نقطه پایانی HeatmapTiles نقشه های حرارتی مرتبط با گرده را از طریق پوشش کاشی ارائه می دهد. پوشش کاشی مجموعه ای از کاشی های تصویری است که می تواند در بالای نقشه های گوگل نمایش داده شود. هر کاشی تصویر 256 در 256 پیکسل است.
روکش کاشی شبکه ای است که از مجموعه ای از کاشی ها مونتاژ شده است که به هر کدام مختصات ( X
, Y
) اختصاص داده شده است. کاشی با مختصات (0,0) همیشه در گوشه شمال غربی نقشه است. مقادیر X
از غرب به شرق افزایش می یابد، در حالی که مقادیر Y
از شمال به جنوب افزایش می یابد.
zoom level
تعیین می کند که محتوای یک نقشه چقدر بزرگ یا کوچک در نمای نقشه ظاهر شود. اندازه شبکه کاشی با مقیاس بندی مختصات X
و Y
به صورت نمایی بر اساس سطح بزرگنمایی تعیین می شود.
gridSizeX = XzoomLevel gridSizeY = YzoomLevel
به عنوان مثال، در سطح زوم 2، نقشه جهان با استفاده از یک ماتریس 4 در 4، در مجموع 16 کاشی نشان داده می شود.
تصویر زیر یک نقشه حرارتی TREE_UPI
از کل جهان را نشان میدهد که به کاشیهایی تقسیم شده است که در سطح زوم 2 قابل دسترسی است.
برای جزئیات بیشتر ، مختصات نقشه و کاشی را ببینید.
میتوانید با استفاده از نقطه پایانی HeatmapTiles با ارسال یک درخواست HTTP GET، کاشیهای نقشه حرارتی گرده فعلی را درخواست کنید:
https://pollen.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY
درباره نقطه پایانی نقشه حرارتی
تمام پارامترهای ذکر شده در زیر برای درخواست موفقیت آمیز مورد نیاز است:
-
KEY
: کلید API برنامه شما. این کلید درخواست شما را برای اهداف مدیریت سهمیه شناسایی می کند. نحوه گرفتن کلید را بیاموزید. -
TYPE
: نوع نقشه حرارتی برای بازگشت. مقادیر مجاز را ببینید. -
Z
: سطح زوم که تعیین می کند محتوای یک نقشه چقدر بزرگ یا کوچک در نمای نقشه ظاهر شود. مقادیر مجاز 0-16 هستند، که در آن مقدار 0 کل جهان را در یک کاشی نمایش می دهد. -
X
,Y
: مختصات کاشی نسبتاً به گوشه شمال شرقی (0,0). مقادیرX
از غرب به شرق و مقادیرY
از شمال به جنوب افزایش می یابد. مختصات باید برای سطح بزرگنمایی مشخص شده معتبر باشند. به عنوان مثال، اگر سطح زوم را روی 2 تنظیم کنید و یک کاشی را در مختصات (10،10) درخواست کنید، API یک خطا برمیگرداند.
نمونه درخواست نقشه حرارتی
تصویر بالا یک نقشه حرارتی TREE_UPI
را با سطح زوم 2 به همراه مختصات هر کاشی نشان می دهد. مثال زیر از نقطه پایانی heatmapTiles
برای درخواست کاشی در مختصات (2،1) استفاده می کند:
https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY
کاشی به عنوان تصویری ظاهر می شود که می تواند روی نقشه قرار گیرد:
برای اطلاعات بیشتر در مورد همپوشانی کاشیها در بالای نقشه پیشفرض، به انواع نقشههای همپوشانی مراجعه کنید.