datosgobar / georef-ar-api

API del Servicio de Normalización de Datos Geográficos de Argentina.
https://apis.datos.gob.ar/georef
MIT License
151 stars 35 forks source link

Agregar todas las unidades territoriales como filtros disponibles #139

Closed abenassi closed 6 years ago

abenassi commented 6 years ago

Contexto

Luego del issue #138 ya se puede filtrar por intersección parcial, y por lo tanto por unidades territoriales que no sean "padres" de la que se está consultando.

Propuesta

Se generaliza el uso de filtros por otras unidades territoriales: ahora todos los endpoints pueden filtrar por municipios, departamentos o provincias usando un nuevo parámetro interseccion con una sintaxis definida para poder filtrar por interseccion de arbitrarias unidades territoriales con sus ids.

abenassi commented 6 years ago

@federicotdn agregá los casos de ejemplo para el nuevo parámetro

federicotdn commented 6 years ago

Se decidió usar la siguiente sintaxis para el parámetro interseccion:

interseccion=<tipo de entidad>:<id 1>:<id 2>,<tipo de entidad>:<id 1>:<id 2>, ...

Por ejemplo, para buscar los departamentos que tengan intersección con los municipios 900021 y 060007:

/departamentos?interseccion=municipio:900021:060007

Para buscar municipios que tengan intersección con el departamento 90084 o la provincia 14:

/municipios?interseccion=departamento:90084,provincia:14