Method: forecast.days.lookup

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

طلب HTTP

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

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

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

المعلمات
location

object (LatLng)

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

enum (UnitsSystem)

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

integer

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

string

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

integer

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

string

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

نص الطلب

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

نص الاستجابة

استجابة طلب بيانات RPC من days.lookup

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

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

object (ForecastDay)

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

object (TimeZone)

المنطقة الزمنية في الموقع الجغرافي المطلوب
nextPageToken

string

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

نطاقات التفويض

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

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

ForecastDay

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

تمثيل JSON 
{
  "interval": {
    object (Interval)
  },
  "displayDate": {
    object (Date)
  },
  "daytimeForecast": {
    object (ForecastDayPart)
  },
  "nighttimeForecast": {
    object (ForecastDayPart)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "feelsLikeMaxTemperature": {
    object (Temperature)
  },
  "feelsLikeMinTemperature": {
    object (Temperature)
  },
  "maxHeatIndex": {
    object (Temperature)
  },
  "sunEvents": {
    object (SunEvents)
  },
  "moonEvents": {
    object (MoonEvents)
  },
  "iceThickness": {
    object (IceThickness)
  }
}
الحقول
interval

object (Interval)

الفاصل الزمني بالتوقيت العالمي المنسق الذي يبدأ فيه هذا اليوم المتوقّع (شامل) وينتهي (حصري). ملاحظة: يبدأ اليوم في الساعة 7 صباحًا وينتهي في الساعة 7 صباحًا في اليوم التالي بالتوقيت المحلي. على سبيل المثال: إذا كانت المنطقة الزمنية المحلية هي UTC-7، سيبدأ الفاصل الزمني في الساعة 14:00:00.000Z وينتهي في الساعة نفسها في اليوم التالي.
displayDate

object (Date)

التاريخ المحلي في المنطقة الزمنية للموقع الجغرافي (التوقيت المدني) الذي يتم احتساب هذه التوقّعات اليومية وفقًا له. قد يتم استخدام هذا الحقل لأغراض العرض على العميل.
daytimeForecast

object (ForecastDayPart)

تشير إلى حالة الطقس المتوقّعة خلال النهار (من الساعة 7 صباحًا إلى الساعة 7 مساءً بالتوقيت المحلي).
nighttimeForecast

object (ForecastDayPart)

أحوال الطقس المتوقّعة خلال الليل (من الساعة 7 مساءً إلى الساعة 7 صباحًا في اليوم التالي بالتوقيت المحلي)
maxTemperature

object (Temperature)

الحد الأقصى (الارتفاع) لدرجة الحرارة على مدار اليوم
minTemperature

object (Temperature)

أدنى درجة حرارة على مدار اليوم
feelsLikeMaxTemperature

object (Temperature)

الحد الأقصى (الأعلى) لدرجة الحرارة المحسوسة على مدار اليوم.
feelsLikeMinTemperature

object (Temperature)

الحد الأدنى (الواطئ) لدرجة الحرارة المحسوسة على مدار اليوم.
maxHeatIndex

object (Temperature)

الحد الأقصى لدرجة حرارة مؤشر الحرارة على مدار اليوم
sunEvents

object (SunEvents)

الأحداث المرتبطة بالشمس (مثل شروق الشمس وغروبها)
moonEvents

object (MoonEvents)

الأحداث المرتبطة بالقمر (مثل شروق القمر وغروبه)
iceThickness

object (IceThickness)

الكمية التراكمية للجليد على مدار اليوم

التاريخ

يمثّل تاريخًا تقويميًا كاملاً أو جزئيًا، مثل تاريخ ميلاد. تم تحديد وقت اليوم والمنطقة الزمنية في مكان آخر أو أنّهما غير مهمّين. التاريخ نسبي إلى التقويم الغريغوري. يمكن أن يشير ذلك إلى أحد الخيارات التالية:

  • تاريخ كامل، بقيم غير صفرية للسنة والشهر واليوم
  • الشهر واليوم، مع سنة صفرية (مثلاً، ذكرى سنوية)
  • سنة بمفردها، مع صفر شهر وصفر يوم
  • سنة وشهر، مع يوم صفري (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان)

الأنواع ذات الصلة:

تمثيل JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
الحقول
year

integer

السنة التي حدث فيها التاريخ. يجب أن تكون من 1 إلى 9999، أو 0 لتحديد تاريخ بدون عام.
month

integer

الشهر من السنة يجب أن يكون من 1 إلى 12، أو 0 لتحديد سنة بدون شهر ويوم.
day

integer

يوم من الشهر يجب أن يكون من 1 إلى 31 وصالحًا للسنة والشهر، أو 0 لتحديد سنة بمفردها أو سنة وشهر لا يُحتسَب فيها اليوم.

ForecastDayPart

يمثّل سجلّ توقّعات لجزء من اليوم.

تمثيل JSON 
{
  "interval": {
    object (Interval)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
الحقول
interval

object (Interval)

تاريخ ووقت التوقيت العالمي المنسق لبدء هذا الجزء من اليوم (شاملاً) وانتهائه (حصريًا). ملاحظة: يبدأ جزء من اليوم في الساعة 7 صباحًا وينتهي في الساعة 7 مساءً في اليوم نفسه بالتوقيت المحلي. على سبيل المثال: إذا كانت المنطقة الزمنية المحلية هي UTC-7، سيبدأ الفاصل الزمني للنهار في الساعة 14:00:00.000Z وينتهي في الساعة 02:00:00.000Z في اليوم التالي، وسيبدأ الفاصل الزمني للليل في الساعة 02:00:00.000Z في اليوم التالي وينتهي في الساعة 14:00:00.000Z في اليوم نفسه.
weatherCondition

object (WeatherCondition)

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

object (Precipitation)

هطول الأمطار المتوقّع
wind

object (Wind)

متوسط اتجاه الرياح والحد الأقصى للسرعة والهبّة
relativeHumidity

integer

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

integer

الحد الأقصى لمؤشر الأشعة فوق البنفسجية المتوقّع
thunderstormProbability

integer

متوسط احتمالية حدوث العواصف الرعدية
cloudCover

integer

متوسّط النسبة المئوية لتغطية السحب

SunEvents

يمثّل الأحداث المرتبطة بالشمس (مثل شروق الشمس وغروبها).

تمثيل JSON 
{
  "sunriseTime": string,
  "sunsetTime": string
}
الحقول
sunriseTime

string (Timestamp format)

الوقت الذي تشرق فيه الشمس

ملاحظة: في بعض الحالات الفريدة (مثلاً شمال الدائرة القطبية) قد لا يكون هناك وقت لطلوع الشمس لمدة يوم. وفي هذه الحالات، لن يتم ضبط هذا الحقل.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
sunsetTime

string (Timestamp format)

الوقت الذي تغيب فيه الشمس

ملاحظة: في بعض الحالات الفريدة (مثلاً شمال الدائرة القطبية) قد لا يكون هناك وقت لغروب الشمس لمدة يوم. وفي هذه الحالات، لن يتم ضبط هذا الحقل.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"

MoonEvents

يمثّل الأحداث المرتبطة بالقمر (مثل شروق القمر وغروبه).

تمثيل JSON 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
الحقول
moonriseTimes[]

string (Timestamp format)

الوقت الذي يظهر فيه الجزء العلوي من القمر فوق الأفق (راجِع https://en.wikipedia.org/wiki/Moonrise_and_moonset).

ملاحظة: في معظم الحالات، سيكون هناك وقت واحد لظهور القمر في اليوم. وفي حالات أخرى، قد تكون القائمة فارغة (مثلاً عندما يرتفع القمر بعد منتصف الليل في اليوم التالي). ومع ذلك، في الحالات الفريدة (مثل المناطق القطبية)، قد تحتوي القائمة على أكثر من قيمة واحدة. وفي هذه الحالات، يتم ترتيب القيم بترتيب تصاعدي.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
moonsetTimes[]

string (Timestamp format)

الوقت الذي يختفي فيه الجزء العلوي من القمر تحت الأفق (راجِع https://en.wikipedia.org/wiki/Moonrise_and_moonset).

ملاحظة: في معظم الحالات، سيكون هناك وقت واحد لضبط القمر في اليوم. وفي حالات أخرى، قد تكون القائمة فارغة (مثلاً عندما يغرب القمر بعد منتصف الليل في اليوم التالي). ومع ذلك، في الحالات الفريدة (مثل المناطق القطبية)، قد تحتوي القائمة على أكثر من قيمة واحدة. وفي هذه الحالات، يتم ترتيب القيم بترتيب تصاعدي.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
moonPhase

enum (MoonPhase)

طور القمر (يُعرف أيضًا باسم المرحلة القمرية)

MoonPhase

يشير إلى مرحلة القمر (المعروفة أيضًا باسم المرحلة القمرية).

عمليات التعداد
MOON_PHASE_UNSPECIFIED مرحلة القمر غير محدّدة
NEW_MOON لا تُضيء الشمس القمر.
WAXING_CRESCENT يكون القمر مضاءً بنسبة تتراوح بين 0% و50% على الجانب الأيمن منه في نصف الكرة الشمالي 🌒 وعلى الجانب الأيسر منه في نصف الكرة الجنوبي 🌘.
FIRST_QUARTER يضيء القمر بنسبة% 50.1 على الجانب الأيمن في نصف الكرة الأرضية الشمالي 🌓 وعلى الجانب الأيسر في نصف الكرة الأرضية الجنوبي 🌗.
WAXING_GIBBOUS يكون القمر مضاءً بنسبة تتراوح بين %50 و% 100 على الجانب الأيمن منه في نصف الكرة الأرضية الشمالي 🌔 وعلى الجانب الأيسر منه في نصف الكرة الأرضية الجنوبي 🌖.
FULL_MOON يكون القمر مضاءً بالكامل.
WANING_GIBBOUS يكون القمر مضاءً بنسبة تتراوح بين %50 و% 100 على جانبه الأيسر في نصف الكرة الأرضية الشمالي 🌖 وعلى جانبه الأيمن في نصف الكرة الأرضية الجنوبي 🌔.
LAST_QUARTER يضيء القمر بنسبة% 50.1 على جانبه الأيسر في نصف الكرة الأرضية الشمالي 🌗 وعلى جانبه الأيمن في نصف الكرة الأرضية الجنوبي 🌓.
WANING_CRESCENT يكون القمر مضاءً بنسبة تتراوح بين 0% و50% على جانبه الأيسر في نصف الكرة الأرضية الشمالي 🌘 وعلى جانبه الأيمن في نصف الكرة الأرضية الجنوبي 🌒.