Package google.maps.airquality.v1

Chỉ mục

AirQuality

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

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

rpc LookupForecast(LookupForecastRequest) returns (LookupForecastResponse)

Trả về thông tin dự báo chất lượng không khí ở 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 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 ảnh PNG của 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 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 Tổng quan về OAuth 2.0.

AirQualityIndex

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

Trường
code

string

Mã của chỉ mục. Trường này biểu thị chỉ mục cho mục đích lập trình bằng cách sử dụng kiểu viết hoa dạng rắn 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ó thể đọc được. Ví dụ: "AQI (Hoa Kỳ)"
aqi_display

string

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

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

Color

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

string

Phân loại văn bản của cách diễn giải điểm số của chỉ mục. Ví dụ: "Chất lượng không khí tuyệt vời".
dominant_pollutant

string

Ký hiệu hoá học của chất gây ô nhiễm chủ yếu. Ví dụ: "CO".
aqi

int32

Điểm 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 theo ngữ cảnh của chỉ số chất lượng không khí có liên quan. Đối với chỉ mục không phải dạng số, trường này sẽ không được trả về.

Lưu ý: Trường này nên được sử dụng để tính toán, hiển thị biểu đồ, v.v. Để hiển thị điểm chỉ mục, 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í toàn cầu" (UAQI) cung cấp. Bảng màu này chỉ phù hợp với UAQI, các chỉ số chất lượng không khí (AQI) khác có bảng màu định sẵn không thể kiểm soát.

Enum
COLOR_PALETTE_UNSPECIFIED Giá trị mặc định. Sẽ bỏ qua nếu được chuyể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 xem có sử dụng bảng màu chàm/Ba Tư hay không (giao diện tối).
INDIGO_PERSIAN_LIGHT Xác định xem có sử dụng bảng màu chàm/Ba Tư hay không (giao diện sáng).

