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ị ở đầu Google Maps. Mỗi thẻ thông tin hình ảnh có kích thước 256 x 256 pixel.

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 ở góc phía 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 ô.

Hình ảnh sau đây hiển thị bản đồ nhiệt TREE_UPI của toàn bộ thế giới, được chia thành các thẻ thông tin có thể truy cập được ở 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 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 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 bản đồ nhiệt

Tất cả các thông số được liệt kê bên dưới là 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 để 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 mức độ lớn hoặc nhỏ của nội dung trên 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ạ độ ô này tương đối với góc phía đông bắc (0,0). Giá trị X tăng từ Tây sang Đông và giá trị Y tăng từ Bắc sang Nam. Toạ độ phải hợp lệ đối với 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 thẻ thông tin 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 bản đồ nhiệt TREE_UPI 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ạ độ (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ể xếp chồng 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ề 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ủ.