Geocode

Multi Geocode API

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

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

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