الحصول على توقعات الطقس كل دقيقة (تجريبية)

هذا المنتج أو الميزة في مرحلة تجريبية (ما قبل التوفر للجمهور العام). قد يكون الدعم المقدّم للمنتجات والميزات في مرحلة ما قبل التوفّر للجمهور العام محدودًا، وقد لا تكون التغييرات التي يتم إجراؤها على المنتجات والميزات هنا متوافقة مع الإصدارات الأخرى من هذه المرحلة. تخضع عروض مرحلة ما قبل التوفّر للجمهور العام لبنود الخدمة المحدّدة في "منصة خرائط Google". لمزيد من المعلومات، يُرجى الاطّلاع على أوصاف مراحل الإطلاق.

توفّر نقطة نهاية forecast:minutes توقّعات عالية الدقة للهطول دقيقة بدقيقة (تُعرف أيضًا باسم التوقّعات الحية) لموقع جغرافي معيّن.

تعرض واجهة برمجة التطبيقات المعلومات التالية خلال إطار زمني مدته 6 ساعات:

• وقت بدء الإطار الزمني للتوقّعات وانتهائه
• المنطقة الزمنية للموقع الجغرافي المطلوب
• وقت البدء والانتهاء لكل شريحة من التوقعات
• النوع المتوقَّع لهطول الأمطار واحتمالية هطولها وكميتها وكثافتها خلال كل فترة زمنية

ملاحظة: قد لا تتم مزامنة التوقعات الدقيقة أو توافقها مع مربّعات خرائط الطقس.

البنود

يتم إصدار هذه البنود بموجب الفقرة 6 (أحكام العروض الترويجية في مرحلة ما قبل التوفّر للجمهور العام) من بنود الخدمة المحدّدة في "منصة خرائط Google"، وذلك وفقًا لما تم الاتفاق عليه بينك وبين Google.

‫1.1 متطلبات تحديد المصدر: على "العميل" تقديم معلومات تحديد المصدر إلى Google وفقًا للمستندات إذا كان "العميل" يستخدم محتوى "خرائط Google" من Weather API.

‫1.2 القيود: لا يمكن للعملاء استخدام محتوى "خرائط Google" الذي تم استرجاعه من Weather API لإعادة إنشاء خدمة أو منتج من Google (على سبيل المثال، استخدام البيانات التي تم استرجاعها من Weather API في تطبيق أو نموذج خاص بالطقس يكون الغرض الأساسي منه تقديم معلومات عن الطقس).

‫1.3 التخزين المؤقت: يمكن للعملاء تخزين المحتوى الساري من "خرائط Google" مؤقتًا من Weather API لمدة التخزين المؤقت السارية، كما هو موضّح في الجدول 1.3.1 (أذونات التخزين المؤقت).

الجدول 1.3.1 (أذونات التخزين المؤقت)

تُضاف هذه الأذونات إلى الأذونات الموضّحة في الجدول 17.2.1 من "بنود الخدمة المحدّدة في منصة خرائط Google".

محتوى "خرائط Google"	فترة التخزين المؤقت
قيم التوقّعات الدقيقة	ساعة واحدة، وبعدها يجب على "العميل" حذف "محتوى خرائط Google" المخزَّن مؤقتًا

لمحة عن طلبات التوقّعات على مستوى الدقيقة

لطلب توقعات كل دقيقة، أرسِل طلب استرداد بيانات باستخدام GET إلى:

https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE

أدرِج إحداثيات خط العرض وخط الطول للموقع الجغرافي في مَعلمات الطلب.

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

تقبل نقطة النهاية forecast.minutes مَعلمات الطلب التالية:

