Códigos Postales Más Cercanos API PNA de Correos Polacos
La API PNA de Códigos Postales Más Cercanos de Correos Polacos 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 autocompletar intuitivas. Con soporte para la coincidencia precisa de números de casa, que incluye tanto comprobaciones 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
- Buscar códigos postales utilizando ciudad, calle y números de casa.
- Validación de direcciones y autocompletar 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.
1. Buscar Códigos Postales
GET /pna/search
-
Parámetros de consulta:
-
ciudad (requerido)
-
calle (opcional)
-
número (opcional)
-
Ejemplo:
GET dominio/pna/search?city=Wroclaw&street=Kwiska&number=3
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)
-
RadiusKm (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:
-
query (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:
-
query (requerido)
-
Ejemplo:
GET /pna/autocomplete/cities?query=Wroc
Integración de IA
-
GET
/pna/ai-guide -
GET