搜狗地图服务接口 API 参考

包含了所有开发中用到的服务接口实例以及使用方法。
使用前请您认真阅读《搜狗地图API使用条款》，如果您已开始使用，表示您已确认并同意该条款中的所有内容。
为了给您提供稳定的服务，请申请clientid，申请流程请参照用户clientid申请。

参考目录

简介

    逆地址解析 Api是将输入的经纬度坐标转换为地址。

逆地址解析请求

逆地址解析请求的http网址：

http://api.go2map.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 指定服务的返回格式。

JSON输出

以下是知春路附近的一个逆地址解析的HTTP请求实例：

http://api.go2map.com/engine/api/regeocoder/json?points=12950035.15625039,4834351.5625&type=0

JSON结果显示如下所示：

{"response":{
    "data":[
        {
            "address":"知春路56号院9号楼",
            "province":"",
            "city":"北京"
        }
    ]
},"status":"ok"}

XML输出

以下是知春路附近的一个逆地址解析的HTTP请求实例：

http://api.go2map.com/engine/api/translate/xml?points=116.317,39.888&type=2

XML结果显示如下所示：

<xml>
    <response>
        <data>
            <address>知春路56号院9号楼</address>
            <province/>
            <city>北京</city>
        </data>
    </response>
    <status>ok</status>
</xml>

结果说明

返回结果包括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 "抱歉,请求坐标点过量！";