API de geocodificação reversa precisa | Documentação e exemplos

Introdução

Antes de começar Como usar a API de geocodificação Como usar por meio do Postman

Guia do desenvolvedor de geocodificação reversa

Formato da solicitação Parâmetros Respostas Códigos de status Mensagens de erro Resultados Tipos de endereço e tipos de componentes de endereço

PERGUNTAS FREQUENTES

O que você pode fazer com a API de geocodificação?Por que usar a API de geocodificação?

Antes de começar

A geocodificação é o processo de converter um endereço em coordenadas de latitude e longitude usando uma API, enquanto a geocodificação reversa é a conversão de coordenadas geográficas (latitude e longitude) em um endereço legível por humanos por meio de uma API.

Assim, por exemplo, ao converter coordenadas geográficas como latitude 40,758678 e longitude 73,978798, usando a API de geocodificação reversa, você receberá o endereço exato “35 Rockefeller Plaza, New York, NY 10111, USA”.

O DistanceMatrix.ai oferece as duas soluções: API de geocodificação reversa para transformar latitude e longitude em endereço e API de geocodificação direta para converter endereços no mapa em coordenadas geográficas.

Como usar a API de geocodificação reversa

Este serviço é acessível por meio de um HTTP interface. Para solicitações de geocodificação reversa, você precisaria enviar uma consulta como coordenadas (latitude e longitude). A lista abaixo detalha os parâmetros obrigatórios e opcionais para essas solicitações.

Ao consultar, você receberá uma resposta na forma de JSON documento contendo os resultados mais pertinentes. Exemplos dessas solicitações e suas respostas correspondentes são fornecidos na documentação abaixo.

A segurança vem em primeiro lugar. É por isso que o HTTPS é altamente recomendado, especialmente para aplicativos que lidam com dados confidenciais, como a localização do usuário. A criptografia HTTPS fortalece a segurança do seu aplicativo, tornando-o mais resistente à vigilância e à modificação.

Nossa API de geocodificação reversa oferece a flexibilidade de fazer solicitações da maneira que melhor atenda às suas necessidades. As instruções detalhadas acima orientam você sobre como fazer essas solicitações usando o Postman, uma ferramenta de interação de API versátil e fácil de usar.

Como usar a API de geocodificação por meio do Postman

Nossa API é um serviço HTTP versátil, adequado para vários casos de uso e cenários de integração. Ele pode ser usado de qualquer forma que atenda às suas necessidades, incluindo solicitações diretas do navegador, codificação em diferentes linguagens de programação ou integração com aplicativos e sistemas.

Uma das maneiras mais fáceis e eficientes de começar a interagir e integrar nossa API em seus projetos é usar Carteiro, conhecida por sua interface amigável e recursos poderosos.

Veja como fazer isso:

Para começar a usar o Postman, instale-o em seu computador ou acesse uma versão web do navegador.
Importe nossa coleção de API pré-configurada:
- Abra o Postman.
- Clique no botão “Importar” no canto superior esquerdo.
- Selecione “Importar do link” e cole este link da coleção Postman: https://www.postman.com/distancematrix/workspace/distance-matrix/overview
Ao importar, o Postman adicionará automaticamente a coleção ao seu espaço de trabalho.
Para usuários da versão on-line do Postman, você pode abrir diretamente o link da coleção e criar um fork. Faça isso clicando nos três pontos ao lado do nome da coleção.
Configure seu ambiente no Postman, vá para a seção Variáveis e adicione seu token de autenticação no campo “Token de autorização da API”.
Não se esqueça de salvar essas alterações.
Faça sua primeira solicitação: selecione um endpoint de nossa coleção, configure seus parâmetros de solicitação e clique em enviar para ver a resposta.

Observe que você pode obter seu token individual no painel de administração. Leia como fazer isso em o artigo.

Não se esqueça de salvar essas alterações.

Em nossa coleção Postman, você encontrará todos os endpoints, tipos de solicitações e parâmetros disponíveis. Em geral, recomendamos o uso de solicitações síncronas. No entanto, para situações em que você precisa processar solicitações em massa com um grande número de locais de uma só vez, as solicitações assíncronas também estão disponíveis e podem ser eficazes. Para trabalhar com eles, clique em Distancematrix Accurate → Solicitações em massa → Enviar um trabalho → Corpo, comece a trabalhar!

