دریافت پیش‌بینی دقیقه‌ای (آزمایشی)

نقطه پایانی forecast:minutes پیش‌بینی بارش دقیقه به دقیقه با وضوح بالا (که به آن پیش‌بینی هوای حالا نیز می‌گویند) را برای مکان مشخصی ارائه می‌دهد.

«میانای برنامه‌سازی کاربردی» اطلاعات زیر را برای بازه زمانی ۶ ساعته برمی‌گرداند:

  • زمان شروع و پایان بازه زمانی پیش‌بینی
  • منطقه زمانی مکان درخواستی
  • زمان شروع و پایان هر بخش پیش‌بینی
  • نوع، احتمال، مقدار، و شدت بارش پیش‌بینی‌شده در هر بخش

شرایط

این شرایط تحت «بخش ۶» (شرایط پیشنهاد پیش‌از دردسترس عموم) از شرایط ویژه سرویس پلاتفرم Google Maps، همان‌گونه که بین Google و شما توافق شده است، صادر شده است.

‫۱-۱ الزامات ذکر منبع. اگر «مشتری» از «محتوای Google Maps» از Weather API استفاده کند، باید مطابق با مستندات به Google ارجاع دهد.

‫۱.۲ محدودیت‌ها. مشتریان نمی‌توانند از «محتوای Google Maps» بازیابی‌شده از Weather API برای بازآفرینی سرویس یا محصول Google استفاده کنند (برای نمونه، استفاده از داده‌های بازیابی‌شده از Weather API در برنامه آب‌وهوا یا مدل آب‌وهوایی که هدف اصلی آن ارائه اطلاعات آب‌وهوا است).

‫۱-۳ ذخیره کردن در حافظه نهان. مشتریان می‌توانند به‌طور موقت «محتوای Google Maps» مربوطه را از Weather API برای «دوره ذخیره‌سازی موقت» مربوطه، همان‌طور که در جدول ۱.۳.۱ (اجازه‌های ذخیره‌سازی موقت) شرح داده شده است، ذخیره موقت کنند.

جدول ۱.۳.۱ (اجازه‌های ذخیره‌سازی موقت)

این اجازه‌ها علاوه‌بر اجازه‌های شرح‌داده‌شده در جدول 17.2.1 «شرایط خدمات ویژه سرویس پلاتفرم Google Maps» است.

محتوای Google Maps دوره ذخیره در حافظه نهان
مقادیر پیش‌بینی دقیقه‌ای یک ساعت، که پس‌از آن «مشتری» باید «محتوای Google Maps» ذخیره‌شده در حافظه نهان را حذف کند

درباره درخواست‌های پیش‌بینی دقیق

برای درخواست پیش‌بینی‌های دقیقه‌ای، درخواست HTTP 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 را به‌عنوان پارامتر ورودی در درخواست بعدی ارسال کنید. اختیاری

درباره پاسخ‌های پیش‌بینی دقیقه‌ای

«میانای برنامه‌سازی کاربردی آب‌وهوا» فیلدهای زیر را در بدنه پاسخ برمی‌گرداند:

فیلد شرح
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 احتمال پیش‌بینی‌شده بارش درطول آن بخش. مقادیر به‌صورت درصد و در محدوده ۰ تا ۱۰۰ است.
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"
    },
    ...
  ]
}