Bản đồ nhiệt

Điểm cuối heatmapTiles cung cấp bản đồ nhiệt liên quan đến phấn hoa thông qua lớp phủ xếp kề. Lớp phủ ô là một tập hợp các ô hình ảnh có thể hiển thị trên Google Maps. Mỗi ô hình ảnh có kích thước 256 x 256 pixel.

Lớp phủ ô là một lưới được tạo thành từ một tập hợp các ô, mỗi ô được chỉ định 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 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 đ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, tổng cộng là 16 ô.

Hình ảnh sau đây cho thấy TREE_UPI bản đồ nhiệt của toàn thế giới, được chia thành các ô có thể truy cập ở mức thu phóng là 2.

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

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

Bạn có thể yêu cầu các ô bản đồ nhiệt Phấn hoa 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://pollen.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY

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

Tất cả các tham số được liệt kê dưới đây đều bắt buộc để yêu cầu thành công:

  • 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. Tìm hiểu cách lấy khoá.
  • 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 nội dung của bản đồ xuất hiện lớn hay nhỏ trong một khung hiển thị 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: Tọa độ ô vuông tương ứng với góc đông 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.

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 TREE_UPI có 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ạ độ (2,1):

https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY

Ô này xuất hiện dưới dạng một hình ảnh có thể được phủ lên bản đồ:

Ví dụ về một ô bản đồ nhiệt sử dụng bản đồ TREE_UPI.

Để 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ủ.