Na coleção Postman, você encontra todos os parâmetros necessários para configurar suas solicitações. Se você tiver alguma dúvida, não hesite em entre em contato conosco.

Quando estiver confortável com o básico, você poderá explorar os recursos mais avançados da nossa API. Nossa documentação detalhada abaixo o guiará pelas funcionalidades específicas de nossa API.

Guia do desenvolvedor de geocodificação reversa

Formato de solicitação de API

Nossa API de geocodificação reversa Distancematrix.ai adota um formato de solicitação semelhante a outras APIs padrão do setor, garantindo uma transição intuitiva e suave para usuários familiarizados com as ferramentas de geocodificação padrão.

Aqui está um exemplo de como uma solicitação de API adequada seria ou poderia parecer:

OBTENHA:

https://api.distancematrix.ai/maps/api/geocode/json?latlng=37.422387799999996,-122.08418770000002&language=uk&key=<your_access_token>

Copiado!

Componentes da solicitação:

Criptografia HTTPS: https:// é usado para comunicação segura.
Domínio: api.distancematrix.ai é o domínio da API precisa.
Caminho da solicitação: /mapas/api/geocodificar/json especifica o tipo de solicitação.
Parâmetro obrigatório: ? latlng=37,422387799999996,-122,08418770000002 especifica a latitude e a longitude para a geocodificação reversa.
Parâmetro opcional: &linguagem= reino unido pode ser adicionado para preferência de idioma.
Token de autorização: &chave=<your_access_token> é necessário para autenticar a solicitação.

Os parâmetros são separados usando o caractere comercial (&), como padrão em URLs.

Essa configuração é personalizada para a API de geocodificação reversa, na qual parâmetros diferentes são usados em comparação com a geocodificação padrão. A página orientará você sobre como obter latitude e longitude de uma API de endereço, incluindo os parâmetros obrigatórios e opcionais a serem usados e o tipo de resposta de geocodificação que você pode esperar. Além disso, um exemplo de resposta JSON com base no sinalizador de saída será fornecido.

Por exemplo, aqui está um exemplo de solicitação para converter as coordenadas das pirâmides egípcias em um endereço, mas obter resultados em inglês em vez de árabe:

https://api.distancematrix.ai/maps/api/geocode/json?latlng=29.976480,%2031.131302&language=en&key=access_token

Copiado!

Parâmetros necessários em uma solicitação de geocodificação reversa:

latlng: Esse parâmetro obrigatório inclui os valores de latitude e longitude para especificar o local para o qual você deseja obter o endereço. Exemplo:

latlng=37.422387799999996,-122.08418770000002

Copiado!

chave: Uma chave de API exclusiva que autentica o solicitante e permite o cálculo da cota. Essa chave precisa ser incluída em cada solicitação. Anexe sua chave de API à solicitação usando o formato &chave=<your_access_token>.

Siga o vincular para saber mais sobre a chave, sua finalidade, como obtê-la e os limites da API de geocodificação reversa.

Parâmetros opcionais em uma solicitação de geocodificação reversa:

linguagem: define o idioma dos resultados.

Os idiomas suportados estão listados no site.
Se não for especificado, o padrão é o cabeçalho Accept-Language ou o idioma de domínio da solicitação.
A geocodificação reversa fornece endereços de rua legíveis no idioma local, transliterando se necessário, e usa o idioma preferido para todos os outros endereços. Se um nome não estiver disponível no idioma escolhido, a correspondência mais próxima será usada.

Mostrar a lista de idiomas

Mostrar idiomas

Ocultar idiomas

Código do idioma

Idioma

Código do idioma

Idioma

afrikaans

sim

japonesa

albanesa

canarês

sou

Amárico

cazaque

sou

árabe

quilômetro

Khmer

por que

armênio

coreana

azerbaijano

chave

Quirguiz

Basco

laosiano

ser

Bielorrusso

letão

bengali

