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

نقطه پایانی heatmapTiles نقشه های حرارتی مرتبط با کیفیت هوا را از طریق پوشش کاشی ارائه می دهد. پوشش کاشی مجموعه ای از کاشی های تصویر PNG است که می تواند در بالای نقشه گوگل نمایش داده شود. هر کاشی تصویر (256 x 256 پیکسل) است.

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

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

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

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

به عنوان مثال، در سطح زوم 2، نقشه جهان با استفاده از یک ماتریس 4 در 4، در مجموع 16 کاشی نشان داده می شود. زوم همچنین تعیین می کند که حداکثر مقدار مجاز برای مختصات چقدر است.

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

یک نقشه حرارتی از کل جهان به عنوان یک شبکه 4 در 4.

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

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

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

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

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

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

  • Z - سطح زوم که تعیین می کند محتوای یک نقشه چقدر بزرگ یا کوچک در نمای نقشه ظاهر می شود. مقادیر مجاز 0-16 هستند، که در آن مقدار 0 کل جهان را در یک کاشی نمایش می دهد.

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

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

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

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

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

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

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

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

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