ปลายทาง history
จะแสดงข้อมูลคุณภาพอากาศรายชั่วโมงที่ผ่านมาสำหรับสถานที่หนึ่งๆ สูงสุด 30 วันในช่วงเวลาที่กำหนด คุณควบคุมได้ว่าจะให้ AQI และข้อมูลภูมิภาคใดแสดงผล (เช่น ระดับความเข้มข้นของสารมลพิษและคำแนะนำด้านสุขภาพ)
คุณขอประวัติคุณภาพอากาศรายชั่วโมงได้โดยใช้ปลายทาง history
โดยส่งคำขอ HTTP POST ไปที่
https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY
ระบุตัวเลือกคำขอในเนื้อหาของคำขอ JSON เนื้อความของคำขอ ประกอบด้วยสถานที่และช่วงเวลาที่คุณต้องการรับ ประวัติคุณภาพอากาศรายชั่วโมง และอาจมีตัวเลือกต่างๆ ในการควบคุม ข้อมูลคุณภาพอากาศที่จะรวมไว้ในคำตอบ
ตัวอย่างคำขอในชั่วโมงเดียว
เนื้อหาคำขอสำหรับ 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'
คำตอบในหนึ่งชั่วโมง
การเรียกใช้ด้านบนจะสร้างการตอบสนองของ 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 ในรูปแบบด้านล่าง ดูรายละเอียดเพิ่มเติมเกี่ยวกับข้อมูลการตอบกลับได้ที่ข้อมูลการตอบกลับ
การโทรทั้งสองครั้งข้างต้นขอข้อมูลคุณภาพอากาศในช่วง 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'