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ủ thẻ thông tin. 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 thẻ thông tin hình ảnh có kích thước 256 x 256 pixel.

Lớp phủ xếp kề là một lưới được tập hợp từ một tập hợp các thẻ thông tin, mỗi thẻ được chỉ định tọa độ (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, trong khi 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 ô.

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 2.

Bản đồ 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.

Bạn có thể yêu cầu các thẻ thông tin 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 của biểu đồ nhiệt

Tất cả các thông 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 sẽ trả về. Xem các giá trị được phép.
  • Z: Cấp độ 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 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 ô tại toạ độ (10,10), thì API sẽ trả về một 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 tọa độ 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ạ độ (2,1):

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

Thẻ thông tin sẽ xuất hiện dưới dạng hình ảnh có thể phủ lên bản đồ:

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

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