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

出自DILA Wiki
imported>Winxd
無編輯摘要
imported>Winxd
無編輯摘要
行 52: 行 52:
http://authority.ddbc.edu.tw/getAuthorityDataMM.php?type=place&id=CN610112Z05AA&jsoncallback=abc123
http://authority.ddbc.edu.tw/getAuthorityDataMM.php?type=place&id=CN610112Z05AA&jsoncallback=abc123


=== 執行結果 ===
<syntaxhighlight lang="XML">
<syntaxhighlight lang="XML">
abc123({
abc123({
行 73: 行 74:
6.Note:註解。<br>
6.Note:註解。<br>
7.Names:別名。<br>
7.Names:別名。<br>
== 取得時間資料 ==
=== 需要餵給程式的參數 ===
1.<font color=red size=3><b>type:</b></font>必須指定成「time」。<br>
2.<font color=red size=3><b>from-to、when:</b></font>時間的參數值為7碼的datecode,由於標記可能是一個時期或一個時間,因此這邊分成兩種形式,如果標記是「時期」,需要給的參數就是<font color=blue>from</font>和<font color=blue>to</font>
3.<font color=red size=3><b>jsoncallback:</b></font>隨機產生的參數。<br>
=== 執行範例 ===
http://authority.ddbc.edu.tw/getAuthorityDataMM.php?type=place&id=CN610112Z05AA&jsoncallback=abc123
<table width="477" border="1">
<table width="477" border="1">
   <tr>
   <tr>

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

前言

由於各個專案可能有取得Authority資料的需求,因此這邊提供取得Authority的人名、地名、時間之方法,已方便各專案使用。

程式位置

http://elib.ddbc.edu.tw/authority/getAuthorityData.php

取得人名資料

需要餵給程式的參數

1.type:必須指定成「person」。
2.id:就是你想要取得人名資料的唯一碼,可接受7碼的Pno(ex-A000004)和5碼的人名PrjNo(ex-B0006)。
3.jsoncallback:隨機產生的參數。

執行範例

http://authority.ddbc.edu.tw/getAuthorityData.php?type=person&id=A000294&jsoncallback=abc123

執行結果

abc123({
    "data1": {
        "Name": "玄奘",
        "Pno": "A000294",
        "Project_No": "B0325",
        "Dynasty": "唐 ",
        "Class": "譯經",
        "Names": " 唐三藏;大遍覺;大乘天"
    }
})

欄位說明

1.Project_No:專案碼,即此筆人名資料的專案編號。
2.Class:分類。
3.Note:註解。
4.Year:生卒年。
5.Dynasty:朝代。
6.Names:別名。


取得地名資料

需要餵給程式的參數

1.type:必須指定成「place」。
2.id:地名資料的唯一碼,可接受13碼以上的地名編碼(ex-CN232723Z01AA)或地名的PrjNo(ex-Z0106105)。
3.jsoncallback:隨機產生的參數。

執行範例

http://authority.ddbc.edu.tw/getAuthorityDataMM.php?type=place&id=CN610112Z05AA&jsoncallback=abc123

執行結果

abc123({
    "data1": {
        "Name": "長安",
        "Dynasty": "西漢",
        "Code": "CN610112Z05AA",
        "XY": "34.3194, 108.8835",
        "County": "西漢_司隸部",
        "Pname": " 陝西省- 西安市-   未央區"
    }
})

欄位說明

1.Code:地名編碼,地名的唯一碼。
2.Pname:行政區。
3.XY:座標。
4.Dynasty:朝代。
5.County:County。
6.Note:註解。
7.Names:別名。

取得時間資料

需要餵給程式的參數

1.type:必須指定成「time」。
2.from-to、when:時間的參數值為7碼的datecode,由於標記可能是一個時期或一個時間,因此這邊分成兩種形式,如果標記是「時期」,需要給的參數就是fromto 3.jsoncallback:隨機產生的參數。

執行範例

http://authority.ddbc.edu.tw/getAuthorityDataMM.php?type=place&id=CN610112Z05AA&jsoncallback=abc123

人名
地名
時間 只接受d開頭的標記,如d331241335258




id和jsoncallback這兩個參數都必須給定,且id的格式須符合上面的說明。

使用範例

http://authority.ddbc.edu.tw/getAuthorityData.php?id=T13005441&jsoncallback=jsoncallback12345

回傳資料

程式的回傳資料為json格式,開發人員可讀取此json結果來顯示Authority的內容。



時間欄位說明

  • 時間回傳值會有包含排版資訊(因為有並行年代的問題),因此開發人員使用dateFrom和dateTo時直接print這兩個變數即可,無須再進行排版。

1.dateFrom:起始日期。
2.dateTo:結束日期。