Skip to main content

API de Geocodificação

Converta Endereços em Coordenadas e Vice-Versa

Transforme endereços em coordenadas precisas e coordenadas em endereços legíveis. Essencial para qualquer aplicação que precise trabalhar com dados de localização.

Principais Recursos

Geocodificação precisa para cada caso de uso

Geocodificação Direta

Converta endereços e nomes de lugares em coordenadas geográficas precisas (latitude/longitude)

Geocodificação Reversa

Transforme coordenadas em endereços legíveis com informações detalhadas de localização

Preenchimento Automático

Forneça sugestões de lugares e endereços em tempo real conforme digita com filtragem inteligente de localização e controles de limites

Cobertura Global

Geocodifique endereços em todo o mundo com suporte para formatos de endereços internacionais

Alta Precisão

Precisão ao nível do telhado para endereços com coordenadas específicas do edifício

Resultados Consistentes

Geocodificação confiável e reproduzível com altas taxas de sucesso e classificação de qualidade

Geocodificação Inversa: Converter Coordenadas em Endereço

A geocodificação inversa recebe um par de latitude e longitude e retorna o endereço legível mais próximo. É o inverso da geocodificação direta, onde se parte de um endereço para obter coordenadas. A geocodificação inversa alimenta qualquer aplicação em que o utilizador parte de um ponto no mapa: localizadores de lojas, confirmações de pontos de entrega, check-ins por GPS, fotos com geotag e agentes de AI que precisam de um endereço verificável para uma coordenada fornecida pelo utilizador.

A MapAtlas Geocoding API devolve a decomposição completa do endereço para qualquer coordenada: rua, número, bairro, cidade, região, código postal e país, em qualquer um dos formatos de endereço do mundo. A resposta é consistente entre países e suficientemente estável para ser comparada com os seus registos existentes.

Exemplo de pedido

curl -X GET "https://api.mapatlas.xyz/v1/geocode/reverse?lat=52.3676&lon=4.9041" \
  -H "Authorization: Bearer YOUR_API_KEY"

Cobertura Global com Precisão Exata

Nosso motor de geocodificação oferece precisão líder do setor em mais de 190 países e territórios. Alimentado por dados do OpenStreetMap e análise avançada de endereços, fornecemos pontuação de confiança e metadados detalhados para cada resultado.

190+
Países Cobertos
High
Taxa de Precisão
<100ms
Tempo Médio de Resposta
  • Pontuação de confiança para cada resultado de geocodificação
  • Componentes de endereço detalhados (rua, cidade, código postal)
  • Suporte para entrada de endereço estruturada e livre

Recursos Avançados para Cada Caso de Uso

Vá além da geocodificação básica com recursos poderosos projetados para aplicações de produção. Da análise de endereços estruturados ao suporte multilíngue, fornecemos as ferramentas necessárias para criar serviços sofisticados baseados em localização.

Normalização de Endereço

Padronize e limpe formatos de endereços inconsistentes em componentes estruturados e validados

Suporte Multilíngue

Retorne resultados em vários idiomas com suporte Unicode para aplicações globais

Preenchimento Automático e Sugestões

Sugestões de endereços em tempo real conforme você digita para melhor UX e precisão

Compatível com GDPR

Arquitetura focada em privacidade sem retenção de dados e infraestrutura hospedada na UE

Normalizado
"123 main st"
↓
123 Main Street
City, State ZIP
Multilíngue
?text=Tokyo Tower
&lang=ja

// 東京タワー
// 日本
Preenchimento Automático
/autocomplete
?text=Eiffe

// Eiffel Tower
// Eiffel 65
Compatível com GDPR
Sem logs de dadosSem retençãoServidores na UE

Especificações Técnicas

Capacidades Principais

Tipos de Geocodificação
Direta e Reversa
Precisão
Precisão ao nível do telhado

Cobertura e Escala

Cobertura
Global, todos os países
Preenchimento Automático
Sugestões em tempo real

Formato de Dados

Formato de Resposta
JSON com detalhes completos
Codificação
UTF-8, todos os idiomas

Preços

Nível Gratuito
10,000 geocodificações/mês
Limites de Taxa
Ilimitado

Pronto para Começar?

Comece a construir com MapAtlas hoje. Cadastre-se gratuitamente e obtenha acesso instantâneo a todas as nossas APIs de mapeamento com limites generosos no nível gratuito.

Perguntas frequentes sobre a API de Geocodificação

Tudo o que você precisa saber antes de integrar a API de Geocodificação do MapAtlas.

Construindo com IA? Chame esta API diretamente do seu agente.

Cursor, Copilot, Cline e agentes autônomos usam este endpoint via spec pública OpenAPI 3.1 ou o MCP server da MapAtlas. Auto-discovery, sem glue code.

Ver guia de integração IA

Perguntas frequentes sobre a API de Geocodificação

Tudo o que você precisa saber antes de integrar a API de Geocodificação do MapAtlas.

Qual é a diferença entre geocodificação direta e inversa?
A geocodificação direta converte um endereço de texto em coordenadas (latitude e longitude). A geocodificação inversa faz o oposto: recebe coordenadas e retorna o endereço mais próximo. A API de Geocodificação do MapAtlas suporta ambas em uma única integração.
Quão precisa é a geocodificação do MapAtlas?
A geocodificação do MapAtlas usa uma combinação de bancos de dados de endereços oficiais, dados do OpenStreetMap e enriquecimento de dados proprietário para oferecer precisão no nível de rua em toda a Europa e em todo o mundo. Pontuações de confiança são retornadas com cada resultado para que seu aplicativo possa lidar com correspondências incertas com elegância.
Posso geocodificar em lote?
Sim. O MapAtlas suporta geocodificação em lote via nossa API com até 1.000 endereços por solicitação. Isso é ideal para migrar bancos de dados de endereços, enriquecer dados de CRM ou processar endereços de entrega.
A API de Geocodificação é compatível com o GDPR?
Todas as solicitações de geocodificação são processadas em servidores baseados na UE e nenhum endereço ou coordenada é armazenado além do ciclo de vida da solicitação. O MapAtlas funciona em centros de dados europeus certificados ISO 27001 e é compatível com o GDPR.
Quais formatos a API de Geocodificação retorna?
Os resultados são retornados como JSON com componentes de endereço estruturados (rua, cidade, CEP, país), coordenadas e uma pontuação de confiança. A saída GeoJSON também é suportada.
Como converto latitude e longitude em um endereço?
Use o endpoint de reverse geocoding. Envie lat e lng como parâmetros de query e a API retorna o endereço postal mais próximo com campos estruturados para rua, cidade, CEP e país. O endpoint tem rate limit generoso no plano gratuito e suporta lookups em lote nos planos pagos.
Como converto um endereço em coordenadas?
Chame o endpoint de forward geocoding com o endereço como uma única string de texto. A API retorna um ou mais candidatos, cada um com latitude e longitude precisas, um confidence score e os componentes que deram match. Você decide se pega o primeiro resultado ou apresenta um seletor.
Isto funciona como verificador de endereços?
Sim. Forward geocoding também serve como validação de endereço: se a API retorna um match com alta confiança em nível de telhado ou rua, o endereço é válido e resolvível. Se o melhor match cai para o centroide de uma cidade ou CEP, esse é o sinal para marcar o endereço como suspeito no seu checkout ou onboarding.