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'