Method: history.hours.lookup

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

طلب HTTP

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

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

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

المعلمات
location

object (LatLng)

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

enum (UnitsSystem)

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

integer

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

string

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

integer

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

string

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

نص الطلب

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

نص الاستجابة

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

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

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

object (HistoryHour)

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

object (TimeZone)

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

string

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

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

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

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

HistoryHour

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

تمثيل 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).