Punkt końcowy history udostępnia historyczne godzinowe informacje o jakości powietrza w określonej lokalizacji w wybranym przedziale czasu (maksymalnie 30 dni). Możesz określić, które wskaźniki AQI i odpowiednie informacje (np. o poziomie stężenia zanieczyszczeń i zaleceniach dotyczących zdrowia) mają być zwracane.
Możesz poprosić o historię godzinowej jakości powietrza za pomocą punktu końcowego history, wysyłając żądanie HTTP POST do:
https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY
Umieść opcje żądania w treści żądania JSON. Treść żądania zawiera lokalizację i zakres czasu, dla których chcesz uzyskać godzinową historię jakości powietrza. Mogą też obejmować różne opcje kontrolowania, jakie informacje o jakości powietrza mają być uwzględniane w odpowiedzi.
Przykład żądania na jedną godzinę
Treść żądania za 1 godzinę
Ten kod pokazuje, jak za pomocą metody history utworzyć treść żądania dotyczącego pojedynczej godziny w historii.
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 godziny
Powyższe wywołanie generuje następującą odpowiedź JSON. Więcej informacji o danych odpowiedzi znajdziesz w sekcji 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
Prośba dotycząca zakresu czasu
Ten kod pokazuje, jak utworzyć treść żądania dla obiektu history, która zwraca wiele zapisów historycznej godzinowej jakości powietrza.
Możesz zażądać wielu rekordów, określając zakres czasu, czyli sygnaturę czasową rozpoczęcia i zakończenia, lub określając liczbę godzin wstecz, które nastąpiły przed aktualnym czasem.
W poniższym przykładzie, ponieważ rozmiar strony ma wartość 2, żądanie historii jakości powietrza z 4 godzin jest zwracane na 2 stronach, z których każda zawiera dane z 2 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'
Możesz wysłać podobne żądanie, przekazują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ź z zakresu czasu
Powyższe wywołania generują odpowiedź JSON w formularzu poniżej. Więcej informacji o danych odpowiedzi znajdziesz w sekcji Dane odpowiedzi.
Oba powyższe rozmowy wymagają danych o jakości powietrza z czterech godzin. Ponieważ jednak w żądaniu ustawisz wartość 2 we właściwości pageSize, odpowiedź 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. Za pomocą tej właściwości możesz przejść do następnej strony wyników, która zawiera dane z kolejnych dwóch 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'