lituano

bósnio

Macedônio

por

búlgaro

malaio

meu

birmanês

Malaiala

catalão

sr.

Marathi

chinês

homem

mongol

zh-CN

Chinês (simplificado)

Nepalês

Zh-HK

Chinês (Hong Kong)

não

norueguês

Zh-TW

Chinês (tradicional)

polonês

croata

portuguesa

Tcheco

pt-BR

Português (Brasil)

dinamarquês

pt-PT

Português (Portugal)

holandês

punjabi

Inglês

romeno

pt-BR

Inglês (australiano)

russa

pt-BR

Inglês (Grã-Bretanha)

sr.

sérvio

estoniano

Cingalês

Farsi

perguntar

eslovaca

finlandês

esloveno

arquivo

Filipino

Sim

espanhol

francês

es-419

Espanhol (América Latina)

fr-CA

Francês (Canadá)

suaíli

galego

sueca

georgiano

chá

tâmil

alemã

Télugo

grego

tailandês

arma

Gujarati

tentar

turca

hebreu

reino unido

ucraniano

hindi

urdu

húngaro

Uzbeque

islandês

vietnamita

indonésio

zulu

isso

italiano

tipo_resultado: filtra os resultados por tipos de endereço, usando um tubo (|) para vários tipos. Ele atua como um filtro pós-pesquisa, descartando resultados que não correspondem aos tipos especificados. Os tipos suportados incluem:

endereço_rua: Endereço preciso.
rota: rotas nomeadas como “US 101".
interseção: Principais cruzamentos.
político: Entidades políticas.
país: Entidades políticas nacionais.
nível_da_área administrativa_1 para nível_da_área administrativa_5: Vários níveis de entidades civis abaixo do país.
área_coloquial: Nomes comumente usados.
localidade: Cidades ou vilas.
sublocalidade (e nível_sublocalidade_1 para nível_de_sublocalidade_5): Entidades abaixo de uma localidade.
vizinhança: Bairros.
premissa: Locais nomeados, como edifícios.
subpremissa: Entidades dentro de uma premissa maior.
código_postal: Códigos postais.
característica_natural: Marcos naturais.
aeroporto: Aeroportos.
parque: Parques.
ponto_de_interesse: Pontos de interesse, como edifícios famosos.

tipo_localização: Filtra por tipos de localização, novamente usando um tubo (|) para múltiplos. Ele pós-filtra os resultados da pesquisa, mantendo somente aqueles que correspondem aos tipos especificados. Os tipos suportados são:

“TELHADO“: Localizações precisas no nível do endereço.
“INTERVALO_INTERPOLADO“: Aproximações entre pontos precisos.
“CENTRO_GEOMÉTRICO“: Centros de linhas ou áreas.
“APROXIMADO“: Localizações aproximadas.

Se ambos tipo_resultado e tipo_localização filtros são usados, somente os resultados correspondentes a ambos são retornados. Se nenhuma correspondência for encontrada, a API retornará”RESULTADOS_ZERO“.

Respostas de geocodificação reversa

A solicitação fornecida usa a API de geocodificação reversa para converter as coordenadas de latitude e longitude '40.714224, -73.961452', localizadas no Brooklyn, em um endereço legível por humanos e especifica que a resposta deve estar no formato JSON.

Veja como a solicitação é estruturada:

OBTENHA:

https://api.distancematrix.ai/maps/api/geocode/json?latlng=40.714224,-73.961452&key=<your_access_token>

Copiado!

*Nota importante: Ao inserir o latlng parâmetro, certifique-se de que não haja espaço entre os valores de latitude e longitude.

Exemplo de resposta JSON:

