Documentación GIS LATAM

Quickstart

En menos de 5 minutos podés tener tu primera geocodificación funcionando.

1. Obtené tu API key

Registrate en el portal de usuario y generá una key desde la sección API Keys. El plan Starter es gratuito y no requiere tarjeta.

2. Primera geocodificación (curl)

curl -X POST https://api.gislatam.io/ar/geocodificar \
  -H "X-API-Key: glk_prod_tukey" \
  -H "Content-Type: application/json" \
  -d '{
    "calle": "Corrientes",
    "numero": 1234,
    "localidad": "CABA"
  }'

Respuesta esperada

{
  "lat":              -34.6041,
  "lon":              -58.3838,
  "calle_encontrada": "AVENIDA CORRIENTES",
  "numero":           1234,
  "cp":               "1043",
  "confianza":        "ALTA",
  "metodo":           "rango_precision"
}

3. Conectar con Claude (MCP)

// ~/.config/claude/claude_desktop_config.json
{
  "mcpServers": {
    "gis-ar": {
      "url":       "https://api.gislatam.io/ar/sse",
      "transport": "sse",
      "headers": { "X-API-Key": "glk_prod_tukey" }
    },
    "gis-mx": {
      "url":       "https://api.gislatam.io/mx/sse",
      "transport": "sse",
      "headers": { "X-API-Key": "glk_prod_tukey" }
    }
  }
}

Autenticación

Todas las solicitudes deben incluir el header X-API-Key con la clave generada en el portal.

# Header requerido en toda solicitud REST
X-API-Key: glk_prod_••••••••••••••••••

Las API keys son por usuario y por entorno (producción / desarrollo). Rotarlas desde el portal no afecta las keys de otro entorno.

Transporte MCP / REST

El servicio expone dos interfaces equivalentes: MCP (para agentes de IA) y REST (para aplicaciones tradicionales).

Los puertos de servidor local (para desarrollo) son: AR → 8001, MX → 8002, LATAM → 8000.

geocodificar_ar

Convierte una dirección argentina a coordenadas lat/lon usando cartografía de precisión 2024 (2.2M segmentos). Soporta desambiguación por localidad y CP.

Ejemplo de respuesta

{
  "lat":              -32.94334,
  "lon":              -60.63585,
  "calle_encontrada": "CALLE SAN MARTIN",
  "numero":           500,
  "cp":               "2000",
  "confianza":        "ALTA",
  "metodo":           "rango_precision"
}

reverse_geocodificar_ar

De coordenadas lat/lon a dirección postal estructurada en Argentina.

enriquecer_por_coordenada_ar

Dado un punto, devuelve contexto geoespacial completo: POIs cercanos, NSE del área, indicadores INDEC, barrios populares RENABAP y riesgo territorial.

enriquecer_lote_ar

Versión batch de enriquecimiento: acepta una lista de puntos y devuelve el resultado consolidado para todos.

catalogo_capacidades_ar

Retorna el estado actual de todas las capas cargadas: nombre, fuente, cantidad de registros, fecha de actualización y cobertura geográfica.

# Sin parámetros
{
  "capas": [
    { "nombre": "calles_precision", "registros": 2228505, "fuente": "Cartografía de Precisión 2024" },
    { "nombre": "barrios_populares", "registros": 4228, "fuente": "RENABAP 2023" },
    ...
  ]
}

geocodificar_mx

Geocodificación para México usando cartografía de precisión nacional (7M segmentos) + DENUE 2026 (anclas de POI para modelos de regresión de numeración). OSM CDMX como respaldo para Ciudad de México.

reverse_geocodificar_mx

De coordenadas a dirección en México. Retorna calle, número, colonia, municipio, estado y CP.

enriquecer_por_coordenada_mx

Enriquecimiento para México: POIs DENUE/OSM cercanos, NSE estimado, municipio y estado.

enriquecer_lote_mx

Enriquecimiento batch para México. Acepta lista de coordenadas y retorna contexto geoespacial para cada punto.

catalogo_capacidades_mx

