【物聯網環控系統開發#2】 測試氣象局OPEN DATA的API KEY

作者:曹永忠

前一篇文章【物聯網環控系統開發#1】 如何取得氣象資料,教大家如何取得中央氣象局氣象資料開放平台的會員資格,接著我們就要申請氣象資料開放平台 OpenData 的 API,並說明如何測試 API Key 是否可使用與如何應用等。

1. 登入帳號

如下圖所示,請使用 Chrome 瀏覽器,輸入網址:https://opendata.cwb.gov.tw/index,進入氣象資料開放平台後,請選擇下圖所示之紅框,選取登錄帳號。

氣象資料開放平台網站(圖片來源:曹永忠提供)

如下圖所示,我們採用氣象會員登入,請輸入申請的帳號。

氣象會員登入(圖片來源:曹永忠提供)

接著輸入您的會員帳號的電子郵件帳號與密碼,登入氣象資料開放平台。

登入氣象資料開放平台網頁畫面(圖片來源:曹永忠提供)

如下圖所示,如果一切登入資訊正確無誤,讀者可以看到登入後頁面。

登入後頁面(圖片來源:曹永忠提供)

2. 申請API Key

請讀者點選下圖紅框的申請授權碼,申請 API Key。

申請授權碼(圖片來源:曹永忠提供)

如下圖所示,如果資料一切無誤,讀者可以在下列畫面看到 CWB 開頭的一串字,這就是您申請到的 API Key,請把這串字圈選後複製到您保存的文件中。

申請授權碼(圖片來源:曹永忠提供)

3. 測試API Key

看到下圖就表示我們進入了 API 主頁。

API 授權碼主頁面(圖片來源:曹永忠提供)

如下圖所示,請讀者點選上面的使用說明。

進入開發指南之使用說明(圖片來源:曹永忠提供)

請讀者先行閱讀使用說明頁面的內容,了解一下相關資訊。

使用說明頁面(圖片來源:曹永忠提供)

如下圖所示,請點選下圖紅框處「資料擷取 API 線上說明文件」,進入下一個頁面。

資料擷取 API 線上說明文件(圖片來源:曹永忠提供)

如下圖所示,請點選下圖藍色區,進行選取、複製。

選取官網測試(圖片來源:曹永忠提供)

接著請讀者打開 Chrome 瀏覽器,輸入上圖所選取的網址。

選取官網測試網址(圖片來源:曹永忠提供)

如下圖所示,我們可以看到進入這個網址後,產生的 Open Data XML 檔案,請讀者將這個檔案存在您的硬碟中。

下載 XML 氣象資料檔(圖片來源:曹永忠提供)

接著要用文字編輯器或其他可以編輯 XML 的編輯器來開啟這個 XML 氣象資料檔的內容(這邊我採用的是 Visual Studio )。

XML 氣象資料檔內容(圖片來源:曹永忠提供)

4. 取得JSON

如下圖所示,我們進入到「資料擷取 API 線上說明文件」的主頁面,這個頁面是氣象資料開放平台所有 OpenData 的教學與產生擷取資料的主業,下面我會用氣象觀測資料做一個範例,其他都大同小異。

中央氣象局開放資料平臺之資料擷取 API(圖片來源:曹永忠提供)

接著請讀者向下移動頁面,移動到「觀測」這一區。

選取觀測區(圖片來源:曹永忠提供)

如下圖所示,請讀者點開 O-A0001-001 自動氣象站-氣象觀測資料,可以看到下列畫面。

點開 O-A0001-001 自動氣象站-氣象觀測資料(圖片來源:曹永忠提供)

如下圖所示,請讀者點選「Try It Out」。

點選試試看(圖片來源:曹永忠提供)

如下圖所示,讀者可以看到試試看畫面。

試試看畫面(圖片來源:曹永忠提供)

然後我們可以看到自動氣象站-氣象觀測資料_進入原始代碼的畫面。

自動氣象站-氣象觀測資料_進入原始代碼畫面(圖片來源:曹永忠提供)

5. 產生API搜尋字串

接下來我們要實際取得程式代碼。如下圖所示,請讀者在下圖紅框處,輸入本文取得 API key 的內容,就是您申請到以 CWB 開頭的那一串字串。

請輸入 API(圖片來源:曹永忠提供)

請輸入 API(圖片來源:曹永忠提供)

請設定回傳格式為「JSON」。

設定回傳格式(圖片來源:曹永忠提供)

輸入完成後,請往下滑動,移到下圖所示之區域,並點選「Execute」。

按下執行(圖片來源:曹永忠提供)

按下執行後,會看到紅框區的程式碼資訊,這就是系統幫我們自動產生的 API 字串。

取得 API 字串(圖片來源:曹永忠提供)

6. 測試API Key是否可以使用

如下圖所示,我們進入 API 主頁,請讀者複製下圖紅框區的 API 字串。

複製 API 字串(圖片來源:曹永忠提供)

接著請讀者開啟 Chrome 瀏覽器,在網址列輸入這串 API 字串,輸完畢後按下 Enter 鍵。

開啟瀏覽器輸入 API 字串(圖片來源:曹永忠提供)

輸入 API 字串後,我們可以在 Chrome 瀏覽器,取得回傳的 JSON 資料。

輸入 API 字串後取得回傳的 JSON 資料(圖片來源:曹永忠提供)

到此我們可以看到,已經可以透過 API 字串,向中央氣象局的氣象資料開放平台擷取到我們需要的氣象資料。

小結

本篇為「物聯網環控系統開發」系列的第二篇,主要介紹如何取得氣象資料開放平台 Open Data 的 API Key,並說明透過網站快速產生 API 字串,以直接取得氣象資料。相信透過筆者一步一步分享,能協助讀者將這個基礎理念與技術,運用到物聯網開發中,成為一個技術的核心能力。

後續筆者還會持續發表「環控系統開發」系列的文章,相信未來我們能創造出更優質,更具未來性的物聯網(Internet of Thing)產品開發相關技術,敬請期待更多的文章。

(責任編輯:賴佩萱)

Author: 曹永忠

目前為自由作家,已有二十多年的開發資訊系統經驗,專長為於軟體工程、軟體開發與設計、物件導向程式設計、Arduino/Ameba/LinkIt 等開發版開發與應用、嵌入式系統開發,同時也喜歡商品攝影及人像攝影,並持續發表作品及相關專業著作。 原始碼網址:https://github.com/brucetsao/

Share This Post On
Subscribe
Notify of
guest
0 Comments
Inline Feedbacks
View all comments
0
Would love your thoughts, please comment.x
()
x