این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

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

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

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

شرایط

این شرایط تحت بخش 6 (شرایط پیشنهادهای قبل از GA) از شرایط خاص سرویس پلتفرم نقشه‌های گوگل ، طبق توافق گوگل و شما، صادر شده‌اند.

۱.۱ الزامات انتساب. اگر مشتری از محتوای نقشه‌های گوگل از API آب و هوا استفاده می‌کند، باید انتساب را مطابق با مستندات به گوگل ارائه دهد.

۱.۲ محدودیت‌ها. مشتریان نمی‌توانند از محتوای نقشه‌های گوگل که از Weather API بازیابی شده‌اند برای ایجاد مجدد یک سرویس یا محصول گوگل استفاده کنند (مثلاً از داده‌های بازیابی شده از Weather API در یک برنامه آب و هوا یا مدل آب و هوا که هدف اصلی آن ارائه اطلاعات آب و هوا است، استفاده کنند).

۱.۳ ذخیره‌سازی. مشتریان می‌توانند محتوای نقشه‌های گوگل مربوط به Weather API را به طور موقت برای دوره ذخیره‌سازی مربوطه، همانطور که در جدول ۱.۳.۱ (مجوزهای ذخیره‌سازی) توضیح داده شده است، ذخیره‌سازی کنند.

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

این مجوزها علاوه بر مواردی است که در جدول ۱۷.۲.۱ از شرایط خاص سرویس پلتفرم نقشه‌های گوگل شرح داده شده است.

محتوای نقشه گوگل	دوره ذخیره سازی
مقادیر پیش‌بینی دقیقه‌ای	یک ساعت، پس از آن مشتری باید محتوای ذخیره شده نقشه‌های گوگل را حذف کند

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

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

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

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"
    },
    ...
  ]
}