ประวัติ

ปลายทาง history ให้ข้อมูลคุณภาพอากาศรายชั่วโมงย้อนหลังสำหรับสถานที่หนึ่งๆ ในช่วงเวลาที่กำหนด สูงสุด 30 วัน คุณสามารถควบคุม AQI และข้อมูลที่เกี่ยวข้องที่จะแสดงผลได้ (เช่น ระดับความเข้มข้นของมลพิษและคำแนะนำด้านสุขภาพ)

คุณสามารถขอประวัติคุณภาพอากาศรายชั่วโมงได้โดยใช้ปลายทาง history ด้วยการส่งคำขอ POST HTTP ไปยัง

https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY

รวมตัวเลือกคำขอไว้ในเนื้อหาคำขอ JSON เนื้อหาคำขอประกอบด้วยสถานที่และช่วงเวลาที่คุณต้องการดูประวัติคุณภาพอากาศรายชั่วโมง นอกจากนี้ ยังอาจมีตัวเลือกต่างๆ เพื่อควบคุมข้อมูลคุณภาพอากาศที่จะรวมไว้ในคำตอบด้วย

โปรแกรมสำรวจ API ช่วยให้คุณส่งคำขอแบบเรียลไทม์เพื่อให้คุ้นเคยกับ API และตัวเลือก API ได้

ตัวอย่างคำขอแบบชั่วโมงเดียว

เนื้อหาคำขอสำหรับ 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

  1. เลือกไอคอน API api ทางด้านขวาของหน้า

  2. แก้ไขพารามิเตอร์คำขอ (ไม่บังคับ)

  3. เลือกปุ่มดำเนินการ ในกล่องโต้ตอบ ให้เลือกบัญชีที่ต้องการใช้เพื่อส่งคำขอ

  4. ในแผงโปรแกรมสำรวจ API ให้เลือกไอคอนเต็มหน้าจอ fullscreen เพื่อขยายหน้าต่างโปรแกรมสำรวจ API