Der Endpunkt forecast
bietet bis zu 96 Stunden (4 Tage) pro Stunde Luft
Informationen zur Qualitätsprognose
für einen bestimmten Standort. Jede Prognose umfasst stündliche
Luftqualitätsindexe sowie weitere Informationen:
- Bestimmter Zeitpunkt und Datum oder Zeitraum für die Prognose
- Sprachcode für übersetzte Felder
- Lokaler oder benutzerdefinierter Luftqualitätsindex (LQI)
- Gesundheitsempfehlungen
- Dominante Schadstoffe
- Schadstoffkonzentration
- Weitere Informationen zu Schadstoffen
- Größe der Antwortseite
- Farbvorlage
Mit APIs Explorer können Sie Live-Anfragen stellen, damit Sie sich mit die API und die API-Optionen:
Prognoseanfragen
Sie können stündliche Informationen zur Luftqualitätsprognose über die Prognoseendpunkt durch Senden einer HTTP-POST-Anfrage an folgende Adresse:
https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY
Ihre Parameter im Anfragetext. Der Anfragetext enthält den Standort, für den Sie z. B. stündliche Vorhersageinformationen zur Luftqualität und verschiedene Optionen, welche zusätzlichen Informationen in der Antwort enthalten sein sollen.
Prognosenantworten
Der Antworttext enthält das UTC-Datum und die UTC-Zeit für die Anzeige der Luft Informationen zur Qualitätsprognose, Luftqualitätsindexe und zusätzliche benutzerdefinierte Informationen. Der Antworttext enthält auch ein Token zum Abrufen der nächsten Seite. wenn die Informationen nicht in die angeforderte Seitengröße passen.
Beispiel für eine einfache Anfrage
Der folgende Code zeigt, wie eine Prognoseanfrage erstellt wird. In diesem Beispiel geben Sie den Ort, das Datum und die Uhrzeit an (ab der nächsten Stunde bis 96 Stunden), für die stündliche Informationen zur Luftqualität angezeigt werden sollen.
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"
Der Aufruf generiert die folgende JSON-Antwort.
{ "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" }
Beispiel für eine Anfrage mit mehreren Parametern
Der folgende Code zeigt, wie ein Anfragetext mit mehreren Parameter. In diesem Beispiel geben Sie Folgendes an:
- Standort
- Zeitraum, für den Informationen zur Luftqualitätsprognose angezeigt werden sollen
- Sprachcode
- Zusätzliche Berechnungen (z. B. Gesundheitsempfehlungen, der vorherrschende Schadstoff Konzentration und zusätzliche Schadstoffinformationen)
- Farbvorlage
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"
Der Aufruf generiert die folgende JSON-Antwort.
{ { "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==" }
Um die nächste Seite mit Prognoseinformationen aufzurufen, übergeben Sie nextPageToken
wird am Ende des Antworttexts zurückgegeben:
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"
Dadurch wird die nächste Seite mit Prognoseinformationen zurückgegeben:
{ "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" }