المَعلمة	الوصف	مطلوبة أم اختيارية
location.latitude	إحداثيات خط العرض للموقع الجغرافي المطلوب	مطلوب
location.longitude	تمثّل هذه السمة إحداثيات خط الطول للموقع الجغرافي المطلوب.	مطلوب
unitsSystem	نظام الوحدات المطلوب. تتضمّن القيم ما يلي: UNITS_SYSTEM_UNSPECIFIED IMPERIAL METRIC إذا لم يتم تحديد نظام وحدات، سيتم ضبط الاستجابة تلقائيًا على METRIC.	اختياري
pageSize	تحدّد هذه السمة الحد الأقصى لعدد النتائج التي سيتم عرضها.	اختياري
pageToken	رمز مميّز للصفحة تم تلقّيه من طلب سابق. لاسترداد الصفحة التالية من البيانات، مرِّر pageToken كمَعلمة إدخال في الطلب التالي.	اختياري

لمحة عن الردود المتعلقة بتوقّعات الطقس كل دقيقة

تعرض Weather API الحقول التالية في نص الردّ:

الحقل	الوصف
overallPredictionTimeframe	الإطار الزمني العام للتوقعات
overallPredictionTimeframe.startTime	وقت بدء الإطار الزمني للتوقّعات يمثّل ذلك نقطة المرجع الأولية.
overallPredictionTimeframe.endTime	وقت انتهاء الإطار الزمني للتوقّع يتم ضبط هذا الوقت بعد ست ساعات من وقت البدء.
timeZone	المنطقة الزمنية للموقع الجغرافي المطلوب
segments	شرائح التوقّعات على مستوى الدقيقة، ويُشار إليها بالرمز timeFrame.
segments.timeFrame	الإطار الزمني ذو الصلة بالجزء
segments.timeFrame.startTime	وقت بدء المقطع
segments.timeFrame.endTime	تمثّل هذه السمة وقت انتهاء المقطع.
segments.type	نوع الهطول المتوقّع خلال تلك الفترة تتضمّن القيَم ما يلي: DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED NONE RAIN SNOW HAIL
segments.probability	احتمال هطول الأمطار المتوقّع خلال تلك الفترة القيم هي نسب مئوية تتراوح بين 0 و100.
segments.qpf	التوقّعات الكمية لهطول الأمطار
segments.qpf.quantity	كمية هطول الأمطار المتوقّعة خلال تلك الفترة
segments.qpf.unit	الوحدة المستخدَمة لقياس كمية الهطول المتراكم (على سبيل المثال، MILLIMETERS وINCHES)
segments.snowfallAmount	كمية الثلوج المتوقّعة خلال تلك الفترة
segments.snowfallAmount.quantity	كمية الثلوج المتوقّعة (كمكافئ للمياه السائلة) خلال هذا الجزء
segments.snowfallAmount.unit	وحدة القياس المستخدَمة لقياس كمية الثلوج المتراكمة (مثلاً، MILLIMETERS أو INCHES)
segments.intensity	تمثّل هذه السمة كثافة هطول الأمطار في الشريحة. تتضمّن القيَم ما يلي: PRECIPITATION_INTENSITY_UNSPECIFIED NO_INTENSITY LIGHT MODERATE HEAVY
nextPageToken	رمز مميّز يمكن إرساله كـ pageToken لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

مثال على التوقعات بالدقيقة

يطلب المثال التالي معلومات عن التوقعات الجوية كل دقيقة لموقع جغرافي في ولاية فرجينيا الغربية:

curl -H "Content-Type: application/json" -X GET "https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=37.60451&location.longitude=-80.59044&unitsSystem=METRIC&pageSize=5"

في الردّ، يشير العنصر segments إلى كل جزء من الإطار الزمني العام للتوقّع:

  {
  "overallPredictionTimeframe": {
    "startTime": "2026-05-11T12:10:00Z",
    "endTime": "2026-05-11T18:12:00Z"
  },
  "timeZone": {
    "id": "America/New_York"
  },
  "segments": [
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:20:00Z",
        "endTime": "2026-05-11T12:22:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:22:00Z",
        "endTime": "2026-05-11T12:24:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    ...
  ]
}