Belirli bir zaman aralığı için belirli bir konumun hava kalitesi geçmişini döndürür.
HTTP isteği
POST https://airquality.googleapis.com/v1/history: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 |
---|
{ "pageSize": integer, "pageToken": string, "location": { object ( |
Alanlar | |
---|---|
pageSize |
İsteğe bağlı. Sayfa başına döndürülecek maksimum saatlik bilgi kaydı sayısı. Varsayılan değer 72 ve maksimum değer 168'dir (7 günlük veri). |
pageToken |
İsteğe bağlı. Önceki bir geçmiş çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için kullanılır. Bu parametre için bir değer sağlarken sağlanan diğer tüm parametrelerin, sayfa jetonunu (önceki çağrı) sağlayan çağrıyla eşleşmesi gerektiğini unutmayın. |
location |
Zorunlu. API'nin hava kalitesi geçmiş verilerini aradığı enlem ve boylam. |
extraComputations[] |
İ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 |
İ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[] |
İ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. |
dateTime |
Geçmiş verilerin döndürüleceği zaman damgası. Zaman damgası, önceki tam saate yuvarlanır. Not: Bu, yalnızca istenen zaman damgası için saatlik verileri (ör. tek bir saatlik bilgi öğesi) döndürür. Örneğin, dateTime parametresinin 2023-01-03T11:05:49Z olarak ayarlandığı bir istek, 2023-01-03T11:00:00Z değerine yuvarlanır. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z". Not: İstekte |
hours |
İsteğin saat aralığını belirten 1 ile 720 arasındaki sayı. Örneğin: 48 değeri, son 48 saate ait verileri verir. |
period |
Geçmiş verilerin alınacağı Not: İstekte |
universalAqi |
İsteğe bağlı. Doğru değerine ayarlanırsa Evrensel HKİ, "dizinlere" eklenir kullanabilirsiniz. Varsayılan değer, doğru değeridir. |
languageCode |
İ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 |
---|
{
"hoursInfo": [
{
object ( |
Alanlar | |
---|---|
hoursInfo[] |
İsteğe bağlı. İstenen aralıktaki her saat için hava kalitesi bilgilerini içerir. Örneğin, istek 48 saatlik geçmişle ilgiliyse 48 saatlik bilgi öğesi olur. |
regionCode |
İsteğe bağlı. İ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. |
nextPageToken |
İsteğe bağlı. Sonraki sayfayı alma jetonu. |
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.
HourInfo
İstenen aralıktaki her saat için hava kalitesi bilgilerini içerir. Örneğin, istek 48 saatlik geçmişle ilgiliyse 48 saatlik bilgi öğesi olur.
JSON gösterimi |
---|
{ "dateTime": string, "indexes": [ { object ( |
Alanlar | |
---|---|
dateTime |
RFC3339 UTC "Zulu" bölümünde verilerin belirttiği zamanı gösteren, aşağı yuvarlanmış bir zaman damgası biçiminde olmalıdır. Örneğin: "2014-10-02T15:00:00Z". |
indexes[] |
İstek parametrelerine bağlı olarak bu liste (en fazla) iki hava kalitesi indeksi içerecektir:
|
pollutants[] |
İ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 |
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. |