forecast
uç noktası, belirli bir konum için 96 saate (4 güne) kadar saatlik hava kalitesi tahmini bilgisi sağlar. Her tahminde saatlik hava kalitesi indeksleri ve ek bilgiler bulunur:
- Tahmin için belirli bir saat ve tarih veya dönem
- Çevrilmiş alanların dil kodu
- Yerel veya özel hava kalitesi indeksi (HKİ)
- Sağlıkla ilgili öneriler
- Kirliliğe yol açan başlıca 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, API'ye ve API seçeneklerine aşina olabilmeniz için canlı istek göndermenize olanak tanır:
Tahmin istekleri hakkında
Aşağıdaki uç noktaya bir HTTP POST isteği göndererek tahmin uç noktasını kullanarak saatlik hava kalitesi tahmini bilgilerini isteyebilirsiniz:
https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY
Parametrelerinizi istek gövdesine ekleyin. İstek gövdesi, hava kalitesiyle ilgili saatlik tahmin bilgilerini almak istediğiniz konumu ve yanıta hangi ek bilgilerin ekleneceğini kontrol etmek için çeşitli seçenekleri içerir.
Tahmin yanıtları hakkında
Yanıt gövdesi, hava kalitesi tahmini bilgilerinin, hava kalitesi indekslerinin ve ek özelleştirilmiş bilgilerin gösterileceği UTC tarihini ve saatini sağlar. Yanıt gövdesinde, bilgiler istenen sayfa boyutuna sığmazsa bir sonraki sayfayı almak için bir jeton da bulunur.
Temel istek örneği
Aşağıdaki kodda, tahmin isteğinin nasıl oluşturulacağı gösterilmektedir. Bu örnekte, saatlik hava kalitesi tahmini bilgilerinin gösterileceği konumu, tarihi ve saati (bir sonraki saatten 96 saate kadar) belirtirsiniz.
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 kodda, birden fazla parametre içeren bir istek gövdesinin nasıl oluşturulacağı gösterilmektedir. Bu örnekte aşağıdakileri belirtirsiniz:
- Konum
- Hava kalitesi tahmini bilgilerinin gösterileceği dönem
- Dil kodu
- Ek hesaplamalar (ör. sağlık önerileri, baskın kirliliğe yol açan madde konsantrasyonu ve kirliliğe yol açan diğer maddelerle ilgili 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 yanıt gövdesinin sonuna döndürülen nextPageToken
parametresini iletin:
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 işlem, tahmin bilgilerinin bir 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" }