API de geocodificação precisa | Documentação e exemplos
Antes de começar
Da mesma forma, a geocodificação reversa converte as coordenadas geográficas em um endereço legível.
Como usar a API de geocodificação
Depois de enviar sua solicitação, o serviço responde com um documento em formato JSON contendo os resultados mais relevantes, idealmente estruturado para uso direto e integração com várias plataformas — de navegadores da Web a diferentes tipos de aplicativos.
A segurança é importante e o HTTPS é recomendado sempre que possível, especialmente para aplicativos que incluem dados confidenciais do usuário, como a localização do usuário, nas solicitações. O uso da criptografia HTTPS torna seu aplicativo mais seguro e mais resistente a espionagem ou adulteração.
Abaixo, você encontra exemplos e instruções sobre nossas solicitações HTTPS de APIs de geocodificação, adequadas para uma ampla variedade de abordagens, seja por meio de um navegador da web, de qualquer plataforma ou aplicativo de sua escolha ou de sistemas como o Postman. Essa orientação inclui descrições abrangentes sobre como formar solicitações e interpretar respostas em diferentes ambientes.
Como usar a API de geocodificação por meio do Postman
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:
- Carteiro aberto
- 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.

-min.webp)
-min.webp)
-min.webp)
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 direta
Formato de solicitação de API
- URL base: No serviço de geocodificação DistanceMatrix.ai, as solicitações são estruturadas como URLs com parâmetros obrigatórios e opcionais, separados pelo caractere comercial (&). Use criptografia HTTPS para segurança: https://.
- Domínio: O domínio preciso da API DistanceMatrix.ai é api.distancematrix.ai
- URL da solicitação: Para geocodificação, é /mapas/api/geocodificar/json.
- Parâmetros: os parâmetros são informações adicionais que são adicionadas ao URL da solicitação para fornecer detalhes específicos à API. Esses parâmetros podem ser categorizados em dois tipos: obrigatórios e opcionais.
- Parâmetros necessários são obrigatórios para que a API processe a solicitação com êxito, pois fornecem informações essenciais sem as quais a API não pode realizar a operação pretendida. Assim, em uma solicitação da API de geocodificação, o endereço para o qual você precisa das coordenadas geográficas é um parâmetro obrigatório. Sem esse endereço, a API não saberia em qual local geocodificar. Por exemplo, para um local de interesse como a Casa de Anne Frank ? endereço=Westermarkt+20, +1016+GV+Amsterdã, +Holanda especifica o endereço para a geocodificação padrão.
- Parâmetros opcionais não são obrigatórios, mas podem ser incluídos para refinar ou personalizar a resposta da API. Os parâmetros opcionais podem fornecer controle adicional sobre o formato da resposta da API, o idioma no qual os dados são retornados ou outras especificações relevantes à solicitação. Por exemplo, em uma solicitação de geocodificação, um parâmetro opcional pode ser o idioma no qual você deseja que os resultados sejam retornados, como &linguagem= reino unido para especificar uma preferência de idioma. A inclusão desse parâmetro não é necessária para a função de geocodificação em si, mas pode melhorar a usabilidade dos dados.
- Token de autorização: Inclua seu token de acesso exclusivo como &chave=<your_access_token> para autenticar a solicitação.
Parâmetros opcionais em uma solicitação de geocodificação:
- Veja a lista de idiomas compatíveis.
- O geocodificador assume como padrão o idioma especificado no cabeçalho Accept-Language ou o idioma nativo do domínio da solicitação se nenhum idioma for fornecido.
- Para garantir a legibilidade, o geocodificador retorna endereços no idioma local, usando transliteração quando necessário, com base no idioma preferido do usuário. Todos os componentes do endereço são entregues no mesmo idioma, determinado pelo idioma do primeiro componente.
- Se um nome de endereço não estiver disponível no idioma preferido, o geocodificador seleciona a correspondência mais próxima disponível.
- O idioma preferido influencia sutilmente a seleção e a ordem dos resultados, pois o geocodificador interpreta abreviações e sinônimos de forma diferente entre os idiomas. Por exemplo, “utca” e “tér” em húngaro correspondem a “rua” e “praça”.
Parâmetros necessários em uma solicitação de geocodificação:
abordar=100% 20Rainhas% 20estacionar% 20Toronto%20 EM onde “100 Queens Park, Toronto, ON” é o endereço do Museu Real de Ontário
Respostas de geocodificação
Observe que esses resultados geralmente precisam ser analisados se você quiser extrair valores dos resultados.
Códigos de status
Mensagens de erro
*Nota: O campo “error_message” pode nem sempre estar disponível e seu conteúdo pode mudar.
Resultados
Os campos típicos em um resultado incluem:
- localização: contém latitude e longitude. Normalmente, é crucial para pesquisas de endereço padrão.
- location_type: fornece detalhes adicionais sobre a localização, com valores como:
- “TELHADO”: Um código geográfico preciso com precisão de endereço de rua.
- “INTERVALO_INTERPOLADO”: Um resultado aproximado entre dois pontos precisos, geralmente usado quando os dados do telhado não estão disponíveis.
- “CENTRO_GEOMÉTRICO”: O centro geométrico de uma linha ou área.
- “APROXIMADO”: Uma localização aproximada.
Tipos de endereço e tipos de componentes de endereço
O geocodificador suporta e retorna vários tipos em matrizes de tipo de endereço e tipo de componente:
PERGUNTAS FREQUENTES
O que diferencia essa API de outras APIs de geocodificação?
A API de geocodificação Distancematrix.ai tem vários fatores que a diferenciam de outras APIs de geocodificação:
- Alta precisão: A API de geocodificação do Distancematrix.ai usa algoritmos e fontes de dados avançados para fornecer resultados de geocodificação precisos e confiáveis. A API também tem uma alta taxa de sucesso na correspondência de endereços, o que significa que ela pode lidar com uma grande variedade de formatos e variações de endereço.
- Cobertura global: a API abrange uma ampla variedade de países e regiões, incluindo lugares de difícil acesso, como áreas rurais, ilhas e países em desenvolvimento. Isso significa que os usuários podem confiar na API para fornecer resultados precisos, independentemente da origem dos dados.
- Velocidade e escalabilidade: A API foi projetada para lidar com grandes volumes de solicitações de geocodificação de forma rápida e eficiente.
- Econômico: a API oferece um modelo de preços simples e transparente, sem taxas ocultas ou custos iniciais. A API oferece um plano gratuito e um plano de crescimento com modelo de preços pré-pago.
Posso usar essa API como um endereço de conversão para uma API de longa duração?
Sim, você pode usar a API de geocodificação Distancematrix.ai para converter endereços em coordenadas de latitude-longitude. Na verdade, essa é uma das principais funções de um endereço para uma API duradoura como esta.
Para usar a API para geocodificação, você enviaria uma solicitação à API com um parâmetro de endereço, e a API responderia com as coordenadas lat-long correspondentes para esse endereço.
A API de geocodificação Distancematrix.ai foi projetada como uma API de obtenção de latitude e longitude do endereço que é fácil de usar. Ele pode ser integrado a uma ampla variedade de aplicativos e plataformas. A API oferece suporte a uma variedade de linguagens e estruturas de programação, incluindo Python, JavaScript e PHP, entre outras.
Posso usar essa API como um conversor de API de latitude e longitude para endereços legíveis por humanos?
Sim, você pode usar a API de geocodificação Distancematrix.ai para converter coordenadas de latitude-longitude (lat-long) em endereços legíveis por humanos. Esse processo também é conhecido como geocodificação reversa e os desenvolvedores geralmente pesquisam por uma API de latitude e longitude ou por coordenadas de agentes da API de endereço.
Para usar a API para geocodificação reversa, você enviaria uma solicitação à API com os parâmetros de latitude e longitude, e a API responderia com o endereço correspondente legível por humanos para essas coordenadas.
Se você tiver alguma dúvida ou precisar de mais ajuda para usar a API para suas necessidades de geocodificação reversa, a equipe do Distancematrix.ai fornece documentação detalhada e suporte ao cliente para ajudá-lo a começar.
O que você pode fazer com a API de geocodificação?
Muitas empresas e empreendimentos usam software e aplicativos para localizar lojas, armazéns, veículos e clientes, para controlar o transporte e os movimentos que lidam com a geocodificação. Mas, atualmente, sua definição não se limita às pesquisas de endereços. É uma ferramenta bastante universal que permite aplicá-la ao mercado geral, desde a localização precisa e o mapeamento de rotas até a análise de dados do cliente e o reconhecimento de padrões geográficos.
Essa solução é útil, por exemplo, entre motoristas de táxi, caso não tenham dados precisos sobre os endereços de destino dos clientes. Além disso, esse serviço é conveniente para entregadores de comida em suas rotinas diárias. Você pode ler outros exemplos de API de geocodificação bem-sucedidos usando nosso local na rede Internet.
Por que usar a API de geocodificação?
As APIs Distancematrix.ai oferecem a melhor precisão da categoria que rivaliza com os gigantes do setor, mas a um preço muito mais acessível, maior escalabilidade e uma equipe de suporte humano amigável e real, sempre disponível para ajudá-lo com suas dúvidas. Um benefício adicional é a facilidade de transição de outros fornecedores, garantindo um processo de troca tranquilo.
Além disso, o Distancematrix.ai permite que os usuários testem o serviço sem a necessidade de anexar um cartão de crédito/débito antes de tomar uma decisão final. Isso é feito para que os usuários possam verificar a qualidade e o valor dos resultados obtidos. Sinta-se à vontade para tentar garantir que o Distancematrix.ai seja uma solução de alta qualidade, rápida e econômica. Além disso, mesmo durante o período de teste, os usuários podem entrar em contato com o suporte ao vivo disponível para qualquer dúvida.
O que é uma API de geocodificação?
Uma API de geocodificação é um serviço que converte endereços em coordenadas geográficas (latitude/longitude) e vice-versa. Ele permite que os aplicativos posicionem com precisão localizações em mapas, calculem distâncias entre pontos e executem operações baseadas em localização.
A API de geolocalização é gratuita?
Sim, a API de geolocalização oferece um plano gratuito no qual você pode usar até 1000 elementos por mês.