v1

latestOpenAPI 3.0.02026-07-211529.7 KB
LocationServices_Geocoding_GlobalTypeAhead

LocationServices_Geocoding_GlobalTypeAhead

post/LocationServices/Geocoding/GlobalTypeAhead/v1.10/json6.ws

Request body

Keystring required

The key you want to use to authenticate with the service (you can request we create one for you or create one in your account section).

Inputstring required

The search text to find. This can be a Town, City, State, Postcode or ZIP Code. Requests made using this as an input will be free.

Countriesstring required

A comma separated list of ISO2 or ISO3 country codes (e.g. GB or GBR). This will limit the search to those countries.

Limitinteger nullable

The maximum number of results that will be returned. If not set this will default to 7. The maximum possible value is 100.

Typesstring

The types that you want to be returned in the response. Valid types are Locality | Postcode | AdministrativeArea. This can be set to include multiple types (comma separated). For example, passing "Postcode" will only return Postcode results; passing "Locality, Postcode" will return both Locality and Postcode.

Originstring

A starting location for the search. This can be the name or ISO 2 or 3 character code of a country, WGS84 coordinates (comma separated) or IP address to search from.

addressIDstring

The unique identifier for a location, as provided in a previous Input search. For example: "VE_CiVlgwok_QT1BPT4_QT1FP0U-PT5Dwok_QD0". Requests made with this parameter will return co-ordinates and be charged.

Response

Success

Idstring

The unique identifier for a returned location. For example: "VE_CiVlgwok_QT1BPT4_QT1FP0U - PT5Dwok_QD0". This can be used in a subsequent "addressID" search to return co-ordinates for the location.

Textstring

The first half of the result that's displayed to the user. For example, if the returned location is "Worcester, Worcestershire" then Text will display "Worcester".

Typestring

The type of location returned. Possible values include: SuperAdministrativeArea |AdministrativeArea | SubAdministrativeArea | Locality | DependentLocality | DoubleDependentLocality | Postcode

Descriptionstring

The second half of the location that's displayed to the user, featuring the broader geographic area. For example, if the returned location is "Worcester, Worcestershire" then Description will display "Worcestershire" as this is the larger geographic area.

Highlightstring

A list of number ranges showing which characters in the Text and Description fields match the user's search term. This can be used to determine which characters should be highlighted in bold in the search field, to give the user a visual representation of what's being searched. See here for more details.

Languagestring

The ISO code of the display language for a result (for example: "ENG" to represent English).

DependentThoroughfarestring

Currently will always return blank.

DependentLocalitystring

A smaller population centre, dependent on the contents of the Locality field (i.e. District). Can only be present if Locality is present.

OrganisationNamestring

Currently will always return blank.

SuperAdministrativeAreastring

The largest administrative district within a country, if applicable (most countries only use AdministrativeArea).

DoubleDependentLocalitystring

A locality within a Dependent locality.

Thoroughfarestring

The name of the street or thoroughfare. Will only display for UK postcodes.

AdministrativeAreastring

The most common administrative district within a country (i.e. US State or UK County).

BuildingNamestring

Currently will always return blank.

SubAdministrativeAreastring

In the US this can be used to define a county within a state or a sub area of a city.

Localitystring

The most common population centre within a country (i.e. USA City, Canadian Municipality).

Postcodestring

The full postal code of the address (i.e. Postcode, ZIP Code, etc.).

Departmentstring

Currently will always return blank.

SubBuildingstring

Currently will always return blank.

SubBuildingFloorstring

Currently will always return blank.

Numberstring

Currently will always return blank.

Countrystring

The full name of the country the location is in, as per the ISO 3166-1 standard. Intended for display purposes if you want to present this to the customer.

Iso2string

The ISO 3166-1 alpha-2 country code for the location.

Iso3string

The ISO 3166-1 alpha-3 country code for the location.

All 1 operations