Method: forecast.hours.lookup

تعرض هذه الطريقة توقعات الطقس كل ساعة لمدة تصل إلى 240 ساعة في موقع جغرافي محدّد، بدءًا من الساعة الحالية.

طلب HTTP

GET https://weather.googleapis.com/v1/forecast/hours:lookup

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

مَعلمات طلب البحث

المعلمات
location

object (LatLng)

الحقل مطلوب. الموقع الجغرافي الذي تريد الحصول على توقعات الطقس لكل ساعة فيه
unitsSystem

enum (UnitsSystem)

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

integer

اختيارية: الحدّ الأقصى لعدد سجلّات توقّعات الطقس كل ساعة التي سيتم عرضها في كل صفحة، وهي قيمة تتراوح بين 1 و24 (شاملة). القيمة التلقائية هي الحد الأقصى المسموح به وهو 24.
pageToken

string

اختيارية: رمز مميز للصفحة تم استلامه من طلب سابق. ويتم استخدامها لاسترداد الصفحة التالية.
hours

integer

اختيارية: يحدّ من عدد الساعات الإجمالي التي سيتم جلبها بدءًا من الساعة الحالية، وهي قيمة تتراوح بين 1 و240 (بما في ذلك). القيمة التلقائية هي الحد الأقصى المسموح به وهو 240.
languageCode

string

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

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

استجابة لطلب RPC الخاص بـ hours.lookup

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

تمثيل JSON 
{
  "forecastHours": [
    {
      object (ForecastHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
الحقول
forecastHours[]

object (ForecastHour)

تسجّل التوقعات كل ساعة وفقًا لعدد الساعات وحجم الصفحة المحدّدَين في الطلب.
timeZone

object (TimeZone)

تمثّل هذه السمة المنطقة الزمنية في الموقع الجغرافي المطلوب.
nextPageToken

string

الرمز المميز لاسترداد الصفحة التالية.

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

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

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

ForecastHour

تمثّل هذه السمة سجلّ توقعات الطقس لكل ساعة في موقع جغرافي معيّن.

تمثيل JSON 
{
  "interval": {
    object (Interval)
  },
  "displayDateTime": {
    object (DateTime)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "wetBulbTemperature": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
الحقول
interval

object (Interval)

الفاصل الزمني لمدة ساعة واحدة (بالتوقيت العالمي المتفق عليه) الذي تكون بيانات التوقّعات هذه صالحة له (يتم تقريب الطوابع الزمنية إلى أقرب ساعة).
displayDateTime

object (DateTime)

التاريخ والوقت المحليان في المنطقة الزمنية للموقع الجغرافي (التوقيت المدني) الذي يتم احتساب التوقعات كل ساعة له قد يتم استخدام هذا الحقل لأغراض العرض على العميل. ملاحظة: سيتألف هذا التاريخ من السنة والشهر واليوم والساعة والفرق عن التوقيت العالمي المتفق عليه.
weatherCondition

object (WeatherCondition)

حالة الطقس المتوقّعة
temperature

object (Temperature)

درجة الحرارة المتوقّعة
feelsLikeTemperature

object (Temperature)

تمثّل هذه السمة درجة الحرارة الظاهرية في الموقع الجغرافي المطلوب.
dewPoint

object (Temperature)

تمثّل هذه السمة درجة حرارة التكثف المتوقّعة.
heatIndex

object (Temperature)

تمثّل هذه السمة درجة الحرارة المتوقّعة لمؤشر الحرارة.
windChill

object (Temperature)

تشير هذه السمة إلى درجة الحرارة المحسوسة المتوقّعة، أي درجة حرارة الهواء التي يشعر بها الجلد.
wetBulbTemperature

object (Temperature)

درجة حرارة البصيلة الرطبة المتوقّعة، وهي أدنى درجة حرارة يمكن تحقيقها من خلال تبخير الماء
precipitation

object (Precipitation)

تعرض هذه السمة احتمال هطول الأمطار المتوقّع وكمية الأمطار المتراكمة خلال الساعة الأخيرة.
airPressure

object (AirPressure)

حالات ضغط الهواء المتوقّعة
wind

object (Wind)

حالة الرياح المتوقّعة
visibility

object (Visibility)

إمكانية الظهور المتوقّعة
iceThickness

object (IceThickness)

تمثّل هذه السمة سمك الجليد المتوقّع.
isDaytime

boolean

تعرض القيمة "صحيح" إذا كانت هذه الساعة تقع بين وقتَي الشروق (شامل) والغروب (غير شامل) المحليَّين. بخلاف ذلك، يكون الوقت ليلاً (بين غروب الشمس وشروقها التالي). ملاحظة: سيتم اعتبار هذه الساعة وقتًا من النهار أو الليل إذا تقاطع الفاصل الزمني مع أوقات شروق الشمس وغروبها المحلية على التوالي (مثلاً: إذا كان الفاصل الزمني من الساعة 5 صباحًا إلى الساعة 6 صباحًا وكان شروق الشمس في الساعة 5:59 صباحًا، ستكون قيمة isDaytime صحيحة).
relativeHumidity

integer

النسبة المئوية المتوقّعة للرطوبة النسبية (قيم تتراوح بين 0 و100)
uvIndex

integer

تمثّل هذه السمة مؤشر الأشعة فوق البنفسجية المتوقّع.
thunderstormProbability

integer

تمثّل هذه السمة احتمال حدوث عواصف رعدية (تتراوح القيم بين 0 و100).
cloudCover

integer

النسبة المئوية المتوقّعة للسماء المغطاة بالسحب (قيم تتراوح بين 0 و100)