Obtenha a chave da API de geocodificação

Guia para desenvolvedores sobre como usar chaves de API com a API de geocodificação

Introdução

A geocodificação é uma solução inovadora para transformar coordenadas geográficas em um endereço legível. Você também pode escolher qualquer endereço real e obter suas coordenadas exatas. Descreveremos em detalhes uma chave da API de geocodificação e sua finalidade.

Neste guia, explicaremos:

  • O que é uma chave de API de geocodificação e por que ela é importante
  • Como obter a chave da API de geocodificação via Distancematrix.ai
  • Como adicionar a chave às suas solicitações de geocodificação
  • Planos de uso gratuitos versus pagos e como eles afetam seus tokens

Você também aprenderá por que nosso serviço oferece uma abordagem mais simples e econômica do que alternativas como o Google ou o Bing.

O que é uma chave de API de geocodificação?

A chave da API de geocodificação — geralmente chamada de “token” — é uma string exclusiva e confidencial que identifica seu aplicativo ou projeto no Distancematrix.ai. Ao incluir essa chave em cada solicitação:

  1. Você autentica suas consultas — O Distancematrix.ai reconhece qual conta está fazendo a chamada.
  2. Você rastreia o uso com precisão — Todas as solicitações sob esse token são contabilizadas no plano ou na cota correta.
  3. Você desbloqueia os recursos certos — Dependendo do seu plano (gratuito ou de crescimento), seu token concede acesso a recursos relevantes, como geocodificação ou geocodificação reversa.

Quer obter a chave da API de geocodificação rapidamente? Inscreva-se em Distancematrix.ai e receba imediatamente após o registro.

Objetivo das chaves de API de geocodificação

O serviço web da API de geocodificação pode ser usado por plataformas web ou desenvolvedores de aplicativos móveis que precisam de dados geográficos precisos. É possível geocodificar somente endereços estáticos, ou seja, aqueles que são conhecidos de antemão. Isso ajudará a colocar o conteúdo de qualquer aplicativo no mapa.

A geocodificação tem certas planos de preços. O custo desse serviço depende do número de itens que você planeja solicitar por mês.

Para entender uma chave da API Geocode, precisamos considerar os parâmetros da solicitação: endereço e chave.

O endereço é o endereço postal que você geocodificará. É importante indicar o endereço no formato especificado usado pelo serviço postal nacional em uma determinada região. Não é necessário adicionar vários detalhes do endereço: o número do apartamento ou o nome da organização.

A chave de API para geocodificação é a identificação do seu aplicativo para gerenciar cotas. Ou seja, é a chave que determina suas ações e seus objetivos.

Você pode usar uma solicitação HTTP específica para monitorar as estatísticas de uso da API de geocodificação. Lá, você especifica o período de tempo necessário e obtém estatísticas para esse intervalo. Você também pode usar essas informações para prever quanto pagará.

Obtendo chaves da API de geocodificação

Para obter uma chave de API de geocodificação, siga estas etapas:

  1. Registre-se em Distancematrix.ai
    • Acesse nossa página de inscrição para criar sua conta gratuita.
    • Você receberá automaticamente um e-mail de confirmação com links e instruções úteis.
  2. Acesse seu painel de administração
    • Depois de fazer login, vá para o Painel de administração.
    • Por padrão, você está no Plano gratuito, que inclui quatro tokens (e você pode criar um quinto).
    • Tokens são essencialmente seus Chaves de API.
  3. Verifique seus limites de tokens
    • Na Plano gratuito, você pode processar 1.000 elementos por mês em todos os tokens.
    • Caso precise de mais elementos mensais ou mais tokens, você pode fazer o upgrade para o Plano de crescimento para uso ilimitado.

Adicionar a chave da API de geocodificação à sua solicitação

Cada solicitação de geocodificação deve incluir sua chave de API do Geocoder como um parâmetro na string de consulta:

