Fuentes de Datos y Atribución
GeoQuetzal es una librería de software que facilita el acceso a los datos públicos del censo 2018 en Guatemala (Instituto Nacional de Estadística) y datos geográficos territoriales (Ministerio de Finanzas). La librería no genera ni modifica los datos originales, pero si los reformatea, particiona y distribuye en formatos optimizados (Parquet, GeoJSON) para facilitar su uso en análisis computacionales.
Datos del censo 2018 — INE Guatemala
Los microdatos de personas, hogares, viviendas, emigración y lugares poblados provienen del XII Censo Nacional de Población y VII de Vivienda 2018, publicado por el Instituto Nacional de Estadística de Guatemala (INE).
| Institución | Instituto Nacional de Estadística (INE) |
| Dataset | XII Censo Nacional de Población y VII de Vivienda 2018 |
| Acceso original | censo2018.ine.gob.gt/descarga |
| Tipo | Datos públicos |
| Cobertura | Nacional — 14,901,286 personas, 3,275,931 hogares |
Los archivos Parquet distribuidos en GitHub Releases son versiones derivadas de los CSV originales del INE, convertidas a formato Parquet y particionadas por departamento para facilitar descargas eficientes. El contenido de los datos no ha sido alterado.
Si utiliza los datos del Censo 2018 en una publicación académica, cite tanto a GeoQuetzal como al INE como fuente original de los datos.
Cómo citar los datos del INE:
Instituto Nacional de Estadística (INE). (2018). XII Censo Nacional de Población y VII de Vivienda 2018. Guatemala: INE. Disponible en: https://censo2018.ine.gob.gt
Datos Geográficos Territoriales — MINFIN Guatemala
Los límites de departamentos y municipios provienen de los archivos TopoJSON publicados por el Ministerio de Finanzas Públicas de Guatemala (MINFIN).
| Institución | Ministerio de Finanzas Públicas de Guatemala (MINFIN) |
| Dataset | Mapas TopoJSON de Guatemala |
| Acceso original | github.com/minfin-bi/Mapas-TopoJSON-Guatemala |
| Tipo | Datos públicos |
| Cobertura | 22 departamentos, 340 municipios (a 2026) |
Los archivos de límites están incluidos directamente en la librería (integrados), por lo que se cargan instantáneamente sin necesidad de conexión a internet. GeoQuetzal reemplaza los nombres de MINFIN con la nomenclatura oficial del INE para garantizar joins confiables por códigos numéricos de Departamento, Municipios y Lugares poblados.
Zonas de la Ciudad de Guatemala — GADM v4.1
Los polígonos de las 22 zonas de la Ciudad de Guatemala se obtienen de GADM (Global Administrative Areas), versión 4.1.
| Fuente | GADM v4.1 |
| Acceso original | gadm.org / geodata.ucdavis.edu |
| Licencia | Libre para uso académico y no comercial |
| Uso en GeoQuetzal | Solo para gq.municipios("Guatemala", zonas=True) |
Los datos de GADM están sujetos a su propia licencia. Son gratuitos para uso académico y no comercial, pero no pueden redistribuirse ni usarse con fines comerciales sin permiso. GeoQuetzal descarga estos datos bajo demanda directamente desde los servidores de GADM (cuando se necesitan visualizar las zonas) y no los redistribuye en la librería.
Polígonos Voronoi — Derivados de centroides INE
Los polígonos Voronoi generados por gq.voronoi_lugares_poblados() son derivados computacionales calculados a partir de los centroides de lugares poblados presentes en los datos del censo 2018, Lugares Poblados del INE. No son límites oficiales ni han sido publicados por ninguna institución gubernamental como tales.
| Tipo | Aproximación computacional |
| Método | Teselación geométrica Voronoi (scipy) recortada a límites municipales (MINFIN) |
| Fuente de centroides | INE — XII Censo 2018 |
| Uso recomendado | Visualización coroplética únicamente |
Estos polígonos son aproximaciones para visualización y análisis de las variables del censo. No deben usarse para análisis geográficas, delimitaciones oficiales, ni en documentos con requerimientos cartográficos precisos.
Resumen de fuentes
| Función GeoQuetzal | Fuente de datos | Licencia |
|---|---|---|
gq.departamentos(), gq.municipios(), gq.lagos() |
MINFIN Guatemala | Pública |
gq.municipios("Guatemala", zonas=True) |
GADM v4.1 | Académica/no comercial |
gq.personas(), gq.hogares(), gq.viviendas(), gq.emigracion() |
INE — Censo 2018 | Pública |
gq.lugares_poblados() |
INE — Censo 2018 (pre-agregado) | Pública |
gq.voronoi_lugares_poblados() |
Derivado de INE + MINFIN | Pública (derivado) |
Sobre GeoQuetzal
GeoQuetzal es software de código abierto publicado bajo la Licencia MIT. El código fuente está disponible en github.com/geoquetzal/geoquetzal.
Los autores del paquete no reclaman autoría sobre los datos originales del INE, MINFIN ni GADM. El valor que aporta GeoQuetzal es la integración, reformateo, agrupación y documentación de estos datos en una interfaz unificada y reproducible.
GeoQuetzal se distribuye tal como está (MIT License), sin garantías de ningún tipo. Los autores no asumen responsabilidad por el uso que se haga de los datos, análisis, visualizaciones o conclusiones derivadas del uso de esta librería. Es responsabilidad del usuario de la librería verificar los resultados, elegir los denominadores apropiados para cada análisis, y consultar los metadatos y documentación original del INE antes de publicar o tomar decisiones basadas en los datos. Los polígonos Voronoi generados por voronoi_lugares_poblados() son aproximaciones computacionales para visualización únicamente y no deben utilizarse como límites oficiales en ningún contexto que requiera precisión cartográfica.