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).