搜狗地图服务接口 API 参考

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

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

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

服务目录

静态图服务是搜狗地图API Web Service服务，是标准HTTP协议，返回地图图片。该地图图片可以用img标签的src属性引用。

用户可以指定图片的尺寸、地图的显示范围(包含中心点和缩放级别)，还可以放置一些位置标记在地图上，同时可以指定地图标记的样式，用以生成符合需求的地图图片。

静态图请求的http网址：

//api.map.sogou.com/engine/api/static/image+parameters.png

其中，parameters 是静态图api图片请求的参数。类型是json格式的。例如：{"points":"搜狐网络大厦","center":"搜狐网络大厦"}。详细的参数解释请参见请求参数说明。

请求URL的长度不能超过2k。

在图上标的点不能超过50个，如果超过50个，多余的点将不画在图片上。

同一个ip每分钟最多请求60次。

参数名必填默认值说明

points

否

需要标注的的坐标点的地址或搜狗坐标。不同的标注点用|隔开。例如"points":"五道口|融科咨询中心c座|12956000,4824875"，现最多支持50个点。多余50的点将不做处理。如果标注点中有地点名称，为确保点位置的准确性，可以指定city。.

pss

否

S1980

标注点的样式id。可以为多个标注点指定样式。如果points有多个坐标点，多个样式id用“|”隔开。pss的取值范围是：｛S1756|S1766|S1922|S1980|S1890|S1891|S1892|S1893

|S1894|S1895|S1896|S1897|S1898|S1899｝。

labels

否

标注点需要显示的标题，多个用“|”隔开，顺序需要和points中指定的坐标点的顺序保持一致。

width

否

500

返回图片的宽度，最大宽度为1500。

height

否

400

返回图片的高度，最大高度1500。

center

否

12956000,4824875

地图图片的中心点。类型：搜狗坐标或地名。经度与纬度用逗号隔开。例如"center":"上海"。如果指定中心点为地名，为了确保准确性，需要指定city。

zoom

否

10

地图的显示级别，取值范围在[0-18]。

city

否

全国

城市名称，传简称即可(北京市传北京即可)。当points和center中有地名时此参数才有效。

clientid

否

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

baseRMP

否

174

出图类型，普通图片或移动设备使用图片。如：baseRMP=174表示为普通图片；baseRMP=191表示为在移动端使用的简版高清图(内容缩减，色彩减淡，字体显大，体积略小)。简版高清图

简单样例

返回500x400,中心点在北京,地图级别是10的一张图片。

HTTP请求URL：

//api.map.sogou.com/engine/api/static/image+{'points':'搜狐网络大厦','city':'北京'}.png

设定图片宽高

返回450x550,中心点在北京,地图级别是10的一张图片。 设置参数列表：

参数名必填默认值说明

width

否

500

返回图片的宽度，最大宽度为1500。

height

否

400

返回图片的高度，最大高度1500。

HTTP请求URL：

//api.map.sogou.com/engine/api/static/image+{'height':450,'width':550}.png

设定中心点和级别

返回450x550,中心点在上海,地图级别是9的一张图片。 设置参数列表：

参数名必填默认值说明

center

否

12956000,4824875

地图图片的中心点。类型：搜狗坐标或地名。经度与纬度用逗号隔开。例如"center":"上海"。如果指定中心点为地名，为了确保准确性，需要指定city。

zoom

否

10

地图的显示级别，取值范围在[0-18]。

HTTP请求URL：

//api.map.sogou.com/engine/api/static/image+{'height':450,'width':550,'zoom':9,'center':'上海'}.png

添加覆盖物

返回450x550,画出搜狐网络大厦的例子。在设置过zoom和cente之后，落在相应区域外的点将不会显示。 设置参数列表：

参数名必填默认值说明

points

否

需要标注的的坐标点的地址或搜狗坐标。不同的标注点用|隔开。例如"points":"五道口|融科咨询中心c座|12956000,4824875"，现最多支持50个点。多余50的点将不做处理。如果标注点中有地点名称，为确保点位置的准确性，可以指定city。.

pss

否

S1980

标注点的样式id。可以为多个标注点指定样式。如果points有多个坐标点，多个样式id用“|”隔开。pss的取值范围是：｛S1756|S1766|S1922|S1980|S1890|S1891|S1892|S1893|S1894|S1895|S1896|S1897|S1898|S1899｝。

labels

否

标注点需要显示的标题，多个用“|”隔开，顺序需要和points中指定的坐标点的顺序保持一致。

city

否

全国

城市名称，传简称即可(北京市传北京即可)。当points和center中有地名时此参数才有效。

HTTP请求URL：

//api.map.sogou.com/engine/api/static/image+{'points':'搜狐网络大厦',height:'450','width':550,'zoom':9,'center':'12956000,4824875',labels:'搜狐网络大厦',pss:'S1756',city:'北京'}.png

简版高清图

在移动端获取简版高清图，baseRMP=191,500x400,中心点在北京,地图级别是10的一张图片。

HTTP请求URL：

//api.map.sogou.com/engine/api/static/image+{'points':'搜狐网络大厦','city':'北京','baseRMP':'191'}.png