Package google.maps.airquality.v1

Chỉ mục

AirQuality

Dịch vụ chất lượng không khí.

LookupCurrentConditions

rpc LookupCurrentConditions(LookupCurrentConditionsRequest) returns (LookupCurrentConditionsResponse)

Đ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 đến 500 x 500 mét. Bao gồm hơn 70 chỉ số địa phương, chỉ số chất lượng không khí toàn cầu và các danh mục.

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.
LookupForecast

rpc LookupForecast(LookupForecastRequest) returns (LookupForecastResponse)

Trả về thông tin dự báo chất lượng không khí cho một vị trí cụ thể trong một khoảng thời gian nhất định.

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.
LookupHeatmapTile

rpc LookupHeatmapTile(LookupHeatmapTileRequest) returns (HttpBody)

Trả về một mảng byte chứa dữ liệu của hình ảnh PNG thẻ thông tin.

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.
LookupHistory

rpc LookupHistory(LookupHistoryRequest) returns (LookupHistoryResponse)

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.

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.

AirQualityIndex

Đối tượng cơ bản để biểu thị các chỉ số chất lượng không khí khác nhau. Khi được kết hợp với nhau, các chỉ số này cung cấp thông tin tổng quan nhanh về tình trạng chất lượng không khí hiện tại. Có nhiều chỉ số trên thế giới phục vụ cho nhiều mục đích và nhóm người quan tâm đến việc đo lường các khía cạnh khác nhau của chất lượng không khí.

Trường
code

string

Mã của chỉ mục. Trường này đại diện cho chỉ mục cho mục đích lập trình bằng cách sử dụng kiểu viết thường thay vì dấu cách. Ví dụ: "uaqi", "fra_atmo".
display_name

string

Biểu thị tên chỉ mục mà con người đọc được. Ví dụ: "AQI (Hoa Kỳ)"
aqi_display

string

Biểu thị bằng văn bản điểm số dạng số của chỉ mục, có thể bao gồm các ký hiệu tiền tố hoặc hậu tố, thường biểu thị điểm số chỉ mục thấp nhất. Ví dụ: >100 hoặc 10+.

Lưu ý: Bạn nên sử dụng trường này khi muốn hiển thị điểm chỉ mục. Đối với các chỉ mục không phải số, trường này sẽ để trống.
color

Color

Màu sắc dùng để thể hiện điểm số AQI dạng số.
category

string

Phân loại văn bản của nội dung giải thích điểm số dạng số của chỉ mục. Ví dụ: "Chất lượng không khí rất tốt".
dominant_pollutant

string

Biểu tượng hoá học của chất gây ô nhiễm chính. Ví dụ: "CO".
aqi

int32

Điểm số dạng số của chỉ mục. Ví dụ: 10, 100.

Giá trị này không được chuẩn hoá và chỉ nên được diễn giải trong bối cảnh chỉ số chất lượng không khí có liên quan. Đối với các chỉ mục không phải số, trường này sẽ không được trả về.

Lưu ý: Bạn nên sử dụng trường này để tính toán, hiển thị biểu đồ, v.v. Để hiển thị điểm chỉ số, bạn nên sử dụng trường hiển thị AQI.

ColorPalette

Xác định bảng màu dùng cho dữ liệu do "Chỉ số chất lượng không khí chung" (UAQI) cung cấp. Bảng màu này chỉ phù hợp với UAQI, các AQI khác có bảng màu được xác định trước và không thể kiểm soát được.

Enum
COLOR_PALETTE_UNSPECIFIED Giá trị mặc định. Bỏ qua nếu được truyền dưới dạng tham số.
RED_GREEN Xác định xem có sử dụng bảng màu đỏ/xanh lục hay không.
INDIGO_PERSIAN_DARK Xác định việc có sử dụng bảng màu indigo/persian (giao diện tối) hay không.
INDIGO_PERSIAN_LIGHT Xác định việc có sử dụng bảng màu indigo/persian (giao diện sáng) hay không.

CustomLocalAqi

Biểu thị 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 một 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.

Trường
region_code

string

Quốc gia/khu vực yêu cầu AQI tuỳ chỉnh. Bạn phải cung cấp giá trị bằng mã ISO 3166-1 alpha-2.
aqi

string

Chỉ số chất lượng không khí (AQI) để liên kết với quốc gia/khu vực. Giá trị phải là mã chỉ mục hợp lệ.

