Airly (éditeur indépendant)
Airly fournit des données précises et hyper-locales sur la pollution de l’air dans votre communauté. Il s’agit de la première étape pour comprendre les risques sanitaires et apporter des améliorations.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Tomasz Poszytek |
| URL | https://aka.ms/poszytek |
| Messagerie électronique | tomasz@poszytek.eu |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Tomasz Poszytek |
| Site internet | https://airly.org/ |
| Politique de confidentialité | https://airly.org/en/terms-conditions/ |
| Catégories | Internet des objets ; Style de vie et divertissement |
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Clé d’API | securestring | Clé API pour cette API | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Obtenir des mesures pour l’installation |
Le point de terminaison retourne des mesures pour l’installation concrète donnée par InstallationId. |
| Obtenir des mesures pour un point |
Le point de terminaison retourne des mesures pour n’importe quel emplacement géographique. Les valeurs de mesure sont interpolées par la moyenne des mesures des capteurs proches (jusqu’à 1,5 km de l’endroit donné). La valeur retournée est une moyenne pondérée, avec le poids inversement proportionnel à la distance entre le capteur et le point donné. |
| Obtenir les index disponibles |
Le point de terminaison retourne une liste de tous les types d’index pris en charge dans l’API, ainsi que les listes de niveaux définis par chaque type d’index. |
| Obtenir les installations les plus proches |
Le point de terminaison retourne la liste des installations les plus proches d’un point donné, triées par distance à ce point. |
| Obtenir les mesures disponibles |
Le point de terminaison retourne la liste de tous les types de mesures pris en charge dans l’API, ainsi que leurs noms et unités. |
| Obtenir les mesures les plus proches |
Le point de terminaison retourne des mesures pour une installation la plus proche d’un emplacement donné. |
| Obtenir l’installation par ID |
L’opération retourne des métadonnées d’installation uniques, données par InstallationId. |
Obtenir des mesures pour l’installation
Le point de terminaison retourne des mesures pour l’installation concrète donnée par InstallationId.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’installation
|
installationId | True | integer |
Identificateur d’installation pour lequel les mesures sont retournées. |
|
Language
|
Accept-Language | string |
Langue dans laquelle les descriptions de texte doivent être retournées. |
|
|
Type d’index
|
indexType | string |
Sélectionne le type de l’index qui doit être calculé et retourné en réponse. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
À partir de DateTime - actuel
|
current.fromDateTime | string |
ISO8601 horodatage. Date et heure UTC. Le champ représente l’heure de début à partir de laquelle les données de cette charge utile ont été mesurées et moyennes. |
|
Till DateTime - current
|
current.tillDateTime | string |
ISO8601 horodatage. Date et heure UTC. Le champ représente l’heure de fin à laquelle les données de cette charge utile ont été mesurées et moyennes. |
|
values
|
current.values | array of object |
Valeurs : en cours. |
|
Nom de mesure - actuel
|
current.values.name | string |
Nom (type) de la mesure donnée ; p. ex. PM10. |
|
Valeur de mesure - current
|
current.values.value | float |
Valeur mesurée du type de mesure donné, par exemple concentration 25μg/m3. |
|
index
|
current.indexes | array of object |
Index : actif. |
|
Nom de l’index - actuel
|
current.indexes.name | string |
Nom de l’index (par exemple, CAQI ou PIJP). |
|
Valeur d’index - current
|
current.indexes.value | float |
Valeur numérique de l’index calculé. |
|
Niveau - actuel
|
current.indexes.level | string |
Niveau discret de l’index (par exemple, HIGH, ou LOW, etc.). |
|
Description - actuel
|
current.indexes.description | string |
Description du niveau d’index. Texte traduit et retourné dans une langue en fonction de Accept-Language en-tête de requête. |
|
Conseils - actuel
|
current.indexes.advice | string |
Texte supplémentaire avec conseils concernant le niveau d’index actuel. Texte traduit et retourné dans une langue en fonction de Accept-Language en-tête de requête. |
|
Couleur - actuel
|
current.indexes.color | string |
Couleur représentant le niveau d’index sous forme de triplet RVB hexadécimal (par exemple, #D1CF1E). |
|
standards
|
current.standards | array of object |
Normes : actuelles. |
|
Nom standard - actuel
|
current.standards.name | string |
Nom de cette norme. Actuellement, seules les normes de l’OMS sont prises en charge. |
|
Polluants - actuel
|
current.standards.pollutant | string |
Nom du polluant auquel cette norme s’applique, actuellement seulement PM10 et PM25 sont pris en charge. |
|
Limite - actuel
|
current.standards.limit | float |
Certain niveau moyen de concentration des polluants qui ne doivent pas être dépassés sur une période donnée ; autrement dit, c’est la valeur pour laquelle la concentration de polluants atteint 100% de la limite. |
|
Pourcentage - actuel
|
current.standards.percent | float |
La valeur de concentration d’un polluant donné exprimé sous la forme d’un pourcentage de cette concentration dans la norme/limite, par exemple pour une norme de 50μg/m3 de PM10, la concentration de 25μg/m3 est exprimée en 50%. |
|
Moyenne - actuel
|
current.standards.averaging | string |
Les valeurs de mesure sont interpolées par la moyenne des mesures des capteurs proches (jusqu’à 1,5 km de l’endroit donné). |
|
histoire
|
history | array of object |
Entrées historiques. |
|
À partir de DateTime - historique
|
history.fromDateTime | string |
ISO8601 horodatage. Date et heure UTC. Le champ représente l’heure de début à partir de laquelle les données de cette charge utile ont été mesurées et moyennes. |
|
Till DateTime - historique
|
history.tillDateTime | string |
ISO8601 horodatage. Date et heure UTC. Le champ représente l’heure de fin à laquelle les données de cette charge utile ont été mesurées et moyennes. |
|
values
|
history.values | array of object |
Valeurs : historique. |
|
Nom de la mesure - historique
|
history.values.name | string |
Nom (type) de la mesure donnée ; p. ex. PM10. |
|
Valeur de mesure - historique
|
history.values.value | float |
Valeur mesurée du type de mesure donné, par exemple concentration 25μg/m3. |
|
index
|
history.indexes | array of object |
Index : historique. |
|
Nom standard - historique
|
history.indexes.name | string |
Nom de cette norme. Actuellement, seules les normes de l’OMS sont prises en charge. |
|
Polluants - Historique
|
history.indexes.pollutant | string |
Nom du polluant auquel cette norme s’applique, actuellement seulement PM10 et PM25 sont pris en charge. |
|
Limite - historique
|
history.indexes.limit | float |
Certain niveau moyen de concentration des polluants qui ne doivent pas être dépassés sur une période donnée ; autrement dit, c’est la valeur pour laquelle la concentration de polluants atteint 100% de la limite. |
|
Pourcentage - Historique
|
history.indexes.percent | float |
La valeur de concentration d’un polluant donné exprimé sous la forme d’un pourcentage de cette concentration dans la norme/limite, par exemple pour une norme de 50μg/m3 de PM10, la concentration de 25μg/m3 est exprimée en 50%. |
|
Moyenne - historique
|
history.indexes.averaging | string |
Les valeurs de mesure sont interpolées par la moyenne des mesures des capteurs proches (jusqu’à 1,5 km de l’endroit donné). |
|
standards
|
history.standards | array of object |
Normes : historique. |
|
Nom standard - historique
|
history.standards.name | string |
Nom de cette norme. Actuellement, seules les normes de l’OMS sont prises en charge. |
|
Polluants - Historique
|
history.standards.pollutant | string |
Nom du polluant auquel cette norme s’applique, actuellement seulement PM10 et PM25 sont pris en charge. |
|
Limite - historique
|
history.standards.limit | float |
Certain niveau moyen de concentration des polluants qui ne doivent pas être dépassés sur une période donnée ; autrement dit, c’est la valeur pour laquelle la concentration de polluants atteint 100% de la limite. |
|
Pourcentage - Historique
|
history.standards.percent | float |
La valeur de concentration d’un polluant donné exprimé sous la forme d’un pourcentage de cette concentration dans la norme/limite, par exemple pour une norme de 50μg/m3 de PM10, la concentration de 25μg/m3 est exprimée en 50%. |
|
Moyenne - historique
|
history.standards.averaging | string |
Les valeurs de mesure sont interpolées par la moyenne des mesures des capteurs proches (jusqu’à 1,5 km de l’endroit donné). |
|
prévision
|
forecast | array of object |
Entrées de prévision. |
|
À partir de DateTime - prévision
|
forecast.fromDateTime | string |
ISO8601 horodatage. Date et heure UTC. Le champ représente l’heure de début à partir de laquelle les données de cette charge utile ont été mesurées et moyennes. |
|
Till DateTime - prévision
|
forecast.tillDateTime | string |
ISO8601 horodatage. Date et heure UTC. Le champ représente l’heure de fin à laquelle les données de cette charge utile ont été mesurées et moyennes. |
|
values
|
forecast.values | array of object |
Valeurs : prévision. |
|
Nom de la mesure - prévision
|
forecast.values.name | string |
Nom (type) de la mesure donnée ; p. ex. PM10. |
|
Valeur de mesure - Prévision
|
forecast.values.value | float |
Valeur mesurée du type de mesure donné, par exemple concentration 25μg/m3. |
|
index
|
forecast.indexes | array of object |
Index : prévision. |
|
Nom standard - Prévision
|
forecast.indexes.name | string |
Nom de cette norme. Actuellement, seules les normes de l’OMS sont prises en charge. |
|
Polluants - prévision
|
forecast.indexes.pollutant | string |
Nom du polluant auquel cette norme s’applique, actuellement seulement PM10 et PM25 sont pris en charge. |
|
Limite - prévision
|
forecast.indexes.limit | float |
Certain niveau moyen de concentration des polluants qui ne doivent pas être dépassés sur une période donnée ; autrement dit, c’est la valeur pour laquelle la concentration de polluants atteint 100% de la limite. |
|
Pourcentage - Prévision
|
forecast.indexes.percent | float |
La valeur de concentration d’un polluant donné exprimé sous la forme d’un pourcentage de cette concentration dans la norme/limite, par exemple pour une norme de 50μg/m3 de PM10, la concentration de 25μg/m3 est exprimée en 50%. |
|
Moyenne - prévision
|
forecast.indexes.averaging | string |
Les valeurs de mesure sont interpolées par la moyenne des mesures des capteurs proches (jusqu’à 1,5 km de l’endroit donné). |
|
standards
|
forecast.standards | array of object |
Normes : prévision. |
|
Nom standard - Prévision
|
forecast.standards.name | string |
Nom de cette norme. Actuellement, seules les normes de l’OMS sont prises en charge. |
|
Polluants - prévision
|
forecast.standards.pollutant | string |
Nom du polluant auquel cette norme s’applique, actuellement seulement PM10 et PM25 sont pris en charge. |
|
Limite - prévision
|
forecast.standards.limit | float |
Certain niveau moyen de concentration des polluants qui ne doivent pas être dépassés sur une période donnée ; autrement dit, c’est la valeur pour laquelle la concentration de polluants atteint 100% de la limite. |
|
Pourcentage - Prévision
|
forecast.standards.percent | float |
La valeur de concentration d’un polluant donné exprimé sous la forme d’un pourcentage de cette concentration dans la norme/limite, par exemple pour une norme de 50μg/m3 de PM10, la concentration de 25μg/m3 est exprimée en 50%. |
|
Moyenne - prévision
|
forecast.standards.averaging | string |
Les valeurs de mesure sont interpolées par la moyenne des mesures des capteurs proches (jusqu’à 1,5 km de l’endroit donné). |
Obtenir des mesures pour un point
Le point de terminaison retourne des mesures pour n’importe quel emplacement géographique. Les valeurs de mesure sont interpolées par la moyenne des mesures des capteurs proches (jusqu’à 1,5 km de l’endroit donné). La valeur retournée est une moyenne pondérée, avec le poids inversement proportionnel à la distance entre le capteur et le point donné.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Latitude
|
lat | True | number |
Latitude sous forme de degré décimal, par exemple 50,062006. |
|
Longitude
|
lng | True | number |
Longitude sous forme de degré décimal, par exemple 19,940984. |
|
Type d’index
|
indexType | string |
Sélectionne le type de l’index qui doit être calculé et retourné en réponse. |
|
|
Language
|
Accept-Language | string |
Langue dans laquelle les descriptions de texte doivent être retournées. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
À partir de DateTime - actuel
|
current.fromDateTime | string |
ISO8601 horodatage. Date et heure UTC. Le champ représente l’heure de début à partir de laquelle les données de cette charge utile ont été mesurées et moyennes. |
|
Till DateTime - current
|
current.tillDateTime | string |
ISO8601 horodatage. Date et heure UTC. Le champ représente l’heure de fin à laquelle les données de cette charge utile ont été mesurées et moyennes. |
|
values
|
current.values | array of object |
Valeurs : en cours. |
|
Nom de mesure - actuel
|
current.values.name | string |
Nom (type) de la mesure donnée ; p. ex. PM10. |
|
Valeur de mesure - current
|
current.values.value | float |
Valeur mesurée du type de mesure donné, par exemple concentration 25μg/m3. |
|
index
|
current.indexes | array of object |
Index : actif. |
|
Nom de l’index - actuel
|
current.indexes.name | string |
Nom de l’index (par exemple, CAQI ou PIJP). |
|
Valeur d’index - current
|
current.indexes.value | float |
Valeur numérique de l’index calculé. |
|
Niveau - actuel
|
current.indexes.level | string |
Niveau discret de l’index (par exemple, HIGH, ou LOW, etc.). |
|
Description - actuel
|
current.indexes.description | string |
Description du niveau d’index. Texte traduit et retourné dans une langue en fonction de Accept-Language en-tête de requête. |
|
Conseils - actuel
|
current.indexes.advice | string |
Texte supplémentaire avec conseils concernant le niveau d’index actuel. Texte traduit et retourné dans une langue en fonction de Accept-Language en-tête de requête. |
|
Couleur - actuel
|
current.indexes.color | string |
Couleur représentant le niveau d’index sous forme de triplet RVB hexadécimal (par exemple, #D1CF1E). |
|
standards
|
current.standards | array of object |
Normes : actuelles. |
|
Nom standard - actuel
|
current.standards.name | string |
Nom de cette norme. Actuellement, seules les normes de l’OMS sont prises en charge. |
|
Polluants - actuel
|
current.standards.pollutant | string |
Nom du polluant auquel cette norme s’applique, actuellement seulement PM10 et PM25 sont pris en charge. |
|
Limite - actuel
|
current.standards.limit | float |
Certain niveau moyen de concentration des polluants qui ne doivent pas être dépassés sur une période donnée ; autrement dit, c’est la valeur pour laquelle la concentration de polluants atteint 100% de la limite. |
|
Pourcentage - actuel
|
current.standards.percent | float |
La valeur de concentration d’un polluant donné exprimé sous la forme d’un pourcentage de cette concentration dans la norme/limite, par exemple pour une norme de 50μg/m3 de PM10, la concentration de 25μg/m3 est exprimée en 50%. |
|
Moyenne - actuel
|
current.standards.averaging | string |
Les valeurs de mesure sont interpolées par la moyenne des mesures des capteurs proches (jusqu’à 1,5 km de l’endroit donné). |
|
histoire
|
history | array of object |
Entrées historiques. |
|
À partir de DateTime - historique
|
history.fromDateTime | string |
ISO8601 horodatage. Date et heure UTC. Le champ représente l’heure de début à partir de laquelle les données de cette charge utile ont été mesurées et moyennes. |
|
Till DateTime - historique
|
history.tillDateTime | string |
ISO8601 horodatage. Date et heure UTC. Le champ représente l’heure de fin à laquelle les données de cette charge utile ont été mesurées et moyennes. |
|
values
|
history.values | array of object |
Valeurs : historique. |
|
Nom de la mesure - historique
|
history.values.name | string |
Nom (type) de la mesure donnée ; p. ex. PM10. |
|
Valeur de mesure - historique
|
history.values.value | float |
Valeur mesurée du type de mesure donné, par exemple concentration 25μg/m3. |
|
index
|
history.indexes | array of object |
Index : historique. |
|
Nom standard - historique
|
history.indexes.name | string |
Nom de cette norme. Actuellement, seules les normes de l’OMS sont prises en charge. |
|
Polluants - Historique
|
history.indexes.pollutant | string |
Nom du polluant auquel cette norme s’applique, actuellement seulement PM10 et PM25 sont pris en charge. |
|
Limite - historique
|
history.indexes.limit | float |
Certain niveau moyen de concentration des polluants qui ne doivent pas être dépassés sur une période donnée ; autrement dit, c’est la valeur pour laquelle la concentration de polluants atteint 100% de la limite. |
|
Pourcentage - Historique
|
history.indexes.percent | float |
La valeur de concentration d’un polluant donné exprimé sous la forme d’un pourcentage de cette concentration dans la norme/limite, par exemple pour une norme de 50μg/m3 de PM10, la concentration de 25μg/m3 est exprimée en 50%. |
|
Moyenne - historique
|
history.indexes.averaging | string |
Les valeurs de mesure sont interpolées par la moyenne des mesures des capteurs proches (jusqu’à 1,5 km de l’endroit donné). |
|
standards
|
history.standards | array of object |
Normes : historique. |
|
Nom standard - historique
|
history.standards.name | string |
Nom de cette norme. Actuellement, seules les normes de l’OMS sont prises en charge. |
|
Polluants - Historique
|
history.standards.pollutant | string |
Nom du polluant auquel cette norme s’applique, actuellement seulement PM10 et PM25 sont pris en charge. |
|
Limite - historique
|
history.standards.limit | float |
Certain niveau moyen de concentration des polluants qui ne doivent pas être dépassés sur une période donnée ; autrement dit, c’est la valeur pour laquelle la concentration de polluants atteint 100% de la limite. |
|
Pourcentage - Historique
|
history.standards.percent | float |
La valeur de concentration d’un polluant donné exprimé sous la forme d’un pourcentage de cette concentration dans la norme/limite, par exemple pour une norme de 50μg/m3 de PM10, la concentration de 25μg/m3 est exprimée en 50%. |
|
Moyenne - historique
|
history.standards.averaging | string |
Les valeurs de mesure sont interpolées par la moyenne des mesures des capteurs proches (jusqu’à 1,5 km de l’endroit donné). |
|
prévision
|
forecast | array of object |
Entrées de prévision. |
|
À partir de DateTime - prévision
|
forecast.fromDateTime | string |
ISO8601 horodatage. Date et heure UTC. Le champ représente l’heure de début à partir de laquelle les données de cette charge utile ont été mesurées et moyennes. |
|
Till DateTime - prévision
|
forecast.tillDateTime | string |
ISO8601 horodatage. Date et heure UTC. Le champ représente l’heure de fin à laquelle les données de cette charge utile ont été mesurées et moyennes. |
|
values
|
forecast.values | array of object |
Valeurs : prévision. |
|
Nom de la mesure - prévision
|
forecast.values.name | string |
Nom (type) de la mesure donnée ; p. ex. PM10. |
|
Valeur de mesure - Prévision
|
forecast.values.value | float |
Valeur mesurée du type de mesure donné, par exemple concentration 25μg/m3. |
|
index
|
forecast.indexes | array of object |
Index : prévision. |
|
Nom standard - Prévision
|
forecast.indexes.name | string |
Nom de cette norme. Actuellement, seules les normes de l’OMS sont prises en charge. |
|
Polluants - prévision
|
forecast.indexes.pollutant | string |
Nom du polluant auquel cette norme s’applique, actuellement seulement PM10 et PM25 sont pris en charge. |
|
Limite - prévision
|
forecast.indexes.limit | float |
Certain niveau moyen de concentration des polluants qui ne doivent pas être dépassés sur une période donnée ; autrement dit, c’est la valeur pour laquelle la concentration de polluants atteint 100% de la limite. |
|
Pourcentage - Prévision
|
forecast.indexes.percent | float |
La valeur de concentration d’un polluant donné exprimé sous la forme d’un pourcentage de cette concentration dans la norme/limite, par exemple pour une norme de 50μg/m3 de PM10, la concentration de 25μg/m3 est exprimée en 50%. |
|
Moyenne - prévision
|
forecast.indexes.averaging | string |
Les valeurs de mesure sont interpolées par la moyenne des mesures des capteurs proches (jusqu’à 1,5 km de l’endroit donné). |
|
standards
|
forecast.standards | array of object |
Normes : prévision. |
|
Nom standard - Prévision
|
forecast.standards.name | string |
Nom de cette norme. Actuellement, seules les normes de l’OMS sont prises en charge. |
|
Polluants - prévision
|
forecast.standards.pollutant | string |
Nom du polluant auquel cette norme s’applique, actuellement seulement PM10 et PM25 sont pris en charge. |
|
Limite - prévision
|
forecast.standards.limit | float |
Certain niveau moyen de concentration des polluants qui ne doivent pas être dépassés sur une période donnée ; autrement dit, c’est la valeur pour laquelle la concentration de polluants atteint 100% de la limite. |
|
Pourcentage - Prévision
|
forecast.standards.percent | float |
La valeur de concentration d’un polluant donné exprimé sous la forme d’un pourcentage de cette concentration dans la norme/limite, par exemple pour une norme de 50μg/m3 de PM10, la concentration de 25μg/m3 est exprimée en 50%. |
|
Moyenne - prévision
|
forecast.standards.averaging | string |
Les valeurs de mesure sont interpolées par la moyenne des mesures des capteurs proches (jusqu’à 1,5 km de l’endroit donné). |
Obtenir les index disponibles
Le point de terminaison retourne une liste de tous les types d’index pris en charge dans l’API, ainsi que les listes de niveaux définis par chaque type d’index.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
|
array of object | ||
|
Nom d’index
|
name | string |
Nom de l'index. |
|
Niveaux
|
levels | array of object |
Liste des niveaux d’index disponibles. |
|
Valeur minimale
|
levels.minValue | float |
Valeur minimale que l’index peut retourner pour le niveau donné. |
|
Valeur maximale
|
levels.maxValue | float |
Valeur maximale que l’index peut retourner pour le niveau donné. |
|
Valeurs
|
levels.values | string |
Les valeurs que l’index peut retourner pour le niveau donné. |
|
Nom de niveau
|
levels.level | string | |
|
Description de niveau
|
levels.description | string | |
|
Color
|
levels.color | string |
Couleur représentant le niveau d’index sous forme de triplet RVB hexadécimal (par exemple, #D1CF1E). |
Obtenir les installations les plus proches
Le point de terminaison retourne la liste des installations les plus proches d’un point donné, triées par distance à ce point.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Latitude
|
lat | True | float |
Latitude sous forme de degré décimal, par exemple 50,062006. |
|
Longitude
|
lng | True | float |
Longitude sous forme de degré décimal, par exemple 19,940984. |
|
Distance maximale (KM)
|
maxDistanceKM | float |
Valeur par défaut 3.0. Toutes les installations retournées doivent se trouver dans cette limite à partir du point donné (en km). La valeur négative signifie qu’aucune limite n’est atteinte. |
|
|
Nombre maximal de résultats retournés
|
maxResults | integer |
Valeur par défaut 1. Nombre maximal d’installations à retourner. La valeur négative signifie qu’aucune limite n’est définie |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
|
array of object | ||
|
Id
|
id | integer |
Identificateur d’installation unique. Avec InstallationId, vous pouvez interroger des mesures à partir d’une installation particulière. |
|
Latitude
|
location.latitude | float |
Coordonnées d’installation : latitude. Emplacement exact du capteur sur la carte. |
|
Longitude
|
location.longitude | float |
Coordonnées d’installation : longitude. Emplacement exact du capteur sur la carte. |
|
ID d’emplacement
|
locationId | integer |
Identificateur d’emplacement unique. |
|
Pays
|
address.country | string |
Pays d’installation. L’attribut est facultatif, peut être vide ou null. |
|
Ville
|
address.city | string |
Ville d’installation. L’attribut est facultatif, peut être vide ou null. |
|
Rue
|
address.street | string |
Rue d’installation. L’attribut est facultatif, peut être vide ou null. |
|
Number
|
address.number | string |
Numéro de rue d’installation. L’attribut est facultatif, peut être vide ou null. |
|
Adresse d’affichage 1
|
address.displayAddress1 | string |
Champ supplémentaire décrivant l’adresse, par exemple le nom ou le numéro de l’école. Champ facultatif. |
|
Adresse d’affichage 2
|
address.displayAddress2 | string |
Champ supplémentaire décrivant l’adresse, par exemple le nom ou le numéro de l’école. Champ facultatif. |
|
Elevation
|
elevation | float |
Altitude à laquelle l’appareil est installé ; mètres au-dessus du niveau moyen de la mer (mamsl). |
|
Airly
|
airly | boolean |
Indicateur indiquant si cette installation est un appareil Airly ou non ; Par exemple, les stations GIOŚ sont signalées comme étant fausses. |
|
Id
|
sponsor.id | integer |
Identificateur du sponsor. |
|
Nom
|
sponsor.name | string |
Nom du sponsor de cette installation. |
|
Descriptif
|
sponsor.description | string |
Description supplémentaire du sponsor de cette installation. |
|
Logo
|
sponsor.logo | string |
URL pointant vers le logo du sponsor (image jpg). |
|
Lien
|
sponsor.link | string |
URL pointant vers le site web du sponsor. |
Obtenir les mesures disponibles
Le point de terminaison retourne la liste de tous les types de mesures pris en charge dans l’API, ainsi que leurs noms et unités.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Language
|
Accept-Language | string |
Langue dans laquelle les descriptions de texte doivent être retournées. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
|
array of object | ||
|
Nom
|
name | string |
Nom de ce type de mesure, par exemple PM10. |
|
Étiquette
|
label | string |
Nom descriptif de ce type de mesure (champ traduit). |
|
Unité
|
unit | string |
Unité de ce type de mesure, par exemple μg/m3. |
Obtenir les mesures les plus proches
Le point de terminaison retourne des mesures pour une installation la plus proche d’un emplacement donné.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Latitude
|
lat | True | number |
Latitude sous forme de degré décimal, par exemple 50,062006. |
|
Longitude
|
lng | True | number |
Longitude sous forme de degré décimal, par exemple 19,940984. |
|
Distance maximale (KM)
|
maxDistanceKM | float |
L’installation recherchée doit se trouver dans cette limite à partir du point donné (en km). La valeur négative signifie qu’aucune limite n’est atteinte. |
|
|
Type d’index
|
indexType | string |
Sélectionne le type de l’index qui doit être calculé et retourné en réponse. |
|
|
Language
|
Accept-Language | string |
Langue dans laquelle les descriptions de texte doivent être retournées. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
À partir de DateTime - actuel
|
current.fromDateTime | string |
ISO8601 horodatage. Date et heure UTC. Le champ représente l’heure de début à partir de laquelle les données de cette charge utile ont été mesurées et moyennes. |
|
Till DateTime - current
|
current.tillDateTime | string |
ISO8601 horodatage. Date et heure UTC. Le champ représente l’heure de fin à laquelle les données de cette charge utile ont été mesurées et moyennes. |
|
values
|
current.values | array of object |
Valeurs : en cours. |
|
Nom de mesure - actuel
|
current.values.name | string |
Nom (type) de la mesure donnée ; p. ex. PM10. |
|
Valeur de mesure - current
|
current.values.value | float |
Valeur mesurée du type de mesure donné, par exemple concentration 25μg/m3. |
|
index
|
current.indexes | array of object |
Index : actif. |
|
Nom de l’index - actuel
|
current.indexes.name | string |
Nom de l’index (par exemple, CAQI ou PIJP). |
|
Valeur d’index - current
|
current.indexes.value | float |
Valeur numérique de l’index calculé. |
|
Niveau - actuel
|
current.indexes.level | string |
Niveau discret de l’index (par exemple, HIGH, ou LOW, etc.). |
|
Description - actuel
|
current.indexes.description | string |
Description du niveau d’index. Texte traduit et retourné dans une langue en fonction de Accept-Language en-tête de requête. |
|
Conseils - actuel
|
current.indexes.advice | string |
Texte supplémentaire avec conseils concernant le niveau d’index actuel. Texte traduit et retourné dans une langue en fonction de Accept-Language en-tête de requête. |
|
Couleur - actuel
|
current.indexes.color | string |
Couleur représentant le niveau d’index sous forme de triplet RVB hexadécimal (par exemple, #D1CF1E). |
|
standards
|
current.standards | array of object |
Normes : actuelles. |
|
Nom standard - actuel
|
current.standards.name | string |
Nom de cette norme. Actuellement, seules les normes de l’OMS sont prises en charge. |
|
Polluants - actuel
|
current.standards.pollutant | string |
Nom du polluant auquel cette norme s’applique, actuellement seulement PM10 et PM25 sont pris en charge. |
|
Limite - actuel
|
current.standards.limit | float |
Certain niveau moyen de concentration des polluants qui ne doivent pas être dépassés sur une période donnée ; autrement dit, c’est la valeur pour laquelle la concentration de polluants atteint 100% de la limite. |
|
Pourcentage - actuel
|
current.standards.percent | float |
La valeur de concentration d’un polluant donné exprimé sous la forme d’un pourcentage de cette concentration dans la norme/limite, par exemple pour une norme de 50μg/m3 de PM10, la concentration de 25μg/m3 est exprimée en 50%. |
|
Moyenne - actuel
|
current.standards.averaging | string |
Les valeurs de mesure sont interpolées par la moyenne des mesures des capteurs proches (jusqu’à 1,5 km de l’endroit donné). |
|
histoire
|
history | array of object |
Entrées historiques. |
|
À partir de DateTime - historique
|
history.fromDateTime | string |
ISO8601 horodatage. Date et heure UTC. Le champ représente l’heure de début à partir de laquelle les données de cette charge utile ont été mesurées et moyennes. |
|
Till DateTime - historique
|
history.tillDateTime | string |
ISO8601 horodatage. Date et heure UTC. Le champ représente l’heure de fin à laquelle les données de cette charge utile ont été mesurées et moyennes. |
|
values
|
history.values | array of object |
Valeurs : historique. |
|
Nom de la mesure - historique
|
history.values.name | string |
Nom (type) de la mesure donnée ; p. ex. PM10. |
|
Valeur de mesure - historique
|
history.values.value | float |
Valeur mesurée du type de mesure donné, par exemple concentration 25μg/m3. |
|
index
|
history.indexes | array of object |
Index : historique. |
|
Nom standard - historique
|
history.indexes.name | string |
Nom de cette norme. Actuellement, seules les normes de l’OMS sont prises en charge. |
|
Polluants - Historique
|
history.indexes.pollutant | string |
Nom du polluant auquel cette norme s’applique, actuellement seulement PM10 et PM25 sont pris en charge. |
|
Limite - historique
|
history.indexes.limit | float |
Certain niveau moyen de concentration des polluants qui ne doivent pas être dépassés sur une période donnée ; autrement dit, c’est la valeur pour laquelle la concentration de polluants atteint 100% de la limite. |
|
Pourcentage - Historique
|
history.indexes.percent | float |
La valeur de concentration d’un polluant donné exprimé sous la forme d’un pourcentage de cette concentration dans la norme/limite, par exemple pour une norme de 50μg/m3 de PM10, la concentration de 25μg/m3 est exprimée en 50%. |
|
Moyenne - historique
|
history.indexes.averaging | string |
Les valeurs de mesure sont interpolées par la moyenne des mesures des capteurs proches (jusqu’à 1,5 km de l’endroit donné). |
|
standards
|
history.standards | array of object |
Normes : historique. |
|
Nom standard - historique
|
history.standards.name | string |
Nom de cette norme. Actuellement, seules les normes de l’OMS sont prises en charge. |
|
Polluants - Historique
|
history.standards.pollutant | string |
Nom du polluant auquel cette norme s’applique, actuellement seulement PM10 et PM25 sont pris en charge. |
|
Limite - historique
|
history.standards.limit | float |
Certain niveau moyen de concentration des polluants qui ne doivent pas être dépassés sur une période donnée ; autrement dit, c’est la valeur pour laquelle la concentration de polluants atteint 100% de la limite. |
|
Pourcentage - Historique
|
history.standards.percent | float |
La valeur de concentration d’un polluant donné exprimé sous la forme d’un pourcentage de cette concentration dans la norme/limite, par exemple pour une norme de 50μg/m3 de PM10, la concentration de 25μg/m3 est exprimée en 50%. |
|
Moyenne - historique
|
history.standards.averaging | string |
Les valeurs de mesure sont interpolées par la moyenne des mesures des capteurs proches (jusqu’à 1,5 km de l’endroit donné). |
|
prévision
|
forecast | array of object |
Entrées de prévision. |
|
À partir de DateTime - prévision
|
forecast.fromDateTime | string |
ISO8601 horodatage. Date et heure UTC. Le champ représente l’heure de début à partir de laquelle les données de cette charge utile ont été mesurées et moyennes. |
|
Till DateTime - prévision
|
forecast.tillDateTime | string |
ISO8601 horodatage. Date et heure UTC. Le champ représente l’heure de fin à laquelle les données de cette charge utile ont été mesurées et moyennes. |
|
values
|
forecast.values | array of object |
Valeurs : prévision. |
|
Nom de la mesure - prévision
|
forecast.values.name | string |
Nom (type) de la mesure donnée ; p. ex. PM10. |
|
Valeur de mesure - Prévision
|
forecast.values.value | float |
Valeur mesurée du type de mesure donné, par exemple concentration 25μg/m3. |
|
index
|
forecast.indexes | array of object |
Index : prévision. |
|
Nom standard - Prévision
|
forecast.indexes.name | string |
Nom de cette norme. Actuellement, seules les normes de l’OMS sont prises en charge. |
|
Polluants - prévision
|
forecast.indexes.pollutant | string |
Nom du polluant auquel cette norme s’applique, actuellement seulement PM10 et PM25 sont pris en charge. |
|
Limite - prévision
|
forecast.indexes.limit | float |
Certain niveau moyen de concentration des polluants qui ne doivent pas être dépassés sur une période donnée ; autrement dit, c’est la valeur pour laquelle la concentration de polluants atteint 100% de la limite. |
|
Pourcentage - Prévision
|
forecast.indexes.percent | float |
La valeur de concentration d’un polluant donné exprimé sous la forme d’un pourcentage de cette concentration dans la norme/limite, par exemple pour une norme de 50μg/m3 de PM10, la concentration de 25μg/m3 est exprimée en 50%. |
|
Moyenne - prévision
|
forecast.indexes.averaging | string |
Les valeurs de mesure sont interpolées par la moyenne des mesures des capteurs proches (jusqu’à 1,5 km de l’endroit donné). |
|
standards
|
forecast.standards | array of object |
Normes : prévision. |
|
Nom standard - Prévision
|
forecast.standards.name | string |
Nom de cette norme. Actuellement, seules les normes de l’OMS sont prises en charge. |
|
Polluants - prévision
|
forecast.standards.pollutant | string |
Nom du polluant auquel cette norme s’applique, actuellement seulement PM10 et PM25 sont pris en charge. |
|
Limite - prévision
|
forecast.standards.limit | float |
Certain niveau moyen de concentration des polluants qui ne doivent pas être dépassés sur une période donnée ; autrement dit, c’est la valeur pour laquelle la concentration de polluants atteint 100% de la limite. |
|
Pourcentage - Prévision
|
forecast.standards.percent | float |
La valeur de concentration d’un polluant donné exprimé sous la forme d’un pourcentage de cette concentration dans la norme/limite, par exemple pour une norme de 50μg/m3 de PM10, la concentration de 25μg/m3 est exprimée en 50%. |
|
Moyenne - prévision
|
forecast.standards.averaging | string |
Les valeurs de mesure sont interpolées par la moyenne des mesures des capteurs proches (jusqu’à 1,5 km de l’endroit donné). |
Obtenir l’installation par ID
L’opération retourne des métadonnées d’installation uniques, données par InstallationId.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’installation
|
InstallationID | True | integer |
ID de l’installation unique pour obtenir les métadonnées. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
|
array of object | ||
|
Id
|
id | integer |
Identificateur d’installation unique. Avec InstallationId, vous pouvez interroger des mesures à partir d’une installation particulière. |
|
Latitude
|
location.latitude | float |
Coordonnées d’installation : latitude. Emplacement exact du capteur sur la carte. |
|
Longitude
|
location.longitude | float |
Coordonnées d’installation : longitude. Emplacement exact du capteur sur la carte. |
|
ID d’emplacement
|
locationId | integer |
Identificateur d’emplacement unique. |
|
Pays
|
address.country | string |
Pays d’installation. L’attribut est facultatif, peut être vide ou null. |
|
Ville
|
address.city | string |
Ville d’installation. L’attribut est facultatif, peut être vide ou null. |
|
Rue
|
address.street | string |
Rue d’installation. L’attribut est facultatif, peut être vide ou null. |
|
Number
|
address.number | string |
Numéro de rue d’installation. L’attribut est facultatif, peut être vide ou null. |
|
Adresse d’affichage 1
|
address.displayAddress1 | string |
Champ supplémentaire décrivant l’adresse, par exemple le nom ou le numéro de l’école. Champ facultatif. |
|
Adresse d’affichage 2
|
address.displayAddress2 | string |
Champ supplémentaire décrivant l’adresse, par exemple le nom ou le numéro de l’école. Champ facultatif. |
|
Elevation
|
elevation | float |
Altitude à laquelle l’appareil est installé ; mètres au-dessus du niveau moyen de la mer (mamsl). |
|
Airly
|
airly | boolean |
Indicateur indiquant si cette installation est un appareil Airly ou non ; Par exemple, les stations GIOŚ sont signalées comme étant fausses. |
|
Id
|
sponsor.id | integer |
Identificateur du sponsor. |
|
Nom
|
sponsor.name | string |
Nom du sponsor de cette installation. |
|
Descriptif
|
sponsor.description | string |
Description supplémentaire du sponsor de cette installation. |
|
Logo
|
sponsor.logo | string |
URL pointant vers le logo du sponsor (image jpg). |
|
Lien
|
sponsor.link | string |
URL pointant vers le site web du sponsor. |