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.
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
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