Referencia

Estas páginas definen cómo se organizan los datos de este repositorio. Son el contrato: una contribución que las siga puede mergearse; una que no, no — por buena que sea la geometría.

Existen porque el proyecto está escalando de un país a potencialmente doscientos. Dos archivos con nombres de propiedades improvisados son simplemente desprolijos; cuatrocientos archivos con nombres improvisados son inutilizables.

De un vistazo

Pregunta	Respuesta	Detalle
¿Dónde va un archivo?	data/{body}/{ISO3}/{ISO3}_{LEVEL}.geojson	Nombres
¿Qué es ADM1?	Divisiones de primer nivel, como sea que se llamen localmente	Niveles
¿Qué propiedades son obligatorias?	shapeName, shapeISO, shapeGroup, shapeType	Esquema
¿Qué sistema de coordenadas?	OGC:CRS84 (≡ EPSG:4326), longitud primero	CRS
¿Puede un archivo declarar su CRS?	No. RFC 7946 eliminó ese miembro	CRS
¿Cómo funcionan la Luna y Marte?	Marcos body-fixed IAU 2015, sin códigos ISO	Planetario
¿De dónde salen los metadatos del catálogo?	manifest.json junto a los datos	Manifiesto

Lenguaje de conformidad

Estas páginas usan debe, debería y puede en el sentido de RFC 2119. "Debe" se aplica en la revisión y, donde es práctico, en CI.

Los archivos heredados

Todo lo que hay bajo data/ sigue estas convenciones. Los cuatro archivos que siguen en la raíz del repositorio — regiones.geojson, comunas.geojson y sus duplicados .json — no: son anteriores a las convenciones.

Se mantienen en su sitio, sin cambios, durante una versión mayor completa para que los enlaces profundos existentes sigan funcionando, y están obsoletos. Usa data/earth/CHL/.

Ver Versionado y estabilidad para el calendario de retirada.