tomtom-reverse-geocode
Convert latitude and longitude coordinates into human-readable addresses using TomTom's geocoding capabilities. Specify language, country set, and additional details like mapcodes, geopolitical views, or extended postal codes for precise, customizable results.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| addressRanges | No | Include address ranges in the response | |
| allowFreeformNewLine | No | Allow newlines in freeform addresses | |
| countrySet | No | Limit results to specific countries using ISO codes. Examples: 'US', 'FR,GB', 'CA,US' | |
| entityTypeSet | No | Filter by entity types: 'Country', 'Municipality', etc. | |
| extendedPostalCodesFor | No | Include extended postal codes for specific index types. Examples: 'PAD', 'PAD,Addr', 'POI' | |
| geometries | No | Include geometries information in the response | |
| heading | No | Heading direction in degrees (0-360) for improved accuracy on roads | |
| language | No | Preferred language for results using IETF language tags. Examples: 'en-US', 'fr-FR', 'de-DE', 'es-ES' | |
| lat | Yes | Latitude coordinate (-90 to +90). Precision to 4+ decimal places recommended. | |
| limit | No | Maximum number of results to return (1-100). Default: 5 | |
| lon | Yes | Longitude coordinate (-180 to +180). Precision to 4+ decimal places recommended. | |
| mapcodes | No | Include mapcode information in the response. Mapcodes represent specific locations within a few meters and are designed to be short, easy to recognize and communicate. Options: Local, International, Alternative. Examples: 'Local' (local mapcode only), 'Local,Alternative' (multiple types). Accepts array of string(s). | |
| maxResults | No | Maximum results to return (alias for limit) | |
| ofs | No | Offset for pagination of results | |
| radius | No | Search radius in meters. Default: 100 | |
| returnAddressNames | No | Include address names in the response | |
| returnCommune | No | Include commune information in the results | |
| returnMatchType | No | Include information about the type of geocoding match achieved | |
| returnRoadAccessibility | No | Include road accessibility information | |
| returnRoadUse | No | Include road use types for street level results | |
| returnSpeedLimit | No | Include posted speed limit for street results | |
| roadUse | No | Types of road use to include in the results. Examples: 'Arterial', 'Ferry', 'Highway', etc. | |
| timeZone | No | Used to indicate the mode in which the timeZone object should be returned. Values: iana Mode shows the IANA ID which allows the user to determine the current time zone for the POI. Usage examples: timeZone=iana | |
| view | No | Geopolitical view for disputed territories. Options: 'Unified', 'AR', 'IL', 'IN', 'MA', 'PK', 'RU', 'TR', 'CN' |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"addressRanges": {
"description": "Include address ranges in the response",
"type": "boolean"
},
"allowFreeformNewLine": {
"description": "Allow newlines in freeform addresses",
"type": "boolean"
},
"countrySet": {
"description": "Limit results to specific countries using ISO codes. Examples: 'US', 'FR,GB', 'CA,US'",
"type": "string"
},
"entityTypeSet": {
"description": "Filter by entity types: 'Country', 'Municipality', etc.",
"type": "string"
},
"extendedPostalCodesFor": {
"description": "Include extended postal codes for specific index types. Examples: 'PAD', 'PAD,Addr', 'POI'",
"type": "string"
},
"geometries": {
"description": "Include geometries information in the response",
"type": "boolean"
},
"heading": {
"description": "Heading direction in degrees (0-360) for improved accuracy on roads",
"type": "number"
},
"language": {
"description": "Preferred language for results using IETF language tags. Examples: 'en-US', 'fr-FR', 'de-DE', 'es-ES'",
"type": "string"
},
"lat": {
"description": "Latitude coordinate (-90 to +90). Precision to 4+ decimal places recommended.",
"type": "number"
},
"limit": {
"description": "Maximum number of results to return (1-100). Default: 5",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"lon": {
"description": "Longitude coordinate (-180 to +180). Precision to 4+ decimal places recommended.",
"type": "number"
},
"mapcodes": {
"description": "Include mapcode information in the response. Mapcodes represent specific locations within a few meters and are designed to be short, easy to recognize and communicate. Options: Local, International, Alternative. Examples: 'Local' (local mapcode only), 'Local,Alternative' (multiple types). Accepts array of string(s).",
"items": {
"type": "string"
},
"type": "array"
},
"maxResults": {
"description": "Maximum results to return (alias for limit)",
"type": "number"
},
"ofs": {
"description": "Offset for pagination of results",
"type": "number"
},
"radius": {
"description": "Search radius in meters. Default: 100",
"type": "number"
},
"returnAddressNames": {
"description": "Include address names in the response",
"type": "boolean"
},
"returnCommune": {
"description": "Include commune information in the results",
"type": "boolean"
},
"returnMatchType": {
"description": "Include information about the type of geocoding match achieved",
"type": "boolean"
},
"returnRoadAccessibility": {
"description": "Include road accessibility information",
"type": "boolean"
},
"returnRoadUse": {
"description": "Include road use types for street level results",
"type": "boolean"
},
"returnSpeedLimit": {
"description": "Include posted speed limit for street results",
"type": "boolean"
},
"roadUse": {
"description": "Types of road use to include in the results. Examples: 'Arterial', 'Ferry', 'Highway', etc.",
"items": {
"type": "string"
},
"type": "array"
},
"timeZone": {
"description": "Used to indicate the mode in which the timeZone object should be returned. Values: iana Mode shows the IANA ID which allows the user to determine the current time zone for the POI. Usage examples: timeZone=iana",
"type": "string"
},
"view": {
"description": "Geopolitical view for disputed territories. Options: 'Unified', 'AR', 'IL', 'IN', 'MA', 'PK', 'RU', 'TR', 'CN'",
"type": "string"
}
},
"required": [
"lat",
"lon"
],
"type": "object"
}