搜狗地图服务接口 API 参考

包含了所有开发中用到的服务接口实例以及使用方法。

使用前请您认真阅读《搜狗地图API使用条款》，如果您已开始使用，表示您已确认并同意该条款中的所有内容。

为了给您提供稳定的服务，请申请clientid，申请流程请参照用户clientid申请。

参考目录

Geocoder根据一个地址类的描述文字，返回其最可能的坐标。

地址解析请求的http网址：

//api.map.sogou.com/engine/api/geocoder/output?parameters

其中，output 可能是以下任何一个值：

json(建议)表示以 JavaScript 对象表示法 (JSON) 的形式输出

xml 表示以 XML 的形式输出

参数是否必填说明

addr

必填

需要coding的地址，必选参数，越详细越好，最好是**省**市**区**路**号格式的.

city

选填

coding时参考的城市，可选参数，如果知道城市最好给city赋值，可以增加准确度。

clientid

选填

clientid参数，表示客户id，用户可以通过申请获得clientid，clientid与客户的域名绑定，并根据用户权限不同绑定了访问次数的限制。如果没有clientid，则请求次数限制在每天2000次。如果访问次数超过这个限制，都需要申请clientid，以便提供更稳定的服务。

contenttype

选填

contenttype参数，用来定义返回内容的编码格式。当无此参数时默认为GBK。

cb

选填

回调函数名，可选参数。

由请求路径中 output 指定服务的返回格式。

以下是一个HTTP请求实例：

//api.map.sogou.com/engine/api/geocoder/json?city=北京市&addr=北京市海淀区中关村东路一号院

JSON结果显示如下所示：

{

"response":

{

"keyword":"北京市海淀区中关村东路一号院",

"match":"海淀区中关村东路一号院7号楼威盛大厦",

"y":4837046.995794,

"city":"北京市",

"x":1.2949190267684E7

},

"status":"ok"

}

以下是一个HTTP请求实例：

//api.map.sogou.com/engine/api/geocoder/xml?city=北京市&addr=北京市海淀区中关村东路一号院

XML结果显示如下所示：

&ltxml>

&ltresponse>

&ltkeyword>北京市海淀区中关村东路一号院&lt/keyword>

&ltmatch>海淀区中关村东路一号院7号楼威盛大厦&lt/match>

&lty>4837046.995794&lt/y>

&ltcity>北京市&lt/city>

&ltx>1.2949190267684E7&lt/x>

&lt/response>

&ltstatus>ok&lt/status>

&lt/xml>

返回结果包括response、status两个元素。

status元素

服务返回的状态码，会返回以下两个值：

ok 表示服务正常，请求无误。

error 表示返回结果有误，可以通过解析response中的error节点，得到详细的错误信息。

response元素

response包括两中情况，输入参数无误，查询结果正常的情况，查询有误的情况。分别对应status的ok和error状态。

属性名说明

keyword

提交的addr参数。

city

所匹配的城市。

match

匹配到的已有地址.

x

匹配到的x坐标.

y

匹配到的y坐标.

error

当status为error时需要解析此节点。error节点包括id和msg两个元素。错误情况：

id=610 "匹配失败！";