התנאים הנוכחיים

נקודת הקצה currentConditions מספקת מידע עדכני על איכות האוויר לפי שעה. אתם יכולים לקבוע אילו מדדי AQI ומידע רלוונטי יוחזרו (למשל, רמת הריכוז של המזהמים והמלצות בריאותיות).

כדי לבקש את איכות האוויר הנוכחית לפי שעה, משתמשים בנקודת הקצה currentConditions ושולחים בקשת POST אל:

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

כוללים את אפשרויות הבקשה בגוף הבקשה ב-JSON. גוף הבקשה מכיל את המיקום שבו רוצים לקבל את התנאים הנוכחיים של איכות האוויר, ואפשרויות שונות לקבוע איזה מידע על איכות האוויר ייכלל בתגובה.

בעזרת APIs Explorer אתם יכולים לשלוח בקשות בזמן אמת כדי להכיר את ה-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": "..."
    }
}

רוצה לנסות?

ב-APIs Explorer אתם יכולים לשלוח בקשות לדוגמה כדי להכיר את ה-API ואת האפשרויות שהוא מציע.

  1. לוחצים על סמל ה-API‏ api בצד שמאל של הדף.

  2. אפשר לערוך את הפרמטרים של הבקשה.

  3. לוחצים על הכפתור Execute. בתיבת הדו-שיח, בוחרים את החשבון שבו רוצים להשתמש כדי לשלוח את הבקשה.

  4. בחלונית APIs Explorer, לוחצים על סמל המסך המלא fullscreen כדי להרחיב את החלון של APIs Explorer.