Punkt końcowy history zawiera historyczne informacje o jakości powietrza w danej lokalizacji (do 30 dni) w wybranym przedziale czasu. Możesz kontrolować, które AQI i istotne informacje, takie jak stężenie zanieczyszczeń i zalecenia zdrowotne, są zwracane.
Możesz poprosić o historię godzinowej jakości powietrza, korzystając z punktu końcowego history, wysyłając żądanie HTTP POST na adres:
https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY
Uwzględnij opcje żądania w treści żądania JSON. Treść żądania zawiera lokalizację i zakres czasu, dla którego chcesz uzyskać godzinową historię jakości powietrza. Może też obejmować różne opcje kontroli jakości powietrza podawane w odpowiedzi.
Przykład żądania jednogodzinnego
Treść żądania na godzinę
Poniższy kod pokazuje, jak przy użyciu metody history utworzyć treść żądania dla żądania dotyczącego historii z jednej godziny.
W tym przykładzie ustawiasz lokalizację i wcześniejszą sygnaturę czasową.
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'
Odpowiedź w ciągu 1 godziny
Wywołanie powyżej generuje następującą odpowiedź JSON. Więcej informacji o danych odpowiedzi znajdziesz w artykule Dane odpowiedzi.
{
"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"
}
Przykład żądania dotyczącego zakresu czasu
Żądanie dotyczące zakresu czasu
Poniższy kod pokazuje, jak utworzyć treść żądania dla history, która zwraca wiele zapisów historycznych danych o jakości powietrza w poszczególnych godzinach.
Możesz prosić o wiele rekordów, określając zakres czasowy, czyli sygnaturę czasową rozpoczęcia i zakończenia, lub liczbę godzin wstecz od bieżącej godziny.
Ponieważ w poniższym przykładzie rozmiar strony to 2, żądanie danych z 4 godzin historii jakości powietrza jest zwracane na 2 stronach, z których każda zawiera dane z dwóch godzin.
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'
Podobne żądanie możesz przesłać, przesyłając sygnatury czasowe rozpoczęcia i zakończenia:
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'
Odpowiedź dotycząca zakresu czasu
Powyższe wywołania generują odpowiedź JSON w formularzu poniżej. Więcej informacji o danych odpowiedzi znajdziesz w artykule Dane odpowiedzi.
W przypadku obu powyższych połączeń żądane są dane o jakości powietrza z 4 godzin. Ponieważ jednak ustawisz w żądaniu właściwość pageSize na 2, odpowiedź będzie zawierać tylko wyniki z ostatnich 2 godzin.
{
"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"
}
Zwróć uwagę, że odpowiedź zawiera też właściwość nextPageToken. Użyj tej usługi, aby przejść do następnej strony wyników, która zawiera dane z następnych 2 godzin.
Aby uzyskać dostęp do następnej strony wyników, wyślij drugie żądanie do punktu końcowego history, ale tym razem ustaw we właściwości pageToken wartość nextPageToken z pierwszej odpowiedzi.
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'