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 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 ô:

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

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

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

Ô 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:

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

Bạn phải cung cấp tất cả các tham số yêu cầu trong một yêu cầu:

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

  • 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:

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

Ô này 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 Các loại bản đồ lớp phủ.