دریافت کلید نسخه نمایشی Maps: Weather API را بدون هزینه با کلید نسخه نمایشی Maps امتحان کنید—اطلاعات صورت‌حساب لازم نیست.

‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

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

نقطه پایانی mapTypes کاشی‌های نقشه شطرنجی را ارائه می‌دهد که پدیده‌های آب‌وهوایی مختلفی مثل پیش‌بینی بارش را نشان می‌دهند. این قطعه‌های نقشه را می‌توان روی Google Maps استاندارد قرار داد.

شرایط

این شرایط تحت بخش ۶ (شرایط پیشنهادهای پیش‌از دردسترس عموم) از شرایط ویژه سرویس 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/mapTypes/{map_type}/mapTiles/{zoom}/{x}/{y}

انواع نقشه

Weather API از انواع مختلف نقشه آب‌وهوا پشتیبانی می‌کند که با مدل‌های آب‌وهوایی و مناطق جغرافیایی مختلف مطابقت دارند:

US_PRECIPITATION_CURRENT: پیش‌بینی فوری بارش در ایالات متحده با وضوح بالا.
‫EU_PRECIPITATION_CURRENT: پیش‌بینی هوای حالا با وضوح بالا برای بارش در اروپا.

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

پوشش کاشی‌های نقشه آب‌وهوا

سیستم مختصات کاشی

این میانای برنامه‌سازی کاربردی از سیستم مختصات کاشی استاندارد Web Mercator استفاده می‌کند. برای توضیح جامع درباره مختصات نقشه و کاشی، به کاشی‌های نقشه راه و مختصات نقشه و کاشی مراجعه کنید.

در این سیستم:

‫zoom: سطح بزرگ‌نمایی (۰ تا ۱۶). سطح بزرگ‌نمایی ۰ کل جهان را در یک کاشی نشان می‌دهد (۲^۰ × ۲^۰ = ۱ کاشی). سطح بزرگ‌نمایی z جهان را به شبکه‌ای از کاشی‌های 2^z x 2^z تقسیم می‌کند.
‫x: مختصات X (ستون) کاشی، از ۰ (غربی‌ترین) تا ‫۲^زوم - ۱ (شرقی‌ترین).
‫y: مختصات Y (ردیف) کاشی، از ۰ (شمالی‌ترین) تا ‫۲^{بزرگ‌نمایی} - ۱ (جنوبی‌ترین).

نمایش نقشه آب‌وهوا

برای نمایش این کاشی‌ها در برنامه وب بااستفاده از Google Maps JavaScript API، می‌توانید google.maps.ImageMapType سفارشی ایجاد کنید:

const weatherMapType = new google.maps.ImageMapType({
  getTileUrl: function(coord, zoom) {
    const mapType = "US_PRECIPITATION_CURRENT";
    return `https://weather.googleapis.com/v1/mapTypes/${mapType}/mapTiles/${zoom}/${coord.x}/${coord.y}`;
  },
  tileSize: new google.maps.Size(256, 256),
  maxZoom: 16,
  minZoom: 0,
  name: "Weather"
});

// Overlay on existing map
map.overlayMapTypes.insertAt(0, weatherMapType);

نمونه درخواست نقشه آب‌وهوا

نمونه زیر کاشی‌های نقشه آب‌وهوای بارش ایالات متحده را برای نیواورلئان درخواست می‌کند:

curl -o tile.png -X GET "https://weather.googleapis.com/v1/mapTypes/US_PRECIPITATION_CURRENT/mapTiles/12/1025/1688?key=API_KEY"

پاسخ دودویی است. پوشاننده JSON فقط تحت تنظیمات سریال‌سازی خاصی، مانند ?alt=json، ظاهر می‌شود.