Trang này được dịch bởi Cloud Translation API.

Lịch sử

Điểm cuối history cung cấp thông tin trước đây về chất lượng không khí theo giờ của một địa điểm cụ thể phạm vi thời gian, tối đa là 30 ngày. Bạn có thể kiểm soát các chỉ số AQI và thông tin liên quan sẽ được trả về (chẳng hạn như nồng độ các chất gây ô nhiễm và sức khoẻ).

Bạn có thể yêu cầu xem nhật ký chất lượng không khí theo giờ bằng cách sử dụng history bằng cách gửi yêu cầu POST qua HTTP tới:

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

Đưa các lựa chọn về yêu cầu của bạn vào trong tệp JSON nội dung yêu cầu. Nội dung yêu cầu chứa vị trí và khoảng thời gian mà bạn muốn nhận nhật ký chất lượng không khí theo giờ. Trang này cũng có thể bao gồm nhiều tuỳ chọn kiểm soát cần cung cấp thông tin nào về chất lượng không khí trong câu trả lời.

APIs Explorer cho phép bạn thực hiện các yêu cầu trực tiếp để bạn có thể làm quen với API và các tuỳ chọn API:

Hãy làm thử!

Ví dụ về yêu cầu một giờ

Nội dung yêu cầu một giờ

Đoạn mã sau đây cho biết cách tạo nội dung yêu cầu trong một giờ yêu cầu nhật ký đang sử dụng Phương thức history. Trong ví dụ này, bạn đặt vị trí và dấu thời gian trong quá khứ.

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'

Phản hồi trong 1 giờ

Lệnh gọi trên tạo ra những dữ liệu sau Phản hồi JSON. Để biết thêm thông tin chi tiết về dữ liệu phản hồi, hãy xem phần Dữ liệu phản hồi.

{
    "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"
}

Ví dụ về yêu cầu phạm vi thời gian

Yêu cầu về phạm vi thời gian

Đoạn mã sau đây biểu thị cách tạo nội dung yêu cầu cho một history trả về nhiều hồ sơ về chất lượng không khí theo giờ trước đây.

Bạn có thể yêu cầu nhiều bản ghi bằng cách chỉ định một khoảng thời gian, tức là bắt đầu và dấu thời gian kết thúc hoặc bằng cách chỉ định số giờ tính từ thời điểm hiện tại bất cứ lúc nào.

Trong ví dụ bên dưới, vì bạn đã đặt kích thước trang thành 2, nên yêu cầu của bạn đối với nhật ký chất lượng không khí trong 4 giờ được trả về trong 2 trang, trong đó mỗi trang chứa 2 giờ dữ liệu.

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'

Bạn có thể thực hiện một yêu cầu tương tự bằng cách truyền dấu thời gian bắt đầu và kết thúc:

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'

Phản hồi trong phạm vi thời gian

Các lệnh gọi trên tạo ra một Phản hồi JSON trong biểu mẫu bên dưới. Để biết thêm thông tin chi tiết về dữ liệu phản hồi, hãy xem Dữ liệu phản hồi.

Cả hai cuộc gọi trên đều yêu cầu dữ liệu chất lượng không khí trong 4 giờ. Tuy nhiên, vì bạn đặt thuộc tính pageSize với 2 trong yêu cầu, thì phản hồi chỉ bao gồm kết quả trong hai giờ gần đây nhất.

{
    "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"
}

Xin lưu ý rằng phản hồi cũng bao gồm thuộc tính nextPageToken. Sử dụng bản thảo này để truy cập trang tiếp theo của kết quả, chứa hai thông tin tiếp theo giờ dữ liệu.

Để truy cập trang kết quả tiếp theo, hãy gửi yêu cầu thứ hai tới điểm cuối history, nhưng lần này hãy đặt thuộc tính pageToken thành giá trị của nextPageToken trong phản hồi đầu tiên.

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'