نقطه پایانی currentConditions
اطلاعات ساعتی کیفیت هوای کنونی را ارائه می‌دهد. می‌توانید کنترل کنید کدام AQI و اطلاعات مربوطه (مثل سطح غلظت آلاینده‌ها و توصیه‌های بهداشتی) برگردانده شود.
می‌توانید کیفیت هوای ساعتی فعلی را بااستفاده از نقطه پایانی
currentConditions
با ارسال درخواست HTTP POST به نشانی زیر درخواست کنید:
https://airquality.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY
گزینه‌های درخواستتان را در بدنه درخواست JSON بگنجانید. بدنه درخواست حاوی مکانی است که می‌خواهید شرایط فعلی کیفیت هوای آن را دریافت کنید و گزینه‌های مختلفی برای کنترل اینکه چه اطلاعاتی درباره کیفیت هوا در پاسخ گنجانده شود وجود دارد.
APIs Explorer به شما امکان می‌دهد درخواست‌های مستقیم ارسال کنید تا بتوانید با «میانای برنامه‌سازی کاربردی» و گزینه‌های آن آشنا شوید:
نمونه درخواست پایه
متن درخواست پایه
کد زیر نحوه ساختن بدنه درخواست پایه برای درخواست
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": "..." } }
امتحان کنید!
با API Explorer می‌توانید درخواست‌های نمونه ایجاد کنید تا با API و گزینه‌های API آشنا شوید.
نماد API api را در سمت راست صفحه انتخاب کنید.
درصورت تمایل، پارامترهای درخواست را ویرایش کنید.
دکمه اجرا را انتخاب کنید. در کادر گفتگو، حسابی را که می‌خواهید برای درخواست استفاده شود انتخاب کنید.
در پانل «کاوشگر API»، نماد تمام‌صفحه تمام‌صفحه را انتخاب کنید تا پنجره «کاوشگر API» ازهم باز شود.