Điểm cuối heatmapTiles 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ủ ô. Lớp phủ ô là một tập hợp các ô hình ảnh PNG có thể 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ủ 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, mỗi 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 kích thước lớn hoặc nhỏ của nội dung bản đồ xuất hiện trong chế độ xem bản đồ. Kích thước lưới ô được xác định bằng cách điều chỉnh tỷ lệ 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, với tổng cộng 16 ô. Mức thu phóng cũng xác định giá trị tối đa được phép cho toạ độ.
Hình ảnh sau đây cho thấy 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:
Xem phần Tọa độ bản đồ và Thẻ thông tin để biết thêm thông tin 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 hình ảnh PNG. Bạn yêu cầu các thẻ thông tin bản đồ nhiệt hiện tại về chất lượng không khí thông qua điểm cuối 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ề. Hãy 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 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ạ độ của thẻ thông tin cần truy xuất, so với góc Tây Bắc (0,0). Các giá trịXđang tăng từ tây sang đông và giá trịYtăng 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 toạ độ là 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 ứng dụng của bạn cho mục đích quản lý hạn mức. Để biết thêm thông tin, hãy xem phần lấy khoá.
Ví dụ về yêu cầu bản đồ nhiệt
Hình ảnh trên cho thấy bản đồ nhiệt US_AQI có mức thu phóng là 2, cùng với toạ độ của mỗi 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ạ độ 0,1 qua 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:
Để biết thêm thông tin về việc phủ thẻ thông tin lên bản đồ mặc định, hãy xem phần Các loại bản đồ lớp phủ.