Pois/add poi

跳转到: 导航, 搜索
 
(未显示1个用户的10个中间版本)
第1行: 第1行:
 
== '''pois/add_poi''' ==
 
== '''pois/add_poi''' ==
 
提交POI点信息。请求必须用POST方式提交。
 
提交POI点信息。请求必须用POST方式提交。
 +
新增POI数据,新增的POI数据会进入数据处理流程,数据处理流程主要包括地理编码、数据排重、信息整合、质量改进等多项具体工作,凡是与位置相关的任何信息都可以通过上述几个环节的处理加入到地理信息库里,并且可通过接口查询到数据处理结果信息,帮助您提高数据质量
  
 
== '''URL''' ==
 
== '''URL''' ==
http://api.map.sina.com.cn/pois/add_poi.php
+
http://api.t.sina.com.cn/location/pois/add_poi.(json|xml)
  
 
== '''支持格式''' ==
 
== '''支持格式''' ==
JSON
+
JSON/XML
  
 
== '''HTTP请求方式''' ==
 
== '''HTTP请求方式''' ==
第12行: 第13行:
  
 
== '''是否需要登录''' ==
 
== '''是否需要登录''' ==
'''false'''  
+
'''true'''  
  
 
== '''请求参数''' ==
 
== '''请求参数''' ==
{| style="width:100%; height:200px;border-color: #CCCCCC;" border="1" cellspacing="0" cellpadding="0"
+
{| style="width:100%; height:200px;" border="1" cellspacing="0" cellpadding="0"
 
! style="text-align:center;width:20%" |参数  
 
! style="text-align:center;width:20%" |参数  
 
! style="text-align:center;width:10%" |必选
 
! style="text-align:center;width:10%" |必选
第29行: 第30行:
 
| style="text-align:center;" |true
 
| style="text-align:center;" |true
 
| style="text-align:center;" |int
 
| style="text-align:center;" |int
| 来源ID
+
| 来源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点类别,填写类别中文名 (详见[[Location/category|分类代码对照表]])
+
| 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点城市,填写城市中文名 (详见[[Location/citycode|城市代码对照表]])
+
| 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;" |float
+
| 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;" |float
+
| 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;" |int
+
| 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;" |pic_url
 
| style="text-align:center;" |false
 
| style="text-align:center;" |string
 
| 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>
curl -d "srcid=yb&name=理想国际大厦&address=北四环西路58号&city=北京&category=大厦&longitude=116.30995&latitude=39.98465" "http://api.map.sina.com.cn/pois/add_poi.php?source=appkey"
+
<?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