API de geocodificación y marco geográfico oficial de México

✓ Marco oficial, no solo un pin

Cada resultado trae colonia (INE), manzana, código postal y jerarquía administrativa con procedencia legal — el dato que un pin de lat/lng no te da.

✓ Privacidad por diseño

No registramos ni cacheamos las direcciones que consultas: no van a logs, métricas ni facturación. Pensado para KYC, fintech, salud y gobierno.

✓ Rápido

Respuesta típica en milisegundos, sobre infraestructura en México.

curl

curl -G "https://api.tlaloc.sh/mx/v1/geo/geocode" \
  -H "Authorization: Bearer tlmx_TU_API_KEY" \
  --data-urlencode "address=Av. Paseo de la Reforma 222, Juárez, 06600 Cuauhtémoc, CDMX"

Python

import requests

r = requests.get(
    "https://api.tlaloc.sh/mx/v1/geo/geocode",
    headers={"Authorization": "Bearer tlmx_TU_API_KEY"},
    params={"address": "Av. Paseo de la Reforma 222, Juárez, 06600 Cuauhtémoc, CDMX"},
)
mejor = r.json()["candidates"][0]
print(mejor["lat"], mejor["lng"], mejor["confidence"])

JavaScript

const params = new URLSearchParams({
  address: "Av. Paseo de la Reforma 222, Juárez, 06600 Cuauhtémoc, CDMX",
});
const r = await fetch(`https://api.tlaloc.sh/mx/v1/geo/geocode?${params}`, {
  headers: { Authorization: "Bearer tlmx_TU_API_KEY" },
});
const { candidates } = await r.json();

Respuesta (abreviada)

{
  "query": "Av. Paseo de la Reforma 222, Juárez, 06600 Cuauhtémoc, CDMX",
  "parsed": { "calle": "PASEO DE LA REFORMA", "num_ext": "222", "cp": "06600", "...": "..." },
  "candidates": [
    {
      "lng": -99.1595,
      "lat": 19.4283,
      "confidence": 0.94,
      "eje": { "nombre": "PASEO DE LA REFORMA", "tipo": "AVENIDA", "...": "..." },
      "numeracion": { "in_range": true, "interpolated": false, "...": "..." },
      "marco": {
        "estado": { "cve_ent": "09", "nombre": "Ciudad de México" },
        "municipio": { "cvegeo": "09015", "nombre": "Cuauhtémoc" },
        "colonia": { "nombre": "JUÁREZ", "cp": "06600", "fuente": "ine_bgd" },
        "cp": { "codigo": "06600" },
        "manzana": { "cvegeo": "0901500010010010", "...": "..." }
      }
    }
  ]
}

¿Qué datos devuelve además de lat/lng?

Cada resultado puede incluir el marco geográfico oficial completo del punto: estado y municipio (INEGI MGN), localidad, AGEB, manzana, el polígono de código postal y la colonia oficial de los polígonos del INE, además de las calles cercanas. Es el dato administrativo que un pin de lat/lng no te da.

¿De dónde vienen los datos?

De fuentes 100% oficiales y abiertas: el Marco Geoestadístico de INEGI, los polígonos de colonias del INE, Overture Maps, DENUE y SEPOMEX. Cada respuesta indica la procedencia de sus capas.

¿Guardan las direcciones que consulto?

No. Las direcciones consultadas son datos personales y nunca se registran ni se cachean: no aparecen en logs, en métricas ni en los detalles de facturación. Los registros del servicio solo llevan ruta, estatus y duración.

¿Qué tan preciso es?

En hold-outs limpios (n=2500, sin fuga de datos) medimos una mediana de 14–17 m y hit@50m de 67.8–71.2%. Son cifras sobre direcciones bien formadas: con direcciones reales sucias la precisión puede ser menor. Cada candidato trae su score de confianza y el método usado para que decidas qué aceptar.

¿Cuánto cuesta?

Geocodificación $0.05 MXN, marco geográfico inverso $0.02 MXN y CP → polígono $0.01 MXN por consulta (IVA incluido). El modelo es prepagado vía SPEI, sin tarjeta, sin mensualidades y sin mínimos; solo se cobran las respuestas exitosas. Ver precios.

¿Puedo geocodificar en lote?

Sí. POST /v1/geo/batch acepta hasta 100 ítems mixtos (geocode, reverse o CP) en una sola petición y se factura por ítem exitoso al precio de la operación correspondiente.

¿Funciona con asistentes de IA?

Sí. El servidor MCP de Tlaloc expone las herramientas geocodificar_direccion y consultar_marco_geografico, así que Claude, ChatGPT o cualquier cliente MCP pueden geocodificar directamente con tu API key.