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'