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:

• https://api.maplink.global/geocode/v2/reverse – POST 

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.

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
    }
]

En la respuesta se devuelve la siguiente información:

• found – Número de registros devueltos;
• results – Array de objetos con todos los resultados encontrados:
  • id – Identificador de la dirección proporcionada en la solicitud;
  • address – Objeto con información de dirección:
    • road – Nombre de la carretera;
    • district – Bairro;
    • zipCode – Código postal;
    • city – Ciudad;
    • state – Estado;
    • mainLocation – Objeto con las coordenadas geográficas del punto:
      • lat – Latitud;
      • lon – Longitud;
    • numberAsInteger – Número de dirección, pero devuelto como un número entero en lugar de una string;
  • type – Indica el mejor elemento encontrado en la base de datos cartográfica para devolver la coordenada geográfica;
  • score – Puntuación de referencia del resultado del proceso de geocodificación;
  • label – Dirección completa encontrada utilizada en el proceso de geocodificación.

Nota: Cuanto mayor sea la puntuación, mayor será la relevancia del resultado para la dirección solicitada.

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
        }
    ],
    "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 CONCEIÇÃO",
                "number": "656",
                "district": "SÃO JOÃO",
                "zipCode": "88304220",
                "city": "ITAJAÍ",
                "state": {
                    "name": "SANTA CATARINA",
                    "code": "SC"
                },
                "mainLocation": {
                    "lat": -26.903700093479443,
                    "lon": -48.680039930963865
                },
                "numberAsInteger": 656
            },
            "type": "ROAD",
            "label": "RUA CONCEIÇÃO, 88304220, SÃO JOÃO, ITAJAÍ, SC",
            "score": 91.04826378482639,
            "distance": 63.60663670637282
        },
        {
            "id": "L2",
            "address": {
                "road": "AVENIDA GOVERNADOR ADOLFO KONDER",
                "number": "229",
                "district": "CIDADE NOVA",
                "zipCode": "88308001",
                "city": "ITAJAÍ",
                "state": {
                    "name": "SANTA CATARINA",
                    "code": "SC"
                },
                "mainLocation": {
                    "lat": -26.908558931768667,
                    "lon": -48.67824030691178
                },
                "numberAsInteger": 229
            },
            "type": "ROAD",
            "label": "AVENIDA GOVERNADOR ADOLFO KONDER, 88308001, CIDADE NOVA, ITAJAÍ, SC",
            "score": 95.79443936391044,
            "distance": 25.236232052027663
        }
    ],
    "found": 2
}