unreleased - 2025/08/29

• Actualiza documentación del Servicio y se muda de GitHub a argentina.gob.ar.

• Cambios en fuentes de datos:

  • Modifica recurso /asentamientos: se dejan de descargar los datos de BAHRA (localidades, parajes y bases antárticas) y se toman directamente desde el IGN. La descarga de entidades se mantiene desde BAHRA ya que IGN no las publica.
  • Modifica recurso /localidades: se dejan de descargar los datos de BAHRA (localidades) y se toman directamente desde el IGN. La descarga de entidades se mantiene desde BAHRA ya que IGN no las publica.
  • Modifica recurso /municipios: se dejan de utilizar los datos del IGN y se comienzan a utilizar los datos del INDEC, obtenidos de filtrar los Gobiernos Locales por categoría.
  • Modifica recurso /localidades-censales: INDEC cambió la capa que provee de localidades censales. Ahora la geometría es de polígonos, antes eran puntos.

• Cambios en parámetros:

  • Modifica recurso /localidades-censales: el parámetro municipio cambia de nombre a gobierno_local.
  • Agrega nuevo parámetro categoria a recurso /asentamientos para filtrar los datos por tipo de asentamiento.
  • Agrega nuevo parámetro categoria a recurso /gobiernos-locales para filtrar los datos por tipo de gobierno local.
  • Agrega nuevo parámetro desplazar a recurso /direcciones. Permite indicar en metros el desplazamiento lateral del punto georreferenciado, dependiendo de la numeración par o impar. Valor por defecto: 0.
  • Agrega nuevo parámetro division a recurso /ubicacion. Permite definir el tipo de división territorial a devolver en la georreferenciación inversa. Valores posibles: politico-administrativa (por defecto) y geoestadistica.

• Cambios en campos de respuesta:

  • Modifica recursos /calles y /direcciones: se agrega al campo nomenclatura el nombre de la localidad/entidad, además del departamento y la provincia.
  • Modifica recurso /localidades-censales: se elimina la palabra "Localidad" que traía de origen el campo nombre.
  • Modifica recurso /ubicacion:
  • Se agrega grupo calle con los campos nombre, altura, id y fuente.
  • Se agrega el campo nomenclatura con la unión de calle, altura, departamento y provincia.
  • Agrega campo localidad a las respuestas de los recursos /calles y /cuadras.

• Nuevos endpoints:

  • Agrega recurso /aglomerados: utiliza la capa de polígonos del INDEC.
  • Agrega recurso /fracciones-censales: utiliza la capa de polígonos del INDEC.
  • Agrega recurso /gobiernos-locales: utiliza la capa de polígonos del INDEC.
  • Agrega recurso /radios-censales: utiliza la capa de polígonos del INDEC.

0.5.3 - 2019/05/16

• Agrega campo parametros a todas las respuestas de la API. El campo contiene los valores (interpretados) de los parámetros recibidos por la API en la consulta.
• Agrega archivo .prj a respuestas de consultas en formato Shapefile.
• Modifica el valor del campo de respuesta altura.valor en el recurso /direcciones. El campo ahora contiene la altura de la dirección en formato numérico, es decir, int o float. Si la dirección no contiene una altura numérica (por ejemplo, "Calle 15 S/N"), el valor del campo es null.

0.5.2 - 2019/05/14

• Agrega parámetro localidad a recurso /direcciones.

0.5.1 - 2019/05/10

• Corrige campos CSV del recurso /localidades-censales.
• Corrige valor de cantidad para consultas al recurso /asentamientos.

0.5.0 - 2019/05/09

• Agrega recurso /localidades-censales. El nuevo recurso ofrece un listado de localidades censales definidas por INDEC.
• Agrega recurso /asentamientos. El nuevo recurso contiene la enteridad de la base BAHRA, y sus parámetros y formatos de respuesta son idénticos a los de /localidades.
• Agrega campo localidad_censal a respuestas de recursos /localidades, /calles, y /direcciones. El campo permite acceder al nombre y ID de la localidad censal de la localidad o calle correspondiente.
• Agrega nuevo parámetro localidad_censal a /localidades, /calles y /direcciones. El parámetro permite filtrar direcciones, calles y localidades por localidad censal, lo cual en algunos casos ofrece un mayor grado de precisión que utilizar departamento.
• Mejora la precisión de la georreferenciación inversa (/ubicacion) como resultado de haber actualizado la versión de Elasticsearch.
• Actualiza versión de datos de ETL a 12.0.0.
• Mejora interpretación de direcciones (georef-ar-address versión 0.0.9).

0.4.1 - 2019/04/25

• Agrega localidades de tipo LCE y LSE a recurso /localidades.
• Actualiza versión de datos de ETL a 11.0.0.

0.4.0 - 2019/04/23

• Modifica fuente de datos utilizada para recurso /direcciones. Se aumentó considerablemente la cantidad de direcciones que pueden ser georreferenciadas.
• Actualiza versión de datos de ETL a 10.0.0.
• Mejora interpretación de direcciones (georef-ar-address versión 0.0.8).

0.3.3 - 2019/02/11

• Corrige error HTTP 500 lanzado cuando se utilizaban valores como "NaN" o "Inifinity" para parámetros lat y lon en /ubicacion.

0.3.2 - 2019/02/05

• El parámetro interseccion de los recursos /provincias, /departamentos y /calles ahora aceptan IDs de calles como parámetros.
• Modifica cantidad de máxima de consultas en una sola petición POST a 1000 (era 5000). El nuevo valor permite normalizar datos a una velocidad prácticamente igual a la anterior, pero con una menor carga a la infraestructura.

0.3.1 - 2019/01/29

• Mejora interpretación de direcciones (georef-ar-address versión 0.0.7).
• Corrige error HTTP 500 lanzado en normalización de direcciones, en casos donde el comienzo y el fin de alturas de la calle comparten el mismo valor, y la dirección tiene ese valor exacto como altura.

0.3.0 - 2019/01/24

• Agrega XML como nuevo formato de respuesta de datos para todos los recursos. Para utilizarlo, agregar formato=xml a los parámetros de la URL.
• Agrega Shapefile como nuevo formato de respuesta de datos para todos los recursos (excepto /direcciones y /ubicacion). Para utilizarlo, agregar formato=shp a los parámetros de la URL. El archivo descargado contiene las geometrías e información de todas las entidades filtradas. Para más detalles, consultar la documentación de descarga de geometrías.
• El parámetro id ahora acepta listas de IDs separadas por comas. Otros parámetros que aceptaban un ID también aceptan ahora listas de IDs.
• Actualiza versión de datos de ETL a 9.0.0.
• Corrige mensajes de error equivocados.
• Cambios varios al recurso /direcciones:
  • Utilizando la librería georef-ar-address, se mejoró el proceso de interpretación de las direcciones recibidas. Ahora, se aceptan más tipos de direcciones, y la API es capaz de detectar errores comunes de escritura. Para más detalles, consultar la nueva documentación de normalización de direcciones.
  • Se removió el parámetro tipo.
  • Se modificó el campo de respuesta altura a un objeto altura que contiene los valores valor y unidad.
  • Se removieron los campos nombre y id, y se agregaron los nuevos campos objeto calle, calle_cruce_1 y calle_cruce_2. Cada uno contiene los campos nombre, id y categoria, y representan las calles normalizadas que fueron detectadas en la dirección de entrada.
  • Se agregó el campo piso.
  • Se modificaron los nombres y el orden de los campos de respuesta en formato CSV.
• Cambios al recurso /provincias:
  • Se agregaron los campos nombre_completo, iso_id, iso_nombre y categoria.
• Cambios al recurso /departamentos:
  • Se agregaron los campos nombre_completo y categoria.
• Cambios al recurso /municipios:
  • Se agregaron los campos nombre_completo y categoria.
  • Parámetro interseccion: agrega calle como tipo de entidad posible a utilizar.
• Cambios al recurso /localidades:
  • Se modificó el nombre del campo tipo a categoria.
• Cambios al recurso /calles:
  • Se modificó el nombre del campo tipo a categoria.
  • Se modificó el nombre del parámetro tipo a categoria.
  • Agrega parámetro interseccion: permite buscar calles por intersección con geometrías de otras entidades.
• Cambios al recurso /ubicacion:
  • Se removió el campo fuente, y se agregaron los campos provincia.fuente, departamento.fuente y municipio.fuente.

0.2.3 - 2018/12/11

• Modifica formato de respuestas CSV: todos los campos no-numéricos ahora son devueltos entre comillas dobles. El cambio permite a algunas herramientas manejar mejor los valores de IDs, que consisten enteramente de dígitos, pero deberían ser tratados como texto.
• El parámetro direccion del recurso /direcciones ahora acepta direcciones con altura 0.
• Mejora la fidelidad de resultados por en búsquedas por nombre: algunos términos de búsqueda ahora excluyen a otros, aunque sean textualmente similares. Por ejemplo, buscar 'salta' no incluye resultados con 'santa', ya que los dos términos refieren a entidades claramente distintas.

0.2.2 - 2018/11/05

• El parámetro direccion del recurso /direcciones ahora acepta direcciones sin altura (por ejemplo, "Avenida Santa Fe"). Este cambio permite utilizar la versión POST del recurso con mayor facilidad, en caso de tener grandes cantidades de datos con y sin alturas en un mismo conjunto.
• Mejoras a mensajes de error para parámetros direccion e interseccion.

0.2.1 - 2018/10/25

• Actualiza proceso de indexación para utilizar datos de ETL versión 6.0.0.
• Agrega mensaje de error descriptivo para errores HTTP 405.
• Mejora parámetro campos: se permite especificar un prefijo para referirse a varios campos (por ejemplo, provincia para provincia.id y provincia.nombre).
• Agrega parámetro interseccion. El mismo permite buscar provincias, departamentos y municipios utilizando intersección de geometrías con otras entidades geográficas.
  • Se pueden buscar provincias por intersección con municipios y departamentos.
  • Se pueden buscar departamentos por intersección con provincias y municipios.
  • Se pueden buscar municipios por intersección con provincias y departamentos.
• Agrega nuevo campo de datos provincia.interseccion a recursos /municipios y /departamentos. El campo especifica qué porcentaje del área de la provincia ocupa la entidad en sí.
• Agrega nuevos recursos de descarga de datos completos. Estos recursos permiten descargar la totalidad de los datos utilizados por cada recurso, en distintos formatos. Por ejemplo, para descargar los datos de provincias, se puede acceder a las siguientes URLs:

https://apis.datos.gob.ar/georef/api/provincias.json
https://apis.datos.gob.ar/georef/api/provincias.csv
https://apis.datos.gob.ar/georef/api/provincias.geojson

0.2.0 - 2018/09/21

• Remueve campo departamento de la entidad municipio. Esto se debe a que los departamentos no son padres jerárquicos de los municipios.
• Agrega parámetro orden a recursos /calles y /direcciones.
• Agrega formato GeoJSON a recurso /direcciones.
• Agrega conjuntos de campos predefinidos al parámetro campos, los valores posibles son:
  • basico
  • estandar (utilizado por defecto)
  • completo
• Mueve campo de respuestas fuente a conjunto completo.
• Permite el uso del parámetro aplanar en respuestas GeoJSON.

0.1.6 - 2018/09/07

• Actualiza proceso de indexación para utilizar datos de ETL versión 4.0.0.
• Modifica manejo de altura en recurso /direcciones. La nueva versión del recurso intenta ubicar altura dentro de los extremos de la calle tomando en consideración que los datos pueden no siempre estar completos (o ser ideales). Este cambio también afecta la efectividad de la geolocalización de direcciones.

0.1.5 - 2018/09/04

• Mejora mensajes de errores para varios casos:
  • Acceso a recursos inexistentes (por ejemplo: /provincia).
  • Valores inválidos para parámetros con elección limitada de valores (por ejemplo, orden).
  • Listas de operaciones bulk inválidas.
  • Direcciones de calles malformadas.
• Agrega API de paginado.
  • Nuevo parámetro: inicio.
  • Los resultados ahora incluyen tres metadatos: cantidad, total e inicio.

0.1.4 - 2018/08/23

• Se modificó la interpretación del parámetro direccion del recurso /direcciones:
  • Se ignoran ítems entre paréntesis y ocurrencias de "N°"
  • Se separa el texto utilizando "-", "," y "B°", y se intenta extraer una dirección (nombre + altura) de cada fragmento.

0.1.3 - 2018/08/21

• Se modificaron los siguientes campos:
  • centroide_lat y centroide_lon ahora están anidados.
  • Los campos altura_inicio_derecha, altura_fin_derecha, etc. ahora están anidados.
• Se agregó una validación de valores repetidos para parámetro campos.
• El recurso /provincias ahora acepta el parámetro aplanar.

0.1.2 - 2018/08/16

• Se removió d como stopword en Elasticsearch.

0.1.1 - 2018/08/15

• Se modificaron los siguientes campos:
  • lat ahora es centroide_lat.
  • lon ahora es centroide_lon.
  • Los campos inicio_derecha, fin_derecha, etc. ahora comienzan con altura_.

0.1.0 - 2018/08/14

• Versión inicial.