简介
时空地名查询辞典API接口——是一个只读界面,用于搜索中国历史地理信息系统(CHGIS)地名数据库的内容。时空地名查询辞典系统架构——大体上基于规范化与通用的CHGIS XML应用编程接口,以便多源集成,并且允许俗名拼音或改写。
该界面接受对UTF 8编码字符串或字形(例如,简体中文或复杂字符)地名的查询。数据库中的每个地名都记有拼音。 本辞典系统架构简介表 (PDF). 视频演示
另见: CHGIS时空地名查询辞典
用法
尝试使用本简易对话框,或阅读下列API使用结构:
TGAZ Web服务被设计成接收包含查询值的RESTful URIs,并且默认情况下以XML格式返回结果。该接口是只读的,目前提供两种功能:
- 规范地名搜索(Canonical Placename)
方法 -> http://tgaz.fudan.edu.cn/tgaz/placename/UNIQUE_ID - 分面搜索(Faceted Search)
方法 -> http://tgaz.fudan.edu.cn/tgaz/placename?QUERY_PARAMETER=VALUE
简介:
- 精准地名搜索 - 用被搜索的地名ID替换上述的“UNIQUE_ID”。(目前正在使用的ID带有 hvd_ 前缀,即在 CHGIS 数据中的ID前加上这个前缀。例如CHGIS的ID为32180,则对应TGAZ的ID为hvd_32180).
- 分面搜索 - 允许搜索查询参数值组合.查询参数(QUERY_PARAMETER)如下:地名(n),年份(yr),行政等级类型(ftyp),数据源(src),上级单位(p)等都可以作为查询字符串的形式发送, 例如: ?n=mengla&yr=1820&ftyp=xian。注意:默认输出为HTML,该HTML可以通过使用“FORMAT(fmt)”参数进行重新设置,即 fmt=json
在地名,行政等级,上级单位的值中允许有空格。中文字符必须以普通UTF-8的形式发送, 而不是URLencoded十六进制字符串的形式。注意:数据库中起止年份设定为-222至1911。
精准地名搜索(Canonical Placename)
精准地名搜索格式
- json http://tgaz.fudan.edu.cn/tgaz/placename/json/hvd_80547
- rdf http://tgaz.fudan.edu.cn/tgaz/placename/rdf/hvd_135744
- html http://tgaz.fudan.edu.cn/tgaz/placename/html/hvd_9732
- xml http://tgaz.fudan.edu.cn/tgaz/placename/xml/hvd_96066
分面搜索(Faceted Search)
参数如下:
- n: 地名
- yr: 地名所在年份
- ftyp: 地名行政等级
- src: 数据来源 (即CHGIS, RAS)
- p: 上一级地名 (该地点所在的直接上级管辖区)
- fmt: 返回的输出格式:xml、json、html
- 拼音: http://tgaz.fudan.edu.cn/tgaz/placename?n=Tianbian
- 中文字符: http://tgaz.fudan.edu.cn/tgaz/placename?n=晋阳
- 藏语: http://tgaz.fudan.edu.cn/tgaz/placename?n=ར་ལོ་དགོན
- 俄语: http://tgaz.fudan.edu.cn/tgaz/placename?n=Вятское Наместничество
- http://tgaz.fudan.edu.cn/tgaz/placename?fmt=json&n=滚弄
- http://tgaz.fudan.edu.cn/tgaz/placename?fmt=html&n=Rui'an Xian
- http://tgaz.fudan.edu.cn/tgaz/placename?fmt=xml&n=温州
- http://tgaz.fudan.edu.cn/tgaz/placename?fmt=html&n=龍&yr=800
- http://tgaz.fudan.edu.cn/tgaz/placename?fmt=html&n=雙&yr=300
- http://tgaz.fudan.edu.cn/tgaz/placename?fmt=html&n=meng&ftyp=州
- http://tgaz.fudan.edu.cn/tgaz/placename?fmt=html&n=鮑&ftyp=cun zhen
- http://tgaz.fudan.edu.cn/tgaz/placename?fmt=html&n=茹&p=上谷郡
- http://tgaz.fudan.edu.cn/tgaz/placename?fmt=html&n=盧溪&p=黔中
地名举例
地名 & 输出格式举例
地名 & 地名所在年份举例
地名 & 地名行政等级举例
地名 & 上一级地名举例
多参数分面搜索举例