history uç noktası, belirli bir zaman aralığı için en fazla 30 gün boyunca belirli bir konumla ilgili geçmiş saatlik hava kalitesi bilgilerini sağlar. Hangi HKİ'lerin ve geçerli bilgilerin (ör. kirliliğe yol açan madde konsantrasyon seviyesi ve sağlık önerileri) döndürüleceğini kontrol edebilirsiniz.
Aşağıdaki adrese bir HTTP POST isteği göndererek history uç noktasını kullanarak saatlik hava kalitesi geçmişini isteyebilirsiniz:
https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY
İstek seçeneklerinizi JSON istek gövdesine ekleyin. İsteğin gövde bölümünde, saatlik hava kalitesi geçmişini almak istediğiniz konum ve zaman aralığı bulunur. Ayrıca, yanıta hangi hava kalitesi bilgilerinin dahil edileceğini kontrol etmek için çeşitli seçenekler de içerebilir.
Tek saatlik istek örneği
Bir saatlik istek gövdesi
Aşağıdaki kod, history yöntemini kullanarak tek bir saatlik geçmiş isteği için istek gövdesinin nasıl oluşturulacağını göstermektedir.
Bu örnekte konumu ve geçmiş zaman damgasını ayarladınız.
curl -X POST -d '{
"dateTime": "2023-06-26T15:01:23Z",
"location": {
"latitude": 37.419734,
"longitude": -122.0827784
}
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'
Bir saat içinde yanıt
Yukarıdaki çağrı, aşağıdaki JSON yanıtını oluşturur. Yanıt verileriyle ilgili daha fazla ayrıntı için Yanıt verileri bölümüne bakın.
{
"hoursInfo": [
{
"dateTime": "2023-06-26T15:00:00Z",
"indexes": [
{
"code": "uaqi",
"displayName": "Universal AQI",
"aqi": 73,
"aqiDisplay": "73",
"color": {
"red": 118,
"green": 202,
"blue": 51,
"alpha": 255
},
"category": "Good air quality",
"dominantPollutant": "pm10"
}
]
}
],
"regionCode": "us"
}
Zaman aralığı isteği örneği
Zaman aralığı isteği
Aşağıdaki kod, geçmişteki saatlik hava kalitesinin birden fazla kaydını döndüren bir history için istek gövdesinin nasıl oluşturulacağını gösterir.
Bir zaman aralığı (başlangıç ve bitiş zaman damgası) belirterek veya geçerli saatten kaç saat geri dönüleceğini belirterek birden fazla kayıt isteyebilirsiniz.
Aşağıdaki örnekte, sayfa boyutunu 2 olarak ayarladığınız için dört saatlik hava kalitesi geçmişi isteğiniz iki sayfada döndürülür ve her sayfada iki saatlik veri yer alır.
curl -X POST -d '{
"hours": 4,
"pageSize": 2,
"pageToken":"",
"location": {
"latitude": 37.419734,
"longitude": -122.0827784
}
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'
Başlangıç ve bitiş zaman damgalarını ileterek benzer bir istekte bulunabilirsiniz:
curl -X POST -d '{
"period": {
"startTime":"2023-06-15T08:00:00Z",
"endTime":"2023-06-15T12:00:00Z"
},
"pageSize": 2,
"pageToken":"",
"location": {
"latitude": 37.419734,
"longitude": -122.0827784
}
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'
Zaman aralığı yanıtı
Yukarıdaki çağrılar, aşağıdaki biçimde bir JSON yanıtı oluşturur. Yanıt verileri hakkında daha fazla bilgi için Yanıt verileri bölümüne bakın.
Yukarıdaki her iki aramada da dört saatlik hava kalitesi verisi istenir. Bununla birlikte, istekte pageSize özelliğini 2 olarak ayarladığınız için yanıt, yalnızca son iki saate ait sonuçları içerir.
{
"hoursInfo": [
{
"dateTime": "2023-06-15T11:00:00Z",
"indexes": [
{
"code": "uaqi",
"displayName": "Universal AQI",
"aqi": 83,
"aqiDisplay": "83",
"color": {
"red": 74,
"green": 185,
"blue": 54,
"alpha": 255
},
"category": "Excellent air quality",
"dominantPollutant": "o3"
}
]
},
{
"dateTime": "2023-06-15T10:00:00Z",
"indexes": [
{
"code": "uaqi",
"displayName": "Universal AQI",
"aqi": 89,
"aqiDisplay": "89",
"color": {
"red": 48,
"green": 175,
"blue": 55,
"alpha": 255
},
"category": "Excellent air quality",
"dominantPollutant": "o3"
}
]
}
],
"regionCode": "us",
"nextPageToken": "ChYaEgl3gv3XubVCQBEsNMY9TTdUMTE6MDA6MDA"
}
Yanıtın nextPageToken özelliğini de içerdiğine dikkat edin. Sonraki iki saatlik veriyi içeren bir sonraki sonuç sayfasına erişmek için bu özelliği kullanın.
Bir sonraki sonuç sayfasına erişmek için history uç noktasına ikinci bir istekte bulunun ancak bu kez pageToken özelliğini ilk yanıttaki nextPageToken değerine ayarlayın.
curl -X POST -d '{
"hours": 4,
"pageSize": 2,
"pageToken":"ChYaEgl3gv3XubVCQBEsNMY9TTdUMTE6MDA6MDA",
"location": {
"latitude": 37.419734,
"longitude": -122.0827784
}
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'