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

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

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

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

The zoom level determines how large or small the contents of a map appear in a map view. The tile grid size is determined by scaling the X and Y coordinates exponentially by the zoom level.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

For example, at a zoom level of 2, the world map is represented using a 4 x 4 matrix, for a total of 16 tiles. The zoom also determines what is the max value allowed for the coordinates.

The following image shows a US_AQI heatmap with a zoom level of 2, along with the coordinates of each tile:

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

See Map and Tile coordinates for additional details.

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

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

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

All request parameters are required in a request:

  • TYPE - The type heatmap to return. See allowed values .

  • Z - Zoom level that determines how large or small the contents of a map appear in a map view. Allowed values are 0-16, where a value of 0 displays the entire world in a single tile.

  • X , Y - The coordinates of the tile to retrieve, relative to the north west corner (0,0). X values are increasing from west to east and Y values are increasing from north to south.

    Tile coordinates have to be valid for the specified zoom level. For example, if you set the zoom level to 2, and request a tile at coordinates of 10,10, the API returns an error.

  • YOUR_API_KEY - Your application's API key. This key identifies your application for purposes of quota management. For more information, see get a key .

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

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

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

The tile appears as:

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

For more information on overlaying tiles on top of the default map, see Overlay Map Types .