ExtraComputation

Các tính năng bổ sung mà bạn có thể bật tuỳ ý. Việc chỉ định các phép tính bổ sung sẽ dẫn đến việc các phần tử và trường có liên quan được trả về trong phản hồi.

Enum
EXTRA_COMPUTATION_UNSPECIFIED Giá trị mặc định. Máy chủ sẽ bỏ qua giá trị này nếu giá trị được truyền dưới dạng tham số.
LOCAL_AQI

Xác định xem có đưa AQI (cấp quốc gia) tại địa phương của vị trí (quốc gia) được yêu cầu vào nội dung phản hồi hay không.

Nếu được chỉ định, phản hồi sẽ chứa cấu trúc dữ liệu "air_quality_index" với tất cả dữ liệu liên quan về AQI tại địa phương của vị trí.
HEALTH_RECOMMENDATIONS

Xác định xem nội dung phản hồi có bao gồm lời khuyên về sức khoẻ và các hành động được đề xuất cho tình trạng AQI hiện tại hay không.

Các đề xuất này được điều chỉnh cho phù hợp với dân số nói chung và 6 nhóm dân số có nguy cơ cao, nhạy cảm hơn với các chất gây ô nhiễm so với dân số nói chung.

Nếu được chỉ định, trường health_recommendations sẽ được điền vào phản hồi khi có dữ liệu liên quan.
POLLUTANT_ADDITIONAL_INFO

Xác định xem có đưa thông tin bổ sung về từng chất gây ô nhiễm vào nội dung phản hồi hay không.

Nếu được chỉ định, mỗi đối tượng chỉ số chất lượng không khí có trong phản hồi trường "chỉ số" sẽ bao gồm một trường additional_info khi có dữ liệu.
DOMINANT_POLLUTANT_CONCENTRATION

Xác định xem phản hồi có bao gồm nồng độ của các chất gây ô nhiễm chính được đo theo chỉ số toàn cầu và/hoặc chỉ số cục bộ hay không.

Nếu yêu cầu chỉ định cả AQI toàn cầu và AQI cục bộ, thì có thể có tối đa 2 mã chất gây ô nhiễm được trả về.

Nếu được chỉ định, đối tượng chất gây ô nhiễm chính có trong danh sách "chất gây ô nhiễm" sẽ bao gồm trường concentration khi có dữ liệu.
POLLUTANT_CONCENTRATION

Xác định xem phản hồi có bao gồm nồng độ của tất cả các chất gây ô nhiễm có số liệu đo lường hiện có theo chỉ số toàn cầu và/hoặc cục bộ hay không.

Nếu được chỉ định, mỗi đối tượng chất gây ô nhiễm có trong trường "chất gây ô nhiễm" trong phản hồi sẽ bao gồm một trường concentration khi có dữ liệu.

HealthRecommendations

Đề xuất về sức khoẻ cho các nhóm dân số khác nhau ở định dạng văn bản tự do. Các đề xuất này được lấy từ các điều kiện chất lượng không khí liên quan.

Trường
general_population

string

Không có vấn đề nhạy cảm cụ thể.
elderly

string

Người nghỉ hưu và những người lớn tuổi hơn so với dân số nói chung.
lung_disease_population

string

Các vấn đề liên quan đến đường hô hấp và hen suyễn.
heart_disease_population

string

Bệnh tim và hệ tuần hoàn.
athletes

string

Các hoạt động thể thao và các hoạt động ngoài trời khác đòi hỏi nhiều sức lực.
pregnant_women

string

Phụ nữ ở mọi giai đoạn mang thai.
children

string

Dân số trẻ hơn, bao gồm trẻ em, trẻ mới biết đi và trẻ sơ sinh.

LookupCurrentConditionsRequest

Định nghĩa yêu cầu về tình trạng chất lượng không khí hiện tại.

Trường
location

LatLng

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

ExtraComputation

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

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í chung" (UAQI) cung cấp. Bảng màu này chỉ phù hợp với UAQI, các AQI khác có bảng màu được xác định trước và không thể kiểm soát được.
custom_local_aqis[]

CustomLocalAqi

Không bắt buộc. Biểu thị 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 một 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 chỉ số AQI không phải mặc định cho một quốc gia nhất định, ví dụ: để lấy chỉ số EPA của Hoa Kỳ cho Canada thay vì chỉ số mặc định cho Canada.
universal_aqi

