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

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

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

شرایط

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

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

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

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

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

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

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

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

برای درخواست نقشه‌های آب و هوا، یک درخواست HTTP GET به آدرس زیر ارسال کنید:

https://weather.googleapis.com/v1/mapTypes/{map_type}/mapTiles/{zoom}/{x}/{y}

انواع نقشه

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

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

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

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

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

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

در این سیستم:

zoom : سطح زوم (0 تا 16). سطح زوم 0 کل جهان را در یک کاشی واحد نشان می‌دهد ( ²⁰ x ²⁰ = 1 کاشی). سطح زوم z جهان را به شبکه‌ای از کاشی‌های 2 ^z x 2 ^z تقسیم می‌کند.
x : مختصات X (ستون) کاشی، که از ۰ (غربی‌ترین) تا ۲ ^(زوم - ۱ (شرقی‌ترین) متغیر است.
y : مختصات Y (ردیف) کاشی، که از ۰ (شمالی‌ترین) تا ۲ ^(زوم - ۱ (جنوبی‌ترین) متغیر است.

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

برای نمایش این کاشی‌ها در یک برنامه وب با استفاده از 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 wrapper فقط تحت تنظیمات سریال‌سازی خاص، مانند ?alt=json ، ظاهر می‌شود.