「取得 Authority 資料」:修訂間差異

出自DILA Wiki
imported>Winxd
無編輯摘要
imported>Winxd
無編輯摘要
行 6: 行 6:


http://elib.ddbc.edu.tw/authority/getAuthorityData.php
http://elib.ddbc.edu.tw/authority/getAuthorityData.php
== 取得人名資料 ==


=== 需要餵給程式的參數 ===
=== 需要餵給程式的參數 ===

於 2008年12月12日 (五) 10:32 的修訂

前言

由於各個專案可能有取得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:結束日期。