bool

Không bắt buộc. Nếu bạn đặt giá trị này thành true, 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.
language_code

string

Không bắt buộc. Cho phép ứng dụng khách 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ữ đó, API sẽ sử dụng ngôn ngữ 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à en.

LookupCurrentConditionsResponse

Trường
date_time

Timestamp

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

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 nội dung phản hồi nếu vị trí được cung cấp trong yêu cầu nằm trong một lãnh thổ đang có tranh chấp.
indexes[]

AirQualityIndex

Dựa trên các tham số 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 chung. Sẽ được trả về nếu giá trị 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 bạn chỉ định tính toán bổ sung LOCAL_AQI.
pollutants[]

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 các yêu cầu chỉ định một hoặc nhiều phép tính bổ sung sau: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION.
health_recommendations

HealthRecommendations

Thông tin tư vấn về sức khoẻ và các biện pháp đề xuất liên quan đến điều kiện chất lượng không khí được báo cáo. Đề xuất được điều chỉnh theo từng nhóm đối tượng, bao gồm cả những người có nguy cơ cao, những người nhạy cảm hơn với chất gây ô nhiễm và dân số nói chung.

LookupForecastRequest

Đối tượng yêu cầu của API dự đoán chất lượng không khí.

Trường
location

LatLng

Bắt buộc. Vĩ độ và kinh độ mà API tìm kiếm dữ liệu chất lượng không khí.
extra_computations[]

ExtraComputation

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

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í chung" (UAQI) cung cấp. Bảng màu này chỉ phù hợp với UAQI, các AQI khác có bảng màu được xác định trước và không thể kiểm soát được.
custom_local_aqis[]

CustomLocalAqi

Không bắt buộc. Biểu thị 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 một 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 chỉ số AQI không phải mặc định cho một quốc gia nhất định, ví dụ: để lấy chỉ số EPA của Hoa Kỳ cho Canada thay vì chỉ số mặc định cho Canada.
page_size

int32

Không bắt buộc. Số lượng bản ghi thông tin hằng giờ tối đa được trả về trên mỗi trang (mặc định = 24).
page_token

string

Không bắt buộc. Mã thông báo trang nhận được từ một lệnh gọi dự đoán trước đó. Phương thức này dùng để truy xuất trang tiếp theo.
Trường hợp hợp nhất time_range. Phạm vi thời gian của dữ liệu dự báo chất lượng không khí bắt buộc. Khoảng thời gian này phải cách thời điểm hiện tại ít nhất một giờ được làm tròn. Nếu không chỉ định trường này, bạn sẽ gặp lỗi INVALID_ARGUMENT. time_range chỉ có thể là một trong những giá trị sau:
date_time

Timestamp

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

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

Interval

Cho biết khoảng thời gian bắt đầu và kết thúc để nhận dữ liệu dự báo. Dấu thời gian được làm tròn đến giờ chính xác trước đó.
universal_aqi

bool

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

string

Không bắt buộc. Cho phép ứng dụng khách 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ữ đó, API sẽ sử dụng ngôn ngữ phù hợp nhất. Các giá trị được phép dựa trên tiêu chuẩn IETF (mặc định = 'en').

LookupForecastResponse

Đối tượng phản hồi của API dự đoán chất lượng không khí.

Trường
hourly_forecasts[]

HourlyForecast

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

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 nội dung phản hồi nếu vị trí được cung cấp trong yêu cầu nằm trong một lãnh thổ đang có tranh chấp.
next_page_token

string

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

HourlyForecast

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

Trường
date_time

Timestamp

Dấu thời gian làm tròn xuống cho biết thời gian (giờ) mà dữ liệu tham chiếu đến ở định dạng "Zulu" RFC3339 UTC. Ví dụ: "2014-10-02T15:00:00Z".
indexes[]

AirQualityIndex

Dựa trên các tham số 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 chung. Sẽ được trả về nếu giá trị boolean universal_aqi đượ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 bạn chỉ định tính toán bổ sung LOCAL_AQI.
pollutants[]

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 các yêu cầu chỉ định một hoặc nhiều phép tính bổ sung sau: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION.
health_recommendations

HealthRecommendations

Thông tin tư vấn về sức khoẻ và các biện pháp đề xuất liên quan đến điều kiện chất lượng không khí được báo cáo. Đề xuất được điều chỉnh theo từng nhóm đối tượng, bao gồm cả những người có nguy cơ cao, những người nhạy cảm hơn với chất gây ô nhiễm và dân số nói chung.

