نقشه‌های حرارتی

نقطه پایانی heatmapTiles نقشه‌های حرارتی مربوط به کیفیت هوا را ازطریق هم‌پوشانی کاشی ارائه می‌دهد. رونهاد کاشی مجموعه‌ای از کاشی‌های تصویر PNG است که می‌تواند روی Google Maps نمایش داده شود. هر کاشی تصویر (۲۵۶ × ۲۵۶ پیکسل) است.

درباره کاشی‌های نقشه حرارتی

رونهاد کاشی جدولی است که از مجموعه‌ای از کاشی‌ها تشکیل شده است، که به هرکدام مختصات (X،‏Y) اختصاص داده شده است. کاشی با مختصات (0,0) همیشه در گوشه شمال غربی نقشه قرار دارد. مقادیر X از غرب به شرق افزایش می‌یابد، درحالی‌که مقادیر Y از شمال به جنوب افزایش می‌یابد.

zoom level تعیین می‌کند که محتوای نقشه در نمای نقشه چقدر بزرگ یا کوچک نشان داده شود. اندازه شبکه کاشی با مقیاس‌بندی مختصات X و Y به‌صورت نمایی براساس سطح بزرگ‌نمایی تعیین می‌شود.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

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

تصویر زیر نقشه حرارتی US_AQI را با سطح بزرگ‌نمایی ۲، همراه با مختصات هر کاشی نشان می‌دهد:

نقشه حرارتی کل جهان به‌صورت یک شبکه ۴ در ۴.

برای جزئیات بیشتر، مختصات نقشه و کاشی را ببینید.

درباره نقطه پایان نقشه حرارتی

کاشی نقشه حرارتی با آرایه بایت حاوی داده‌های کاشی به‌صورت تصویر PNG نشان داده می‌شود. با ارسال درخواست HTTP GET به نشانی زیر، کاشی‌های نقشه حرارتی کیفیت هوای فعلی را بااستفاده از نقطه پایانی heatmapTiles درخواست می‌کنید:

https://airquality.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY

همه پارامترهای درخواست در درخواست الزامی است:

  • TYPE - نوع نقشه حرارتی برای برگرداندن. مقادیر مجاز را ببینید.

  • Z - سطح بزرگ‌نمایی که تعیین می‌کند محتوای نقشه در نمای نقشه چقدر بزرگ یا کوچک نشان داده شود. مقادیر مجاز ۰ تا ۱۶ است، که مقدار ۰ کل جهان را در یک کاشی نمایش می‌دهد.

  • X،Y - مختصات کاشی برای بازیابی، نسبت به گوشه شمال غربی (0,0). مقادیر X از غرب به شرق افزایش می‌یابد و مقادیر Y از شمال به جنوب افزایش می‌یابد.

    مختصات کاشی باید برای سطح بزرگ‌نمایی مشخص‌شده معتبر باشد. برای مثال، اگر سطح بزرگ‌نمایی را روی ۲ تنظیم کنید و کاشی‌ای را در مختصات ۱۰،۱۰ درخواست کنید، API خطا برمی‌گرداند.

  • YOUR_API_KEY - کلید میانای برنامه‌سازی کاربردی برنامه شما. این کلید برنامه شما را برای اهداف مدیریت سهمیه شناسایی می‌کند. برای اطلاعات بیشتر، به دریافت کلید مراجعه کنید.

درخواست نقشه حرارتی نمونه

تصویر بالا نقشه حرارتی US_AQI را با سطح بزرگ‌نمایی ۲ به‌همراه مختصات هر کاشی نشان می‌دهد. مثال زیر از نقطه پایانی heatmapTiles برای درخواست کاشی در مختصات 0,1 از نقشه حرارتی استفاده می‌کند:

https://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY

کاشی به‌صورت زیر نشان داده می‌شود:

کاشی نقشه حرارتی در مختصات ۰،۱.

برای اطلاعات بیشتر درباره هم‌پوشانی کاشی‌ها روی نقشه پیش‌فرض، انواع نقشه هم‌پوشانی را ببینید.