Reverse Geocode API
El propósito de este segundo endpoint, Reverse Geocode, es devolver información sobre la dirección en función de sus coordenadas.
- Lista de parámetros
- Ejemplo 1 – Búsqueda de la dirección a partir de las coordenadas
- Ejemplo 2 – Búsqueda de direcciones desde más de una coordenada
Para realizar la solicitud de Reverse Geocode es necesario enviar la solicitud mediante el método POST al siguiente endpoint:
Nota: Actualmente regresa solo a direcciones ubicadas en Brasil.
La Reverse Geocode API se actualizó a V2. El endpoint https://api.maplink.global/geocode/v1/reverse seguirá funcionando, pero se recomienda utilizar el nuevo endpoint para obtener una mayor precisión de los resultados y porque las nuevas funciones serán exclusivas de la nueva versión.
Lista de parámetros
Parámetros obligatorios
lat– Latitud;lon– Longitud.
Parámetros opcionales
id– Texto con el identificador de la dirección buscada;distance– Distancia máxima en metros para buscar la dirección. El valor predeterminado es 2.000 (2 Km) y el valor máximo es hasta 100.000 (100 Km)
Nota: Hay un límite de 200 puntos por enviar una misma solicitud.
Ejemplo 1 – Búsqueda de la dirección a partir de las coordenadas
[
{
"lat": -23.566617861455924,
"lon": -46.65362331449377
}
]
La descripción de cada campo presente en la respuesta se puede encontrar en el siguiente enlace: Estructura de respuesta – Geocode API.
La respuesta completa está a continuación:
{
"results": [
{
"id": "6684353bf0662a1541ff635d",
"address": {
"road": "ALAMEDA CAMPINAS",
"district": "JARDIM PAULISTA",
"zipCode": "01404000",
"city": "SÃO PAULO",
"state": {
"name": "SÃO PAULO",
"code": "SP"
},
"mainLocation": {
"lat": -23.5663551335,
"lon": -46.65364273168
}
},
"type": "ROAD",
"label": "ALAMEDA CAMPINAS, 01404000, JARDIM PAULISTA, SÃO PAULO, SP",
"score": 95.18153327776994,
"distance": 29.313601838651707,
"precision": "ROAD_CENTROID"
}
],
"found": 1
}
Ejemplo 2 – Búsqueda de direcciones desde más de una coordenada
En este ejemplo, obtendremos resultados para dos coordenadas diferentes. Para ello necesitamos identificarlos con el parámetro id. El primer punto será "L1" y el segundo "L2".
El punto "L1" debería devolver resultados dentro de un radio de 500 metros. Para ello utilizamos el parámetro distance.
La solicitud completa está a continuación:
[
{
"id": "L1",
"lat": -26.90314282963394,
"lon": -48.68018153051618,
"distance": 500
},
{
"id": "L2",
"lat": -26.908620508271895,
"lon": -48.67848497677373
}
]
La respuesta completa está a continuación:
{
"results": [
{
"id": "L1",
"address": {
"road": "RUA LEOPOLDO HESS",
"number": "54",
"district": "SÃO JOÃO",
"zipCode": "88304260",
"city": "ITAJAÍ",
"state": {
"name": "SANTA CATARINA",
"code": "SC"
},
"mainLocation": {
"lat": -26.903134,
"lon": -48.680257
},
"numberAsInteger": 54
},
"type": "ROAD",
"label": "RUA LEOPOLDO HESS, 88304260, SÃO JOÃO, ITAJAÍ, SC",
"score": 98.96608277648525,
"distance": 7.556140571987315,
"precision": "NUMBER_EXACT"
},
{
"id": "L2",
"address": {
"road": "RUA HEITOR LIBERATO",
"number": "2057",
"district": "SÃO JUDAS",
"zipCode": "88303101",
"city": "ITAJAÍ",
"state": {
"name": "SANTA CATARINA",
"code": "SC"
},
"mainLocation": {
"lat": -26.908564,
"lon": -48.67848
},
"numberAsInteger": 2057
},
"type": "ROAD",
"label": "RUA HEITOR LIBERATO, 88303101, SÃO JUDAS, ITAJAÍ, SC",
"score": 99.21863668889449,
"distance": 6.309805167165782,
"precision": "NUMBER_EXACT"
}
],
"found": 2
}
