Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Điểm cuối heatmapTiles cung cấp bản đồ nhiệt liên quan đến chất lượng không khí thông qua một lớp phủ ô. Lớp phủ dạng ô là một tập hợp các ô hình ảnh PNG có thể xuất hiện ở trên cùng của Google Maps. Mỗi ô hình ảnh có kích thước 256 x 256 pixel.
Giới thiệu về thẻ bản đồ nhiệt
Lớp phủ ô vuông là một lưới được tạo thành từ một tập hợp các ô vuông, mỗi ô vuông được chỉ định toạ độ (X,Y).
Ô có toạ độ (0,0) luôn nằm ở góc tây bắc của bản đồ. Các giá trị X tăng từ tây sang đông, trong khi các giá trị Y tăng từ bắc xuống nam.
zoom level xác định nội dung của bản đồ xuất hiện lớn hay nhỏ trong một khung hiển thị bản đồ. Kích thước lưới ô được xác định bằng cách mở rộng quy mô các toạ độ X và Y theo cấp số nhân theo mức thu phóng.
gridSizeX = XzoomLevel
gridSizeY = YzoomLevel
Ví dụ: ở mức thu phóng 2, bản đồ thế giới được biểu thị bằng ma trận 4 x 4, tổng cộng là 16 ô. Mức thu phóng cũng xác định giá trị tối đa được phép cho toạ độ.
Hình ảnh sau đây cho thấy một bản đồ nhiệt US_AQI có mức thu phóng là 2, cùng với toạ độ của từng ô:
Ô biểu đồ nhiệt được biểu thị bằng một mảng byte chứa dữ liệu ô dưới dạng hình ảnh PNG. Bạn yêu cầu các ô bản đồ nhiệt về chất lượng không khí hiện tại bằng cách sử dụng điểm cuối heatmapTiles bằng cách gửi yêu cầu HTTP GET đến:
Z – Mức thu phóng xác định kích thước nội dung của bản đồ xuất hiện trong một khung hiển thị bản đồ. Các giá trị được phép là 0-16, trong đó giá trị 0 hiển thị toàn bộ thế giới trong một ô duy nhất.
X,Y – Toạ độ của ô cần truy xuất, tương ứng với góc tây bắc (0,0). Giá trị X tăng từ tây sang đông và giá trị Y tăng từ bắc xuống nam.
Toạ độ ô phải hợp lệ cho mức thu phóng đã chỉ định.
Ví dụ: nếu bạn đặt mức thu phóng thành 2 và yêu cầu một ô ở toạ độ 10,10, thì API sẽ trả về lỗi.
YOUR_API_KEY – Khoá API của ứng dụng. Khoá này xác định ứng dụng của bạn cho mục đích quản lý hạn mức. Để biết thêm thông tin, hãy xem phần lấy khoá.
Ví dụ về yêu cầu bản đồ nhiệt
Hình ảnh ở trên cho thấy một bản đồ nhiệt US_AQI với mức thu phóng là 2, cùng với toạ độ của từng ô. Ví dụ sau đây sử dụng điểm cuối heatmapTiles để yêu cầu ô ở toạ độ 0,1 từ bản đồ nhiệt:
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-08-31 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eheatmapTiles\u003c/code\u003e endpoint delivers air quality heatmaps as a tile overlay, which is a collection of PNG images displayed on top of a Google Map.\u003c/p\u003e\n"],["\u003cp\u003eEach tile within the overlay has specific (X, Y) coordinates, with (0,0) at the northwest corner and increasing values eastward (X) and southward (Y), determined by the zoom level.\u003c/p\u003e\n"],["\u003cp\u003eThe zoom level (0-16) controls the map's scale and the tile grid size, with higher zoom levels showing more detailed areas.\u003c/p\u003e\n"],["\u003cp\u003eTo request a heatmap tile, you need to provide the heatmap type, zoom level (Z), tile coordinates (X, Y), and your API key in the request URL.\u003c/p\u003e\n"],["\u003cp\u003eYou can overlay these heatmap tiles on top of the default map using methods described in the provided documentation for a comprehensive air quality visualization.\u003c/p\u003e\n"]]],[],null,["The\n[`heatmapTiles`](/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile)\nendpoint provides air quality related heatmaps through a tile overlay. A tile\noverlay is a collection of PNG image tiles that can be displayed on top of a\nGoogle Maps. Each image tile is (256 x 256 pixels).\n\nAbout heatmap tiles\n\nThe tile overlay is a grid assembled from a collection of tiles,\neach assigned (`X`,`Y`) coordinates.\nThe tile with coordinates (0,0) is always at the northwest corner\nof the map. The `X` values increase from west to east,\nwhile the `Y` values increase from north to south.\n\nThe `zoom level` determines how large or small the contents of a map appear in a\nmap view. The tile grid size is determined by scaling the `X` and `Y`\ncoordinates exponentially by the zoom level. \n\n```text\ngridSizeX = XzoomLevel\ngridSizeY = YzoomLevel\n```\n\nFor example, at a zoom level of 2, the world map is represented using a 4 x 4\nmatrix, for a total of 16 tiles. The zoom also determines what is the max value\nallowed for the coordinates.\n\nThe following image shows a `US_AQI` heatmap with a zoom level of 2,\nalong with the coordinates of each tile:\n\nSee [Map and Tile coordinates](/maps/documentation/javascript/coordinates)\nfor additional details.\n\nAbout the heatmap endpoint\n\nA heatmap tile is represented by a bytes array containing the tile data as a PNG\nimage. You request current air quality heatmap tiles using the\n[`heatmapTiles`](/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile)\nendpoint by sending an HTTP GET request to: \n\n```html\nhttps://airquality.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY\n```\n\nAll request parameters are required in a request:\n\n- `TYPE` - The type heatmap to return. See [allowed\n values](/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile#maptype).\n\n- `Z` - Zoom level that determines how large or small the contents of a map\n appear in a map view. Allowed values are 0-16, where a value of 0 displays\n the entire world in a single tile.\n\n- `X`,`Y` - The coordinates of the tile to retrieve, relative to the north\n west corner (0,0). `X` values are increasing from west to east and `Y`\n values are increasing from north to south.\n\n Tile coordinates have to be valid for the specified zoom level.\n For example, if you set the zoom level to 2, and request a tile at\n coordinates of 10,10, the API returns an error.\n- `YOUR_API_KEY` - Your application's API key. This key identifies your\n application for purposes of quota management. For more information, see [get\n a key](/maps/documentation/air-quality/get-api-key).\n\nExample heatmap request\n\nThe image above shows a `US_AQI` heatmap with a zoom level of 2,\nalong with the coordinates of each tile. The following example uses the\n`heatmapTiles` endpoint to request the tile at coordinates 0,1 from the\nheatmap: \n\n```html\nhttps://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY\n```\n\nThe tile appears as:\n\nFor more information on overlaying tiles on top of the default map, see\n[Overlay Map Types](/maps/documentation/javascript/examples/maptype-overlay)."]]
