Bản đồ nhiệt

Đ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 lớp phủ ô. Lớp phủ xếp kề là một tập hợp các ô hình ảnh PNG có thể hiển thị trên Google Maps. Mỗi ô hình ảnh có kích thước 256 x 256 pixel.

Giới thiệu về thẻ thông tin bản đồ nhiệt

Lớp phủ xếp kề là một lưới được tập hợp từ một tập hợp các ô, mỗi ô được gán toạ độ (X,Y). Mảnh có toạ độ (0,0) luôn nằm ở góc tây bắc của bản đồ. Giá trị X tăng từ tây sang đông, trong khi giá trị Y tăng từ bắc xuống nam.

zoom level xác định mức độ lớn hay nhỏ của nội dung bản đồ xuất hiện trong chế độ xem bản đồ. Kích thước lưới ô được xác định bằng cách điều chỉnh 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, với tổng cộng 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 ô:

Bản đồ nhiệt của toàn thế giới dưới dạng lưới 4 x 4.

Hãy xem phần Toạ độ bản đồ và tọa độ ô vuông để biết thêm thông tin chi tiết.

Giới thiệu về điểm cuối của bản đồ nhiệt

Một ô bản đồ 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 GET HTTP đến:

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

Tất cả tham số yêu cầu đều bắt buộc trong một yêu cầu:

  • TYPE – Loại bản đồ nhiệt cần trả về. Xem các giá trị được cho phép.

  • Z – Mức thu phóng xác định mức độ lớn hay nhỏ của nội dung trên bản đồ xuất hiện trong chế độ xem bản đồ. Chỉ cho phép các giá trị từ 0 đến 16, trong đó giá trị 0 sẽ 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 dần từ tây sang đông và giá trị Y tăng dần từ bắc xuống nam.

    Tọa độ ô vuông 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 giúp 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 bài viết 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 có mức thu phóng là 2, cùng với toạ độ của mỗi ô. Ví dụ sau đây sử dụng điểm cuối heatmapTiles để yêu cầu ô tại toạ độ 0,1 từ bản đồ nhiệt:

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

Thẻ thông tin sẽ xuất hiện như sau:

Một ô bản đồ nhiệt tại toạ độ 0,1.

Để biết thêm thông tin về cách phủ các ô lên trên bản đồ mặc định, hãy xem phần Loại bản đồ lớp phủ.