ปลายทาง history
จะให้ข้อมูลคุณภาพอากาศรายชั่วโมงย้อนหลังสำหรับสถานที่ตั้งที่เฉพาะเจาะจงในช่วงเวลาที่กำหนด โดยมีระยะเวลาสูงสุด 30 วัน
คุณสามารถควบคุมค่า AQI และข้อมูลที่เกี่ยวข้องที่จะแสดง (เช่น ระดับความเข้มข้นของสารมลพิษและคำแนะนำด้านสุขภาพ)
คุณขอประวัติคุณภาพอากาศรายชั่วโมงได้โดยใช้ปลายทาง
history
โดยส่งคำขอ HTTP POST ไปยัง
https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY
ระบุตัวเลือกคำขอใน request body ของ JSON เนื้อหาของคำขอ ประกอบด้วยสถานที่และช่วงเวลาที่คุณต้องการรับ ประวัติคุณภาพอากาศรายชั่วโมง นอกจากนี้ยังอาจมีตัวเลือกต่างๆ เพื่อควบคุม ข้อมูลคุณภาพอากาศที่จะรวมไว้ในคำตอบด้วย
โปรแกรมสำรวจ API ช่วยให้คุณส่งคำขอแบบเรียลไทม์เพื่อให้คุ้นเคยกับ API และตัวเลือก API ดังนี้
ตัวอย่างคำขอ 1 ชั่วโมง
เนื้อความของคำขอ 1 ชั่วโมง
โค้ดต่อไปนี้แสดงวิธีสร้างเนื้อหาคำขอสำหรับคำขอประวัติ 1 ชั่วโมงโดยใช้เมธอด history
ในตัวอย่างนี้ คุณตั้งค่าตำแหน่งและการประทับเวลาที่ผ่านมา
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'
ตอบกลับภายใน 1 ชั่วโมง
การเรียกใช้ด้านบนจะสร้างการตอบกลับ JSON ต่อไปนี้ ดูรายละเอียดเพิ่มเติมเกี่ยวกับข้อมูลการตอบกลับได้ที่ข้อมูลการตอบกลับ
{ "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" }
ตัวอย่างคำขอช่วงเวลา
คำขอช่วงเวลา
โค้ดต่อไปนี้แสดงวิธีสร้างเนื้อหาคำขอสำหรับ history
ซึ่งจะแสดงผลระเบียนหลายรายการ
ของคุณภาพอากาศรายชั่วโมงในอดีต
คุณขอหลายระเบียนได้โดยการระบุช่วงเวลา ซึ่งหมายถึงการประทับเวลาเริ่มต้น และสิ้นสุด หรือโดยการระบุจำนวนชั่วโมงย้อนหลังนับจากเวลาปัจจุบัน
ในตัวอย่างด้านล่าง เนื่องจากคุณตั้งค่าขนาดหน้าเป็น 2
ระบบจึงแสดงคำขอประวัติคุณภาพอากาศ 4 ชั่วโมงใน 2 หน้า โดยแต่ละหน้าจะมีข้อมูล 2 ชั่วโมง
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'
คุณส่งคำขอที่คล้ายกันได้โดยส่งการประทับเวลาเริ่มต้นและสิ้นสุด
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'
การตอบกลับช่วงเวลา
การเรียกใช้ข้างต้นจะสร้างการตอบกลับ JSON ในรูปแบบด้านล่าง ดูรายละเอียดเพิ่มเติมเกี่ยวกับข้อมูลการตอบกลับได้ที่ ข้อมูลการตอบกลับ
การเรียกทั้ง 2 รายการข้างต้นขอข้อมูลคุณภาพอากาศ 4 ชั่วโมง อย่างไรก็ตาม เนื่องจากคุณตั้งค่าพร็อพเพอร์ตี้ pageSize
เป็น 2
ในคำขอ คำตอบจึงมีเฉพาะผลลัพธ์ในช่วง 2 ชั่วโมงล่าสุด
{ "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" }
โปรดสังเกตว่าการตอบกลับมีพร็อพเพอร์ตี้ nextPageToken
ด้วย ใช้พร็อพเพอร์ตี้นี้
เพื่อเข้าถึงหน้าถัดไปของผลลัพธ์ ซึ่งมีข้อมูล 2 ชั่วโมงถัดไป
หากต้องการเข้าถึงผลการค้นหาในหน้าถัดไป ให้ส่งคำขอที่ 2 ไปยังปลายทาง
history
แต่คราวนี้ให้ตั้งค่าพร็อพเพอร์ตี้ pageToken
เป็น
ค่าของ nextPageToken
จากการตอบกลับแรก
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'
ลองใช้งาน
โปรแกรมสำรวจ API ช่วยให้คุณส่งคำขอตัวอย่างได้ เพื่อให้คุ้นเคยกับ API และตัวเลือก API
เลือกไอคอน API api ทางด้านขวาของหน้า
แก้ไขพารามิเตอร์คำขอ (ไม่บังคับ)
เลือกปุ่มดำเนินการ ในกล่องโต้ตอบ ให้เลือกบัญชี ที่ต้องการใช้เพื่อส่งคำขอ
ในแผงโปรแกรมสำรวจ API ให้เลือกไอคอนเต็มหน้าจอ fullscreen เพื่อขยายหน้าต่างโปรแกรมสำรวจ API