Bản đồ nhiệt

Chiến lược phát hành đĩa đơn heatmapTiles điểm cuối 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ủ ô. Thẻ thông tin lớp phủ là một tập hợp các ô hình ảnh PNG có thể được 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ề thẻ thông tin bản đồ nhiệt

Lớp phủ ô là một lưới được ghép từ một tập hợp các ô, từng toạ độ được chỉ định (X,Y). Ô có toạ độ (0,0) luôn ở 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 độ lớn hay nhỏ của nội dung bản đồ xuất hiện trong một chế độ xem bản đồ. Kích thước lưới ô được xác định bằng cách điều chỉnh theo tỷ lệ X và Y phối hợp theo cấp số nhân theo mức thu phóng.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Ví dụ: ở mức thu phóng bằng 2, bản đồ thế giới được thể hiện bằng tỷ lệ 4 x 4 ma trận, tổng cộng 16 thẻ thông tin. Mức thu phóng cũng xác định giá trị tối đa được phép đối với toạ độ.

Hình ảnh sau đây hiển thị bản đồ nhiệt US_AQI với mức thu phóng là 2, cùng với toạ độ của mỗi thẻ thông tin:

Bản đồ nhiệt về toàn bộ thế giới ở dạng lưới 4 x 4.

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

Giới thiệu về điểm cuối bản đồ nhiệ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 PNG hình ảnh. Bạn yêu cầu các lát bản đồ nhiệt hiện tại về chất lượng không khí bằng cách sử dụng heatmapTiles bằng cách gửi yêu cầu HTTP GET tới:

https://airquality.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY

Tất cả thông số yêu cầu đều phải có trong một yêu cầu:

  • TYPE – Bản đồ nhiệt kiểu cần trả về. Xem được phép giá trị.

  • Z – Mức thu phóng xác định độ 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 sẽ hiển thị cả thế giới trong một thẻ thông tin duy nhất.

  • X,Y – Toạ độ của ô cần truy xuất, so với hướng bắc góc phía tây (0,0). Các giá trị của X đang tăng từ tây sang đông và Y đang tăng lên từ bắc xuống nam.

    Toạ độ ô phải hợp lệ 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 10,10 thì API sẽ trả về lỗi.

  • YOUR_API_KEY – Khoá API của ứng dụng của bạn. Khoá này xác định cho mục đích quản lý hạn mức. Để biết thêm thông tin, hãy xem tải một khoá.

Ví dụ về yêu cầu bản đồ nhiệt

Hình ảnh trên hiển thị 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 phương thức Đ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ẽ xuất hiện như sau:

Thẻ thông tin bản đồ nhiệt có toạ độ 0,1.

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