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 ( |
Trường | |
---|---|
pageSize |
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). |
pageToken |
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 |
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í. |
extraComputations[] |
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. |
uaqiColorPalette |
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. |
customLocalAqis[] |
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. |
dateTime |
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". Lưu ý: Bạn có thể sử dụng |
hours |
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 |
Cho biết khoảng thời gian Lưu ý: Bạn có thể sử dụng |
universalAqi |
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. |
languageCode |
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. |
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 ( |
Trường | |
---|---|
hoursInfo[] |
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ờ. |
regionCode |
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. |
nextPageToken |
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 Tổng quan về OAuth 2.0.
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ờ.
Biểu diễn dưới dạng JSON |
---|
{ "dateTime": string, "indexes": [ { object ( |
Trường | |
---|---|
dateTime |
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[] |
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í:
|
pollutants[] |
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 |
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. |