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ủ thẻ thông tin. Lớp phủ dạng ô 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ủ thẻ thông tin là một lưới được tập hợp từ một tập hợp thẻ thông tin, mỗi thẻ được chỉ định toạ độ (X,Y). Thẻ thông tin 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, còn các giá trị Y tăng từ bắc xuống nam.

zoom level xác định kích thướ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 thẻ thông tin được xác định bằng cách điều chỉnh theo tỷ lệ to nhỏ các toạ độ X và Y theo cấp 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 16 ô. Độ thu phóng cũng xác định giá trị tối đa được phép cho các toạ độ.

Hình ảnh sau đây 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 thẻ thông tin:

Biểu đồ nhiệt của toàn bộ 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

Thẻ thông tin biểu đồ nhiệt được biểu thị bằng một mảng byte chứa dữ liệu thẻ thông tin dưới dạng hình ảnh PNG. Bạn yêu cầu thẻ thông tin 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

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 sẽ trả về. Xem các giá trị được phép.

  • Z – Mức thu phóng xác định kích thước lớn hay nhỏ của nội dung bản đồ xuất hiện trong chế độ xem 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 ô.

  • X,Y – Toạ độ của thẻ thông tin cần truy xuất, so với góc bắc-tây (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 ô tại 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 thẻ thông tin. Ví dụ sau đây sử dụng điểm cuối heatmapTiles để yêu cầu thẻ thông tin 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:

Thẻ thông tin bản đồ nhiệt tại toạ độ 0,1.

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