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 indeks ve küresel hava kalitesi endeksi ile kategorileri 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ıyla birlikte veriler 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 hava kalitesi güncel koşullar verilerini aradığı boylam ve enlemdir.
extraComputations[]

enum (ExtraComputation)

İsteğe bağlı. İsteğe bağlı olarak etkinleştirilebilen ek özellikler. Ek hesaplamaların belirtilmesi, ilgili öğelerin ve alanların yanıtta döndürülmesiyle sonuçlanır.
uaqiColorPalette

enum (ColorPalette)

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

object (CustomLocalAqi)

İsteğe bağlı. "Ülke/bölge ile HKİ" ilişkisi ifade eder. Bir ülkeyi/bölgeyi istenen HKİ ile eşleyerek o ülke/bölge için gerekli olan hava kalitesi verilerinin seçilen HKİ'ye göre görüntülenmesini sağlar. Bu parametre, belirli bir ülke için varsayılan olmayan bir HKİ belirtmek amacıyla (örneğin, 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İ, yanıtın "dizinler" alanına eklenir. Varsayılan değer, doğru değeridir.
languageCode

string

İsteğe bağlı. İstemcinin yanıtın dilini seçmesine olanak tanır. Bu dil için veri sağlanamazsa API en yakın eşleşmeyi kullanır. İzin verilen değerler IETF standardını kullanır. Varsayılan değer İngilizce'dir (en).

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)

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde yuvarlanmış zaman damgası. Örneğin: "2014-10-02T15:00:00Z".
regionCode

string

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

object (AirQualityIndex)

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

  • Evrensel HKİ. universalAqi boole değeri doğru değerine ayarlanırsa döndürülür.
  • Yerel HKİ. LOCAL_AQI ekstra hesaplama 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 ekstra hesaplamalardan birini veya daha fazlasını belirten 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. Risk altındaki kişiler, kirliliğe yol açan maddelere karşı daha hassas olan gruplar ve genel popülasyon için öneriler farklı şekilde özelleştirilir.

Yetkilendirme kapsamları

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

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.