CustomLocalAqi

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 có chỉ số chất lượng không khí (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 chỉ số chất lượng không khí (AQI) đã chọn.

Trường
region_code

string

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

string

AQI (Chỉ số chất lượng không khí) 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 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 liên quan trong phản hồi.

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

Xác định xem có đưa AQI của địa phương (quốc gia) của vị trí (quốc gia) được yêu cầu vào câu trả lờ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 có liên quan về AQI cục bộ của vị trí.
HEALTH_RECOMMENDATIONS

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

Nội dung đề xuất này được thiết kế riêng cho dân số chung và 6 nhóm có nguy cơ nhạy cảm với các chất gây ô nhiễm hơn so với dân số 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 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 của trường "chỉ mục" 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ác chất gây ô nhiễm chủ yếu được đo lường theo chỉ số toàn cầu và/hoặc tại địa phương hay không.

Nếu yêu cầu chỉ định cả AQI toàn cầu và AQI địa phương, 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 gây ô nhiễm chủ yếu có trong danh sách "các 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 với kết quả đo lường sẵn có theo chỉ số toàn cầu và/hoặc tại địa phương hay không.

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

HealthRecommendations

Nội dung đề xuất về sức khoẻ cho nhiều nhóm dân số ở dạng văn bản tự do. Nội dung đề xuất được đưa ra dựa trên điều kiện chất lượng không khí có liên quan.

Trường
general_population

string

Không có độ nhạy cụ thể.
elderly

string

Người về hưu và những người lớn hơn dân số chung.
lung_disease_population

string

Các vấn đề liên quan đến hô hấp và bệnh hen suyễn.
heart_disease_population

string

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

string

Thể thao và các hoạt động cường độ cao khác ngoài trời.
pregnant_women

string

Phụ nữ ở tất cả các giai đoạn mang thai.
children

string

Nhóm dân số trẻ tuổi bao gồm trẻ em, trẻ mới biết đi và trẻ sơ sinh.

LookupCurrentConditionsRequest

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

Trường
location

LatLng

Bắt buộc. Kinh độ và vĩ độ mà API tìm kiế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 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 liên quan 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í toàn cầu" (UAQI) cung cấp. Bảng màu này chỉ phù hợp với UAQI, các chỉ số chất lượng không khí (AQI) khác có bảng màu định sẵn không thể kiểm soát.
custom_local_aqis[]

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 có chỉ số chất lượng không khí (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 chỉ số chất lượng không khí (AQI) đã chọn. Bạn có thể sử dụng tham số này để chỉ định AQI không 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 chính sách này thành true, thì chỉ số 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 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ữ đó, API sẽ sử dụng kết quả khớp 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.

LookupCurrentConditionsResponse

Trường
date_time

Timestamp

Dấu thời gian làm tròn xuống ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 phân số. 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í nêu 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ổ bị tranh chấp.
indexes[]

AirQualityIndex

Dựa trên các 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í:

  • AQI toàn cầu. Sẽ được trả về nếu boolean globalAqi được đặt thành true.
  • AQI (Chỉ số chất lượng không khí) 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[]

Pollutant

Danh sách các chất gây ô nhiễm ảnh hưởng đến vị trí đã nêu 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 đây: ): vừa
health_recommendations

HealthRecommendations

Nội dung tư vấ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. Nội dung đề xuất được điều chỉnh theo những cách khác nhau cho những nhóm dân số có nguy cơ, những nhóm nhạy cảm hơn với các chất gây ô nhiễm, và nhóm dân số chung.

LookupForecastRequest

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

Trường
location

LatLng

Bắt buộc. Vĩ độ và kinh độ mà API tì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 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 liên quan 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í toàn cầu" (UAQI) cung cấp. Bảng màu này chỉ phù hợp với UAQI, các chỉ số chất lượng không khí (AQI) khác có bảng màu định sẵn không thể kiểm soát.
custom_local_aqis[]

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 có chỉ số chất lượng không khí (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 chỉ số chất lượng không khí (AQI) đã chọn. Bạn có thể sử dụng tham số này để chỉ định AQI không 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ần trả lại trên mỗi trang (mặc định là 24).
page_token

string

Không bắt buộc. Mã thông báo trang nhận được từ lệnh gọi dự đoán trước đó. URL này được dùng để truy xuất trang tiếp theo.
Trường hợp 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. Phạm vi thời gian phải làm tròn ít nhất một giờ trong tương lai. Việc không thể chỉ định trường này sẽ dẫn đến lỗi INVALID_ qu. time_range chỉ có thể là một trong những trạng thái 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 thành giờ chính xác trước đó.

Lưu ý: thao tá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 thành phần thông tin hằng giờ). Ví dụ: Một yêu cầu được gửi có tham số date_time được đặt thành 2023-01-03T11:05:49Z sẽ được làm tròn xuống 2023-01-03T11:00:00Z.
period

Interval

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

bool

Không bắt buộc. Nếu bạn đặt chính sách này thành true, thì Universal AQI 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 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ữ đó, API sẽ sử dụng kết quả khớp nhất. Các giá trị được phép phụ thuộc vào tiêu chuẩn IETF (mặc định là "en").

LookupForecastResponse

Đối tượng phản hồi của API dự báo 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í từng giờ trong phạm vi yêu cầu. Ví dụ: nếu yêu cầu là dành cho dự báo trong 48 giờ, thì sẽ có 48 phần tử là 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í nêu 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ổ bị 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í từng giờ trong phạm vi yêu cầu. Ví dụ: nếu yêu cầu là dành cho dự báo trong 48 giờ, thì sẽ có 48 phần tử là 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 đề cập ở định dạng "Zulu" theo chuẩn RFC3339 UTC. Ví dụ: "2014-10-02T15:00:00Z".
indexes[]

AirQualityIndex

Dựa trên các 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í:

  • AQI toàn cầu. Sẽ được trả về nếu boolean universal_aqi được đặt thành true.
  • AQI (Chỉ số chất lượng không khí) 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[]

Pollutant

Danh sách các chất gây ô nhiễm ảnh hưởng đến vị trí đã nêu 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 đây: ): vừa
health_recommendations

HealthRecommendations

Nội dung tư vấ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. Nội dung đề xuất được điều chỉnh theo những cách khác nhau cho những nhóm dân số có nguy cơ, những nhóm nhạy cảm hơn với các chất gây ô nhiễm, và nhóm dân số chung.

LookupHeatmapTileRequest

Một yêu cầu về 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 tiêu 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 dưới dạng đồ hoạ.

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 hoặc kích thước của nội dung của bản đồ xuất hiện trong một chế độ xem bản đồ.

Mức thu phóng 0 cho phép bạn xem toàn bộ thế giới trong một ô duy nhất. Thu phóng cấp 1 là cả thế giới trong 4 ô. Thu phóng cấp 2 là toàn bộ thế giới trong 16 ô. Mức thu phóng 16 là cả thế giới trong 65.536 ô.

Các giá trị cho 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ố bản ghi thông tin hằng giờ tối đa được 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 đó. URL 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 thông 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 dữ liệu trước đây về chất lượng không khí.
extra_computations[]

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

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 có chỉ số chất lượng không khí (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 chỉ số chất lượng không khí (AQI) đã chọn. Bạn có thể sử dụng tham số này để chỉ định AQI không 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 time_range. Phạm vi thời gian của dữ liệu chất lượng không khí cần thiết. Việc không chỉ định bất kỳ trường có liên quan đến phạm vi thời gian nào sẽ dẫn đến lỗi INVALID_ qu. Phạm vi thời gian có thể chỉ là một trong các trường sau: time_range có thể chỉ là một trong các trường sau đây:
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 thành giờ chính xác trước đó.

Lưu ý: thao tá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 thành phần 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 2023-01-03T11:00:00Z.

Dấu thời gian ở đị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:01:23Z" và "2014-10-02T15:01:23.045123456Z".
hours

int32

Số từ 1 đến 720 cho biết phạm vi giờ cho yêu cầu. Ví dụ: Giá trị 48 sẽ tạo ra 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 mà bạn cần nhận dữ liệu trong quá khứ. Dấu thời gian được làm tròn thành giờ chính xác trước đó.
universal_aqi

bool

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 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 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ữ đó, API sẽ sử dụng kết quả khớp 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.

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í từng giờ trong phạm vi yêu cầu. Ví dụ: nếu yêu cầu là về 48 giờ lịch sử sẽ có 48 phần tử thông tin 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í nêu 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ổ bị 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í từng giờ trong phạm vi yêu cầu. Ví dụ: nếu yêu cầu là về 48 giờ lịch sử 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 được đề cập ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa là 9 chữ số phân số. Ví dụ: "2014-10-02T15:00:00Z".
indexes[]

AirQualityIndex

Dựa trên các 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í:

  • AQI toàn cầu. Sẽ được trả về nếu boolean globalAqi được đặt thành true.
  • AQI (Chỉ số chất lượng không khí) 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[]

Pollutant

Danh sách các chất gây ô nhiễm ảnh hưởng đến vị trí đã nêu 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 đây: ): vừa
health_recommendations

HealthRecommendations

Nội dung tư vấ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. Nội dung đề xuất được điều chỉnh theo những cách khác nhau cho những nhóm dân số có nguy cơ, những nhóm nhạy cảm hơn với các chất gây ô nhiễm, và nhóm dân số 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 dưới dạng đồ hoạ.

Enum
MAP_TYPE_UNSPECIFIED Giá trị mặc định. Máy chủ sẽ bỏ qua thông số này nếu đượ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í toàn cầu.
UAQI_INDIGO_PERSIAN Bảng chỉ số chất lượng không khí toàn cầu màu chàm – Ba Tư.
PM25_INDIGO_PERSIAN Chỉ số PM2.5 trong bảng màu chàm-Ba Tư.
GBR_DEFRA Bảng màu Chỉ số chất lượng không khí hằng ngày (Vương quốc Anh).
DEU_UBA Bảng màu Chỉ số chất lượng không khí địa phương của Đức.
CAN_EC Bảng màu Chỉ số sức khoẻ theo chất lượng không khí của Canada.
FRA_ATMO Bảng màu Chỉ số chất lượng không khí của Pháp.
US_AQI Bảng màu Chỉ số chất lượng không khí của Hoa Kỳ.

Chất gây ô nhiễm

Dữ liệu liên quan đến một 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". Bạn có thể tìm thấy danh sách tất cả các mã hiện có tại đây.
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 hoá học, đây là tên IUPAC. Ví dụ: "Lưu huỳnh đioxit".

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

Concentration

Nồng độ của chất ô 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

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

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 đến 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 nồng độ chất ô nhiễm này.
value

float

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

Đơn vị

Xác định đơn vị dùng để đo nồng độ của chất gây ô nhiễm.

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