Method: currentConditions.lookup

توفّر نقطة نهاية "الظروف الحالية" معلومات حول جودة الهواء كل ساعة في أكثر من 100 بلد، بدقة تصل إلى 500 × 500 متر. يتضمّن التطبيق أكثر من 70 مؤشرًا محليًا ومؤشر جودة الهواء وفئة عالمية.

طلب HTTP

POST https://airquality.googleapis.com/v1/currentConditions:lookup

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "location": {
    object (LatLng)
  },
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "uaqiColorPalette": enum (ColorPalette),
  "customLocalAqis": [
    {
      object (CustomLocalAqi)
    }
  ],
  "universalAqi": boolean,
  "languageCode": string
}
الحقول
location

object (LatLng)

مطلوب. خطوط الطول والعرض التي تبحث من خلالها واجهة برمجة التطبيقات عن بيانات أحوال جودة الهواء الحالية.
extraComputations[]

enum (ExtraComputation)

اختياريّ. الميزات الإضافية التي يمكن تفعيلها اختياريًا. سيؤدي تحديد عمليات حسابية إضافية إلى عرض العناصر والحقول ذات الصلة في الردّ.
uaqiColorPalette

enum (ColorPalette)

اختياريّ. لتحديد لوحة الألوان المستخدمة للبيانات التي يوفّرها "مؤشر جودة الهواء العالمي" (UAQI). تلائم لوحة الألوان هذه مؤشر UAQI فقط، بينما تتضمّن مؤشرات جودة الهواء الأخرى لوحة ألوان محدّدة مسبقًا لا يمكن التحكّم فيها.
customLocalAqis[]

object (CustomLocalAqi)

اختياريّ. يحدّد "البلد/المنطقة المرتبطة بمؤشر جودة الهواء" (AQI) العلاقة. يتم إقران البلد أو المنطقة مع مؤشر جودة الهواء المطلوب لعرض بيانات جودة الهواء المطلوبة في ذلك البلد أو هذه المنطقة وفقًا لمؤشر جودة الهواء الذي تم اختياره. ويمكن استخدام هذه المَعلمة لتحديد مؤشر جودة الهواء (AQI) غير تلقائي لبلد معيّن، مثلاً للحصول على مؤشر وكالة حماية البيئة الأمريكية (EPA) في الولايات المتحدة بدلاً من الفهرس التلقائي لكندا.
universalAqi

boolean

اختياريّ. في حال ضبط هذه السياسة على "صحيح"، سيتم تضمين مؤشر جودة الهواء العام في "المؤشرات". لحقل الاستجابة. القيمة التلقائية هي true.
languageCode

string

اختياريّ. تسمح للعميل باختيار لغة الرد. إذا تعذّر توفير بيانات لهذه اللغة، ستستخدم واجهة برمجة التطبيقات أقرب تطابق. تعتمد القيم المسموح بها على معيار مجموعة مهندسي شبكة الإنترنت (IETF). القيمة التلقائية هي en.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "dateTime": string,
  "regionCode": string,
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  }
}
الحقول
dateTime

string (Timestamp format)

طابع زمني تقريبي في RFC3339 UTC "Zulu" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. على سبيل المثال: "2014-10-02T15:00:00Z".
regionCode

string

تمثّل هذه السمة رمز ISO_3166-1 alpha-2 للبلد أو المنطقة المتوافقَين مع الموقع الجغرافي المقدَّم في الطلب. قد يتم حذف هذا الحقل من الرد إذا كان الموقع الجغرافي المذكور في الطلب يقع في منطقة متنازع عليها.
indexes[]

object (AirQualityIndex)

استنادًا إلى معلَمات الطلب، تتضمّن هذه القائمة (ما يصل إلى) مؤشرَين لجودة الهواء:

  • مؤشر جودة الهواء العام. سيتم عرضه في حال ضبط القيمة المنطقية universalAqi على true.
  • مؤشر جودة الهواء المحلي. سيتم عرضه إذا تم تحديد طريقة الاحتساب الإضافية لـ LOCAL_AQI.
pollutants[]

object (Pollutant)

تعرض هذه السياسة قائمة بالملوّثات التي تؤثّر في الموقع الجغرافي المحدّد في الطلب. ملاحظة: لن يتم عرض هذا الحقل إلا للطلبات التي حددت واحدة أو أكثر من العمليات الحسابية الإضافية التالية: POLLUTANT_ADDITIONAL_INFO وDOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION.
healthRecommendations

object (HealthRecommendations)

النصائح الصحية والإجراءات المقترَحة المتعلقة بظروف جودة الهواء التي يتم الإبلاغ عنها يتم تصميم الاقتراحات بشكل مختلف حسب الفئات السكانية المعرّضة للخطر والمجموعات ذات الحساسية الأكبر للملوّثات وعموم السكان.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/cloud-platform

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.