取得天氣地圖 (實驗功能)

這項產品或功能仍在實驗階段 (正式發布前)。 我們對於正式發布前的產品和功能僅提供有限度的支援。此外，這類產品和功能的變更可能與其他正式發布前版本不相容。正式發布前產品/功能受到《Google 地圖平台服務專屬條款》規範。詳情請參閱推出階段說明。

mapTypes 端點提供光柵地圖圖塊，代表各種天氣現象，例如降水預報。這些地圖圖塊可疊加在標準 Google 地圖上。

注意： 天氣地圖圖塊可能不會同步處理，或與 forecast:minute 端點提供的資料一致。

條款

這些條款是依據 Google 與您同意的《Google 地圖平台服務專屬條款》第 6 節 (正式發布前產品條款) 發布。

1.1 註明出處規定。如果客戶使用 Weather API 的 Google 地圖內容，必須按照說明文件向 Google 提供出處資訊。

1.2 限制。客戶不得使用從 Weather API 擷取的 Google 地圖內容，重新建立 Google 服務或產品 (例如在天氣應用程式或天氣模型中使用從 Weather API 擷取的資料，而這些應用程式/模型的主要用途是提供天氣資訊)。

1.3 快取。如表 1.3.1 (快取權限) 所述，客戶可在適用的快取期間內，暫時快取 Weather API 中適用的 Google 地圖內容。

表 1.3.1 (快取權限)

這些權限是《Google 地圖平台服務專屬條款》表 17.2.1 所述權限的補充。

Google 地圖內容	快取週期
天氣地圖圖塊	一小時，之後客戶必須刪除快取的 Google 地圖內容

關於天氣地圖要求

如要要求天氣地圖，請將 HTTP GET 要求傳送至：

https://weather.googleapis.com/v1/mapTypes/{map_type}/mapTiles/{zoom}/{x}/{y}

地圖類型

Weather API 支援不同類型的天氣地圖，對應不同的基礎天氣模型和地理區域：

• US_PRECIPITATION_CURRENT：美國高解析度降水即時預報。
• EU_PRECIPITATION_CURRENT：歐洲高解析度降水即時預報。

下方的涵蓋範圍地圖顯示提供天氣地圖圖塊的區域：

圖塊座標系統

API 使用標準 Web Mercator 圖塊座標系統。如要全面瞭解地圖和圖塊座標，請參閱「道路地圖圖塊」和「地圖與圖塊座標」。

在這個系統中：

• zoom：縮放等級 (0 到 16)。縮放等級 0 代表整個世界，以單一圖塊呈現 (2⁰ x 2⁰ = 1 個圖塊)。縮放等級 z 會將世界劃分為 2^z x 2^z 的圖塊方格。
• x：圖塊的 X 座標 (欄)，範圍從 0 (最西邊) 到 2^縮放 - 1 (最東邊)。
• y：圖塊的 Y 座標 (列)，範圍從 0 (最北端) 到 2^zoom - 1 (最南端)。

顯示天氣圖

如要使用 Google Maps JavaScript API 在網頁應用程式中顯示這些圖塊，您可以建立自訂 google.maps.ImageMapType：

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);

天氣地圖要求範例

以下範例要求紐奧良的美國降水量天氣地圖圖塊：

curl -o tile.png -X GET "https://weather.googleapis.com/v1/mapTypes/US_PRECIPITATION_CURRENT/mapTiles/12/1025/1688?key=API_KEY"

回覆是二進位制，JSON 包裝函式只會顯示在特定序列化設定下，例如 ?alt=json。