2011年3月28日 (一) 18:22的版本

API简介

定位服务根据客户端提供的一系列定位依据数据，通过计算获取一个固定的位置。定位依据主要包括客户端可以检测到的基站或者WIFI相关数据。本文档的主要目的，就是描述如何使用该接口发送定位依据数据至服务器，然后如何解析从服务器返回的位置数据。需要注意的是，客户端与服务器的通讯采用HTTP的方式请求，数据用POST方式向服务器请求，接口接收和返回的数据都是JSON格式，这里要注意的一点是，请求的Content-Type请使用application/json。

定位覆盖范围

目前定位服务只主要支持中国大陆地区。

服务请求地址

http://api.map.sina.com.cn/loc/get_location.(json|xml)

使用实例

客户端请求以及服务器返回举例说明如下

请求定位数据格式

 {
 "version": "1.1.0",
 "source":1433233234
 "host": "api.map.sina.com.cn:80/loc/",
 "radio_type": "gsm",
 "request_address": true,
 "decode_pos":true,
 "location": {
   "latitude": 39.08943,
   "longitude": 116.36843
   "accuracy" :678.0
 },
 "cell_towers": [
   {
     "cell_id": 4466,
     "location_area_code": 26630,
     "mobile_country_code": 460,
     "mobile_network_code": 0,
     "signal_strength": -60,
   },
   {
     "cell_id": 4466,
     "location_area_code": 25054,
     "mobile_country_code": 460,
     "mobile_network_code": 0,
     "signal_strength": -70,
   }
 ],
 "wifi_towers": [
   {
     "mac_address": "00:0B:86:27:99:B0",
     “mac_name”:"Sina-web",
     "signal_strength": 78,   
   },
   {
     "mac_address": "00:0B:86:28:7B:F0",
     “mac_name”:"CMCC",
     "signal_strength": 90,
   }
 ]
 }

服务器返回数据格式(JSON格式）

 {
 "location": {
   "longitude": 116.30951,
   "latitude": 39.98384,
   "accuracy": 49,
   "altitude": 0,
   "altitude_accuracy": 0,
   "address": {
     "province ": "北京市",
     "city": "北京市",
     "citycode": "0010"
     "district": "海淀区",
     "addr": "海淀北二街10",
   }
 },
 }

服务器返回数据格式(XML格式）

<?xml version="1.0" encoding="UTF-8"?> <geoSearchResult><location>

   <longitude>116.30951</longitude>
   <latitude>39.98384</latitude>
   <accuracy>49</accuracy>
   <altitude></altitude>
   <altitude_accuracy></altitude_accuracy>
  <address>
     <province>北京市</province>
     <city>北京市</city>
     <citycode>0010</citycode>
     <district>海淀区</district>
     <addr>海淀北二街10</addr>
  </address>

</location></geoSearchResult>

请求数据格式说明

对请求数据的详细说明如下：

位置对象

基站数据对象

WIFI数据对象，WIFI对于定位这个过程不是必须的，但是对于采用WIFI定位来说，mac_address这个参数是必须的。

服务器返回数据说明

服务器定位成功后，会将定位结果返回客户端，如果定位没有成功，返回结果为空。

地址对象格式定义的具体说明