Điểm cuối mapTypes cung cấp các ô bản đồ dạng raster thể hiện nhiều hiện tượng thời tiết, chẳng hạn như dự báo 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 nhận quyền tác giả. Khách hàng phải cung cấp cho Google thông tin ghi nhận tác giả 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 Quy định hạn chế. Khách hàng không được 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ể lưu tạm Nội dung hiện hành trên Google Maps từ Weather API trong 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 được bổ sung vào 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 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 đối với 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 các mô hình thời tiết cơ bản và khu vực địa lý khác nhau:
US_PRECIPITATION_CURRENT: Bản tin dự báo tức thời về lượng mưa có độ phân giải cao ở Hoa Kỳ.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ệ thống toạ độ ô
API này sử dụng hệ toạ độ ô Web Mercator tiêu chuẩn. Để biết nội dung giải thích toàn diện về toạ độ bản đồ và ô, hãy xem phần Ô bản đồ đường 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 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 khoảng 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"
Câu trả lời là có hoặc không. Trình bao bọc JSON chỉ xuất hiện trong một số chế độ cài đặt chuyển đổi tuần tự cụ thể, chẳng hạn như ?alt=json.