Pois/add poi
Zhangchao2 (讨论 | 贡献) (→pois/add_poi) |
Zhangchao2 (讨论 | 贡献) |
||
第1行: | 第1行: | ||
− | == ''' | + | == '''新增POI数据''' == |
− | + | 提交POI点信息。请求必须用POST方式提交。 | |
− | + | 新增POI数据,新增的POI数据会进入数据处理流程,数据处理流程主要包括地理编码、数据排重、信息整合、质量改进等多项具体工作,凡是与位置相关的任何信息都可以通过上述几个环节的处理加入到地理信息库里,并且可通过接口查询到数据处理结果信息,帮助您提高数据质量 | |
== '''URL''' == | == '''URL''' == | ||
− | http://api. | + | http://api.t.sina.com.cn/pois/add_poi.(json|xml) |
== '''支持格式''' == | == '''支持格式''' == | ||
− | JSON | + | JSON/XML |
== '''HTTP请求方式''' == | == '''HTTP请求方式''' == | ||
第12行: | 第12行: | ||
== '''是否需要登录''' == | == '''是否需要登录''' == | ||
− | ''' | + | '''true''' |
== '''请求参数''' == | == '''请求参数''' == | ||
− | {| style="width:100%; height:200px | + | {| style="width:100%; height:200px;" border="1" cellspacing="0" cellpadding="0" |
− | ! style=" | + | ! style="width:20%" |参数 |
− | ! style=" | + | ! style="width:10%" |必选 |
− | ! style=" | + | ! style="width:20%" |类型及范围 |
− | ! style=" | + | ! style="width:50%" |说明 |
|- style="height:px" | |- style="height:px" | ||
| style="text-align:center;" |source | | style="text-align:center;" |source | ||
第29行: | 第29行: | ||
| style="text-align:center;" |true | | style="text-align:center;" |true | ||
| style="text-align:center;" |int | | style="text-align:center;" |int | ||
− | | | + | | 来源ID,用户自己生成,用于取回自己上传的poi信息 |
|- | |- | ||
| style="text-align:center;" |name | | style="text-align:center;" |name | ||
第44行: | 第44行: | ||
| style="text-align:center;" |true | | style="text-align:center;" |true | ||
| style="text-align:center;" |string | | style="text-align:center;" |string | ||
− | | POI点类别,填写类别中文名 (详见[[ | + | | POI点类别,填写类别中文名 (详见[[分类代码对照表|分类代码对照表]]) |
|- | |- | ||
| style="text-align:center;" |city | | style="text-align:center;" |city | ||
| style="text-align:center;" |true | | style="text-align:center;" |true | ||
| style="text-align:center;" |string | | style="text-align:center;" |string | ||
− | | POI点城市,填写城市中文名 (详见[[ | + | | POI点城市,填写城市中文名 (详见[[城市代码对照表|城市代码对照表]]) |
|- | |- | ||
| style="text-align:center;" |longitude | | style="text-align:center;" |longitude | ||
| style="text-align:center;" |true | | style="text-align:center;" |true | ||
− | | style="text-align:center;" | | + | | style="text-align:center;" |string |
| POI点经度 (如:116.30636) | | POI点经度 (如:116.30636) | ||
|- | |- | ||
| style="text-align:center;" |latitude | | style="text-align:center;" |latitude | ||
| style="text-align:center;" |true | | style="text-align:center;" |true | ||
− | | style="text-align:center;" | | + | | style="text-align:center;" |string |
| POI点维度 (如:39.84985) | | POI点维度 (如:39.84985) | ||
|- | |- | ||
| style="text-align:center;" |telephone | | style="text-align:center;" |telephone | ||
| style="text-align:center;" |false | | style="text-align:center;" |false | ||
− | | style="text-align:center;" | | + | | style="text-align:center;" |string |
| POI点电话 | | POI点电话 | ||
|- | |- | ||
第85行: | 第85行: | ||
| style="text-align:center;" |string | | style="text-align:center;" |string | ||
| POI点交通情况描述(换乘,公交地铁到达) | | POI点交通情况描述(换乘,公交地铁到达) | ||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
| style="text-align:center;" |intro | | style="text-align:center;" |intro | ||
第95行: | 第90行: | ||
| style="text-align:center;" |string | | style="text-align:center;" |string | ||
| POI点其他特色信息(将特色信息组织成数组array('key1'=>value,'key2'=>value)后转成json格式存入) | | POI点其他特色信息(将特色信息组织成数组array('key1'=>value,'key2'=>value)后转成json格式存入) | ||
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
== '''返回结果''' == | == '''返回结果''' == | ||
− | + | === '''XML示例''' === | |
+ | <pre> | ||
+ | <?xml version="1.0" encoding="UTF-8" ?> | ||
+ | <geoResult> | ||
+ | <result>1</result> | ||
+ | <info>Submit success</info> | ||
+ | <num>1</num> | ||
+ | </geoResult> | ||
+ | </pre> | ||
=== '''JSON示例''' === | === '''JSON示例''' === | ||
<pre> | <pre> | ||
第118行: | 第117行: | ||
== '''使用示例''' == | == '''使用示例''' == | ||
+ | 注:中文需进行urlencode编码,示例中未编码 | ||
<pre> | <pre> | ||
− | curl -d "srcid=yb&name=理想国际大厦&address=北四环西路58号&city=北京&category=大厦&longitude=116.30995&latitude=39.98465" "http://api. | + | curl -u "username:password" -d "srcid=yb&name=理想国际大厦&address=北四环西路58号&city=北京&category=大厦&longitude=116.30995&latitude=39.98465" "http://api.t.sina.com.cn/location/pois/add_poi.json?source=appkey" |
</pre> | </pre> |
2011年5月7日 (六) 00:01的版本
目录 |
新增POI数据
提交POI点信息。请求必须用POST方式提交。 新增POI数据,新增的POI数据会进入数据处理流程,数据处理流程主要包括地理编码、数据排重、信息整合、质量改进等多项具体工作,凡是与位置相关的任何信息都可以通过上述几个环节的处理加入到地理信息库里,并且可通过接口查询到数据处理结果信息,帮助您提高数据质量
URL
http://api.t.sina.com.cn/pois/add_poi.(json%7Cxml)
支持格式
JSON/XML
HTTP请求方式
POST
是否需要登录
true
请求参数
参数 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
source | true | string | 申请应用时分配的AppKey |
srcid | true | int | 来源ID,用户自己生成,用于取回自己上传的poi信息 |
name | true | string | POI点名称 |
address | true | string | POI点地址 |
category | true | string | POI点类别,填写类别中文名 (详见分类代码对照表) |
city | true | string | POI点城市,填写城市中文名 (详见城市代码对照表) |
longitude | true | string | POI点经度 (如:116.30636) |
latitude | true | string | POI点维度 (如:39.84985) |
telephone | false | string | POI点电话 |
url | false | string | POI点网址 |
tags | false | string | POI点标签(根据类别填写标签,比如:湘菜,川菜) |
description | false | string | POI点介绍 |
traffic | false | string | POI点交通情况描述(换乘,公交地铁到达) |
intro | false | string | POI点其他特色信息(将特色信息组织成数组array('key1'=>value,'key2'=>value)后转成json格式存入) |
返回结果
XML示例
<?xml version="1.0" encoding="UTF-8" ?> <geoResult> <result>1</result> <info>Submit success</info> <num>1</num> </geoResult>
JSON示例
{ "result":1, "info":"Submit success", "num":1 }
字段说明
- result:结果标志 (1表示成功)
- info:提示信息
- num:结果总数
使用示例
注:中文需进行urlencode编码,示例中未编码
curl -u "username:password" -d "srcid=yb&name=理想国际大厦&address=北四环西路58号&city=北京&category=大厦&longitude=116.30995&latitude=39.98465" "http://api.t.sina.com.cn/location/pois/add_poi.json?source=appkey"