LookupHeatmapTileRequest

Yêu cầu thẻ thông tin bản đồ nhiệt.

Cấu trúc này tuân thủ lệnh gọi GET của máy chủ thẻ thông tin chuẩn, tức là https://airquality.googleapis.com/v1/mapTypes/{map_type}/heatmapTiles/{zoom}/{x}/{y}

Ví dụ: https://airquality.googleapis.com/v1/mapTypes/BAQI_INDIGO_PERSIAN/heatmapTiles/1/1/1

Trường
map_type

MapType

Bắt buộc. Loại bản đồ nhiệt về chất lượng không khí. Xác định chất gây ô nhiễm mà bản đồ sẽ thể hiện bằng hình ảnh.

Allowed values:
- UAQI_RED_GREEN (UAQI, red-green palette)
- UAQI_INDIGO_PERSIAN (UAQI, indigo-persian palette)
- PM25_INDIGO_PERSIAN
- GBR_DEFRA
- DEU_UBA
- CAN_EC
- FRA_ATMO
- US_AQI
zoom

int32

Bắt buộc. Mức thu phóng của bản đồ. Xác định kích thước lớn hay nhỏ của nội dung trên bản đồ trong chế độ xem bản đồ.

Mức thu phóng 0 là toàn bộ thế giới trong một ô. Cấp độ thu phóng 1 là toàn bộ thế giới trong 4 ô. Cấp độ thu phóng 2 là toàn bộ thế giới trong 16 ô. Cấp độ thu phóng 16 là toàn bộ thế giới trong 65.536 ô.

Giá trị được phép: 0-16
x

int32

Bắt buộc. Xác định điểm đông-tây trong thẻ thông tin được yêu cầu.
y

int32

Bắt buộc. Xác định điểm bắc-nam trong thẻ thông tin được yêu cầu.

LookupHistoryRequest

Đối tượng yêu cầu của API nhật ký chất lượng không khí.

Trường
page_size

int32

Không bắt buộc. Số lượng bản ghi thông tin hằng giờ tối đa cần 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).
page_token

string

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

Xin lưu ý rằng khi cung cấp giá trị cho tham số này, tất 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

LatLng

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

ExtraComputation

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

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í chung" (UAQI) cung cấp. Bảng màu này chỉ phù hợp với UAQI, các AQI khác có bảng màu được xác định trước và không thể kiểm soát được.
custom_local_aqis[]

CustomLocalAqi

Không bắt buộc. Biểu thị 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 một 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 chỉ số AQI không phải mặc định cho một quốc gia nhất định, ví dụ: để lấy chỉ số EPA của Hoa Kỳ cho Canada thay vì chỉ số mặc định cho Canada.
Trường hợp hợp nhất time_range. Phạm vi thời gian của dữ liệu chất lượng không khí bắt buộc. Nếu bạn không chỉ định bất kỳ trường nào liên quan đến phạm vi thời gian, thì sẽ xảy ra lỗi INVALID_ARGUMENT. time_range chỉ có thể là một trong những trường sau: time_range chỉ có thể là một trong những trường sau:
date_time

Timestamp

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 ý: phương thức này sẽ chỉ trả về dữ liệu hằng giờ cho dấu thời gian được yêu cầu (tức là một phần tử thông tin hằng giờ). Ví dụ: một 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 thành 2023-01-03T11:00:00Z.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
hours

int32

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

Interval

Cho biết khoảng thời gian bắt đầu và kết thúc để lấy dữ liệu trong quá khứ. Dấu thời gian được làm tròn đến giờ chính xác trước đó.
universal_aqi

bool

Không bắt buộc. Nếu bạn đặt giá trị này thành true, 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.
language_code

string

Không bắt buộc. Cho phép ứng dụng khách 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ữ đó, API sẽ sử dụng ngôn ngữ 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à en.

LookupHistoryResponse

Trường
hours_info[]

HourInfo

Không bắt buộc. Chứa thông tin về chất lượng không khí cho mỗi giờ trong phạm vi được yêu cầu. Ví dụ: nếu yêu cầu là nhật ký trong 48 giờ, thì sẽ có 48 phần tử thông tin theo giờ.
region_code

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 nội dung phản hồi nếu vị trí được cung cấp trong yêu cầu nằm trong một lãnh thổ đang có tranh chấp.
next_page_token

