跳到主要內容區塊

API開發指引

一、使用說明

使用者可以進入本站開放資料專區 進行資料集詮釋資料了解與資料查詢預覽。 以下說明說明M2M程式使用方式。

【資料下載】

開放資料下載資訊頁面.jpg
直接於網站中的各資料頁面,篩選所需的資料時間區間,於列表中時間後方下載欄位按鈕,點擊即可下載檔案。檔案格式:MP3、PNG、JPG等

【程式介接】

可直接以系統介接的方式連結該資料介接URL取得內容。檔案格式:JSON、CSV每份資料均有詮釋資料,列出資料的格式及欄位定義,協助開發人員充分了解資料內容進行解譯與下載。

二、輸入範例
1.檔案下載(JSON):https://iesn.tfri.gov.tw/Common/GetOpenData.ashx?file=json&type=far&pointId=0206&d1=2023-01-01&d2=2023-01-31
{file}:檔案格式
{type}:開放資料類型
{pointID}:傳入觀測點編碼
{d1}:資料收集起始時間
型態:YYYY-MM-dd
{d2}:資料收集迄止時間
型態:YYYY-MM-dd
2.檔案下載(CSV): https://iesn.tfri.gov.tw/Common/GetOpenData.ashx?file=csv&type=far&pointId=0206&d1=2023-01-01&d2=2023-01-31
{file}:檔案格式
{type}:開放資料類型
{pointID}:傳入觀測點編碼
{d1}:資料收集起始時間
型態:YYYY-MM-dd
{d2}:資料收集迄止時間
型態:YYYY-MM-dd
三、使用範例
1.API查詢連結:
https://iesn.tfri.gov.tw/Common/GetOpenData.ashx?file=json&type=far&pointId=0206&d1=2023-01-01&d2=2023-01-31
回傳範例:
{"sound_id":"1741407","record_device_id":"lhc_03_m1","record_time":"2023/1/1 上午 12:02:00","sound_path":"https://iesn.tfri.gov.tw/opd/api/downloadapi.jsp?fName=%2fobs%2f02%2f0206%2f202301%2f30s%2flhc_03_m1_s_s2_20230101000200.mp3","spectrum_path":"https://iesn.tfri.gov.tw/opd/api/downloadapi.jsp?fName=%2fobs%2f02%2f0206%2f202301%2f30s%2flhc_03_m1_s_s2_20230101000200.png"},
2.進階下載
進一步將連結的原始影像、氣象資料、聲音等檔案進行第二層資料下載
https://iesn.tfri.gov.tw/opd/api/downloadapi.jsp?fName=%2fobs%2f02%2f0206%2f202301%2f30s%2flhc_03_m1_s_s2_20230101000200.mp3