Method: currentConditions.lookup

Le point de terminaison Conditions actuelles fournit des informations horaires sur la qualité de l'air dans plus de 100 pays, avec une résolution de 500 x 500 mètres. Comprend plus de 70 indices locaux, ainsi qu'un indice et des catégories de la qualité de l'air mondiaux.

Requête HTTP

POST https://airquality.googleapis.com/v1/currentConditions: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 
{
  "location": {
    object (LatLng)
  },
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "uaqiColorPalette": enum (ColorPalette),
  "customLocalAqis": [
    {
      object (CustomLocalAqi)
    }
  ],
  "universalAqi": boolean,
  "languageCode": string
}
Champs
location

object (LatLng)

Obligatoire. Longitude et latitude à partir desquelles l'API recherche les données sur les conditions actuelles de qualité de l'air.
extraComputations[]

enum (ExtraComputation)

Facultatif. Fonctionnalités supplémentaires qui peuvent ê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

enum (ColorPalette)

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 n'est pertinente que pour l'UAQI. Les autres IQA ont une palette de couleurs prédéterminée qui ne peut pas être contrôlée.
customLocalAqis[]

object (CustomLocalAqi)

Facultatif. Indique un "pays/région pour l'IQA" relation. Associe un pays/une région à un IQA souhaité afin que les données sur la qualité de l'air requises pour ce pays/cette région soient affichées 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'Agence américaine de protection de l'environnement pour le Canada plutôt que l'indice par défaut pour le Canada.
universalAqi

boolean

Facultatif. Si elle est définie sur "True", l'IQA universel est inclus dans la métrique "Indices" de la réponse. La valeur par défaut est "true" (vrai).
languageCode

string

Facultatif. Permet au client de choisir la langue de la réponse. Si les données ne peuvent pas être fournies pour ce langage, l'API utilise la correspondance la plus proche. Les valeurs autorisées sont basées sur 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 
{
  "dateTime": string,
  "regionCode": string,
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  }
}
Champs
dateTime

string (Timestamp format)

Code temporel arrondi à la valeur inférieure de la RFC 3339 UTC "Zulu" avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Par exemple : "2014-10-02T15:00:00Z".
regionCode

string

Code ISO_3166-1 alpha-2 du pays ou de la région correspondant à l'emplacement fourni dans la requête. Ce champ peut être omis de la réponse si la zone géographique indiquée dans la demande se trouve dans un territoire contesté.
indexes[]

object (AirQualityIndex)

En fonction des paramètres de demande, cette liste comprendra jusqu'à deux indices de la qualité de l'air:

  • IQA universel. Sera renvoyé si la valeur booléenne "UniversalAqi" est définie sur "true".
  • IQA local. Sera renvoyé si le calcul supplémentaire LOCAL_AQI est spécifié.
pollutants[]

object (Pollutant)

Liste des polluants affectant l'emplacement spécifié dans la requête. Remarque: Ce champ est renvoyé uniquement pour les requêtes spécifiant un ou plusieurs des calculs supplémentaires suivants: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION.
healthRecommendations

object (HealthRecommendations)

Conseils de santé et actions recommandées en lien avec les conditions de qualité de l'air signalées. Les recommandations sont adaptées différemment aux populations à risque, aux groupes plus sensibles aux polluants et à la population globale.

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.