Method: history.lookup

Trả về nhật ký chất lượng không khí của một vị trí cụ thể trong một khoảng thời gian nhất định.

Yêu cầu HTTP

POST https://airquality.googleapis.com/v1/history:lookup

URL sử dụng cú pháp Chuyển mã gRPC.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "pageSize": integer,
  "pageToken": string,
  "location": {
    object (LatLng)
  },
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "uaqiColorPalette": enum (ColorPalette),
  "customLocalAqis": [
    {
      object (CustomLocalAqi)
    }
  ],
  "dateTime": string,
  "hours": integer,
  "period": {
    object (Interval)
  }
  // End of list of possible types for union field time_range.
  "universalAqi": boolean,
  "languageCode": string
}
Trường
pageSize

integer

Không bắt buộc. Số lượng bản ghi thông tin hằng giờ tối đa có thể trả về trên mỗi trang. Giá trị mặc định là 72 và giá trị tối đa là 168 (dữ liệu trong 7 ngày).

pageToken

string

Không bắt buộc. Mã thông báo trang đã nhận được từ một lệnh gọi nhật ký trước đó. Hàm này được dùng để truy xuất trang tiếp theo.

Xin lưu ý rằng khi cung cấp giá trị cho thông số này, tất cả các tham số khác được cung cấp phải khớp với lệnh gọi đã cung cấp mã thông báo trang (lệnh gọi trước đó).

location

object (LatLng)

Bắt buộc. Vĩ độ và kinh độ mà API tìm dữ liệu nhật ký chất lượng không khí.

extraComputations[]

enum (ExtraComputation)

Không bắt buộc. Các tính năng bổ sung có thể bật nếu muốn. Việc chỉ định các phép tính bổ sung sẽ dẫn đến việc trả về các phần tử và trường có liên quan trong phản hồi.

uaqiColorPalette

enum (ColorPalette)

Không bắt buộc. Xác định bảng màu dùng cho dữ liệu được cung cấp theo "Chỉ số chất lượng không khí toàn cầu" (UAQI). Bảng màu này chỉ liên quan đến UAQI, các chỉ số AQI khác có bảng màu định sẵn và không thể kiểm soát được.

customLocalAqis[]

object (CustomLocalAqi)

Không bắt buộc. Thể hiện "quốc gia/khu vực theo chỉ số AQI" mối quan hệ. Ghép nối một quốc gia/khu vực với một chỉ số AQI mong muốn để dữ liệu chất lượng không khí cần thiết cho quốc gia/khu vực đó sẽ hiển thị theo AQI đã chọn. Bạn có thể dùng tham số này để chỉ định một chỉ số AQI không mặc định cho một quốc gia cụ thể, chẳng hạn như để lấy chỉ số EPA của Hoa Kỳ cho Canada thay vì chỉ số mặc định cho Canada.

dateTime

string (Timestamp format)

Dấu thời gian để trả về dữ liệu trong quá khứ. Dấu thời gian được làm tròn đến giờ chính xác trước đó.

Lưu ý: hàm này sẽ chỉ trả về dữ liệu hằng giờ cho dấu thời gian được yêu cầu (ví dụ: một phần tử thông tin hằng giờ). Ví dụ: yêu cầu được gửi khi tham số dateTime được đặt thành 2023-01-03T11:05:49Z sẽ được làm tròn xuống 2023-01-03T11:00:00Z.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

Lưu ý: Bạn có thể dùng dateTime hoặc startTimeendTime trong yêu cầu.

hours

integer

Số từ 1 đến 720 cho biết phạm vi giờ cho yêu cầu. Ví dụ: Giá trị 48 sẽ cho kết quả dữ liệu trong 48 giờ qua.

period

object (Interval)

Cho biết khoảng thời gian startTimeendTime mà bạn muốn nhận dữ liệu trong quá khứ. Dấu thời gian được làm tròn đến giờ chính xác trước đó.

Lưu ý: Bạn có thể dùng dateTime hoặc startTimeendTime trong yêu cầu.

universalAqi

boolean

Không bắt buộc. Nếu bạn đặt chính sách này thành true, thì chỉ số AQI chung sẽ được đưa vào các "chỉ mục" của trường phản hồi. Giá trị mặc định là true.

languageCode

string

Không bắt buộc. Cho phép khách hàng chọn ngôn ngữ cho câu trả lời. Nếu không thể cung cấp dữ liệu cho ngôn ngữ đó, API sẽ sử dụng kết quả phù hợp nhất. Các giá trị được phép dựa trên tiêu chuẩn IETF. Giá trị mặc định là vi.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "hoursInfo": [
    {
      object (HourInfo)
    }
  ],
  "regionCode": string,
  "nextPageToken": string
}
Trường
hoursInfo[]

object (HourInfo)

Không bắt buộc. Chứa thông tin về chất lượng không khí của từng giờ trong phạm vi được yêu cầu. Ví dụ: nếu yêu cầu là về nội dung lịch sử trong 48 giờ, thì sẽ có 48 phần tử của thông tin hằng giờ.

regionCode

string

Không bắt buộc. Mã ISO_3166-1 alpha-2 của quốc gia/khu vực tương ứng với vị trí được cung cấp trong yêu cầu. Trường này có thể bị bỏ qua trong phản hồi nếu vị trí được cung cấp trong yêu cầu nằm ở lãnh thổ tranh chấp.

nextPageToken

string

Không bắt buộc. Mã thông báo để truy xuất trang tiếp theo.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.

HourInfo

Chứa thông tin về chất lượng không khí cho từng giờ trong phạm vi yêu cầu. Ví dụ: nếu yêu cầu là về nội dung lịch sử trong 48 giờ, thì sẽ có 48 phần tử của thông tin hằng giờ.

Biểu diễn dưới dạng JSON
{
  "dateTime": string,
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  }
}
Trường
dateTime

string (Timestamp format)

Dấu thời gian được làm tròn xuống cho biết thời điểm mà dữ liệu tham chiếu trong RFC3339 giờ UTC "Zulu" với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:00:00Z".

indexes[]

object (AirQualityIndex)

Dựa trên các thông số theo yêu cầu, danh sách này sẽ bao gồm (tối đa) 2 chỉ số chất lượng không khí:

  • Chỉ số AQI toàn cầu. Sẽ được trả về nếu boolean UniversalAqi được đặt thành true.
  • Chỉ số chất lượng không khí (AQI) tại địa phương. Sẽ được trả về nếu phép tính bổ sung LOCAL_AQI được chỉ định.
pollutants[]

object (Pollutant)

Danh sách các chất gây ô nhiễm ảnh hưởng đến vị trí được chỉ định trong yêu cầu. Lưu ý: Trường này sẽ chỉ được trả về cho những yêu cầu đã chỉ định một hoặc nhiều phép tính bổ sung sau: NUMUTANT_ADDITIONAL_INFO, DOMINANT_VOTEUTANT_CONCENTRATION, PACKAGESUTANT_CONCENTRATION.

healthRecommendations

object (HealthRecommendations)

Thông tin tư vấn về sức khoẻ và hành động được đề xuất liên quan đến tình trạng chất lượng không khí được báo cáo. Các đề xuất được điều chỉnh theo cách khác nhau cho những nhóm dân số có nguy cơ cao, những nhóm nhạy cảm hơn với các chất gây ô nhiễm và dân số nói chung.