Điểm cuối mapTypes cung cấp các ô bản đồ raster thể hiện 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/dịch vụ ở giai đoạn trước khi phát hành rộng rãi) trong Điều khoản dành riêng cho dịch vụ của Google Maps Platform, 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 cung cấp thông tin ghi nhận quyền tác giả cho Google theo 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 Google Maps hiện hành từ Weather API trong Khoảng thời gian lưu vào bộ nhớ đệm hiện hành, 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)
Những quyền này bổ sung cho các quyền được mô tả trong Bảng 17.2.1 của Điều khoản dành riêng cho dịch vụ của Google Maps Platform.
| Nội dung trên Google Maps | Khoảng thời gian lưu vào bộ nhớ đệm |
|---|---|
| Thẻ bản đồ thời tiết | Một giờ, sau đó Khách hàng phải xoá Nội dung được lưu vào bộ nhớ đệm của Google Maps |
Giới thiệu về yêu cầu đối với bản đồ thời tiết
Để yêu cầu bản đồ thời tiết, hãy gửi một 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 các mô hình thời tiết và khu vực địa lý cơ bản khác nhau:
US_PRECIPITATION_CURRENT: Thông tin dự báo tức thời về lượng mưa ở Hoa Kỳ với độ phân giải cao.EU_PRECIPITATION_CURRENT: Bản tin dự báo lượng mưa hiện tại ở Châu Âu có độ phân giải cao.
Bản đồ phạm vi bên dưới cho thấy những khu vực có ô bản đồ thời tiết:
Hệ toạ độ ô 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à toạ độ ô vuông, hãy xem Ô bản đồ đường đi và Toạ độ bản đồ và toạ độ ô vuông.
Trong hệ thống này:
zoom: Mức thu phóng (từ 0 đến 16). Mức thu phóng 0 biểu thị toàn bộ thế giới trong một ô duy nhấ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 ô, trong khoảng từ 0 (cực tây) đến 2zoom – 1 (cực đông).y: Toạ độ Y (hàng) của ô, trong phạm vi từ 0 (cực bắc) đến 2zoom – 1 (cực nam).
Hiển thị bản đồ thời tiết
Để hiển thị các ô này trong một ứng dụng web bằng Google Maps JavaScript API, bạn có thể tạo một 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.