Der Endpunkt forecast liefert stündliche Vorhersagen zur Luftqualität für einen bestimmten Standort für bis zu 96 Stunden (4 Tage). Jede Prognose enthält stündliche Luftqualitätsindexe sowie zusätzliche Informationen:
- Bestimmte Uhrzeit und bestimmtes Datum oder bestimmter Zeitraum für die Vorhersage
- Sprachcode für übersetzte Felder
- Lokaler oder benutzerdefinierter Luftqualitätsindex (LQI)
- Zustandsempfehlungen
- Dominante Schadstoffe
- Schadstoffkonzentration
- Weitere Informationen zu Schadstoffen
- Seitengröße der Antwort
- Farbvorlage
Mit dem APIs Explorer können Sie Liveanfragen stellen, um sich mit der API und den API-Optionen vertraut zu machen:
Prognoseanfragen
Sie können stündliche Informationen zur Luftqualitätsprognose über den Prognoseendpunkt anfordern, indem Sie eine HTTP-POST-Anfrage an folgende Adresse senden:
https://airquality.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY
Fügen Sie Ihre Parameter in den Anfragetext ein. Der Anfragetext enthält den Standort, für den Sie stündliche Vorhersageinformationen zur Luftqualität abrufen möchten, sowie verschiedene Optionen, mit denen Sie festlegen können, welche zusätzlichen Informationen in der Antwort enthalten sein sollen.
Prognoseantworten
Der Antworttext enthält das UTC-Datum und die UTC-Uhrzeit, für die Informationen zur Luftqualitätsprognose, Luftqualitätsindizes und zusätzliche benutzerdefinierte Informationen angezeigt werden sollen. 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 (ab der nächsten Stunde bis zu 96 Stunden) an, für die stündliche Informationen zur Luftqualitätsprognose 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 Parametern erstellt wird. 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, Konzentration des dominanten Schadstoffs 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==" }
Wenn Sie die nächste Seite mit Prognoseinformationen aufrufen möchten, übergeben Sie das nextPageToken, das am Ende des Antworttexts zurückgegeben wird:
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" }
Testen!
Mit dem APIs Explorer können Sie Beispielanfragen erstellen, um sich mit der API und den API-Optionen vertraut zu machen.
Wählen Sie rechts auf der Seite das API-Symbol api aus.
Bearbeiten Sie optional die Anfrageparameter.
Wählen Sie den Button Ausführen aus. Wählen Sie im Dialogfeld das Konto aus, das Sie für die Anfrage verwenden möchten.
Wählen Sie im APIs Explorer-Bereich das Vollbildsymbol fullscreen aus, um das APIs Explorer-Fenster zu maximieren.