Airly (Publicador independiente)
Airly proporciona datos precisos e hiper-locales sobre la contaminación del aire en su comunidad. Este es el primer paso para comprender los riesgos de salud y realizar mejoras.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Tomasz Poszytek |
| URL | https://aka.ms/poszytek |
| Correo Electrónico | tomasz@poszytek.eu |
| Metadatos del conector | |
|---|---|
| Publicador | Tomasz Poszytek |
| Sitio web | https://airly.org/ |
| Directiva de privacidad | https://airly.org/en/terms-conditions/ |
| Categorías | Internet de las cosas; Estilo de vida y entretenimiento |
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Clave de API | securestring | La clave de API de esta API | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Obtención de la instalación por identificador |
La operación devuelve metadatos de instalación únicos, proporcionados por InstallationId. |
| Obtención de medidas disponibles |
El punto de conexión devuelve una lista de todos los tipos de medida admitidos en la API junto con sus nombres y unidades. |
| Obtención de medidas para la instalación |
El punto de conexión devuelve medidas para la instalación concreta dada por InstallationId. |
| Obtención de medidas para un punto |
El punto de conexión devuelve medidas para cualquier ubicación geográfica. Los valores de medición se interpolan mediante mediciones medias de sensores cercanos (hasta 1,5km lejos del punto dado). El valor devuelto es un promedio ponderado, con el peso inversamente proporcional a la distancia desde el sensor hasta el punto dado. |
| Obtención de índices disponibles |
Endpoint devuelve una lista de todos los tipos de índice admitidos en la API junto con listas de niveles definidos por cada tipo de índice. |
| Obtener instalaciones más cercanas |
Endpoint devuelve la lista de instalaciones más cercanas a un punto determinado, ordenados por distancia a ese punto. |
| Obtener medidas más cercanas |
El punto de conexión devuelve medidas para una instalación más cercana a una ubicación determinada. |
Obtención de la instalación por identificador
La operación devuelve metadatos de instalación únicos, proporcionados por InstallationId.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de instalación
|
InstallationID | True | integer |
Identificador de la instalación única para obtener metadatos. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
Id
|
id | integer |
Identificador de instalación único. Si tiene InstallationId, puede consultar medidas desde una instalación determinada. |
|
Latitude
|
location.latitude | float |
Coordenadas de instalación: latitud. Ubicación exacta del sensor en el mapa. |
|
Longitude
|
location.longitude | float |
Coordenadas de instalación: longitud. Ubicación exacta del sensor en el mapa. |
|
Id. de ubicación
|
locationId | integer |
Identificador de ubicación único. |
|
País
|
address.country | string |
País de instalación. El atributo es opcional, puede estar vacío o nulo. |
|
City
|
address.city | string |
Ciudad de instalación. El atributo es opcional, puede estar vacío o nulo. |
|
Calle
|
address.street | string |
Calle de instalación. El atributo es opcional, puede estar vacío o nulo. |
|
Number
|
address.number | string |
Número de la calle de instalación. El atributo es opcional, puede estar vacío o nulo. |
|
Dirección de presentación 1
|
address.displayAddress1 | string |
Campo adicional que describe la dirección, por ejemplo, el nombre o el número de la escuela. Campo opcional. |
|
Dirección de presentación 2
|
address.displayAddress2 | string |
Campo adicional que describe la dirección, por ejemplo, el nombre o el número de la escuela. Campo opcional. |
|
Elevation
|
elevation | float |
Altitud a la que está instalado el dispositivo; metros por encima del nivel medio del mar (mamsl). |
|
Aire acondicionado
|
airly | boolean |
Marca que indica si esta instalación es un dispositivo Airly o no; Por ejemplo, las estaciones de GIOŚ se marcan como falsas. |
|
Id
|
sponsor.id | integer |
Identificador del patrocinador. |
|
Nombre
|
sponsor.name | string |
Nombre del patrocinador de esta instalación. |
|
Description
|
sponsor.description | string |
Descripción adicional del patrocinador de esta instalación. |
|
Logotipo
|
sponsor.logo | string |
Dirección URL que apunta al logotipo del patrocinador (imagen jpg). |
|
Link
|
sponsor.link | string |
Dirección URL que apunta al sitio web del patrocinador. |
Obtención de medidas disponibles
El punto de conexión devuelve una lista de todos los tipos de medida admitidos en la API junto con sus nombres y unidades.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Language
|
Accept-Language | string |
Idioma en el que se deben devolver descripciones de texto. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
Nombre
|
name | string |
Nombre de este tipo de medida, por ejemplo, PM10. |
|
Etiqueta
|
label | string |
Nombre descriptivo de este tipo de medida (campo traducido). |
|
Unidad
|
unit | string |
Unidad de este tipo de medida, por ejemplo, μg/m3. |
Obtención de medidas para la instalación
El punto de conexión devuelve medidas para la instalación concreta dada por InstallationId.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de instalación
|
installationId | True | integer |
Identificador de instalación para el que se devuelven las medidas. |
|
Language
|
Accept-Language | string |
Idioma en el que se deben devolver descripciones de texto. |
|
|
Tipo de índice
|
indexType | string |
Selecciona el tipo del índice que se debe calcular y devolver en respuesta. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Desde DateTime: actual
|
current.fromDateTime | string |
ISO8601 marca de tiempo. Fecha y hora en UTC. El campo representa la hora de inicio a partir de la cual se midieron y promediaron los datos de esta carga. |
|
Till DateTime: current
|
current.tillDateTime | string |
ISO8601 marca de tiempo. Fecha y hora en UTC. El campo representa la hora de finalización a la que se midieron y promediaron los datos de esta carga. |
|
values
|
current.values | array of object |
Valores: actual. |
|
Nombre de medida: actual
|
current.values.name | string |
Nombre (tipo) de la medida especificada; Por ejemplo, PM10. |
|
Valor de medida: actual
|
current.values.value | float |
Valor medido del tipo de medida especificado, por ejemplo, concentración de 25μg/m3. |
|
índices
|
current.indexes | array of object |
Índices: actual. |
|
Nombre del índice: actual
|
current.indexes.name | string |
Nombre del índice (por ejemplo, CAQI o PIJP). |
|
Valor de índice: actual
|
current.indexes.value | float |
Valor numérico del índice calculado. |
|
Nivel: actual
|
current.indexes.level | string |
Nivel discreto del índice (por ejemplo, HIGH, o LOW, etc.). |
|
Descripción: actual
|
current.indexes.description | string |
Descripción del nivel de índice. Texto traducido y devuelto en un idioma según Accept-Language encabezado de solicitud. |
|
Consejo: actual
|
current.indexes.advice | string |
Texto adicional con consejos sobre el nivel de índice actual. Texto traducido y devuelto en un idioma según Accept-Language encabezado de solicitud. |
|
Color: actual
|
current.indexes.color | string |
Color que representa el nivel de índice en forma de triplete RGB hexadecimal (por ejemplo, #D1CF1E). |
|
standards
|
current.standards | array of object |
Estándares: actual. |
|
Nombre estándar: actual
|
current.standards.name | string |
Nombre de este estándar. Actualmente solo se admiten los estándares de la OMS. |
|
Contaminante - corriente
|
current.standards.pollutant | string |
Nombre del contaminante al que se aplica esta norma, actualmente solo se admiten PM10 y PM25. |
|
Límite: actual
|
current.standards.limit | float |
Cierto nivel medio de concentración del contaminante que no debe superarse durante un período de tiempo determinado; es decir, este es el valor para el que la concentración de contaminantes alcanza 100% del límite. |
|
Porcentaje: actual
|
current.standards.percent | float |
Valor de concentración de un contaminante determinado expresado como un porcentaje de esta concentración en el estándar / límite, por ejemplo, para un estándar de 50μg/m3 de PM10, la concentración de 25μg/m3 se expresa como 50%. |
|
Promedio: actual
|
current.standards.averaging | string |
Los valores de medición se interpolan mediante mediciones medias de sensores cercanos (hasta 1,5km lejos del punto dado). |
|
historia
|
history | array of object |
Entradas históricas. |
|
Desde DateTime: historial
|
history.fromDateTime | string |
ISO8601 marca de tiempo. Fecha y hora en UTC. El campo representa la hora de inicio a partir de la cual se midieron y promediaron los datos de esta carga. |
|
Till DateTime: historial
|
history.tillDateTime | string |
ISO8601 marca de tiempo. Fecha y hora en UTC. El campo representa la hora de finalización a la que se midieron y promediaron los datos de esta carga. |
|
values
|
history.values | array of object |
Valores: historial. |
|
Nombre de medida: historial
|
history.values.name | string |
Nombre (tipo) de la medida especificada; Por ejemplo, PM10. |
|
Valor de medida: historial
|
history.values.value | float |
Valor medido del tipo de medida especificado, por ejemplo, concentración de 25μg/m3. |
|
índices
|
history.indexes | array of object |
Índices: historial. |
|
Nombre estándar: historial
|
history.indexes.name | string |
Nombre de este estándar. Actualmente solo se admiten los estándares de la OMS. |
|
Contaminante - historia
|
history.indexes.pollutant | string |
Nombre del contaminante al que se aplica esta norma, actualmente solo se admiten PM10 y PM25. |
|
Límite: historial
|
history.indexes.limit | float |
Cierto nivel medio de concentración del contaminante que no debe superarse durante un período de tiempo determinado; es decir, este es el valor para el que la concentración de contaminantes alcanza 100% del límite. |
|
Porcentaje: historial
|
history.indexes.percent | float |
Valor de concentración de un contaminante determinado expresado como un porcentaje de esta concentración en el estándar / límite, por ejemplo, para un estándar de 50μg/m3 de PM10, la concentración de 25μg/m3 se expresa como 50%. |
|
Promedio: historial
|
history.indexes.averaging | string |
Los valores de medición se interpolan mediante mediciones medias de sensores cercanos (hasta 1,5km lejos del punto dado). |
|
standards
|
history.standards | array of object |
Estándares: historial. |
|
Nombre estándar: historial
|
history.standards.name | string |
Nombre de este estándar. Actualmente solo se admiten los estándares de la OMS. |
|
Contaminante - historia
|
history.standards.pollutant | string |
Nombre del contaminante al que se aplica esta norma, actualmente solo se admiten PM10 y PM25. |
|
Límite: historial
|
history.standards.limit | float |
Cierto nivel medio de concentración del contaminante que no debe superarse durante un período de tiempo determinado; es decir, este es el valor para el que la concentración de contaminantes alcanza 100% del límite. |
|
Porcentaje: historial
|
history.standards.percent | float |
Valor de concentración de un contaminante determinado expresado como un porcentaje de esta concentración en el estándar / límite, por ejemplo, para un estándar de 50μg/m3 de PM10, la concentración de 25μg/m3 se expresa como 50%. |
|
Promedio: historial
|
history.standards.averaging | string |
Los valores de medición se interpolan mediante mediciones medias de sensores cercanos (hasta 1,5km lejos del punto dado). |
|
previsión
|
forecast | array of object |
Entradas de previsión. |
|
Desde DateTime: previsión
|
forecast.fromDateTime | string |
ISO8601 marca de tiempo. Fecha y hora en UTC. El campo representa la hora de inicio a partir de la cual se midieron y promediaron los datos de esta carga. |
|
Till DateTime: previsión
|
forecast.tillDateTime | string |
ISO8601 marca de tiempo. Fecha y hora en UTC. El campo representa la hora de finalización a la que se midieron y promediaron los datos de esta carga. |
|
values
|
forecast.values | array of object |
Valores: previsión. |
|
Nombre de medida: previsión
|
forecast.values.name | string |
Nombre (tipo) de la medida especificada; Por ejemplo, PM10. |
|
Valor de medida: previsión
|
forecast.values.value | float |
Valor medido del tipo de medida especificado, por ejemplo, concentración de 25μg/m3. |
|
índices
|
forecast.indexes | array of object |
Índices: previsión. |
|
Nombre estándar: previsión
|
forecast.indexes.name | string |
Nombre de este estándar. Actualmente solo se admiten los estándares de la OMS. |
|
Contaminante: previsión
|
forecast.indexes.pollutant | string |
Nombre del contaminante al que se aplica esta norma, actualmente solo se admiten PM10 y PM25. |
|
Límite: previsión
|
forecast.indexes.limit | float |
Cierto nivel medio de concentración del contaminante que no debe superarse durante un período de tiempo determinado; es decir, este es el valor para el que la concentración de contaminantes alcanza 100% del límite. |
|
Porcentaje: previsión
|
forecast.indexes.percent | float |
Valor de concentración de un contaminante determinado expresado como un porcentaje de esta concentración en el estándar / límite, por ejemplo, para un estándar de 50μg/m3 de PM10, la concentración de 25μg/m3 se expresa como 50%. |
|
Promedio: previsión
|
forecast.indexes.averaging | string |
Los valores de medición se interpolan mediante mediciones medias de sensores cercanos (hasta 1,5km lejos del punto dado). |
|
standards
|
forecast.standards | array of object |
Estándares: previsión. |
|
Nombre estándar: previsión
|
forecast.standards.name | string |
Nombre de este estándar. Actualmente solo se admiten los estándares de la OMS. |
|
Contaminante: previsión
|
forecast.standards.pollutant | string |
Nombre del contaminante al que se aplica esta norma, actualmente solo se admiten PM10 y PM25. |
|
Límite: previsión
|
forecast.standards.limit | float |
Cierto nivel medio de concentración del contaminante que no debe superarse durante un período de tiempo determinado; es decir, este es el valor para el que la concentración de contaminantes alcanza 100% del límite. |
|
Porcentaje: previsión
|
forecast.standards.percent | float |
Valor de concentración de un contaminante determinado expresado como un porcentaje de esta concentración en el estándar / límite, por ejemplo, para un estándar de 50μg/m3 de PM10, la concentración de 25μg/m3 se expresa como 50%. |
|
Promedio: previsión
|
forecast.standards.averaging | string |
Los valores de medición se interpolan mediante mediciones medias de sensores cercanos (hasta 1,5km lejos del punto dado). |
Obtención de medidas para un punto
El punto de conexión devuelve medidas para cualquier ubicación geográfica. Los valores de medición se interpolan mediante mediciones medias de sensores cercanos (hasta 1,5km lejos del punto dado). El valor devuelto es un promedio ponderado, con el peso inversamente proporcional a la distancia desde el sensor hasta el punto dado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Latitude
|
lat | True | number |
Latitud como grado decimal, por ejemplo, 50,062006. |
|
Longitude
|
lng | True | number |
Longitud como grado decimal, por ejemplo, 19,940984. |
|
Tipo de índice
|
indexType | string |
Selecciona el tipo del índice que se debe calcular y devolver en respuesta. |
|
|
Language
|
Accept-Language | string |
Idioma en el que se deben devolver descripciones de texto. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Desde DateTime: actual
|
current.fromDateTime | string |
ISO8601 marca de tiempo. Fecha y hora en UTC. El campo representa la hora de inicio a partir de la cual se midieron y promediaron los datos de esta carga. |
|
Till DateTime: current
|
current.tillDateTime | string |
ISO8601 marca de tiempo. Fecha y hora en UTC. El campo representa la hora de finalización a la que se midieron y promediaron los datos de esta carga. |
|
values
|
current.values | array of object |
Valores: actual. |
|
Nombre de medida: actual
|
current.values.name | string |
Nombre (tipo) de la medida especificada; Por ejemplo, PM10. |
|
Valor de medida: actual
|
current.values.value | float |
Valor medido del tipo de medida especificado, por ejemplo, concentración de 25μg/m3. |
|
índices
|
current.indexes | array of object |
Índices: actual. |
|
Nombre del índice: actual
|
current.indexes.name | string |
Nombre del índice (por ejemplo, CAQI o PIJP). |
|
Valor de índice: actual
|
current.indexes.value | float |
Valor numérico del índice calculado. |
|
Nivel: actual
|
current.indexes.level | string |
Nivel discreto del índice (por ejemplo, HIGH, o LOW, etc.). |
|
Descripción: actual
|
current.indexes.description | string |
Descripción del nivel de índice. Texto traducido y devuelto en un idioma según Accept-Language encabezado de solicitud. |
|
Consejo: actual
|
current.indexes.advice | string |
Texto adicional con consejos sobre el nivel de índice actual. Texto traducido y devuelto en un idioma según Accept-Language encabezado de solicitud. |
|
Color: actual
|
current.indexes.color | string |
Color que representa el nivel de índice en forma de triplete RGB hexadecimal (por ejemplo, #D1CF1E). |
|
standards
|
current.standards | array of object |
Estándares: actual. |
|
Nombre estándar: actual
|
current.standards.name | string |
Nombre de este estándar. Actualmente solo se admiten los estándares de la OMS. |
|
Contaminante - corriente
|
current.standards.pollutant | string |
Nombre del contaminante al que se aplica esta norma, actualmente solo se admiten PM10 y PM25. |
|
Límite: actual
|
current.standards.limit | float |
Cierto nivel medio de concentración del contaminante que no debe superarse durante un período de tiempo determinado; es decir, este es el valor para el que la concentración de contaminantes alcanza 100% del límite. |
|
Porcentaje: actual
|
current.standards.percent | float |
Valor de concentración de un contaminante determinado expresado como un porcentaje de esta concentración en el estándar / límite, por ejemplo, para un estándar de 50μg/m3 de PM10, la concentración de 25μg/m3 se expresa como 50%. |
|
Promedio: actual
|
current.standards.averaging | string |
Los valores de medición se interpolan mediante mediciones medias de sensores cercanos (hasta 1,5km lejos del punto dado). |
|
historia
|
history | array of object |
Entradas históricas. |
|
Desde DateTime: historial
|
history.fromDateTime | string |
ISO8601 marca de tiempo. Fecha y hora en UTC. El campo representa la hora de inicio a partir de la cual se midieron y promediaron los datos de esta carga. |
|
Till DateTime: historial
|
history.tillDateTime | string |
ISO8601 marca de tiempo. Fecha y hora en UTC. El campo representa la hora de finalización a la que se midieron y promediaron los datos de esta carga. |
|
values
|
history.values | array of object |
Valores: historial. |
|
Nombre de medida: historial
|
history.values.name | string |
Nombre (tipo) de la medida especificada; Por ejemplo, PM10. |
|
Valor de medida: historial
|
history.values.value | float |
Valor medido del tipo de medida especificado, por ejemplo, concentración de 25μg/m3. |
|
índices
|
history.indexes | array of object |
Índices: historial. |
|
Nombre estándar: historial
|
history.indexes.name | string |
Nombre de este estándar. Actualmente solo se admiten los estándares de la OMS. |
|
Contaminante - historia
|
history.indexes.pollutant | string |
Nombre del contaminante al que se aplica esta norma, actualmente solo se admiten PM10 y PM25. |
|
Límite: historial
|
history.indexes.limit | float |
Cierto nivel medio de concentración del contaminante que no debe superarse durante un período de tiempo determinado; es decir, este es el valor para el que la concentración de contaminantes alcanza 100% del límite. |
|
Porcentaje: historial
|
history.indexes.percent | float |
Valor de concentración de un contaminante determinado expresado como un porcentaje de esta concentración en el estándar / límite, por ejemplo, para un estándar de 50μg/m3 de PM10, la concentración de 25μg/m3 se expresa como 50%. |
|
Promedio: historial
|
history.indexes.averaging | string |
Los valores de medición se interpolan mediante mediciones medias de sensores cercanos (hasta 1,5km lejos del punto dado). |
|
standards
|
history.standards | array of object |
Estándares: historial. |
|
Nombre estándar: historial
|
history.standards.name | string |
Nombre de este estándar. Actualmente solo se admiten los estándares de la OMS. |
|
Contaminante - historia
|
history.standards.pollutant | string |
Nombre del contaminante al que se aplica esta norma, actualmente solo se admiten PM10 y PM25. |
|
Límite: historial
|
history.standards.limit | float |
Cierto nivel medio de concentración del contaminante que no debe superarse durante un período de tiempo determinado; es decir, este es el valor para el que la concentración de contaminantes alcanza 100% del límite. |
|
Porcentaje: historial
|
history.standards.percent | float |
Valor de concentración de un contaminante determinado expresado como un porcentaje de esta concentración en el estándar / límite, por ejemplo, para un estándar de 50μg/m3 de PM10, la concentración de 25μg/m3 se expresa como 50%. |
|
Promedio: historial
|
history.standards.averaging | string |
Los valores de medición se interpolan mediante mediciones medias de sensores cercanos (hasta 1,5km lejos del punto dado). |
|
previsión
|
forecast | array of object |
Entradas de previsión. |
|
Desde DateTime: previsión
|
forecast.fromDateTime | string |
ISO8601 marca de tiempo. Fecha y hora en UTC. El campo representa la hora de inicio a partir de la cual se midieron y promediaron los datos de esta carga. |
|
Till DateTime: previsión
|
forecast.tillDateTime | string |
ISO8601 marca de tiempo. Fecha y hora en UTC. El campo representa la hora de finalización a la que se midieron y promediaron los datos de esta carga. |
|
values
|
forecast.values | array of object |
Valores: previsión. |
|
Nombre de medida: previsión
|
forecast.values.name | string |
Nombre (tipo) de la medida especificada; Por ejemplo, PM10. |
|
Valor de medida: previsión
|
forecast.values.value | float |
Valor medido del tipo de medida especificado, por ejemplo, concentración de 25μg/m3. |
|
índices
|
forecast.indexes | array of object |
Índices: previsión. |
|
Nombre estándar: previsión
|
forecast.indexes.name | string |
Nombre de este estándar. Actualmente solo se admiten los estándares de la OMS. |
|
Contaminante: previsión
|
forecast.indexes.pollutant | string |
Nombre del contaminante al que se aplica esta norma, actualmente solo se admiten PM10 y PM25. |
|
Límite: previsión
|
forecast.indexes.limit | float |
Cierto nivel medio de concentración del contaminante que no debe superarse durante un período de tiempo determinado; es decir, este es el valor para el que la concentración de contaminantes alcanza 100% del límite. |
|
Porcentaje: previsión
|
forecast.indexes.percent | float |
Valor de concentración de un contaminante determinado expresado como un porcentaje de esta concentración en el estándar / límite, por ejemplo, para un estándar de 50μg/m3 de PM10, la concentración de 25μg/m3 se expresa como 50%. |
|
Promedio: previsión
|
forecast.indexes.averaging | string |
Los valores de medición se interpolan mediante mediciones medias de sensores cercanos (hasta 1,5km lejos del punto dado). |
|
standards
|
forecast.standards | array of object |
Estándares: previsión. |
|
Nombre estándar: previsión
|
forecast.standards.name | string |
Nombre de este estándar. Actualmente solo se admiten los estándares de la OMS. |
|
Contaminante: previsión
|
forecast.standards.pollutant | string |
Nombre del contaminante al que se aplica esta norma, actualmente solo se admiten PM10 y PM25. |
|
Límite: previsión
|
forecast.standards.limit | float |
Cierto nivel medio de concentración del contaminante que no debe superarse durante un período de tiempo determinado; es decir, este es el valor para el que la concentración de contaminantes alcanza 100% del límite. |
|
Porcentaje: previsión
|
forecast.standards.percent | float |
Valor de concentración de un contaminante determinado expresado como un porcentaje de esta concentración en el estándar / límite, por ejemplo, para un estándar de 50μg/m3 de PM10, la concentración de 25μg/m3 se expresa como 50%. |
|
Promedio: previsión
|
forecast.standards.averaging | string |
Los valores de medición se interpolan mediante mediciones medias de sensores cercanos (hasta 1,5km lejos del punto dado). |
Obtención de índices disponibles
Endpoint devuelve una lista de todos los tipos de índice admitidos en la API junto con listas de niveles definidos por cada tipo de índice.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
Nombre del índice
|
name | string |
Nombre del índice. |
|
Niveles
|
levels | array of object |
Lista de niveles de índices disponibles. |
|
Valor mínimo
|
levels.minValue | float |
Valor mínimo que el índice puede devolver para el nivel especificado. |
|
Valor máximo
|
levels.maxValue | float |
Valor máximo que el índice puede devolver para el nivel especificado. |
|
Valores
|
levels.values | string |
Los valores que el índice puede devolver para el nivel especificado. |
|
Nombre de nivel
|
levels.level | string | |
|
Descripción del nivel
|
levels.description | string | |
|
Color
|
levels.color | string |
Color que representa el nivel de índice en forma de triplete RGB hexadecimal (por ejemplo, #D1CF1E). |
Obtener instalaciones más cercanas
Endpoint devuelve la lista de instalaciones más cercanas a un punto determinado, ordenados por distancia a ese punto.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Latitude
|
lat | True | float |
Latitud como grado decimal, por ejemplo, 50,062006. |
|
Longitude
|
lng | True | float |
Longitud como grado decimal, por ejemplo, 19,940984. |
|
Distancia máxima (KM)
|
maxDistanceKM | float |
Valor predeterminado 3.0. Todas las instalaciones devueltas deben encontrarse dentro de este límite desde el punto especificado (en km). El valor negativo no significa ningún límite. |
|
|
Número máximo de resultados devueltos
|
maxResults | integer |
Valor predeterminado 1. Número máximo de instalaciones que se van a devolver. El valor negativo significa que no hay límite |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
Id
|
id | integer |
Identificador de instalación único. Si tiene InstallationId, puede consultar medidas desde una instalación determinada. |
|
Latitude
|
location.latitude | float |
Coordenadas de instalación: latitud. Ubicación exacta del sensor en el mapa. |
|
Longitude
|
location.longitude | float |
Coordenadas de instalación: longitud. Ubicación exacta del sensor en el mapa. |
|
Id. de ubicación
|
locationId | integer |
Identificador de ubicación único. |
|
País
|
address.country | string |
País de instalación. El atributo es opcional, puede estar vacío o nulo. |
|
City
|
address.city | string |
Ciudad de instalación. El atributo es opcional, puede estar vacío o nulo. |
|
Calle
|
address.street | string |
Calle de instalación. El atributo es opcional, puede estar vacío o nulo. |
|
Number
|
address.number | string |
Número de la calle de instalación. El atributo es opcional, puede estar vacío o nulo. |
|
Dirección de presentación 1
|
address.displayAddress1 | string |
Campo adicional que describe la dirección, por ejemplo, el nombre o el número de la escuela. Campo opcional. |
|
Dirección de presentación 2
|
address.displayAddress2 | string |
Campo adicional que describe la dirección, por ejemplo, el nombre o el número de la escuela. Campo opcional. |
|
Elevation
|
elevation | float |
Altitud a la que está instalado el dispositivo; metros por encima del nivel medio del mar (mamsl). |
|
Aire acondicionado
|
airly | boolean |
Marca que indica si esta instalación es un dispositivo Airly o no; Por ejemplo, las estaciones de GIOŚ se marcan como falsas. |
|
Id
|
sponsor.id | integer |
Identificador del patrocinador. |
|
Nombre
|
sponsor.name | string |
Nombre del patrocinador de esta instalación. |
|
Description
|
sponsor.description | string |
Descripción adicional del patrocinador de esta instalación. |
|
Logotipo
|
sponsor.logo | string |
Dirección URL que apunta al logotipo del patrocinador (imagen jpg). |
|
Link
|
sponsor.link | string |
Dirección URL que apunta al sitio web del patrocinador. |
Obtener medidas más cercanas
El punto de conexión devuelve medidas para una instalación más cercana a una ubicación determinada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Latitude
|
lat | True | number |
Latitud como grado decimal, por ejemplo, 50,062006. |
|
Longitude
|
lng | True | number |
Longitud como grado decimal, por ejemplo, 19,940984. |
|
Distancia máxima (KM)
|
maxDistanceKM | float |
La instalación buscada debe encontrarse dentro de este límite desde el punto dado (en km). El valor negativo no significa ningún límite. |
|
|
Tipo de índice
|
indexType | string |
Selecciona el tipo del índice que se debe calcular y devolver en respuesta. |
|
|
Language
|
Accept-Language | string |
Idioma en el que se deben devolver descripciones de texto. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Desde DateTime: actual
|
current.fromDateTime | string |
ISO8601 marca de tiempo. Fecha y hora en UTC. El campo representa la hora de inicio a partir de la cual se midieron y promediaron los datos de esta carga. |
|
Till DateTime: current
|
current.tillDateTime | string |
ISO8601 marca de tiempo. Fecha y hora en UTC. El campo representa la hora de finalización a la que se midieron y promediaron los datos de esta carga. |
|
values
|
current.values | array of object |
Valores: actual. |
|
Nombre de medida: actual
|
current.values.name | string |
Nombre (tipo) de la medida especificada; Por ejemplo, PM10. |
|
Valor de medida: actual
|
current.values.value | float |
Valor medido del tipo de medida especificado, por ejemplo, concentración de 25μg/m3. |
|
índices
|
current.indexes | array of object |
Índices: actual. |
|
Nombre del índice: actual
|
current.indexes.name | string |
Nombre del índice (por ejemplo, CAQI o PIJP). |
|
Valor de índice: actual
|
current.indexes.value | float |
Valor numérico del índice calculado. |
|
Nivel: actual
|
current.indexes.level | string |
Nivel discreto del índice (por ejemplo, HIGH, o LOW, etc.). |
|
Descripción: actual
|
current.indexes.description | string |
Descripción del nivel de índice. Texto traducido y devuelto en un idioma según Accept-Language encabezado de solicitud. |
|
Consejo: actual
|
current.indexes.advice | string |
Texto adicional con consejos sobre el nivel de índice actual. Texto traducido y devuelto en un idioma según Accept-Language encabezado de solicitud. |
|
Color: actual
|
current.indexes.color | string |
Color que representa el nivel de índice en forma de triplete RGB hexadecimal (por ejemplo, #D1CF1E). |
|
standards
|
current.standards | array of object |
Estándares: actual. |
|
Nombre estándar: actual
|
current.standards.name | string |
Nombre de este estándar. Actualmente solo se admiten los estándares de la OMS. |
|
Contaminante - corriente
|
current.standards.pollutant | string |
Nombre del contaminante al que se aplica esta norma, actualmente solo se admiten PM10 y PM25. |
|
Límite: actual
|
current.standards.limit | float |
Cierto nivel medio de concentración del contaminante que no debe superarse durante un período de tiempo determinado; es decir, este es el valor para el que la concentración de contaminantes alcanza 100% del límite. |
|
Porcentaje: actual
|
current.standards.percent | float |
Valor de concentración de un contaminante determinado expresado como un porcentaje de esta concentración en el estándar / límite, por ejemplo, para un estándar de 50μg/m3 de PM10, la concentración de 25μg/m3 se expresa como 50%. |
|
Promedio: actual
|
current.standards.averaging | string |
Los valores de medición se interpolan mediante mediciones medias de sensores cercanos (hasta 1,5km lejos del punto dado). |
|
historia
|
history | array of object |
Entradas históricas. |
|
Desde DateTime: historial
|
history.fromDateTime | string |
ISO8601 marca de tiempo. Fecha y hora en UTC. El campo representa la hora de inicio a partir de la cual se midieron y promediaron los datos de esta carga. |
|
Till DateTime: historial
|
history.tillDateTime | string |
ISO8601 marca de tiempo. Fecha y hora en UTC. El campo representa la hora de finalización a la que se midieron y promediaron los datos de esta carga. |
|
values
|
history.values | array of object |
Valores: historial. |
|
Nombre de medida: historial
|
history.values.name | string |
Nombre (tipo) de la medida especificada; Por ejemplo, PM10. |
|
Valor de medida: historial
|
history.values.value | float |
Valor medido del tipo de medida especificado, por ejemplo, concentración de 25μg/m3. |
|
índices
|
history.indexes | array of object |
Índices: historial. |
|
Nombre estándar: historial
|
history.indexes.name | string |
Nombre de este estándar. Actualmente solo se admiten los estándares de la OMS. |
|
Contaminante - historia
|
history.indexes.pollutant | string |
Nombre del contaminante al que se aplica esta norma, actualmente solo se admiten PM10 y PM25. |
|
Límite: historial
|
history.indexes.limit | float |
Cierto nivel medio de concentración del contaminante que no debe superarse durante un período de tiempo determinado; es decir, este es el valor para el que la concentración de contaminantes alcanza 100% del límite. |
|
Porcentaje: historial
|
history.indexes.percent | float |
Valor de concentración de un contaminante determinado expresado como un porcentaje de esta concentración en el estándar / límite, por ejemplo, para un estándar de 50μg/m3 de PM10, la concentración de 25μg/m3 se expresa como 50%. |
|
Promedio: historial
|
history.indexes.averaging | string |
Los valores de medición se interpolan mediante mediciones medias de sensores cercanos (hasta 1,5km lejos del punto dado). |
|
standards
|
history.standards | array of object |
Estándares: historial. |
|
Nombre estándar: historial
|
history.standards.name | string |
Nombre de este estándar. Actualmente solo se admiten los estándares de la OMS. |
|
Contaminante - historia
|
history.standards.pollutant | string |
Nombre del contaminante al que se aplica esta norma, actualmente solo se admiten PM10 y PM25. |
|
Límite: historial
|
history.standards.limit | float |
Cierto nivel medio de concentración del contaminante que no debe superarse durante un período de tiempo determinado; es decir, este es el valor para el que la concentración de contaminantes alcanza 100% del límite. |
|
Porcentaje: historial
|
history.standards.percent | float |
Valor de concentración de un contaminante determinado expresado como un porcentaje de esta concentración en el estándar / límite, por ejemplo, para un estándar de 50μg/m3 de PM10, la concentración de 25μg/m3 se expresa como 50%. |
|
Promedio: historial
|
history.standards.averaging | string |
Los valores de medición se interpolan mediante mediciones medias de sensores cercanos (hasta 1,5km lejos del punto dado). |
|
previsión
|
forecast | array of object |
Entradas de previsión. |
|
Desde DateTime: previsión
|
forecast.fromDateTime | string |
ISO8601 marca de tiempo. Fecha y hora en UTC. El campo representa la hora de inicio a partir de la cual se midieron y promediaron los datos de esta carga. |
|
Till DateTime: previsión
|
forecast.tillDateTime | string |
ISO8601 marca de tiempo. Fecha y hora en UTC. El campo representa la hora de finalización a la que se midieron y promediaron los datos de esta carga. |
|
values
|
forecast.values | array of object |
Valores: previsión. |
|
Nombre de medida: previsión
|
forecast.values.name | string |
Nombre (tipo) de la medida especificada; Por ejemplo, PM10. |
|
Valor de medida: previsión
|
forecast.values.value | float |
Valor medido del tipo de medida especificado, por ejemplo, concentración de 25μg/m3. |
|
índices
|
forecast.indexes | array of object |
Índices: previsión. |
|
Nombre estándar: previsión
|
forecast.indexes.name | string |
Nombre de este estándar. Actualmente solo se admiten los estándares de la OMS. |
|
Contaminante: previsión
|
forecast.indexes.pollutant | string |
Nombre del contaminante al que se aplica esta norma, actualmente solo se admiten PM10 y PM25. |
|
Límite: previsión
|
forecast.indexes.limit | float |
Cierto nivel medio de concentración del contaminante que no debe superarse durante un período de tiempo determinado; es decir, este es el valor para el que la concentración de contaminantes alcanza 100% del límite. |
|
Porcentaje: previsión
|
forecast.indexes.percent | float |
Valor de concentración de un contaminante determinado expresado como un porcentaje de esta concentración en el estándar / límite, por ejemplo, para un estándar de 50μg/m3 de PM10, la concentración de 25μg/m3 se expresa como 50%. |
|
Promedio: previsión
|
forecast.indexes.averaging | string |
Los valores de medición se interpolan mediante mediciones medias de sensores cercanos (hasta 1,5km lejos del punto dado). |
|
standards
|
forecast.standards | array of object |
Estándares: previsión. |
|
Nombre estándar: previsión
|
forecast.standards.name | string |
Nombre de este estándar. Actualmente solo se admiten los estándares de la OMS. |
|
Contaminante: previsión
|
forecast.standards.pollutant | string |
Nombre del contaminante al que se aplica esta norma, actualmente solo se admiten PM10 y PM25. |
|
Límite: previsión
|
forecast.standards.limit | float |
Cierto nivel medio de concentración del contaminante que no debe superarse durante un período de tiempo determinado; es decir, este es el valor para el que la concentración de contaminantes alcanza 100% del límite. |
|
Porcentaje: previsión
|
forecast.standards.percent | float |
Valor de concentración de un contaminante determinado expresado como un porcentaje de esta concentración en el estándar / límite, por ejemplo, para un estándar de 50μg/m3 de PM10, la concentración de 25μg/m3 se expresa como 50%. |
|
Promedio: previsión
|
forecast.standards.averaging | string |
Los valores de medición se interpolan mediante mediciones medias de sensores cercanos (hasta 1,5km lejos del punto dado). |