取得 Authority 資料
出自DILA Wiki
前言
由於各個專案可能有取得Authority資料的需求,因此這邊提供取得Authority的人名、地名、時間之方法,已方便各專案使用。
程式資訊
程式位置
http://elib.ddbc.edu.tw/authority/getAuthorityData.php
需要餵給程式的參數
1.type:由於Authority有分成人名、地名、時間三個部份,此type參數指定要取何種資料。
1.id:就是你想要取得資料的唯一碼,格式說明如下:
人名 | 可接受7碼的Pno(ex-A000004)和5碼的人名PrjNo(ex-B0006) |
地名 | 可接受13碼以上的地名編碼(ex-CN232723Z01AA)或地名的PrjNo(ex-Z0106105) |
時間 | 只接受d開頭的標記,如d331241335258 |
2.jsoncallback:隨機產生的參數。
id和jsoncallback這兩個參數都必須給定,且id的格式須符合上面的說明。
使用範例
http://authority.ddbc.edu.tw/getAuthorityData.php?id=T13005441&jsoncallback=jsoncallback12345
回傳資料
程式的回傳資料為json格式,開發人員可讀取此json結果來顯示Authority的內容。
欄位說明
由於人名、地名、時間三者回傳的資訊都不一樣,欄位也不同,茲說明如下:
人名欄位說明
1.Project_No:專案碼,即此筆人名資料的專案編號。
2.Class:分類。
3.Note:註解。
4.Year:生卒年。
5.Dynasty:朝代。
6.Names:別名。
地名欄位說明
1.Code:地名編碼,地名的唯一碼。
2.Pname:行政區。
3.XY:座標。
4.Dynasty:朝代。
5.County:County。
6.Note:註解。
7.Names:別名。
時間欄位說明
- 時間回傳值會有包含排版資訊(因為有並行年代的問題),因此開發人員使用dateFrom和dateTo時直接print這兩個變數即可,無須再進行排版。
1.dateFrom:起始日期。
2.dateTo:結束日期。