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

نقطه پایانی HeatmapTiles نقشه های حرارتی مرتبط با گرده را از طریق پوشش کاشی ارائه می دهد. پوشش کاشی مجموعه ای از کاشی های تصویری است که می تواند در بالای نقشه های گوگل نمایش داده شود. هر کاشی تصویر 256 در 256 پیکسل است.

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

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

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

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

تصویر زیر یک نقشه حرارتی TREE_UPI از کل جهان را نشان می‌دهد که به کاشی‌هایی تقسیم شده است که در سطح زوم 2 قابل دسترسی است.

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

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

می‌توانید با استفاده از نقطه پایانی 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

کاشی به عنوان تصویری ظاهر می شود که می تواند روی نقشه قرار گیرد:

نمونه ای از کاشی نقشه حرارتی با استفاده از نقشه TREE_UPI.

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