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)
  }
}
الحقول
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)

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

التاريخ

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

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

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

تمثيل 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)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
الحقول
interval

object (Interval)

تاريخ ووقت التوقيت العالمي المنسَّق (UTC) الذي يبدأ فيه هذا الجزء من اليوم (شامل) وينتهي (غير شامل). ملاحظة: يبدأ جزء من اليوم في الساعة 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)

متوسط اتجاه الرياح والسرعة القصوى والعاصفة
iceThickness

object (IceThickness)

تمثّل هذه السمة كمية الثلج المتراكم خلال جزء من اليوم.
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 على الجانب الأيسر في نصف الكرة الشمالي 🌘 وعلى الجانب الأيمن في نصف الكرة الجنوبي 🌒.