搜狗地图服务接口 API 参考

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

服务目录

简介

    静态图服务是搜狗地图API Web Service服务,是标准HTTP协议,返回地图图片。该地图图片可以用img标签的src属性引用。 用户可以指定图片的尺寸、地图的显示范围(包含中心点和缩放级别),还可以放置一些位置标记在地图上,同时可以指定地图标记的样式,用以生成符合需求的地图图片。

静态图请求

静态图请求的http网址:

                        //api.go2map.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.go2map.com/engine/api/static/image+{'points':'搜狐网络大厦','city':'北京'}.png
                

设定图片宽高

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

参数名必填默认值说明
width 500 返回图片的宽度,最大宽度为1500。
height 400 返回图片的高度,最大高度1500。

HTTP请求URL:

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

设定中心点和级别

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

参数名必填默认值说明
center 12956000,4824875 地图图片的中心点。类型:搜狗坐标或地名。经度与纬度用逗号隔开。例如"center":"上海"。如果指定中心点为地名,为了确保准确性,需要指定city。
zoom 10 地图的显示级别,取值范围在[0-18]。

HTTP请求URL:

                       //api.go2map.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.go2map.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.go2map.com/engine/api/static/image+{'points':'搜狐网络大厦','city':'北京','baseRMP':'191'}.png