BODY
{
    "result": [
        {
            "address_components": [
                {
                    "long_name": "290-306",
                    "short_name": "290-306",
                    "types": [
                        "street_number"
                    ]
                },
                {
                    "long_name": "bedford ave",
                    "short_name": "bedford ave",
                    "types": [
                        "route"
                    ]
                },
                {
                    "long_name": "brooklyn",
                    "short_name": "brooklyn",
                    "types": [
                        "city_district"
                    ]
                },
                {
                    "long_name": "ny",
                    "short_name": "ny",
                    "types": [
                        "state"
                    ]
                },
                {
                    "long_name": "11249",
                    "short_name": "11249",
                    "types": [
                        "postcode"
                    ]
                },
                {
                    "long_name": "usa",
                    "short_name": "usa",
                    "types": [
                        "country"
                    ]
                }
            ],
            "formatted_address": "290-306 Bedford Ave, Brooklyn, NY 11249, USA",
            "geometry": {
                "location": {
                    "lat": 40.714224,
                    "lng": -73.961452
                },
                "location_type": "APPROXIMATE",
                "viewport": {
                    "northeast": {
                        "lat": 40.714224,
                        "lng": -73.961452
                    },
                    "southwest": {
                        "lat": 40.714224,
                        "lng": -73.961452
                    }
                }
            },
            "place_id": "",
            "plus_code": {},
            "types": [
                "locality",
                "political"
            ]
        }
    ],
    "status": "OK"
}

Copiado!

O”endereço_formatado“Os resultados incluem várias maneiras de nomear geograficamente um local, como endereços, nomes de cidades, estados ou países, retornando qualquer um desses tipos como resultados válidos. Por exemplo, a geocodificação de um ponto em Chicago pode ser representada como endereço, cidade (Chicago), estado (Illinois) ou país (EUA). O geocodificador reverso combina entidades políticas, endereços e códigos postais.

* Nota importante: A geocodificação reversa estima a localização endereçável mais próxima dentro de uma faixa de tolerância específica, retornando zero resultados se nenhuma correspondência próxima for encontrada.

Observe que a resposta JSON tem dois elementos principais:

“status”: esse elemento fornece metadados sobre a solicitação. Consulte o Códigos de status abaixo para obter mais detalhes.

“resultado”: Isso inclui uma matriz com detalhes de endereço geocodificados e informações de geometria.

Lembre-se de que, para extrair valores específicos desses resultados, geralmente é necessário analisar o JSON, o que, por sua vez, é um processo simples.

Códigos de status

Na resposta de geocodificação, o”statusO campo “mostra o status da solicitação e pode incluir detalhes de depuração. Os valores possíveis são:

“ESTÁ BEM”: Sem erros; o endereço foi processado e o (s) código (s) geográfico (s) retornado (s).

“RESULTADOS_ZERO”: A geocodificação foi bem-sucedida, mas nenhum resultado foi encontrado, possivelmente devido a um endereço inexistente.

“ACIMA DO LIMITE_DIÁRIO_DE_LIMITE”: pode significar uma chave de API ausente/inválida, nenhuma cobrança ativada ou um limite de uso excedido.

“EXCEDA_LIMITE_CONSULTA”: indica o uso excessivo da cota.

“SOLICITAÇÃO_NEGADA”: Sua solicitação foi negada.

“SOLICITAÇÃO_INVÁLIDA”: normalmente significa falta de detalhes da consulta (endereço, componentes ou latlng).

“ERRO_DESCONHECIDO”: um erro no servidor impediu o processamento. Uma nova tentativa pode ser bem-sucedida.

Mensagens de erro

Se o código de status do geocodificador for algo diferente de”OK,” um”mensagem_de_erro” o campo” pode aparecer na resposta. Esse campo fornece motivos detalhados para o código de status específico.

*Nota importante: O”mensagem_de_erro” o campo” nem sempre está incluído e seu conteúdo pode variar.

Resultados

Quando o geocodificador produz resultados, eles são colocados em uma matriz de resultados no formato JSON. Se nenhum resultado for encontrado, como com um endereço inexistente, a matriz será retornada vazia.

Os principais campos em um resultado típico incluem:

matriz de tipos []: Especifica o tipo de resultado, com tags como “localidade” para cidades ou “político” para entidades políticas. Por exemplo, “Chicago” pode ser marcado como ambos.

endereço_formatado: Uma sequência de endereços legível por humanos, geralmente semelhante a um endereço postal. No entanto, em alguns lugares, como no Reino Unido, os endereços postais verdadeiros podem não ser distribuíveis. Esse endereço é composto por componentes como número da rua, rota, cidade e estado. Em vez de analisar esse endereço, use os componentes de endereço separados que também são fornecidos na resposta.

