forecast
uç noktası
96 saate kadar (4 gün) saatlik hava durumu sağlar
belirli bir konum için kalite tahmini bilgileridir. Her tahmin saatlik olarak
ve ek bilgiler:
- Tahmin için belirli bir saat, tarih veya zaman aralığı
- Çevrilmiş alanlar için dil kodu
- Yerel veya özel hava kalitesi indeksi (HKİ)
- Sağlık önerileri
- Kirliliğe yol açan baskın maddeler
- Kirliliğe yol açan madde konsantrasyonu
- Kirliliğe yol açan maddeler hakkında ek bilgi
- Yanıt sayfası boyutu
- Renk paleti
API Gezgini, canlı isteklerde bulunur. Bu sayede API ve API seçenekleri:
Tahmin istekleri hakkında
Şunu kullanarak saatlik hava kalitesi tahmin bilgilerini isteyebilirsiniz: şuna bir HTTP POST isteği göndererek uç nokta tahminini görebilirsiniz:
https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY
parametreler yazması gerekir. İstek gövdesinde, saatlik hava kalitesi tahmini bilgilerini ve çeşitli seçenekleri içeren yanıta hangi ek bilgilerin dahil edileceğini kontrol edebilir.
Tahmin yanıtları hakkında
Yanıt gövdesi, havanın gösterileceği UTC tarih ve saatini sağlar kalite tahmini bilgileri, hava kalitesi indeksleri ve ek özelleştirilmiş bilgiler ekleyebilirsiniz. Yanıt gövdesi, sonraki sayfayı almak için bir jeton da içerir bilgiler istenen sayfa boyutuna uymuyorsa.
Temel istek örneği
Aşağıdaki kodda, tahmin isteğinin nasıl oluşturulacağı gösterilmektedir. Bu örnekte konumu, tarihi ve saati (sonraki saatten başlayarak 96 saat (saat) görüntülenebilir.
curl -X POST -d '{ "location": { "latitude": 37.4125333, "longitude": -122.0840937 }, "dateTime": "2024-02-09T08:00:00Z" }' \ -H "Content-Type: application/json" \ -H "Accept-Language: *" \ "https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY"
Çağrı, aşağıdaki JSON yanıtını oluşturur.
{ "hourlyForecasts": [ { "dateTime": "2024-02-09T08:00:00Z", "indexes": [ { "code": "uaqi", "displayName": "Universal AQI", "aqi": 80, "aqiDisplay": "80", "color": { "red": 0.34509805, "green": 0.74509805, "blue": 0.20784314 }, "category": "Excellent air quality", "dominantPollutant": "pm25" } ] } ], "regionCode": "us" }
Birden fazla parametre içeren istek örneği
Aşağıdaki kod birden çok öğe içeren bir istek gövdesinin nasıl oluşturulacağını gösterir parametreleridir. Bu örnekte şunları belirtirsiniz:
- Konum
- Hava kalitesi tahmin bilgilerinin gösterileceği dönem
- Dil kodu
- Ek hesaplamalar (ör. sağlık önerileri, kirliliğe yol açan baskın madde) konsantrasyonu ve kirliliğe yol açan ek bilgiler)
- Renk paleti
curl -X POST -d '{ "pageSize": "10", "universalAqi": "true", "location": { "latitude": "40.741895", "longitude": "-73.989308" }, "period": { "startTime": "2024-02-27T13:58:14+02:00", "endTime": "2024-02-28T16:58:14+02:00" }, "languageCode": "en", "extraComputations": [ "HEALTH_RECOMMENDATIONS", "DOMINANT_POLLUTANT_CONCENTRATION", "POLLUTANT_ADDITIONAL_INFO" ], "uaqiColorPalette": "RED_GREEN" }' \ -H "Content-Type: application/json" \ -H "Accept-Language: *" \ "https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY"
Çağrı, aşağıdaki JSON yanıtını oluşturur.
{ { "hourlyForecasts": [ { "dateTime": "2024-02-27T11:00:00Z", "indexes": [ { "code": "uaqi", "displayName": "Universal AQI", "aqi": 75, "aqiDisplay": "75", "color": { "red": 0.43137255, "green": 0.7764706, "blue": 0.20392157 }, "category": "Good air quality", "dominantPollutant": "pm25" } ], "pollutants": [ { "code": "pm25", "displayName": "PM2.5", "fullName": "Fine particulate matter (\u003c2.5µm)", "concentration": { "value": 15.1, "units": "MICROGRAMS_PER_CUBIC_METER" }, "additionalInfo": { "sources": "...", "effects": "..." } } ], "healthRecommendations": { "generalPopulation": "...", "lungDiseasePopulation": "...", "heartDiseasePopulation": "...", "athletes": "...", "pregnantWomen": "..." } }, { "dateTime": "2024-02-27T12:00:00Z", "indexes": [ { "code": "uaqi", "displayName": "Universal AQI", "aqi": 67, "aqiDisplay": "67", "color": { "red": 0.5882353, "green": 0.8392157, "blue": 0.16862746 }, "category": "Good air quality", "dominantPollutant": "pm25" } ], "pollutants": [ { "code": "pm25", "displayName": "PM2.5", "fullName": "Fine particulate matter (\u003c2.5µm)", "concentration": { "value": 19.96, "units": "MICROGRAMS_PER_CUBIC_METER" }, "additionalInfo": { "sources": "...", "effects": "..." } } ], "healthRecommendations": { "generalPopulation": "...", "lungDiseasePopulation": "...", "heartDiseasePopulation": "...", "athletes": "...", "pregnantWomen": "...", "children": "..." } }, /.../ ] } "regionCode": "us", "nextPageToken": "CjMKEglwCFVq9l5EQBH0aoDSUH9SwBoQCgYI1pDirgYSBgiGiOiuBiABKgMCBAMyAmVuOAEQGA==" }
Tahmin bilgilerinin bir sonraki sayfasını görüntülemek için nextPageToken
.
yanıt gövdesinin sonunda döndürüldü:
curl -X POST -d '{ "universalAqi": "true", "location": { "latitude": "40.741895", "longitude": "-73.989308" }, "period": { "startTime": "2024-02-27T13:58:14+02:00", "endTime": "2024-02-28T16:58:14+02:00" }, "languageCode": "en", "extraComputations": [ "HEALTH_RECOMMENDATIONS", "DOMINANT_POLLUTANT_CONCENTRATION", "POLLUTANT_ADDITIONAL_INFO" ], "uaqiColorPalette": "RED_GREEN", "pageToken": "CjMKEglwCFVq9l5EQBH0aoDSUH9SwBoQCgYI1pDirgYSBgiGiOiuBiABKgMCBAMyAmVuOAEQGA==" }' \ -H "Content-Type: application/json" \ -H "Accept-Language: *" \ "https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY"
Bu komut, tahmin bilgilerinin sonraki sayfasını döndürür:
{ "hourlyForecasts": [ { "dateTime": "2024-02-27T21:00:00Z", "indexes": [ { "code": "uaqi", "displayName": "Universal AQI", "aqi": 74, "aqiDisplay": "74", "color": { "red": 0.44705883, "green": 0.78431374, "blue": 0.2 }, "category": "Good air quality", "dominantPollutant": "o3" } ], "pollutants": [ { "code": "o3", "displayName": "O3", "fullName": "Ozone", "concentration": { "value": 32.07, "units": "PARTS_PER_BILLION" }, "additionalInfo": { "sources": "...", "effects": "..." } } ], "healthRecommendations": { "generalPopulation": "...", "elderly": "...", "lungDiseasePopulation": "...", "heartDiseasePopulation": "...", "athletes": "...", "pregnantWomen": "...", "children": "..." } }, { "dateTime": "2024-02-27T22:00:00Z", "indexes": [ { "code": "uaqi", "displayName": "Universal AQI", "aqi": 75, "aqiDisplay": "75", "color": { "red": 0.43137255, "green": 0.7764706, "blue": 0.20392157 }, "category": "Good air quality", "dominantPollutant": "o3" } ], "pollutants": [ { "code": "o3", "displayName": "O3", "fullName": "Ozone", "concentration": { "value": 30.94, "units": "PARTS_PER_BILLION" }, "additionalInfo": { "sources": "...", "effects": "..." } } ], "healthRecommendations": { "generalPopulation": "...", "lungDiseasePopulation": "...", "heartDiseasePopulation": "...", "athletes": "...", "pregnantWomen": "...", "children": "..." } }, /.../ ] "regionCode": "us" }