Catálogo de capas México: INEGI, DENUE, OSM CDMX, Bienestar, REPEP y SIDECU con counts y metadatos de cobertura. Llamar primero para descubrir capacidades disponibles.

bienestar_por_municipio_mx

Consulta las estadísticas del Plan Bienestar para el municipio que contiene la coordenada indicada. Devuelve conteos, distribución por sexo e importe promedio de los 4 programas federales (21.9M beneficiarios en 2,469 municipios).

Ejemplo de respuesta

{
  "cvegeo":              "09002",
  "municipio":           "Azcapotzalco",
  "estado":              "Ciudad de México",
  "total_beneficiarios":  57736,
  "S038_adultos_mayores": {
    "total":         18450,
    "mujeres":        11230,
    "hombres":        7220,
    "edad_prom":      74.3,
    "importe_prom":   2550.0,
    "pct_total":      31.9
  },
  "S052_discapacidad":   { /* misma estructura */ },
  "S072_sembrando_vida": { /* misma estructura */ },
  "S174_jovenes":        { /* misma estructura */ }
}

verificar_repep_mx

Verifica si un número telefónico está inscrito en el REPEP (Registro Público de Usuarios que No Desean ser Contactados — PROFECO). Llamar a un número registrado en el REPEP constituye una infracción según la Ley Federal de Protección al Consumidor.

Ejemplo de respuesta — registrado

{
  "telefono":   "5512345678",
  "registrado": true,
  "telco":      true,
  "turistico":  true,
  "comercio":   false,
  "estado":     "DF Y AREA METROPOLITANA",
  "alerta":     "NÚMERO EN REPEP — contacto no autorizado viola LFPC"
}

verificar_lote_repep_mx

Versión batch del REPEP. Ideal para higienizar listas de contacto antes de campañas outbound. Devuelve un resumen con porcentaje bloqueado más el detalle por número.

Ejemplo de respuesta

{
  "resumen": {
    "total":           1000,
    "registrados":     47,
    "libres":          950,
    "invalidos":       3,
    "pct_bloqueados":  4.7
  },
  "detalle": [ /* un objeto por número */ ],
  "fuente":   "REPEP Actual — PROFECO México (junio 2025)"
}

centros_cuidado_cercanos_mx

Busca centros de cuidado del SIDECU (Sistema Nacional de Cuidados) cercanos a una coordenada. Cubre escuelas de nivel inicial, guarderías, CENDI, centros comunitarios y más — 128,141 puntos a nivel nacional.

Ejemplo de respuesta

[{
  "nombre":       "ENRIQUE REBSAMEN",
  "tipo":         "Educación preescolar",
  "sector":       "Público",
  "modalidad":    "Gratuito",
  "estatus":      "En operación",
  "municipio":    "Progreso",
  "entidad":      "Yucatán",
  "horario":      "07:00 – 14:00",
  "dias_atencion":"Lunes - Viernes",
  "capacidad":    120,
  "lat":          19.4022,
  "lon":          -99.1655,
  "distancia_m":  284
}]

riesgo_inundacion_mx

Consulta el nivel de riesgo de inundación para un punto geográfico según el Atlas de Riesgo de CONAGUA/SPCGIR. Cobertura: Ciudad de México (4,908 zonas clasificadas a nivel AGEB). Niveles: Muy Alto, Alto, Medio, Bajo, Muy Bajo.

Ejemplo de respuesta — zona de riesgo

{
  "en_zona_riesgo": true,
  "intensidad":    "Muy Alto",
  "nivel_num":     5,
  "fenomeno":      "Hidrometeorológicos",
  "taxonomia":     "Inundaciones",
  "alcaldia":      "Benito Juárez",
  "entidad":       "Ciudad de México",
  "periodo":       "5 años",
  "fuente":        "Atlas de Riesgo SPCGIR / CONAGUA — CDMX 2019"
}

Niveles de confianza

Cada respuesta de geocodificación incluye un campo confianza que indica la calidad de la resolución.

Códigos de error

Changelog