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