Method: lookupWeather

البحث عن الأحوال الجوية في موقع جغرافي معيّن

طلب HTTP

POST https://mapstools.googleapis.com/v1alpha:lookupWeather

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

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],
  "date": {
    object (Date)
  },
  "hour": integer,
  "languageCode": string,
  "weatherOptions": {
    object (WeatherOptions)
  },
  "airQualityOptions": {
    object (AirQualityOptions)
  }
}
الحقول
unitsSystem

enum (UnitsSystem)

اختياريّ. نظام الوحدات المطلوب استخدامه لأحوال الطقس التي يتم عرضها في حال عدم تقديمها، ستكون أحوال الطقس المعروضة بالنظام المتري (القيمة التلقائية = METRIC).
location

object (Location)

الحقل مطلوب. الموقع الجغرافي المطلوب معرفة أحوال الطقس فيه
capabilities[]

enum (Capability)

اختياريّ. الإمكانات البيئية التي يجب تضمينها في الردّ
date

object (Date)

اختياريّ. يحدّد هذا الحقل تاريخ المعلومات البيئية المطلوبة، بالنسبة إلى المنطقة الزمنية المحلية للموقع الجغرافي المحدّد في الحقل location. تعتمد النطاقات الزمنية المتاحة على الميزات المطلوبة: - WEATHER: ما يصل إلى 24 ساعة في الماضي (عند ضبط hour أيضًا) وما يصل إلى 10 أيام (240 ساعة) في المستقبل (من اليوم إلى 9 أيام أخرى للتوقعات اليومية). - AIR_QUALITY: ما يصل إلى 30 يومًا (720 ساعة) في الماضي وما يصل إلى 4 أيام (96 ساعة) في المستقبل. ‫- POLLEN: من اليوم إلى 4 أيام قادمة (ما يصل إلى 5 أيام بما في ذلك اليوم، ولا يمكن استخدام تواريخ سابقة).
hour

integer

اختياريّ. يحدّد هذا الحقل ساعة المعلومات البيئية المطلوبة، بتنسيق 24 ساعة (0-23)، بالنسبة إلى المنطقة الزمنية المحلية للموقع الجغرافي المحدّد في الحقل location. يتطلّب تحديد date. تعتمد النطاقات الزمنية المتاحة على الإمكانات المطلوبة: - WEATHER: ما يصل إلى 24 ساعة في الماضي وما يصل إلى 240 ساعة (10 أيام) في المستقبل. - AIR_QUALITY: ما يصل إلى 30 يومًا (720 ساعة) في الماضي وما يصل إلى 4 أيام (96 ساعة) في المستقبل. ‫- POLLEN: تعرض التوقعات اليومية فقط، ويتم تجاهل hour في ما يتعلق بحبوب اللقاح.
languageCode

string

اختياريّ. رمز اللغة المستخدَمة في النص المترجَم في الردّ وفق المعيار BCP-47 (مثل "en" أو "ja" أو "fr-CA"). ويتم ضبط القيمة على "en" تلقائيًا في حال عدم تحديدها.
weatherOptions

object (WeatherOptions)

اختياريّ. خيارات خاصة بطلبات الطقس يتم استخدام weatherOptions.units_system مع unitsSystem (العلامة 4) ذي المستوى الأعلى للحفاظ على التوافق مع الأنظمة القديمة للمتصلين الحاليين، ويتم عرض INVALID_ARGUMENT إذا كان كلاهما يحدّد أنظمة وحدات متعارضة. يتم تجاهل هذه السياسة في حال عدم طلب WEATHER في capabilities.
airQualityOptions

object (AirQualityOptions)

اختياريّ. خيارات خاصة بطلبات جودة الهواء يتم تجاهل هذه السياسة في حال عدم طلب AIR_QUALITY في capabilities.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال LookupWeatherResponse.

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

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

  • https://www.googleapis.com/auth/maps-platform.mapstools