Python｜使用 Untangle 拆解 XML API 獲取澳門停車場剩餘車位量

2021 年 12 月 22 日

在停車場車位資訊數據中，首先會有基本信息，主要需要知道數據格式是甚麼，例如這個是 XML。另外有些是 JSON，有些供下載的則可能是 XLSX 或者 XML 等。針對不同的格式，我們會使用不同的方法來處理。例如 XML 數據，除了使用 Python 內置的 XML 模組外，亦推介使用第三方的 Untangle 模組，這個模組可以方便將 XML 網址或字串返回成物件類型。

在澳門政府數據開放平台 data.gov.mo 中有若干數據可以使用，其中包括停車場剩餘車位數量等實用資訊。

停車場車位資訊通常在右下方的「熱門數據集」中可以找到。否則，可以在公共交通，交通事務局的數據分類中找到，名為「停車場車位資訊」的數據。

澳門政府數據開放平台分為下載使用的及直接 API 網址使用的。通常視乎更新頻率而定。例如停車場車位資料這些頻繁數據更新的，我們會使用 API 即時存取。而像餐廳資料等沒有實時更新需求的，則可以下載檔案後再讀取分析。

停車場車位資訊 API

緊接著是數據字段，即當中每筆記錄包括甚麼屬性資料。要注意的是，這個政府開放數據平台的數據描述有時會有錯字。實際應用時要注意拿到的數據才是真的。另外也要注意，是真實返回數據亦有機會有錯字，甚至有影響XML結構的情況出現。幸好，這個停車場車位量 API 暫時未有上述情況。

最底就是 API 的調用方法。包括網址、GET 還是POST 方法、及調用的授權資料等。

API 調用很少有完全不用授權的。大多都需要起碼建立免費帳號取得 API 授權碼。而政府開放平台上的API，暫時不用建立帳號，大多只需填上統一的授權碼便可以。

Untangle 拆解 XML

Untangle 可以很方便的直接貼上 XML 網址，例如澳門天氣 API 便可以。但由於這個停車場API 需要自定義 header資料。所以我們不能方便地直接給網址，而是需要多兩步，使用 requests 取得返回 XML 值再交給 untangle。

import untangle
import requests

url = "https://dsat.apigateway.data.gov.mo/car_park_maintance"

headers = {
        "Authorization": "APPCODE 09d43a591fba407fb862412970667de4"
}

res = requests.get(url, headers=headers)
res.encoding="UTF-8"

data = untangle.parse(res.text)

Untangle 開啟 XML 數據後，我們可以通過 dir(data) 來逐層檢視其 XML 結構。

例如 dir(data) 會得出 ['CarPark']。

XML 的頂層都有一個元素，通過 dir(data.CarPark)，可以見到一堆 Car_park_info 的列表。即我們可以通過 for 循環逐個逐個檢視。

可以首先逐個印出來檢視一下。

for carpark in data.CarPark.Car_park_info:
   print(carpark)

可以見到每個 Car_park_info 有我們需要的屬性，包括停車場名稱及車位剩餘數量。於是，我們可以進一步整埋，只列印名稱及剩餘車位數量。

for carpark in data.CarPark.Car_park_info:   
   name = carpark["name"]
   car = carpark["Car_CNT"]
   print(name, car)

可以得出現時所有澳門公共停車場車位數量。

進一步，我們可以憑名稱搜尋前往目標附近的停車場資訊。

targets=["栢佳", "栢湖"]
for carpark in data.CarPark.Car_park_info:   
   name = carpark["name"]
   car = carpark["Car_CNT"]   
   for target in targets:
       if target in name:
           print(name, car)

原整代碼：

https://gist.github.com/makzan/c02d35dcf5bd13760255fc1d9580b621