From 12935faf29a4a382bee6438659692607674952cf Mon Sep 17 00:00:00 2001
From: Lucas Lavandeira <19612265+lucaslavandeira@users.noreply.github.com>
Date: Thu, 7 Mar 2019 11:12:58 -0300
Subject: [PATCH] =?UTF-8?q?Docs=20para=20la=20versi=C3=B3n=201.12.1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/history.md | 6 ++++++
docs/history/index.html | 20 ++++++++++++++++++++
docs/open_api/index.html | 2 +-
docs/open_api/swagger-ui.css | 1 +
docs/search/search_index.json | 2 +-
docs/sitemap.xml | 28 ++++++++++++++--------------
docs/sitemap.xml.gz | Bin 347 -> 347 bytes
7 files changed, 43 insertions(+), 16 deletions(-)
diff --git a/docs/history.md b/docs/history.md
index e0cdad91..fff69a81 100644
--- a/docs/history.md
+++ b/docs/history.md
@@ -1,5 +1,11 @@
# Historial de versiones
+## 1.12.1
+
+- Revert al uso de metadatos de consultas en el endpoint de búsqueda
+- Revert al conteo de series en cada filtro de metadatos.
+- Nuevo parámetro para `/search`: `aggregations` muestra el conteo de series relevantes para la búsqueda dada, desagregadas según los varios filtros posibles
+
## 1.12.0
- Bugfixes en indexación y respuesta de API series (#471, #473, #474)
diff --git a/docs/history/index.html b/docs/history/index.html
index 2a561e6b..c4174252 100644
--- a/docs/history/index.html
+++ b/docs/history/index.html
@@ -568,6 +568,13 @@
Contenidos de la sección
+
+
+ 1.12.1
+
+
+
+
1.12.0
@@ -916,6 +923,13 @@
Contenidos de la sección
+
+
+ 1.12.1
+
+
+
+
1.12.0
@@ -1251,6 +1265,12 @@
Historial de versiones
+1.12.1
+
+Revert al uso de metadatos de consultas en el endpoint de búsqueda
+Revert al conteo de series en cada filtro de metadatos.
+Nuevo parámetro para /search: aggregations muestra el conteo de series relevantes para la búsqueda dada, desagregadas según los varios filtros posibles
+
1.12.0
Bugfixes en indexación y respuesta de API series (#471, #473, #474)
diff --git a/docs/open_api/index.html b/docs/open_api/index.html
index 99f538f1..6a95f003 100644
--- a/docs/open_api/index.html
+++ b/docs/open_api/index.html
@@ -39,7 +39,7 @@
window.onload = function() {
// Begin Swagger UI call region
const ui = SwaggerUIBundle({
- url: "./swagger.yml", validatorUrl: null, validatorUrl: null, validatorUrl: null, validatorUrl: null,
+ url: "./swagger.yml", validatorUrl: null, validatorUrl: null, validatorUrl: null, validatorUrl: null, validatorUrl: null,
dom_id: '#swagger-ui',
deepLinking: true,
presets: [
diff --git a/docs/open_api/swagger-ui.css b/docs/open_api/swagger-ui.css
index 3a86d26c..d84be9a7 100644
--- a/docs/open_api/swagger-ui.css
+++ b/docs/open_api/swagger-ui.css
@@ -4,3 +4,4 @@
.download-url-wrapper { display: none!important; }
.download-url-wrapper { display: none!important; }
.download-url-wrapper { display: none!important; }
+.download-url-wrapper { display: none!important; }
diff --git a/docs/search/search_index.json b/docs/search/search_index.json
index 452c0d3a..7ccfa387 100644
--- a/docs/search/search_index.json
+++ b/docs/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"API de Series de Tiempo de la Rep\u00fablica Argentina Versi\u00f3n : 1.10.0 La API de Series de Tiempo de Argentina, permite consultar indicadores con evoluci\u00f3n cronol\u00f3gica publicados en formatos abiertos por organismos de la Administraci\u00f3n P\u00fablica Nacional. Una serie de tiempo es una secuencia de observaciones o valores, medidos en determinados momentos del tiempo y ordenados cronol\u00f3gicamente. indice_tiempo ipc_2016_nivel_general 2017-04 0.28 2017-05 0.24 2017-06 0.22 2017-07 0.22 2017-08 0.23 2017-09 0.24 2017-10 0.23 2017-11 0.22 2017-12 0.25 2018-01 0.25 2018-02 0.26 2018-03 0.26 Un servicio web , es una tecnolog\u00eda que permite intercambiar datos entre aplicaciones. apis.datos.gob.ar/series/api/series/?ids=101.1_I2NG_2016_M_22:percent_change_a_year_ago&format=csv Estos indicadores son ejemplos de series de tiempo: Inflaci\u00f3n ( csv | json ) Tipo de cambio ( csv | json ) Nivel de actividad ( csv | json ) Si sos usuario de la API de Series de Tiempo y quer\u00e9s estar al tanto de los cambios y novedades, inscribite en la base de contactos de Datos Argentina y eleg\u00ed sobre qu\u00e9 temas quer\u00e9s que te escribamos. \u00bfTen\u00e9s algo que contarnos? Nos encantar\u00eda que nos cuentes por Twitter o por mail qu\u00e9 mejor\u00f3 usar la API en tu trabajo y qu\u00e9 le falta para mejorar a\u00fan m\u00e1s.","title":"Inicio"},{"location":"#api-de-series-de-tiempo-de-la-republica-argentina","text":"Versi\u00f3n : 1.10.0 La API de Series de Tiempo de Argentina, permite consultar indicadores con evoluci\u00f3n cronol\u00f3gica publicados en formatos abiertos por organismos de la Administraci\u00f3n P\u00fablica Nacional. Una serie de tiempo es una secuencia de observaciones o valores, medidos en determinados momentos del tiempo y ordenados cronol\u00f3gicamente. indice_tiempo ipc_2016_nivel_general 2017-04 0.28 2017-05 0.24 2017-06 0.22 2017-07 0.22 2017-08 0.23 2017-09 0.24 2017-10 0.23 2017-11 0.22 2017-12 0.25 2018-01 0.25 2018-02 0.26 2018-03 0.26 Un servicio web , es una tecnolog\u00eda que permite intercambiar datos entre aplicaciones. apis.datos.gob.ar/series/api/series/?ids=101.1_I2NG_2016_M_22:percent_change_a_year_ago&format=csv Estos indicadores son ejemplos de series de tiempo: Inflaci\u00f3n ( csv | json ) Tipo de cambio ( csv | json ) Nivel de actividad ( csv | json ) Si sos usuario de la API de Series de Tiempo y quer\u00e9s estar al tanto de los cambios y novedades, inscribite en la base de contactos de Datos Argentina y eleg\u00ed sobre qu\u00e9 temas quer\u00e9s que te escribamos. \u00bfTen\u00e9s algo que contarnos? Nos encantar\u00eda que nos cuentes por Twitter o por mail qu\u00e9 mejor\u00f3 usar la API en tu trabajo y qu\u00e9 le falta para mejorar a\u00fan m\u00e1s.","title":"API de Series de Tiempo de la Rep\u00fablica Argentina"},{"location":"additional-parameters/","text":"Filtrar y transformar las series Descargar una tabla con una o varias series Filtrar por fechas Cambiar la agregaci\u00f3n temporal Cambiar la funci\u00f3n de agregaci\u00f3n temporal Aplicar transformaciones Aplicar transformaciones y cambiar la funci\u00f3n de agregaci\u00f3n temporal en series individuales, a la vez Descargar una tabla con una o varias series El par\u00e1metro ids permite la consulta simult\u00e1nea de hasta 40 series a la vez , separadas por comas. IPC por categor\u00edas http://apis.datos.gob.ar/series/api/series/?ids=103.1_I2N_2016_M_15,101.1_I2NG_2016_M_22,102.1_I2S_ABRI_M_18,102.1_I2B_ABRI_M_15,103.1_I2R_2016_M_18,103.1_I2E_2016_M_21&format=csv Filtrar por fechas Los par\u00e1metros start_date y end_date permiten limitar una consulta a todos aquellos valores posteriores o anteriores (respectivamente) a una fecha determinada. Tipo de cambio desde Enero de 2016 https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26&start_date=2016-01&limit=1000&format=csv Tipo de cambio hasta Diciembre de 2016 https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26&end_date=2016-12&format=csv Tipo de cambio desde Enero de 2016 hasta Diciembre de 2016 https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26&start_date=2016-01&end_date=2016-12&format=csv Cambiar la agregaci\u00f3n temporal Por default, las series se muestran en la frecuencia m\u00e1s alta posible (esta es, la frecuencia m\u00e1s baja de todas las series consultadas a la vez). El par\u00e1metro collapse permite elegir una frecuencia m\u00e1s baja que esta. \u00cdndice de Tipo de Cambio Real Multilateral, China y Brasil. Valores mensuales promediados por trimestre. http://apis.datos.gob.ar/series/api/series/?limit=1000&collapse=quarter&ids=116.3_TCRMA_0_M_36,116.3_TCRC_0_M_22,116.3_TCRB_0_M_23&format=csv Cambiar la funci\u00f3n de agregaci\u00f3n temporal Por default, cuando la API hace agregaciones temporales (ie. convertir una serie mensual en trimestral) hace un promedio de los valores de cada per\u00edodo . Esta funci\u00f3n de agregaci\u00f3n se puede cambiar para toda la consulta con el par\u00e1metro collapse_aggregation , o para cada serie en particular (suma, m\u00e1ximo, m\u00ednimo, etc.). Tipo de cambio. Valores diarios a cierre de cada mes. https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26&collapse=month&collapse_aggregation=end_of_period&format=csv Tipo de cambio. Valores diarios m\u00ednimo, promedio, m\u00e1ximo y cierre de cada mes. https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26:min,168.1_T_CAMBIOR_D_0_0_26:avg,168.1_T_CAMBIOR_D_0_0_26:max,168.1_T_CAMBIOR_D_0_0_26:end_of_period&collapse=month&format=csv&limit=1000 Aplicar transformaciones Las series de pueden transformar en otras unidades (variaci\u00f3n porcentual, variaci\u00f3n interanual, etc.) en forma individual o conjunta, usando el par\u00e1metro representation_mode . Tipo de cambio, IPC n\u00facleo e IPC nivel general desde Enero de 2016. Variaci\u00f3n porcentual de valores mensuales, respecto del per\u00edodo anterior. https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26,103.1_I2N_2016_M_15,103.1_I2N_2016_M_19&collapse=month&format=csv&start_date=2016-01&representation_mode=percent_change IPC n\u00facleo, IPC n\u00facleo (variaci\u00f3n porcentual per\u00edodo a per\u00edodo) e IPC n\u00facleo (variaci\u00f3n porcentual interanual) desde Enero de 2016. Valores mensuales. Nota: series con unidades de diferentes escalas, pueden ser dif\u00edciles de visualizar en un mismo gr\u00e1fico. https://apis.datos.gob.ar/series/api/series?ids=103.1_I2N_2016_M_15,103.1_I2N_2016_M_15:percent_change,103.1_I2N_2016_M_15:percent_change_a_year_ago&start_date=2016-01&format=csv&limit=1000 Aplicar transformaciones y cambiar la funci\u00f3n de agregaci\u00f3n temporal en series individuales, a la vez Es posible aplicar a las series individuales tanto una transformaci\u00f3n como una funci\u00f3n de agregaci\u00f3n particular a la vez . En todos los casos, siempre se aplica primero la funci\u00f3n de agregaci\u00f3n y luego la transformaci\u00f3n . Tipo de cambio. Variaci\u00f3n porcentual de valores diarios a cierre de cada mes, respecto del per\u00edodo anterior. http://apis.datos.gob.ar/series/api/series/?limit=1000&collapse=month&ids=168.1_T_CAMBIOR_D_0_0_26:end_of_period:percent_change&format=csv","title":"Filtrar y transformar las series"},{"location":"additional-parameters/#filtrar-y-transformar-las-series","text":"Descargar una tabla con una o varias series Filtrar por fechas Cambiar la agregaci\u00f3n temporal Cambiar la funci\u00f3n de agregaci\u00f3n temporal Aplicar transformaciones Aplicar transformaciones y cambiar la funci\u00f3n de agregaci\u00f3n temporal en series individuales, a la vez","title":"Filtrar y transformar las series"},{"location":"additional-parameters/#descargar-una-tabla-con-una-o-varias-series","text":"El par\u00e1metro ids permite la consulta simult\u00e1nea de hasta 40 series a la vez , separadas por comas. IPC por categor\u00edas http://apis.datos.gob.ar/series/api/series/?ids=103.1_I2N_2016_M_15,101.1_I2NG_2016_M_22,102.1_I2S_ABRI_M_18,102.1_I2B_ABRI_M_15,103.1_I2R_2016_M_18,103.1_I2E_2016_M_21&format=csv","title":"Descargar una tabla con una o varias series"},{"location":"additional-parameters/#filtrar-por-fechas","text":"Los par\u00e1metros start_date y end_date permiten limitar una consulta a todos aquellos valores posteriores o anteriores (respectivamente) a una fecha determinada. Tipo de cambio desde Enero de 2016 https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26&start_date=2016-01&limit=1000&format=csv Tipo de cambio hasta Diciembre de 2016 https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26&end_date=2016-12&format=csv Tipo de cambio desde Enero de 2016 hasta Diciembre de 2016 https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26&start_date=2016-01&end_date=2016-12&format=csv","title":"Filtrar por fechas"},{"location":"additional-parameters/#cambiar-la-agregacion-temporal","text":"Por default, las series se muestran en la frecuencia m\u00e1s alta posible (esta es, la frecuencia m\u00e1s baja de todas las series consultadas a la vez). El par\u00e1metro collapse permite elegir una frecuencia m\u00e1s baja que esta. \u00cdndice de Tipo de Cambio Real Multilateral, China y Brasil. Valores mensuales promediados por trimestre. http://apis.datos.gob.ar/series/api/series/?limit=1000&collapse=quarter&ids=116.3_TCRMA_0_M_36,116.3_TCRC_0_M_22,116.3_TCRB_0_M_23&format=csv","title":"Cambiar la agregaci\u00f3n temporal"},{"location":"additional-parameters/#cambiar-la-funcion-de-agregacion-temporal","text":"Por default, cuando la API hace agregaciones temporales (ie. convertir una serie mensual en trimestral) hace un promedio de los valores de cada per\u00edodo . Esta funci\u00f3n de agregaci\u00f3n se puede cambiar para toda la consulta con el par\u00e1metro collapse_aggregation , o para cada serie en particular (suma, m\u00e1ximo, m\u00ednimo, etc.). Tipo de cambio. Valores diarios a cierre de cada mes. https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26&collapse=month&collapse_aggregation=end_of_period&format=csv Tipo de cambio. Valores diarios m\u00ednimo, promedio, m\u00e1ximo y cierre de cada mes. https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26:min,168.1_T_CAMBIOR_D_0_0_26:avg,168.1_T_CAMBIOR_D_0_0_26:max,168.1_T_CAMBIOR_D_0_0_26:end_of_period&collapse=month&format=csv&limit=1000","title":"Cambiar la funci\u00f3n de agregaci\u00f3n temporal"},{"location":"additional-parameters/#aplicar-transformaciones","text":"Las series de pueden transformar en otras unidades (variaci\u00f3n porcentual, variaci\u00f3n interanual, etc.) en forma individual o conjunta, usando el par\u00e1metro representation_mode . Tipo de cambio, IPC n\u00facleo e IPC nivel general desde Enero de 2016. Variaci\u00f3n porcentual de valores mensuales, respecto del per\u00edodo anterior. https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26,103.1_I2N_2016_M_15,103.1_I2N_2016_M_19&collapse=month&format=csv&start_date=2016-01&representation_mode=percent_change IPC n\u00facleo, IPC n\u00facleo (variaci\u00f3n porcentual per\u00edodo a per\u00edodo) e IPC n\u00facleo (variaci\u00f3n porcentual interanual) desde Enero de 2016. Valores mensuales. Nota: series con unidades de diferentes escalas, pueden ser dif\u00edciles de visualizar en un mismo gr\u00e1fico. https://apis.datos.gob.ar/series/api/series?ids=103.1_I2N_2016_M_15,103.1_I2N_2016_M_15:percent_change,103.1_I2N_2016_M_15:percent_change_a_year_ago&start_date=2016-01&format=csv&limit=1000","title":"Aplicar transformaciones"},{"location":"additional-parameters/#aplicar-transformaciones-y-cambiar-la-funcion-de-agregacion-temporal-en-series-individuales-a-la-vez","text":"Es posible aplicar a las series individuales tanto una transformaci\u00f3n como una funci\u00f3n de agregaci\u00f3n particular a la vez . En todos los casos, siempre se aplica primero la funci\u00f3n de agregaci\u00f3n y luego la transformaci\u00f3n . Tipo de cambio. Variaci\u00f3n porcentual de valores diarios a cierre de cada mes, respecto del per\u00edodo anterior. http://apis.datos.gob.ar/series/api/series/?limit=1000&collapse=month&ids=168.1_T_CAMBIOR_D_0_0_26:end_of_period:percent_change&format=csv","title":"Aplicar transformaciones y cambiar la funci\u00f3n de agregaci\u00f3n temporal en series individuales, a la vez"},{"location":"applications/","text":"Aplicaciones Lista de proyectos y aplicaciones que utilizan, extienden o documentan la API de Series de Tiempo. Propias datosgobar/series-tiempo-ar-landing : Tablero web modular y parametrizado para armar un dashboard de indicadores con datos y gr\u00e1ficos, basado en la API de Series de Tiempo. datosgobar/series-tiempo-ar-call-generator : Form liviano y sencillo para generar llamadas a la API de Series de Tiempo. De terceros fmgarciadiaz/PortalHacienda : Interface en R para usar la API por @fergd1978 . http://series-de-tiempo-ar-graficos.netlify.com/ : Navegador y visualizador web de series por @SoyYoConBonete_ . Contacto \u00bfDesarrollaste una librer\u00eda o ten\u00e9s un proyecto que usa la API? Te invitamos a contarnos as\u00ed la agregamos a esta lista. Para todo lo dem\u00e1s, pod\u00e9s mandarnos tu comentario o consulta a datos@modernizacion.gob.ar .","title":"Aplicaciones"},{"location":"applications/#aplicaciones","text":"Lista de proyectos y aplicaciones que utilizan, extienden o documentan la API de Series de Tiempo.","title":"Aplicaciones"},{"location":"applications/#propias","text":"datosgobar/series-tiempo-ar-landing : Tablero web modular y parametrizado para armar un dashboard de indicadores con datos y gr\u00e1ficos, basado en la API de Series de Tiempo. datosgobar/series-tiempo-ar-call-generator : Form liviano y sencillo para generar llamadas a la API de Series de Tiempo.","title":"Propias"},{"location":"applications/#de-terceros","text":"fmgarciadiaz/PortalHacienda : Interface en R para usar la API por @fergd1978 . http://series-de-tiempo-ar-graficos.netlify.com/ : Navegador y visualizador web de series por @SoyYoConBonete_ .","title":"De terceros"},{"location":"applications/#contacto","text":"\u00bfDesarrollaste una librer\u00eda o ten\u00e9s un proyecto que usa la API? Te invitamos a contarnos as\u00ed la agregamos a esta lista. Para todo lo dem\u00e1s, pod\u00e9s mandarnos tu comentario o consulta a datos@modernizacion.gob.ar .","title":"Contacto"},{"location":"dumps/","text":"Se encuentran disponibles varios archivos con los mismos datos de la base de series de tiempo disponibles a trav\u00e9s de la API. Los datos est\u00e1n para descargar en cuatro formatos: CSV XLSX SQL (Una base de datos SQLITE) DTA Existen varios paquetes de datos por cada formato: Valores y metadatos desagregados: Contiene a la base entera de datos, junto con los metadatos de las series en cada indicador S\u00f3lo valores: Contiene a la base entera de datos, con una cantidad de metadatos de las series reducida respecto al paquete anterior Metadatos: Contiene a todos los metadatos de cada serie de tiempo en la base. No contiene datos (indicadores) de las series. Fuentes: Indicadores sobre las fuentes de datos disponibles en la base. Puede resultar \u00fatil como punto de partida para buscar series. Links de descarga Los dumps de la base de datos entera est\u00e1n disponibles bajo la siguiente ruta: https://apis.datos.gob.ar/series/api/dump/:dump Donde :dump puede ser uno de los siguientes archivos: Formato CSV: series-tiempo-csv.zip series-tiempo-valores-csv.zip series-tiempo-metadatos.csv series-tiempo-fuentes.csv Formato XLSX: series-tiempo.xlsx series-tiempo-valores.xlsx series-tiempo-metadatos.xlsx series-tiempo-fuentes.xlsx Formato SQL: La base de datos en SQL contiene a estos paquetes como tablas, todas en un \u00fanico archivo. series-tiempo-sqlite.zip Formato DTA: series-tiempo-valores-dta.zip series-tiempo-metadatos.dta series-tiempo-fuentes.dta Notar que para el formato DTA no se disponibiliza la distribuci\u00f3n con valores y metadatos desagregados. Por ejemplo, la base de series de tiempo entera, junto con varios metadatos de las series, en formato XLSX, se encuentra disponible bajo https://apis.datos.gob.ar/series/api/dump/series-tiempo.xlsx Dumps por cat\u00e1logo A su vez, tambi\u00e9n existen versiones de los datos desagregados seg\u00fan el cat\u00e1logo de origen. Se encuentran en la siguiente URL de descarga: https://apis.datos.gob.ar/series/api/dump/:catalog/:dump Los cat\u00e1logos se pueden consultar bajo el siguiente endpoint de la API de b\u00fasqueda: https://apis.datos.gob.ar/series/api/search/catalog_id/ Por ejemplo, para consultar las fuentes del cat\u00e1logo sspm (de la Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica del Ministerio de Hacienda de la Naci\u00f3n), en formato XLSX, se puede acceder en la siguiente URL: https://apis.datos.gob.ar/series/api/dump/sspm/series-tiempo-fuentes.xlsx","title":"Descargar la base completa de series de tiempo"},{"location":"dumps/#links-de-descarga","text":"Los dumps de la base de datos entera est\u00e1n disponibles bajo la siguiente ruta: https://apis.datos.gob.ar/series/api/dump/:dump Donde :dump puede ser uno de los siguientes archivos: Formato CSV: series-tiempo-csv.zip series-tiempo-valores-csv.zip series-tiempo-metadatos.csv series-tiempo-fuentes.csv Formato XLSX: series-tiempo.xlsx series-tiempo-valores.xlsx series-tiempo-metadatos.xlsx series-tiempo-fuentes.xlsx Formato SQL: La base de datos en SQL contiene a estos paquetes como tablas, todas en un \u00fanico archivo. series-tiempo-sqlite.zip Formato DTA: series-tiempo-valores-dta.zip series-tiempo-metadatos.dta series-tiempo-fuentes.dta Notar que para el formato DTA no se disponibiliza la distribuci\u00f3n con valores y metadatos desagregados. Por ejemplo, la base de series de tiempo entera, junto con varios metadatos de las series, en formato XLSX, se encuentra disponible bajo https://apis.datos.gob.ar/series/api/dump/series-tiempo.xlsx","title":"Links de descarga"},{"location":"dumps/#dumps-por-catalogo","text":"A su vez, tambi\u00e9n existen versiones de los datos desagregados seg\u00fan el cat\u00e1logo de origen. Se encuentran en la siguiente URL de descarga: https://apis.datos.gob.ar/series/api/dump/:catalog/:dump Los cat\u00e1logos se pueden consultar bajo el siguiente endpoint de la API de b\u00fasqueda: https://apis.datos.gob.ar/series/api/search/catalog_id/ Por ejemplo, para consultar las fuentes del cat\u00e1logo sspm (de la Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica del Ministerio de Hacienda de la Naci\u00f3n), en formato XLSX, se puede acceder en la siguiente URL: https://apis.datos.gob.ar/series/api/dump/sspm/series-tiempo-fuentes.xlsx","title":"Dumps por cat\u00e1logo"},{"location":"history/","text":"Historial de versiones 1.12.0 Bugfixes en indexaci\u00f3n y respuesta de API series (#471, #473, #474) Administraci\u00f3n de unidades de series, con atributo de si son porcentuales Conteo de series en cada filtro de metadatos Actualizaci\u00f3n de validaciones de series durante la indexaci\u00f3n 1.11.0 Metadatos de consultas de las series: rutina de c\u00e1lculo diaria, uso en dumps y en resultados de b\u00fasqueda de series 1.10.0 Nuevos metadatos de series: representation_mode y representation_mode_units Borrado del croneado de tareas usado para metadatos, analytics y test de integraci\u00f3n. Su funcionalidad qued\u00f3 deprecada por Synchronizer de django_datajsonar . 1.9.0 Bump de la versi\u00f3n de django_datajsonar a 0.1.17, con mejoras de UX de Synchronizers Bump de la versi\u00f3n de series-tiempo-ar a 0.2.1, con una validaci\u00f3n adicional para permitir distribuciones con series vac\u00edas, hasta cierta proporci\u00f3n. Agregados nuevos metadatos de series ( metadata=full o metadata=only ): max_value , min_value , average 1.8.0 Integraci\u00f3n con django_datajsonar: Uso de Synchronizers y Stages para correr tareas asincr\u00f3nicas de manera ordenada 1.7.0 Optimizaciones de performance en dumps CSV Indexaci\u00f3n de datos: siempre se reindexan completamente las distribuciones ( refresh ) Test de integraci\u00f3n y consistencia de los datos, a correr despu\u00e9s de la indexaci\u00f3n diaria. Bugfix de series sin datos cuando eran pedidas en un solo request Traducci\u00f3n parcial del panel de administraci\u00f3n a espa\u00f1ol 1.6.0 Release con herramientas de administraci\u00f3n para \"refrescar\" distribuciones de datos inconsistentes con su fuente. 1.5.1 Correcciones a dumps: Header faltante en hojas adicionales en dump XLSX Columnas y nombres de una tabla de dumps SQL Bugfix de generaci\u00f3n de dump global XLSX Mejoras de organizaci\u00f3n en el admin de django 1.5.0 Nuevo par\u00e1metro last . Ver documentaci\u00f3n Permito trailing slashes en URLs de descarga de dumps 1.4.3 Fix de estabilidad de generaci\u00f3n de dumps en general. 1.4.2 Fix a tasks asincr\u00f3nicas de dumps no corriendo correctamente cuando son generadas desde el admin 1.4.0 Orden a filas de dump de metadatos No es m\u00e1s necesario setear dataset_identifier en distributciones para ser indexadas Se permiten csvs de distribuciones con encoding distinto a utf-8 1.3.3 Callables de rqscheduler para dumps CSV y XLSX. 1.3.2 Optimizaciones de memoria de generaci\u00f3n dumps xlsx 1.3.1 Peque\u00f1o release con un fix a parseo de URLs de descarga de distribuciones 1.3.0 hotfix 2 Hotfix para servir files de minio desde una ruta interna de la aplicaci\u00f3n 1.3.0 hotfix 1 Hotfixes de logging de dump 1.3.0 Nueva generaci\u00f3n de dumps en CSV, usando los datos cargados en postgres, y generando dumps individuales por cat\u00e1logo. Borrado de datos en el endpoint de /search/ cuando una serie se borra de la base de datos 1.2.1 Refactor e integraci\u00f3n de generaci\u00f3n de dumps de la base de datos de series de tiempo, para utilizar postgres en vez de Elasticsearch e integrar los archivos al filesystem distribuido 1.2.0 Adopci\u00f3n de semver como sistema de versionado File system distribuido (minio) Optimizaciones en la UI del admin Display de mensajes de error en reportes de indexaci\u00f3n 1.1.8 Correcciones en importado de analytics para adaptarse a la nueva API paginada con cursor en api mgmt 1.1.7 Cambio de nombres de respuesta de metadatos. Fixes de usabilidad del admin relacionado a administradores de nodos. Bugfixes en respuesta de /series 1.1.6 Se aumenta el l\u00edmite de series m\u00e1ximas por request a 40 Revisi\u00f3n de nombres y agregado de metadatos en la respuesta de /series Cambio de nombre de par\u00e1metro de /search: offset -> start para consistencia con /series 1.1.5 An\u00e1lisis y tokenizaci\u00f3n de texto para la b\u00fasqueda de metadatos en /search. Permite reconocer palabras sin acento, entre otras cosas. Muestra de metadatos enriquecidos de las series pedidas en /series, cuando se pide la respuesta con metadata=full o metadata=only. Actualmente todos los valores devueltos son de tipo string, sujeto a cambios a futuro. 1.1.4 Modificaci\u00f3n de la respuesta de metadatos en search/: se agregan campos dataset.theme, dataset.source y field.units. Adem\u00e1s se cambia la respuesta de field.periodicity de formato legible por humanos a ISO8601 1.1.3 Actualizaciones de django_datajsonar Se agregan aliases de cat\u00e1logos para metadatos. Se puede configurar un alias para los filtros catalog_id que sea equivalente a filtrar por uno o m\u00e1s cat\u00e1logos. 1.1.2 Funcionalidades de importado hist\u00f3rico de analytics, y ampliaci\u00f3n de los datos guardados de cada query 1.1.1 Validaci\u00f3n de cat\u00e1logos le\u00eddos al generar reporte Fixes a los valores de reportes Fix de metadatos enriquecidos no mostr\u00e1ndose bien en /search/ 1.1.0 Nuevo formato de respuesta de metadatos tanto en /series como en /search Mejoras en visualizaciones del admin de django 1.0.18 Mejoras al endpoint de b\u00fasqueda: nuevo par\u00e1metro catalog_id Mejoras al indexado de metadatos Configuraci\u00f3n de importado de analytics desde un API gateway 1.0.17 Se pasa a usar django_datajsonar como dependencia directa para manejar las entidades procesadas de data.json de los nodos 1.0.16-1 Actualizaci\u00f3n de dependencias pydatajson==0.4.12 1.0.16 Actualizaci\u00f3n de validaciones para indexaci\u00f3n 1.0.15 Release con: Resumen de reporte de indexaci\u00f3n Detalle de cada entidad indexada como archivos adjuntos en el reporte Reimplementaci\u00f3n de aggregations max y min Fechas en el dump de analytics se exportan en horario local 1.0.14 Mejoras al formato del reporte de indexaci\u00f3n, junto con mensajes de error m\u00e1s descriptivos 1.0.13 Hotfix con fixes a comportamiento err\u00f3neo en queries de dos series iguales con distinto modo de representaci\u00f3n + uso de caracter decimal no default 1.0.12 Release con: Permite generar reportes de indexaci\u00f3n individuales por nodo Fixes a valores de los reportes (datasets actualizados, no actualizados) Mejoras de performance de la indexaci\u00f3n de metadatos 1.0.11 Generaci\u00f3n de reporte de indexaci\u00f3n completo: Nuevos fields para cat\u00e1logos, datasets, distribuciones y series. 1.0.10 Mejoras en la generaci\u00f3n de reportes de indexaci\u00f3n, con m\u00e1s campos reportados. 1.0.9 Mostrado de versi\u00f3n en la p\u00e1gina principal del admin de Django Mejora del proceso de indexaci\u00f3n y persistencia de las m\u00e9tricas obtenidas Bugfix para permitir que las series de tiempo puedan cambiar de distribuci\u00f3n dentro de un mismo cat\u00e1logo 1.0.8 Bugfixes: Correcciones a llamadas de series m\u00faltiples en orden descendiente Permito la exportaci\u00f3n correcta de analytics a CSV en vol\u00famenes grandes Correcciones a guardados de analytics err\u00f3neos 1.0.7 Endpoint de b\u00fasqueda de series: /search 1.0.6 Fixes a herramientas de administraci\u00f3n: No se indexan metadatos de series y distribuciones pertenecientes a cat\u00e1logos no marcados como indexables Finalizaci\u00f3n autom\u00e1tica de la tarea de indexaci\u00f3n si no hay datasets marcados como indexable Arreglos a borrados de croneado de tareas de indexaci\u00f3n 1.0.3 Herramientas de administraci\u00f3n: Configuraci\u00f3n de que nodos y datasets se deben indexar Configuraci\u00f3n del croneado de la tarea de indexaci\u00f3n Generaci\u00f3n de reportes de resultado de indexaci\u00f3n por mail a los administradores 1.0.0 Release inicial","title":"Historial de versiones"},{"location":"history/#historial-de-versiones","text":"","title":"Historial de versiones"},{"location":"history/#1120","text":"Bugfixes en indexaci\u00f3n y respuesta de API series (#471, #473, #474) Administraci\u00f3n de unidades de series, con atributo de si son porcentuales Conteo de series en cada filtro de metadatos Actualizaci\u00f3n de validaciones de series durante la indexaci\u00f3n","title":"1.12.0"},{"location":"history/#1110","text":"Metadatos de consultas de las series: rutina de c\u00e1lculo diaria, uso en dumps y en resultados de b\u00fasqueda de series","title":"1.11.0"},{"location":"history/#1100","text":"Nuevos metadatos de series: representation_mode y representation_mode_units Borrado del croneado de tareas usado para metadatos, analytics y test de integraci\u00f3n. Su funcionalidad qued\u00f3 deprecada por Synchronizer de django_datajsonar .","title":"1.10.0"},{"location":"history/#190","text":"Bump de la versi\u00f3n de django_datajsonar a 0.1.17, con mejoras de UX de Synchronizers Bump de la versi\u00f3n de series-tiempo-ar a 0.2.1, con una validaci\u00f3n adicional para permitir distribuciones con series vac\u00edas, hasta cierta proporci\u00f3n. Agregados nuevos metadatos de series ( metadata=full o metadata=only ): max_value , min_value , average","title":"1.9.0"},{"location":"history/#180","text":"Integraci\u00f3n con django_datajsonar: Uso de Synchronizers y Stages para correr tareas asincr\u00f3nicas de manera ordenada","title":"1.8.0"},{"location":"history/#170","text":"Optimizaciones de performance en dumps CSV Indexaci\u00f3n de datos: siempre se reindexan completamente las distribuciones ( refresh ) Test de integraci\u00f3n y consistencia de los datos, a correr despu\u00e9s de la indexaci\u00f3n diaria. Bugfix de series sin datos cuando eran pedidas en un solo request Traducci\u00f3n parcial del panel de administraci\u00f3n a espa\u00f1ol","title":"1.7.0"},{"location":"history/#160","text":"Release con herramientas de administraci\u00f3n para \"refrescar\" distribuciones de datos inconsistentes con su fuente.","title":"1.6.0"},{"location":"history/#151","text":"Correcciones a dumps: Header faltante en hojas adicionales en dump XLSX Columnas y nombres de una tabla de dumps SQL Bugfix de generaci\u00f3n de dump global XLSX Mejoras de organizaci\u00f3n en el admin de django","title":"1.5.1"},{"location":"history/#150","text":"Nuevo par\u00e1metro last . Ver documentaci\u00f3n Permito trailing slashes en URLs de descarga de dumps","title":"1.5.0"},{"location":"history/#143","text":"Fix de estabilidad de generaci\u00f3n de dumps en general.","title":"1.4.3"},{"location":"history/#142","text":"Fix a tasks asincr\u00f3nicas de dumps no corriendo correctamente cuando son generadas desde el admin","title":"1.4.2"},{"location":"history/#140","text":"Orden a filas de dump de metadatos No es m\u00e1s necesario setear dataset_identifier en distributciones para ser indexadas Se permiten csvs de distribuciones con encoding distinto a utf-8","title":"1.4.0"},{"location":"history/#133","text":"Callables de rqscheduler para dumps CSV y XLSX.","title":"1.3.3"},{"location":"history/#132","text":"Optimizaciones de memoria de generaci\u00f3n dumps xlsx","title":"1.3.2"},{"location":"history/#131","text":"Peque\u00f1o release con un fix a parseo de URLs de descarga de distribuciones","title":"1.3.1"},{"location":"history/#130-hotfix-2","text":"Hotfix para servir files de minio desde una ruta interna de la aplicaci\u00f3n","title":"1.3.0 hotfix 2"},{"location":"history/#130-hotfix-1","text":"Hotfixes de logging de dump","title":"1.3.0 hotfix 1"},{"location":"history/#130","text":"Nueva generaci\u00f3n de dumps en CSV, usando los datos cargados en postgres, y generando dumps individuales por cat\u00e1logo. Borrado de datos en el endpoint de /search/ cuando una serie se borra de la base de datos","title":"1.3.0"},{"location":"history/#121","text":"Refactor e integraci\u00f3n de generaci\u00f3n de dumps de la base de datos de series de tiempo, para utilizar postgres en vez de Elasticsearch e integrar los archivos al filesystem distribuido","title":"1.2.1"},{"location":"history/#120","text":"Adopci\u00f3n de semver como sistema de versionado File system distribuido (minio) Optimizaciones en la UI del admin Display de mensajes de error en reportes de indexaci\u00f3n","title":"1.2.0"},{"location":"history/#118","text":"Correcciones en importado de analytics para adaptarse a la nueva API paginada con cursor en api mgmt","title":"1.1.8"},{"location":"history/#117","text":"Cambio de nombres de respuesta de metadatos. Fixes de usabilidad del admin relacionado a administradores de nodos. Bugfixes en respuesta de /series","title":"1.1.7"},{"location":"history/#116","text":"Se aumenta el l\u00edmite de series m\u00e1ximas por request a 40 Revisi\u00f3n de nombres y agregado de metadatos en la respuesta de /series Cambio de nombre de par\u00e1metro de /search: offset -> start para consistencia con /series","title":"1.1.6"},{"location":"history/#115","text":"An\u00e1lisis y tokenizaci\u00f3n de texto para la b\u00fasqueda de metadatos en /search. Permite reconocer palabras sin acento, entre otras cosas. Muestra de metadatos enriquecidos de las series pedidas en /series, cuando se pide la respuesta con metadata=full o metadata=only. Actualmente todos los valores devueltos son de tipo string, sujeto a cambios a futuro.","title":"1.1.5"},{"location":"history/#114","text":"Modificaci\u00f3n de la respuesta de metadatos en search/: se agregan campos dataset.theme, dataset.source y field.units. Adem\u00e1s se cambia la respuesta de field.periodicity de formato legible por humanos a ISO8601","title":"1.1.4"},{"location":"history/#113","text":"Actualizaciones de django_datajsonar Se agregan aliases de cat\u00e1logos para metadatos. Se puede configurar un alias para los filtros catalog_id que sea equivalente a filtrar por uno o m\u00e1s cat\u00e1logos.","title":"1.1.3"},{"location":"history/#112","text":"Funcionalidades de importado hist\u00f3rico de analytics, y ampliaci\u00f3n de los datos guardados de cada query","title":"1.1.2"},{"location":"history/#111","text":"Validaci\u00f3n de cat\u00e1logos le\u00eddos al generar reporte Fixes a los valores de reportes Fix de metadatos enriquecidos no mostr\u00e1ndose bien en /search/","title":"1.1.1"},{"location":"history/#110","text":"Nuevo formato de respuesta de metadatos tanto en /series como en /search Mejoras en visualizaciones del admin de django","title":"1.1.0"},{"location":"history/#1018","text":"Mejoras al endpoint de b\u00fasqueda: nuevo par\u00e1metro catalog_id Mejoras al indexado de metadatos Configuraci\u00f3n de importado de analytics desde un API gateway","title":"1.0.18"},{"location":"history/#1017","text":"Se pasa a usar django_datajsonar como dependencia directa para manejar las entidades procesadas de data.json de los nodos","title":"1.0.17"},{"location":"history/#1016-1","text":"Actualizaci\u00f3n de dependencias pydatajson==0.4.12","title":"1.0.16-1"},{"location":"history/#1016","text":"Actualizaci\u00f3n de validaciones para indexaci\u00f3n","title":"1.0.16"},{"location":"history/#1015","text":"Release con: Resumen de reporte de indexaci\u00f3n Detalle de cada entidad indexada como archivos adjuntos en el reporte Reimplementaci\u00f3n de aggregations max y min Fechas en el dump de analytics se exportan en horario local","title":"1.0.15"},{"location":"history/#1014","text":"Mejoras al formato del reporte de indexaci\u00f3n, junto con mensajes de error m\u00e1s descriptivos","title":"1.0.14"},{"location":"history/#1013","text":"Hotfix con fixes a comportamiento err\u00f3neo en queries de dos series iguales con distinto modo de representaci\u00f3n + uso de caracter decimal no default","title":"1.0.13"},{"location":"history/#1012","text":"Release con: Permite generar reportes de indexaci\u00f3n individuales por nodo Fixes a valores de los reportes (datasets actualizados, no actualizados) Mejoras de performance de la indexaci\u00f3n de metadatos","title":"1.0.12"},{"location":"history/#1011","text":"Generaci\u00f3n de reporte de indexaci\u00f3n completo: Nuevos fields para cat\u00e1logos, datasets, distribuciones y series.","title":"1.0.11"},{"location":"history/#1010","text":"Mejoras en la generaci\u00f3n de reportes de indexaci\u00f3n, con m\u00e1s campos reportados.","title":"1.0.10"},{"location":"history/#109","text":"Mostrado de versi\u00f3n en la p\u00e1gina principal del admin de Django Mejora del proceso de indexaci\u00f3n y persistencia de las m\u00e9tricas obtenidas Bugfix para permitir que las series de tiempo puedan cambiar de distribuci\u00f3n dentro de un mismo cat\u00e1logo","title":"1.0.9"},{"location":"history/#108","text":"Bugfixes: Correcciones a llamadas de series m\u00faltiples en orden descendiente Permito la exportaci\u00f3n correcta de analytics a CSV en vol\u00famenes grandes Correcciones a guardados de analytics err\u00f3neos","title":"1.0.8"},{"location":"history/#107","text":"Endpoint de b\u00fasqueda de series: /search","title":"1.0.7"},{"location":"history/#106","text":"Fixes a herramientas de administraci\u00f3n: No se indexan metadatos de series y distribuciones pertenecientes a cat\u00e1logos no marcados como indexables Finalizaci\u00f3n autom\u00e1tica de la tarea de indexaci\u00f3n si no hay datasets marcados como indexable Arreglos a borrados de croneado de tareas de indexaci\u00f3n","title":"1.0.6"},{"location":"history/#103","text":"Herramientas de administraci\u00f3n: Configuraci\u00f3n de que nodos y datasets se deben indexar Configuraci\u00f3n del croneado de la tarea de indexaci\u00f3n Generaci\u00f3n de reportes de resultado de indexaci\u00f3n por mail a los administradores","title":"1.0.3"},{"location":"history/#100","text":"Release inicial","title":"1.0.0"},{"location":"python-usage/","text":"Usar en python Con requests Con pandas Con requests Armar una funci\u00f3n wrapper que facilite construir llamadas a la API. import requests import urllib.parse def get_api_call ( ids , ** kwargs ): API_BASE_URL = \"https://apis.datos.gob.ar/series/api/\" kwargs [ \"ids\" ] = \",\" . join ( ids ) return \"{}{}?{}\" . format ( API_BASE_URL , \"series\" , urllib . parse . urlencode ( kwargs )) Una llamada v\u00e1lida a la API debe tener por lo menos un id de una serie v\u00e1lida, y luego puede tener par\u00e1metros opcionales. api_call = get_api_call ([ \"168.1_T_CAMBIOR_D_0_0_26\" ], start_date = \"2018-08\" ) print ( api_call ) https : // apis . datos . gob . ar / series / api / series ? start_date = 2018 - 08 & ids = 168.1 _T_CAMBIOR_D_0_0_26 Obtener la respuesta en un diccionario. result = requests . get ( api_call ) . json () print ( result ) { 'data' : [[ '2018-08-01' , 27.525 ], [ '2018-08-02' , 27.45 ], [ '2018-08-03' , 27.29 ], [ '2018-08-04' , 27.29 ], [ '2018-08-05' , 27.29 ], [ '2018-08-06' , 27.33 ], [ '2018-08-07' , 27.395 ], [ '2018-08-08' , 27.65 ], [ '2018-08-09' , 28.11 ], [ '2018-08-10' , 29.25 ], [ '2018-08-11' , 29.25 ], [ '2018-08-12' , 29.25 ], [ '2018-08-13' , 29.925 ], [ '2018-08-14' , 29.61 ], [ '2018-08-15' , 30.0 ], [ '2018-08-16' , 29.84 ]], 'meta' : [{ 'end_date' : '2018-08-16' , 'frequency' : 'day' , 'start_date' : '2018-08-01' }, { 'catalog' : { 'title' : 'Datos Programaci\u00f3n Macroecon\u00f3mica' }, 'dataset' : { 'description' : 'Datos de tipo de cambio $-USD - futuro d\u00f3lar . Con respecto al d\u00f3lar de Estados Unidos. Frecuencia diaria.' , 'issued' : '2017-09-28' , 'source' : 'BCRA, MAE, Rofex y Bloomberg' , 'title' : 'Tipo de Cambio $-USD - Futuro D\u00f3lar' }, 'distribution' : { 'downloadURL' : 'http://infra.datos.gob.ar/catalog/sspm/dataset/168/distribution/168.1/download/datos-tipo-cambio-usd-futuro-dolar-frecuencia-diaria.csv' , 'title' : 'Tipo de cambio $-USD - futuro d\u00f3lar. Valores diarios' }, 'field' : { 'description' : 'Tipo de Cambio BNA (Vendedor)' , 'id' : '168.1_T_CAMBIOR_D_0_0_26' , 'units' : 'Pesos argentinos por d\u00f3lar' }}], 'params' : { 'identifiers' : [{ 'dataset' : '168' , 'distribution' : '168.1' , 'id' : '168.1_T_CAMBIOR_D_0_0_26' }], 'ids' : '168.1_T_CAMBIOR_D_0_0_26' , 'start_date' : '2018-08' }} Con pandas Las llamadas a la API en CSV se pueden leer directamente a un pandas.DataFrame . import pandas as pd df = pd . read_csv ( get_api_call ( [ \"168.1_T_CAMBIOR_D_0_0_26\" , \"101.1_I2NG_2016_M_22\" , \"116.3_TCRMA_0_M_36\" , \"143.3_NO_PR_2004_A_21\" , \"11.3_VMATC_2004_M_12\" ], format = \"csv\" , start_date = 2018 )) indice_tiempo tipo_cambio_bna_vendedor ipc_2016_nivel_general \\ 2018-01-01 19.023065 127.0147 2018-02-01 19.835179 130.2913 2018-03-01 20.229355 133.5028 2018-04-01 20.251100 136.9380 2018-05-01 23.600452 139.5800 2018-06-01 26.674333 145.0582 2018-07-01 27.607645 149.1178 tipo_cambio_real_multilateral_actual indice_serie_original construccion 96.628715 144.086686 158.920762 96.121512 138.470530 152.630381 93.062453 155.570021 158.931156 90.715862 152.432629 149.860484 104.302984 160.622476 154.011846 114.546258 NaN NaN 107.105698 NaN NaN","title":"Usar en python"},{"location":"python-usage/#usar-en-python","text":"Con requests Con pandas","title":"Usar en python"},{"location":"python-usage/#con-requests","text":"Armar una funci\u00f3n wrapper que facilite construir llamadas a la API. import requests import urllib.parse def get_api_call ( ids , ** kwargs ): API_BASE_URL = \"https://apis.datos.gob.ar/series/api/\" kwargs [ \"ids\" ] = \",\" . join ( ids ) return \"{}{}?{}\" . format ( API_BASE_URL , \"series\" , urllib . parse . urlencode ( kwargs )) Una llamada v\u00e1lida a la API debe tener por lo menos un id de una serie v\u00e1lida, y luego puede tener par\u00e1metros opcionales. api_call = get_api_call ([ \"168.1_T_CAMBIOR_D_0_0_26\" ], start_date = \"2018-08\" ) print ( api_call ) https : // apis . datos . gob . ar / series / api / series ? start_date = 2018 - 08 & ids = 168.1 _T_CAMBIOR_D_0_0_26 Obtener la respuesta en un diccionario. result = requests . get ( api_call ) . json () print ( result ) { 'data' : [[ '2018-08-01' , 27.525 ], [ '2018-08-02' , 27.45 ], [ '2018-08-03' , 27.29 ], [ '2018-08-04' , 27.29 ], [ '2018-08-05' , 27.29 ], [ '2018-08-06' , 27.33 ], [ '2018-08-07' , 27.395 ], [ '2018-08-08' , 27.65 ], [ '2018-08-09' , 28.11 ], [ '2018-08-10' , 29.25 ], [ '2018-08-11' , 29.25 ], [ '2018-08-12' , 29.25 ], [ '2018-08-13' , 29.925 ], [ '2018-08-14' , 29.61 ], [ '2018-08-15' , 30.0 ], [ '2018-08-16' , 29.84 ]], 'meta' : [{ 'end_date' : '2018-08-16' , 'frequency' : 'day' , 'start_date' : '2018-08-01' }, { 'catalog' : { 'title' : 'Datos Programaci\u00f3n Macroecon\u00f3mica' }, 'dataset' : { 'description' : 'Datos de tipo de cambio $-USD - futuro d\u00f3lar . Con respecto al d\u00f3lar de Estados Unidos. Frecuencia diaria.' , 'issued' : '2017-09-28' , 'source' : 'BCRA, MAE, Rofex y Bloomberg' , 'title' : 'Tipo de Cambio $-USD - Futuro D\u00f3lar' }, 'distribution' : { 'downloadURL' : 'http://infra.datos.gob.ar/catalog/sspm/dataset/168/distribution/168.1/download/datos-tipo-cambio-usd-futuro-dolar-frecuencia-diaria.csv' , 'title' : 'Tipo de cambio $-USD - futuro d\u00f3lar. Valores diarios' }, 'field' : { 'description' : 'Tipo de Cambio BNA (Vendedor)' , 'id' : '168.1_T_CAMBIOR_D_0_0_26' , 'units' : 'Pesos argentinos por d\u00f3lar' }}], 'params' : { 'identifiers' : [{ 'dataset' : '168' , 'distribution' : '168.1' , 'id' : '168.1_T_CAMBIOR_D_0_0_26' }], 'ids' : '168.1_T_CAMBIOR_D_0_0_26' , 'start_date' : '2018-08' }}","title":"Con requests"},{"location":"python-usage/#con-pandas","text":"Las llamadas a la API en CSV se pueden leer directamente a un pandas.DataFrame . import pandas as pd df = pd . read_csv ( get_api_call ( [ \"168.1_T_CAMBIOR_D_0_0_26\" , \"101.1_I2NG_2016_M_22\" , \"116.3_TCRMA_0_M_36\" , \"143.3_NO_PR_2004_A_21\" , \"11.3_VMATC_2004_M_12\" ], format = \"csv\" , start_date = 2018 )) indice_tiempo tipo_cambio_bna_vendedor ipc_2016_nivel_general \\ 2018-01-01 19.023065 127.0147 2018-02-01 19.835179 130.2913 2018-03-01 20.229355 133.5028 2018-04-01 20.251100 136.9380 2018-05-01 23.600452 139.5800 2018-06-01 26.674333 145.0582 2018-07-01 27.607645 149.1178 tipo_cambio_real_multilateral_actual indice_serie_original construccion 96.628715 144.086686 158.920762 96.121512 138.470530 152.630381 93.062453 155.570021 158.931156 90.715862 152.432629 149.860484 104.302984 160.622476 154.011846 114.546258 NaN NaN 107.105698 NaN NaN","title":"Con pandas"},{"location":"quick-start/","text":"Comenzar a usar la API de Series de Tiempo 1. Buscar series En un archivo En el explorador de series 2. Armar consulta Manualmente En el generador de consultas 3. Realizar consulta Consultar o integrar JSON Descargar CSV Integrar en planilla de c\u00e1lculo Consultar en el explorador de series 1. Buscar series Para usar la API, ten\u00e9s que buscar los ids de las series que te interesan. En un archivo En datos.gob.ar pod\u00e9s encontrar la base completa de series de tiempo , que contiene la lista de series disponibles en: CSV XLSX DTA En el explorador de series En el Explorador de Series de Tiempo pod\u00e9s buscar series, visualizarlas y compartir las URLs a la API o al explorador. 2. Armar consulta Manualmente Los ids de las series deben pasarse al par\u00e1metro ids . Se pueden usar par\u00e1metros adicionales para filtrar y transformar las series . Ver la referencia API para consultar la documentaci\u00f3n completa de todos los par\u00e1metros disponibles. En el generador de consultas En el generador de consultas pod\u00e9s ver todos los par\u00e1metros disponibles en la API para armar tu consulta. 3. Realizar consulta Consultar o integrar JSON Para realizar la consulta directamente en el navegador, o integrarla en una aplicaci\u00f3n: Usar format=json (valor default). Elegir el nivel de detalle de los metadatos metadata=none , only , simple o full . https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26,103.1_I2N_2016_M_15&format=json&metadata=full Descargar CSV Para descargar un archivo CSV: Usar format=csv . https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26,103.1_I2N_2016_M_15&format=csv Integrar en planilla de c\u00e1lculo Tanto la consulta en CSV como en JSON se pueden integrar en planillas de c\u00e1lculo . Consultar en el explorador de series Cualquier llamada a la API se puede visualizar en el explorador quitando el subdominio apis de la URL (y cambiando a HTTP): Llamada a la API https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26:percent_change_a_year_ago&collapse=month Consulta en el explorador http://datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26:percent_change_a_year_ago&collapse=month","title":"Comenzar a usar la API de Series de Tiempo"},{"location":"quick-start/#comenzar-a-usar-la-api-de-series-de-tiempo","text":"1. Buscar series En un archivo En el explorador de series 2. Armar consulta Manualmente En el generador de consultas 3. Realizar consulta Consultar o integrar JSON Descargar CSV Integrar en planilla de c\u00e1lculo Consultar en el explorador de series","title":"Comenzar a usar la API de Series de Tiempo"},{"location":"quick-start/#1-buscar-series","text":"Para usar la API, ten\u00e9s que buscar los ids de las series que te interesan.","title":"1. Buscar series"},{"location":"quick-start/#en-un-archivo","text":"En datos.gob.ar pod\u00e9s encontrar la base completa de series de tiempo , que contiene la lista de series disponibles en: CSV XLSX DTA","title":"En un archivo"},{"location":"quick-start/#en-el-explorador-de-series","text":"En el Explorador de Series de Tiempo pod\u00e9s buscar series, visualizarlas y compartir las URLs a la API o al explorador.","title":"En el explorador de series"},{"location":"quick-start/#2-armar-consulta","text":"","title":"2. Armar consulta"},{"location":"quick-start/#manualmente","text":"Los ids de las series deben pasarse al par\u00e1metro ids . Se pueden usar par\u00e1metros adicionales para filtrar y transformar las series . Ver la referencia API para consultar la documentaci\u00f3n completa de todos los par\u00e1metros disponibles.","title":"Manualmente"},{"location":"quick-start/#en-el-generador-de-consultas","text":"En el generador de consultas pod\u00e9s ver todos los par\u00e1metros disponibles en la API para armar tu consulta.","title":"En el generador de consultas"},{"location":"quick-start/#3-realizar-consulta","text":"","title":"3. Realizar consulta"},{"location":"quick-start/#consultar-o-integrar-json","text":"Para realizar la consulta directamente en el navegador, o integrarla en una aplicaci\u00f3n: Usar format=json (valor default). Elegir el nivel de detalle de los metadatos metadata=none , only , simple o full . https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26,103.1_I2N_2016_M_15&format=json&metadata=full","title":"Consultar o integrar JSON"},{"location":"quick-start/#descargar-csv","text":"Para descargar un archivo CSV: Usar format=csv . https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26,103.1_I2N_2016_M_15&format=csv","title":"Descargar CSV"},{"location":"quick-start/#integrar-en-planilla-de-calculo","text":"Tanto la consulta en CSV como en JSON se pueden integrar en planillas de c\u00e1lculo .","title":"Integrar en planilla de c\u00e1lculo"},{"location":"quick-start/#consultar-en-el-explorador-de-series","text":"Cualquier llamada a la API se puede visualizar en el explorador quitando el subdominio apis de la URL (y cambiando a HTTP): Llamada a la API https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26:percent_change_a_year_ago&collapse=month Consulta en el explorador http://datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26:percent_change_a_year_ago&collapse=month","title":"Consultar en el explorador de series"},{"location":"spreadsheet-integration/","text":"Integraci\u00f3n con planillas de c\u00e1lculo Google Drive 1. Modificar la configuraci\u00f3n regional o usar el par\u00e1metro \"decimal=,\" Usar el par\u00e1metro decimal Modificar la configuraci\u00f3n regional 2. Importar los datos a la planilla 3. Elegir el formato de fecha 4. Modificar la URL de consulta a la API Excel 0. Chequear que ten\u00e9s instalado lo que necesit\u00e1s 1. Generar una nueva consulta desde una URL 2. Editar codificaci\u00f3n del archivo origen 3. Editar los tipos de las columnas 4. Guardar las modificaciones y cargar la consulta Google Drive 1. Modificar la configuraci\u00f3n regional o usar el par\u00e1metro \"decimal=,\" Usar el par\u00e1metro decimal La API genera archivos CSV usando \".\" como separador decimal por defecto. Si tu cuenta de Google est\u00e1 configurada para Argentina / latinoam\u00e9rica, pod\u00e9s agregar a todas tus llamadas a la API el argumento &decimal=, para que los CSVs se generen con \",\" como separador decimal. https://apis.datos.gob.ar/series/api/series/?limit=1000&metadata=full&start=0&ids=143.3_NO_PR_2004_A_21&format=csv&decimal=, Ver uso del par\u00e1metro decimal en la referencia. Modificar la configuraci\u00f3n regional Para que Google Spreadsheet lea correctamente el archivo CSV por defecto, puede elegirse \u201cEstados Unidos\u201d o cualquier otra regi\u00f3n compatible como configuraci\u00f3n regional. 2. Importar los datos a la planilla La funci\u00f3n IMPORTDATA() toma la URL de la consulta a la API y trae los datos a la planilla. 3. Elegir el formato de fecha El \u00edndice de tiempo puede verse como un n\u00famero la primera vez que se importan los datos. Lo m\u00e1s conveniente es seleccionar toda la columna y elegir el formato en el que se desea visualizar la fecha. 4. Modificar la URL de consulta a la API Una vez importada la tabla por primera vez, se pueden modificar los distintos par\u00e1metros de la consulta seg\u00fan lo que se necesite. La tabla se actualizar\u00e1 con cada cambio. Excel 0. Chequear que ten\u00e9s instalado lo que necesit\u00e1s Excel 2016 : tiene todo lo necesario para integrar una URL a un CSV. Excel 2013 : necesita descargar e instalar Microsoft Power Query . Excel 2010 : necesita descargar e instalar el Service Pack 1 y luego descargar e instalar Microsoft Power Query . 1. Generar una nueva consulta desde una URL \u201cDatos\u201d > \u201cNueva consulta\u201d > \u201cDesde otras fuentes\u201d > \u201cDesde una web\u201d Nota: si Excel est\u00e1 configurado para Argentina / latinoam\u00e9rica agregar a la URL de la API &decimal=, para que los n\u00fameros decimales usen \",\" en lugar de \".\" y Excel los lea correctamente. Ver uso del par\u00e1metro decimal en la referencia. https://apis.datos.gob.ar/series/api/series/?limit=1000&metadata=full&start=0&ids=143.3_NO_PR_2004_A_21&format=csv&decimal=, 2. Editar codificaci\u00f3n del archivo origen Esto s\u00f3lo es necesario si se pide a la API usar las descripciones como nombres de las columnas ( &header=descriptions ) en lugar del texto corto que viene por defecto, formado con carateres compatibles con cualquier codificaci\u00f3n. La API genera los archivos CSV con codificaci\u00f3n \u201cUnicode UTF-8\u201d, que no es el valor por defecto de Excel y puede generar errores en los caracteres con tildes o la \"\u00f1\". Click en la rueda de \u201cOrigen\u201d > \u201cOrigen de archivo\u201d > Elegir \u201cUnicode UTF-8\u201d 3. Editar los tipos de las columnas Excel puede no interpretar correctamente las fechas cuando Excel est\u00e1 configurado para Argentina / latinoam\u00e9rica. Si este es el caso, se debe utilizar el \u201cEditor avanzado\u201d para corregir el tipo de la columna \"indice_tiempo\" que debe ser \u201ctype date\u201d. 4. Guardar las modificaciones y cargar la consulta Por \u00faltimo, haciendo click en \u201cCerrar y cargar\u201d la consulta queda configurada en una tabla de Excel que se puede actualizar.","title":"Integrar la API en planillas de c\u00e1lculo"},{"location":"spreadsheet-integration/#integracion-con-planillas-de-calculo","text":"Google Drive 1. Modificar la configuraci\u00f3n regional o usar el par\u00e1metro \"decimal=,\" Usar el par\u00e1metro decimal Modificar la configuraci\u00f3n regional 2. Importar los datos a la planilla 3. Elegir el formato de fecha 4. Modificar la URL de consulta a la API Excel 0. Chequear que ten\u00e9s instalado lo que necesit\u00e1s 1. Generar una nueva consulta desde una URL 2. Editar codificaci\u00f3n del archivo origen 3. Editar los tipos de las columnas 4. Guardar las modificaciones y cargar la consulta","title":"Integraci\u00f3n con planillas de c\u00e1lculo"},{"location":"spreadsheet-integration/#google-drive","text":"","title":"Google Drive"},{"location":"spreadsheet-integration/#1-modificar-la-configuracion-regional-o-usar-el-parametro-decimal","text":"","title":"1. Modificar la configuraci\u00f3n regional o usar el par\u00e1metro \"decimal=,\""},{"location":"spreadsheet-integration/#usar-el-parametro-decimal","text":"La API genera archivos CSV usando \".\" como separador decimal por defecto. Si tu cuenta de Google est\u00e1 configurada para Argentina / latinoam\u00e9rica, pod\u00e9s agregar a todas tus llamadas a la API el argumento &decimal=, para que los CSVs se generen con \",\" como separador decimal. https://apis.datos.gob.ar/series/api/series/?limit=1000&metadata=full&start=0&ids=143.3_NO_PR_2004_A_21&format=csv&decimal=, Ver uso del par\u00e1metro decimal en la referencia.","title":"Usar el par\u00e1metro decimal"},{"location":"spreadsheet-integration/#modificar-la-configuracion-regional","text":"Para que Google Spreadsheet lea correctamente el archivo CSV por defecto, puede elegirse \u201cEstados Unidos\u201d o cualquier otra regi\u00f3n compatible como configuraci\u00f3n regional.","title":"Modificar la configuraci\u00f3n regional"},{"location":"spreadsheet-integration/#2-importar-los-datos-a-la-planilla","text":"La funci\u00f3n IMPORTDATA() toma la URL de la consulta a la API y trae los datos a la planilla.","title":"2. Importar los datos a la planilla"},{"location":"spreadsheet-integration/#3-elegir-el-formato-de-fecha","text":"El \u00edndice de tiempo puede verse como un n\u00famero la primera vez que se importan los datos. Lo m\u00e1s conveniente es seleccionar toda la columna y elegir el formato en el que se desea visualizar la fecha.","title":"3. Elegir el formato de fecha"},{"location":"spreadsheet-integration/#4-modificar-la-url-de-consulta-a-la-api","text":"Una vez importada la tabla por primera vez, se pueden modificar los distintos par\u00e1metros de la consulta seg\u00fan lo que se necesite. La tabla se actualizar\u00e1 con cada cambio.","title":"4. Modificar la URL de consulta a la API"},{"location":"spreadsheet-integration/#excel","text":"","title":"Excel"},{"location":"spreadsheet-integration/#0-chequear-que-tenes-instalado-lo-que-necesitas","text":"Excel 2016 : tiene todo lo necesario para integrar una URL a un CSV. Excel 2013 : necesita descargar e instalar Microsoft Power Query . Excel 2010 : necesita descargar e instalar el Service Pack 1 y luego descargar e instalar Microsoft Power Query .","title":"0. Chequear que ten\u00e9s instalado lo que necesit\u00e1s"},{"location":"spreadsheet-integration/#1-generar-una-nueva-consulta-desde-una-url","text":"\u201cDatos\u201d > \u201cNueva consulta\u201d > \u201cDesde otras fuentes\u201d > \u201cDesde una web\u201d Nota: si Excel est\u00e1 configurado para Argentina / latinoam\u00e9rica agregar a la URL de la API &decimal=, para que los n\u00fameros decimales usen \",\" en lugar de \".\" y Excel los lea correctamente. Ver uso del par\u00e1metro decimal en la referencia. https://apis.datos.gob.ar/series/api/series/?limit=1000&metadata=full&start=0&ids=143.3_NO_PR_2004_A_21&format=csv&decimal=,","title":"1. Generar una nueva consulta desde una URL"},{"location":"spreadsheet-integration/#2-editar-codificacion-del-archivo-origen","text":"Esto s\u00f3lo es necesario si se pide a la API usar las descripciones como nombres de las columnas ( &header=descriptions ) en lugar del texto corto que viene por defecto, formado con carateres compatibles con cualquier codificaci\u00f3n. La API genera los archivos CSV con codificaci\u00f3n \u201cUnicode UTF-8\u201d, que no es el valor por defecto de Excel y puede generar errores en los caracteres con tildes o la \"\u00f1\". Click en la rueda de \u201cOrigen\u201d > \u201cOrigen de archivo\u201d > Elegir \u201cUnicode UTF-8\u201d","title":"2. Editar codificaci\u00f3n del archivo origen"},{"location":"spreadsheet-integration/#3-editar-los-tipos-de-las-columnas","text":"Excel puede no interpretar correctamente las fechas cuando Excel est\u00e1 configurado para Argentina / latinoam\u00e9rica. Si este es el caso, se debe utilizar el \u201cEditor avanzado\u201d para corregir el tipo de la columna \"indice_tiempo\" que debe ser \u201ctype date\u201d.","title":"3. Editar los tipos de las columnas"},{"location":"spreadsheet-integration/#4-guardar-las-modificaciones-y-cargar-la-consulta","text":"Por \u00faltimo, haciendo click en \u201cCerrar y cargar\u201d la consulta queda configurada en una tabla de Excel que se puede actualizar.","title":"4. Guardar las modificaciones y cargar la consulta"},{"location":"terms/","text":"Condiciones de uso Legales Los datos de la API de Series de Tiempo bajo las licencias aplicadas por sus publicadores, que pueden ser consultadas en la tabla de metadatos de las series o en el objeto meta devuelto en una consulta a la API con par\u00e1metro metadata=full . https://apis.datos.gob.ar/series/api/series/?ids=103.1_I2N_2016_M_15&metadata=full { \"catalog\" : { \"publisher\" : { \"mbox\" : \"datoseconomicos@mecon.gov.ar\" , \"name\" : \"Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" }, \"license\" : \"Creative Commons Attribution 4.0\" , \"description\" : \"Cat\u00e1logo de datos abiertos de la Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" , \"language\" : Array [ 1 ][ \"SPA\" ], \"superThemeTaxonomy\" : \"http://datos.gob.ar/superThemeTaxonomy.json\" , \"issued\" : \"2017-09-28\" , \"rights\" : \"2017-09-28\" , \"modified\" : \"2017-09-28\" , \"spatial\" : \"ARG\" , \"title\" : \"Datos Programaci\u00f3n Macroecon\u00f3mica\" , \"identifier\" : \"sspm\" }, \"dataset\" : { \"publisher\" : { \"mbox\" : \"datoseconomicos@mecon.gov.ar\" , \"name\" : \"Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" }, \"landingPage\" : \"https://www.minhacienda.gob.ar/secretarias/politica-economica/programacion-macroeconomica/\" , \"keyword\" : Array [ 2 ][ \"Informaci\u00f3n Econ\u00f3mica al D\u00eda\" , \"Precios\" ], \"superTheme\" : Array [ 1 ][ \"ECON\" ], \"title\" : \"\u00cdndice de Precios al Consumidor. Por categor\u00edas. Base diciembre 2016.\" , \"language\" : Array [ 1 ][ \"SPA\" ], \"issued\" : \"2017-09-28\" , \"temporal\" : \"2016-04-01/2017-06-01\" , \"source\" : \"Instituto Nacional de Estad\u00edstica y Censos (INDEC)\" , \"theme\" : Array [ 1 ][ { \"label\" : \"Precios\" , \"id\" : \"precios\" , \"description\" : \"Series de precios\" } ], \"accrualPeriodicity\" : \"R/P1M\" , \"spatial\" : \"ARG\" , \"identifier\" : \"103\" , \"license\" : \"Creative Commons Attribution 4.0\" , \"contactPoint\" : { \"fn\" : \"Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" }, \"accessLevel\" : \"ABIERTO\" , \"description\" : \"\u00cdndice de Precios al Consumidor. Apertura por categor\u00edas. Base diciembre 2016.\" }, \"distribution\" : { \"accessURL\" : \"https://www.minhacienda.gob.ar/secretarias/politica-economica/programacion-macroeconomica/\" , \"description\" : \"\u00cdndice de Precios al Consumidor. Categor\u00edas. Valores mensuales. (Base diciembre 2016).\" , \"format\" : \"CSV\" , \"dataset_identifier\" : \"103\" , \"issued\" : \"2017-09-28\" , \"title\" : \"\u00cdndice de Precios al Consumidor, por categor\u00edas. Base diciembre 2016. Valores mensuales\" , \"fileName\" : \"indice-precios-al-consumidor-categorias-base-diciembre-2016-mensual.csv\" , \"downloadURL\" : \"http://infra.datos.gob.ar/catalog/sspm/dataset/103/distribution/103.1/download/indice-precios-al-consumidor-categorias-base-diciembre-2016-mensual.csv\" , \"identifier\" : \"103.1\" , \"scrapingFileURL\" : \"https://www.economia.gob.ar/download/infoeco/apendice4.xlsx\" , \"frequency\" : \"R/P1M\" , \"last_hash\" : \"355c9dd579208476c6520e8cb05c350dbfcb6b5d5b5743f30db0f8222a0cd6db38048b73ea465102c6c5d2dfa66970eb6857f4ed63cafaaf07fbde193e82979e\" , \"changed\" : \"False\" }, \"field\" : { \"distribution_identifier\" : \"103.1\" , \"description\" : \"IPC N\u00facleo. Base abr 2016. Mensual\" , \"title\" : \"ipc_2016_nucleo\" , \"dataset_identifier\" : \"103\" , \"specialTypeDetail\" : \"\" , \"units\" : \"\u00cdndice Dic-2016=100\" , \"type\" : \"number\" , \"id\" : \"103.1_I2N_2016_M_15\" , \"available\" : \"true\" , \"last_value\" : \"149.8703\" , \"second_to_last_value\" : \"145.2069\" , \"last_pct_change\" : \"0.03211555373746\" , \"time_index_end\" : \"2018-08-01\" , \"frequency\" : \"R/P1M\" , \"time_index_size\" : \"29\" , \"days_without_data\" : \"14\" , \"time_index_start\" : \"2016-04-01\" } } ] T\u00e9cnicas La API de series de tiempo se encuentra en estado beta de desarrollo y las cuotas de uso pueden cambiar significativamente en el futuro, dependiendo de la evoluci\u00f3n del desarrollo y uso del servicio. Actualmente se aplican las siguientes cuotas de uso por IP: Por segundo: 30 consultas Por minuto: 1000 consultas Por hora: 10000 consultas Por d\u00eda: 50000 consultas","title":"Condiciones de uso"},{"location":"terms/#condiciones-de-uso","text":"","title":"Condiciones de uso"},{"location":"terms/#legales","text":"Los datos de la API de Series de Tiempo bajo las licencias aplicadas por sus publicadores, que pueden ser consultadas en la tabla de metadatos de las series o en el objeto meta devuelto en una consulta a la API con par\u00e1metro metadata=full . https://apis.datos.gob.ar/series/api/series/?ids=103.1_I2N_2016_M_15&metadata=full { \"catalog\" : { \"publisher\" : { \"mbox\" : \"datoseconomicos@mecon.gov.ar\" , \"name\" : \"Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" }, \"license\" : \"Creative Commons Attribution 4.0\" , \"description\" : \"Cat\u00e1logo de datos abiertos de la Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" , \"language\" : Array [ 1 ][ \"SPA\" ], \"superThemeTaxonomy\" : \"http://datos.gob.ar/superThemeTaxonomy.json\" , \"issued\" : \"2017-09-28\" , \"rights\" : \"2017-09-28\" , \"modified\" : \"2017-09-28\" , \"spatial\" : \"ARG\" , \"title\" : \"Datos Programaci\u00f3n Macroecon\u00f3mica\" , \"identifier\" : \"sspm\" }, \"dataset\" : { \"publisher\" : { \"mbox\" : \"datoseconomicos@mecon.gov.ar\" , \"name\" : \"Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" }, \"landingPage\" : \"https://www.minhacienda.gob.ar/secretarias/politica-economica/programacion-macroeconomica/\" , \"keyword\" : Array [ 2 ][ \"Informaci\u00f3n Econ\u00f3mica al D\u00eda\" , \"Precios\" ], \"superTheme\" : Array [ 1 ][ \"ECON\" ], \"title\" : \"\u00cdndice de Precios al Consumidor. Por categor\u00edas. Base diciembre 2016.\" , \"language\" : Array [ 1 ][ \"SPA\" ], \"issued\" : \"2017-09-28\" , \"temporal\" : \"2016-04-01/2017-06-01\" , \"source\" : \"Instituto Nacional de Estad\u00edstica y Censos (INDEC)\" , \"theme\" : Array [ 1 ][ { \"label\" : \"Precios\" , \"id\" : \"precios\" , \"description\" : \"Series de precios\" } ], \"accrualPeriodicity\" : \"R/P1M\" , \"spatial\" : \"ARG\" , \"identifier\" : \"103\" , \"license\" : \"Creative Commons Attribution 4.0\" , \"contactPoint\" : { \"fn\" : \"Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" }, \"accessLevel\" : \"ABIERTO\" , \"description\" : \"\u00cdndice de Precios al Consumidor. Apertura por categor\u00edas. Base diciembre 2016.\" }, \"distribution\" : { \"accessURL\" : \"https://www.minhacienda.gob.ar/secretarias/politica-economica/programacion-macroeconomica/\" , \"description\" : \"\u00cdndice de Precios al Consumidor. Categor\u00edas. Valores mensuales. (Base diciembre 2016).\" , \"format\" : \"CSV\" , \"dataset_identifier\" : \"103\" , \"issued\" : \"2017-09-28\" , \"title\" : \"\u00cdndice de Precios al Consumidor, por categor\u00edas. Base diciembre 2016. Valores mensuales\" , \"fileName\" : \"indice-precios-al-consumidor-categorias-base-diciembre-2016-mensual.csv\" , \"downloadURL\" : \"http://infra.datos.gob.ar/catalog/sspm/dataset/103/distribution/103.1/download/indice-precios-al-consumidor-categorias-base-diciembre-2016-mensual.csv\" , \"identifier\" : \"103.1\" , \"scrapingFileURL\" : \"https://www.economia.gob.ar/download/infoeco/apendice4.xlsx\" , \"frequency\" : \"R/P1M\" , \"last_hash\" : \"355c9dd579208476c6520e8cb05c350dbfcb6b5d5b5743f30db0f8222a0cd6db38048b73ea465102c6c5d2dfa66970eb6857f4ed63cafaaf07fbde193e82979e\" , \"changed\" : \"False\" }, \"field\" : { \"distribution_identifier\" : \"103.1\" , \"description\" : \"IPC N\u00facleo. Base abr 2016. Mensual\" , \"title\" : \"ipc_2016_nucleo\" , \"dataset_identifier\" : \"103\" , \"specialTypeDetail\" : \"\" , \"units\" : \"\u00cdndice Dic-2016=100\" , \"type\" : \"number\" , \"id\" : \"103.1_I2N_2016_M_15\" , \"available\" : \"true\" , \"last_value\" : \"149.8703\" , \"second_to_last_value\" : \"145.2069\" , \"last_pct_change\" : \"0.03211555373746\" , \"time_index_end\" : \"2018-08-01\" , \"frequency\" : \"R/P1M\" , \"time_index_size\" : \"29\" , \"days_without_data\" : \"14\" , \"time_index_start\" : \"2016-04-01\" } } ]","title":"Legales"},{"location":"terms/#tecnicas","text":"La API de series de tiempo se encuentra en estado beta de desarrollo y las cuotas de uso pueden cambiar significativamente en el futuro, dependiendo de la evoluci\u00f3n del desarrollo y uso del servicio. Actualmente se aplican las siguientes cuotas de uso por IP: Por segundo: 30 consultas Por minuto: 1000 consultas Por hora: 10000 consultas Por d\u00eda: 50000 consultas","title":"T\u00e9cnicas"},{"location":"developers/admin/","text":"Documentaci\u00f3n de administraci\u00f3n de la API El proyecto se desdobla en varias aplicaciones, todas ellas con configuraciones particulares, accesibles desde el panel de administraci\u00f3n /admin (\"el admin\"). Tareas en segundo plano La API cuenta con varias tareas que se corren en segundo plano: la lectura de datos de series de tiempo, la indexaci\u00f3n de dichos datos al \u00edndice de Elasticsearch, la generaci\u00f3n de dumps de la base entera, entre otras. Todas las tareas se pueden correr manualmente creando nuevos modelos de tipo \"Corrida\" desde el admin, por ejemplo, Corridas de importaci\u00f3n de analytics , Corridas de indexaci\u00f3n de datos . Dentro de los modelos se encuentran los logs de cada corrida. Programaci\u00f3n de tareas Las tareas se pueden programar como una cola a correrse de manera autom\u00e1tica a trav\u00e9s de los modelos Synchronizer de django_datajsonar . Consultar su documentaci\u00f3n para m\u00e1s informaci\u00f3n. A continuaci\u00f3n se deja un ejemplo de una secuencia de tareas. Read Datajson (corrida completa) Indexaci\u00f3n de datos (s\u00f3lo actualizados) Test de integraci\u00f3n Reporte de indexaci\u00f3n Indexaci\u00f3n de metadatos Generaci\u00f3n de dumps CSV Generaci\u00f3n de dumps XLSX Generaci\u00f3n de dumps SQL Generaci\u00f3n de dumps DTA Esta programaci\u00f3n de tareas se puede realizar creando o editando desde el admin los modelos Synchronizer . Adicionalmente, se pueden programar corridas individuales utilizando el bot\u00f3n Schedule Task en las vistas individuales de los modelos de tipo \"Corrida\" mencionados anteriormente, pero es fuertemente recomendado utilizar Synchronizers por su funcionalidad m\u00e1s extensiva. Analytics Existe un m\u00f3dulo de la aplicaci\u00f3n que se dedica a importar datos de uso de la aplicaci\u00f3n desde una instanacia de api-gateway . Se puede configurar a trav\u00e9s de la vista \"Configuraci\u00f3n de importaci\u00f3n de analytics\" en el admin, a llenar con los campos relevantes de la instancia de API Gateway que querramos consultar, incluyendo ID de la API de series de tiempo en ese proyecto, y una api key. El campo Last Cursor es de uso interno y no deber\u00eda ser modificado . Test de integraci\u00f3n Existe un m\u00f3dulo que, idealmente justo despu\u00e9s de una indexaci\u00f3n de datos, se encargue de testear la consistencia de los datos cargados en el \u00edndice de Elasticsearch con los datos originales. Para la generaci\u00f3n del reporte en casos de errores, se pueden configurar usuarios destinatarios del email de error. en la vista \"Configuraci\u00f3n del test de integraci\u00f3n\", as\u00ed como el endpoint de la misma API a utilizar en los repotes (la API no conoce su propio host name, y por lo tanto debe ser configurado manualmente). Metadatos Otra tarea programada es la indexaci\u00f3n de metadatos de las series disponibles, para ser consultadas en el endpoint /search . La tarea debe ser corrida siempre despu\u00e9s de la indexaci\u00f3n de datos, para asegurar que ambos \u00edndices contengan datos consistentes entre ellos. Dentro de la vista \"Configuraci\u00f3n de b\u00fasqueda de series por metadatos\", se pueden configurar par\u00e1metros de boosting sobre ciertos campos de metadatos, para ir ajustando los resultados de b\u00fasqueda. El formato JSON de los par\u00e1metros debe ser siempre respetado. A continuaci\u00f3n se muestra el valor por defecto: {\"description\": {\"boost\": 1.5}, \"dataset_title\": {\"boost\": 1}, \"dataset_source\": {\"boost\": 1}, \"dataset_description\": {\"boost\": 1}} As\u00ed, el campo description de las series tiene cierta relevancia adicional sobre los dem\u00e1s (1.5 vs 1). Si se modifica el boost de alg\u00fan campo, no es necesario reindexar los datos para que el cambio tome efecto, se aplica en tiempo de b\u00fasqueda y no de indexaci\u00f3n. Dumps Existen cuatro tareas relacionadas a la generaci\u00f3n de dumps de la base entera de series de tiempo. Son una tarea por cada formato disponible: CSV, XLSX, SQL, DTA. Cada tarea genera dumps globales , de la base entera, y tambi\u00e9n individuales por cada nodo. Existe una fuerte dependencia entre estas tareas: los dumps en CSV se generan a partir de lecturas a la base de datos para leer metadatos, y al file storage para leer los datos de cada serie. Los dem\u00e1s formatos se generan a partir del dump CSV. Por lo tanto el dump en CSV debe ser programado 3 horas antes que los dem\u00e1s. Los dumps CSV y XLSX generan 4 distribuciones por cat\u00e1logo , Los dumps en SQLite un archivo \u00fanico por cat\u00e1logo con varias tablas, y los dumps en DTA 3 archivos, todos disponibles en un endpoint accesible al p\u00fablico. Los dumps generados tendr\u00e1n los datos de todas las series disponibles por la API, es decir las series cuyos datos fueron indexados exitosamente. Unidades porcentuales y no porcentuales Una vez cargadas e indexadas las series, en la vista de Unidades de series en el admin se pueden indicar cuales de las unidades se deber\u00edan interpretar como porcentuales. Por defecto todas las unidades existentes son tratadas como valores absolutos. Cuando una unidad se marque como porcentual, en la respuesta de metadatos de las series, el campo \u00ecs_percentage pasar\u00e1 a valer true en todos los casos de consulta de series que est\u00e9n representadas bajo esa unidad. El prop\u00f3sito de esta funcionalidad es para indicarle a los usuarios de manera m\u00e1s sencilla si los valores de una serie deber\u00edan ser tratados como porcentajes o no.","title":"Administraci\u00f3n"},{"location":"developers/admin/#documentacion-de-administracion-de-la-api","text":"El proyecto se desdobla en varias aplicaciones, todas ellas con configuraciones particulares, accesibles desde el panel de administraci\u00f3n /admin (\"el admin\").","title":"Documentaci\u00f3n de administraci\u00f3n de la API"},{"location":"developers/admin/#tareas-en-segundo-plano","text":"La API cuenta con varias tareas que se corren en segundo plano: la lectura de datos de series de tiempo, la indexaci\u00f3n de dichos datos al \u00edndice de Elasticsearch, la generaci\u00f3n de dumps de la base entera, entre otras. Todas las tareas se pueden correr manualmente creando nuevos modelos de tipo \"Corrida\" desde el admin, por ejemplo, Corridas de importaci\u00f3n de analytics , Corridas de indexaci\u00f3n de datos . Dentro de los modelos se encuentran los logs de cada corrida.","title":"Tareas en segundo plano"},{"location":"developers/admin/#programacion-de-tareas","text":"Las tareas se pueden programar como una cola a correrse de manera autom\u00e1tica a trav\u00e9s de los modelos Synchronizer de django_datajsonar . Consultar su documentaci\u00f3n para m\u00e1s informaci\u00f3n. A continuaci\u00f3n se deja un ejemplo de una secuencia de tareas. Read Datajson (corrida completa) Indexaci\u00f3n de datos (s\u00f3lo actualizados) Test de integraci\u00f3n Reporte de indexaci\u00f3n Indexaci\u00f3n de metadatos Generaci\u00f3n de dumps CSV Generaci\u00f3n de dumps XLSX Generaci\u00f3n de dumps SQL Generaci\u00f3n de dumps DTA Esta programaci\u00f3n de tareas se puede realizar creando o editando desde el admin los modelos Synchronizer . Adicionalmente, se pueden programar corridas individuales utilizando el bot\u00f3n Schedule Task en las vistas individuales de los modelos de tipo \"Corrida\" mencionados anteriormente, pero es fuertemente recomendado utilizar Synchronizers por su funcionalidad m\u00e1s extensiva.","title":"Programaci\u00f3n de tareas"},{"location":"developers/admin/#analytics","text":"Existe un m\u00f3dulo de la aplicaci\u00f3n que se dedica a importar datos de uso de la aplicaci\u00f3n desde una instanacia de api-gateway . Se puede configurar a trav\u00e9s de la vista \"Configuraci\u00f3n de importaci\u00f3n de analytics\" en el admin, a llenar con los campos relevantes de la instancia de API Gateway que querramos consultar, incluyendo ID de la API de series de tiempo en ese proyecto, y una api key. El campo Last Cursor es de uso interno y no deber\u00eda ser modificado .","title":"Analytics"},{"location":"developers/admin/#test-de-integracion","text":"Existe un m\u00f3dulo que, idealmente justo despu\u00e9s de una indexaci\u00f3n de datos, se encargue de testear la consistencia de los datos cargados en el \u00edndice de Elasticsearch con los datos originales. Para la generaci\u00f3n del reporte en casos de errores, se pueden configurar usuarios destinatarios del email de error. en la vista \"Configuraci\u00f3n del test de integraci\u00f3n\", as\u00ed como el endpoint de la misma API a utilizar en los repotes (la API no conoce su propio host name, y por lo tanto debe ser configurado manualmente).","title":"Test de integraci\u00f3n"},{"location":"developers/admin/#metadatos","text":"Otra tarea programada es la indexaci\u00f3n de metadatos de las series disponibles, para ser consultadas en el endpoint /search . La tarea debe ser corrida siempre despu\u00e9s de la indexaci\u00f3n de datos, para asegurar que ambos \u00edndices contengan datos consistentes entre ellos. Dentro de la vista \"Configuraci\u00f3n de b\u00fasqueda de series por metadatos\", se pueden configurar par\u00e1metros de boosting sobre ciertos campos de metadatos, para ir ajustando los resultados de b\u00fasqueda. El formato JSON de los par\u00e1metros debe ser siempre respetado. A continuaci\u00f3n se muestra el valor por defecto: {\"description\": {\"boost\": 1.5}, \"dataset_title\": {\"boost\": 1}, \"dataset_source\": {\"boost\": 1}, \"dataset_description\": {\"boost\": 1}} As\u00ed, el campo description de las series tiene cierta relevancia adicional sobre los dem\u00e1s (1.5 vs 1). Si se modifica el boost de alg\u00fan campo, no es necesario reindexar los datos para que el cambio tome efecto, se aplica en tiempo de b\u00fasqueda y no de indexaci\u00f3n.","title":"Metadatos"},{"location":"developers/admin/#dumps","text":"Existen cuatro tareas relacionadas a la generaci\u00f3n de dumps de la base entera de series de tiempo. Son una tarea por cada formato disponible: CSV, XLSX, SQL, DTA. Cada tarea genera dumps globales , de la base entera, y tambi\u00e9n individuales por cada nodo. Existe una fuerte dependencia entre estas tareas: los dumps en CSV se generan a partir de lecturas a la base de datos para leer metadatos, y al file storage para leer los datos de cada serie. Los dem\u00e1s formatos se generan a partir del dump CSV. Por lo tanto el dump en CSV debe ser programado 3 horas antes que los dem\u00e1s. Los dumps CSV y XLSX generan 4 distribuciones por cat\u00e1logo , Los dumps en SQLite un archivo \u00fanico por cat\u00e1logo con varias tablas, y los dumps en DTA 3 archivos, todos disponibles en un endpoint accesible al p\u00fablico. Los dumps generados tendr\u00e1n los datos de todas las series disponibles por la API, es decir las series cuyos datos fueron indexados exitosamente.","title":"Dumps"},{"location":"developers/admin/#unidades-porcentuales-y-no-porcentuales","text":"Una vez cargadas e indexadas las series, en la vista de Unidades de series en el admin se pueden indicar cuales de las unidades se deber\u00edan interpretar como porcentuales. Por defecto todas las unidades existentes son tratadas como valores absolutos. Cuando una unidad se marque como porcentual, en la respuesta de metadatos de las series, el campo \u00ecs_percentage pasar\u00e1 a valer true en todos los casos de consulta de series que est\u00e9n representadas bajo esa unidad. El prop\u00f3sito de esta funcionalidad es para indicarle a los usuarios de manera m\u00e1s sencilla si los valores de una serie deber\u00edan ser tratados como porcentajes o no.","title":"Unidades porcentuales y no porcentuales"},{"location":"developers/arquitectura/","text":"Arquitectura de la API de series de tiempo Introducci\u00f3n La API de Series de Tiempo del Paquete de Apertura de Datos de la Rep\u00fablica Argentina est\u00e1 basada en una aplicaci\u00f3n web Django que corre bajo Python2.7 que funciona como puerta de entrada a los datos que la misma aloja y procesa. Los datos mencionados previamente son calculados en base a recursos alojados en distintas ubicaciones dentro de la World Wide Web , que son obtenidos por procesos asicr\u00f3nicos basados en RQ orquestados utilizando supervisor y Redis.io . El almacenamiento de los datos se realiza en un cluster de Elastic y la API utiliza distintas estrategias para acceder a los mismos, realizando transformaciones precalculadas o en memoria. Componentes de la arquitectura Servidor Web El servidor web contiene la aplicaci\u00f3n Django que conforma el punto de entrada a la API de Series de Tiempo. La aplicaci\u00f3n Django es ejecutada utilizando supervisor y publicada a la web usando el servidor web Nginx . \u00c9sta publica un conjunto de endpoints sencillos que permiten acceder a los datos y a los metadatos de la informaci\u00f3n que contiene, permitiendo configurar filtros y expresiones de transformaci\u00f3n predefinidas (ver documentaci\u00f3n de la API de Series de Tiempo ). Se trata de una aplicaci\u00f3n Django 1.11 (por dependencias transitivas, la API no es compatible con Python3) cuyo panel de administraci\u00f3n se utiliza exhaustivamente para configurar el funcionamiento de la misma. Cluster de Workers Los workers est\u00e1n conformados por aplicaciones Python que ejecutan el mismo contexto y baseline de c\u00f3digo que la aplicaci\u00f3n web. Estos procesos Python realizan distintas tareas asincr\u00f3nicas de administraci\u00f3n que permiten el correcto funcionamiento de la API de Serie de Tiempo, como por ejemplo: Procesamiento de archivos de configuraci\u00f3n. Descarga y validaci\u00f3n de los data.json de la red de nodos. Descarga y validaci\u00f3n de los recursos pertenecientes a los datasets seleccionados para indexar. Indexaci\u00f3n de datos, incluyendo el prec\u00e1lculo de algunos indicadores. Indexaci\u00f3n de metadatos de los datos. Generaci\u00f3n de reportes. Sincronizaci\u00f3n de datos con servicios externos. Las colas de tareas y los workers est\u00e1n basados en Python-RQ, y las tareas se persisten en un servidor de base de datos en memoria Redis.io. Servidor de bases de datos El servidor de bases de datos contiene dos servicios: PostgreSQL: Base de datos relacional que contiene el modelo de datos de la aplicaci\u00f3n web. Redis: Base de datos en memoria que es utilizado para guardar los datos y metadatos de las tareas asincr\u00f3nicas a ejecutar por los workers y tambi\u00e9n es utilizado como cach\u00e9 por la aplicaci\u00f3n web. Cluster Elastic El cluster Elastic contiene un n\u00famero de servidores con el servicio de Elastic search ejecut\u00e1ndose. El mismo est\u00e1 configurado para tener 3 shards y una r\u00e9plica.","title":"Arquitectura"},{"location":"developers/arquitectura/#arquitectura-de-la-api-de-series-de-tiempo","text":"","title":"Arquitectura de la API de series de tiempo"},{"location":"developers/arquitectura/#introduccion","text":"La API de Series de Tiempo del Paquete de Apertura de Datos de la Rep\u00fablica Argentina est\u00e1 basada en una aplicaci\u00f3n web Django que corre bajo Python2.7 que funciona como puerta de entrada a los datos que la misma aloja y procesa. Los datos mencionados previamente son calculados en base a recursos alojados en distintas ubicaciones dentro de la World Wide Web , que son obtenidos por procesos asicr\u00f3nicos basados en RQ orquestados utilizando supervisor y Redis.io . El almacenamiento de los datos se realiza en un cluster de Elastic y la API utiliza distintas estrategias para acceder a los mismos, realizando transformaciones precalculadas o en memoria.","title":"Introducci\u00f3n"},{"location":"developers/arquitectura/#componentes-de-la-arquitectura","text":"","title":"Componentes de la arquitectura"},{"location":"developers/arquitectura/#servidor-web","text":"El servidor web contiene la aplicaci\u00f3n Django que conforma el punto de entrada a la API de Series de Tiempo. La aplicaci\u00f3n Django es ejecutada utilizando supervisor y publicada a la web usando el servidor web Nginx . \u00c9sta publica un conjunto de endpoints sencillos que permiten acceder a los datos y a los metadatos de la informaci\u00f3n que contiene, permitiendo configurar filtros y expresiones de transformaci\u00f3n predefinidas (ver documentaci\u00f3n de la API de Series de Tiempo ). Se trata de una aplicaci\u00f3n Django 1.11 (por dependencias transitivas, la API no es compatible con Python3) cuyo panel de administraci\u00f3n se utiliza exhaustivamente para configurar el funcionamiento de la misma.","title":"Servidor Web"},{"location":"developers/arquitectura/#cluster-de-workers","text":"Los workers est\u00e1n conformados por aplicaciones Python que ejecutan el mismo contexto y baseline de c\u00f3digo que la aplicaci\u00f3n web. Estos procesos Python realizan distintas tareas asincr\u00f3nicas de administraci\u00f3n que permiten el correcto funcionamiento de la API de Serie de Tiempo, como por ejemplo: Procesamiento de archivos de configuraci\u00f3n. Descarga y validaci\u00f3n de los data.json de la red de nodos. Descarga y validaci\u00f3n de los recursos pertenecientes a los datasets seleccionados para indexar. Indexaci\u00f3n de datos, incluyendo el prec\u00e1lculo de algunos indicadores. Indexaci\u00f3n de metadatos de los datos. Generaci\u00f3n de reportes. Sincronizaci\u00f3n de datos con servicios externos. Las colas de tareas y los workers est\u00e1n basados en Python-RQ, y las tareas se persisten en un servidor de base de datos en memoria Redis.io.","title":"Cluster de Workers"},{"location":"developers/arquitectura/#servidor-de-bases-de-datos","text":"El servidor de bases de datos contiene dos servicios: PostgreSQL: Base de datos relacional que contiene el modelo de datos de la aplicaci\u00f3n web. Redis: Base de datos en memoria que es utilizado para guardar los datos y metadatos de las tareas asincr\u00f3nicas a ejecutar por los workers y tambi\u00e9n es utilizado como cach\u00e9 por la aplicaci\u00f3n web.","title":"Servidor de bases de datos"},{"location":"developers/arquitectura/#cluster-elastic","text":"El cluster Elastic contiene un n\u00famero de servidores con el servicio de Elastic search ejecut\u00e1ndose. El mismo est\u00e1 configurado para tener 3 shards y una r\u00e9plica.","title":"Cluster Elastic"},{"location":"developers/development/","text":"Development A continuaci\u00f3n se detallan los pasos a seguir para levantar una versi\u00f3n local de la aplicaci\u00f3n, apuntado a futuros desarrolladores de la misma. Este documento asume un entorno Linux para el desarrollo, y fue probado bajo Ubuntu 16.04. Requerimientos Python 2.7.6 Virtualenv Docker Docker compose Setup Virtualenv (con Pyenv) Es recomendable instalar las dependencias de la aplicaci\u00f3n en un entorno virtual para evitar conflictos con otras aplicaciones de versionado de las librer\u00edas usadas. Este ejemplo instala un entorno virtual de Python 2.7.6 con el nombre stiempo-api , y todas las dependencias de la aplicaci\u00f3n. pyenv virtualenv 2 .7.6 stiempo-api pyenv activate stiempo-api pip install -r requirements/local.txt Configuraci\u00f3n Algunas configuraciones locales (como variables de entorno, o la base de datos usada) pueden llegar a diferir de la versi\u00f3n productiva, y deben ser seteadas manualmente. Para ello se provee una configuraci\u00f3n de ejemplo , que puede ser usada como base. cp conf/settings/local_example.py conf/settings/local.py cp conf/settings/.env.default_local conf/settings/.env A su vez, se debe informar a Django cual es el m\u00f3dulo de configuraci\u00f3n a leer. Este m\u00f3dulo debe ser el mismo que fue copiado en el paso anterior ( conf/settings/local.py en el ejemplo). Esto se hace seteando la variable de entorno DJANGO_SETTINGS_MODULE , lo cual se puede hacer persistente entre sesiones de terminal escribi\u00e9ndolo en .bashrc (o similar, dependiendo de la terminal utilizada): export DJANGO_SETTINGS_MODULE = conf.settings.local Servicios Los servicios (PostgreSQL, Elasticsearch, Redis) pueden ser levantados usando Docker y Docker Compose: docker-compose pull docker-compose up -d Base de datos Correr las migraciones de las base de datos: python manage.py migrate Worker Levanta los workers para ejecutar tareas asincr\u00f3nicas. Notar que esta tarea bloquea la terminal. python manage.py rqworker high default low scrapping Web server Este comando levanta la aplicaci\u00f3n. python manage.py runserver Si est\u00e1 todo en orden se podr\u00e1 leer alg\u00fan mensaje como el siguiente: Django version 1 .11.6, using settings 'conf.settings.local' Starting development server at http://127.0.0.1:8000/ Quit the server with CONTROL-C. Tests Correr scripts/tests.sh desde el directorio ra\u00edz. Tambi\u00e9n se proveen scripts que chequean estilos ( scripts/pycodestyle.sh ) y p\u00fdlint ( scripts/pylint.sh )","title":"Instalaci\u00f3n"},{"location":"developers/development/#development","text":"A continuaci\u00f3n se detallan los pasos a seguir para levantar una versi\u00f3n local de la aplicaci\u00f3n, apuntado a futuros desarrolladores de la misma. Este documento asume un entorno Linux para el desarrollo, y fue probado bajo Ubuntu 16.04.","title":"Development"},{"location":"developers/development/#requerimientos","text":"Python 2.7.6 Virtualenv Docker Docker compose","title":"Requerimientos"},{"location":"developers/development/#setup","text":"","title":"Setup"},{"location":"developers/development/#virtualenv-con-pyenv","text":"Es recomendable instalar las dependencias de la aplicaci\u00f3n en un entorno virtual para evitar conflictos con otras aplicaciones de versionado de las librer\u00edas usadas. Este ejemplo instala un entorno virtual de Python 2.7.6 con el nombre stiempo-api , y todas las dependencias de la aplicaci\u00f3n. pyenv virtualenv 2 .7.6 stiempo-api pyenv activate stiempo-api pip install -r requirements/local.txt","title":"Virtualenv (con Pyenv)"},{"location":"developers/development/#configuracion","text":"Algunas configuraciones locales (como variables de entorno, o la base de datos usada) pueden llegar a diferir de la versi\u00f3n productiva, y deben ser seteadas manualmente. Para ello se provee una configuraci\u00f3n de ejemplo , que puede ser usada como base. cp conf/settings/local_example.py conf/settings/local.py cp conf/settings/.env.default_local conf/settings/.env A su vez, se debe informar a Django cual es el m\u00f3dulo de configuraci\u00f3n a leer. Este m\u00f3dulo debe ser el mismo que fue copiado en el paso anterior ( conf/settings/local.py en el ejemplo). Esto se hace seteando la variable de entorno DJANGO_SETTINGS_MODULE , lo cual se puede hacer persistente entre sesiones de terminal escribi\u00e9ndolo en .bashrc (o similar, dependiendo de la terminal utilizada): export DJANGO_SETTINGS_MODULE = conf.settings.local","title":"Configuraci\u00f3n"},{"location":"developers/development/#servicios","text":"Los servicios (PostgreSQL, Elasticsearch, Redis) pueden ser levantados usando Docker y Docker Compose: docker-compose pull docker-compose up -d","title":"Servicios"},{"location":"developers/development/#base-de-datos","text":"Correr las migraciones de las base de datos: python manage.py migrate","title":"Base de datos"},{"location":"developers/development/#worker","text":"Levanta los workers para ejecutar tareas asincr\u00f3nicas. Notar que esta tarea bloquea la terminal. python manage.py rqworker high default low scrapping","title":"Worker"},{"location":"developers/development/#web-server","text":"Este comando levanta la aplicaci\u00f3n. python manage.py runserver Si est\u00e1 todo en orden se podr\u00e1 leer alg\u00fan mensaje como el siguiente: Django version 1 .11.6, using settings 'conf.settings.local' Starting development server at http://127.0.0.1:8000/ Quit the server with CONTROL-C.","title":"Web server"},{"location":"developers/development/#tests","text":"Correr scripts/tests.sh desde el directorio ra\u00edz. Tambi\u00e9n se proveen scripts que chequean estilos ( scripts/pycodestyle.sh ) y p\u00fdlint ( scripts/pylint.sh )","title":"Tests"},{"location":"reference/api-reference/","text":"Referencia API: series Recurso: /series El recurso /series permite obtener datos y metadatos de una o m\u00e1s series, permitiendo hacer filtros por el \u00edndice de tiempo, cambios de granularidad en la dimensi\u00f3n temporal y cambios en la unidad de medida de los valores de la serie, entre otras operaciones. Tabla de par\u00e1metros ids representation_mode collapse collapse_aggregation limit start start_date end_date format header sort metadata decimal sep flatten last Tabla de par\u00e1metros Nombre Requerido Descripci\u00f3n Default Ejemplos ids Si Lista de caracteres alfanum\u00e9ricos separados por comas. Contiene la especificaci\u00f3n de las series a consultar, junto a transformaciones y operaciones. N/A ids=2.4_DGI_1993_T_19,134.2_B_0_0_6 representation_mode No Uno de: value, change, percent_change, percent_change_a_year_ago value representation_mode=percent_change collapse No Uno de: day, week, month, quarter, year La frecuencia propia de la serie collapse=year collapse=quarter collapse_aggregation No Uno de: avg, sum, end_of_period, min, max avg collapse_aggregation=sum limit No N\u00famero entero positivo, no mayor que 1000. 100 limit=50 start No N\u00famero entero positivo o 0. 0 start=100 start_date No Fecha y hora en formato ISO 8601. Si no se especifica este par\u00e1metro, se devuelven los datos disponibles para la serie o series desde el valor m\u00e1s antiguo. N/A start_date=2016-11-30 start_date=2016-11 start_date=2016 end_date No Fecha y hora en formato ISO 8601. Si no se especifica este par\u00e1metro, se devuelven los datos disponibles para la serie o series hasta el valor m\u00e1s reciente. N/A end_date=2016-11-30 end_date=2016-11 end_date=2016 format No Uno de: json, csv json format=csv header No Uno de: titles, ids, descriptions titles header=ids sort No Uno de: asc, desc asc sort=desc metadata No Uno de: none, simple, full, only simple metadata=none decimal No Caracter utilizado para los decimales. Uno de: \",\" o \".\" . decimal=, sep No Caracter separador de los valores del CSV. Cualquier caracter UTF-8 , sep=| flatten No Aplana la respuesta de metadatos en un objeto con un \u00fanico nivel (sin objetos anidados). No es necesario darle valor flatten last No Modifica el pedido para devolver los \u00faltimos N valores de la(s) serie(s), en orden de fechas ascendiente. Mutuamente exclusivo con `sort`, `start`, y `limit`. N/A last=12 ids Lista separada por comas de los identificadores de las series a seleccionar para armar la respuesta. Los datos del resultado de la llamada tendr\u00e1n una columna por cada serie seleccionada, en el mismo orden. Este par\u00e1metro es requerido para la llamada . En caso de no suministrarse, se devolver\u00e1 un error. Cada identificador de serie podr\u00e1 ser sufijado con: Un modo de representaci\u00f3n ( representation_mode ). Una funci\u00f3n de agregaci\u00f3n temporal ( collapse_aggregation ). Cuando estos atributos se utilizan como parte del par\u00e1metro ids , se deben separar usando el caracter \":\". El orden de los componentes no incide en el resultado de la operaci\u00f3n. Ejemplos: ids=2.4_DGI_1993_T_19,134.2_B_0_0_6:change ids=2.4_DGI_1993_T_19,134.2_B_0_0_6:sum:change ids=2.4_DGI_1993_T_19,134.2_B_0_0_6:change:sum ids=2.4_DGI_1993_T_19:percent_change,134.2_B_0_0_6:sum:change ids=2.4_DGI_1993_T_19:end_of_period:percent_change,134.2_B_0_0_6:sum:change representation_mode Este par\u00e1metro indica el modo de representaci\u00f3n de las series, y se aplica a todas aquellas que no tengan otro modo de representaci\u00f3n distinto indicado en el par\u00e1metro ids en forma individual. El modo de representaci\u00f3n por defecto es el valor medido en la serie ( value ). Los modos de representaci\u00f3n disponibles son: value : Es el modo de representaci\u00f3n por defecto. Devuelve el valor medido en la serie. change : Devuelve la diferencia absoluta entre el valor del per\u00edodo t y el de t-1. percent_change : Devuelve la variaci\u00f3n porcentual entre el valor del per\u00edodo t y el de t-1. percent_change_a_year_ago : Devuelve la variaci\u00f3n porcentual entre el valor del per\u00edodo t y el del per\u00edodo t equivalente de hace un a\u00f1o atr\u00e1s. Las funciones de transformaci\u00f3n disponibles en representation_mode tambi\u00e9n pueden especificarse para series individuales usando la notaci\u00f3n :percent_change junto al id de la serie: EMAE Construcci\u00f3n. Variaci\u00f3n porcentual de valores mensuales, respecto del per\u00edodo anterior. https://apis.datos.gob.ar/series/api/series/?limit=1000&ids=11.3_VMATC_2004_M_12:percent_change EMAE Construcci\u00f3n (variaci\u00f3n porcentual per\u00edodo a per\u00edodo), EMAE Construcci\u00f3n (variaci\u00f3n porcentual interanual). Valores mensuales. https://apis.datos.gob.ar/series/api/series/?limit=1000&ids=11.3_VMATC_2004_M_12:percent_change,11.3_VMATC_2004_M_12:percent_change_a_year_ago El par\u00e1metro representation_mode seguir\u00e1 afectando a todas las series para las cuales no se especifique individualmente una funci\u00f3n de transformaci\u00f3n. collapse El par\u00e1metro collapse modifica la frecuencia de muestreo de los datos de la serie o las series solicitadas. Debe usarse en combinaci\u00f3n con collapse_aggregation para indicar una funnci\u00f3n de agregaci\u00f3n temporal, cuando corresponda. Las opciones disponibles son: year : Muestra datos agregados anualmente. quarter : Muestra datos agregados trimestralmente. month : Muestra datos agregados mensualmente. week : Muestra datos agregados semanalmente. day : Muestra datos agregados diariamente. Si no se indica, se retornan los datos con la frecuencia original de la serie . Si se solicitan m\u00faltiples series de distintas frecuencias , se utilizar\u00e1 la menor frecuencia de todas ellas (Ej.: si se solicitan a la vez una serie diaria, una mensual y una trimestral, se convertir\u00e1n todas las series a la frecuencia trimestral). Si la granularidad temporal solicitada en el valor de collapse es menor a la granularidad propia de alguna de las series solicitadas, la consulta devolver\u00e1 un error. El par\u00e1metro collapse afecta globalmente a todas las series seleccionadas por el par\u00e1metro ids en la llamada. collapse_aggregation El par\u00e1metro collapse_aggregation indica la funci\u00f3n de agregaci\u00f3n temporal que debe usarse para homogeneizar la frecuencia temporal de todas las series solicitadas (Ej.: qu\u00e9 operaci\u00f3n realizar para convertir una serie mensual en anual). Esta funci\u00f3n de agregaci\u00f3n actuar\u00e1 sobre: Las series agrupadas de mayor granularidad temporal (frecuencia m\u00e1s alta) que la granularidad indicada por el par\u00e1metro collapse En caso de que no se especifique el par\u00e1metro collapse , las series agrupadas de mayor granularidad temporal que la de la serie de menor frecuencia temporal. Los valores disponibles para el par\u00e1metro son: avg : Realiza el promedio de todos los valores agrupados. Es la opci\u00f3n por defecto si no se indica valor para collapse_aggregation . sum : Suma todos los valores agrupados. end_of_period : \u00daltimo valor del per\u00edodo. min : M\u00ednimo entre los valores agrupados. max : M\u00e1ximo entre los valores agrupados. Las funciones de agregaci\u00f3n temporal disponibles en collapse_aggregation tambi\u00e9n pueden especificarse para series individuales usando la notaci\u00f3n :sum junto al id de la serie: Cobro de servicios de turismo y viajes. Valores mensuales promediados y sumados por a\u00f1o. https://apis.datos.gob.ar/series/api/series/?ids=185.1_COBRO_SERVJES_0_M_30:avg,185.1_COBRO_SERVJES_0_M_30:sum&collapse=year El par\u00e1metro collapse_aggregation seguir\u00e1 afectando a todas las series para las cuales no se especifique individualmente una funci\u00f3n de agregaci\u00f3n temporal. Cobro de servicios de turismo y viajes. Valores mensuales promediados y sumados por a\u00f1o. https://apis.datos.gob.ar/series/api/series/?ids=185.1_COBRO_SERVJES_0_M_30:avg,185.1_COBRO_SERVJES_0_M_30&collapse=year&collapse_aggregation=sum limit Este par\u00e1metro es utilizado junto a start para controlar el paginado de los resultados devueltos por la API. Debe especificarse un n\u00famero entero positivo, no mayor que 1000, ya que esa es la cantidad m\u00e1xima de resultados devueltos por la API. El valor por defecto si no se especifica valor alguno es 100. start Este par\u00e1metro es utilizado junto a limit para controlar el paginado de los resultados devueltos por la API. Debe especificarse un n\u00famero entero positivo o 0. El valor por defecto si no se especifica valor alguno es 0. El start indica el \"n\u00famero de per\u00edodos despu\u00e9s de start_date \" (o el \"n\u00famero de per\u00edodos antes de end_date \", dependiendo del ordenamiento asc o desc del par\u00e1metro sort ) que se saltean desde el comienzo o el final de la serie antes de empezar a devolver valores. start_date El par\u00e1metro start_date indica la fecha menor a partir de la cual se comenzar\u00e1n a recolectar datos para la respuesta. Los valores cuyo \u00edndice de tiempo coincida con el valor de start_date se incluir\u00e1n en el resultado retornado. Se utilizar\u00e1 como filtro sobre el \u00edndice de tiempo de las series de datos. end_date El par\u00e1metro end_date indica la fecha mayor hasta la cual se recolectar\u00e1n datos para la respuesta. Los valores cuyo \u00edndice de tiempo coincida con el valor de end_date se incluir\u00e1n en el resultado retornado. Se utilizar\u00e1 como filtro sobre el \u00edndice de tiempo de las series de datos. format Especifica el formato de la respuesta, siendo json el valor por defecto. Las opciones disponibles son: json : Devuelve un objeto json con datos y metadatos de las series. csv : Devuelve las series seleccionadas en formato separado por comas. Este tipo de formato no incluye metadatos de las series seleccionadas. header Especifica los atributos de las series a utilizar como headers (cabeceras) de las columnas del archivo CSV generado. Por defecto usa titles , que son los t\u00edtulos de las series. Las opciones disponibles son: titles : T\u00edtulos de las series, por ejemplo oferta_global_pib (default). ids : Identificadores \u00fanicos de las series, los mismos pasados al par\u00e1metro ids . descriptions : Descripciones completas de las series, por ejemplo Plazo fijo entre 60-89 d\u00edas en millones de pesos. Categor\u00eda II-VI sort Especifica el orden temporal de los resultados devueltos, siendo asc el valor por defecto. Las opciones disponibles son: asc : Se devuelven los valores m\u00e1s antiguos primero (default). desc : Se devuelven los valores m\u00e1s recientes primero. metadata Especifica el nivel de detalle de metadatos requerido por el usuario, siendo simple el valor por defecto. S\u00f3lo aplica cuando format=json . Las opciones disponibles son: none : No se devuelven metadatos, s\u00f3lo datos. only : No se devuelven datos, s\u00f3lo metadatos. simple : Se devuelven los metadatos m\u00e1s importantes para comprender y utilizar las series (default). full : Se devuelven todos los metadatos disponibles que tengan relaci\u00f3n con cada serie. decimal Especifica el caracter utilizado para los n\u00fameros decimales, siendo . el valor por defecto. S\u00f3lo aplica cuando format=csv . Las opciones disponibles son: , : Coma. . : Punto. sep Especifica el caracter separador de valores, siendo , el valor por defecto. S\u00f3lo aplica cuando format=csv . Se puede utilizar cualquier caracter UTF-8, si bien se recomienda preservar el uso de la coma en la mayor\u00eda de los casos. flatten Especifica si la respuesta de los metadatos de las series pedidas deber\u00edan devolverse en una jerarqu\u00eda plana . Cuando el par\u00e1metro no es incluido, la respuesta tiene la siguiente estructura: { \"catalog\": [], \"dataset\": [], \"distribution\": [], \"field\": [], } Una consulta con par\u00e1metro flatten incluido tendr\u00e1 la siguiente respuesta de metadatos: { catalog_meta1: ..., catalog_meta2: ..., dataset_meta1: ..., _: ... } last Modifica el pedido para devolver los \u00faltimos N valores de la(s) serie(s), en orden de fechas ascendiente. Mutuamente exclusivo con sort , start , y limit . Un pedido con last=N es equivalente a invertir el orden de un pedido con sort=desc , limit=N .","title":"/series"},{"location":"reference/api-reference/#referencia-api-series","text":"Recurso: /series El recurso /series permite obtener datos y metadatos de una o m\u00e1s series, permitiendo hacer filtros por el \u00edndice de tiempo, cambios de granularidad en la dimensi\u00f3n temporal y cambios en la unidad de medida de los valores de la serie, entre otras operaciones. Tabla de par\u00e1metros ids representation_mode collapse collapse_aggregation limit start start_date end_date format header sort metadata decimal sep flatten last","title":"Referencia API: series"},{"location":"reference/api-reference/#tabla-de-parametros","text":"Nombre Requerido Descripci\u00f3n Default Ejemplos ids Si Lista de caracteres alfanum\u00e9ricos separados por comas. Contiene la especificaci\u00f3n de las series a consultar, junto a transformaciones y operaciones. N/A ids=2.4_DGI_1993_T_19,134.2_B_0_0_6 representation_mode No Uno de: value, change, percent_change, percent_change_a_year_ago value representation_mode=percent_change collapse No Uno de: day, week, month, quarter, year La frecuencia propia de la serie collapse=year collapse=quarter collapse_aggregation No Uno de: avg, sum, end_of_period, min, max avg collapse_aggregation=sum limit No N\u00famero entero positivo, no mayor que 1000. 100 limit=50 start No N\u00famero entero positivo o 0. 0 start=100 start_date No Fecha y hora en formato ISO 8601. Si no se especifica este par\u00e1metro, se devuelven los datos disponibles para la serie o series desde el valor m\u00e1s antiguo. N/A start_date=2016-11-30 start_date=2016-11 start_date=2016 end_date No Fecha y hora en formato ISO 8601. Si no se especifica este par\u00e1metro, se devuelven los datos disponibles para la serie o series hasta el valor m\u00e1s reciente. N/A end_date=2016-11-30 end_date=2016-11 end_date=2016 format No Uno de: json, csv json format=csv header No Uno de: titles, ids, descriptions titles header=ids sort No Uno de: asc, desc asc sort=desc metadata No Uno de: none, simple, full, only simple metadata=none decimal No Caracter utilizado para los decimales. Uno de: \",\" o \".\" . decimal=, sep No Caracter separador de los valores del CSV. Cualquier caracter UTF-8 , sep=| flatten No Aplana la respuesta de metadatos en un objeto con un \u00fanico nivel (sin objetos anidados). No es necesario darle valor flatten last No Modifica el pedido para devolver los \u00faltimos N valores de la(s) serie(s), en orden de fechas ascendiente. Mutuamente exclusivo con `sort`, `start`, y `limit`. N/A last=12","title":"Tabla de par\u00e1metros"},{"location":"reference/api-reference/#ids","text":"Lista separada por comas de los identificadores de las series a seleccionar para armar la respuesta. Los datos del resultado de la llamada tendr\u00e1n una columna por cada serie seleccionada, en el mismo orden. Este par\u00e1metro es requerido para la llamada . En caso de no suministrarse, se devolver\u00e1 un error. Cada identificador de serie podr\u00e1 ser sufijado con: Un modo de representaci\u00f3n ( representation_mode ). Una funci\u00f3n de agregaci\u00f3n temporal ( collapse_aggregation ). Cuando estos atributos se utilizan como parte del par\u00e1metro ids , se deben separar usando el caracter \":\". El orden de los componentes no incide en el resultado de la operaci\u00f3n. Ejemplos: ids=2.4_DGI_1993_T_19,134.2_B_0_0_6:change ids=2.4_DGI_1993_T_19,134.2_B_0_0_6:sum:change ids=2.4_DGI_1993_T_19,134.2_B_0_0_6:change:sum ids=2.4_DGI_1993_T_19:percent_change,134.2_B_0_0_6:sum:change ids=2.4_DGI_1993_T_19:end_of_period:percent_change,134.2_B_0_0_6:sum:change","title":"ids"},{"location":"reference/api-reference/#representation_mode","text":"Este par\u00e1metro indica el modo de representaci\u00f3n de las series, y se aplica a todas aquellas que no tengan otro modo de representaci\u00f3n distinto indicado en el par\u00e1metro ids en forma individual. El modo de representaci\u00f3n por defecto es el valor medido en la serie ( value ). Los modos de representaci\u00f3n disponibles son: value : Es el modo de representaci\u00f3n por defecto. Devuelve el valor medido en la serie. change : Devuelve la diferencia absoluta entre el valor del per\u00edodo t y el de t-1. percent_change : Devuelve la variaci\u00f3n porcentual entre el valor del per\u00edodo t y el de t-1. percent_change_a_year_ago : Devuelve la variaci\u00f3n porcentual entre el valor del per\u00edodo t y el del per\u00edodo t equivalente de hace un a\u00f1o atr\u00e1s. Las funciones de transformaci\u00f3n disponibles en representation_mode tambi\u00e9n pueden especificarse para series individuales usando la notaci\u00f3n :percent_change junto al id de la serie: EMAE Construcci\u00f3n. Variaci\u00f3n porcentual de valores mensuales, respecto del per\u00edodo anterior. https://apis.datos.gob.ar/series/api/series/?limit=1000&ids=11.3_VMATC_2004_M_12:percent_change EMAE Construcci\u00f3n (variaci\u00f3n porcentual per\u00edodo a per\u00edodo), EMAE Construcci\u00f3n (variaci\u00f3n porcentual interanual). Valores mensuales. https://apis.datos.gob.ar/series/api/series/?limit=1000&ids=11.3_VMATC_2004_M_12:percent_change,11.3_VMATC_2004_M_12:percent_change_a_year_ago El par\u00e1metro representation_mode seguir\u00e1 afectando a todas las series para las cuales no se especifique individualmente una funci\u00f3n de transformaci\u00f3n.","title":"representation_mode"},{"location":"reference/api-reference/#collapse","text":"El par\u00e1metro collapse modifica la frecuencia de muestreo de los datos de la serie o las series solicitadas. Debe usarse en combinaci\u00f3n con collapse_aggregation para indicar una funnci\u00f3n de agregaci\u00f3n temporal, cuando corresponda. Las opciones disponibles son: year : Muestra datos agregados anualmente. quarter : Muestra datos agregados trimestralmente. month : Muestra datos agregados mensualmente. week : Muestra datos agregados semanalmente. day : Muestra datos agregados diariamente. Si no se indica, se retornan los datos con la frecuencia original de la serie . Si se solicitan m\u00faltiples series de distintas frecuencias , se utilizar\u00e1 la menor frecuencia de todas ellas (Ej.: si se solicitan a la vez una serie diaria, una mensual y una trimestral, se convertir\u00e1n todas las series a la frecuencia trimestral). Si la granularidad temporal solicitada en el valor de collapse es menor a la granularidad propia de alguna de las series solicitadas, la consulta devolver\u00e1 un error. El par\u00e1metro collapse afecta globalmente a todas las series seleccionadas por el par\u00e1metro ids en la llamada.","title":"collapse"},{"location":"reference/api-reference/#collapse_aggregation","text":"El par\u00e1metro collapse_aggregation indica la funci\u00f3n de agregaci\u00f3n temporal que debe usarse para homogeneizar la frecuencia temporal de todas las series solicitadas (Ej.: qu\u00e9 operaci\u00f3n realizar para convertir una serie mensual en anual). Esta funci\u00f3n de agregaci\u00f3n actuar\u00e1 sobre: Las series agrupadas de mayor granularidad temporal (frecuencia m\u00e1s alta) que la granularidad indicada por el par\u00e1metro collapse En caso de que no se especifique el par\u00e1metro collapse , las series agrupadas de mayor granularidad temporal que la de la serie de menor frecuencia temporal. Los valores disponibles para el par\u00e1metro son: avg : Realiza el promedio de todos los valores agrupados. Es la opci\u00f3n por defecto si no se indica valor para collapse_aggregation . sum : Suma todos los valores agrupados. end_of_period : \u00daltimo valor del per\u00edodo. min : M\u00ednimo entre los valores agrupados. max : M\u00e1ximo entre los valores agrupados. Las funciones de agregaci\u00f3n temporal disponibles en collapse_aggregation tambi\u00e9n pueden especificarse para series individuales usando la notaci\u00f3n :sum junto al id de la serie: Cobro de servicios de turismo y viajes. Valores mensuales promediados y sumados por a\u00f1o. https://apis.datos.gob.ar/series/api/series/?ids=185.1_COBRO_SERVJES_0_M_30:avg,185.1_COBRO_SERVJES_0_M_30:sum&collapse=year El par\u00e1metro collapse_aggregation seguir\u00e1 afectando a todas las series para las cuales no se especifique individualmente una funci\u00f3n de agregaci\u00f3n temporal. Cobro de servicios de turismo y viajes. Valores mensuales promediados y sumados por a\u00f1o. https://apis.datos.gob.ar/series/api/series/?ids=185.1_COBRO_SERVJES_0_M_30:avg,185.1_COBRO_SERVJES_0_M_30&collapse=year&collapse_aggregation=sum","title":"collapse_aggregation"},{"location":"reference/api-reference/#limit","text":"Este par\u00e1metro es utilizado junto a start para controlar el paginado de los resultados devueltos por la API. Debe especificarse un n\u00famero entero positivo, no mayor que 1000, ya que esa es la cantidad m\u00e1xima de resultados devueltos por la API. El valor por defecto si no se especifica valor alguno es 100.","title":"limit"},{"location":"reference/api-reference/#start","text":"Este par\u00e1metro es utilizado junto a limit para controlar el paginado de los resultados devueltos por la API. Debe especificarse un n\u00famero entero positivo o 0. El valor por defecto si no se especifica valor alguno es 0. El start indica el \"n\u00famero de per\u00edodos despu\u00e9s de start_date \" (o el \"n\u00famero de per\u00edodos antes de end_date \", dependiendo del ordenamiento asc o desc del par\u00e1metro sort ) que se saltean desde el comienzo o el final de la serie antes de empezar a devolver valores.","title":"start"},{"location":"reference/api-reference/#start_date","text":"El par\u00e1metro start_date indica la fecha menor a partir de la cual se comenzar\u00e1n a recolectar datos para la respuesta. Los valores cuyo \u00edndice de tiempo coincida con el valor de start_date se incluir\u00e1n en el resultado retornado. Se utilizar\u00e1 como filtro sobre el \u00edndice de tiempo de las series de datos.","title":"start_date"},{"location":"reference/api-reference/#end_date","text":"El par\u00e1metro end_date indica la fecha mayor hasta la cual se recolectar\u00e1n datos para la respuesta. Los valores cuyo \u00edndice de tiempo coincida con el valor de end_date se incluir\u00e1n en el resultado retornado. Se utilizar\u00e1 como filtro sobre el \u00edndice de tiempo de las series de datos.","title":"end_date"},{"location":"reference/api-reference/#format","text":"Especifica el formato de la respuesta, siendo json el valor por defecto. Las opciones disponibles son: json : Devuelve un objeto json con datos y metadatos de las series. csv : Devuelve las series seleccionadas en formato separado por comas. Este tipo de formato no incluye metadatos de las series seleccionadas.","title":"format"},{"location":"reference/api-reference/#header","text":"Especifica los atributos de las series a utilizar como headers (cabeceras) de las columnas del archivo CSV generado. Por defecto usa titles , que son los t\u00edtulos de las series. Las opciones disponibles son: titles : T\u00edtulos de las series, por ejemplo oferta_global_pib (default). ids : Identificadores \u00fanicos de las series, los mismos pasados al par\u00e1metro ids . descriptions : Descripciones completas de las series, por ejemplo Plazo fijo entre 60-89 d\u00edas en millones de pesos. Categor\u00eda II-VI","title":"header"},{"location":"reference/api-reference/#sort","text":"Especifica el orden temporal de los resultados devueltos, siendo asc el valor por defecto. Las opciones disponibles son: asc : Se devuelven los valores m\u00e1s antiguos primero (default). desc : Se devuelven los valores m\u00e1s recientes primero.","title":"sort"},{"location":"reference/api-reference/#metadata","text":"Especifica el nivel de detalle de metadatos requerido por el usuario, siendo simple el valor por defecto. S\u00f3lo aplica cuando format=json . Las opciones disponibles son: none : No se devuelven metadatos, s\u00f3lo datos. only : No se devuelven datos, s\u00f3lo metadatos. simple : Se devuelven los metadatos m\u00e1s importantes para comprender y utilizar las series (default). full : Se devuelven todos los metadatos disponibles que tengan relaci\u00f3n con cada serie.","title":"metadata"},{"location":"reference/api-reference/#decimal","text":"Especifica el caracter utilizado para los n\u00fameros decimales, siendo . el valor por defecto. S\u00f3lo aplica cuando format=csv . Las opciones disponibles son: , : Coma. . : Punto.","title":"decimal"},{"location":"reference/api-reference/#sep","text":"Especifica el caracter separador de valores, siendo , el valor por defecto. S\u00f3lo aplica cuando format=csv . Se puede utilizar cualquier caracter UTF-8, si bien se recomienda preservar el uso de la coma en la mayor\u00eda de los casos.","title":"sep"},{"location":"reference/api-reference/#flatten","text":"Especifica si la respuesta de los metadatos de las series pedidas deber\u00edan devolverse en una jerarqu\u00eda plana . Cuando el par\u00e1metro no es incluido, la respuesta tiene la siguiente estructura: { \"catalog\": [], \"dataset\": [], \"distribution\": [], \"field\": [], } Una consulta con par\u00e1metro flatten incluido tendr\u00e1 la siguiente respuesta de metadatos: { catalog_meta1: ..., catalog_meta2: ..., dataset_meta1: ..., _: ... }","title":"flatten"},{"location":"reference/api-reference/#last","text":"Modifica el pedido para devolver los \u00faltimos N valores de la(s) serie(s), en orden de fechas ascendiente. Mutuamente exclusivo con sort , start , y limit . Un pedido con last=N es equivalente a invertir el orden de un pedido con sort=desc , limit=N .","title":"last"},{"location":"reference/search-reference/","text":"Referencia API: search Tabla de par\u00e1metros q dataset_theme , units , dataset_publisher_name , dataset_source , catalog_id limit start Referencia API: search Recurso: /search El recurso /search permite buscar series a partir de un texto, proporcionando adem\u00e1s algunos filtros (ej.: por tema o por unidades de las series). Tabla de par\u00e1metros Nombre Requerido Descripci\u00f3n Default Ejemplos q No Texto N/A q=ipc dataset_theme No Uno de los valores listados en /search/dataset_theme N/A dataset_theme=\"Finanzas P\u00fablicas\" units No Uno de los valores listados en /search/field_units N/A units=\"Millones de pesos\" dataset_publisher_name No Uno de los valores listados en /search/dataset_publisher_name N/A dataset_publisher_name=\"Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" dataset_source No Uno de los valores listados en /search/dataset_source N/A dataset_source=\"Ministerio de Hacienda\" catalog_id No Uno de los valores listados en /search/catalog_id N/A catalog_id=\"sspm\" limit No N\u00famero entero positivo, no mayor que 1000. 10 limit=50 start No N\u00famero entero positivo o 0. 0 start=100 aggregations No N/A N/A N/A q Texto de entrada a buscar en la base de series de tiempo. Puede ser abritrariamente largo, pero se recomienda ingresar una o m\u00e1s palabras clave. dataset_theme , units , dataset_publisher_name , dataset_source , catalog_id Estos par\u00e1metros pueden ser usados como filtros en los resultados de la b\u00fasqueda . Al aplicarse, se muestran \u00fanicamente aquellos resultados que sean compatibles con la especificaci\u00f3n. Por ejemplo: un pedido con units=Millones de pesos s\u00f3lo contendr\u00e1 series de tiempo que est\u00e9n expresadas en millones de pesos. Los t\u00e9rminos que aceptan estos par\u00e1metros son especificados en recursos auxiliares que devuelven la lista entera de valores aceptados en los filtros. Por ejemplo: un pedido a /search/field_units devuelve una lista de los t\u00e9rminos que se le pueden pasar al par\u00e1metro units . Cualquier otra opci\u00f3n devolver\u00e1 una lista vac\u00eda de resultados (al no haber coincidencias). Consultar la tabla de par\u00e1metros para ver los endpoints auxiliares. limit Este par\u00e1metro es utilizado junto a start para controlar el paginado de los resultados devueltos por la API. Debe especificarse un n\u00famero entero positivo, no mayor que 1000, ya que esa es la cantidad m\u00e1xima de resultados devueltos por la API. El valor por defecto si no se especifica valor alguno es 10. start Este par\u00e1metro es utilizado junto a limit para controlar el paginado de los resultados devueltos por la API. Debe especificarse un n\u00famero entero positivo o 0. El valor por defecto si no se especifica valor alguno es 0. El start indica el \"n\u00famero de resultados despu\u00e9s del inicio\" que se saltea el buscador para el armado de la respuesta. aggregations La presencia de este par\u00e1metro agrega un objeto nuevo a la respuesta de la API bajo la clave aggregations , que contiene la cantidad de ocurrencias totales de la b\u00fasqueda discriminando por los distintos filtros posibles. Si el par\u00e1metro no est\u00e1 presente, no se calculan las agregaciones. Un ejemplo posible de la respuesta: { \"aggregations\" : { \"dataset_theme\" : [ { \"label\" : \"Finanzas P\u00fablicas\" , \"series_count\" : 904 }, { \"label\" : \"Precios\" , \"series_count\" : 522 }, { \"label\" : \"Sector Externo\" , \"series_count\" : 21 } ], \"units\" : [ { \"label\" : \"Millones de pesos\" , \"series_count\" : 904 }, { \"label\" : \"\u00cdndice\" , \"series_count\" : 509 }, { \"label\" : \"Millones de d\u00f3lares\" , \"series_count\" : 21 }, { \"label\" : \"Variaci\u00f3n Porcentual\" , \"series_count\" : 12 }, { \"label\" : \"Variaci\u00f3n intermensual\" , \"series_count\" : 1 } ], \"dataset_publisher_name\" : [ { \"label\" : \"Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" , \"series_count\" : 1447 } ], \"dataset_source\" : [ { \"label\" : \"Ministerio de Hacienda\" , \"series_count\" : 925 }, { \"label\" : \"Instituto Nacional de Estad\u00edstica y Censos (INDEC)\" , \"series_count\" : 522 } ], \"catalog_id\" : [ { \"label\" : \"sspm\" , \"series_count\" : 1447 } ] } }","title":"/search"},{"location":"reference/search-reference/#referencia-api-search","text":"Recurso: /search El recurso /search permite buscar series a partir de un texto, proporcionando adem\u00e1s algunos filtros (ej.: por tema o por unidades de las series).","title":"Referencia API: search"},{"location":"reference/search-reference/#tabla-de-parametros","text":"Nombre Requerido Descripci\u00f3n Default Ejemplos q No Texto N/A q=ipc dataset_theme No Uno de los valores listados en /search/dataset_theme N/A dataset_theme=\"Finanzas P\u00fablicas\" units No Uno de los valores listados en /search/field_units N/A units=\"Millones de pesos\" dataset_publisher_name No Uno de los valores listados en /search/dataset_publisher_name N/A dataset_publisher_name=\"Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" dataset_source No Uno de los valores listados en /search/dataset_source N/A dataset_source=\"Ministerio de Hacienda\" catalog_id No Uno de los valores listados en /search/catalog_id N/A catalog_id=\"sspm\" limit No N\u00famero entero positivo, no mayor que 1000. 10 limit=50 start No N\u00famero entero positivo o 0. 0 start=100 aggregations No N/A N/A N/A","title":"Tabla de par\u00e1metros"},{"location":"reference/search-reference/#q","text":"Texto de entrada a buscar en la base de series de tiempo. Puede ser abritrariamente largo, pero se recomienda ingresar una o m\u00e1s palabras clave.","title":"q"},{"location":"reference/search-reference/#dataset_theme-units-dataset_publisher_name-dataset_source-catalog_id","text":"Estos par\u00e1metros pueden ser usados como filtros en los resultados de la b\u00fasqueda . Al aplicarse, se muestran \u00fanicamente aquellos resultados que sean compatibles con la especificaci\u00f3n. Por ejemplo: un pedido con units=Millones de pesos s\u00f3lo contendr\u00e1 series de tiempo que est\u00e9n expresadas en millones de pesos. Los t\u00e9rminos que aceptan estos par\u00e1metros son especificados en recursos auxiliares que devuelven la lista entera de valores aceptados en los filtros. Por ejemplo: un pedido a /search/field_units devuelve una lista de los t\u00e9rminos que se le pueden pasar al par\u00e1metro units . Cualquier otra opci\u00f3n devolver\u00e1 una lista vac\u00eda de resultados (al no haber coincidencias). Consultar la tabla de par\u00e1metros para ver los endpoints auxiliares.","title":"dataset_theme, units, dataset_publisher_name, dataset_source, catalog_id"},{"location":"reference/search-reference/#limit","text":"Este par\u00e1metro es utilizado junto a start para controlar el paginado de los resultados devueltos por la API. Debe especificarse un n\u00famero entero positivo, no mayor que 1000, ya que esa es la cantidad m\u00e1xima de resultados devueltos por la API. El valor por defecto si no se especifica valor alguno es 10.","title":"limit"},{"location":"reference/search-reference/#start","text":"Este par\u00e1metro es utilizado junto a limit para controlar el paginado de los resultados devueltos por la API. Debe especificarse un n\u00famero entero positivo o 0. El valor por defecto si no se especifica valor alguno es 0. El start indica el \"n\u00famero de resultados despu\u00e9s del inicio\" que se saltea el buscador para el armado de la respuesta.","title":"start"},{"location":"reference/search-reference/#aggregations","text":"La presencia de este par\u00e1metro agrega un objeto nuevo a la respuesta de la API bajo la clave aggregations , que contiene la cantidad de ocurrencias totales de la b\u00fasqueda discriminando por los distintos filtros posibles. Si el par\u00e1metro no est\u00e1 presente, no se calculan las agregaciones. Un ejemplo posible de la respuesta: { \"aggregations\" : { \"dataset_theme\" : [ { \"label\" : \"Finanzas P\u00fablicas\" , \"series_count\" : 904 }, { \"label\" : \"Precios\" , \"series_count\" : 522 }, { \"label\" : \"Sector Externo\" , \"series_count\" : 21 } ], \"units\" : [ { \"label\" : \"Millones de pesos\" , \"series_count\" : 904 }, { \"label\" : \"\u00cdndice\" , \"series_count\" : 509 }, { \"label\" : \"Millones de d\u00f3lares\" , \"series_count\" : 21 }, { \"label\" : \"Variaci\u00f3n Porcentual\" , \"series_count\" : 12 }, { \"label\" : \"Variaci\u00f3n intermensual\" , \"series_count\" : 1 } ], \"dataset_publisher_name\" : [ { \"label\" : \"Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" , \"series_count\" : 1447 } ], \"dataset_source\" : [ { \"label\" : \"Ministerio de Hacienda\" , \"series_count\" : 925 }, { \"label\" : \"Instituto Nacional de Estad\u00edstica y Censos (INDEC)\" , \"series_count\" : 522 } ], \"catalog_id\" : [ { \"label\" : \"sspm\" , \"series_count\" : 1447 } ] } }","title":"aggregations"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"API de Series de Tiempo de la Rep\u00fablica Argentina Versi\u00f3n : 1.10.0 La API de Series de Tiempo de Argentina, permite consultar indicadores con evoluci\u00f3n cronol\u00f3gica publicados en formatos abiertos por organismos de la Administraci\u00f3n P\u00fablica Nacional. Una serie de tiempo es una secuencia de observaciones o valores, medidos en determinados momentos del tiempo y ordenados cronol\u00f3gicamente. indice_tiempo ipc_2016_nivel_general 2017-04 0.28 2017-05 0.24 2017-06 0.22 2017-07 0.22 2017-08 0.23 2017-09 0.24 2017-10 0.23 2017-11 0.22 2017-12 0.25 2018-01 0.25 2018-02 0.26 2018-03 0.26 Un servicio web , es una tecnolog\u00eda que permite intercambiar datos entre aplicaciones. apis.datos.gob.ar/series/api/series/?ids=101.1_I2NG_2016_M_22:percent_change_a_year_ago&format=csv Estos indicadores son ejemplos de series de tiempo: Inflaci\u00f3n ( csv | json ) Tipo de cambio ( csv | json ) Nivel de actividad ( csv | json ) Si sos usuario de la API de Series de Tiempo y quer\u00e9s estar al tanto de los cambios y novedades, inscribite en la base de contactos de Datos Argentina y eleg\u00ed sobre qu\u00e9 temas quer\u00e9s que te escribamos. \u00bfTen\u00e9s algo que contarnos? Nos encantar\u00eda que nos cuentes por Twitter o por mail qu\u00e9 mejor\u00f3 usar la API en tu trabajo y qu\u00e9 le falta para mejorar a\u00fan m\u00e1s.","title":"Inicio"},{"location":"#api-de-series-de-tiempo-de-la-republica-argentina","text":"Versi\u00f3n : 1.10.0 La API de Series de Tiempo de Argentina, permite consultar indicadores con evoluci\u00f3n cronol\u00f3gica publicados en formatos abiertos por organismos de la Administraci\u00f3n P\u00fablica Nacional. Una serie de tiempo es una secuencia de observaciones o valores, medidos en determinados momentos del tiempo y ordenados cronol\u00f3gicamente. indice_tiempo ipc_2016_nivel_general 2017-04 0.28 2017-05 0.24 2017-06 0.22 2017-07 0.22 2017-08 0.23 2017-09 0.24 2017-10 0.23 2017-11 0.22 2017-12 0.25 2018-01 0.25 2018-02 0.26 2018-03 0.26 Un servicio web , es una tecnolog\u00eda que permite intercambiar datos entre aplicaciones. apis.datos.gob.ar/series/api/series/?ids=101.1_I2NG_2016_M_22:percent_change_a_year_ago&format=csv Estos indicadores son ejemplos de series de tiempo: Inflaci\u00f3n ( csv | json ) Tipo de cambio ( csv | json ) Nivel de actividad ( csv | json ) Si sos usuario de la API de Series de Tiempo y quer\u00e9s estar al tanto de los cambios y novedades, inscribite en la base de contactos de Datos Argentina y eleg\u00ed sobre qu\u00e9 temas quer\u00e9s que te escribamos. \u00bfTen\u00e9s algo que contarnos? Nos encantar\u00eda que nos cuentes por Twitter o por mail qu\u00e9 mejor\u00f3 usar la API en tu trabajo y qu\u00e9 le falta para mejorar a\u00fan m\u00e1s.","title":"API de Series de Tiempo de la Rep\u00fablica Argentina"},{"location":"additional-parameters/","text":"Filtrar y transformar las series Descargar una tabla con una o varias series Filtrar por fechas Cambiar la agregaci\u00f3n temporal Cambiar la funci\u00f3n de agregaci\u00f3n temporal Aplicar transformaciones Aplicar transformaciones y cambiar la funci\u00f3n de agregaci\u00f3n temporal en series individuales, a la vez Descargar una tabla con una o varias series El par\u00e1metro ids permite la consulta simult\u00e1nea de hasta 40 series a la vez , separadas por comas. IPC por categor\u00edas http://apis.datos.gob.ar/series/api/series/?ids=103.1_I2N_2016_M_15,101.1_I2NG_2016_M_22,102.1_I2S_ABRI_M_18,102.1_I2B_ABRI_M_15,103.1_I2R_2016_M_18,103.1_I2E_2016_M_21&format=csv Filtrar por fechas Los par\u00e1metros start_date y end_date permiten limitar una consulta a todos aquellos valores posteriores o anteriores (respectivamente) a una fecha determinada. Tipo de cambio desde Enero de 2016 https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26&start_date=2016-01&limit=1000&format=csv Tipo de cambio hasta Diciembre de 2016 https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26&end_date=2016-12&format=csv Tipo de cambio desde Enero de 2016 hasta Diciembre de 2016 https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26&start_date=2016-01&end_date=2016-12&format=csv Cambiar la agregaci\u00f3n temporal Por default, las series se muestran en la frecuencia m\u00e1s alta posible (esta es, la frecuencia m\u00e1s baja de todas las series consultadas a la vez). El par\u00e1metro collapse permite elegir una frecuencia m\u00e1s baja que esta. \u00cdndice de Tipo de Cambio Real Multilateral, China y Brasil. Valores mensuales promediados por trimestre. http://apis.datos.gob.ar/series/api/series/?limit=1000&collapse=quarter&ids=116.3_TCRMA_0_M_36,116.3_TCRC_0_M_22,116.3_TCRB_0_M_23&format=csv Cambiar la funci\u00f3n de agregaci\u00f3n temporal Por default, cuando la API hace agregaciones temporales (ie. convertir una serie mensual en trimestral) hace un promedio de los valores de cada per\u00edodo . Esta funci\u00f3n de agregaci\u00f3n se puede cambiar para toda la consulta con el par\u00e1metro collapse_aggregation , o para cada serie en particular (suma, m\u00e1ximo, m\u00ednimo, etc.). Tipo de cambio. Valores diarios a cierre de cada mes. https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26&collapse=month&collapse_aggregation=end_of_period&format=csv Tipo de cambio. Valores diarios m\u00ednimo, promedio, m\u00e1ximo y cierre de cada mes. https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26:min,168.1_T_CAMBIOR_D_0_0_26:avg,168.1_T_CAMBIOR_D_0_0_26:max,168.1_T_CAMBIOR_D_0_0_26:end_of_period&collapse=month&format=csv&limit=1000 Aplicar transformaciones Las series de pueden transformar en otras unidades (variaci\u00f3n porcentual, variaci\u00f3n interanual, etc.) en forma individual o conjunta, usando el par\u00e1metro representation_mode . Tipo de cambio, IPC n\u00facleo e IPC nivel general desde Enero de 2016. Variaci\u00f3n porcentual de valores mensuales, respecto del per\u00edodo anterior. https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26,103.1_I2N_2016_M_15,103.1_I2N_2016_M_19&collapse=month&format=csv&start_date=2016-01&representation_mode=percent_change IPC n\u00facleo, IPC n\u00facleo (variaci\u00f3n porcentual per\u00edodo a per\u00edodo) e IPC n\u00facleo (variaci\u00f3n porcentual interanual) desde Enero de 2016. Valores mensuales. Nota: series con unidades de diferentes escalas, pueden ser dif\u00edciles de visualizar en un mismo gr\u00e1fico. https://apis.datos.gob.ar/series/api/series?ids=103.1_I2N_2016_M_15,103.1_I2N_2016_M_15:percent_change,103.1_I2N_2016_M_15:percent_change_a_year_ago&start_date=2016-01&format=csv&limit=1000 Aplicar transformaciones y cambiar la funci\u00f3n de agregaci\u00f3n temporal en series individuales, a la vez Es posible aplicar a las series individuales tanto una transformaci\u00f3n como una funci\u00f3n de agregaci\u00f3n particular a la vez . En todos los casos, siempre se aplica primero la funci\u00f3n de agregaci\u00f3n y luego la transformaci\u00f3n . Tipo de cambio. Variaci\u00f3n porcentual de valores diarios a cierre de cada mes, respecto del per\u00edodo anterior. http://apis.datos.gob.ar/series/api/series/?limit=1000&collapse=month&ids=168.1_T_CAMBIOR_D_0_0_26:end_of_period:percent_change&format=csv","title":"Filtrar y transformar las series"},{"location":"additional-parameters/#filtrar-y-transformar-las-series","text":"Descargar una tabla con una o varias series Filtrar por fechas Cambiar la agregaci\u00f3n temporal Cambiar la funci\u00f3n de agregaci\u00f3n temporal Aplicar transformaciones Aplicar transformaciones y cambiar la funci\u00f3n de agregaci\u00f3n temporal en series individuales, a la vez","title":"Filtrar y transformar las series"},{"location":"additional-parameters/#descargar-una-tabla-con-una-o-varias-series","text":"El par\u00e1metro ids permite la consulta simult\u00e1nea de hasta 40 series a la vez , separadas por comas. IPC por categor\u00edas http://apis.datos.gob.ar/series/api/series/?ids=103.1_I2N_2016_M_15,101.1_I2NG_2016_M_22,102.1_I2S_ABRI_M_18,102.1_I2B_ABRI_M_15,103.1_I2R_2016_M_18,103.1_I2E_2016_M_21&format=csv","title":"Descargar una tabla con una o varias series"},{"location":"additional-parameters/#filtrar-por-fechas","text":"Los par\u00e1metros start_date y end_date permiten limitar una consulta a todos aquellos valores posteriores o anteriores (respectivamente) a una fecha determinada. Tipo de cambio desde Enero de 2016 https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26&start_date=2016-01&limit=1000&format=csv Tipo de cambio hasta Diciembre de 2016 https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26&end_date=2016-12&format=csv Tipo de cambio desde Enero de 2016 hasta Diciembre de 2016 https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26&start_date=2016-01&end_date=2016-12&format=csv","title":"Filtrar por fechas"},{"location":"additional-parameters/#cambiar-la-agregacion-temporal","text":"Por default, las series se muestran en la frecuencia m\u00e1s alta posible (esta es, la frecuencia m\u00e1s baja de todas las series consultadas a la vez). El par\u00e1metro collapse permite elegir una frecuencia m\u00e1s baja que esta. \u00cdndice de Tipo de Cambio Real Multilateral, China y Brasil. Valores mensuales promediados por trimestre. http://apis.datos.gob.ar/series/api/series/?limit=1000&collapse=quarter&ids=116.3_TCRMA_0_M_36,116.3_TCRC_0_M_22,116.3_TCRB_0_M_23&format=csv","title":"Cambiar la agregaci\u00f3n temporal"},{"location":"additional-parameters/#cambiar-la-funcion-de-agregacion-temporal","text":"Por default, cuando la API hace agregaciones temporales (ie. convertir una serie mensual en trimestral) hace un promedio de los valores de cada per\u00edodo . Esta funci\u00f3n de agregaci\u00f3n se puede cambiar para toda la consulta con el par\u00e1metro collapse_aggregation , o para cada serie en particular (suma, m\u00e1ximo, m\u00ednimo, etc.). Tipo de cambio. Valores diarios a cierre de cada mes. https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26&collapse=month&collapse_aggregation=end_of_period&format=csv Tipo de cambio. Valores diarios m\u00ednimo, promedio, m\u00e1ximo y cierre de cada mes. https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26:min,168.1_T_CAMBIOR_D_0_0_26:avg,168.1_T_CAMBIOR_D_0_0_26:max,168.1_T_CAMBIOR_D_0_0_26:end_of_period&collapse=month&format=csv&limit=1000","title":"Cambiar la funci\u00f3n de agregaci\u00f3n temporal"},{"location":"additional-parameters/#aplicar-transformaciones","text":"Las series de pueden transformar en otras unidades (variaci\u00f3n porcentual, variaci\u00f3n interanual, etc.) en forma individual o conjunta, usando el par\u00e1metro representation_mode . Tipo de cambio, IPC n\u00facleo e IPC nivel general desde Enero de 2016. Variaci\u00f3n porcentual de valores mensuales, respecto del per\u00edodo anterior. https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26,103.1_I2N_2016_M_15,103.1_I2N_2016_M_19&collapse=month&format=csv&start_date=2016-01&representation_mode=percent_change IPC n\u00facleo, IPC n\u00facleo (variaci\u00f3n porcentual per\u00edodo a per\u00edodo) e IPC n\u00facleo (variaci\u00f3n porcentual interanual) desde Enero de 2016. Valores mensuales. Nota: series con unidades de diferentes escalas, pueden ser dif\u00edciles de visualizar en un mismo gr\u00e1fico. https://apis.datos.gob.ar/series/api/series?ids=103.1_I2N_2016_M_15,103.1_I2N_2016_M_15:percent_change,103.1_I2N_2016_M_15:percent_change_a_year_ago&start_date=2016-01&format=csv&limit=1000","title":"Aplicar transformaciones"},{"location":"additional-parameters/#aplicar-transformaciones-y-cambiar-la-funcion-de-agregacion-temporal-en-series-individuales-a-la-vez","text":"Es posible aplicar a las series individuales tanto una transformaci\u00f3n como una funci\u00f3n de agregaci\u00f3n particular a la vez . En todos los casos, siempre se aplica primero la funci\u00f3n de agregaci\u00f3n y luego la transformaci\u00f3n . Tipo de cambio. Variaci\u00f3n porcentual de valores diarios a cierre de cada mes, respecto del per\u00edodo anterior. http://apis.datos.gob.ar/series/api/series/?limit=1000&collapse=month&ids=168.1_T_CAMBIOR_D_0_0_26:end_of_period:percent_change&format=csv","title":"Aplicar transformaciones y cambiar la funci\u00f3n de agregaci\u00f3n temporal en series individuales, a la vez"},{"location":"applications/","text":"Aplicaciones Lista de proyectos y aplicaciones que utilizan, extienden o documentan la API de Series de Tiempo. Propias datosgobar/series-tiempo-ar-landing : Tablero web modular y parametrizado para armar un dashboard de indicadores con datos y gr\u00e1ficos, basado en la API de Series de Tiempo. datosgobar/series-tiempo-ar-call-generator : Form liviano y sencillo para generar llamadas a la API de Series de Tiempo. De terceros fmgarciadiaz/PortalHacienda : Interface en R para usar la API por @fergd1978 . http://series-de-tiempo-ar-graficos.netlify.com/ : Navegador y visualizador web de series por @SoyYoConBonete_ . Contacto \u00bfDesarrollaste una librer\u00eda o ten\u00e9s un proyecto que usa la API? Te invitamos a contarnos as\u00ed la agregamos a esta lista. Para todo lo dem\u00e1s, pod\u00e9s mandarnos tu comentario o consulta a datos@modernizacion.gob.ar .","title":"Aplicaciones"},{"location":"applications/#aplicaciones","text":"Lista de proyectos y aplicaciones que utilizan, extienden o documentan la API de Series de Tiempo.","title":"Aplicaciones"},{"location":"applications/#propias","text":"datosgobar/series-tiempo-ar-landing : Tablero web modular y parametrizado para armar un dashboard de indicadores con datos y gr\u00e1ficos, basado en la API de Series de Tiempo. datosgobar/series-tiempo-ar-call-generator : Form liviano y sencillo para generar llamadas a la API de Series de Tiempo.","title":"Propias"},{"location":"applications/#de-terceros","text":"fmgarciadiaz/PortalHacienda : Interface en R para usar la API por @fergd1978 . http://series-de-tiempo-ar-graficos.netlify.com/ : Navegador y visualizador web de series por @SoyYoConBonete_ .","title":"De terceros"},{"location":"applications/#contacto","text":"\u00bfDesarrollaste una librer\u00eda o ten\u00e9s un proyecto que usa la API? Te invitamos a contarnos as\u00ed la agregamos a esta lista. Para todo lo dem\u00e1s, pod\u00e9s mandarnos tu comentario o consulta a datos@modernizacion.gob.ar .","title":"Contacto"},{"location":"dumps/","text":"Se encuentran disponibles varios archivos con los mismos datos de la base de series de tiempo disponibles a trav\u00e9s de la API. Los datos est\u00e1n para descargar en cuatro formatos: CSV XLSX SQL (Una base de datos SQLITE) DTA Existen varios paquetes de datos por cada formato: Valores y metadatos desagregados: Contiene a la base entera de datos, junto con los metadatos de las series en cada indicador S\u00f3lo valores: Contiene a la base entera de datos, con una cantidad de metadatos de las series reducida respecto al paquete anterior Metadatos: Contiene a todos los metadatos de cada serie de tiempo en la base. No contiene datos (indicadores) de las series. Fuentes: Indicadores sobre las fuentes de datos disponibles en la base. Puede resultar \u00fatil como punto de partida para buscar series. Links de descarga Los dumps de la base de datos entera est\u00e1n disponibles bajo la siguiente ruta: https://apis.datos.gob.ar/series/api/dump/:dump Donde :dump puede ser uno de los siguientes archivos: Formato CSV: series-tiempo-csv.zip series-tiempo-valores-csv.zip series-tiempo-metadatos.csv series-tiempo-fuentes.csv Formato XLSX: series-tiempo.xlsx series-tiempo-valores.xlsx series-tiempo-metadatos.xlsx series-tiempo-fuentes.xlsx Formato SQL: La base de datos en SQL contiene a estos paquetes como tablas, todas en un \u00fanico archivo. series-tiempo-sqlite.zip Formato DTA: series-tiempo-valores-dta.zip series-tiempo-metadatos.dta series-tiempo-fuentes.dta Notar que para el formato DTA no se disponibiliza la distribuci\u00f3n con valores y metadatos desagregados. Por ejemplo, la base de series de tiempo entera, junto con varios metadatos de las series, en formato XLSX, se encuentra disponible bajo https://apis.datos.gob.ar/series/api/dump/series-tiempo.xlsx Dumps por cat\u00e1logo A su vez, tambi\u00e9n existen versiones de los datos desagregados seg\u00fan el cat\u00e1logo de origen. Se encuentran en la siguiente URL de descarga: https://apis.datos.gob.ar/series/api/dump/:catalog/:dump Los cat\u00e1logos se pueden consultar bajo el siguiente endpoint de la API de b\u00fasqueda: https://apis.datos.gob.ar/series/api/search/catalog_id/ Por ejemplo, para consultar las fuentes del cat\u00e1logo sspm (de la Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica del Ministerio de Hacienda de la Naci\u00f3n), en formato XLSX, se puede acceder en la siguiente URL: https://apis.datos.gob.ar/series/api/dump/sspm/series-tiempo-fuentes.xlsx","title":"Descargar la base completa de series de tiempo"},{"location":"dumps/#links-de-descarga","text":"Los dumps de la base de datos entera est\u00e1n disponibles bajo la siguiente ruta: https://apis.datos.gob.ar/series/api/dump/:dump Donde :dump puede ser uno de los siguientes archivos: Formato CSV: series-tiempo-csv.zip series-tiempo-valores-csv.zip series-tiempo-metadatos.csv series-tiempo-fuentes.csv Formato XLSX: series-tiempo.xlsx series-tiempo-valores.xlsx series-tiempo-metadatos.xlsx series-tiempo-fuentes.xlsx Formato SQL: La base de datos en SQL contiene a estos paquetes como tablas, todas en un \u00fanico archivo. series-tiempo-sqlite.zip Formato DTA: series-tiempo-valores-dta.zip series-tiempo-metadatos.dta series-tiempo-fuentes.dta Notar que para el formato DTA no se disponibiliza la distribuci\u00f3n con valores y metadatos desagregados. Por ejemplo, la base de series de tiempo entera, junto con varios metadatos de las series, en formato XLSX, se encuentra disponible bajo https://apis.datos.gob.ar/series/api/dump/series-tiempo.xlsx","title":"Links de descarga"},{"location":"dumps/#dumps-por-catalogo","text":"A su vez, tambi\u00e9n existen versiones de los datos desagregados seg\u00fan el cat\u00e1logo de origen. Se encuentran en la siguiente URL de descarga: https://apis.datos.gob.ar/series/api/dump/:catalog/:dump Los cat\u00e1logos se pueden consultar bajo el siguiente endpoint de la API de b\u00fasqueda: https://apis.datos.gob.ar/series/api/search/catalog_id/ Por ejemplo, para consultar las fuentes del cat\u00e1logo sspm (de la Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica del Ministerio de Hacienda de la Naci\u00f3n), en formato XLSX, se puede acceder en la siguiente URL: https://apis.datos.gob.ar/series/api/dump/sspm/series-tiempo-fuentes.xlsx","title":"Dumps por cat\u00e1logo"},{"location":"history/","text":"Historial de versiones 1.12.1 Revert al uso de metadatos de consultas en el endpoint de b\u00fasqueda Revert al conteo de series en cada filtro de metadatos. Nuevo par\u00e1metro para /search : aggregations muestra el conteo de series relevantes para la b\u00fasqueda dada, desagregadas seg\u00fan los varios filtros posibles 1.12.0 Bugfixes en indexaci\u00f3n y respuesta de API series (#471, #473, #474) Administraci\u00f3n de unidades de series, con atributo de si son porcentuales Conteo de series en cada filtro de metadatos Actualizaci\u00f3n de validaciones de series durante la indexaci\u00f3n 1.11.0 Metadatos de consultas de las series: rutina de c\u00e1lculo diaria, uso en dumps y en resultados de b\u00fasqueda de series 1.10.0 Nuevos metadatos de series: representation_mode y representation_mode_units Borrado del croneado de tareas usado para metadatos, analytics y test de integraci\u00f3n. Su funcionalidad qued\u00f3 deprecada por Synchronizer de django_datajsonar . 1.9.0 Bump de la versi\u00f3n de django_datajsonar a 0.1.17, con mejoras de UX de Synchronizers Bump de la versi\u00f3n de series-tiempo-ar a 0.2.1, con una validaci\u00f3n adicional para permitir distribuciones con series vac\u00edas, hasta cierta proporci\u00f3n. Agregados nuevos metadatos de series ( metadata=full o metadata=only ): max_value , min_value , average 1.8.0 Integraci\u00f3n con django_datajsonar: Uso de Synchronizers y Stages para correr tareas asincr\u00f3nicas de manera ordenada 1.7.0 Optimizaciones de performance en dumps CSV Indexaci\u00f3n de datos: siempre se reindexan completamente las distribuciones ( refresh ) Test de integraci\u00f3n y consistencia de los datos, a correr despu\u00e9s de la indexaci\u00f3n diaria. Bugfix de series sin datos cuando eran pedidas en un solo request Traducci\u00f3n parcial del panel de administraci\u00f3n a espa\u00f1ol 1.6.0 Release con herramientas de administraci\u00f3n para \"refrescar\" distribuciones de datos inconsistentes con su fuente. 1.5.1 Correcciones a dumps: Header faltante en hojas adicionales en dump XLSX Columnas y nombres de una tabla de dumps SQL Bugfix de generaci\u00f3n de dump global XLSX Mejoras de organizaci\u00f3n en el admin de django 1.5.0 Nuevo par\u00e1metro last . Ver documentaci\u00f3n Permito trailing slashes en URLs de descarga de dumps 1.4.3 Fix de estabilidad de generaci\u00f3n de dumps en general. 1.4.2 Fix a tasks asincr\u00f3nicas de dumps no corriendo correctamente cuando son generadas desde el admin 1.4.0 Orden a filas de dump de metadatos No es m\u00e1s necesario setear dataset_identifier en distributciones para ser indexadas Se permiten csvs de distribuciones con encoding distinto a utf-8 1.3.3 Callables de rqscheduler para dumps CSV y XLSX. 1.3.2 Optimizaciones de memoria de generaci\u00f3n dumps xlsx 1.3.1 Peque\u00f1o release con un fix a parseo de URLs de descarga de distribuciones 1.3.0 hotfix 2 Hotfix para servir files de minio desde una ruta interna de la aplicaci\u00f3n 1.3.0 hotfix 1 Hotfixes de logging de dump 1.3.0 Nueva generaci\u00f3n de dumps en CSV, usando los datos cargados en postgres, y generando dumps individuales por cat\u00e1logo. Borrado de datos en el endpoint de /search/ cuando una serie se borra de la base de datos 1.2.1 Refactor e integraci\u00f3n de generaci\u00f3n de dumps de la base de datos de series de tiempo, para utilizar postgres en vez de Elasticsearch e integrar los archivos al filesystem distribuido 1.2.0 Adopci\u00f3n de semver como sistema de versionado File system distribuido (minio) Optimizaciones en la UI del admin Display de mensajes de error en reportes de indexaci\u00f3n 1.1.8 Correcciones en importado de analytics para adaptarse a la nueva API paginada con cursor en api mgmt 1.1.7 Cambio de nombres de respuesta de metadatos. Fixes de usabilidad del admin relacionado a administradores de nodos. Bugfixes en respuesta de /series 1.1.6 Se aumenta el l\u00edmite de series m\u00e1ximas por request a 40 Revisi\u00f3n de nombres y agregado de metadatos en la respuesta de /series Cambio de nombre de par\u00e1metro de /search: offset -> start para consistencia con /series 1.1.5 An\u00e1lisis y tokenizaci\u00f3n de texto para la b\u00fasqueda de metadatos en /search. Permite reconocer palabras sin acento, entre otras cosas. Muestra de metadatos enriquecidos de las series pedidas en /series, cuando se pide la respuesta con metadata=full o metadata=only. Actualmente todos los valores devueltos son de tipo string, sujeto a cambios a futuro. 1.1.4 Modificaci\u00f3n de la respuesta de metadatos en search/: se agregan campos dataset.theme, dataset.source y field.units. Adem\u00e1s se cambia la respuesta de field.periodicity de formato legible por humanos a ISO8601 1.1.3 Actualizaciones de django_datajsonar Se agregan aliases de cat\u00e1logos para metadatos. Se puede configurar un alias para los filtros catalog_id que sea equivalente a filtrar por uno o m\u00e1s cat\u00e1logos. 1.1.2 Funcionalidades de importado hist\u00f3rico de analytics, y ampliaci\u00f3n de los datos guardados de cada query 1.1.1 Validaci\u00f3n de cat\u00e1logos le\u00eddos al generar reporte Fixes a los valores de reportes Fix de metadatos enriquecidos no mostr\u00e1ndose bien en /search/ 1.1.0 Nuevo formato de respuesta de metadatos tanto en /series como en /search Mejoras en visualizaciones del admin de django 1.0.18 Mejoras al endpoint de b\u00fasqueda: nuevo par\u00e1metro catalog_id Mejoras al indexado de metadatos Configuraci\u00f3n de importado de analytics desde un API gateway 1.0.17 Se pasa a usar django_datajsonar como dependencia directa para manejar las entidades procesadas de data.json de los nodos 1.0.16-1 Actualizaci\u00f3n de dependencias pydatajson==0.4.12 1.0.16 Actualizaci\u00f3n de validaciones para indexaci\u00f3n 1.0.15 Release con: Resumen de reporte de indexaci\u00f3n Detalle de cada entidad indexada como archivos adjuntos en el reporte Reimplementaci\u00f3n de aggregations max y min Fechas en el dump de analytics se exportan en horario local 1.0.14 Mejoras al formato del reporte de indexaci\u00f3n, junto con mensajes de error m\u00e1s descriptivos 1.0.13 Hotfix con fixes a comportamiento err\u00f3neo en queries de dos series iguales con distinto modo de representaci\u00f3n + uso de caracter decimal no default 1.0.12 Release con: Permite generar reportes de indexaci\u00f3n individuales por nodo Fixes a valores de los reportes (datasets actualizados, no actualizados) Mejoras de performance de la indexaci\u00f3n de metadatos 1.0.11 Generaci\u00f3n de reporte de indexaci\u00f3n completo: Nuevos fields para cat\u00e1logos, datasets, distribuciones y series. 1.0.10 Mejoras en la generaci\u00f3n de reportes de indexaci\u00f3n, con m\u00e1s campos reportados. 1.0.9 Mostrado de versi\u00f3n en la p\u00e1gina principal del admin de Django Mejora del proceso de indexaci\u00f3n y persistencia de las m\u00e9tricas obtenidas Bugfix para permitir que las series de tiempo puedan cambiar de distribuci\u00f3n dentro de un mismo cat\u00e1logo 1.0.8 Bugfixes: Correcciones a llamadas de series m\u00faltiples en orden descendiente Permito la exportaci\u00f3n correcta de analytics a CSV en vol\u00famenes grandes Correcciones a guardados de analytics err\u00f3neos 1.0.7 Endpoint de b\u00fasqueda de series: /search 1.0.6 Fixes a herramientas de administraci\u00f3n: No se indexan metadatos de series y distribuciones pertenecientes a cat\u00e1logos no marcados como indexables Finalizaci\u00f3n autom\u00e1tica de la tarea de indexaci\u00f3n si no hay datasets marcados como indexable Arreglos a borrados de croneado de tareas de indexaci\u00f3n 1.0.3 Herramientas de administraci\u00f3n: Configuraci\u00f3n de que nodos y datasets se deben indexar Configuraci\u00f3n del croneado de la tarea de indexaci\u00f3n Generaci\u00f3n de reportes de resultado de indexaci\u00f3n por mail a los administradores 1.0.0 Release inicial","title":"Historial de versiones"},{"location":"history/#historial-de-versiones","text":"","title":"Historial de versiones"},{"location":"history/#1121","text":"Revert al uso de metadatos de consultas en el endpoint de b\u00fasqueda Revert al conteo de series en cada filtro de metadatos. Nuevo par\u00e1metro para /search : aggregations muestra el conteo de series relevantes para la b\u00fasqueda dada, desagregadas seg\u00fan los varios filtros posibles","title":"1.12.1"},{"location":"history/#1120","text":"Bugfixes en indexaci\u00f3n y respuesta de API series (#471, #473, #474) Administraci\u00f3n de unidades de series, con atributo de si son porcentuales Conteo de series en cada filtro de metadatos Actualizaci\u00f3n de validaciones de series durante la indexaci\u00f3n","title":"1.12.0"},{"location":"history/#1110","text":"Metadatos de consultas de las series: rutina de c\u00e1lculo diaria, uso en dumps y en resultados de b\u00fasqueda de series","title":"1.11.0"},{"location":"history/#1100","text":"Nuevos metadatos de series: representation_mode y representation_mode_units Borrado del croneado de tareas usado para metadatos, analytics y test de integraci\u00f3n. Su funcionalidad qued\u00f3 deprecada por Synchronizer de django_datajsonar .","title":"1.10.0"},{"location":"history/#190","text":"Bump de la versi\u00f3n de django_datajsonar a 0.1.17, con mejoras de UX de Synchronizers Bump de la versi\u00f3n de series-tiempo-ar a 0.2.1, con una validaci\u00f3n adicional para permitir distribuciones con series vac\u00edas, hasta cierta proporci\u00f3n. Agregados nuevos metadatos de series ( metadata=full o metadata=only ): max_value , min_value , average","title":"1.9.0"},{"location":"history/#180","text":"Integraci\u00f3n con django_datajsonar: Uso de Synchronizers y Stages para correr tareas asincr\u00f3nicas de manera ordenada","title":"1.8.0"},{"location":"history/#170","text":"Optimizaciones de performance en dumps CSV Indexaci\u00f3n de datos: siempre se reindexan completamente las distribuciones ( refresh ) Test de integraci\u00f3n y consistencia de los datos, a correr despu\u00e9s de la indexaci\u00f3n diaria. Bugfix de series sin datos cuando eran pedidas en un solo request Traducci\u00f3n parcial del panel de administraci\u00f3n a espa\u00f1ol","title":"1.7.0"},{"location":"history/#160","text":"Release con herramientas de administraci\u00f3n para \"refrescar\" distribuciones de datos inconsistentes con su fuente.","title":"1.6.0"},{"location":"history/#151","text":"Correcciones a dumps: Header faltante en hojas adicionales en dump XLSX Columnas y nombres de una tabla de dumps SQL Bugfix de generaci\u00f3n de dump global XLSX Mejoras de organizaci\u00f3n en el admin de django","title":"1.5.1"},{"location":"history/#150","text":"Nuevo par\u00e1metro last . Ver documentaci\u00f3n Permito trailing slashes en URLs de descarga de dumps","title":"1.5.0"},{"location":"history/#143","text":"Fix de estabilidad de generaci\u00f3n de dumps en general.","title":"1.4.3"},{"location":"history/#142","text":"Fix a tasks asincr\u00f3nicas de dumps no corriendo correctamente cuando son generadas desde el admin","title":"1.4.2"},{"location":"history/#140","text":"Orden a filas de dump de metadatos No es m\u00e1s necesario setear dataset_identifier en distributciones para ser indexadas Se permiten csvs de distribuciones con encoding distinto a utf-8","title":"1.4.0"},{"location":"history/#133","text":"Callables de rqscheduler para dumps CSV y XLSX.","title":"1.3.3"},{"location":"history/#132","text":"Optimizaciones de memoria de generaci\u00f3n dumps xlsx","title":"1.3.2"},{"location":"history/#131","text":"Peque\u00f1o release con un fix a parseo de URLs de descarga de distribuciones","title":"1.3.1"},{"location":"history/#130-hotfix-2","text":"Hotfix para servir files de minio desde una ruta interna de la aplicaci\u00f3n","title":"1.3.0 hotfix 2"},{"location":"history/#130-hotfix-1","text":"Hotfixes de logging de dump","title":"1.3.0 hotfix 1"},{"location":"history/#130","text":"Nueva generaci\u00f3n de dumps en CSV, usando los datos cargados en postgres, y generando dumps individuales por cat\u00e1logo. Borrado de datos en el endpoint de /search/ cuando una serie se borra de la base de datos","title":"1.3.0"},{"location":"history/#121","text":"Refactor e integraci\u00f3n de generaci\u00f3n de dumps de la base de datos de series de tiempo, para utilizar postgres en vez de Elasticsearch e integrar los archivos al filesystem distribuido","title":"1.2.1"},{"location":"history/#120","text":"Adopci\u00f3n de semver como sistema de versionado File system distribuido (minio) Optimizaciones en la UI del admin Display de mensajes de error en reportes de indexaci\u00f3n","title":"1.2.0"},{"location":"history/#118","text":"Correcciones en importado de analytics para adaptarse a la nueva API paginada con cursor en api mgmt","title":"1.1.8"},{"location":"history/#117","text":"Cambio de nombres de respuesta de metadatos. Fixes de usabilidad del admin relacionado a administradores de nodos. Bugfixes en respuesta de /series","title":"1.1.7"},{"location":"history/#116","text":"Se aumenta el l\u00edmite de series m\u00e1ximas por request a 40 Revisi\u00f3n de nombres y agregado de metadatos en la respuesta de /series Cambio de nombre de par\u00e1metro de /search: offset -> start para consistencia con /series","title":"1.1.6"},{"location":"history/#115","text":"An\u00e1lisis y tokenizaci\u00f3n de texto para la b\u00fasqueda de metadatos en /search. Permite reconocer palabras sin acento, entre otras cosas. Muestra de metadatos enriquecidos de las series pedidas en /series, cuando se pide la respuesta con metadata=full o metadata=only. Actualmente todos los valores devueltos son de tipo string, sujeto a cambios a futuro.","title":"1.1.5"},{"location":"history/#114","text":"Modificaci\u00f3n de la respuesta de metadatos en search/: se agregan campos dataset.theme, dataset.source y field.units. Adem\u00e1s se cambia la respuesta de field.periodicity de formato legible por humanos a ISO8601","title":"1.1.4"},{"location":"history/#113","text":"Actualizaciones de django_datajsonar Se agregan aliases de cat\u00e1logos para metadatos. Se puede configurar un alias para los filtros catalog_id que sea equivalente a filtrar por uno o m\u00e1s cat\u00e1logos.","title":"1.1.3"},{"location":"history/#112","text":"Funcionalidades de importado hist\u00f3rico de analytics, y ampliaci\u00f3n de los datos guardados de cada query","title":"1.1.2"},{"location":"history/#111","text":"Validaci\u00f3n de cat\u00e1logos le\u00eddos al generar reporte Fixes a los valores de reportes Fix de metadatos enriquecidos no mostr\u00e1ndose bien en /search/","title":"1.1.1"},{"location":"history/#110","text":"Nuevo formato de respuesta de metadatos tanto en /series como en /search Mejoras en visualizaciones del admin de django","title":"1.1.0"},{"location":"history/#1018","text":"Mejoras al endpoint de b\u00fasqueda: nuevo par\u00e1metro catalog_id Mejoras al indexado de metadatos Configuraci\u00f3n de importado de analytics desde un API gateway","title":"1.0.18"},{"location":"history/#1017","text":"Se pasa a usar django_datajsonar como dependencia directa para manejar las entidades procesadas de data.json de los nodos","title":"1.0.17"},{"location":"history/#1016-1","text":"Actualizaci\u00f3n de dependencias pydatajson==0.4.12","title":"1.0.16-1"},{"location":"history/#1016","text":"Actualizaci\u00f3n de validaciones para indexaci\u00f3n","title":"1.0.16"},{"location":"history/#1015","text":"Release con: Resumen de reporte de indexaci\u00f3n Detalle de cada entidad indexada como archivos adjuntos en el reporte Reimplementaci\u00f3n de aggregations max y min Fechas en el dump de analytics se exportan en horario local","title":"1.0.15"},{"location":"history/#1014","text":"Mejoras al formato del reporte de indexaci\u00f3n, junto con mensajes de error m\u00e1s descriptivos","title":"1.0.14"},{"location":"history/#1013","text":"Hotfix con fixes a comportamiento err\u00f3neo en queries de dos series iguales con distinto modo de representaci\u00f3n + uso de caracter decimal no default","title":"1.0.13"},{"location":"history/#1012","text":"Release con: Permite generar reportes de indexaci\u00f3n individuales por nodo Fixes a valores de los reportes (datasets actualizados, no actualizados) Mejoras de performance de la indexaci\u00f3n de metadatos","title":"1.0.12"},{"location":"history/#1011","text":"Generaci\u00f3n de reporte de indexaci\u00f3n completo: Nuevos fields para cat\u00e1logos, datasets, distribuciones y series.","title":"1.0.11"},{"location":"history/#1010","text":"Mejoras en la generaci\u00f3n de reportes de indexaci\u00f3n, con m\u00e1s campos reportados.","title":"1.0.10"},{"location":"history/#109","text":"Mostrado de versi\u00f3n en la p\u00e1gina principal del admin de Django Mejora del proceso de indexaci\u00f3n y persistencia de las m\u00e9tricas obtenidas Bugfix para permitir que las series de tiempo puedan cambiar de distribuci\u00f3n dentro de un mismo cat\u00e1logo","title":"1.0.9"},{"location":"history/#108","text":"Bugfixes: Correcciones a llamadas de series m\u00faltiples en orden descendiente Permito la exportaci\u00f3n correcta de analytics a CSV en vol\u00famenes grandes Correcciones a guardados de analytics err\u00f3neos","title":"1.0.8"},{"location":"history/#107","text":"Endpoint de b\u00fasqueda de series: /search","title":"1.0.7"},{"location":"history/#106","text":"Fixes a herramientas de administraci\u00f3n: No se indexan metadatos de series y distribuciones pertenecientes a cat\u00e1logos no marcados como indexables Finalizaci\u00f3n autom\u00e1tica de la tarea de indexaci\u00f3n si no hay datasets marcados como indexable Arreglos a borrados de croneado de tareas de indexaci\u00f3n","title":"1.0.6"},{"location":"history/#103","text":"Herramientas de administraci\u00f3n: Configuraci\u00f3n de que nodos y datasets se deben indexar Configuraci\u00f3n del croneado de la tarea de indexaci\u00f3n Generaci\u00f3n de reportes de resultado de indexaci\u00f3n por mail a los administradores","title":"1.0.3"},{"location":"history/#100","text":"Release inicial","title":"1.0.0"},{"location":"python-usage/","text":"Usar en python Con requests Con pandas Con requests Armar una funci\u00f3n wrapper que facilite construir llamadas a la API. import requests import urllib.parse def get_api_call ( ids , ** kwargs ): API_BASE_URL = \"https://apis.datos.gob.ar/series/api/\" kwargs [ \"ids\" ] = \",\" . join ( ids ) return \"{}{}?{}\" . format ( API_BASE_URL , \"series\" , urllib . parse . urlencode ( kwargs )) Una llamada v\u00e1lida a la API debe tener por lo menos un id de una serie v\u00e1lida, y luego puede tener par\u00e1metros opcionales. api_call = get_api_call ([ \"168.1_T_CAMBIOR_D_0_0_26\" ], start_date = \"2018-08\" ) print ( api_call ) https : // apis . datos . gob . ar / series / api / series ? start_date = 2018 - 08 & ids = 168.1 _T_CAMBIOR_D_0_0_26 Obtener la respuesta en un diccionario. result = requests . get ( api_call ) . json () print ( result ) { 'data' : [[ '2018-08-01' , 27.525 ], [ '2018-08-02' , 27.45 ], [ '2018-08-03' , 27.29 ], [ '2018-08-04' , 27.29 ], [ '2018-08-05' , 27.29 ], [ '2018-08-06' , 27.33 ], [ '2018-08-07' , 27.395 ], [ '2018-08-08' , 27.65 ], [ '2018-08-09' , 28.11 ], [ '2018-08-10' , 29.25 ], [ '2018-08-11' , 29.25 ], [ '2018-08-12' , 29.25 ], [ '2018-08-13' , 29.925 ], [ '2018-08-14' , 29.61 ], [ '2018-08-15' , 30.0 ], [ '2018-08-16' , 29.84 ]], 'meta' : [{ 'end_date' : '2018-08-16' , 'frequency' : 'day' , 'start_date' : '2018-08-01' }, { 'catalog' : { 'title' : 'Datos Programaci\u00f3n Macroecon\u00f3mica' }, 'dataset' : { 'description' : 'Datos de tipo de cambio $-USD - futuro d\u00f3lar . Con respecto al d\u00f3lar de Estados Unidos. Frecuencia diaria.' , 'issued' : '2017-09-28' , 'source' : 'BCRA, MAE, Rofex y Bloomberg' , 'title' : 'Tipo de Cambio $-USD - Futuro D\u00f3lar' }, 'distribution' : { 'downloadURL' : 'http://infra.datos.gob.ar/catalog/sspm/dataset/168/distribution/168.1/download/datos-tipo-cambio-usd-futuro-dolar-frecuencia-diaria.csv' , 'title' : 'Tipo de cambio $-USD - futuro d\u00f3lar. Valores diarios' }, 'field' : { 'description' : 'Tipo de Cambio BNA (Vendedor)' , 'id' : '168.1_T_CAMBIOR_D_0_0_26' , 'units' : 'Pesos argentinos por d\u00f3lar' }}], 'params' : { 'identifiers' : [{ 'dataset' : '168' , 'distribution' : '168.1' , 'id' : '168.1_T_CAMBIOR_D_0_0_26' }], 'ids' : '168.1_T_CAMBIOR_D_0_0_26' , 'start_date' : '2018-08' }} Con pandas Las llamadas a la API en CSV se pueden leer directamente a un pandas.DataFrame . import pandas as pd df = pd . read_csv ( get_api_call ( [ \"168.1_T_CAMBIOR_D_0_0_26\" , \"101.1_I2NG_2016_M_22\" , \"116.3_TCRMA_0_M_36\" , \"143.3_NO_PR_2004_A_21\" , \"11.3_VMATC_2004_M_12\" ], format = \"csv\" , start_date = 2018 )) indice_tiempo tipo_cambio_bna_vendedor ipc_2016_nivel_general \\ 2018-01-01 19.023065 127.0147 2018-02-01 19.835179 130.2913 2018-03-01 20.229355 133.5028 2018-04-01 20.251100 136.9380 2018-05-01 23.600452 139.5800 2018-06-01 26.674333 145.0582 2018-07-01 27.607645 149.1178 tipo_cambio_real_multilateral_actual indice_serie_original construccion 96.628715 144.086686 158.920762 96.121512 138.470530 152.630381 93.062453 155.570021 158.931156 90.715862 152.432629 149.860484 104.302984 160.622476 154.011846 114.546258 NaN NaN 107.105698 NaN NaN","title":"Usar en python"},{"location":"python-usage/#usar-en-python","text":"Con requests Con pandas","title":"Usar en python"},{"location":"python-usage/#con-requests","text":"Armar una funci\u00f3n wrapper que facilite construir llamadas a la API. import requests import urllib.parse def get_api_call ( ids , ** kwargs ): API_BASE_URL = \"https://apis.datos.gob.ar/series/api/\" kwargs [ \"ids\" ] = \",\" . join ( ids ) return \"{}{}?{}\" . format ( API_BASE_URL , \"series\" , urllib . parse . urlencode ( kwargs )) Una llamada v\u00e1lida a la API debe tener por lo menos un id de una serie v\u00e1lida, y luego puede tener par\u00e1metros opcionales. api_call = get_api_call ([ \"168.1_T_CAMBIOR_D_0_0_26\" ], start_date = \"2018-08\" ) print ( api_call ) https : // apis . datos . gob . ar / series / api / series ? start_date = 2018 - 08 & ids = 168.1 _T_CAMBIOR_D_0_0_26 Obtener la respuesta en un diccionario. result = requests . get ( api_call ) . json () print ( result ) { 'data' : [[ '2018-08-01' , 27.525 ], [ '2018-08-02' , 27.45 ], [ '2018-08-03' , 27.29 ], [ '2018-08-04' , 27.29 ], [ '2018-08-05' , 27.29 ], [ '2018-08-06' , 27.33 ], [ '2018-08-07' , 27.395 ], [ '2018-08-08' , 27.65 ], [ '2018-08-09' , 28.11 ], [ '2018-08-10' , 29.25 ], [ '2018-08-11' , 29.25 ], [ '2018-08-12' , 29.25 ], [ '2018-08-13' , 29.925 ], [ '2018-08-14' , 29.61 ], [ '2018-08-15' , 30.0 ], [ '2018-08-16' , 29.84 ]], 'meta' : [{ 'end_date' : '2018-08-16' , 'frequency' : 'day' , 'start_date' : '2018-08-01' }, { 'catalog' : { 'title' : 'Datos Programaci\u00f3n Macroecon\u00f3mica' }, 'dataset' : { 'description' : 'Datos de tipo de cambio $-USD - futuro d\u00f3lar . Con respecto al d\u00f3lar de Estados Unidos. Frecuencia diaria.' , 'issued' : '2017-09-28' , 'source' : 'BCRA, MAE, Rofex y Bloomberg' , 'title' : 'Tipo de Cambio $-USD - Futuro D\u00f3lar' }, 'distribution' : { 'downloadURL' : 'http://infra.datos.gob.ar/catalog/sspm/dataset/168/distribution/168.1/download/datos-tipo-cambio-usd-futuro-dolar-frecuencia-diaria.csv' , 'title' : 'Tipo de cambio $-USD - futuro d\u00f3lar. Valores diarios' }, 'field' : { 'description' : 'Tipo de Cambio BNA (Vendedor)' , 'id' : '168.1_T_CAMBIOR_D_0_0_26' , 'units' : 'Pesos argentinos por d\u00f3lar' }}], 'params' : { 'identifiers' : [{ 'dataset' : '168' , 'distribution' : '168.1' , 'id' : '168.1_T_CAMBIOR_D_0_0_26' }], 'ids' : '168.1_T_CAMBIOR_D_0_0_26' , 'start_date' : '2018-08' }}","title":"Con requests"},{"location":"python-usage/#con-pandas","text":"Las llamadas a la API en CSV se pueden leer directamente a un pandas.DataFrame . import pandas as pd df = pd . read_csv ( get_api_call ( [ \"168.1_T_CAMBIOR_D_0_0_26\" , \"101.1_I2NG_2016_M_22\" , \"116.3_TCRMA_0_M_36\" , \"143.3_NO_PR_2004_A_21\" , \"11.3_VMATC_2004_M_12\" ], format = \"csv\" , start_date = 2018 )) indice_tiempo tipo_cambio_bna_vendedor ipc_2016_nivel_general \\ 2018-01-01 19.023065 127.0147 2018-02-01 19.835179 130.2913 2018-03-01 20.229355 133.5028 2018-04-01 20.251100 136.9380 2018-05-01 23.600452 139.5800 2018-06-01 26.674333 145.0582 2018-07-01 27.607645 149.1178 tipo_cambio_real_multilateral_actual indice_serie_original construccion 96.628715 144.086686 158.920762 96.121512 138.470530 152.630381 93.062453 155.570021 158.931156 90.715862 152.432629 149.860484 104.302984 160.622476 154.011846 114.546258 NaN NaN 107.105698 NaN NaN","title":"Con pandas"},{"location":"quick-start/","text":"Comenzar a usar la API de Series de Tiempo 1. Buscar series En un archivo En el explorador de series 2. Armar consulta Manualmente En el generador de consultas 3. Realizar consulta Consultar o integrar JSON Descargar CSV Integrar en planilla de c\u00e1lculo Consultar en el explorador de series 1. Buscar series Para usar la API, ten\u00e9s que buscar los ids de las series que te interesan. En un archivo En datos.gob.ar pod\u00e9s encontrar la base completa de series de tiempo , que contiene la lista de series disponibles en: CSV XLSX DTA En el explorador de series En el Explorador de Series de Tiempo pod\u00e9s buscar series, visualizarlas y compartir las URLs a la API o al explorador. 2. Armar consulta Manualmente Los ids de las series deben pasarse al par\u00e1metro ids . Se pueden usar par\u00e1metros adicionales para filtrar y transformar las series . Ver la referencia API para consultar la documentaci\u00f3n completa de todos los par\u00e1metros disponibles. En el generador de consultas En el generador de consultas pod\u00e9s ver todos los par\u00e1metros disponibles en la API para armar tu consulta. 3. Realizar consulta Consultar o integrar JSON Para realizar la consulta directamente en el navegador, o integrarla en una aplicaci\u00f3n: Usar format=json (valor default). Elegir el nivel de detalle de los metadatos metadata=none , only , simple o full . https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26,103.1_I2N_2016_M_15&format=json&metadata=full Descargar CSV Para descargar un archivo CSV: Usar format=csv . https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26,103.1_I2N_2016_M_15&format=csv Integrar en planilla de c\u00e1lculo Tanto la consulta en CSV como en JSON se pueden integrar en planillas de c\u00e1lculo . Consultar en el explorador de series Cualquier llamada a la API se puede visualizar en el explorador quitando el subdominio apis de la URL (y cambiando a HTTP): Llamada a la API https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26:percent_change_a_year_ago&collapse=month Consulta en el explorador http://datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26:percent_change_a_year_ago&collapse=month","title":"Comenzar a usar la API de Series de Tiempo"},{"location":"quick-start/#comenzar-a-usar-la-api-de-series-de-tiempo","text":"1. Buscar series En un archivo En el explorador de series 2. Armar consulta Manualmente En el generador de consultas 3. Realizar consulta Consultar o integrar JSON Descargar CSV Integrar en planilla de c\u00e1lculo Consultar en el explorador de series","title":"Comenzar a usar la API de Series de Tiempo"},{"location":"quick-start/#1-buscar-series","text":"Para usar la API, ten\u00e9s que buscar los ids de las series que te interesan.","title":"1. Buscar series"},{"location":"quick-start/#en-un-archivo","text":"En datos.gob.ar pod\u00e9s encontrar la base completa de series de tiempo , que contiene la lista de series disponibles en: CSV XLSX DTA","title":"En un archivo"},{"location":"quick-start/#en-el-explorador-de-series","text":"En el Explorador de Series de Tiempo pod\u00e9s buscar series, visualizarlas y compartir las URLs a la API o al explorador.","title":"En el explorador de series"},{"location":"quick-start/#2-armar-consulta","text":"","title":"2. Armar consulta"},{"location":"quick-start/#manualmente","text":"Los ids de las series deben pasarse al par\u00e1metro ids . Se pueden usar par\u00e1metros adicionales para filtrar y transformar las series . Ver la referencia API para consultar la documentaci\u00f3n completa de todos los par\u00e1metros disponibles.","title":"Manualmente"},{"location":"quick-start/#en-el-generador-de-consultas","text":"En el generador de consultas pod\u00e9s ver todos los par\u00e1metros disponibles en la API para armar tu consulta.","title":"En el generador de consultas"},{"location":"quick-start/#3-realizar-consulta","text":"","title":"3. Realizar consulta"},{"location":"quick-start/#consultar-o-integrar-json","text":"Para realizar la consulta directamente en el navegador, o integrarla en una aplicaci\u00f3n: Usar format=json (valor default). Elegir el nivel de detalle de los metadatos metadata=none , only , simple o full . https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26,103.1_I2N_2016_M_15&format=json&metadata=full","title":"Consultar o integrar JSON"},{"location":"quick-start/#descargar-csv","text":"Para descargar un archivo CSV: Usar format=csv . https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26,103.1_I2N_2016_M_15&format=csv","title":"Descargar CSV"},{"location":"quick-start/#integrar-en-planilla-de-calculo","text":"Tanto la consulta en CSV como en JSON se pueden integrar en planillas de c\u00e1lculo .","title":"Integrar en planilla de c\u00e1lculo"},{"location":"quick-start/#consultar-en-el-explorador-de-series","text":"Cualquier llamada a la API se puede visualizar en el explorador quitando el subdominio apis de la URL (y cambiando a HTTP): Llamada a la API https://apis.datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26:percent_change_a_year_ago&collapse=month Consulta en el explorador http://datos.gob.ar/series/api/series?ids=168.1_T_CAMBIOR_D_0_0_26:percent_change_a_year_ago&collapse=month","title":"Consultar en el explorador de series"},{"location":"spreadsheet-integration/","text":"Integraci\u00f3n con planillas de c\u00e1lculo Google Drive 1. Modificar la configuraci\u00f3n regional o usar el par\u00e1metro \"decimal=,\" Usar el par\u00e1metro decimal Modificar la configuraci\u00f3n regional 2. Importar los datos a la planilla 3. Elegir el formato de fecha 4. Modificar la URL de consulta a la API Excel 0. Chequear que ten\u00e9s instalado lo que necesit\u00e1s 1. Generar una nueva consulta desde una URL 2. Editar codificaci\u00f3n del archivo origen 3. Editar los tipos de las columnas 4. Guardar las modificaciones y cargar la consulta Google Drive 1. Modificar la configuraci\u00f3n regional o usar el par\u00e1metro \"decimal=,\" Usar el par\u00e1metro decimal La API genera archivos CSV usando \".\" como separador decimal por defecto. Si tu cuenta de Google est\u00e1 configurada para Argentina / latinoam\u00e9rica, pod\u00e9s agregar a todas tus llamadas a la API el argumento &decimal=, para que los CSVs se generen con \",\" como separador decimal. https://apis.datos.gob.ar/series/api/series/?limit=1000&metadata=full&start=0&ids=143.3_NO_PR_2004_A_21&format=csv&decimal=, Ver uso del par\u00e1metro decimal en la referencia. Modificar la configuraci\u00f3n regional Para que Google Spreadsheet lea correctamente el archivo CSV por defecto, puede elegirse \u201cEstados Unidos\u201d o cualquier otra regi\u00f3n compatible como configuraci\u00f3n regional. 2. Importar los datos a la planilla La funci\u00f3n IMPORTDATA() toma la URL de la consulta a la API y trae los datos a la planilla. 3. Elegir el formato de fecha El \u00edndice de tiempo puede verse como un n\u00famero la primera vez que se importan los datos. Lo m\u00e1s conveniente es seleccionar toda la columna y elegir el formato en el que se desea visualizar la fecha. 4. Modificar la URL de consulta a la API Una vez importada la tabla por primera vez, se pueden modificar los distintos par\u00e1metros de la consulta seg\u00fan lo que se necesite. La tabla se actualizar\u00e1 con cada cambio. Excel 0. Chequear que ten\u00e9s instalado lo que necesit\u00e1s Excel 2016 : tiene todo lo necesario para integrar una URL a un CSV. Excel 2013 : necesita descargar e instalar Microsoft Power Query . Excel 2010 : necesita descargar e instalar el Service Pack 1 y luego descargar e instalar Microsoft Power Query . 1. Generar una nueva consulta desde una URL \u201cDatos\u201d > \u201cNueva consulta\u201d > \u201cDesde otras fuentes\u201d > \u201cDesde una web\u201d Nota: si Excel est\u00e1 configurado para Argentina / latinoam\u00e9rica agregar a la URL de la API &decimal=, para que los n\u00fameros decimales usen \",\" en lugar de \".\" y Excel los lea correctamente. Ver uso del par\u00e1metro decimal en la referencia. https://apis.datos.gob.ar/series/api/series/?limit=1000&metadata=full&start=0&ids=143.3_NO_PR_2004_A_21&format=csv&decimal=, 2. Editar codificaci\u00f3n del archivo origen Esto s\u00f3lo es necesario si se pide a la API usar las descripciones como nombres de las columnas ( &header=descriptions ) en lugar del texto corto que viene por defecto, formado con carateres compatibles con cualquier codificaci\u00f3n. La API genera los archivos CSV con codificaci\u00f3n \u201cUnicode UTF-8\u201d, que no es el valor por defecto de Excel y puede generar errores en los caracteres con tildes o la \"\u00f1\". Click en la rueda de \u201cOrigen\u201d > \u201cOrigen de archivo\u201d > Elegir \u201cUnicode UTF-8\u201d 3. Editar los tipos de las columnas Excel puede no interpretar correctamente las fechas cuando Excel est\u00e1 configurado para Argentina / latinoam\u00e9rica. Si este es el caso, se debe utilizar el \u201cEditor avanzado\u201d para corregir el tipo de la columna \"indice_tiempo\" que debe ser \u201ctype date\u201d. 4. Guardar las modificaciones y cargar la consulta Por \u00faltimo, haciendo click en \u201cCerrar y cargar\u201d la consulta queda configurada en una tabla de Excel que se puede actualizar.","title":"Integrar la API en planillas de c\u00e1lculo"},{"location":"spreadsheet-integration/#integracion-con-planillas-de-calculo","text":"Google Drive 1. Modificar la configuraci\u00f3n regional o usar el par\u00e1metro \"decimal=,\" Usar el par\u00e1metro decimal Modificar la configuraci\u00f3n regional 2. Importar los datos a la planilla 3. Elegir el formato de fecha 4. Modificar la URL de consulta a la API Excel 0. Chequear que ten\u00e9s instalado lo que necesit\u00e1s 1. Generar una nueva consulta desde una URL 2. Editar codificaci\u00f3n del archivo origen 3. Editar los tipos de las columnas 4. Guardar las modificaciones y cargar la consulta","title":"Integraci\u00f3n con planillas de c\u00e1lculo"},{"location":"spreadsheet-integration/#google-drive","text":"","title":"Google Drive"},{"location":"spreadsheet-integration/#1-modificar-la-configuracion-regional-o-usar-el-parametro-decimal","text":"","title":"1. Modificar la configuraci\u00f3n regional o usar el par\u00e1metro \"decimal=,\""},{"location":"spreadsheet-integration/#usar-el-parametro-decimal","text":"La API genera archivos CSV usando \".\" como separador decimal por defecto. Si tu cuenta de Google est\u00e1 configurada para Argentina / latinoam\u00e9rica, pod\u00e9s agregar a todas tus llamadas a la API el argumento &decimal=, para que los CSVs se generen con \",\" como separador decimal. https://apis.datos.gob.ar/series/api/series/?limit=1000&metadata=full&start=0&ids=143.3_NO_PR_2004_A_21&format=csv&decimal=, Ver uso del par\u00e1metro decimal en la referencia.","title":"Usar el par\u00e1metro decimal"},{"location":"spreadsheet-integration/#modificar-la-configuracion-regional","text":"Para que Google Spreadsheet lea correctamente el archivo CSV por defecto, puede elegirse \u201cEstados Unidos\u201d o cualquier otra regi\u00f3n compatible como configuraci\u00f3n regional.","title":"Modificar la configuraci\u00f3n regional"},{"location":"spreadsheet-integration/#2-importar-los-datos-a-la-planilla","text":"La funci\u00f3n IMPORTDATA() toma la URL de la consulta a la API y trae los datos a la planilla.","title":"2. Importar los datos a la planilla"},{"location":"spreadsheet-integration/#3-elegir-el-formato-de-fecha","text":"El \u00edndice de tiempo puede verse como un n\u00famero la primera vez que se importan los datos. Lo m\u00e1s conveniente es seleccionar toda la columna y elegir el formato en el que se desea visualizar la fecha.","title":"3. Elegir el formato de fecha"},{"location":"spreadsheet-integration/#4-modificar-la-url-de-consulta-a-la-api","text":"Una vez importada la tabla por primera vez, se pueden modificar los distintos par\u00e1metros de la consulta seg\u00fan lo que se necesite. La tabla se actualizar\u00e1 con cada cambio.","title":"4. Modificar la URL de consulta a la API"},{"location":"spreadsheet-integration/#excel","text":"","title":"Excel"},{"location":"spreadsheet-integration/#0-chequear-que-tenes-instalado-lo-que-necesitas","text":"Excel 2016 : tiene todo lo necesario para integrar una URL a un CSV. Excel 2013 : necesita descargar e instalar Microsoft Power Query . Excel 2010 : necesita descargar e instalar el Service Pack 1 y luego descargar e instalar Microsoft Power Query .","title":"0. Chequear que ten\u00e9s instalado lo que necesit\u00e1s"},{"location":"spreadsheet-integration/#1-generar-una-nueva-consulta-desde-una-url","text":"\u201cDatos\u201d > \u201cNueva consulta\u201d > \u201cDesde otras fuentes\u201d > \u201cDesde una web\u201d Nota: si Excel est\u00e1 configurado para Argentina / latinoam\u00e9rica agregar a la URL de la API &decimal=, para que los n\u00fameros decimales usen \",\" en lugar de \".\" y Excel los lea correctamente. Ver uso del par\u00e1metro decimal en la referencia. https://apis.datos.gob.ar/series/api/series/?limit=1000&metadata=full&start=0&ids=143.3_NO_PR_2004_A_21&format=csv&decimal=,","title":"1. Generar una nueva consulta desde una URL"},{"location":"spreadsheet-integration/#2-editar-codificacion-del-archivo-origen","text":"Esto s\u00f3lo es necesario si se pide a la API usar las descripciones como nombres de las columnas ( &header=descriptions ) en lugar del texto corto que viene por defecto, formado con carateres compatibles con cualquier codificaci\u00f3n. La API genera los archivos CSV con codificaci\u00f3n \u201cUnicode UTF-8\u201d, que no es el valor por defecto de Excel y puede generar errores en los caracteres con tildes o la \"\u00f1\". Click en la rueda de \u201cOrigen\u201d > \u201cOrigen de archivo\u201d > Elegir \u201cUnicode UTF-8\u201d","title":"2. Editar codificaci\u00f3n del archivo origen"},{"location":"spreadsheet-integration/#3-editar-los-tipos-de-las-columnas","text":"Excel puede no interpretar correctamente las fechas cuando Excel est\u00e1 configurado para Argentina / latinoam\u00e9rica. Si este es el caso, se debe utilizar el \u201cEditor avanzado\u201d para corregir el tipo de la columna \"indice_tiempo\" que debe ser \u201ctype date\u201d.","title":"3. Editar los tipos de las columnas"},{"location":"spreadsheet-integration/#4-guardar-las-modificaciones-y-cargar-la-consulta","text":"Por \u00faltimo, haciendo click en \u201cCerrar y cargar\u201d la consulta queda configurada en una tabla de Excel que se puede actualizar.","title":"4. Guardar las modificaciones y cargar la consulta"},{"location":"terms/","text":"Condiciones de uso Legales Los datos de la API de Series de Tiempo bajo las licencias aplicadas por sus publicadores, que pueden ser consultadas en la tabla de metadatos de las series o en el objeto meta devuelto en una consulta a la API con par\u00e1metro metadata=full . https://apis.datos.gob.ar/series/api/series/?ids=103.1_I2N_2016_M_15&metadata=full { \"catalog\" : { \"publisher\" : { \"mbox\" : \"datoseconomicos@mecon.gov.ar\" , \"name\" : \"Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" }, \"license\" : \"Creative Commons Attribution 4.0\" , \"description\" : \"Cat\u00e1logo de datos abiertos de la Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" , \"language\" : Array [ 1 ][ \"SPA\" ], \"superThemeTaxonomy\" : \"http://datos.gob.ar/superThemeTaxonomy.json\" , \"issued\" : \"2017-09-28\" , \"rights\" : \"2017-09-28\" , \"modified\" : \"2017-09-28\" , \"spatial\" : \"ARG\" , \"title\" : \"Datos Programaci\u00f3n Macroecon\u00f3mica\" , \"identifier\" : \"sspm\" }, \"dataset\" : { \"publisher\" : { \"mbox\" : \"datoseconomicos@mecon.gov.ar\" , \"name\" : \"Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" }, \"landingPage\" : \"https://www.minhacienda.gob.ar/secretarias/politica-economica/programacion-macroeconomica/\" , \"keyword\" : Array [ 2 ][ \"Informaci\u00f3n Econ\u00f3mica al D\u00eda\" , \"Precios\" ], \"superTheme\" : Array [ 1 ][ \"ECON\" ], \"title\" : \"\u00cdndice de Precios al Consumidor. Por categor\u00edas. Base diciembre 2016.\" , \"language\" : Array [ 1 ][ \"SPA\" ], \"issued\" : \"2017-09-28\" , \"temporal\" : \"2016-04-01/2017-06-01\" , \"source\" : \"Instituto Nacional de Estad\u00edstica y Censos (INDEC)\" , \"theme\" : Array [ 1 ][ { \"label\" : \"Precios\" , \"id\" : \"precios\" , \"description\" : \"Series de precios\" } ], \"accrualPeriodicity\" : \"R/P1M\" , \"spatial\" : \"ARG\" , \"identifier\" : \"103\" , \"license\" : \"Creative Commons Attribution 4.0\" , \"contactPoint\" : { \"fn\" : \"Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" }, \"accessLevel\" : \"ABIERTO\" , \"description\" : \"\u00cdndice de Precios al Consumidor. Apertura por categor\u00edas. Base diciembre 2016.\" }, \"distribution\" : { \"accessURL\" : \"https://www.minhacienda.gob.ar/secretarias/politica-economica/programacion-macroeconomica/\" , \"description\" : \"\u00cdndice de Precios al Consumidor. Categor\u00edas. Valores mensuales. (Base diciembre 2016).\" , \"format\" : \"CSV\" , \"dataset_identifier\" : \"103\" , \"issued\" : \"2017-09-28\" , \"title\" : \"\u00cdndice de Precios al Consumidor, por categor\u00edas. Base diciembre 2016. Valores mensuales\" , \"fileName\" : \"indice-precios-al-consumidor-categorias-base-diciembre-2016-mensual.csv\" , \"downloadURL\" : \"http://infra.datos.gob.ar/catalog/sspm/dataset/103/distribution/103.1/download/indice-precios-al-consumidor-categorias-base-diciembre-2016-mensual.csv\" , \"identifier\" : \"103.1\" , \"scrapingFileURL\" : \"https://www.economia.gob.ar/download/infoeco/apendice4.xlsx\" , \"frequency\" : \"R/P1M\" , \"last_hash\" : \"355c9dd579208476c6520e8cb05c350dbfcb6b5d5b5743f30db0f8222a0cd6db38048b73ea465102c6c5d2dfa66970eb6857f4ed63cafaaf07fbde193e82979e\" , \"changed\" : \"False\" }, \"field\" : { \"distribution_identifier\" : \"103.1\" , \"description\" : \"IPC N\u00facleo. Base abr 2016. Mensual\" , \"title\" : \"ipc_2016_nucleo\" , \"dataset_identifier\" : \"103\" , \"specialTypeDetail\" : \"\" , \"units\" : \"\u00cdndice Dic-2016=100\" , \"type\" : \"number\" , \"id\" : \"103.1_I2N_2016_M_15\" , \"available\" : \"true\" , \"last_value\" : \"149.8703\" , \"second_to_last_value\" : \"145.2069\" , \"last_pct_change\" : \"0.03211555373746\" , \"time_index_end\" : \"2018-08-01\" , \"frequency\" : \"R/P1M\" , \"time_index_size\" : \"29\" , \"days_without_data\" : \"14\" , \"time_index_start\" : \"2016-04-01\" } } ] T\u00e9cnicas La API de series de tiempo se encuentra en estado beta de desarrollo y las cuotas de uso pueden cambiar significativamente en el futuro, dependiendo de la evoluci\u00f3n del desarrollo y uso del servicio. Actualmente se aplican las siguientes cuotas de uso por IP: Por segundo: 30 consultas Por minuto: 1000 consultas Por hora: 10000 consultas Por d\u00eda: 50000 consultas","title":"Condiciones de uso"},{"location":"terms/#condiciones-de-uso","text":"","title":"Condiciones de uso"},{"location":"terms/#legales","text":"Los datos de la API de Series de Tiempo bajo las licencias aplicadas por sus publicadores, que pueden ser consultadas en la tabla de metadatos de las series o en el objeto meta devuelto en una consulta a la API con par\u00e1metro metadata=full . https://apis.datos.gob.ar/series/api/series/?ids=103.1_I2N_2016_M_15&metadata=full { \"catalog\" : { \"publisher\" : { \"mbox\" : \"datoseconomicos@mecon.gov.ar\" , \"name\" : \"Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" }, \"license\" : \"Creative Commons Attribution 4.0\" , \"description\" : \"Cat\u00e1logo de datos abiertos de la Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" , \"language\" : Array [ 1 ][ \"SPA\" ], \"superThemeTaxonomy\" : \"http://datos.gob.ar/superThemeTaxonomy.json\" , \"issued\" : \"2017-09-28\" , \"rights\" : \"2017-09-28\" , \"modified\" : \"2017-09-28\" , \"spatial\" : \"ARG\" , \"title\" : \"Datos Programaci\u00f3n Macroecon\u00f3mica\" , \"identifier\" : \"sspm\" }, \"dataset\" : { \"publisher\" : { \"mbox\" : \"datoseconomicos@mecon.gov.ar\" , \"name\" : \"Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" }, \"landingPage\" : \"https://www.minhacienda.gob.ar/secretarias/politica-economica/programacion-macroeconomica/\" , \"keyword\" : Array [ 2 ][ \"Informaci\u00f3n Econ\u00f3mica al D\u00eda\" , \"Precios\" ], \"superTheme\" : Array [ 1 ][ \"ECON\" ], \"title\" : \"\u00cdndice de Precios al Consumidor. Por categor\u00edas. Base diciembre 2016.\" , \"language\" : Array [ 1 ][ \"SPA\" ], \"issued\" : \"2017-09-28\" , \"temporal\" : \"2016-04-01/2017-06-01\" , \"source\" : \"Instituto Nacional de Estad\u00edstica y Censos (INDEC)\" , \"theme\" : Array [ 1 ][ { \"label\" : \"Precios\" , \"id\" : \"precios\" , \"description\" : \"Series de precios\" } ], \"accrualPeriodicity\" : \"R/P1M\" , \"spatial\" : \"ARG\" , \"identifier\" : \"103\" , \"license\" : \"Creative Commons Attribution 4.0\" , \"contactPoint\" : { \"fn\" : \"Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" }, \"accessLevel\" : \"ABIERTO\" , \"description\" : \"\u00cdndice de Precios al Consumidor. Apertura por categor\u00edas. Base diciembre 2016.\" }, \"distribution\" : { \"accessURL\" : \"https://www.minhacienda.gob.ar/secretarias/politica-economica/programacion-macroeconomica/\" , \"description\" : \"\u00cdndice de Precios al Consumidor. Categor\u00edas. Valores mensuales. (Base diciembre 2016).\" , \"format\" : \"CSV\" , \"dataset_identifier\" : \"103\" , \"issued\" : \"2017-09-28\" , \"title\" : \"\u00cdndice de Precios al Consumidor, por categor\u00edas. Base diciembre 2016. Valores mensuales\" , \"fileName\" : \"indice-precios-al-consumidor-categorias-base-diciembre-2016-mensual.csv\" , \"downloadURL\" : \"http://infra.datos.gob.ar/catalog/sspm/dataset/103/distribution/103.1/download/indice-precios-al-consumidor-categorias-base-diciembre-2016-mensual.csv\" , \"identifier\" : \"103.1\" , \"scrapingFileURL\" : \"https://www.economia.gob.ar/download/infoeco/apendice4.xlsx\" , \"frequency\" : \"R/P1M\" , \"last_hash\" : \"355c9dd579208476c6520e8cb05c350dbfcb6b5d5b5743f30db0f8222a0cd6db38048b73ea465102c6c5d2dfa66970eb6857f4ed63cafaaf07fbde193e82979e\" , \"changed\" : \"False\" }, \"field\" : { \"distribution_identifier\" : \"103.1\" , \"description\" : \"IPC N\u00facleo. Base abr 2016. Mensual\" , \"title\" : \"ipc_2016_nucleo\" , \"dataset_identifier\" : \"103\" , \"specialTypeDetail\" : \"\" , \"units\" : \"\u00cdndice Dic-2016=100\" , \"type\" : \"number\" , \"id\" : \"103.1_I2N_2016_M_15\" , \"available\" : \"true\" , \"last_value\" : \"149.8703\" , \"second_to_last_value\" : \"145.2069\" , \"last_pct_change\" : \"0.03211555373746\" , \"time_index_end\" : \"2018-08-01\" , \"frequency\" : \"R/P1M\" , \"time_index_size\" : \"29\" , \"days_without_data\" : \"14\" , \"time_index_start\" : \"2016-04-01\" } } ]","title":"Legales"},{"location":"terms/#tecnicas","text":"La API de series de tiempo se encuentra en estado beta de desarrollo y las cuotas de uso pueden cambiar significativamente en el futuro, dependiendo de la evoluci\u00f3n del desarrollo y uso del servicio. Actualmente se aplican las siguientes cuotas de uso por IP: Por segundo: 30 consultas Por minuto: 1000 consultas Por hora: 10000 consultas Por d\u00eda: 50000 consultas","title":"T\u00e9cnicas"},{"location":"developers/admin/","text":"Documentaci\u00f3n de administraci\u00f3n de la API El proyecto se desdobla en varias aplicaciones, todas ellas con configuraciones particulares, accesibles desde el panel de administraci\u00f3n /admin (\"el admin\"). Tareas en segundo plano La API cuenta con varias tareas que se corren en segundo plano: la lectura de datos de series de tiempo, la indexaci\u00f3n de dichos datos al \u00edndice de Elasticsearch, la generaci\u00f3n de dumps de la base entera, entre otras. Todas las tareas se pueden correr manualmente creando nuevos modelos de tipo \"Corrida\" desde el admin, por ejemplo, Corridas de importaci\u00f3n de analytics , Corridas de indexaci\u00f3n de datos . Dentro de los modelos se encuentran los logs de cada corrida. Programaci\u00f3n de tareas Las tareas se pueden programar como una cola a correrse de manera autom\u00e1tica a trav\u00e9s de los modelos Synchronizer de django_datajsonar . Consultar su documentaci\u00f3n para m\u00e1s informaci\u00f3n. A continuaci\u00f3n se deja un ejemplo de una secuencia de tareas. Read Datajson (corrida completa) Indexaci\u00f3n de datos (s\u00f3lo actualizados) Test de integraci\u00f3n Reporte de indexaci\u00f3n Indexaci\u00f3n de metadatos Generaci\u00f3n de dumps CSV Generaci\u00f3n de dumps XLSX Generaci\u00f3n de dumps SQL Generaci\u00f3n de dumps DTA Esta programaci\u00f3n de tareas se puede realizar creando o editando desde el admin los modelos Synchronizer . Adicionalmente, se pueden programar corridas individuales utilizando el bot\u00f3n Schedule Task en las vistas individuales de los modelos de tipo \"Corrida\" mencionados anteriormente, pero es fuertemente recomendado utilizar Synchronizers por su funcionalidad m\u00e1s extensiva. Analytics Existe un m\u00f3dulo de la aplicaci\u00f3n que se dedica a importar datos de uso de la aplicaci\u00f3n desde una instanacia de api-gateway . Se puede configurar a trav\u00e9s de la vista \"Configuraci\u00f3n de importaci\u00f3n de analytics\" en el admin, a llenar con los campos relevantes de la instancia de API Gateway que querramos consultar, incluyendo ID de la API de series de tiempo en ese proyecto, y una api key. El campo Last Cursor es de uso interno y no deber\u00eda ser modificado . Test de integraci\u00f3n Existe un m\u00f3dulo que, idealmente justo despu\u00e9s de una indexaci\u00f3n de datos, se encargue de testear la consistencia de los datos cargados en el \u00edndice de Elasticsearch con los datos originales. Para la generaci\u00f3n del reporte en casos de errores, se pueden configurar usuarios destinatarios del email de error. en la vista \"Configuraci\u00f3n del test de integraci\u00f3n\", as\u00ed como el endpoint de la misma API a utilizar en los repotes (la API no conoce su propio host name, y por lo tanto debe ser configurado manualmente). Metadatos Otra tarea programada es la indexaci\u00f3n de metadatos de las series disponibles, para ser consultadas en el endpoint /search . La tarea debe ser corrida siempre despu\u00e9s de la indexaci\u00f3n de datos, para asegurar que ambos \u00edndices contengan datos consistentes entre ellos. Dentro de la vista \"Configuraci\u00f3n de b\u00fasqueda de series por metadatos\", se pueden configurar par\u00e1metros de boosting sobre ciertos campos de metadatos, para ir ajustando los resultados de b\u00fasqueda. El formato JSON de los par\u00e1metros debe ser siempre respetado. A continuaci\u00f3n se muestra el valor por defecto: {\"description\": {\"boost\": 1.5}, \"dataset_title\": {\"boost\": 1}, \"dataset_source\": {\"boost\": 1}, \"dataset_description\": {\"boost\": 1}} As\u00ed, el campo description de las series tiene cierta relevancia adicional sobre los dem\u00e1s (1.5 vs 1). Si se modifica el boost de alg\u00fan campo, no es necesario reindexar los datos para que el cambio tome efecto, se aplica en tiempo de b\u00fasqueda y no de indexaci\u00f3n. Dumps Existen cuatro tareas relacionadas a la generaci\u00f3n de dumps de la base entera de series de tiempo. Son una tarea por cada formato disponible: CSV, XLSX, SQL, DTA. Cada tarea genera dumps globales , de la base entera, y tambi\u00e9n individuales por cada nodo. Existe una fuerte dependencia entre estas tareas: los dumps en CSV se generan a partir de lecturas a la base de datos para leer metadatos, y al file storage para leer los datos de cada serie. Los dem\u00e1s formatos se generan a partir del dump CSV. Por lo tanto el dump en CSV debe ser programado 3 horas antes que los dem\u00e1s. Los dumps CSV y XLSX generan 4 distribuciones por cat\u00e1logo , Los dumps en SQLite un archivo \u00fanico por cat\u00e1logo con varias tablas, y los dumps en DTA 3 archivos, todos disponibles en un endpoint accesible al p\u00fablico. Los dumps generados tendr\u00e1n los datos de todas las series disponibles por la API, es decir las series cuyos datos fueron indexados exitosamente. Unidades porcentuales y no porcentuales Una vez cargadas e indexadas las series, en la vista de Unidades de series en el admin se pueden indicar cuales de las unidades se deber\u00edan interpretar como porcentuales. Por defecto todas las unidades existentes son tratadas como valores absolutos. Cuando una unidad se marque como porcentual, en la respuesta de metadatos de las series, el campo \u00ecs_percentage pasar\u00e1 a valer true en todos los casos de consulta de series que est\u00e9n representadas bajo esa unidad. El prop\u00f3sito de esta funcionalidad es para indicarle a los usuarios de manera m\u00e1s sencilla si los valores de una serie deber\u00edan ser tratados como porcentajes o no.","title":"Administraci\u00f3n"},{"location":"developers/admin/#documentacion-de-administracion-de-la-api","text":"El proyecto se desdobla en varias aplicaciones, todas ellas con configuraciones particulares, accesibles desde el panel de administraci\u00f3n /admin (\"el admin\").","title":"Documentaci\u00f3n de administraci\u00f3n de la API"},{"location":"developers/admin/#tareas-en-segundo-plano","text":"La API cuenta con varias tareas que se corren en segundo plano: la lectura de datos de series de tiempo, la indexaci\u00f3n de dichos datos al \u00edndice de Elasticsearch, la generaci\u00f3n de dumps de la base entera, entre otras. Todas las tareas se pueden correr manualmente creando nuevos modelos de tipo \"Corrida\" desde el admin, por ejemplo, Corridas de importaci\u00f3n de analytics , Corridas de indexaci\u00f3n de datos . Dentro de los modelos se encuentran los logs de cada corrida.","title":"Tareas en segundo plano"},{"location":"developers/admin/#programacion-de-tareas","text":"Las tareas se pueden programar como una cola a correrse de manera autom\u00e1tica a trav\u00e9s de los modelos Synchronizer de django_datajsonar . Consultar su documentaci\u00f3n para m\u00e1s informaci\u00f3n. A continuaci\u00f3n se deja un ejemplo de una secuencia de tareas. Read Datajson (corrida completa) Indexaci\u00f3n de datos (s\u00f3lo actualizados) Test de integraci\u00f3n Reporte de indexaci\u00f3n Indexaci\u00f3n de metadatos Generaci\u00f3n de dumps CSV Generaci\u00f3n de dumps XLSX Generaci\u00f3n de dumps SQL Generaci\u00f3n de dumps DTA Esta programaci\u00f3n de tareas se puede realizar creando o editando desde el admin los modelos Synchronizer . Adicionalmente, se pueden programar corridas individuales utilizando el bot\u00f3n Schedule Task en las vistas individuales de los modelos de tipo \"Corrida\" mencionados anteriormente, pero es fuertemente recomendado utilizar Synchronizers por su funcionalidad m\u00e1s extensiva.","title":"Programaci\u00f3n de tareas"},{"location":"developers/admin/#analytics","text":"Existe un m\u00f3dulo de la aplicaci\u00f3n que se dedica a importar datos de uso de la aplicaci\u00f3n desde una instanacia de api-gateway . Se puede configurar a trav\u00e9s de la vista \"Configuraci\u00f3n de importaci\u00f3n de analytics\" en el admin, a llenar con los campos relevantes de la instancia de API Gateway que querramos consultar, incluyendo ID de la API de series de tiempo en ese proyecto, y una api key. El campo Last Cursor es de uso interno y no deber\u00eda ser modificado .","title":"Analytics"},{"location":"developers/admin/#test-de-integracion","text":"Existe un m\u00f3dulo que, idealmente justo despu\u00e9s de una indexaci\u00f3n de datos, se encargue de testear la consistencia de los datos cargados en el \u00edndice de Elasticsearch con los datos originales. Para la generaci\u00f3n del reporte en casos de errores, se pueden configurar usuarios destinatarios del email de error. en la vista \"Configuraci\u00f3n del test de integraci\u00f3n\", as\u00ed como el endpoint de la misma API a utilizar en los repotes (la API no conoce su propio host name, y por lo tanto debe ser configurado manualmente).","title":"Test de integraci\u00f3n"},{"location":"developers/admin/#metadatos","text":"Otra tarea programada es la indexaci\u00f3n de metadatos de las series disponibles, para ser consultadas en el endpoint /search . La tarea debe ser corrida siempre despu\u00e9s de la indexaci\u00f3n de datos, para asegurar que ambos \u00edndices contengan datos consistentes entre ellos. Dentro de la vista \"Configuraci\u00f3n de b\u00fasqueda de series por metadatos\", se pueden configurar par\u00e1metros de boosting sobre ciertos campos de metadatos, para ir ajustando los resultados de b\u00fasqueda. El formato JSON de los par\u00e1metros debe ser siempre respetado. A continuaci\u00f3n se muestra el valor por defecto: {\"description\": {\"boost\": 1.5}, \"dataset_title\": {\"boost\": 1}, \"dataset_source\": {\"boost\": 1}, \"dataset_description\": {\"boost\": 1}} As\u00ed, el campo description de las series tiene cierta relevancia adicional sobre los dem\u00e1s (1.5 vs 1). Si se modifica el boost de alg\u00fan campo, no es necesario reindexar los datos para que el cambio tome efecto, se aplica en tiempo de b\u00fasqueda y no de indexaci\u00f3n.","title":"Metadatos"},{"location":"developers/admin/#dumps","text":"Existen cuatro tareas relacionadas a la generaci\u00f3n de dumps de la base entera de series de tiempo. Son una tarea por cada formato disponible: CSV, XLSX, SQL, DTA. Cada tarea genera dumps globales , de la base entera, y tambi\u00e9n individuales por cada nodo. Existe una fuerte dependencia entre estas tareas: los dumps en CSV se generan a partir de lecturas a la base de datos para leer metadatos, y al file storage para leer los datos de cada serie. Los dem\u00e1s formatos se generan a partir del dump CSV. Por lo tanto el dump en CSV debe ser programado 3 horas antes que los dem\u00e1s. Los dumps CSV y XLSX generan 4 distribuciones por cat\u00e1logo , Los dumps en SQLite un archivo \u00fanico por cat\u00e1logo con varias tablas, y los dumps en DTA 3 archivos, todos disponibles en un endpoint accesible al p\u00fablico. Los dumps generados tendr\u00e1n los datos de todas las series disponibles por la API, es decir las series cuyos datos fueron indexados exitosamente.","title":"Dumps"},{"location":"developers/admin/#unidades-porcentuales-y-no-porcentuales","text":"Una vez cargadas e indexadas las series, en la vista de Unidades de series en el admin se pueden indicar cuales de las unidades se deber\u00edan interpretar como porcentuales. Por defecto todas las unidades existentes son tratadas como valores absolutos. Cuando una unidad se marque como porcentual, en la respuesta de metadatos de las series, el campo \u00ecs_percentage pasar\u00e1 a valer true en todos los casos de consulta de series que est\u00e9n representadas bajo esa unidad. El prop\u00f3sito de esta funcionalidad es para indicarle a los usuarios de manera m\u00e1s sencilla si los valores de una serie deber\u00edan ser tratados como porcentajes o no.","title":"Unidades porcentuales y no porcentuales"},{"location":"developers/arquitectura/","text":"Arquitectura de la API de series de tiempo Introducci\u00f3n La API de Series de Tiempo del Paquete de Apertura de Datos de la Rep\u00fablica Argentina est\u00e1 basada en una aplicaci\u00f3n web Django que corre bajo Python2.7 que funciona como puerta de entrada a los datos que la misma aloja y procesa. Los datos mencionados previamente son calculados en base a recursos alojados en distintas ubicaciones dentro de la World Wide Web , que son obtenidos por procesos asicr\u00f3nicos basados en RQ orquestados utilizando supervisor y Redis.io . El almacenamiento de los datos se realiza en un cluster de Elastic y la API utiliza distintas estrategias para acceder a los mismos, realizando transformaciones precalculadas o en memoria. Componentes de la arquitectura Servidor Web El servidor web contiene la aplicaci\u00f3n Django que conforma el punto de entrada a la API de Series de Tiempo. La aplicaci\u00f3n Django es ejecutada utilizando supervisor y publicada a la web usando el servidor web Nginx . \u00c9sta publica un conjunto de endpoints sencillos que permiten acceder a los datos y a los metadatos de la informaci\u00f3n que contiene, permitiendo configurar filtros y expresiones de transformaci\u00f3n predefinidas (ver documentaci\u00f3n de la API de Series de Tiempo ). Se trata de una aplicaci\u00f3n Django 1.11 (por dependencias transitivas, la API no es compatible con Python3) cuyo panel de administraci\u00f3n se utiliza exhaustivamente para configurar el funcionamiento de la misma. Cluster de Workers Los workers est\u00e1n conformados por aplicaciones Python que ejecutan el mismo contexto y baseline de c\u00f3digo que la aplicaci\u00f3n web. Estos procesos Python realizan distintas tareas asincr\u00f3nicas de administraci\u00f3n que permiten el correcto funcionamiento de la API de Serie de Tiempo, como por ejemplo: Procesamiento de archivos de configuraci\u00f3n. Descarga y validaci\u00f3n de los data.json de la red de nodos. Descarga y validaci\u00f3n de los recursos pertenecientes a los datasets seleccionados para indexar. Indexaci\u00f3n de datos, incluyendo el prec\u00e1lculo de algunos indicadores. Indexaci\u00f3n de metadatos de los datos. Generaci\u00f3n de reportes. Sincronizaci\u00f3n de datos con servicios externos. Las colas de tareas y los workers est\u00e1n basados en Python-RQ, y las tareas se persisten en un servidor de base de datos en memoria Redis.io. Servidor de bases de datos El servidor de bases de datos contiene dos servicios: PostgreSQL: Base de datos relacional que contiene el modelo de datos de la aplicaci\u00f3n web. Redis: Base de datos en memoria que es utilizado para guardar los datos y metadatos de las tareas asincr\u00f3nicas a ejecutar por los workers y tambi\u00e9n es utilizado como cach\u00e9 por la aplicaci\u00f3n web. Cluster Elastic El cluster Elastic contiene un n\u00famero de servidores con el servicio de Elastic search ejecut\u00e1ndose. El mismo est\u00e1 configurado para tener 3 shards y una r\u00e9plica.","title":"Arquitectura"},{"location":"developers/arquitectura/#arquitectura-de-la-api-de-series-de-tiempo","text":"","title":"Arquitectura de la API de series de tiempo"},{"location":"developers/arquitectura/#introduccion","text":"La API de Series de Tiempo del Paquete de Apertura de Datos de la Rep\u00fablica Argentina est\u00e1 basada en una aplicaci\u00f3n web Django que corre bajo Python2.7 que funciona como puerta de entrada a los datos que la misma aloja y procesa. Los datos mencionados previamente son calculados en base a recursos alojados en distintas ubicaciones dentro de la World Wide Web , que son obtenidos por procesos asicr\u00f3nicos basados en RQ orquestados utilizando supervisor y Redis.io . El almacenamiento de los datos se realiza en un cluster de Elastic y la API utiliza distintas estrategias para acceder a los mismos, realizando transformaciones precalculadas o en memoria.","title":"Introducci\u00f3n"},{"location":"developers/arquitectura/#componentes-de-la-arquitectura","text":"","title":"Componentes de la arquitectura"},{"location":"developers/arquitectura/#servidor-web","text":"El servidor web contiene la aplicaci\u00f3n Django que conforma el punto de entrada a la API de Series de Tiempo. La aplicaci\u00f3n Django es ejecutada utilizando supervisor y publicada a la web usando el servidor web Nginx . \u00c9sta publica un conjunto de endpoints sencillos que permiten acceder a los datos y a los metadatos de la informaci\u00f3n que contiene, permitiendo configurar filtros y expresiones de transformaci\u00f3n predefinidas (ver documentaci\u00f3n de la API de Series de Tiempo ). Se trata de una aplicaci\u00f3n Django 1.11 (por dependencias transitivas, la API no es compatible con Python3) cuyo panel de administraci\u00f3n se utiliza exhaustivamente para configurar el funcionamiento de la misma.","title":"Servidor Web"},{"location":"developers/arquitectura/#cluster-de-workers","text":"Los workers est\u00e1n conformados por aplicaciones Python que ejecutan el mismo contexto y baseline de c\u00f3digo que la aplicaci\u00f3n web. Estos procesos Python realizan distintas tareas asincr\u00f3nicas de administraci\u00f3n que permiten el correcto funcionamiento de la API de Serie de Tiempo, como por ejemplo: Procesamiento de archivos de configuraci\u00f3n. Descarga y validaci\u00f3n de los data.json de la red de nodos. Descarga y validaci\u00f3n de los recursos pertenecientes a los datasets seleccionados para indexar. Indexaci\u00f3n de datos, incluyendo el prec\u00e1lculo de algunos indicadores. Indexaci\u00f3n de metadatos de los datos. Generaci\u00f3n de reportes. Sincronizaci\u00f3n de datos con servicios externos. Las colas de tareas y los workers est\u00e1n basados en Python-RQ, y las tareas se persisten en un servidor de base de datos en memoria Redis.io.","title":"Cluster de Workers"},{"location":"developers/arquitectura/#servidor-de-bases-de-datos","text":"El servidor de bases de datos contiene dos servicios: PostgreSQL: Base de datos relacional que contiene el modelo de datos de la aplicaci\u00f3n web. Redis: Base de datos en memoria que es utilizado para guardar los datos y metadatos de las tareas asincr\u00f3nicas a ejecutar por los workers y tambi\u00e9n es utilizado como cach\u00e9 por la aplicaci\u00f3n web.","title":"Servidor de bases de datos"},{"location":"developers/arquitectura/#cluster-elastic","text":"El cluster Elastic contiene un n\u00famero de servidores con el servicio de Elastic search ejecut\u00e1ndose. El mismo est\u00e1 configurado para tener 3 shards y una r\u00e9plica.","title":"Cluster Elastic"},{"location":"developers/development/","text":"Development A continuaci\u00f3n se detallan los pasos a seguir para levantar una versi\u00f3n local de la aplicaci\u00f3n, apuntado a futuros desarrolladores de la misma. Este documento asume un entorno Linux para el desarrollo, y fue probado bajo Ubuntu 16.04. Requerimientos Python 2.7.6 Virtualenv Docker Docker compose Setup Virtualenv (con Pyenv) Es recomendable instalar las dependencias de la aplicaci\u00f3n en un entorno virtual para evitar conflictos con otras aplicaciones de versionado de las librer\u00edas usadas. Este ejemplo instala un entorno virtual de Python 2.7.6 con el nombre stiempo-api , y todas las dependencias de la aplicaci\u00f3n. pyenv virtualenv 2 .7.6 stiempo-api pyenv activate stiempo-api pip install -r requirements/local.txt Configuraci\u00f3n Algunas configuraciones locales (como variables de entorno, o la base de datos usada) pueden llegar a diferir de la versi\u00f3n productiva, y deben ser seteadas manualmente. Para ello se provee una configuraci\u00f3n de ejemplo , que puede ser usada como base. cp conf/settings/local_example.py conf/settings/local.py cp conf/settings/.env.default_local conf/settings/.env A su vez, se debe informar a Django cual es el m\u00f3dulo de configuraci\u00f3n a leer. Este m\u00f3dulo debe ser el mismo que fue copiado en el paso anterior ( conf/settings/local.py en el ejemplo). Esto se hace seteando la variable de entorno DJANGO_SETTINGS_MODULE , lo cual se puede hacer persistente entre sesiones de terminal escribi\u00e9ndolo en .bashrc (o similar, dependiendo de la terminal utilizada): export DJANGO_SETTINGS_MODULE = conf.settings.local Servicios Los servicios (PostgreSQL, Elasticsearch, Redis) pueden ser levantados usando Docker y Docker Compose: docker-compose pull docker-compose up -d Base de datos Correr las migraciones de las base de datos: python manage.py migrate Worker Levanta los workers para ejecutar tareas asincr\u00f3nicas. Notar que esta tarea bloquea la terminal. python manage.py rqworker high default low scrapping Web server Este comando levanta la aplicaci\u00f3n. python manage.py runserver Si est\u00e1 todo en orden se podr\u00e1 leer alg\u00fan mensaje como el siguiente: Django version 1 .11.6, using settings 'conf.settings.local' Starting development server at http://127.0.0.1:8000/ Quit the server with CONTROL-C. Tests Correr scripts/tests.sh desde el directorio ra\u00edz. Tambi\u00e9n se proveen scripts que chequean estilos ( scripts/pycodestyle.sh ) y p\u00fdlint ( scripts/pylint.sh )","title":"Instalaci\u00f3n"},{"location":"developers/development/#development","text":"A continuaci\u00f3n se detallan los pasos a seguir para levantar una versi\u00f3n local de la aplicaci\u00f3n, apuntado a futuros desarrolladores de la misma. Este documento asume un entorno Linux para el desarrollo, y fue probado bajo Ubuntu 16.04.","title":"Development"},{"location":"developers/development/#requerimientos","text":"Python 2.7.6 Virtualenv Docker Docker compose","title":"Requerimientos"},{"location":"developers/development/#setup","text":"","title":"Setup"},{"location":"developers/development/#virtualenv-con-pyenv","text":"Es recomendable instalar las dependencias de la aplicaci\u00f3n en un entorno virtual para evitar conflictos con otras aplicaciones de versionado de las librer\u00edas usadas. Este ejemplo instala un entorno virtual de Python 2.7.6 con el nombre stiempo-api , y todas las dependencias de la aplicaci\u00f3n. pyenv virtualenv 2 .7.6 stiempo-api pyenv activate stiempo-api pip install -r requirements/local.txt","title":"Virtualenv (con Pyenv)"},{"location":"developers/development/#configuracion","text":"Algunas configuraciones locales (como variables de entorno, o la base de datos usada) pueden llegar a diferir de la versi\u00f3n productiva, y deben ser seteadas manualmente. Para ello se provee una configuraci\u00f3n de ejemplo , que puede ser usada como base. cp conf/settings/local_example.py conf/settings/local.py cp conf/settings/.env.default_local conf/settings/.env A su vez, se debe informar a Django cual es el m\u00f3dulo de configuraci\u00f3n a leer. Este m\u00f3dulo debe ser el mismo que fue copiado en el paso anterior ( conf/settings/local.py en el ejemplo). Esto se hace seteando la variable de entorno DJANGO_SETTINGS_MODULE , lo cual se puede hacer persistente entre sesiones de terminal escribi\u00e9ndolo en .bashrc (o similar, dependiendo de la terminal utilizada): export DJANGO_SETTINGS_MODULE = conf.settings.local","title":"Configuraci\u00f3n"},{"location":"developers/development/#servicios","text":"Los servicios (PostgreSQL, Elasticsearch, Redis) pueden ser levantados usando Docker y Docker Compose: docker-compose pull docker-compose up -d","title":"Servicios"},{"location":"developers/development/#base-de-datos","text":"Correr las migraciones de las base de datos: python manage.py migrate","title":"Base de datos"},{"location":"developers/development/#worker","text":"Levanta los workers para ejecutar tareas asincr\u00f3nicas. Notar que esta tarea bloquea la terminal. python manage.py rqworker high default low scrapping","title":"Worker"},{"location":"developers/development/#web-server","text":"Este comando levanta la aplicaci\u00f3n. python manage.py runserver Si est\u00e1 todo en orden se podr\u00e1 leer alg\u00fan mensaje como el siguiente: Django version 1 .11.6, using settings 'conf.settings.local' Starting development server at http://127.0.0.1:8000/ Quit the server with CONTROL-C.","title":"Web server"},{"location":"developers/development/#tests","text":"Correr scripts/tests.sh desde el directorio ra\u00edz. Tambi\u00e9n se proveen scripts que chequean estilos ( scripts/pycodestyle.sh ) y p\u00fdlint ( scripts/pylint.sh )","title":"Tests"},{"location":"reference/api-reference/","text":"Referencia API: series Recurso: /series El recurso /series permite obtener datos y metadatos de una o m\u00e1s series, permitiendo hacer filtros por el \u00edndice de tiempo, cambios de granularidad en la dimensi\u00f3n temporal y cambios en la unidad de medida de los valores de la serie, entre otras operaciones. Tabla de par\u00e1metros ids representation_mode collapse collapse_aggregation limit start start_date end_date format header sort metadata decimal sep flatten last Tabla de par\u00e1metros Nombre Requerido Descripci\u00f3n Default Ejemplos ids Si Lista de caracteres alfanum\u00e9ricos separados por comas. Contiene la especificaci\u00f3n de las series a consultar, junto a transformaciones y operaciones. N/A ids=2.4_DGI_1993_T_19,134.2_B_0_0_6 representation_mode No Uno de: value, change, percent_change, percent_change_a_year_ago value representation_mode=percent_change collapse No Uno de: day, week, month, quarter, year La frecuencia propia de la serie collapse=year collapse=quarter collapse_aggregation No Uno de: avg, sum, end_of_period, min, max avg collapse_aggregation=sum limit No N\u00famero entero positivo, no mayor que 1000. 100 limit=50 start No N\u00famero entero positivo o 0. 0 start=100 start_date No Fecha y hora en formato ISO 8601. Si no se especifica este par\u00e1metro, se devuelven los datos disponibles para la serie o series desde el valor m\u00e1s antiguo. N/A start_date=2016-11-30 start_date=2016-11 start_date=2016 end_date No Fecha y hora en formato ISO 8601. Si no se especifica este par\u00e1metro, se devuelven los datos disponibles para la serie o series hasta el valor m\u00e1s reciente. N/A end_date=2016-11-30 end_date=2016-11 end_date=2016 format No Uno de: json, csv json format=csv header No Uno de: titles, ids, descriptions titles header=ids sort No Uno de: asc, desc asc sort=desc metadata No Uno de: none, simple, full, only simple metadata=none decimal No Caracter utilizado para los decimales. Uno de: \",\" o \".\" . decimal=, sep No Caracter separador de los valores del CSV. Cualquier caracter UTF-8 , sep=| flatten No Aplana la respuesta de metadatos en un objeto con un \u00fanico nivel (sin objetos anidados). No es necesario darle valor flatten last No Modifica el pedido para devolver los \u00faltimos N valores de la(s) serie(s), en orden de fechas ascendiente. Mutuamente exclusivo con `sort`, `start`, y `limit`. N/A last=12 ids Lista separada por comas de los identificadores de las series a seleccionar para armar la respuesta. Los datos del resultado de la llamada tendr\u00e1n una columna por cada serie seleccionada, en el mismo orden. Este par\u00e1metro es requerido para la llamada . En caso de no suministrarse, se devolver\u00e1 un error. Cada identificador de serie podr\u00e1 ser sufijado con: Un modo de representaci\u00f3n ( representation_mode ). Una funci\u00f3n de agregaci\u00f3n temporal ( collapse_aggregation ). Cuando estos atributos se utilizan como parte del par\u00e1metro ids , se deben separar usando el caracter \":\". El orden de los componentes no incide en el resultado de la operaci\u00f3n. Ejemplos: ids=2.4_DGI_1993_T_19,134.2_B_0_0_6:change ids=2.4_DGI_1993_T_19,134.2_B_0_0_6:sum:change ids=2.4_DGI_1993_T_19,134.2_B_0_0_6:change:sum ids=2.4_DGI_1993_T_19:percent_change,134.2_B_0_0_6:sum:change ids=2.4_DGI_1993_T_19:end_of_period:percent_change,134.2_B_0_0_6:sum:change representation_mode Este par\u00e1metro indica el modo de representaci\u00f3n de las series, y se aplica a todas aquellas que no tengan otro modo de representaci\u00f3n distinto indicado en el par\u00e1metro ids en forma individual. El modo de representaci\u00f3n por defecto es el valor medido en la serie ( value ). Los modos de representaci\u00f3n disponibles son: value : Es el modo de representaci\u00f3n por defecto. Devuelve el valor medido en la serie. change : Devuelve la diferencia absoluta entre el valor del per\u00edodo t y el de t-1. percent_change : Devuelve la variaci\u00f3n porcentual entre el valor del per\u00edodo t y el de t-1. percent_change_a_year_ago : Devuelve la variaci\u00f3n porcentual entre el valor del per\u00edodo t y el del per\u00edodo t equivalente de hace un a\u00f1o atr\u00e1s. Las funciones de transformaci\u00f3n disponibles en representation_mode tambi\u00e9n pueden especificarse para series individuales usando la notaci\u00f3n :percent_change junto al id de la serie: EMAE Construcci\u00f3n. Variaci\u00f3n porcentual de valores mensuales, respecto del per\u00edodo anterior. https://apis.datos.gob.ar/series/api/series/?limit=1000&ids=11.3_VMATC_2004_M_12:percent_change EMAE Construcci\u00f3n (variaci\u00f3n porcentual per\u00edodo a per\u00edodo), EMAE Construcci\u00f3n (variaci\u00f3n porcentual interanual). Valores mensuales. https://apis.datos.gob.ar/series/api/series/?limit=1000&ids=11.3_VMATC_2004_M_12:percent_change,11.3_VMATC_2004_M_12:percent_change_a_year_ago El par\u00e1metro representation_mode seguir\u00e1 afectando a todas las series para las cuales no se especifique individualmente una funci\u00f3n de transformaci\u00f3n. collapse El par\u00e1metro collapse modifica la frecuencia de muestreo de los datos de la serie o las series solicitadas. Debe usarse en combinaci\u00f3n con collapse_aggregation para indicar una funnci\u00f3n de agregaci\u00f3n temporal, cuando corresponda. Las opciones disponibles son: year : Muestra datos agregados anualmente. quarter : Muestra datos agregados trimestralmente. month : Muestra datos agregados mensualmente. week : Muestra datos agregados semanalmente. day : Muestra datos agregados diariamente. Si no se indica, se retornan los datos con la frecuencia original de la serie . Si se solicitan m\u00faltiples series de distintas frecuencias , se utilizar\u00e1 la menor frecuencia de todas ellas (Ej.: si se solicitan a la vez una serie diaria, una mensual y una trimestral, se convertir\u00e1n todas las series a la frecuencia trimestral). Si la granularidad temporal solicitada en el valor de collapse es menor a la granularidad propia de alguna de las series solicitadas, la consulta devolver\u00e1 un error. El par\u00e1metro collapse afecta globalmente a todas las series seleccionadas por el par\u00e1metro ids en la llamada. collapse_aggregation El par\u00e1metro collapse_aggregation indica la funci\u00f3n de agregaci\u00f3n temporal que debe usarse para homogeneizar la frecuencia temporal de todas las series solicitadas (Ej.: qu\u00e9 operaci\u00f3n realizar para convertir una serie mensual en anual). Esta funci\u00f3n de agregaci\u00f3n actuar\u00e1 sobre: Las series agrupadas de mayor granularidad temporal (frecuencia m\u00e1s alta) que la granularidad indicada por el par\u00e1metro collapse En caso de que no se especifique el par\u00e1metro collapse , las series agrupadas de mayor granularidad temporal que la de la serie de menor frecuencia temporal. Los valores disponibles para el par\u00e1metro son: avg : Realiza el promedio de todos los valores agrupados. Es la opci\u00f3n por defecto si no se indica valor para collapse_aggregation . sum : Suma todos los valores agrupados. end_of_period : \u00daltimo valor del per\u00edodo. min : M\u00ednimo entre los valores agrupados. max : M\u00e1ximo entre los valores agrupados. Las funciones de agregaci\u00f3n temporal disponibles en collapse_aggregation tambi\u00e9n pueden especificarse para series individuales usando la notaci\u00f3n :sum junto al id de la serie: Cobro de servicios de turismo y viajes. Valores mensuales promediados y sumados por a\u00f1o. https://apis.datos.gob.ar/series/api/series/?ids=185.1_COBRO_SERVJES_0_M_30:avg,185.1_COBRO_SERVJES_0_M_30:sum&collapse=year El par\u00e1metro collapse_aggregation seguir\u00e1 afectando a todas las series para las cuales no se especifique individualmente una funci\u00f3n de agregaci\u00f3n temporal. Cobro de servicios de turismo y viajes. Valores mensuales promediados y sumados por a\u00f1o. https://apis.datos.gob.ar/series/api/series/?ids=185.1_COBRO_SERVJES_0_M_30:avg,185.1_COBRO_SERVJES_0_M_30&collapse=year&collapse_aggregation=sum limit Este par\u00e1metro es utilizado junto a start para controlar el paginado de los resultados devueltos por la API. Debe especificarse un n\u00famero entero positivo, no mayor que 1000, ya que esa es la cantidad m\u00e1xima de resultados devueltos por la API. El valor por defecto si no se especifica valor alguno es 100. start Este par\u00e1metro es utilizado junto a limit para controlar el paginado de los resultados devueltos por la API. Debe especificarse un n\u00famero entero positivo o 0. El valor por defecto si no se especifica valor alguno es 0. El start indica el \"n\u00famero de per\u00edodos despu\u00e9s de start_date \" (o el \"n\u00famero de per\u00edodos antes de end_date \", dependiendo del ordenamiento asc o desc del par\u00e1metro sort ) que se saltean desde el comienzo o el final de la serie antes de empezar a devolver valores. start_date El par\u00e1metro start_date indica la fecha menor a partir de la cual se comenzar\u00e1n a recolectar datos para la respuesta. Los valores cuyo \u00edndice de tiempo coincida con el valor de start_date se incluir\u00e1n en el resultado retornado. Se utilizar\u00e1 como filtro sobre el \u00edndice de tiempo de las series de datos. end_date El par\u00e1metro end_date indica la fecha mayor hasta la cual se recolectar\u00e1n datos para la respuesta. Los valores cuyo \u00edndice de tiempo coincida con el valor de end_date se incluir\u00e1n en el resultado retornado. Se utilizar\u00e1 como filtro sobre el \u00edndice de tiempo de las series de datos. format Especifica el formato de la respuesta, siendo json el valor por defecto. Las opciones disponibles son: json : Devuelve un objeto json con datos y metadatos de las series. csv : Devuelve las series seleccionadas en formato separado por comas. Este tipo de formato no incluye metadatos de las series seleccionadas. header Especifica los atributos de las series a utilizar como headers (cabeceras) de las columnas del archivo CSV generado. Por defecto usa titles , que son los t\u00edtulos de las series. Las opciones disponibles son: titles : T\u00edtulos de las series, por ejemplo oferta_global_pib (default). ids : Identificadores \u00fanicos de las series, los mismos pasados al par\u00e1metro ids . descriptions : Descripciones completas de las series, por ejemplo Plazo fijo entre 60-89 d\u00edas en millones de pesos. Categor\u00eda II-VI sort Especifica el orden temporal de los resultados devueltos, siendo asc el valor por defecto. Las opciones disponibles son: asc : Se devuelven los valores m\u00e1s antiguos primero (default). desc : Se devuelven los valores m\u00e1s recientes primero. metadata Especifica el nivel de detalle de metadatos requerido por el usuario, siendo simple el valor por defecto. S\u00f3lo aplica cuando format=json . Las opciones disponibles son: none : No se devuelven metadatos, s\u00f3lo datos. only : No se devuelven datos, s\u00f3lo metadatos. simple : Se devuelven los metadatos m\u00e1s importantes para comprender y utilizar las series (default). full : Se devuelven todos los metadatos disponibles que tengan relaci\u00f3n con cada serie. decimal Especifica el caracter utilizado para los n\u00fameros decimales, siendo . el valor por defecto. S\u00f3lo aplica cuando format=csv . Las opciones disponibles son: , : Coma. . : Punto. sep Especifica el caracter separador de valores, siendo , el valor por defecto. S\u00f3lo aplica cuando format=csv . Se puede utilizar cualquier caracter UTF-8, si bien se recomienda preservar el uso de la coma en la mayor\u00eda de los casos. flatten Especifica si la respuesta de los metadatos de las series pedidas deber\u00edan devolverse en una jerarqu\u00eda plana . Cuando el par\u00e1metro no es incluido, la respuesta tiene la siguiente estructura: { \"catalog\": [], \"dataset\": [], \"distribution\": [], \"field\": [], } Una consulta con par\u00e1metro flatten incluido tendr\u00e1 la siguiente respuesta de metadatos: { catalog_meta1: ..., catalog_meta2: ..., dataset_meta1: ..., _: ... } last Modifica el pedido para devolver los \u00faltimos N valores de la(s) serie(s), en orden de fechas ascendiente. Mutuamente exclusivo con sort , start , y limit . Un pedido con last=N es equivalente a invertir el orden de un pedido con sort=desc , limit=N .","title":"/series"},{"location":"reference/api-reference/#referencia-api-series","text":"Recurso: /series El recurso /series permite obtener datos y metadatos de una o m\u00e1s series, permitiendo hacer filtros por el \u00edndice de tiempo, cambios de granularidad en la dimensi\u00f3n temporal y cambios en la unidad de medida de los valores de la serie, entre otras operaciones. Tabla de par\u00e1metros ids representation_mode collapse collapse_aggregation limit start start_date end_date format header sort metadata decimal sep flatten last","title":"Referencia API: series"},{"location":"reference/api-reference/#tabla-de-parametros","text":"Nombre Requerido Descripci\u00f3n Default Ejemplos ids Si Lista de caracteres alfanum\u00e9ricos separados por comas. Contiene la especificaci\u00f3n de las series a consultar, junto a transformaciones y operaciones. N/A ids=2.4_DGI_1993_T_19,134.2_B_0_0_6 representation_mode No Uno de: value, change, percent_change, percent_change_a_year_ago value representation_mode=percent_change collapse No Uno de: day, week, month, quarter, year La frecuencia propia de la serie collapse=year collapse=quarter collapse_aggregation No Uno de: avg, sum, end_of_period, min, max avg collapse_aggregation=sum limit No N\u00famero entero positivo, no mayor que 1000. 100 limit=50 start No N\u00famero entero positivo o 0. 0 start=100 start_date No Fecha y hora en formato ISO 8601. Si no se especifica este par\u00e1metro, se devuelven los datos disponibles para la serie o series desde el valor m\u00e1s antiguo. N/A start_date=2016-11-30 start_date=2016-11 start_date=2016 end_date No Fecha y hora en formato ISO 8601. Si no se especifica este par\u00e1metro, se devuelven los datos disponibles para la serie o series hasta el valor m\u00e1s reciente. N/A end_date=2016-11-30 end_date=2016-11 end_date=2016 format No Uno de: json, csv json format=csv header No Uno de: titles, ids, descriptions titles header=ids sort No Uno de: asc, desc asc sort=desc metadata No Uno de: none, simple, full, only simple metadata=none decimal No Caracter utilizado para los decimales. Uno de: \",\" o \".\" . decimal=, sep No Caracter separador de los valores del CSV. Cualquier caracter UTF-8 , sep=| flatten No Aplana la respuesta de metadatos en un objeto con un \u00fanico nivel (sin objetos anidados). No es necesario darle valor flatten last No Modifica el pedido para devolver los \u00faltimos N valores de la(s) serie(s), en orden de fechas ascendiente. Mutuamente exclusivo con `sort`, `start`, y `limit`. N/A last=12","title":"Tabla de par\u00e1metros"},{"location":"reference/api-reference/#ids","text":"Lista separada por comas de los identificadores de las series a seleccionar para armar la respuesta. Los datos del resultado de la llamada tendr\u00e1n una columna por cada serie seleccionada, en el mismo orden. Este par\u00e1metro es requerido para la llamada . En caso de no suministrarse, se devolver\u00e1 un error. Cada identificador de serie podr\u00e1 ser sufijado con: Un modo de representaci\u00f3n ( representation_mode ). Una funci\u00f3n de agregaci\u00f3n temporal ( collapse_aggregation ). Cuando estos atributos se utilizan como parte del par\u00e1metro ids , se deben separar usando el caracter \":\". El orden de los componentes no incide en el resultado de la operaci\u00f3n. Ejemplos: ids=2.4_DGI_1993_T_19,134.2_B_0_0_6:change ids=2.4_DGI_1993_T_19,134.2_B_0_0_6:sum:change ids=2.4_DGI_1993_T_19,134.2_B_0_0_6:change:sum ids=2.4_DGI_1993_T_19:percent_change,134.2_B_0_0_6:sum:change ids=2.4_DGI_1993_T_19:end_of_period:percent_change,134.2_B_0_0_6:sum:change","title":"ids"},{"location":"reference/api-reference/#representation_mode","text":"Este par\u00e1metro indica el modo de representaci\u00f3n de las series, y se aplica a todas aquellas que no tengan otro modo de representaci\u00f3n distinto indicado en el par\u00e1metro ids en forma individual. El modo de representaci\u00f3n por defecto es el valor medido en la serie ( value ). Los modos de representaci\u00f3n disponibles son: value : Es el modo de representaci\u00f3n por defecto. Devuelve el valor medido en la serie. change : Devuelve la diferencia absoluta entre el valor del per\u00edodo t y el de t-1. percent_change : Devuelve la variaci\u00f3n porcentual entre el valor del per\u00edodo t y el de t-1. percent_change_a_year_ago : Devuelve la variaci\u00f3n porcentual entre el valor del per\u00edodo t y el del per\u00edodo t equivalente de hace un a\u00f1o atr\u00e1s. Las funciones de transformaci\u00f3n disponibles en representation_mode tambi\u00e9n pueden especificarse para series individuales usando la notaci\u00f3n :percent_change junto al id de la serie: EMAE Construcci\u00f3n. Variaci\u00f3n porcentual de valores mensuales, respecto del per\u00edodo anterior. https://apis.datos.gob.ar/series/api/series/?limit=1000&ids=11.3_VMATC_2004_M_12:percent_change EMAE Construcci\u00f3n (variaci\u00f3n porcentual per\u00edodo a per\u00edodo), EMAE Construcci\u00f3n (variaci\u00f3n porcentual interanual). Valores mensuales. https://apis.datos.gob.ar/series/api/series/?limit=1000&ids=11.3_VMATC_2004_M_12:percent_change,11.3_VMATC_2004_M_12:percent_change_a_year_ago El par\u00e1metro representation_mode seguir\u00e1 afectando a todas las series para las cuales no se especifique individualmente una funci\u00f3n de transformaci\u00f3n.","title":"representation_mode"},{"location":"reference/api-reference/#collapse","text":"El par\u00e1metro collapse modifica la frecuencia de muestreo de los datos de la serie o las series solicitadas. Debe usarse en combinaci\u00f3n con collapse_aggregation para indicar una funnci\u00f3n de agregaci\u00f3n temporal, cuando corresponda. Las opciones disponibles son: year : Muestra datos agregados anualmente. quarter : Muestra datos agregados trimestralmente. month : Muestra datos agregados mensualmente. week : Muestra datos agregados semanalmente. day : Muestra datos agregados diariamente. Si no se indica, se retornan los datos con la frecuencia original de la serie . Si se solicitan m\u00faltiples series de distintas frecuencias , se utilizar\u00e1 la menor frecuencia de todas ellas (Ej.: si se solicitan a la vez una serie diaria, una mensual y una trimestral, se convertir\u00e1n todas las series a la frecuencia trimestral). Si la granularidad temporal solicitada en el valor de collapse es menor a la granularidad propia de alguna de las series solicitadas, la consulta devolver\u00e1 un error. El par\u00e1metro collapse afecta globalmente a todas las series seleccionadas por el par\u00e1metro ids en la llamada.","title":"collapse"},{"location":"reference/api-reference/#collapse_aggregation","text":"El par\u00e1metro collapse_aggregation indica la funci\u00f3n de agregaci\u00f3n temporal que debe usarse para homogeneizar la frecuencia temporal de todas las series solicitadas (Ej.: qu\u00e9 operaci\u00f3n realizar para convertir una serie mensual en anual). Esta funci\u00f3n de agregaci\u00f3n actuar\u00e1 sobre: Las series agrupadas de mayor granularidad temporal (frecuencia m\u00e1s alta) que la granularidad indicada por el par\u00e1metro collapse En caso de que no se especifique el par\u00e1metro collapse , las series agrupadas de mayor granularidad temporal que la de la serie de menor frecuencia temporal. Los valores disponibles para el par\u00e1metro son: avg : Realiza el promedio de todos los valores agrupados. Es la opci\u00f3n por defecto si no se indica valor para collapse_aggregation . sum : Suma todos los valores agrupados. end_of_period : \u00daltimo valor del per\u00edodo. min : M\u00ednimo entre los valores agrupados. max : M\u00e1ximo entre los valores agrupados. Las funciones de agregaci\u00f3n temporal disponibles en collapse_aggregation tambi\u00e9n pueden especificarse para series individuales usando la notaci\u00f3n :sum junto al id de la serie: Cobro de servicios de turismo y viajes. Valores mensuales promediados y sumados por a\u00f1o. https://apis.datos.gob.ar/series/api/series/?ids=185.1_COBRO_SERVJES_0_M_30:avg,185.1_COBRO_SERVJES_0_M_30:sum&collapse=year El par\u00e1metro collapse_aggregation seguir\u00e1 afectando a todas las series para las cuales no se especifique individualmente una funci\u00f3n de agregaci\u00f3n temporal. Cobro de servicios de turismo y viajes. Valores mensuales promediados y sumados por a\u00f1o. https://apis.datos.gob.ar/series/api/series/?ids=185.1_COBRO_SERVJES_0_M_30:avg,185.1_COBRO_SERVJES_0_M_30&collapse=year&collapse_aggregation=sum","title":"collapse_aggregation"},{"location":"reference/api-reference/#limit","text":"Este par\u00e1metro es utilizado junto a start para controlar el paginado de los resultados devueltos por la API. Debe especificarse un n\u00famero entero positivo, no mayor que 1000, ya que esa es la cantidad m\u00e1xima de resultados devueltos por la API. El valor por defecto si no se especifica valor alguno es 100.","title":"limit"},{"location":"reference/api-reference/#start","text":"Este par\u00e1metro es utilizado junto a limit para controlar el paginado de los resultados devueltos por la API. Debe especificarse un n\u00famero entero positivo o 0. El valor por defecto si no se especifica valor alguno es 0. El start indica el \"n\u00famero de per\u00edodos despu\u00e9s de start_date \" (o el \"n\u00famero de per\u00edodos antes de end_date \", dependiendo del ordenamiento asc o desc del par\u00e1metro sort ) que se saltean desde el comienzo o el final de la serie antes de empezar a devolver valores.","title":"start"},{"location":"reference/api-reference/#start_date","text":"El par\u00e1metro start_date indica la fecha menor a partir de la cual se comenzar\u00e1n a recolectar datos para la respuesta. Los valores cuyo \u00edndice de tiempo coincida con el valor de start_date se incluir\u00e1n en el resultado retornado. Se utilizar\u00e1 como filtro sobre el \u00edndice de tiempo de las series de datos.","title":"start_date"},{"location":"reference/api-reference/#end_date","text":"El par\u00e1metro end_date indica la fecha mayor hasta la cual se recolectar\u00e1n datos para la respuesta. Los valores cuyo \u00edndice de tiempo coincida con el valor de end_date se incluir\u00e1n en el resultado retornado. Se utilizar\u00e1 como filtro sobre el \u00edndice de tiempo de las series de datos.","title":"end_date"},{"location":"reference/api-reference/#format","text":"Especifica el formato de la respuesta, siendo json el valor por defecto. Las opciones disponibles son: json : Devuelve un objeto json con datos y metadatos de las series. csv : Devuelve las series seleccionadas en formato separado por comas. Este tipo de formato no incluye metadatos de las series seleccionadas.","title":"format"},{"location":"reference/api-reference/#header","text":"Especifica los atributos de las series a utilizar como headers (cabeceras) de las columnas del archivo CSV generado. Por defecto usa titles , que son los t\u00edtulos de las series. Las opciones disponibles son: titles : T\u00edtulos de las series, por ejemplo oferta_global_pib (default). ids : Identificadores \u00fanicos de las series, los mismos pasados al par\u00e1metro ids . descriptions : Descripciones completas de las series, por ejemplo Plazo fijo entre 60-89 d\u00edas en millones de pesos. Categor\u00eda II-VI","title":"header"},{"location":"reference/api-reference/#sort","text":"Especifica el orden temporal de los resultados devueltos, siendo asc el valor por defecto. Las opciones disponibles son: asc : Se devuelven los valores m\u00e1s antiguos primero (default). desc : Se devuelven los valores m\u00e1s recientes primero.","title":"sort"},{"location":"reference/api-reference/#metadata","text":"Especifica el nivel de detalle de metadatos requerido por el usuario, siendo simple el valor por defecto. S\u00f3lo aplica cuando format=json . Las opciones disponibles son: none : No se devuelven metadatos, s\u00f3lo datos. only : No se devuelven datos, s\u00f3lo metadatos. simple : Se devuelven los metadatos m\u00e1s importantes para comprender y utilizar las series (default). full : Se devuelven todos los metadatos disponibles que tengan relaci\u00f3n con cada serie.","title":"metadata"},{"location":"reference/api-reference/#decimal","text":"Especifica el caracter utilizado para los n\u00fameros decimales, siendo . el valor por defecto. S\u00f3lo aplica cuando format=csv . Las opciones disponibles son: , : Coma. . : Punto.","title":"decimal"},{"location":"reference/api-reference/#sep","text":"Especifica el caracter separador de valores, siendo , el valor por defecto. S\u00f3lo aplica cuando format=csv . Se puede utilizar cualquier caracter UTF-8, si bien se recomienda preservar el uso de la coma en la mayor\u00eda de los casos.","title":"sep"},{"location":"reference/api-reference/#flatten","text":"Especifica si la respuesta de los metadatos de las series pedidas deber\u00edan devolverse en una jerarqu\u00eda plana . Cuando el par\u00e1metro no es incluido, la respuesta tiene la siguiente estructura: { \"catalog\": [], \"dataset\": [], \"distribution\": [], \"field\": [], } Una consulta con par\u00e1metro flatten incluido tendr\u00e1 la siguiente respuesta de metadatos: { catalog_meta1: ..., catalog_meta2: ..., dataset_meta1: ..., _: ... }","title":"flatten"},{"location":"reference/api-reference/#last","text":"Modifica el pedido para devolver los \u00faltimos N valores de la(s) serie(s), en orden de fechas ascendiente. Mutuamente exclusivo con sort , start , y limit . Un pedido con last=N es equivalente a invertir el orden de un pedido con sort=desc , limit=N .","title":"last"},{"location":"reference/search-reference/","text":"Referencia API: search Tabla de par\u00e1metros q dataset_theme , units , dataset_publisher_name , dataset_source , catalog_id limit start Referencia API: search Recurso: /search El recurso /search permite buscar series a partir de un texto, proporcionando adem\u00e1s algunos filtros (ej.: por tema o por unidades de las series). Tabla de par\u00e1metros Nombre Requerido Descripci\u00f3n Default Ejemplos q No Texto N/A q=ipc dataset_theme No Uno de los valores listados en /search/dataset_theme N/A dataset_theme=\"Finanzas P\u00fablicas\" units No Uno de los valores listados en /search/field_units N/A units=\"Millones de pesos\" dataset_publisher_name No Uno de los valores listados en /search/dataset_publisher_name N/A dataset_publisher_name=\"Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" dataset_source No Uno de los valores listados en /search/dataset_source N/A dataset_source=\"Ministerio de Hacienda\" catalog_id No Uno de los valores listados en /search/catalog_id N/A catalog_id=\"sspm\" limit No N\u00famero entero positivo, no mayor que 1000. 10 limit=50 start No N\u00famero entero positivo o 0. 0 start=100 aggregations No N/A N/A N/A q Texto de entrada a buscar en la base de series de tiempo. Puede ser abritrariamente largo, pero se recomienda ingresar una o m\u00e1s palabras clave. dataset_theme , units , dataset_publisher_name , dataset_source , catalog_id Estos par\u00e1metros pueden ser usados como filtros en los resultados de la b\u00fasqueda . Al aplicarse, se muestran \u00fanicamente aquellos resultados que sean compatibles con la especificaci\u00f3n. Por ejemplo: un pedido con units=Millones de pesos s\u00f3lo contendr\u00e1 series de tiempo que est\u00e9n expresadas en millones de pesos. Los t\u00e9rminos que aceptan estos par\u00e1metros son especificados en recursos auxiliares que devuelven la lista entera de valores aceptados en los filtros. Por ejemplo: un pedido a /search/field_units devuelve una lista de los t\u00e9rminos que se le pueden pasar al par\u00e1metro units . Cualquier otra opci\u00f3n devolver\u00e1 una lista vac\u00eda de resultados (al no haber coincidencias). Consultar la tabla de par\u00e1metros para ver los endpoints auxiliares. limit Este par\u00e1metro es utilizado junto a start para controlar el paginado de los resultados devueltos por la API. Debe especificarse un n\u00famero entero positivo, no mayor que 1000, ya que esa es la cantidad m\u00e1xima de resultados devueltos por la API. El valor por defecto si no se especifica valor alguno es 10. start Este par\u00e1metro es utilizado junto a limit para controlar el paginado de los resultados devueltos por la API. Debe especificarse un n\u00famero entero positivo o 0. El valor por defecto si no se especifica valor alguno es 0. El start indica el \"n\u00famero de resultados despu\u00e9s del inicio\" que se saltea el buscador para el armado de la respuesta. aggregations La presencia de este par\u00e1metro agrega un objeto nuevo a la respuesta de la API bajo la clave aggregations , que contiene la cantidad de ocurrencias totales de la b\u00fasqueda discriminando por los distintos filtros posibles. Si el par\u00e1metro no est\u00e1 presente, no se calculan las agregaciones. Un ejemplo posible de la respuesta: { \"aggregations\" : { \"dataset_theme\" : [ { \"label\" : \"Finanzas P\u00fablicas\" , \"series_count\" : 904 }, { \"label\" : \"Precios\" , \"series_count\" : 522 }, { \"label\" : \"Sector Externo\" , \"series_count\" : 21 } ], \"units\" : [ { \"label\" : \"Millones de pesos\" , \"series_count\" : 904 }, { \"label\" : \"\u00cdndice\" , \"series_count\" : 509 }, { \"label\" : \"Millones de d\u00f3lares\" , \"series_count\" : 21 }, { \"label\" : \"Variaci\u00f3n Porcentual\" , \"series_count\" : 12 }, { \"label\" : \"Variaci\u00f3n intermensual\" , \"series_count\" : 1 } ], \"dataset_publisher_name\" : [ { \"label\" : \"Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" , \"series_count\" : 1447 } ], \"dataset_source\" : [ { \"label\" : \"Ministerio de Hacienda\" , \"series_count\" : 925 }, { \"label\" : \"Instituto Nacional de Estad\u00edstica y Censos (INDEC)\" , \"series_count\" : 522 } ], \"catalog_id\" : [ { \"label\" : \"sspm\" , \"series_count\" : 1447 } ] } }","title":"/search"},{"location":"reference/search-reference/#referencia-api-search","text":"Recurso: /search El recurso /search permite buscar series a partir de un texto, proporcionando adem\u00e1s algunos filtros (ej.: por tema o por unidades de las series).","title":"Referencia API: search"},{"location":"reference/search-reference/#tabla-de-parametros","text":"Nombre Requerido Descripci\u00f3n Default Ejemplos q No Texto N/A q=ipc dataset_theme No Uno de los valores listados en /search/dataset_theme N/A dataset_theme=\"Finanzas P\u00fablicas\" units No Uno de los valores listados en /search/field_units N/A units=\"Millones de pesos\" dataset_publisher_name No Uno de los valores listados en /search/dataset_publisher_name N/A dataset_publisher_name=\"Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" dataset_source No Uno de los valores listados en /search/dataset_source N/A dataset_source=\"Ministerio de Hacienda\" catalog_id No Uno de los valores listados en /search/catalog_id N/A catalog_id=\"sspm\" limit No N\u00famero entero positivo, no mayor que 1000. 10 limit=50 start No N\u00famero entero positivo o 0. 0 start=100 aggregations No N/A N/A N/A","title":"Tabla de par\u00e1metros"},{"location":"reference/search-reference/#q","text":"Texto de entrada a buscar en la base de series de tiempo. Puede ser abritrariamente largo, pero se recomienda ingresar una o m\u00e1s palabras clave.","title":"q"},{"location":"reference/search-reference/#dataset_theme-units-dataset_publisher_name-dataset_source-catalog_id","text":"Estos par\u00e1metros pueden ser usados como filtros en los resultados de la b\u00fasqueda . Al aplicarse, se muestran \u00fanicamente aquellos resultados que sean compatibles con la especificaci\u00f3n. Por ejemplo: un pedido con units=Millones de pesos s\u00f3lo contendr\u00e1 series de tiempo que est\u00e9n expresadas en millones de pesos. Los t\u00e9rminos que aceptan estos par\u00e1metros son especificados en recursos auxiliares que devuelven la lista entera de valores aceptados en los filtros. Por ejemplo: un pedido a /search/field_units devuelve una lista de los t\u00e9rminos que se le pueden pasar al par\u00e1metro units . Cualquier otra opci\u00f3n devolver\u00e1 una lista vac\u00eda de resultados (al no haber coincidencias). Consultar la tabla de par\u00e1metros para ver los endpoints auxiliares.","title":"dataset_theme, units, dataset_publisher_name, dataset_source, catalog_id"},{"location":"reference/search-reference/#limit","text":"Este par\u00e1metro es utilizado junto a start para controlar el paginado de los resultados devueltos por la API. Debe especificarse un n\u00famero entero positivo, no mayor que 1000, ya que esa es la cantidad m\u00e1xima de resultados devueltos por la API. El valor por defecto si no se especifica valor alguno es 10.","title":"limit"},{"location":"reference/search-reference/#start","text":"Este par\u00e1metro es utilizado junto a limit para controlar el paginado de los resultados devueltos por la API. Debe especificarse un n\u00famero entero positivo o 0. El valor por defecto si no se especifica valor alguno es 0. El start indica el \"n\u00famero de resultados despu\u00e9s del inicio\" que se saltea el buscador para el armado de la respuesta.","title":"start"},{"location":"reference/search-reference/#aggregations","text":"La presencia de este par\u00e1metro agrega un objeto nuevo a la respuesta de la API bajo la clave aggregations , que contiene la cantidad de ocurrencias totales de la b\u00fasqueda discriminando por los distintos filtros posibles. Si el par\u00e1metro no est\u00e1 presente, no se calculan las agregaciones. Un ejemplo posible de la respuesta: { \"aggregations\" : { \"dataset_theme\" : [ { \"label\" : \"Finanzas P\u00fablicas\" , \"series_count\" : 904 }, { \"label\" : \"Precios\" , \"series_count\" : 522 }, { \"label\" : \"Sector Externo\" , \"series_count\" : 21 } ], \"units\" : [ { \"label\" : \"Millones de pesos\" , \"series_count\" : 904 }, { \"label\" : \"\u00cdndice\" , \"series_count\" : 509 }, { \"label\" : \"Millones de d\u00f3lares\" , \"series_count\" : 21 }, { \"label\" : \"Variaci\u00f3n Porcentual\" , \"series_count\" : 12 }, { \"label\" : \"Variaci\u00f3n intermensual\" , \"series_count\" : 1 } ], \"dataset_publisher_name\" : [ { \"label\" : \"Subsecretar\u00eda de Programaci\u00f3n Macroecon\u00f3mica.\" , \"series_count\" : 1447 } ], \"dataset_source\" : [ { \"label\" : \"Ministerio de Hacienda\" , \"series_count\" : 925 }, { \"label\" : \"Instituto Nacional de Estad\u00edstica y Censos (INDEC)\" , \"series_count\" : 522 } ], \"catalog_id\" : [ { \"label\" : \"sspm\" , \"series_count\" : 1447 } ] } }","title":"aggregations"}]}
\ No newline at end of file
diff --git a/docs/sitemap.xml b/docs/sitemap.xml
index c02dff1a..535372f6 100644
--- a/docs/sitemap.xml
+++ b/docs/sitemap.xml
@@ -2,42 +2,42 @@
http://apis.datos.gob.ar/series/
- 2019-03-06
+ 2019-03-07
daily
http://apis.datos.gob.ar/series/quick-start/
- 2019-03-06
+ 2019-03-07
daily
http://apis.datos.gob.ar/series/additional-parameters/
- 2019-03-06
+ 2019-03-07
daily
http://apis.datos.gob.ar/series/spreadsheet-integration/
- 2019-03-06
+ 2019-03-07
daily
http://apis.datos.gob.ar/series/python-usage/
- 2019-03-06
+ 2019-03-07
daily
http://apis.datos.gob.ar/series/dumps/
- 2019-03-06
+ 2019-03-07
daily
http://apis.datos.gob.ar/series/reference/api-reference/
- 2019-03-06
+ 2019-03-07
daily
http://apis.datos.gob.ar/series/reference/search-reference/
- 2019-03-06
+ 2019-03-07
daily
@@ -47,32 +47,32 @@
http://apis.datos.gob.ar/series/terms/
- 2019-03-06
+ 2019-03-07
daily
http://apis.datos.gob.ar/series/applications/
- 2019-03-06
+ 2019-03-07
daily
http://apis.datos.gob.ar/series/developers/arquitectura/
- 2019-03-06
+ 2019-03-07
daily
http://apis.datos.gob.ar/series/developers/development/
- 2019-03-06
+ 2019-03-07
daily
http://apis.datos.gob.ar/series/developers/admin/
- 2019-03-06
+ 2019-03-07
daily
http://apis.datos.gob.ar/series/history/
- 2019-03-06
+ 2019-03-07
daily
\ No newline at end of file
diff --git a/docs/sitemap.xml.gz b/docs/sitemap.xml.gz
index 7dbe9b034202872471a46e102e0db6b1be64e1b1..96993d70d5049bd8fab07dc65e9dd4756e57cf8b 100644
GIT binary patch
literal 347
zcmV-h0i^yPiwFqZCV^Z6|8r?{Wo=<_E_iKh0L_+7R>L3=$M>EhFMC3&3#~6rcb-5G
zFotQuGkkPr(%Rcg+Nj;SP+DxuBy5$(09RD-*3v7=O^`0
zZrht?qLERG6zq9Z4kGbU>*MiQu@!U>xeC;4?uKNrUYxqF)@6HBq%u!%X%)>Fx^|fX
zqUFkf1g`qN{26r|!kKgmeS=9(RQM)_@&PjlS|+
z2=o`iPhs|x?cNj%kmLmh##l*-gHc5wa40E}c_DHn1j7TODC-4#f|)ok$as<=cr`Kf
zm=~FuT+A$^ggd095jcmaZ!1$sMxbu^FV5@5{$k%r09-$al^8BP8
z%58hoOf)h|k%B#M%0VPPYJEH&E4G3TB3FTW&E1d;){9fu)w*nNid5zaF0G;&L)R`d
zK(t&Lkib-k^=)Me$q3X9|HXN|*k9~B34qJ&zCetl?ar@0Gctn*97CKn
t6DWziU?&qnwvbEHp_hCQ(m0!$x(}8m(CPP}&Q