# Ordnance Survey - Places API

In early 2021, Councils became able to use the Ordnance Survey APIs to search for addresses at no cost.&#x20;

These APIs are documented here:

{% embed url="https://osdatahub.os.uk/docs/places/overview" %}
OS Data Hub
{% endembed %}

Reflective of this, IEG4 has created a no code address look up function that is fully integrated to these APIs and this enables non-technical staff to add an address look up to all of their forms.&#x20;

To add the address look up it's as easy as adding a section and selecting the address selection per below:

### Address Section

The ability to place an address search into forms that is able to search the entirety of the UK:

![](https://3978362562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MgKIYotuJ2G9zOHXIfg%2Fuploads%2FuJT76XeXf16sRAB31NC1%2Fimage.png?alt=media\&token=c767e1b7-727d-4be1-b066-71442246bbc8)

The default option, now that it is free to councils is 'Ordnance Survey'.&#x20;

Simply click to save and you've set up an address section, which is capable of integrating with the Ordnance Survey.

### Address Lookup Style

There is a setting that controls the style of the address look up. The setting is:

**AddressLookupStyle**

The two modes available which needs you to set them as the value for the above setting.

* **TypeAheadSearch** (this is the default)

If this option is enabled, as the user types in an address or postcode, it will instantly start searching for addresses.&#x20;

![](https://3978362562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MgKIYotuJ2G9zOHXIfg%2Fuploads%2FyIFCAHpTeKUfNG9Ykb8r%2Fimage.png?alt=media\&token=a58cbed6-88ed-47a2-b8a0-2f5383fbf7d9)

This provides a smart way of dynamically getting the results as the user enters their address.

{% hint style="info" %}
The speed of the API can mean that sometimes it takes a while for the results to refresh and so if you find this, we'd suggest using the 'Postcode' method.
{% endhint %}

* **Postcode**

If this option is selected the customer needs to enter a postcode and then physically click a search button.&#x20;

{% hint style="success" %}
We'd recommend using this method.
{% endhint %}

![](https://3978362562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MgKIYotuJ2G9zOHXIfg%2Fuploads%2FcNSNPBDaPP3y1lja3XyK%2Fimage.png?alt=media\&token=bbac4212-6e05-4f2f-a752-053ca0d00a62)

{% hint style="info" %}
**Notes**

If the setting is not present, you simply need to use the Create button at the bottom of the Form Management > Settings page to add it and set its value to your preferred style.

This can be added at either form level or at global level (not form specific) in your form settings.&#x20;
{% endhint %}



### Prerequisite

In order that this can be set up by the IEG4 team, we need to have the council's API key for this. This is free to councils now and simply needs you to create an account per below:

{% hint style="info" %}
**If you are a Public Sector Geospatial Agreement (PSGA) member you can access and use the OS Places API (excluding Match & Cleanse) for free via the OS DataHub. Register for an account or login at** [**www.osdatahub.os.uk**](https://osdatahub.os.uk/)
{% endhint %}

\
.Once you have this simply provide the details to IEG4 support:

{% embed url="https://help.ieg4.com" %}

