O objetivo desse último endpoint é retornar as coordenadas geográficas a partir de múltiplos endereços, completos ou parciais.  

• Lista de parâmetros
• Exemplo 1 – Buscar coordenadas de dois ou mais endereços na mesma requisição

Para realizar a requisição para a Multi Geocode é necessário enviar a requisição usando o método POST para o seguinte endpoint: 

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

Lista de parâmetros

Parâmetros obrigatórios

• id – Texto com o identificador do endereço buscado.

Aos parâmetros abaixos, é obrigatório informar ao menos um. Não é necessário informar todos. No entanto, quanto mais informações forem fornecidas, mais preciso será o resultado.

• road – Nome da rua ou parte dele;
• number – Número do logradouro. NÃO informar os dados do complemento.
• city – Nome da cidade;
• state – Estado;
• country – País;
• district – Nome do bairro;
• zipcode – CEP.

Para endereços fora do Brasil, será necessário adicionar o query param globalSearch na URL, da seguinte forma:
https://api.maplink.global/geocode/v1/geocode?globalSearch=true

Parâmetro opcional

• type – Limita o tipo da pesquisa. Apenas para endereços no Brasil e caso o parâmetro globalSearch não seja informado. Valores possíveis:
  • ZIPCODE – CEP;
  • STATE – Estado;
  • CITY – Cidade;
  • DISTRICT – Bairro.

Nota: Há o limite de 200 pontos para o envio em uma mesma requisição.

Exemplo 1 – Buscar coordenadas de dois ou mais endereços na mesma requisição

Nesse exemplo vamos buscar dois endereços diferentes na mesma requisição. Para isso precisamos identificar cada um dos endereços com o parâmetro id.

O primeiro será "Address1" e o segundo "Address2". A requisição completa pode ser conferida abaixo:

[
    {
        "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"
    }
]

Na resposta, as seguintes informações são retornadas:

• found – Quantidade de registros retornados.
• results – Array de objetos com todos os resultados encontrados:
  • id – Identificador do endereço informado na requisição;
  • address – Objeto com informações do endereço:
    • road – Nome da via;
    • district – Bairro;
    • zipCode – CEP;
    • city – Cidade;
    • state – Estado;
    • mainLocation – Coordenadas geográficas em latitude/longitude;
  • type – Indica qual o melhor elemento encontrado na base cartográfica para o retorno da coordenada geográfica;
  • score – Pontuação de referência do resultado do processo de geocodificação;
  • label – Endereço completo encontrado utilizado no processo de geocodificação.

Nota: Quanto maior o score, maior será a relevância do resultado para o endereço solicitado.

A resposta completa encontra-se abaixo:

{
    "found": 2,
    "results": [
        {
            "id": "Address1",
            "address": {
                "road": "Rua Leopoldo Hess",
                "number": "75",
                "district": "São João",
                "zipCode": "88304260",
                "city": "Itajaí",
                "state": {
                    "code": "SC",
                    "name": "Santa Catarina"
                },
                "mainLocation": {
                    "lat": -26.90314282963394,
                    "lon": -48.68023153051618
                }
            },
            "type": "ROAD",
            "score": 154.34358,
            "label": "Rua Leopoldo Hess, 75, São João,Itajaí, Santa Catarina, SC"
        },
        {
            "id": "Address2",
            "address": {
                "road": "Alameda Santos",
                "district": "Cerqueira César",
                "zipCode": "01419001",
                "city": "São Paulo",
                "state": {
                    "code": "SP",
                    "name": "São Paulo"
                },
                "mainLocation": {
                    "lat": -23.568495,
                    "lon": -46.650085
                }
            },
            "type": "ZIPCODE",
            "score": 48.98619,
            "label": "Alameda Santos, Cerqueira César,São Paulo, São Paulo, SP"
        }
    ]
}