Method: currentConditions.lookup

Mevcut Koşullar uç noktası, 100'den fazla ülkede 500 x 500 metre çözünürlüğe kadar saatlik hava kalitesi bilgileri sağlar. 70'ten fazla yerel indeksi ve global hava kalitesi indeksi ile kategorilerini içerir.

HTTP isteği

POST https://airquality.googleapis.com/v1/currentConditions:lookup

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi 
{
  "location": {
    object (LatLng)
  },
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "uaqiColorPalette": enum (ColorPalette),
  "customLocalAqis": [
    {
      object (CustomLocalAqi)
    }
  ],
  "universalAqi": boolean,
  "languageCode": string
}
Alanlar
location

object (LatLng)

Zorunlu. API'nin güncel hava kalitesi koşullarıyla ilgili verileri aradığı boylam ve enlemdir.
extraComputations[]

enum (ExtraComputation)

İsteğe bağlı. İsteğe bağlı olarak etkinleştirilebilen ek özellikler. Ek hesaplamalar belirtmek, ilgili öğelerin ve alanların yanıtta döndürülmesini sağlar.
uaqiColorPalette

enum (ColorPalette)

İsteğe bağlı. "Evrensel Hava Kalitesi İndeksi" tarafından sağlanan veriler için kullanılan renk paletini belirler (UAQI). Bu renk paleti yalnızca UAQI ile ilgilidir. Diğer HKİ'lerin kontrol edilemeyen önceden belirlenmiş bir renk paleti vardır.
customLocalAqis[]

object (CustomLocalAqi)

İsteğe bağlı. "HKİ'ye ülke/bölge" ifade eder ilişkilidir. Bir ülkeyi/bölgeyi istenen HKİ ile eşleştirir. Böylece, o ülke/bölge için gerekli olan hava kalitesi verileri, seçilen HKİ'ye göre görüntülenir. Bu parametre, belirli bir ülke için varsayılan olmayan bir HKİ belirtmek amacıyla kullanılabilir. Örneğin, bu parametre Kanada için varsayılan dizin yerine Kanada için ABD EPA dizinini almak amacıyla kullanılabilir.
universalAqi

boolean

İsteğe bağlı. Doğru değerine ayarlanırsa Evrensel HKİ, "dizinlere" eklenir kullanabilirsiniz. Varsayılan değer, doğru değeridir.
languageCode

string

İsteğe bağlı. İstemcinin yanıtın dilini seçmesine izin verir. Bu dil için veri sağlanamıyorsa API en yakın eşleşmeyi kullanır. İzin verilen değerler IETF standardına dayanır. Varsayılan değer "en"dir.

Yanıt gövdesi

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "dateTime": string,
  "regionCode": string,
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  }
}
Alanlar
dateTime

string (Timestamp format)

RFC3339 UTC "Zulu"da aşağı yuvarlanmış bir zaman damgası biçiminde olmalıdır. Örneğin: "2014-10-02T15:00:00Z".
regionCode

string

İstekte sağlanan konuma karşılık gelen ülkenin/bölgenin ISO_3166-1 alpha-2 kodu. İstekte belirtilen konum itiraz edilen bir bölgedeyse bu alan yanıttan çıkarılabilir.
indexes[]

object (AirQualityIndex)

İstek parametrelerine bağlı olarak bu liste (en fazla) iki hava kalitesi indeksi içerecektir:

  • Evrensel HKİ. universalAqi boole değeri doğru değerine ayarlanırsa döndürülür.
  • Yerel HKİ. LOCAL_AQI ek hesaplaması belirtilirse döndürülür.
pollutants[]

object (Pollutant)

İstekte belirtilen konumu etkileyen kirliliğe yol açan maddelerin listesi. Not: Bu alan yalnızca şu ek hesaplamalardan bir veya daha fazlasının belirtildiği istekler için döndürülür: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION.
healthRecommendations

object (HealthRecommendations)

Bildirilen hava kalitesi koşullarıyla ilgili sağlık önerileri ve önerilen işlemler. Öneriler; risk altındaki popülasyonlar, kirliliğe yol açan maddelere karşı hassasiyeti daha yüksek olan gruplar ve genel nüfus için farklı şekilde uyarlanır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/cloud-platform

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.