API de Geocodificación de Códigos Postales de Poczta Polska

La API de Geocodificación de Códigos Postales de Poczta Polska es una API REST robusta y de alto rendimiento diseñada para la búsqueda y gestión eficiente de códigos postales polacos (PNA). Esta API simplifica el proceso de validación de entradas de direcciones y mejora la experiencia del usuario a través de sus sugerencias de autocompletado intuitivas. Con soporte para coincidencias precisas de números de casa, incluyendo tanto verificaciones de rango como lógica de paridad impar/par, es una herramienta esencial para desarrolladores y empresas que trabajan con direcciones polacas.

Características Clave

  • Búsqueda de códigos postales utilizando ciudad, calle y números de casa.
  • Validación de direcciones y autocompletado para mejorar la precisión.
  • Soporta tanto solicitudes GET como POST para mayor flexibilidad.
  • Geocodificación inversa para encontrar ubicaciones basadas en latitud y longitud.
  • Integración de IA para mejorar la funcionalidad y el compromiso del usuario.

Puntos Finales de la API

1. Buscar Códigos Postales

GET /pna/search

  • Parámetros de consulta:

  • ciudad (requerido)

  • calle (opcional)

  • número (opcional)

  • Ejemplo: GET domain/pna/search?city=Wroclaw&street=Kwiska&number=3

 

2. Buscar Códigos Postales (POST)

POST /pna/search

Cuerpo (application/json):

{"city":"Bialystok","street":"Mikolaja Kopernika","number":"2a","province":"podlaskie"}

3. Obtener Direcciones por Código Postal

GET /pna/code/{postalCode}

Ejemplo: GET /pna/code/54-210

4. Obtener Direcciones por Código Postal (POST)

POST /pna/code

Cuerpo (application/json):

{"postal_code":"54-210"}

5. Geocodificación Inversa

GET /pna/reverse

  • Parámetros de consulta:

  • Lat (requerido)

  • Lon (requerido)

  • RadioKm (opcional, por defecto 5)

  • Ejemplo: GET /pna/reverse?Lat=51.12161528781476&Lon=16.98550601056978&RadiusKm=0.1

6. Geocodificación Inversa (POST)

POST /pna/reverse

Cuerpo (application/json):

{"lat":51.12161528781476,"lon":16.98550601056978,"radius_km":0.1}

7. Autocompletar Calles

GET /pna/autocomplete/streets

  • Parámetros de consulta:

  • consulta (mínimo 2 caracteres)

  • ciudad (opcional)

  • Ejemplo: GET /pna/autocomplete/streets?query=Legn&city=Wroclaw

8. Autocompletar Ciudades

GET /pna/autocomplete/cities

  • Parámetros de consulta:

  • consulta (requerido)

  • Ejemplo: GET /pna/autocomplete/cities?query=Wroc

Integración de IA

  • GET /pna/ai-guide

  • GET /.well-known/ai-plugin.json