Geocode/address to geo

跳转到: 导航, 搜索
第1行: 第1行:
== '''逆地理编码''' ==
+
== '''地理编码''' ==
根据坐标返回地址信息的接口
+
根据地址返回坐标的接口
 +
 
 
== '''URL''' ==
 
== '''URL''' ==
http://api.map.sina.com.cn/geocode/geo_to_address.(json|xml)
+
http://api.map.sina.com.cn/geocode/address_to_geo.(json|xml)
  
 
== '''支持格式''' ==
 
== '''支持格式''' ==
第26行: 第27行:
 
| 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份
 
| 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份
 
|- style="height:20px"  
 
|- style="height:20px"  
| style="text-align:center;" |coordinate
+
| style="text-align:center;" |address
 
| style="text-align:center;" |true
 
| style="text-align:center;" |true
| style="text-align:center;" |float
+
| style="text-align:center;" |string
| 需要获取信息的坐标
+
| 需要获取坐标的地址
 +
|-style="height:20px"
 +
| style="text-align:center;" |city
 +
| style="text-align:center;" |false
 +
| style="text-align:center;" |string
 +
| 所在城市对应代码
 
|}
 
|}
  
第36行: 第42行:
 
===  '''XML示例''' ===
 
===  '''XML示例''' ===
 
<pre>
 
<pre>
<geoSearchResult>
+
  <?xml version="1.0" encoding="UTF-8" ?>  
  <address>
+
  <geoSearchResult>
    <status>1</status>  
+
  <status>1</status>  
    <prov_name>北京市</prov_name>  
+
  <geo>
     <city_name>北京市</city_name>  
+
     <exactitude>1.000000</exactitude>  
     <city>0010</city>  
+
     <name>中国北京市海淀区中关村</name>  
     <district_name>海淀区</district_name>  
+
     <longitude>116.324416</longitude>  
     <street>北四环西路58</street>  
+
     <latitude>39.984213</latitude>  
  </address>
+
  </geo>
</geoSearchResult>
+
  </geoSearchResult>
 
</pre>
 
</pre>
  
 
=== '''JSON示例''' ===
 
=== '''JSON示例''' ===
 
<pre>
 
<pre>
{"address":
+
{
{
+
  "status":1,
   "status":1,
+
  "geo": 
  "prov_name":"\u5317\u4eac\u5e02",
+
  {
  "city_name":"\u5317\u4eac\u5e02",
+
   "exactitude":"1.000000",
  "city":"0010",
+
    "name":"\u4e2d\u56fd\u5317\u4eac\u5e02\u6d77\u6dc0\u533a\u4e2d\u5173\u6751",
  "district_name":"\u6d77\u6dc0\u533a",
+
    "longitude":"116.324416",
  "street":"\u5317\u56db\u73af\u897f\u8def58"
+
    "latitude":"39.984213"
}
+
  }
 
}
 
}
 
</pre>
 
</pre>
  
 
===  '''字段说明 ''' ===
 
===  '''字段说明 ''' ===
:prov_name:坐标所属省份
+
:status:状态
:city_name:坐标所属城市
+
:geo:geo信息
:city:坐标所属城市代码
+
:::exactitude:置信度
:district_name:坐标所属区域
+
:::name:匹配到的地址名称
:street:地址
+
:::longitude:匹配到的坐标经度
 +
:::latitude:匹配到的坐标纬度
  
 
== '''使用示例''' ==
 
== '''使用示例''' ==
 
<pre>
 
<pre>
 
xml:  
 
xml:  
http://api.map.sina.com.cn/geocode/geo_to_address.xml?coordinate=116.30987,39.98437&source=appkey
+
http://api.map.sina.com.cn/geocode/address_to_geo.xml?address=中关村&source=appkey
  
 
json:  
 
json:  
http://api.map.sina.com.cn/geocode/geo_to_address.json?coordinate=116.30987,39.98437&source=appkey
+
http://api.map.sina.com.cn/geocode/address_to_geo.json?address=中关村&source=appkey
 
</pre>
 
</pre>

2011年3月24日 (四) 19:25的版本

目录

地理编码

根据地址返回坐标的接口

URL

http://api.map.sina.com.cn/geocode/address_to_geo.(json%7Cxml)

支持格式

XML/JSON

HTTP请求方式

GET

是否需要登录

false

请求数限制

true

请求参数

参数 必选 类型及范围 说明
source true string 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份
address true string 需要获取坐标的地址
city false string 所在城市对应代码

返回结果

XML示例

  <?xml version="1.0" encoding="UTF-8" ?> 
  <geoSearchResult>
   <status>1</status> 
   <geo>
    <exactitude>1.000000</exactitude> 
    <name>中国北京市海淀区中关村</name> 
    <longitude>116.324416</longitude> 
    <latitude>39.984213</latitude> 
   </geo>
  </geoSearchResult>

JSON示例

{
  "status":1,
  "geo":   
  {
   "exactitude":"1.000000",
    "name":"\u4e2d\u56fd\u5317\u4eac\u5e02\u6d77\u6dc0\u533a\u4e2d\u5173\u6751",
    "longitude":"116.324416",
    "latitude":"39.984213"
  }
}

字段说明

status:状态
geo:geo信息
exactitude:置信度
name:匹配到的地址名称
longitude:匹配到的坐标经度
latitude:匹配到的坐标纬度

使用示例

xml: 
http://api.map.sina.com.cn/geocode/address_to_geo.xml?address=中关村&source=appkey

json: 
http://api.map.sina.com.cn/geocode/address_to_geo.json?address=中关村&source=appkey