endereço_componentes []: Uma matriz dos componentes do endereço.

Cada componente de endereço normalmente contém os seguintes campos:

tipos []: Especifica o tipo de cada componente de endereço.

nome_longo: Fornece a descrição em texto completo ou o nome do componente de endereço, conforme fornecido pelo Geocodificador.

nome_curto: Aplica-se ao nome do componente de endereço com uma versão abreviada disponível do nome do componente de endereço. Vamos pegar o estado do Alasca como exemplo: a nome_curto de “AK”, que é sua abreviatura postal de 2 letras e um nome_longo de “Alaska”.

Tenha em mente esses pontos sobre o endereço_componentes [] matriz em resultados de geocodificação:

A matriz pode incluir mais elementos do que endereço_formatado.

Nem sempre abrange todas as entidades políticas de um endereço, apenas aquelas no endereço_formatado. Use geocodificação reversa com latitude/longitude para obter uma lista abrangente.

O formato da resposta, incluindo o número e os tipos de componentes do endereço, pode variar com cada solicitação e ao longo do tempo para o mesmo endereço. Os componentes podem mudar de posição, mudar de tipo ou estar ausentes nas respostas subsequentes.

Para usar efetivamente a resposta de geocodificação, você precisa analisar a matriz de componentes e selecionar valores conforme necessário.

postcode_localities []: Essa matriz lista todas as localidades dentro de um código postal. Ele aparece apenas para códigos postais que abrangem várias localidades.

geometria: Fornece os principais detalhes da localização:

localização: A latitude e longitude geocodificadas. Geralmente, esse é o campo mais importante para pesquisas de endereços padrão.
tipo_localização: Informações adicionais sobre o local. Os valores aceitos incluem:
- ”TELHADO”: Um código geográfico preciso com a localização exata do endereço.
- “INTERVALO_INTERPOLADO“: Um resultado aproximado, geralmente usado quando dados específicos do telhado não estão disponíveis.
- “CENTRO_GEOMÉTRICO“: O ponto central de uma linha ou área.
- ”APROXIMADO”: Uma localização estimada.

partial_match: indica uma correspondência não exata, na qual somente parte do endereço solicitado pode ser correspondida. Isso é comum em endereços de rua inexistentes na localidade solicitada ou quando um endereço corresponde a vários locais. Por exemplo, uma solicitação com um endereço com um pequeno erro ortográfico pode retornar um endereço próximo, escrito corretamente, como uma correspondência parcial.

Tipos de endereço e tipos de componentes de endereço

O tipos [] a matriz nos resultados da geocodificação indica o tipo de endereço, que pode incluir:

endereço_rua: Um endereço específico.

rota: Uma rota nomeada como “US 101”.

interseção: Uma grande encruzilhada de duas estradas.

político: Uma entidade política, geralmente uma área da administração civil.

país: A entidade política nacional, geralmente do tipo de nível superior.

nível_da_área administrativa_2: Uma entidade civil secundária, como condados nos EUA.

nível_do_área administrativa 3 para nível_da_área administrativa_5: Divisões civis de ordem inferior.

Outros tipos compatíveis incluem:

área_coloquial: Um nome alternativo para um lugar.

localidade: Uma cidade ou vila incorporada.

sublocalidade (e níveis 1-5): Uma entidade civil dentro de uma localidade.

vizinhança: Um bairro específico.

premissa: Um edifício ou complexo nomeado.

subpremissa: Uma unidade dentro de uma premissa maior.

código_postal: O código postal.

característica_natural: Marcos naturais notáveis.

aeroporto: Um aeroporto.

parque: Um parque com nome.

ponto_de_interesse: Entidades locais importantes, como pontos turísticos.

Uma lista de tipos vazia significa que não há tipos conhecidos para esse componente de endereço. Os tipos adicionais incluem:

chão: Piso do prédio.

estabelecimento: Lugares não classificados.

estacionamento: Áreas de estacionamento.

caixa postal: Caixas postais específicas.

