Geocode/geo to address

跳转到: 导航, 搜索
(创建新页面为 '== '''逆地理编码''' == 根据坐标返回地址信息的接口 == '''URL''' == http://api.t.sina.com.cn/geocode/geo_to_address.(json|xml) == '''支持格式''' == '''XML/J…')
 
 
(未显示1个用户的10个中间版本)
第1行: 第1行:
== '''逆地理编码''' ==
+
== '''geocode/geo_to_address''' ==
 
根据坐标返回地址信息的接口
 
根据坐标返回地址信息的接口
 +
 
== '''URL''' ==
 
== '''URL''' ==
http://api.t.sina.com.cn/geocode/geo_to_address.(json|xml)
+
http://api.t.sina.com.cn/location/geocode/geo_to_address.(json|xml)
  
 
== '''支持格式''' ==
 
== '''支持格式''' ==
第11行: 第12行:
  
 
== '''是否需要登录''' ==
 
== '''是否需要登录''' ==
'''false'''  
+
'''true'''  
 
== '''请求数限制''' ==
 
== '''请求数限制''' ==
 
'''true'''  
 
'''true'''  
 
== '''请求参数''' ==
 
== '''请求参数''' ==
{| style="width:100%; height:200px;" border="1" cellspacing="0" cellpadding="0"
+
{| style="width:100%; height:100px;" border="1" cellspacing="0" cellpadding="0"
! style="width:20%;height:20px" |参数  
+
! style="text-align:center;width:20%;height:20px" |参数  
! style="width:10%" |必选
+
! style="text-align:center;width:10%" |必选
! style="width:20%" |类型及范围
+
! style="text-align:center;width:20%" |类型及范围
! style="width:50%" |说明
+
! style="text-align:center;width:50%" |说明
 
|- style="height:20px"  
 
|- style="height:20px"  
 
| style="text-align:center;" |source
 
| style="text-align:center;" |source
第29行: 第30行:
 
| style="text-align:center;" |true
 
| style="text-align:center;" |true
 
| style="text-align:center;" |float
 
| style="text-align:center;" |float
| 需要获取信息的坐标
+
| 需要获取信息的坐标(不支持多组坐标,若有多组只取第一组)
 
|}
 
|}
  
第36行: 第37行:
 
===  '''XML示例''' ===
 
===  '''XML示例''' ===
 
<pre>
 
<pre>
<?xml version="1.0" encoding="utf-8" ?>
+
<geoResult>
<xml>
+
   <address>
   <status>1</status>
+
  <prov_name>北京市</prov_name>  
  <prov_name>北京市</prov_name>  
+
  <city_name>北京市</city_name>  
  <city_name>北京市</city_name>  
+
  <city>0010</city>  
  <city>0010</city>  
+
  <district_name>海淀区</district_name>  
  <district_name>海淀区</district_name>  
+
  <street>北四环西路58</street>
  <address>北四环西路58</address>  
+
  </address>
  </xml>
+
  </geoResult>
 
</pre>
 
</pre>
  
 
=== '''JSON示例''' ===
 
=== '''JSON示例''' ===
 
<pre>
 
<pre>
{
+
{"address":
  "status":1,
+
{
  "prov_name":"\u5317\u4eac\u5e02",
+
  "prov_name":"\u5317\u4eac\u5e02",
  "city_name":"\u5317\u4eac\u5e02",
+
  "city_name":"\u5317\u4eac\u5e02",
  "city":"0010",
+
  "city":"0010",
  "district_name":"\u6d77\u6dc0\u533a",
+
  "district_name":"\u6d77\u6dc0\u533a",
  "address":"\u5317\u56db\u73af\u897f\u8def58"
+
  "street":"\u5317\u56db\u73af\u897f\u8def58"
}  
+
}
 +
}
 
</pre>
 
</pre>
  
第64行: 第66行:
 
:city:坐标所属城市代码
 
:city:坐标所属城市代码
 
:district_name:坐标所属区域
 
:district_name:坐标所属区域
:address:坐标所在地址
+
:street:地址
  
== '''使用示例''' ==
+
== '''其它''' ==
 +
 
 +
===  '''PHP示例''' ===
 +
需要开启PHP的cURL扩展
 
<pre>
 
<pre>
xml:  
+
<?php
http://api.t.sina.com.cn/geocode/geo_to_address.xml?coordinate=116.30987,39.98437&source=appkey
+
//改为你的微博账号,用户名和密码之间用:隔开
 +
$userPwd = 'user@sina.com:pwd';
 +
//改为你微博应用的appkey
 +
$appkey = '0123456789';
 +
 
 +
$url = "http://api.t.sina.com.cn/location/geocode/geo_to_address.xml?coordinate=116.30987,39.98437&source=$appkey";
 +
 
 +
$rst = curlSample($url,$userPwd);
 +
 
 +
echo $rst;
  
json:
+
function curlSample($url,$userPwd,$postFields = '',$header = ''){
http://api.t.sina.com.cn/geocode/geo_to_address.json?coordinate=116.30987,39.98437&source=appkey
+
$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:24的最后版本

目录

geocode/geo_to_address

根据坐标返回地址信息的接口

URL

http://api.t.sina.com.cn/location/geocode/geo_to_address.(json%7Cxml)

支持格式

XML/JSON

HTTP请求方式

GET

是否需要登录

true

请求数限制

true

请求参数

参数 必选 类型及范围 说明
source true string 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份
coordinate true float 需要获取信息的坐标(不支持多组坐标,若有多组只取第一组)

返回结果

XML示例

<geoResult>
  <address>
   <prov_name>北京市</prov_name> 
   <city_name>北京市</city_name> 
   <city>0010</city> 
   <district_name>海淀区</district_name> 
   <street>北四环西路58</street> 
  </address>
 </geoResult>

JSON示例

{"address":
 {
   "prov_name":"\u5317\u4eac\u5e02",
   "city_name":"\u5317\u4eac\u5e02",
   "city":"0010",
   "district_name":"\u6d77\u6dc0\u533a",
   "street":"\u5317\u56db\u73af\u897f\u8def58"
 }
}

字段说明

prov_name:坐标所属省份
city_name:坐标所属城市
city:坐标所属城市代码
district_name:坐标所属区域
street:地址

其它

PHP示例

需要开启PHP的cURL扩展

<?php
//改为你的微博账号,用户名和密码之间用:隔开
$userPwd = 'user@sina.com:pwd';
//改为你微博应用的appkey
$appkey = '0123456789';

$url = "http://api.t.sina.com.cn/location/geocode/geo_to_address.xml?coordinate=116.30987,39.98437&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