This endpoint will return address information for a position.

• There may be times when you need to translate a coordinate (for example: 37.786505, -122.3862) into a human understandable street address.
• Most often this is needed in tracking applications where you receive a GPS feed from the device or an asset, and wish to know the address where the point is located.

You can easily run this and other endpoints.

1. Go to the TomTom API Explorer page.
2. Click an endpoint.
   1. Click Try it out.
   2. Enter/select all required parameter values and any optional parameter values.
   3. At the bottom of the form, click Execute.
   4. Review the Response.

HTTPS Method: GET

URL format

For identification purposes:

• Required constants and parameters are shown in bold text.
• Optional parameters are shown in plain text.

https://api.tomtom.com/search/2/reverseGeocode/crossStreet/37.8328,-122.27669.json?key=*****limit=1&spatialKeys=true&heading=0&radius=1000&language=en-us

curl command

curl -X GET "https://api.tomtom.com/search/2/reverseGeocode/crossStreet/37.8328,-122.27669.json?&key=*****
  &limit=1
  &spatialKeys=true
  &heading=0
  &radius=1000
  &language=en-us"
-H "accept: */*"

▲ Return to Top

Request parameters

The following data table describes the parameters that can be used in a request.

• Required parameters must be used or the call will fail.
• Optional parameters may be used.
• A parameter's data type is beneath its name.
• If there is a default value that will be assumed when an optional parameter is not used, it is shown in the table.
• The order of request parameters is not important.

Response body

For illustrative purposes the example below is neatly indented and includes all possible Response fields.

• Actual Responses are more compact and the fields present will vary based on the result type and the data available.
• See the following Response field section for more information.

When requesting JSON output the Response has the following structure:

{
    "summary": {
        "numResults": 1,
        "queryTime": 176
    },
    "addresses": [],
    "spatialKeys": []
}

Each element of the addresses array is in the following format:

{
    "address": {
        "streetName": "Soquel Dr & Winkle Ave",
        "crossStreet": "Soquel Dr",
        "municipalitySubdivision": "Santa Cruz, Live Oak",
        "municipality": "Santa Cruz, Live Oak",
        "countrySecondarySubdivision": "Santa Cruz",
        "countryTertiarySubdivision": "Santa Cruz",
        "countrySubdivision": "CA",
        "postalCode": "95065",
        "countryCode": "US",
        "country": "United States Of America",
        "countryCodeISO3": "USA",
        "freeformAddress": "Soquel Dr & Winkle Ave, Santa Cruz, CA 95065",
        "countrySubdivisionName": "California",
        "street": "Winkle Ave"
    },
    "position": "36.9882,-121.97511"
}

Each element of the spatialKeys[] array is in the following format:

{
    "priority": "0",
    "val": "1563238492"
}

▲ Return to top

Response fields

The following tables describe all of the fields that can appear in a Response. Fields are listed by the Response section they belong to, and in the order that they appear in the Response.

▲ Return to top

HTTP Response codes

The following table contains Response codes signifying successful and failed requests to an API server.

▲ Return to top

Response headers

The following table contains Response headers sent back from an API server.