Historia

Punkt końcowy history zapewnia historyczne godzinowe informacje o jakości powietrza w konkretnej lokalizacji w określonym maksymalnie 30 dni. Możesz określić, które wskaźniki AQI istotne informacje (takie jak poziom stężenia zanieczyszczeń zalecenia zdrowotne).

Możesz poprosić o historię godzinowej jakości powietrza w history przez wysłanie żądania HTTP POST do:

https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY

Uwzględnij opcje żądania w pliku JSON treści żądania. treść żądania; zawiera lokalizację i zakres czasu, dla których chcesz uzyskać godzinową historię jakości powietrza. Może też obejmować różne opcje jakie informacje o jakości powietrza należy zawrzeć w odpowiedzi.

Eksplorator interfejsów API umożliwia wysyłanie żądań na żywo, dzięki czemu zapoznasz się interfejs API i opcje interfejsu API:

Wypróbuj

Przykład żądania na jedną godzinę

Treść żądania za 1 godzinę

Poniższy kod pokazuje, jak utworzyć treść żądania na godzinę żądanie historii za pomocą history. 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

To wywołanie generuje następujące 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

Poniższy kod pokazuje, jak utworzyć treść żądania dla zapytania history, które zwraca wiele rekordów historycznej jakości powietrza w godzinnych odstępach.

Możesz zażądać wielu rekordów, określając zakres czasu, tzn. początek i sygnatury czasowej zakończenia lub przez podanie liczby godzin wstecz obecnie się znajdujesz.

W poniższym przykładzie ustawienie rozmiaru strony na 2 powoduje, że żądanie historia jakości powietrza z czterech godzin jest wyświetlana 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'

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

Te 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. Ustawienie właściwość pageSize do 2 w żądaniu, odpowiedź zawiera tylko wyniki z ostatnich dwóch 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 właściwości dostępu do następnej strony wyników, która zawiera dwie następne godzin danych.

Aby uzyskać dostęp do następnej strony wyników, wyślij drugą prośbę do history, ale tym razem ustaw właściwość pageToken na 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'