https://api.distancematrix.ai/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=<your_access_token>

  • abordar: O endereço postal que você está convertendo em coordenadas.
  • chave: Sua chave de API de geocodificação (token) do painel de administração do Distancematrix.ai.

Formatando endereços:

Use o formato padrão reconhecido pelo serviço postal local. Evite detalhes extras, como números de apartamentos ou nomes comerciais, no campo de endereço.

Restrições para chaves da API de geocodificação

Podemos impor certas restrições de aplicação aos tokens, às vezes necessárias por motivos de segurança. Em um plano gratuito, seus tokens são limitados no número de elementos que você pode usar por mês. Você pode receber 1.000 elementos todos os meses. Depois de usar todos os elementos, você deve fazer o upgrade para o plano Growth ou ficar com a opção gratuita.

Exceto os limites no número de elementos, você não tem nenhuma outra restrição em um plano gratuito. Portanto, sinta-se à vontade para usar todos os recursos de todos os produtos Distancematrix.ai.

O plano pago (plano de crescimento) não tem nenhuma API restritiva; você recebe itens ilimitados por mês. Aqui é importante prestar atenção que em uma solicitação você pode converter apenas um local, que será considerado como um elemento. Pedimos gentilmente não enviar mais de 100 solicitações por segundo devido aos limites de taxa do sistema que garantem estabilidade e uso justo para todos os usuários.

Por favor, sinta-se à vontade para envie uma mensagem de texto e discuta suas perguntas com o gerente, se tiver alguma.

Comece sua integração de geocodificação em minutos

Adquirir uma chave de API de geocodificação do Distancematrix.ai é mais simples e mais econômico em vez de usar o Google, o Bing ou outros provedores. Nós oferecemos um plano gratuito generoso para projetos menores, além de um plano de crescimento acessível com uso ilimitado quando você estiver pronto para escalar.

Com sua nova chave, você pode:

  • Converter endereços de rua para coordenadas precisas
  • Geocodificação reversa coordenadas para endereços
  • Construir recursos personalizados de mapeamento ou otimização de rotas

Comece agora para desbloquear todo o potencial da geocodificação para seus aplicativos ou sites.

Precisa de ajuda?

FAQ

What is Geo API key?

A Geo API key is a unique identifier that developers use to authenticate and access geolocation services, such as Distancematrix.ai. The key allows the developer's application or website to use geolocation services, such as geocoding or reverse geocoding. Developers can get a Geocoding API key automatically by registering for an account.

Is an API key for Geocoding free?

Distancematrix.ai provides a Free plan and a Growth plan. Right after the registration, you can get a geocoding API key free for a limited number of Geocoding API requests per month. If this limit is enough for you, you can continue using it. However, if you require more requests, you will need to upgrade to the paid Growth plan. The pricing and plan details can be found here.

Where can I find Geocoding API key after registration?

After registering to the Distancematrix.ai you will get access to the admin panel. To get a geocoding api key please go to the main dashboard to the section with apps. You can find a geocoding api key there among the other free keys. Every Geocoding API key belongs to one of your Apps. On a free plan, you can use two Geocoding API keys, two Distance Matrix API keys, and one extra key of your choice. You can also delete the keys and create those that you need, but not more than 5. If you need to generate more keys, you should upgrade to the Growth plan.

Geocoding api key on your dashboard

Please read our documentation to learn more about our APIs.

How to get a geocoding API key?

You can easily obtain a geocoding API key by registering with Distancematrix.ai, accessing your admin panel, and creating a token. This token serves as your API key to fulfill geocoding requests.

How many free requests do I get per month?

The Free plan gives you 1,000 elements every month (resets monthly).

Can I exceed 1,000 elements without upgrading immediately?

Once you hit your limit, you’ll stop receiving successful responses. You can upgrade anytime to restore or increase usage.

Não é necessário pagamento antecipado.
Comece gratuitamente e tenha acesso instantâneo a todos os produtos e recursos da Distancematrix.ai