Saltar a los endpoints

07/1 endpoints

API de geocodificación inversa

Convierte un par de latitud y longitud en el código postal de México más cercano, con su estado y municipio. Este endpoint está activo, pero ningún código postal del catálogo trae coordenadas todavía.

Todavía no hay datos detrás de este endpoint

Todos los endpoints de esta página están desplegados y responden, pero el catálogo que va detrás no está cargado, así que los resultados vuelven vacíos. Las formas de solicitud y respuesta de abajo son el contrato y no van a cambiar cuando lleguen los datos. Nada más de la API se ve afectado.

URL base https://api.postalkit.mx
Autenticación
GET /v1/geocode/reverse

Geocodificación Inversa

Encuentra el código postal más cercano a las coordenadas de latitud y longitud dadas.

Parámetros de Consulta

Parámetro Tipo Descripción
lat number Latitud (-90 a 90)
lng number Longitud (-180 a 180)

Solicitud

curl
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.postalkit.mx/v1/geocode/reverse?lat=19.4233&lng=-99.1637"

Respuesta

200 Éxito
{
  "data": {
    "id": 384,
    "code": "06600",
    "state": { "id": 1, "name": "Ciudad de México", "code": "09" },
    "municipality": { "id": 6, "name": "Cuauhtémoc", "code": "015" },
    "city": null,
    "settlements": [],
    "latitude": "19.4233000",
    "longitude": "-99.1637000"
  }
}
404 Sin Resultados
{ "message": "No geocoded postal codes found near the given coordinates." }
422 Error de Validación
{ "message": "The given data was invalid.", "errors": { "lat": ["The lat field is required."], "lng": ["The lng field is required."] } }

¿Listo para construir?

Comienza a consultar el catálogo postal completo en minutos.

curl -s https://api.postalkit.mx/v1/postal-codes/06600 -H "Authorization: Bearer YOUR_API_KEY"