Códigos Postais Mais Próximos API PNA dos Correios Poloneses

A API PNA dos Correios Poloneses para Códigos Postais Mais Próximos é uma API REST robusta e de alto desempenho projetada para busca e gerenciamento eficiente de códigos postais poloneses (PNA). Esta API simplifica o processo de validação de entradas de endereços e melhora a experiência do usuário através de suas sugestões intuitivas de autocompletar. 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

  • Busca de códigos postais usando cidade, rua e números de casas.
  • Validação de endereços e autocompletar para maior precisão.
  • Suporta solicitaçõ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. Busca de 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. Busca de 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