Filtrado por intersección
Algunos recursos de la API permiten buscar entidades que interseccionan espacialmente con otras. Para eso se utiliza el parámetro interseccion, disponible en los siguientes endpoints:
/provincias/departamentos/municipios/gobiernos-locales
Este parámetro permite devolver entidades que comparten área con otras, en base a sus geometrías oficiales.
Formato del parámetro
interseccion=<tipo de entidad>:<id 1>[:<id 2>:...],<tipo de entidad 2>:<id 3>,...
- Se pueden incluir uno o más IDs.
- Se pueden combinar diferentes tipos de entidad.
- Se incluyen en la respuesta todas las entidades que intersequen con al menos una de las entidades indicadas.
Ejemplos
interseccion=departamento:18105- Devuelve todas las entidades (según el recurso) que intersecan con el departamento 18105.
interseccion=municipio:620133:540378- Devuelve entidades que intersecan con cualquiera de esos dos municipios.
interseccion=calle:0638503000235- Devuelve, por ejemplo, el municipio que contiene a esa calle.
Los IDs que no correspondan a entidades válidas serán ignorados sin generar error.
Ejemplo completo
Consulta
GET https://apis.datos.gob.ar/georef/api/v2.0/municipios?interseccion=departamento:18105
Respuesta
{
"municipios": [
{
"centroide": { "lat": -28.508559, "lon": -58.031593 },
"id": "180042",
"nombre": "Concepción",
"provincia": { "id": "18", "nombre": "Corrientes" }
},
{ ... } // 9 resultados omitidos
],
"cantidad": 10,
"total": 13,
"inicio": 0,
"parametros": { ... }
}
Recomendaciones de uso
Aunque /provincias permite usar el parámetro interseccion, se recomienda filtrar por ID directamente si se conoce la provincia buscada. Por ejemplo:
interseccion=departamento:18105yid=18son equivalentes (ya que los dos primeros dígitos del ID del departamento corresponden a su provincia).
Usar id directamente mejora la performance de la consulta.