Pois/add poi
Zhangchao2 (讨论 | 贡献) (→请求参数) |
|||
(未显示1个用户的13个中间版本) | |||
第1行: | 第1行: | ||
− | == '''pois/ | + | == '''pois/add_poi''' == |
提交POI点信息。请求必须用POST方式提交。 | 提交POI点信息。请求必须用POST方式提交。 | ||
+ | 新增POI数据,新增的POI数据会进入数据处理流程,数据处理流程主要包括地理编码、数据排重、信息整合、质量改进等多项具体工作,凡是与位置相关的任何信息都可以通过上述几个环节的处理加入到地理信息库里,并且可通过接口查询到数据处理结果信息,帮助您提高数据质量 | ||
== '''URL''' == | == '''URL''' == | ||
− | http://api. | + | http://api.t.sina.com.cn/location/pois/add_poi.(json|xml) |
== '''支持格式''' == | == '''支持格式''' == | ||
− | JSON | + | JSON/XML |
== '''HTTP请求方式''' == | == '''HTTP请求方式''' == | ||
第12行: | 第13行: | ||
== '''是否需要登录''' == | == '''是否需要登录''' == | ||
− | ''' | + | '''true''' |
== '''请求参数''' == | == '''请求参数''' == | ||
第29行: | 第30行: | ||
| 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行: | 第45行: | ||
| style="text-align:center;" |true | | style="text-align:center;" |true | ||
| style="text-align:center;" |string | | style="text-align:center;" |string | ||
− | | POI点类别,填写类别中文名 (详见[[ | + | | POI点类别,填写类别中文名 (详见[[location/category|分类代码对照表]]) |
|- | |- | ||
| 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点城市,填写城市中文名 (详见[[location/citycode|城市代码对照表]]) |
|- | |- | ||
| 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行: | 第86行: | ||
| style="text-align:center;" |string | | style="text-align:center;" |string | ||
| POI点交通情况描述(换乘,公交地铁到达) | | POI点交通情况描述(换乘,公交地铁到达) | ||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
| style="text-align:center;" |intro | | style="text-align:center;" |intro | ||
第95行: | 第91行: | ||
| 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> | ||
第117行: | 第117行: | ||
:num:结果总数 | :num:结果总数 | ||
− | == ''' | + | == '''其它''' == |
+ | |||
+ | === '''PHP示例''' === | ||
+ | 需要开启PHP的cURL扩展 | ||
<pre> | <pre> | ||
− | + | <?php | |
+ | //改为你的微博账号,用户名和密码之间用:隔开 | ||
+ | $userPwd = 'user@sina.com:pwd'; | ||
+ | //改为你微博应用的appkey | ||
+ | $appkey = '0123456789'; | ||
+ | |||
+ | $url = "http://api.t.sina.com.cn/location/pois/add_poi.xml?srcid=test001&name=123&address=abc&city=north&category=010000&longitude=116.30995&latitude=39.98465&source=$appkey"; | ||
+ | |||
+ | $rst = curlSample($url,$userPwd); | ||
+ | |||
+ | echo $rst; | ||
+ | |||
+ | function curlSample($url,$userPwd,$postFields = '',$header = ''){ | ||
+ | $ch = curl_init() or die (curl_error()) ; | ||
+ | curl_setopt($ch,CURLOPT_URL,$url); | ||
+ | curl_setopt($ch,CURLOPT_RETURNTRANSFER,1); | ||
+ | curl_setopt($ch,CURLOPT_TIMEOUT,30); | ||
+ | if(!empty($userPwd)){ | ||
+ | curl_setopt($ch,CURLOPT_USERPWD,$userPwd); | ||
+ | } | ||
+ | if(!empty($postFields)){ | ||
+ | curl_setopt($ch,CURLOPT_POST,true); | ||
+ | curl_setopt($ch,CURLOPT_POSTFIELDS,$postFields); | ||
+ | } | ||
+ | if(!empty($header)){ | ||
+ | curl_setopt($ch, CURLOPT_HTTPHEADER,$header); | ||
+ | } | ||
+ | $result = curl_exec($ch) or die (curl_error($ch)); | ||
+ | curl_close($ch); | ||
+ | return $result; | ||
+ | } | ||
+ | ?> | ||
</pre> | </pre> |
2011年8月11日 (四) 14:32的最后版本
目录 |
pois/add_poi
提交POI点信息。请求必须用POST方式提交。 新增POI数据,新增的POI数据会进入数据处理流程,数据处理流程主要包括地理编码、数据排重、信息整合、质量改进等多项具体工作,凡是与位置相关的任何信息都可以通过上述几个环节的处理加入到地理信息库里,并且可通过接口查询到数据处理结果信息,帮助您提高数据质量
URL
http://api.t.sina.com.cn/location/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:结果总数
其它
PHP示例
需要开启PHP的cURL扩展
<?php //改为你的微博账号,用户名和密码之间用:隔开 $userPwd = 'user@sina.com:pwd'; //改为你微博应用的appkey $appkey = '0123456789'; $url = "http://api.t.sina.com.cn/location/pois/add_poi.xml?srcid=test001&name=123&address=abc&city=north&category=010000&longitude=116.30995&latitude=39.98465&source=$appkey"; $rst = curlSample($url,$userPwd); echo $rst; function curlSample($url,$userPwd,$postFields = '',$header = ''){ $ch = curl_init() or die (curl_error()) ; curl_setopt($ch,CURLOPT_URL,$url); curl_setopt($ch,CURLOPT_RETURNTRANSFER,1); curl_setopt($ch,CURLOPT_TIMEOUT,30); if(!empty($userPwd)){ curl_setopt($ch,CURLOPT_USERPWD,$userPwd); } if(!empty($postFields)){ curl_setopt($ch,CURLOPT_POST,true); curl_setopt($ch,CURLOPT_POSTFIELDS,$postFields); } if(!empty($header)){ curl_setopt($ch, CURLOPT_HTTPHEADER,$header); } $result = curl_exec($ch) or die (curl_error($ch)); curl_close($ch); return $result; } ?>
文档更新时间: 2011-08-11