Điểm cuối mapTypes cung cấp các ô bản đồ raster đại diện cho nhiều hiện tượng thời tiết, chẳng hạn như dự báo lượng mưa. Bạn có thể phủ các ô bản đồ này lên Google Maps tiêu chuẩn.
Điều khoản
Các điều khoản này được ban hành theo Mục 6 (Điều khoản dành cho sản phẩm ở giai đoạn trước khi phát hành rộng rãi) trong Điều khoản riêng dành cho dịch vụ của Nền tảng Google Maps, theo thoả thuận giữa Google và bạn.
1.1 Yêu cầu về việc ghi công. Khách hàng phải ghi công cho Google theo đúng Tài liệu nếu Khách hàng sử dụng Nội dung trên Google Maps từ Weather API.
1.2 Các hạn chế. Khách hàng không thể sử dụng Nội dung trên Google Maps được truy xuất từ Weather API để tạo lại một dịch vụ hoặc sản phẩm của Google (ví dụ: sử dụng dữ liệu được truy xuất từ Weather API trong một ứng dụng thời tiết hoặc mô hình thời tiết có mục đích chính là cung cấp thông tin thời tiết).
1.3 Lưu vào bộ nhớ đệm. Khách hàng có thể tạm thời lưu vào bộ nhớ đệm Nội dung trên Google Maps áp dụng từ Weather API trong Khoảng thời gian lưu vào bộ nhớ đệm áp dụng, như mô tả trong Bảng 1.3.1 (Quyền lưu vào bộ nhớ đệm).
Bảng 1.3.1 (Quyền lưu vào bộ nhớ đệm)
Các quyền này bổ sung cho những quyền được mô tả trong Bảng 17.2.1 của Điều khoản riêng dành cho dịch vụ của Nền tảng Google Maps.
| Nội dung trên Google Maps | Khoảng thời gian lưu vào bộ nhớ đệm |
|---|---|
| Ô bản đồ thời tiết | Một giờ, sau đó Khách hàng phải xoá Nội dung trên Google Maps đã lưu vào bộ nhớ đệm |
Giới thiệu về yêu cầu bản đồ thời tiết
Để yêu cầu bản đồ thời tiết, hãy gửi yêu cầu GET HTTP đến:
https://weather.googleapis.com/v1/mapTypes/{map_type}/mapTiles/{zoom}/{x}/{y}Loại bản đồ
Weather API hỗ trợ nhiều loại bản đồ thời tiết, tương ứng với nhiều mô hình thời tiết cơ bản và khu vực địa lý:
US_PRECIPITATION_CURRENT: Dự báo tức thì lượng mưa ở Hoa Kỳ với độ phân giải cao.EU_PRECIPITATION_CURRENT: Dự báo tức thì lượng mưa ở Châu Âu với độ phân giải cao.
Bản đồ phạm vi phủ sóng bên dưới cho thấy các khu vực có ô bản đồ thời tiết:
Hệ thống tọa độ ô vuông
API này sử dụng hệ toạ độ ô Web Mercator tiêu chuẩn. Để biết giải thích toàn diện về toạ độ bản đồ và ô, hãy xem phần Ô bản đồ lộ trình và Toạ độ bản đồ và ô.
Trong hệ thống này:
zoom: Mức thu phóng (từ 0 đến 16). Mức thu phóng 0 đại diện cho toàn thế giới trong một ô (20 x 20 = 1 ô). Mức thu phóng z chia thế giới thành một lưới gồm 2z x 2z ô.x: Toạ độ X (cột) của ô, từ 0 (cực tây) đến 2zoom - 1 (cực đông).y: Toạ độ Y (hàng) của ô, từ 0 (cực bắc) đến 2zoom - 1 (cực nam).
Hiện bản đồ thời tiết
Để hiện các ô này trong một ứng dụng web bằng Google Maps JavaScript API, bạn có thể tạo google.maps.ImageMapType tuỳ chỉnh:
const weatherMapType = new google.maps.ImageMapType({ getTileUrl: function(coord, zoom) { const mapType = "US_PRECIPITATION_CURRENT"; return `https://weather.googleapis.com/v1/mapTypes/${mapType}/mapTiles/${zoom}/${coord.x}/${coord.y}`; }, tileSize: new google.maps.Size(256, 256), maxZoom: 16, minZoom: 0, name: "Weather" }); // Overlay on existing map map.overlayMapTypes.insertAt(0, weatherMapType);
Ví dụ về yêu cầu bản đồ thời tiết
Ví dụ sau đây yêu cầu các ô bản đồ thời tiết về lượng mưa ở Hoa Kỳ cho New Orleans:
curl -o tile.png -X GET "https://weather.googleapis.com/v1/mapTypes/US_PRECIPITATION_CURRENT/mapTiles/12/1025/1688?key=API_KEY"
Phản hồi là nhị phân. Trình bao bọc JSON chỉ xuất hiện trong các chế độ cài đặt chuyển đổi tuần tự cụ thể, chẳng hạn như ?alt=json.