API de Geocodificação de Código Postal dos Correios Poloneses
A API de Geocodificação de Código Postal dos Correios Poloneses é uma API REST robusta e de alto desempenho projetada para busca e gerenciamento eficientes de códigos postais poloneses (PNA). Esta API simplifica o processo de validação de entradas de endereço e melhora a experiência do usuário por meio de sugestões de autocompletar intuitivas. Com suporte para correspondência precisa de números de casas, incluindo verificações de intervalo e lógica de paridade ímpar/par, é uma ferramenta essencial para desenvolvedores e empresas que trabalham com endereços poloneses.
Principais Recursos
- Busque códigos postais usando cidade, rua e números de casas.
- Validação de endereço e autocompletar para maior precisão.
- Suporta requisições GET e POST para maior flexibilidade.
- Geocodificação reversa para encontrar locais com base em latitude e longitude.
- Integração de IA para funcionalidade aprimorada e engajamento do usuário.
1. Buscar Códigos Postais
GET /pna/search
-
Parâmetros de consulta:
-
cidade (obrigatório)
-
rua (opcional)
-
número (opcional)
-
Exemplo:
GET domain/pna/search?city=Wroclaw&street=Kwiska&number=3
POST /pna/search
Corpo (application/json):
{"city":"Bialystok","street":"Mikolaja Kopernika","number":"2a","province":"podlaskie"}
3. Obter Endereços por Código Postal
GET /pna/code/{postalCode}
Exemplo: GET /pna/code/54-210
4. Obter Endereços por Código Postal (POST)
POST /pna/code
Corpo (application/json):
{"postal_code":"54-210"}
5. Geocodificação Reversa
GET /pna/reverse
-
Parâmetros de consulta:
-
Lat (obrigatório)
-
Lon (obrigatório)
-
RadiusKm (opcional, padrão 5)
-
Exemplo:
GET /pna/reverse?Lat=51.12161528781476&Lon=16.98550601056978&RadiusKm=0.1
6. Geocodificação Reversa (POST)
POST /pna/reverse
Corpo (application/json):
{"lat":51.12161528781476,"lon":16.98550601056978,"radius_km":0.1}
7. Autocompletar Ruas
GET /pna/autocomplete/streets
-
Parâmetros de consulta:
-
query (mínimo 2 caracteres)
-
cidade (opcional)
-
Exemplo:
GET /pna/autocomplete/streets?query=Legn&city=Wroclaw
8. Autocompletar Cidades
GET /pna/autocomplete/cities
-
Parâmetros de consulta:
-
query (obrigatório)
-
Exemplo:
GET /pna/autocomplete/cities?query=Wroc
Integração de IA
-
GET
/pna/ai-guide -
GET