氣象Widget使用教學

本章將說明氣象Widget 的使用方式。

[info] 小提示：

程式碼連結：https://doc-3dgdp.colife.org.tw/samplecode/#src/testweb/widget-weather-sample/

[info] 小提示：

構成本Widget使用之Function：
ov.TerrainView.addCustomLayer
ov.TerrainView.removeLayer
ov.WeatherModule.getRadarReflectivityHistoryValidTimeSpan
ov.WeatherModule.addRadarReflectivityHistoryLayer
ov.WeatherModule.addWeatherImageLayer
ov.WeatherModule.removeLayer

這裡先撰寫一個最基本的圖台。
並在圖台中加入按鈕以控制Widget開關。

[info] 小提示：

此Widget有使用到Material ICON，可自行下載引入或使用線上CDN。

如果需要使用reverse proxy，本產品已經編寫完畢(在安裝目錄/js底下)，直接使用即可。 index.html：

<!DOCTYPE html>
<html lang="en" xmlns="http://www.w3.org/1999/xhtml">
    <head>
        <meta charset="utf-8" />
        <title>氣象Widget</title>
        <script src="PGWeb3D.min.js"></script>
        <link rel="stylesheet" type="text/css" href="./css/PGWeb3D.css" />
        <link rel="stylesheet" type="text/css" href="https://fonts.googleapis.com/icon?family=Material+Icons" />
    </head>
    <body>
        <div id="MyControl" style="position: absolute;z-index:1;color: white;background-color:black;">
            <button id="openWidget" onclick="openWidget()" style="left: 5px; top: 7px; position: absolute; width: 120px; border-radius: 7px;">開啟Widget</button>
        </div>
        <div id="MyMap" style="width:100%;height:100%;position:absolute;top:0;left:0"></div>
        <script src="main.js"></script>
    </body>
</html>

main.js：

var terrainview = new ov.TerrainView("MyMap");
function openCallback (result) {
    //設定底圖
    terrainview.setBaseLayer({
        url: "BING_MAP",
        identifier: "IMAGE",
        urlTemplate: "{URL}"
    });   
}
terrainview.openTerrain(
    {
        url: "http://127.0.0.1:8080",
        identifier: "terrain",
        callback: openCallback,
        urlTemplate: "oview.aspx?{URL}"
    }
);

再來我們要把openWidget按鈕點擊事件加進我們撰寫好的main.js中。

main.js：

var terrainview = new ov.TerrainView("MyMap");
function openCallback (result) {
    //設定預設底圖
    terrainview.setBaseLayer({
        url: "BING_MAP",
        identifier: "IMAGE",
        urlTemplate: "{URL}"
    });
}
terrainview.openTerrain(
    {
        url: "http://127.0.0.1:8080",
        identifier: "terrain",
        callback: openCallback,
        urlTemplate: "oview.aspx?{URL}"
    }
);
// 加入開啟氣象 Widget的按鈕事件
function openWidget() {
  new window.ov.Widget.Weather({
    view: terrainview,
    proxy: "weather.ashx?", // 填入代理伺服器，如若不需代理，可不填寫。
    authorization: "填入從氣象局資料開放平台中取得的API Key。" // 填入從氣象局資料開放平台中取得的API Key。
  });
  var button = document.getElementById("openWidget");
  button.disabled = true;
  setTimeout(function () {
    button.disabled = false;
  }, 1000);
}

到目前為止，我們已成功將開啟氣象 Widget功能加入圖台中。

初始化Widget