- Las entidades son polígonos geográficos que tienen asociadas observaciones, como, por ejemplo, el valor observado o estimado de la población en esa entidad o polígono.
- Los lugares son establecimientos georreferenciados que se encuentran asociados a marcas, empresas y giros.
Entidades geográficas
Una entidad geográfica es cualquier unidad territorial de México. Por el momento, Atlas maneja 9 niveles, desde el polígono nacional hasta manzanas:
Las entidades están organizadas de forma jerárquica vía un
parent_code que nos ayuda a asociar la relación entre municipios y estados, localidades y municipios, y así sucesivamente.
Así se ve una entidad completa, tal como la recibes al consultar entidades:
Polígonos
Cada entidad geográfica que está dada de alta en la base de Atlas tiene un polígono que define la geometría oficial de su territorio. Como los límites cambian con el tiempo, cada polígono está versionado: una misma entidad puede tener varias versiones y solo una de ellas es la vigente.Indicadores, colecciones y observaciones
Un indicador es una variable estadística a la cuál se le puede asignar una observación o estimación numérica. Por ejemplo: población total, porcentaje de viviendas de nivel socioeconómico alto, precio promedio de renta por metro cuadrado. Atlas tiene más de 400 indicadores en su base de datos, con los siguientes atributos:
Para facilitar la consulta de indicadores relacionados, las colecciones agrupan indicadores por un tema en común y te permiten pedir todas las observaciones con una sola llamada en lugar de enumerar IDs o mnemónicos.
Finalmente, una observación es el valor de un indicador para una entidad en un periodo. Así es como la recibes al consultar últimas observaciones:
Cada observación viene acompañada del contexto de su entidad y de su indicador, para que puedas interpretarla sin cruzarla contra los catálogos.
Lugares
Un lugar es un establecimiento físico georreferenciado: una sucursal, una tienda, un cajero. Cada lugar pertenece a una marca, cada marca a una institución —la empresa dueña de la marca, identificada por su RFC— y se clasifica con una o más categorías que describen su giro. Estos son los datos que recibes al consultar lugares en el endpoint de listado por entidad:
Los lugares no se consultan uno por uno: los endpoints de conteo por entidad los agregan por marca, institución o categoría dentro del área que tú definas — un radio, una dirección, una entidad geográfica o una isócrona de traslado.