El objetivo de este último endpoint es devolver las coordenadas geográficas de varias direcciones, ya sean completas o parciales.

• Lista de parámetros
• Ejemplo 1 – Búsqueda de las coordenadas de dos o más direcciones en la misma solicitud
• Respuesta

Para realizar la solicitud a Multi Geocode es necesario enviar la solicitud utilizando el método POST al siguiente endpoint:

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

Lista de parámetros

Parámetros obligatorios

• id – Texto con el identificador de la dirección buscada.

Debe introducirse al menos uno de los siguientes parámetros. No es necesario informar a todo el mundo. No obstante, cuanta más información facilite, más preciso será el resultado.

• road – Nombre de la calle o parte de ella;
• number – Número de la calle. NO introduzca los datos del complemento.
• city – Nombre de la ciudad;
• state – Estado;
• country – País;
• district – Nombre del barrio;
• zipcode – Código postal.
• label – Dirección completa. Se recomienda armar el texto en el orden «Nombre de la calle, número, código postal, barrio, ciudad, estado».

Nota: Actualmente regresa solo a direcciones ubicadas en Brasil.

Nota: Hay un límite de 200 puntos por enviar una misma solicitud.

Parâmetros opcionais

• mainLocation – Objeto con dos parámetros para limitar el área de búsqueda de direcciones:
  • center – Objeto con coordenadas de referencia para resultados de búsqueda. Las coordenadas se pueden ingresar en los siguientes formatos:
    • Objeto con las propiedades lat y lon que representan latitud y longitud respectivamente. Ejemplo: {"lat":-23.0852, "lon": -46.98020}
    • Array con latitud y longitud. Ejemplo: [-23.0852,  -46.98020]
    • Coordenadas codificadas como geohash. Ejemplo: "6tr6df675"
  • radius – Radio de búsqueda, en metros, desde el punto central definido en center. Si no se informa, el valor por defecto es 500.000 metros (500 km).

Ejemplo 1 – Búsqueda de las coordenadas de dos o más direcciones en la misma solicitud

En este ejemplo vamos a buscar dos direcciones diferentes en la misma petición. Para ello, debemos identificar cada dirección con el parámetro id.

El primero será "Address1" y el segundo "Address2". La solicitud completa puede verse a continuación:

[
    {
        "id": "Address1",
        "road": "Leopoldo Hess",
        "number": 75,
        "district": "São João",
        "zipcode": "88304-260",
        "city": "Itajai",
        "state": "SC"
    },
    {
        "id": "Address2",
        "road": "Alameda Campinas",
        "number": 579,
        "zipcode": "01419-001",
        "city": "São Paulo",
        "state": "SP"
    }
]

Respuesta

La descripción de cada campo presente en la respuesta se puede encontrar en el siguiente enlace: Estructura de respuesta – Geocode API.

A continuación encontrará la respuesta completa:

{
    "results": [
        {
            "id": "Address1",
            "address": {
                "road": "RUA LEOPOLDO HESS",
                "number": "75",
                "district": "SÃO JOÃO",
                "zipCode": "88304260",
                "city": "ITAJAÍ",
                "state": {
                    "name": "SANTA CATARINA",
                    "code": "SC"
                },
                "mainLocation": {
                    "lat": -26.903004,
                    "lon": -48.680296
                },
                "numberAsInteger": 75
            },
            "type": "ROAD",
            "label": "RUA LEOPOLDO HESS, 88304260, SÃO JOÃO, ITAJAÍ, SC",
            "score": 96.79654045442564,
            "precision": "NUMBER_EXACT"
        },
        {
            "id": "Address2",
            "address": {
                "road": "ALAMEDA CAMPINAS",
                "district": "JARDIM PAULISTA",
                "zipCode": "01404001",
                "city": "SÃO PAULO",
                "state": {
                    "name": "SÃO PAULO",
                    "code": "SP"
                },
                "mainLocation": {
                    "lat": -23.56880844109,
                    "lon": -46.65604091167
                }
            },
            "type": "ROAD",
            "label": "ALAMEDA CAMPINAS, 01404001, JARDIM PAULISTA, SÃO PAULO, SP",
            "score": 96.91391938959099,
            "precision": "ROAD_CENTROID"
        }
    ],
    "found": 2
}