- Requête HTTP
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- HourInfo
Affiche l'historique de la qualité de l'air pour un lieu spécifique pendant une période donnée.
Requête HTTP
POST https://airquality.googleapis.com/v1/history:lookup
L'URL utilise la syntaxe de transcodage gRPC.
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{ "pageSize": integer, "pageToken": string, "location": { object ( |
Champs | |
---|---|
pageSize |
Facultatif. Nombre maximal d'enregistrements d'informations horaires à renvoyer par page. La valeur par défaut est 72. La valeur maximale est 168 (7 jours de données). |
pageToken |
Facultatif. Jeton de page reçu à partir d'un appel d'historique précédent. Il permet de récupérer la page suivante. Notez que lorsque vous attribuez une valeur à ce paramètre, tous les autres paramètres fournis doivent correspondre à l'appel qui a fourni le jeton de page (l'appel précédent). |
location |
Obligatoire. Latitude et longitude pour lesquelles l'API recherche des données historiques sur la qualité de l'air. |
extraComputations[] |
Facultatif. Fonctionnalités supplémentaires pouvant être activées en option Si vous spécifiez des calculs supplémentaires, les éléments et champs pertinents seront renvoyés dans la réponse. |
uaqiColorPalette |
Facultatif. Détermine la palette de couleurs utilisée pour les données fournies par l 'indice universel de la qualité de l'air (UAQI). Cette palette de couleurs ne concerne que les UAQI. Les autres ont une palette de couleurs prédéterminée qui ne peut pas être contrôlée. |
customLocalAqis[] |
Facultatif. Exprime une relation "pays/région pour l'IQA". associe un pays/une région à l'IQA souhaité afin que les données sur la qualité de l'air requises pour ce pays/cette région s'affichent en fonction de l'IQA choisi. Ce paramètre permet de spécifier un IQA autre que celui par défaut pour un pays donné, par exemple, afin d'obtenir l'indice de l'EPA des États-Unis pour le Canada plutôt que l'indice par défaut pour le Canada. |
dateTime |
Horodatage pour lequel renvoyer des données historiques. Le code temporel est arrondi à l'heure exacte précédente. Remarque: cette méthode ne renverra des données horaires que pour l'horodatage demandé (c'est-à-dire un seul élément d'information horaire). Par exemple, une requête envoyée pour laquelle le paramètre dateTime est défini sur 2023-01-03T11:05:49Z sera arrondie à 2023-01-03T11:00:00Z. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z". Remarque:Vous pouvez utiliser |
hours |
Nombre compris entre 1 et 720 qui indique la plage d'heures pour la requête. Par exemple, la valeur 48 renvoie les données des dernières 48 heures. |
period |
Indique les périodes Remarque:Vous pouvez utiliser |
universalAqi |
Facultatif. Si elle est définie sur "True", l'IQA universel est inclus dans le champ "index" de la réponse. La valeur par défaut est "true" (vrai). |
languageCode |
Facultatif. Permet au client de choisir la langue de la réponse. Si aucune donnée ne peut être fournie pour cette langue, l'API utilise la correspondance la plus proche. Les valeurs autorisées dépendent de la norme IETF. La valeur par défaut est "en". |
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient des données présentant la structure suivante :
Représentation JSON |
---|
{
"hoursInfo": [
{
object ( |
Champs | |
---|---|
hoursInfo[] |
Facultatif. Contient des informations sur la qualité de l'air pour chaque heure dans la plage demandée. Par exemple, si la requête porte sur 48 heures d'historique, les informations horaires seront au nombre de 48. |
regionCode |
Facultatif. Code ISO_3166-1 alpha-2 du pays ou de la région correspondant à la zone géographique indiquée dans la requête. Ce champ peut être omis de la réponse si le lieu indiqué dans la requête se trouve dans un territoire contesté. |
nextPageToken |
Facultatif. Jeton permettant de récupérer la page suivante. |
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/cloud-platform
Pour en savoir plus, consultez la présentation d'OAuth 2.0.
HourInfo
Contient des informations sur la qualité de l'air pour chaque heure dans la plage demandée. Par exemple, si la requête porte sur 48 heures d'historique, les informations horaires seront au nombre de 48.
Représentation JSON |
---|
{ "dateTime": string, "indexes": [ { object ( |
Champs | |
---|---|
dateTime |
Code temporel arrondi au format inférieur indiquant l'heure à laquelle les données font référence au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et neuf chiffres décimaux au maximum. Par exemple: "2014-10-02T15:00:00Z". |
indexes[] |
En fonction des paramètres de la requête, cette liste comprendra jusqu'à deux indices de la qualité de l'air:
|
pollutants[] |
Liste des polluants affectant l'emplacement spécifié dans la requête. Remarque: Ce champ n'est renvoyé que pour les requêtes qui ont spécifié un ou plusieurs des calculs supplémentaires suivants: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION. |
healthRecommendations |
Conseils de santé et actions recommandées concernant les conditions de qualité de l'air signalées. Les recommandations sont adaptées différemment pour les populations à risque, les groupes plus sensibles aux polluants et la population globale. |