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

نقطه پایانی heatmapTiles از طریق پوشش کاشی، نقشه‌های حرارتی مرتبط با گرده را ارائه می‌دهد. پوشش کاشی مجموعه‌ای از کاشی‌های تصویری است که می‌توانند در بالای نقشه‌های گوگل نمایش داده شوند. هر کاشی تصویری ۲۵۶ در ۲۵۶ پیکسل است.

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

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

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

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

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

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

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

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

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

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

تمام پارامترهای ذکر شده در زیر برای یک درخواست موفق ضروری هستند:

  • KEY : کلید API برنامه شما. این کلید، برنامه شما را برای اهداف مدیریت سهمیه شناسایی می‌کند. نحوه دریافت کلید را بیاموزید.
  • TYPE : نوع نقشه حرارتی که باید برگردانده شود. مقادیر مجاز را ببینید.
  • Z : سطح بزرگنمایی که میزان بزرگ یا کوچک بودن محتویات نقشه را در نمای نقشه تعیین می‌کند. مقادیر مجاز از ۰ تا ۱۶ هستند، که مقدار ۰ کل جهان را در یک کاشی واحد نمایش می‌دهد.
  • X ، Y : مختصات کاشی نسبت به گوشه شمال شرقی (0،0) است. مقادیر X از غرب به شرق و مقادیر Y از شمال به جنوب افزایش می‌یابند. مختصات باید برای سطح بزرگنمایی مشخص شده معتبر باشند. به عنوان مثال، اگر سطح بزرگنمایی را روی 2 تنظیم کنید و یک کاشی در مختصات (10،10) درخواست کنید، API خطا برمی‌گرداند.

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

تصویر بالا یک نقشه حرارتی TREE_UPI با سطح بزرگنمایی ۲ را به همراه مختصات هر کاشی نشان می‌دهد. مثال زیر از نقطه پایانی heatmapTiles برای درخواست کاشی در مختصات (۲،۱) استفاده می‌کند:

https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY

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

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

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