cidade_postal: Áreas geográficas usadas para endereços de correspondência.

espaço: Salas específicas em um edifício.

número_da_rua: Número exato da rua.

estação de ônibus, estação de trem, estação de trânsito: Paradas de trânsito.

PERGUNTAS FREQUENTES

O que você pode fazer com a API de geocodificação reversa?

As empresas que lidam com geocodificação usam amplamente as APIs de geocodificação direta e de geocodificação reversa em software e aplicativos para localizar lojas, veículos e clientes, auxiliando no gerenciamento de transporte e no rastreamento de movimentos.

Mais do que apenas identificação/posicionamento de endereços, a geocodificação reversa é uma ferramenta versátil para mapeamento de localização, planejamento de rotas e análise de dados. Essa tecnologia pode ser benéfica para empresas de logística que precisam de detalhes precisos de localização. Há mais exemplos reais de API de geocodificação reversa em ação em nosso local na rede Internet.

Por que usar a API de geocodificação reversa?

A API de geocodificação reversa do DistanceMatrix.ai fornece dados de localização precisos de 99% do mundo em uma variedade de formatos. Para que você possa obter o endereço correto em segundos de qualquer lugar. É isso que coloca nossa ferramenta em alta demanda em vários setores. Além disso, devido à sua alta precisão, ele compete com os principais fornecedores da área. Outra coisa a se lembrar é que o processo de mudança de qualquer serviço secundário para nossa API é perfeito e sem problemas.

Introdução

Antes de começar Como usar a API de geocodificação Como usar por meio do Postman

Guia do desenvolvedor de geocodificação reversa

Formato da solicitação Parâmetros Respostas Códigos de status Mensagens de erro Resultados Tipos de endereço e tipos de componentes de endereço

Geocodificação direta

PERGUNTAS FREQUENTES

O que você pode fazer com a API de geocodificação?Por que usar a API de geocodificação?

Antes de começar

Como usar a API de geocodificação reversa

Este serviço é acessível por meio de um HTTP interface. Para solicitações de geocodificação reversa, você precisaria enviar uma consulta como coordenadas (latitude e longitude). A lista abaixo detalha os dois parâmetros dessas solicitações.

Ao consultar, você receberá uma resposta na forma de JSON documento contendo os resultados mais pertinentes. Exemplos dessas solicitações e suas respostas correspondentes são fornecidos na documentação abaixo.

A segurança vem em primeiro lugar. É por isso que o HTTPS é altamente recomendado, especialmente para aplicativos que lidam com dados confidenciais, como a localização do usuário. A criptografia HTTPS fortalece a segurança do seu aplicativo, tornando-o mais resistente à vigilância e à modificação.

Nossa API de geocodificação reversa oferece a flexibilidade de fazer solicitações da maneira que melhor atenda às suas necessidades. As instruções detalhadas acima orientam você sobre como fazer essas solicitações usando o Postman, uma ferramenta de interação de API versátil e fácil de usar.

Como usar a API de geocodificação por meio do Postman

Para começar a usar o Postman, instale-o em seu computador ou acesse uma versão web do navegador.
Importe nossa coleção de API pré-configurada:
- Abra o Postman.
- Clique no botão “Importar” no canto superior esquerdo.
- Selecione “Importar do link” e cole este link da coleção Postman: https://www.postman.com/distancematrix/workspace/distance-matrix/overview
Ao importar, o Postman adicionará automaticamente a coleção ao seu espaço de trabalho.
Para usuários da versão on-line do Postman, você pode abrir diretamente o link da coleção e criar um fork. Faça isso clicando nos três pontos ao lado do nome da coleção.
Configure seu ambiente no Postman, vá para a seção Variáveis e adicione seu token de autenticação no campo “Token de autorização da API”.
Não se esqueça de salvar essas alterações.
Faça sua primeira solicitação: selecione um endpoint de nossa coleção, configure seus parâmetros de solicitação e clique em enviar para ver a resposta.

Observe que você pode obter seu token individual no painel de administração. Leia como fazer isso em o artigo.

Não se esqueça de salvar essas alterações.

