A geocodificação transforma endereços de rua em coordenadas geográficas precisas — e a geocodificação reversa faz o oposto, convertendo coordenadas de volta em um endereço legível. Para usar esses recursos programaticamente, você precisa de uma chave de API de geocodificação: um token único que autentica suas solicitações ao Distancematrix e rastreia seu uso em relação ao seu plano. Este guia cobre o que é uma chave de API de geocodificação, como obter acesso à chave de API de geocodificação, como adicioná-la às suas solicitações e como os planos gratuitos vs. pagos afetam seu uso — além de por que o Distancematrix é uma alternativa mais simples e econômica em comparação ao Google ou Bing.
- Inscreva-se para uma conta gratuita Distancematrix.ai
- Abra o Painel de Administração
- Copie um dos seus tokens padrão
- Crie uma solicitação na sua área de trabalho.
O que é uma Chave de API de Geocodificação?
Uma chave de API de geocodificação — frequentemente chamada de “token” — é uma string única e confidencial que identifica sua aplicação ao Distancematrix. Incluí-la em cada solicitação permite que você:
- Autentique suas consultas — Distancematrix.ai reconhece qual conta está chamando.
- Rastreie o uso com precisão — cada solicitação sob esse token conta para a cota do seu plano.
- Desbloqueie os recursos certos — seu token concede acesso às capacidades incluídas no seu plano (Gratuito ou Crescimento), como geocodificação ou geocodificação reversa.
Inscreva-se no Distancematrix.ai para obter uma chave de API de geocodificação instantaneamente após o registro.
Propósito de uma Chave de API de Geocodificação
Desenvolvedores web e móveis usam a API de Geocodificação quando precisam de dados geográficos precisos — por exemplo, para colocar conteúdo em um mapa. Ela geocodifica endereços estáticos e conhecidos. A precificação depende de quantos elementos você solicita por mês.
Cada solicitação de geocodificação precisa de dois parâmetros principais:
- endereço — o endereço postal a ser geocodificado, formatado da maneira como o serviço postal local o formata. Pule detalhes extras como números de apartamento ou nomes de organizações.
- chave — sua chave de API de geocodificação, que identifica sua conta e gerencia sua cota.
Você também pode consultar um endpoint de estatísticas de uso para qualquer período de tempo, o que é útil para monitorar o consumo e prever custos.
Obtendo uma Chave da API de Geocodificação: Guia Rápido
Para obter sua chave da API de geocodificação, você deve seguir um rápido processo de três etapas. Siga os passos abaixo para ter uma chave pronta para uso em minutos.
1. Registre-se no Distancematrix — crie uma conta gratuita através da página de inscrição. Você receberá um e-mail de confirmação com os próximos passos.
2. Abra seu Painel de Administração — após fazer login, você será direcionado para o plano Gratuito por padrão, que inclui quatro tokens (você pode criar um quinto). Tokens são suas chaves da API.
3. Verifique seus limites de token — o plano Gratuito cobre 1.000 elementos por mês, combinados entre todos os tokens. Precisa de mais tokens ou elementos? Faça upgrade para o plano Growth para uso ilimitado.
Adicionando a Chave da API de Geocodificação à Sua Requisição
Toda requisição de geocodificação deve incluir sua chave como um parâmetro de consulta:
- endereço — o endereço postal que você está convertendo em coordenadas.
- chave — sua chave da API de geocodificação do painel de administração do Distancematrix.ai.
Use o formato de endereço reconhecido pelo serviço postal local, sem números de apartamento ou nomes de empresas.
Restrições para Chaves da API de Geocodificação
No plano Gratuito, os tokens são limitados a 1.000 elementos por mês combinados — caso contrário, não há outras restrições, então todos os recursos do Distancematrix.ai estão disponíveis. O plano Growth remove completamente o limite de elementos. Observe que cada requisição converte uma localização, contada como um elemento, e — independentemente do plano — as requisições são limitadas a 100 por segundo para manter o sistema estável para todos os usuários.
Dúvidas? Entre em contato com nossa equipe de suporte a qualquer momento.
Comece sua Integração de Geocodificação em Minutos
Obter uma chave de API de geocodificação da Distancematrix.ai é mais simples e econômico do que Google, Bing ou outros provedores: um generoso plano gratuito para projetos menores, além de um plano de crescimento acessível com uso ilimitado quando você estiver pronto para escalar.
Com sua chave, você pode:
- Converter endereços de rua em coordenadas precisas
- Geocodificar coordenadas de volta 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? Nossa equipe de suporte está disponível a qualquer momento, e nossa documentação cobre integrações avançadas, melhores práticas e exemplos de código.
