| Versão |
Autor |
Data |
Ação |
| 1.0 |
Felipe Rabelo |
23 de jul. de 2024 |
Início da documentação |
| 1.1 |
Felipe Rabelo |
14 de fev. de 2025 |
Inclusão do link de acesso |
Descrição
- A API Geocode é uma plataforma que realiza a conversão de endereços em coordenadas geográficas.
- Estruturada no padrão REST, a API utiliza requisições HTTP para retornar o JSON com os dados correspondentes ao ponto informado.
- A Pathfind disponibiliza três planos de geocodificação: Geocode, Geoloc e Geoloc Premium; conforme tabela abaixo:
Link de acesso: https://southamerica-east1-geocode-service-prod-383511.cloudfunctions.net/homol-ptf-geocode-1
| Requisitos |
Geocode |
Geoloc |
Geoloc Premium |
Arquivos |
| Retornar coordenadas geográficas a partir de endereços |
✅ |
✅ |
✅ |
✅ |
| Acuracidade média |
85% |
90% |
95% |
|
| Algoritmo de tratamento léxico nos endereços submetidos |
1 algoritmo |
+ 2 algoritmos |
+ 3 algoritmos |
|
| Informa a precisão da coordenada encontrada |
✅ |
✅ |
✅ |
✅ |
| Modo de aproximação (centroíde) |
|
|
|
|
Em casos de endereços não encontrados 100%, ele pode ser posicionado no centroíde da rua, bairro, estado ou país | ✅ | ✅ | ✅ | ✅ |
| Múltiplas chamadas em APIs | - | + 2 chamadas | + 5 chamadas | ➖ |
| Busca avançada utilizando APIs | 1 API | 1 API | + 2 APIs | |
| Mapas | Here | Here & Google | Here & Google | |
Funcionalidades
- Retornar as coordenadas do endereço informado
- Retornar endereço completo de um POI (Ponto de Interesse)
- Retornar o ponto central (centroide) da rua, bairro, cep, cidade e estado caso não seja encontrado o endereço informado
Detalhamento dos Endpoints
| Funcionalidade |
Definição |
Forma de Envio |
| Geocodificação |
Permite geocodificar o endereço informado |
[POST] |
<URL>/ ptf-geocode-native |
|
|
Geocodificação
[POST] <URL>/ ptf-geocode-native
- Objetivo: permite geocodificar o endereço informado.
- Parâmetros possíveis: header, body