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

Giới thiệu về ô 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 các thẻ thông tin, với mỗi toạ độ (X,Y) được chỉ đị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 kích thước hoặc kích thước nhỏ của nội dung trên bản đồ xuất hiện trong khung hiển thị bản đồ. Kích thước lưới thẻ thông tin được xác định bằng cách chia tỷ lệ 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 là 2, bản đồ thế giới được biểu diễn 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 với mức thu phóng là 2, cùng với toạ độ của từng thẻ thông tin:

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

Xem Tọa độ bản đồ và ô để biết thêm thông tin chi tiết.

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

Một thẻ thông tin bản đồ 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 các ô bản đồ nhiệt chất lượng không khí hiện tại qua đ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 có tất cả tham số yêu cầu trong yêu cầu:

  • TYPE – Bản đồ nhiệt cho kiểu 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 hoặc kích thước của nội dung của 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 thẻ thông tin.

  • X,Y – Toạ độ của thẻ thông tin cần truy xuất, so với góc phía Tây Bắc (0,0). Giá trị X đang tăng từ Tây sang Đông và giá trị Y đang tăng từ Bắc sang Nam.

    Toạ độ ô phải hợp lệ đối với mức thu phóng được chỉ định. Ví dụ: nếu bạn đặt mức thu phóng thành 2 và yêu cầu thẻ thông tin tại toạ độ 10,10, thì API sẽ trả về một 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 để 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 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

Ô này sẽ có dạng:

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

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