Geocoding

Endpoints para convertir un código postal (opcionalmente con calle y número) a coordenadas geográficas, y para el proceso inverso: obtener dirección postal a partir de coordenadas lat/lng.

CP a coordenadas

`GET /info_cp_geocoding/{CP}`

Devuelve la información del CP más coordenadas lat/lng. Si proporcionas calle y número, las coordenadas apuntan a esa dirección específica.

Costo: 1 crédito por petición.

Parámetros

Parámetro	Tipo	Requerido	Descripción
`{CP}`	`string`	Sí	Código postal de 5 dígitos (ruta)
`token`	`string`	Sí	Token de proyecto
`type`	`string`	No	`simplified` para respuesta compacta
`calle`	`string`	No	Nombre de la calle para mayor precisión
`numero`	`string`	No	Número exterior

Request — solo CP

curl "https://api.copomex.com/query/info_cp_geocoding/06600?token=pruebas"

Request — con calle y número

curl "https://api.copomex.com/query/info_cp_geocoding/06600?calle=Paseo%20de%20la%20Reforma&numero=222&token=pruebas"

Respuesta

[
  {
    "error": false,
    "code_error": 0,
    "error_message": null,
    "response": {
      "cp": "06600",
      "asentamiento": "Juárez",
      "tipo_asentamiento": "Colonia",
      "municipio": "Cuauhtémoc",
      "estado": "Ciudad de México",
      "ciudad": "Ciudad de México",
      "pais": "México"
    },
    "geocoding": [
      {
        "lat": 19.4285,
        "lng": -99.1644,
        "label": "Paseo de la Reforma 222, Juárez, Cuauhtémoc, Ciudad de México"
      }
    ]
  }
]

En modo pruebas, lat y lng devuelven null.

Campos adicionales

Campo	Tipo	Descripción
`geocoding[].lat`	`number \| null`	Latitud decimal
`geocoding[].lng`	`number \| null`	Longitud decimal
`geocoding[].label`	`string \| null`	Dirección formateada

Coordenadas a dirección

`GET /info_cp_geocoding_reverse`

Convierte coordenadas lat/lng en una dirección postal con CP, colonia, municipio y estado.

Costo: 2 créditos por petición.

Parámetros

Parámetro	Tipo	Requerido	Descripción
`lat`	`number`	Sí	Latitud decimal
`lng`	`number`	Sí	Longitud decimal
`token`	`string`	Sí	Token de proyecto

Request

curl "https://api.copomex.com/query/info_cp_geocoding_reverse?lat=19.4326&lng=-99.1332&token=pruebas"

Respuesta

{
  "error": false,
  "code_error": 0,
  "error_message": null,
  "response": {
    "label": "Av. Juárez 60, Centro Histórico, Cuauhtémoc, Ciudad de México, 06010",
    "cp": "06010",
    "calle": "Av. Juárez",
    "numero": "60",
    "asentamiento": "Centro Histórico",
    "municipio": "Cuauhtémoc",

Campos de respuesta

Campo	Tipo	Descripción
`label`	`string`	Dirección completa formateada
`cp`	`string`	Código postal de la ubicación
`calle`	`string`	Nombre de la calle
`numero`	`string`	Número exterior estimado
`asentamiento`	`string`	Colonia principal
`municipio`	`string`	Municipio o delegación
`estado`	`string`	Entidad federativa
`pais`	`string`	Siempre `"México"`
`lat`	`string`	Latitud enviada en la petición
`lng`	`string`	Longitud enviada en la petición
`asentamientos_cp`	`string[]`	Todas las colonias del CP encontrado