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

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

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

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

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

توجه: پیش‌بینی‌های دقیقه‌ای ممکن است با کاشی‌های نقشه آب‌وهوا همگام‌سازی یا هم‌راستا نباشد.

شرایط

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

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

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

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

جدول ۱.۳.۱ (اجازه‌های ذخیره‌سازی در حافظه نهان)

این اجازه‌ها علاوه‌بر اجازه‌های شرح‌داده‌شده در جدول ۱۷.۲.۱ «شرایط خاص سرویس Google Maps Platform» است.

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

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

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