Guia do desenvolvedor de geocodificação reversa

Formato de solicitação de API

OBTENHA:

https://api-v2.distancematrix.ai/maps/api/geocode/json?latlng=37.422387799999996,-122.08418770000002&key=<your_access_token>

Copiado!

Componentes da solicitação:

Criptografia HTTPS: https:// é usado para comunicação segura.
Domínio: api-v2.distancematrix.ai é o domínio da API precisa.
Caminho da solicitação: /mapas/api/geocodificar/json especifica o tipo de solicitação.
Parâmetro obrigatório: ? latlng=37,422387799999996,-122,08418770000002 especifica a latitude e a longitude para a geocodificação reversa.
Parâmetro opcional: &linguagem= reino unido pode ser adicionado para preferência de idioma.
Token de autorização: &chave=<your_access_token> é necessário para autenticar a solicitação.

Os parâmetros são separados usando o caractere comercial (&), como padrão em URLs.

Essa configuração é personalizada para a API de geocodificação reversa, na qual parâmetros diferentes são usados em comparação com a geocodificação padrão. A página orientará você sobre como obter latitude e longitude de uma API de endereço, incluindo os parâmetros necessários para uso e o tipo de resposta de geocodificação que você pode esperar. Além disso, um exemplo de resposta JSON com base no sinalizador de saída será fornecido.

https://api-v2.distancematrix.ai/maps/api/geocode/json?latlng=29.976480,%2031.131302&key=access_token

Copiado!

Parâmetros necessários em uma solicitação de geocodificação reversa:

latlng: Esse parâmetro obrigatório inclui os valores de latitude e longitude para especificar o local para o qual você deseja obter o endereço. Exemplo:

latlng=37.422387799999996,-122.08418770000002

Copiado!

Siga o vincular para saber mais sobre a chave, sua finalidade, como obtê-la e os limites da API de geocodificação reversa.

Respostas de geocodificação reversa

OBTENHA:

https://api-v2.distancematrix.ai/maps/api/geocode/json?latlng=40.714224,-73.961452&key=<your_access_token>

Copiado!

*Nota importante: Ao inserir o latlng parâmetro, certifique-se de que não haja espaço entre os valores de latitude e longitude.

Exemplo de resposta JSON:

BODY
{
    "result": [
        {
            "address_components": [
                {
                    "long_name": "United States",
                    "short_name": "US",
                    "types": [
                        "country",
                        "political"
                    ]
                },
                {
                    "long_name": "Brooklyn",
                    "short_name": "Brooklyn",
                    "types": [
                        "administrative_area_level_3",
                        "political"
                    ]
                },
                {
                    "long_name": "11211",
                    "short_name": "11211",
                    "types": [
                        "postal_code"
                    ]
                },
                {
                    "long_name": "Brooklyn",
                    "short_name": "Brooklyn",
                    "types": [
                        "locality",
                        "political"
                    ]
                },
                {
                    "long_name": "279",
                    "short_name": "279",
                    "types": [
                        "street_number"
                    ]
                },
                {
                    "long_name": "Bedford Avenue",
                    "short_name": "Bedford Avenue",
                    "types": [
                        "route"
                    ]
                },
                {
                    "long_name": "Michel Cluizel",
                    "short_name": "Michel Cluizel",
                    "types": [
                        "name"
                    ]
                },
                {
                    "long_name": "NY",
                    "short_name": "NY",
                    "types": [
                        "state",
                        "administrative_area_level_1",
                        "political"
                    ]
                }
            ],
            "formatted_address": "279 Bedford Avenue, Kings County, Brooklyn 11211, United States",
            "geometry": {
                "location": {
                    "lat": 40.7142138,
                    "lng": -73.9613419
                },
                "location_type": "APPROXIMATE",
                "viewport": {
                    "northeast": {
                        "lat": 40.7142138,
                        "lng": -73.9613419
                    },
                    "southwest": {
                        "lat": 40.7142138,
                        "lng": -73.9613419
                    }
                }
            },
            "place_id": "4961172027",
            "plus_code": {},
            "types": [
                "street_address"
            ]
        }
    ],
    "status": "OK"
}