Điểm cuối history
cung cấp
thông tin trước đây về chất lượng không khí theo giờ của một địa điểm cụ thể
phạm vi thời gian, tối đa là 30 ngày. Bạn có thể kiểm soát các chỉ số AQI và
thông tin liên quan sẽ được trả về (chẳng hạn như nồng độ các chất gây ô nhiễm và
sức khoẻ).
Bạn có thể yêu cầu xem nhật ký chất lượng không khí theo giờ bằng cách sử dụng
history
bằng cách gửi yêu cầu POST qua HTTP tới:
https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY
Đưa các lựa chọn về yêu cầu của bạn vào trong tệp JSON nội dung yêu cầu. Nội dung yêu cầu chứa vị trí và khoảng thời gian mà bạn muốn nhận nhật ký chất lượng không khí theo giờ. Trang này cũng có thể bao gồm nhiều tuỳ chọn kiểm soát cần cung cấp thông tin nào về chất lượng không khí trong câu trả lời.
APIs Explorer cho phép bạn đưa ra các yêu cầu trực tiếp để bạn có thể làm quen với API và các tuỳ chọn API:
Ví dụ về yêu cầu một giờ
Nội dung yêu cầu một giờ
Đoạn mã sau đây cho biết cách tạo nội dung yêu cầu trong một giờ
yêu cầu nhật ký đang sử dụng
Phương thức history
.
Trong ví dụ này, bạn đặt vị trí và dấu thời gian trong quá khứ.
curl -X POST -d '{ "dateTime": "2023-06-26T15:01:23Z", "location": { "latitude": 37.419734, "longitude": -122.0827784 } }' \ -H 'Content-Type: application/json' \ 'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'
Phản hồi trong 1 giờ
Lệnh gọi trên tạo ra những dữ liệu sau Phản hồi JSON. Để biết thêm thông tin chi tiết về dữ liệu phản hồi, hãy xem phần Dữ liệu phản hồi.
{ "hoursInfo": [ { "dateTime": "2023-06-26T15:00:00Z", "indexes": [ { "code": "uaqi", "displayName": "Universal AQI", "aqi": 73, "aqiDisplay": "73", "color": { "red": 118, "green": 202, "blue": 51, "alpha": 255 }, "category": "Good air quality", "dominantPollutant": "pm10" } ] } ], "regionCode": "us" }
Ví dụ về yêu cầu phạm vi thời gian
Yêu cầu về phạm vi thời gian
Đoạn mã sau đây biểu thị cách tạo nội dung yêu cầu cho một
history
trả về nhiều
hồ sơ về chất lượng không khí theo giờ trước đây.
Bạn có thể yêu cầu nhiều bản ghi bằng cách chỉ định một khoảng thời gian, tức là bắt đầu và dấu thời gian kết thúc hoặc bằng cách chỉ định số giờ tính từ thời điểm hiện tại bất cứ lúc nào.
Trong ví dụ bên dưới, vì bạn đã đặt kích thước trang thành 2
, nên yêu cầu của bạn đối với
nhật ký chất lượng không khí trong 4 giờ được trả về trong 2 trang, trong đó mỗi trang
chứa 2 giờ dữ liệu.
curl -X POST -d '{ "hours": 4, "pageSize": 2, "pageToken":"", "location": { "latitude": 37.419734, "longitude": -122.0827784 } }' \ -H 'Content-Type: application/json' \ 'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'
Bạn có thể thực hiện một yêu cầu tương tự bằng cách truyền dấu thời gian bắt đầu và kết thúc:
curl -X POST -d '{ "period": { "startTime":"2023-06-15T08:00:00Z", "endTime":"2023-06-15T12:00:00Z" }, "pageSize": 2, "pageToken":"", "location": { "latitude": 37.419734, "longitude": -122.0827784 } }' \ -H 'Content-Type: application/json' \ 'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'
Phản hồi theo phạm vi thời gian
Các lệnh gọi trên tạo ra một Phản hồi JSON trong biểu mẫu bên dưới. Để biết thêm thông tin chi tiết về dữ liệu phản hồi, hãy xem Dữ liệu phản hồi.
Cả hai cuộc gọi trên đều yêu cầu dữ liệu chất lượng không khí trong 4 giờ. Tuy nhiên, vì bạn đặt
thuộc tính pageSize
với 2
trong yêu cầu, thì phản hồi chỉ bao gồm
kết quả trong hai giờ gần đây nhất.
{ "hoursInfo": [ { "dateTime": "2023-06-15T11:00:00Z", "indexes": [ { "code": "uaqi", "displayName": "Universal AQI", "aqi": 83, "aqiDisplay": "83", "color": { "red": 74, "green": 185, "blue": 54, "alpha": 255 }, "category": "Excellent air quality", "dominantPollutant": "o3" } ] }, { "dateTime": "2023-06-15T10:00:00Z", "indexes": [ { "code": "uaqi", "displayName": "Universal AQI", "aqi": 89, "aqiDisplay": "89", "color": { "red": 48, "green": 175, "blue": 55, "alpha": 255 }, "category": "Excellent air quality", "dominantPollutant": "o3" } ] } ], "regionCode": "us", "nextPageToken": "ChYaEgl3gv3XubVCQBEsNMY9TTdUMTE6MDA6MDA" }
Xin lưu ý rằng phản hồi cũng bao gồm thuộc tính nextPageToken
. Sử dụng bản thảo này
để truy cập vào trang tiếp theo của kết quả, chứa hai thông tin tiếp theo
giờ dữ liệu.
Để truy cập trang kết quả tiếp theo, hãy gửi yêu cầu thứ hai tới
điểm cuối history
, nhưng lần này hãy đặt thuộc tính pageToken
thành
giá trị của nextPageToken
trong phản hồi đầu tiên.
curl -X POST -d '{ "hours": 4, "pageSize": 2, "pageToken":"ChYaEgl3gv3XubVCQBEsNMY9TTdUMTE6MDA6MDA", "location": { "latitude": 37.419734, "longitude": -122.0827784 } }' \ -H 'Content-Type: application/json' \ 'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'