6.5. Multi Geocode

Construindo requisições para a 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: 

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

Parâmetros da requisição

 Os parâmetros são os mesmos usados na Geocode API, com a adição do parâmetro id, que irá identificar os endereços desejados.

Parâmetros obrigatórios

Com exceção do id, o restante ao menos um é obrigatório, não há necessidade de informar todos. No entanto, quanto mais informação for fornecida, mais preciso será o resultado.

• id - Identificador único do endereço;

• 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;

• district - Nome do bairro;

• zipcode - CEP.

Parâmetro opcional

• type - Limita o tipo da pesquisa. Valores possíveis:

  • ZIPCODE - CEP;

  • STATE - Estado;

  • CITY - Cidade;

  • POI - Pedágios (Até a data atual);

  • DISTRICT - Bairro.
    
    

Exemplo 1 - Busca 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 encontra-se abaixo:

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

• found - Quantidade de registros encontrados.

• results - Resultados encontrados:

  • address - 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.

 A resposta completa pode ser conferida abaixo: