Servicio de catálogos

El servicio de catálogos proporciona acceso a información de referencia fundamental utilizada por todos los demás servicios de la plataforma DataInt. Este microservicio expone catálogos estandarizados de ubicaciones geográficas, datos demográficos, clasificaciones de crímenes e indicadores de percepción de seguridad.

Resumen del Servicio de Catálogos

Características Principales

El servicio de catálogos proporciona acceso centralizado y estandarizado a información de referencia fundamental, como nombres de estados o delitos. Esto incluye:

Catálogo Único de Claves de Áreas Geoestadísticas Estatales, Municipales y Localidades: Este catálogo, preparado por el INEGI después del censo del año 2000 y actualizado periódicamente desde entonces, contiene información estandarizada sobre los límites geográficos y nombres de estados, municipios y localidades de México.
Encuesta Nacional de Seguridad Urbana (ENSU): Datos sobre la percepción de seguridad y la incidencia delictiva en áreas urbanas.
Datos abiertos de incidencia delictiva: Información sobre crímenes reportados por el SESNSP, incluyendo clasificaciones estandarizadas de delitos.

Categorías de catálogos

1. Ubicaciones Geográficas

Estos endpoints proporcionan información sobre la división político-administrativa de México, basada en los catálogos oficiales del INEGI.

Estados

Endpoint: /v1/catalogues/location/state
Descripción: Catálogo completo de estados mexicanos con códigos oficiales, nombres completos y abreviaciones
Fuente: INEGI - Catálogo Único de Claves de Áreas Geoestadísticas

Municipios

Endpoint: /v1/catalogues/location/municipality
Descripción: Catálogo de municipios con asociación a estados
Filtros disponibles: Por estado, por municipio específico
Fuente: INEGI - Catálogo Único de Claves de Áreas Geoestadísticas

Ciudades ENSU

Endpoint: /v1/catalogues/location/city
Descripción: Códigos de ciudades incluidas en la Encuesta Nacional de Seguridad Urbana
Incluye: Coordenadas geográficas del centroide de la ciudad (latitud y longitud)
Fuente: INEGI - Programa ENSU

Colonias

Endpoint: /v1/catalogues/location/neighborhood
Descripción: Catálogo de colonias con asociación a municipios y estados
Filtros disponibles: Por estado, por municipio, por colonia específica
Fuente: INEGI - Catálogo Único de Claves de Áreas Geoestadísticas

2. Población

Información demográfica basada en el Censo de Población y Vivienda 2020 del INEGI.

Población Nacional

Endpoint: /v1/catalogues/population
Descripción: Datos de población total nacional desagregados por sexo
Filtros: Por año
Incluye: Total, hombres, mujeres

Población por Estados

Endpoint: /v1/catalogues/population/states
Descripción: Datos de población desagregados por estado
Filtros: Por estado específico, por año

Población por Municipios

Endpoint: /v1/catalogues/population/municipalities
Descripción: Datos de población desagregados por municipio
Filtros: Por municipio específico, por año

3. Clasificación de Crímenes

Catálogos estandarizados para clasificar y categorizar diferentes tipos de delitos.

Catálogo General de Crímenes

Endpoint: /v1/catalogues/crime
Descripción: Listado completo de tipos de crímenes con sus códigos
Filtros: Por crimen específico, por grupo de crimen

Grupos de Crímenes

Endpoint: /v1/catalogues/crime/group
Descripción: Clasificación jerárquica de grupos de crímenes
Uso: Organización temática para análisis agregado

Tipos de Crímenes

Endpoint: /v1/catalogues/crime/types
Descripción: Tipología detallada de subtipos de crímenes
Uso: Clasificación granular para análisis específico

Crímenes Principales

Endpoint: /v1/catalogues/main_crime
Descripción: Catálogo de crímenes principales con información de fuentes
Incluye: Identificación de la fuente de datos para cada crimen

4. Indicadores ENSU

Catálogos relacionados con la Encuesta Nacional de Seguridad Urbana para análisis de percepción de seguridad.

Grupos de Series

Un grupo corresponde a una categoría temática en la Encuesta Nacional de Seguridad Urbana (ENSU). Por ejemplo, en la batería de preguntas sobre “Percepción de seguridad en el espacio público”, el encuestador construye variantes a la pregunta

En términos de delincuencia, dígame si en (LUGAR) se siente seguro(a) o inseguro(a)

Con los siguientes LUGARES (grupos): Su casas, su trabajo, la calle, la escuela, etc.

Endpoint: /v1/catalogues/ensu/group
Descripción: Agrupaciones temáticas de indicadores ENSU
Uso: Navegación y organización de indicadores por área temática

Series ENSU

Una serie corresponde a una categoría de respuesta a una de las preguntas de la Encuesta Nacional de Seguridad Urbana (ENSU). Por ejemplo, ante la pregunta:

En términos de delincuencia, ¿considera que vivir actualmente en (CIUDAD), es seguro o inseguro?

“Seguro” es una serie, “Inseguro” es otra serie.

Esta decisión de diseño permite que el almacenamiento y análisis de los datos sea más flexible y escalable.

Endpoint: /v1/catalogues/ensu/serie
Descripción: Series temporales de datos ENSU
Uso: Análisis de tendencias históricas

Grupos Socio-demográficos

Un grupo socio-demográfico corresponde a una categoría de características demográficas en la Encuesta Nacional de Seguridad Urbana (ENSU). Por ejemplo, se pueden agrupar los encuestados por edad, género, nivel educativo, entre otros.

Endpoint: /v1/catalogues/ensu/socio_group
Descripción: Categorías demográficas para análisis ENSU
Uso: Segmentación de resultados por características demográficas

Series Socio-demográficas

Una serie socio-demográfica corresponde a una característica demográfica específica que se mide a lo largo del tiempo y puede ser agrupada en un grupo. Por ejemplo, el grupo sociodemográfico “Edad” puede tener series como “Edad 18-24”, “Edad 25-34”, etc.

Endpoint: /v1/catalogues/ensu/socio_serie
Descripción: Series de datos desagregadas por características socio-demográficas
Uso: Análisis detallado por grupos poblacionales

Integración con otros servicios

Los IDs obtenidos de estos catálogos se utilizan como parámetros en otros servicios:

IDs de ubicación → Servicio de incidencia delictiva
IDs de crímenes → Filtrado de datos criminales
IDs de indicadores ENSU → Servicio de percepción de seguridad

Buenas prácticas

Cachear resultados: Los catálogos cambian poco, implementa cache local
Usar filtros: Evita consultas masivas cuando solo necesitas datos específicos
Consultas jerárquicas: Aprovecha la estructura estado → municipio → colonia
Validar IDs: Usa estos catálogos para validar IDs antes de llamar otros servicios