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