ปลายทาง currentConditions
ให้ข้อมูลคุณภาพอากาศรายชั่วโมงปัจจุบัน คุณควบคุมได้ว่าจะแสดงผล AQI และข้อมูลที่เกี่ยวข้องใดบ้าง (เช่น ระดับความเข้มข้นของสารมลพิษและคำแนะนำด้านสุขภาพ)
คุณขอข้อมูลคุณภาพอากาศรายชั่วโมงในปัจจุบันได้โดยใช้ปลายทาง currentConditions
โดยส่งคำขอ HTTP POST ไปที่
https://airquality.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY
ใส่ตัวเลือกคำขอใน JSON เนื้อหาคำขอ เนื้อหาคำขอประกอบด้วยสถานที่ที่คุณต้องการทราบสภาพคุณภาพอากาศปัจจุบันและตัวเลือกต่างๆ ในการควบคุมข้อมูลคุณภาพอากาศที่จะรวมไว้ในคำตอบ
โปรแกรมสำรวจ API ช่วยให้คุณส่งคําขอแบบเรียลไทม์เพื่อให้คุณคุ้นเคยกับ API และตัวเลือก API ต่อไปนี้
ตัวอย่างคําขอพื้นฐาน
เนื้อหาคำขอพื้นฐาน
โค้ดต่อไปนี้แสดงวิธีสร้างเนื้อหาคำขอพื้นฐานสำหรับคำขอ currentConditions
ในตัวอย่างนี้ คุณตั้งค่าเฉพาะตำแหน่ง
curl -X POST -d '{ "location": { "latitude": 37.419734, "longitude": -122.0827784 } }' \ -H 'Content-Type: application/json' \ 'https://airquality.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY'
การตอบกลับคําขอพื้นฐาน
การเรียกข้างต้นจะสร้างการตอบกลับ JSON ต่อไปนี้ ดูรายละเอียดเพิ่มเติมเกี่ยวกับข้อมูลการตอบกลับได้ที่ข้อมูลการตอบกลับ
{ "dateTime": "2023-10-26T18:00:00Z", "regionCode": "us", "indexes": [ { "code": "uaqi", "displayName": "Universal AQI", "aqi": 52, "aqiDisplay": "52", "color": { "red": 0.9490196, "green": 0.98039216, "blue": 0.019607844 }, "category": "Moderate air quality", "dominantPollutant": "no2" } ] }
ตัวอย่างคําขอที่มีพารามิเตอร์หลายรายการ
คำขอพารามิเตอร์หลายรายการ
โค้ดต่อไปนี้แสดงวิธีสร้างเนื้อหาคำขอสำหรับคำขอ currentConditions
ในตัวอย่างนี้ นอกจากสถานที่ตั้งแล้ว ระบบยังระบุการคํานวณเพิ่มเติมหลายรายการและภาษาของคําตอบ
curl -X POST -d '{ "universalAqi": true, "location": { "latitude": 37.419734, "longitude": -122.0827784 }, "extraComputations": [ "HEALTH_RECOMMENDATIONS", "DOMINANT_POLLUTANT_CONCENTRATION", "POLLUTANT_CONCENTRATION", "LOCAL_AQI", "POLLUTANT_ADDITIONAL_INFO" ], "languageCode": "en" }' \ -H 'Content-Type: application/json' \ 'https://airquality.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY'
การตอบสนองของพารามิเตอร์หลายรายการ
การเรียกข้างต้นจะสร้างการตอบกลับ JSON ต่อไปนี้ ดูรายละเอียดเพิ่มเติมเกี่ยวกับข้อมูลการตอบกลับได้ที่ข้อมูลการตอบกลับ
{ "dateTime": "2023-06-15T10:00:00Z", "regionCode": "us", "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" }, { "code": "usa_epa", "displayName": "AQI (US)", "aqi": 41, "aqiDisplay": "41", "color": { "green": 228, "alpha": 255 }, "category": "Good air quality", "dominantPollutant": "pm25" } ], "pollutants": [ { "code": "co", "displayName": "CO", "fullName": "Carbon monoxide", "concentration": { "value": 334.24, "units": "PARTS_PER_BILLION" }, "additionalInfo": { "sources": "Typically originates from incomplete combustion...", "effects": "When inhaled, carbon monoxide can prevent the blood from..." } }, { "code": "no2", "displayName": "NO2", "fullName": "Nitrogen dioxide", "concentration": { "value": 13.12, "units": "PARTS_PER_BILLION" }, "additionalInfo": { "sources": "Main sources are fuel burning processes, such as...", "effects": "Exposure may cause increased bronchial reactivity..." } }, { "code": "o3", "displayName": "O3", "fullName": "Ozone", "concentration": { "value": 13.88, "units": "PARTS_PER_BILLION" }, "additionalInfo": { "sources": "Ozone is created in a chemical reaction between atmospheric oxygen...", "effects": "Ozone can irritate the airways and cause coughing, a burning..." } }, { "code": "pm10", "displayName": "PM10", "fullName": "Inhalable particulate matter (<10µm)", "concentration": { "value": 5.07, "units": "MICROGRAMS_PER_CUBIC_METER" }, "additionalInfo": { "sources": "Main sources are combustion processes (e.g. indoor heating, wildfires)...", "effects": "Inhalable particles can penetrate into the lungs. Short term exposure..." } }, { "code": "pm25", "displayName": "PM2.5", "fullName": "Fine particulate matter (<2.5µm)", "concentration": { "value": 2.83, "units": "MICROGRAMS_PER_CUBIC_METER" }, "additionalInfo": { "sources": "Main sources are combustion processes (e.g. power plants, indoor heating...", "effects": "Fine particles can penetrate into the lungs and bloodstream. Short term..." } }, { "code": "so2", "displayName": "SO2", "fullName": "Sulfur dioxide", "concentration": { "value": 0.02, "units": "PARTS_PER_BILLION" }, "additionalInfo": { "sources": "Main sources are burning processes of sulfur-containing fuel in industry...", "effects": "Exposure causes irritation of the respiratory tract, coughing and generates..." } } ], "healthRecommendations": { "generalPopulation": "With this level of air quality, you have no limitations. Enjoy the outdoors!", "elderly": "If you start to feel respiratory discomfort such as coughing or breathing difficulties...", "lungDiseasePopulation": "...", "heartDiseasePopulation": "...", "athletes": "...", "pregnantWomen": "...", "children": "..." } }