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

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

رونهاد کاشی جدولی است که از مجموعه‌ای از کاشی‌ها تشکیل شده است و به هرکدام مختصات (X،‏ Y) اختصاص داده شده است. کاشی با مختصات (۰،۰) همیشه در گوشه شمال غربی نقشه قرار دارد. مقادیر 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: مختصات کاشی نسبت‌به گوشه شمال شرقی (۰،۰). ‫Xمقادیر از غرب به شرق افزایش می‌یابد و Y مقادیر از شمال به جنوب افزایش می‌یابد. مختصات باید برای سطح بزرگ‌نمایی مشخص‌شده معتبر باشد. برای مثال، اگر سطح بزرگ‌نمایی را روی ۲ تنظیم کنید و کاشی‌ای را در مختصات (۱۰،۱۰) درخواست کنید، API خطا برمی‌گرداند.

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

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

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

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

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

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