Skip to main content
POST
/
LocationServices
/
Geocoding
/
Global
/
v1.10
/
json6.ws
LocationServices_Geocoding_Global
curl --request POST \
  --url 'https://api.addressy.com/LocationServices/Geocoding/Global/v1.10/json6.ws?Key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "Key": "AA11-AA11-AA11-AA11",
  "Input": [
    "<string>"
  ],
  "Country": "<string>"
}
'
[
  {
    "Input": "<string>",
    "Results": [
      {
        "Premise": "<string>",
        "Thoroughfare": "<string>",
        "Locality": "<string>",
        "AdministrativeArea": "<string>",
        "PostalCode": "<string>",
        "Country": "<string>",
        "Latitude": "<string>",
        "Longitude": "<string>",
        "GeoDistance": "<string>",
        "GeoAccuracy": "<string>",
        "LocationType": "<string>"
      }
    ]
  }
]
When reverse geocoding, multiple addresses will be returned if possible (with a maximum of 5). This is because, particularly in urban areas, it can be difficult to identify the specific property associated with a set of co-ordinates. The Global Geocoding API supports most international locations. For a full list of coverage please see data coverage documentation. This method will consume credit. You will be charged per address geocoded.

​
Use of geocodes/addresses

Use of the output of the Global Geocoding API is temporary, and only for use as part of a Store Finder. It is not permitted to index or store results for other purposes, such as use in a checkout process. For further information please see the Loqate Terms and Conditions.

Authorizations

​
Key
string
query
required

Body

application/json
​
Key
string
default:AA11-AA11-AA11-AA11
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).

​
Input
string[]

An array of strings containing either location co-ordinates and/or unstructured addresses. This array can contain up to 10 items.

​
Country
string

The ISO2 or ISO3 country code (e.g. GB or GBR). This will limit the geocoding lookup to the specified country, but will improve performance. This parameter is not required for reverse geocoding requests.

Response

Success

​
Input
string

The input from the original request.

​
Results
object[]

An array of geocoding results corresponding to each input from the original request.