颱風動態 首頁 合歡山 地圖查找 附近影像 站內搜尋 天氣資訊 警廣路況 最新消息 功能建議

即時影像API 說明文件

查詢座標附近的即時影像監視器

基本資訊

此API通過網址超連結的方式提供,用戶可以直接在網頁瀏覽器中輸入或點擊超連結查詢指定地理座標附近的即時影像監視器。

使用方式

嵌入網頁使用 (iframe),直接訪問以下格式的URL來查詢附近的即時影像監視器:

https://www.twipcam.com/widget/v1/query-cam-list-by-coordinate?lat=[緯度]&lon=[經度]

[緯度][經度]替換成實際的座標值。

超連結範例

查詢位於緯度24.1372、經度121.277的監視器(合歡山武嶺亭附近),可以使用以下超連結:

https://www.twipcam.com/widget/v1/query-cam-list-by-coordinate?lat=24.1372&lon=121.277

響應內容

成功的請求將在網頁中顯示附近監視器的資訊,包括監視器名稱、位置描述、氣候溫度等。

錯誤處理

如果提供的座標無效,您將在網頁中看到錯誤訊息。

注意事項

  • 確保輸入的緯度和經度是有效的數字。

取得即時影像攝影機清單

基本資訊

此API回傳即時影像攝影機的影像資訊清單,每筆資料包含攝影機位置座標與即時影像串流連結。

使用方式

直接訪問以下的URL來取得即時影像攝影機清單:

https://www.twipcam.com/api/v1/cam-list.json

回傳格式(JSON Array)

每筆資料為一個物件,包含以下欄位:

欄位名稱 類型 說明
idstring攝影機唯一識別碼
latfloat緯度
lonfloat經度
namestring即時影像攝影機名稱
cam_urlstring即時影像串流網址

範例資料說明

{ "id": "wra-003324", "lat": 23.9809, "lon": 121.6136, "name": "水利署水資源 花蓮縣政府水利科 中正抽水站2", "cam_url": "https://c01.twipcam.com/cam/snapshot/wra-003324.jpg" }
  • 位置座標:緯度 23.9809,經度 121.6136
  • 影像名稱:水利署水資源 花蓮縣政府水利科 中正抽水站2
  • 影像連結即時影像

風場預報顯示系統

基本資訊

這是一個可以動態觀看風速與風向變化的地圖工具,透過動畫方式呈現大氣風場,讓您輕鬆掌握天氣趨勢。

使用方式

嵌入網頁使用 (iframe)

https://www.twipcam.com/widget/v1/wind?lat=[緯度]&lon=[經度]&zoom=[地圖縮放程度]

[緯度][經度][地圖縮放程度]替換成實際的座標值與地圖縮放程度。

*地圖縮放程度的範圍: 4 - 10

如果未指定值, 則呈現預設座標緯度 23.5, 經度 121, 地圖縮放程度 5

資料來源

交通部中央氣象署 全球預報模式(GFS)

天氣資訊 Widget

基本資訊

此 Widget 提供指定地理座標的即時天氣資訊,以網頁形式呈現,可直接嵌入其他網站使用。適合在即時影像頁面、部落格或資訊看板中顯示該地點當下的氣象概況。

使用方式

嵌入網頁使用 (iframe),直接訪問以下格式的 URL:

https://www.twipcam.com/widget/v1/wx-info?lat=[緯度]&lon=[經度]

[緯度][經度]替換成實際的座標值。

參數說明

參數名稱 類型 必填 說明
lat float 緯度,例如 24.1618
lon float 經度,例如 120.6468

超連結範例

查詢位於緯度 24.1618、經度 120.6468 的天氣資訊(台中市附近),可以使用以下超連結:

https://www.twipcam.com/widget/v1/wx-info?lat=24.1618&lon=120.6468

響應內容

成功的請求將在網頁中顯示該座標對應地點的即時天氣資訊,包括溫度、天氣狀況等氣象資料。

錯誤處理

如果提供的座標無效或缺少必要參數,頁面將顯示錯誤訊息。

注意事項

  • 確保輸入的緯度和經度是有效的數字。
  • 建議 iframe 高度依實際版型調整。
  • 此 Widget 適合與「查詢座標附近的即時影像監視器」API 搭配使用,形成完整的「即時影像 + 即時天氣」呈現。

資料來源

交通部中央氣象署

天氣資訊 Widget(含紫外線與熱指數)

基本資訊

此 Widget 為「天氣資訊 Widget」的加強版:除了即時天氣(溫度、體感溫度、降雨機率、濕度、雨量與一週預報)外,另加上該地點的紫外線指數熱指數(熱危害等級),以網頁形式呈現,可直接嵌入其他網站使用。

使用方式

嵌入網頁使用 (iframe),直接訪問以下格式的 URL:

https://www.twipcam.com/widget/v1/wx-info2?lat=[緯度]&lon=[經度]

[緯度][經度]替換成實際的座標值。

參數說明

參數名稱 類型 必填 說明
lat float 緯度,例如 24.1618
lon float 經度,例如 120.6468

超連結範例

查詢位於緯度 24.1618、經度 120.6468 的天氣資訊(台中市附近),可以使用以下超連結:

https://www.twipcam.com/widget/v1/wx-info2?lat=24.1618&lon=120.6468

響應內容

成功的請求將顯示該座標對應地點的即時天氣與一週預報,並額外包含:

  • 紫外線指數:取自最近的中央氣象署紫外線測站觀測值,並標示低量/中量/高量/過量/危險級;當最近測站無有效觀測(或觀測時間過舊)時以「-」顯示。
  • 熱指數:依當地氣溫與相對濕度以美國國家氣象局熱指數(Heat Index)公式推算,對應勞動部職安署熱危害第一至第四級(注意/格外注意/危險/極度危險)。

注意事項

  • 確保輸入的緯度和經度是有效的數字。
  • 建議 iframe 高度依實際版型調整。
  • 與「查詢座標附近的即時影像監視器」API 搭配使用,可形成完整的「即時影像 + 即時天氣 + 生活氣象指數」呈現。

資料來源

交通部中央氣象署(天氣、紫外線)、勞動部職業安全衛生署(熱危害等級對應)。

資料來源:twipcam 台灣即時影像監視器
授權條款:創用 CC 姓名標示 3.0 台灣 (CC BY 3.0 TW)
使用時請標示出處。