搜狗地图服务接口 API 参考
包含了所有开发中用到的服务接口实例以及使用方法。
使用前请您认真阅读《搜狗地图API使用条款》,如果您已开始使用,表示您已确认并同意该条款中的所有内容。
为了给您提供稳定的服务,请申请clientid,申请流程请参照用户clientid申请。
参考目录
逆地址解析 Api是将输入的经纬度坐标转换为地址。
逆地址解析请求的http网址:
//api.map.sogou.com/engine/api/regeocoder/output?parameters
其中,output 可能是以下任何一个值:
json(建议)表示以 JavaScript 对象表示法 (JSON) 的形式输出
xml 表示以 XML 的形式输出
参数是否必填说明
points
必填
需要转换的坐标串。 可以为一个或多个坐标点。坐标点用经度坐标+逗号+纬度坐标来表示,多个点用分号隔开。例如:23112,888990;32353,8993233;…….
type
必填
源坐标的所属类型,取值范围:
type=0 sogou坐标
type=1 对应标准经纬度
clientid
可选
clientid参数,表示客户id,用户可以通过申请获得clientid,clientid与客户的域名绑定,并根据用户权限不同绑定了访问次数的限制。如果没有clientid,则请求次数限制在每天2000次。如果访问次数超过这个限制,都需要申请clientid,以便提供更稳定的服务。
contenttype
可选
contenttype参数,用来定义返回内容的编码格式。当无此参数时默认为GBK。
cb
可选
返回结果需要回调的函数名。主要是为浏览器js调用设计。在返回结果格式是xml的时候,此参数失效。缺省值为空。
由请求路径中 output 指定服务的返回格式。
以下是知春路附近的一个逆地址解析的HTTP请求实例:
//api.map.sogou.com/engine/api/regeocoder/json?points=12950035.15625039,4834351.5625&type=0
JSON结果显示如下所示:
{ "response": {
"data": [
{
"address": "知春路甲48-1号",
"province": "",
"pois": [],
"district": "海淀区",
"city": "北京"
}
]
}, "status": "ok" }
以下是知春路附近的一个逆地址解析的HTTP请求实例:
//api.map.sogou.com/engine/api/regeocoder/xml?points=116.332861,39.998635&type=1
XML结果显示如下所示:
王庄路1号海淀区
北京
ok
返回结果包括response、status两个元素。
status元素
服务返回的状态码,会返回以下两个值:
ok 表示服务正常,请求无误。
error 表示返回结果有误,可以通过解析response中的error节点,得到详细的错误信息。
response元素
response包括两中情况,输入参数无误,查询结果正常的情况,查询有误的情况。分别对应status的ok和error状态。
属性名说明
data
匹配到的地址信息数组。每个信息对象有adress、province、city属性。address代表匹配到的地址信息。province代表匹配到的省份。city代表匹配到的城市。
error
当status为error时需要解析此节点。error节点包括id和msg两个元素。错误情况:
id=501 "抱歉,请求参数错误!";
id=500 "抱歉,服务器异常!";
id=502 "抱歉,请求坐标点过量!";