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.

Endpoints da API

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

 

2. Buscar Códigos Postais (POST)

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 /.well-known/ai-plugin.json