Presidencia de la Nación

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:18105 y id=18 son 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.

Activar: 
0
Template: 
caritas3
Scroll hacia arriba