Xem bản đồ thời tiết (Thử nghiệm)

Đ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ề thông tin ghi công. 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 thời Nội dung Google Maps hiện hành 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 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ụ Google Maps Platform.

Nội dung trên Google Maps Thời gian lưu vào bộ nhớ đệm
Thẻ thông tin bản đồ thời tiết Một giờ, sau đó Khách hàng phải xoá Nội dung 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 các mô hình thời tiết và khu vực địa lý khác nhau:

  • US_PRECIPITATION_CURRENT: Dự báo lượng mưa có độ phân giải cao ở Hoa Kỳ.
  • EU_PRECIPITATION_CURRENT: Dự báo lượng mưa có độ phân giải cao ở Châu Âu.

Bản đồ phạm vi bên dưới cho thấy những khu vực có mảnh bản đồ thời tiết:

Phạm vi bao phủ của thẻ thông tin bản đồ thời tiết

Hệ thống toạ độ ô

API này sử dụng hệ thống toạ độ ô vuông 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 thể hiện 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 ô, 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 thị bản đồ thời tiết

Để hiển thị các ô này trong một ứng dụng web bằng API JavaScript của Google Maps, 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à nhị phân. 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.