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

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

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

شرایط

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

انواع نقشه

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

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

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

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

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

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

در این سیستم:

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

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

برای نمایش این کاشی‌ها در برنامه وب بااستفاده از 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، ظاهر می‌شود.