string

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

HourInfo

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

Trường
date_time

Timestamp

Dấu thời gian làm tròn xuống cho biết thời gian dữ liệu tham chiếu đến ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:00:00Z".
indexes[]

AirQualityIndex

Dựa trên các tham số 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 chung. Sẽ được trả về nếu giá trị 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 bạn chỉ định tính toán bổ sung LOCAL_AQI.
pollutants[]

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 các yêu cầu chỉ định một hoặc nhiều phép tính bổ sung sau: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION.
health_recommendations

HealthRecommendations

Thông tin tư vấn về sức khoẻ và các biện pháp đề xuất liên quan đến điều kiện chất lượng không khí được báo cáo. Đề xuất được điều chỉnh cho phù hợp với những người có nguy cơ, những nhóm nhạy cảm hơn với chất gây ô nhiễm và dân số nói chung.

MapType

Loại bản đồ nhiệt về chất lượng không khí. Xác định chất gây ô nhiễm mà bản đồ sẽ thể hiện bằng hình ảnh.

Enum
MAP_TYPE_UNSPECIFIED Giá trị mặc định. Máy chủ sẽ bỏ qua giá trị này nếu giá trị được truyền dưới dạng tham số.
UAQI_RED_GREEN Bảng màu đỏ-xanh lục của Chỉ số chất lượng không khí chung.
UAQI_INDIGO_PERSIAN Bảng màu indigo-persian của Chỉ số chất lượng không khí chung.
PM25_INDIGO_PERSIAN Bảng màu indigo-persian của chỉ số PM2.5.
GBR_DEFRA Bảng màu của Chỉ số chất lượng không khí hằng ngày (Vương quốc Anh).
DEU_UBA Bảng màu của Chỉ số chất lượng không khí tại địa phương của Đức.
CAN_EC Bảng màu của Chỉ số sức khoẻ theo chất lượng không khí của Canada.
FRA_ATMO Bảng màu của Chỉ số chất lượng không khí của Pháp.
US_AQI Bảng màu của Chỉ số chất lượng không khí của Hoa Kỳ.

Chất gây ô nhiễm

Dữ liệu về chất gây ô nhiễm chất lượng không khí.

Trường
code

string

Tên mã của chất gây ô nhiễm (ví dụ: "so2"). Để biết danh sách mã chất gây ô nhiễm được hỗ trợ, hãy xem phần Chất gây ô nhiễm được báo cáo.
display_name

string

Tên hiển thị của chất gây ô nhiễm. Ví dụ: "NOx".
full_name

string

Tên đầy đủ của chất gây ô nhiễm. Đối với các hợp chất hóa học, đây là tên theo IUPAC. Ví dụ: "Sulfur Dioxide".

Để biết thêm thông tin về bảng tên theo IUPAC, hãy xem https://iupac.org/what-we-do/periodic-table-of-elements/.
concentration

Concentration

Mức độ nồng độ của chất gây ô nhiễm được đo bằng một trong các đơn vị đo lường ô nhiễm không khí tiêu chuẩn.
additional_info

AdditionalInfo

Thông tin bổ sung về chất gây ô nhiễm.

AdditionalInfo

Nguồn phát thải và tác động đến sức khoẻ của một chất gây ô nhiễm nhất định.

Trường
sources

string

Văn bản thể hiện các nguồn phát thải chính của chất gây ô nhiễm.
effects

string

Văn bản thể hiện các tác động chính của chất gây ô nhiễm đối với sức khoẻ.

Nồng độ

Nồng độ của một chất gây ô nhiễm nhất định trong không khí.

Trường
units

Unit

Đơn vị đo lường nồng độ chất gây ô nhiễm này.
value

float

Giá trị của nồng độ chất gây ô nhiễm.

Đơn vị

Xác định đơn vị dùng để đo nồng độ của chất gây ô nhiễm. Để xác định đơn vị nồng độ mặc định cho một chất gây ô nhiễm nhất định, hãy tham khảo bảng trong phần Chất gây ô nhiễm được báo cáo.

Enum
UNIT_UNSPECIFIED Đơn vị nồng độ không được chỉ định.
PARTS_PER_BILLION Đơn vị nồng độ ppb (phần tỷ).
MICROGRAMS_PER_CUBIC_METER Đơn vị nồng độ "µg/m^3" (microgram trên mét khối).