Method: currentConditions.lookup

Điểm cuối Điều kiện hiện tại cung cấp thông tin về chất lượng không khí hằng giờ ở hơn 100 quốc gia, với độ phân giải lên tới 500 x 500 mét. Bao gồm hơn 70 chỉ số địa phương, cũng như chỉ số và danh mục chất lượng không khí trên toàn cầu.

Yêu cầu HTTP

POST https://airquality.googleapis.com/v1/currentConditions: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 
{
  "location": {
    object (LatLng)
  },
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "uaqiColorPalette": enum (ColorPalette),
  "customLocalAqis": [
    {
      object (CustomLocalAqi)
    }
  ],
  "universalAqi": boolean,
  "languageCode": string
}
Các trường
location

object (LatLng)

Bắt buộc. Kinh độ và vĩ độ mà qua đó API tìm dữ liệu về điều kiện chất lượng không khí hiện tại.
extraComputations[]

enum (ExtraComputation)

Không bắt buộc. Các tính năng bổ sung có thể bật tuỳ ý. 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 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 do "Chỉ số chất lượng không khí toàn cầu" (UAQI) cung cấp. Bảng màu này chỉ dành cho UAQI, các AQI khác có bảng màu được xác định trước không thể kiểm soát.
customLocalAqis[]

object (CustomLocalAqi)

Không bắt buộc. Thể hiện mối quan hệ "quốc gia/khu vực với AQI". Ghép nối một quốc gia/khu vực với 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ẽ xuất hiện theo AQI đã chọn. Bạn có thể dùng tham số này để chỉ định AQI không mặc định cho một quốc gia cụ thể. Ví dụ: để lấy chỉ số EPA của Hoa Kỳ cho Canada thay vì chỉ số mặc định cho Canada.
universalAqi

boolean

Không bắt buộc. Nếu bạn đặt chính sách này thành true (đúng), thì AQI chung sẽ được đưa vào trường "chỉ mục" của 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 phản hồi. Nếu không thể cung cấp dữ liệu cho ngôn ngữ đó thì API sẽ sử dụng kết quả khớp gần nhất. Các giá trị được phép sẽ 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 
{
  "dateTime": string,
  "regionCode": string,
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  }
}
Các trường
dateTime

string (Timestamp format)

Dấu thời gian được làm tròn xuống theo định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:00:00Z".
regionCode

string

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 trong lãnh thổ tranh chấp.
indexes[]

object (AirQualityIndex)

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

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

object (Pollutant)

Danh sách các chất gây ô nhiễm ảnh hưởng đến vị trí đã chỉ định trong yêu cầu. Lưu ý: Trường này sẽ chỉ được trả về cho các yêu cầu đã chỉ định một hoặc nhiều phép tính bổ sung sau: 🏤UTANT_ADDITIONAL_INFO, DOMINANT_ USDUTANT_CONCENTRATION, {/5}UTANT_CONCENTRATION.
healthRecommendations

object (HealthRecommendations)

Lời khuyên về sức khoẻ và các 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ơ, những nhóm dễ nhạy cảm hơn với các chất gây ô nhiễm và dân số nói chung.

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 Tổng quan về OAuth 2.0.