สภาพอากาศปัจจุบัน

ปลายทาง 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 ต่อไปนี้ ดูรายละเอียดเพิ่มเติมเกี่ยวกับข้อมูลการตอบกลับได้ที่ข้อมูลการตอบกลับ

หมายเหตุ: โดยค่าเริ่มต้น การตอบกลับจะมี AQI สากลพร้อมข้อมูล AQI พื้นฐาน คุณสามารถนำ AQI ออกหรือแทนที่ด้วย AQI อื่นได้โดยการตั้งค่าพารามิเตอร์ที่เกี่ยวข้อง

{
  "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"
    }
  ]
}

หมายเหตุ: หากค่าในช่อง color คือ 0 ระบบจะไม่รวมช่องนั้นไว้ในคําตอบ

ตัวอย่างคําขอที่มีพารามิเตอร์หลายรายการ

คำขอพารามิเตอร์หลายรายการ

โค้ดต่อไปนี้แสดงวิธีสร้างเนื้อหาคำขอสำหรับคำขอ 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": "..."
    }
}