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

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). Ô vuông 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 ô.

Hình ảnh sau đây cho thấy một bản đồ nhiệt TREE_UPI 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 4x4.

Xem Toạ độ Bản đồ và Ô để biết thêm thông tin chi tiết.

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

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

Bạn phải cung cấp tất cả các thông số được liệt kê dưới đây để 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 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 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ạ độ ô 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 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ạ độ (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 Các loại bản đồ lớp phủ.