腾讯 Static Maps API 开发人员指南

欢迎阅读静态地图API开发人员文档!在 腾讯 Static Maps API中,您只需要根据文档说明,传递适当的参数,腾讯 Static Maps API便会以图片的形式传回您所需要的地图。比如,您想创建一个宽604像素,高300像素,中心点为天安门广场,放大级别为16的地图,你可以设设置如下参数:

http://st.map.qq.com/api?size=604*300&center=116.39782,39.90611&zoom=16

把上面的链接做为页面上img元素的src属性值即可,如下所示:

URL格式

http://st.map.qq.com/api?parameters

parameters

参数名描述是否必须
size静态图片的大小必须
center中心点必须
zoom缩放级别必须
format图片格式可选,默认gif
markers点标记可选
paths线标记可选

size

格式:size=X*Y,其中X为水平方向的大小,Y为垂直方向的大小,两者均为整数。

取值范围: X : [50,1680], Y : [50,1200]。

下面的示例创建了一个宽300像素,高200像素的地图。

http://st.map.qq.com/api?size=300*200&center=116,39&zoom=8

format

格式: format=F。

取值范围: gif(default), png, jpg, png8。

下面的示例返回了一个png格式的地图图片,注意和上例图片格式的区别。

http://st.map.qq.com/api?size=300*200&center=116,39&zoom=8&format=png

center和zoom

格式: center=x,y&zoom=z 其中x,y分别为经度和纬度,精确到小数点后6位数字,z为整数

取值范围: x :[73.5 , 135],y :[3.5 , 53],z :[4, 17]

下面的示例创建了一个中心点为银科大厦的地图。

http://st.map.qq.com/api?size=300*200&center=116.30613,39.98219&zoom=16

markers

格式:

markers= markerDescriptor1|markerDescriptor2|……|markerDescriptorN

markerDescriptor : x ,y{,color|markerIconID}{,character}

参数名 描述 是否必须 取值范围
x 经度 必须 [73.5 , 135]
y 维度 必须 [3.5 , 53]
color 颜色 可选 ,该参数在使用自定义marker时无效 red/yellow/blue,默认为red
character marker序号 可选,默认无序号 [a,z]、[A,Z]、[0,9],使用字母序号color为必选项,在无color的情况下,b代码起点,e代表终点
markers 点标记 可选
N markerDescriptor的个数 可选 [1,50]

注:在markerDescriptor的第三个参数位上,用户可以选择使用默认marker或者自定义marker。使用默认marker时,可以选择3种颜色;使用自定义marker时,marker的表现完全由用户自定义。另外,多个marker时,第三参数位是可以继承的,无论是默认marker还是自定义marker。譬如用户想添加4个蓝色的默认marker,则只将第一个marker的color位设置为blue,后续的marker就不需要设置了,如果在中间改变了颜色,那么其后面的marker都采用新颜色。

示例:使用默认marker,添加两个蓝色的默认marker,分别标注序号1,2

http://st.map.qq.com/api?size=604*300&center=116.31993,40.03304&zoom=13&
markers=116.31993,40.03304,1|116.31634,40.02369,2

paths

格式:

paths=pathDescriptor1|pathDescriptor2|……|pathDescriptorN

pathDescriptor:{ color:xxxx,}{weight:xxxx,}x1,y1,x2,y2,……

参数名 描述 是否必须 取值范围
color 线的颜色 可选,默认为蓝色 可以为标准RGB或者RGBA格式,如果用前者则无法设置透明度,默认透明度为50%
weight 线宽 可选,默认为1 [1 , 20],单位为像素
x,y 组成path的经纬度点 必须,且至少为两个经纬度点 x : [73.5 , 135] y :[3.5 , 53]
N 线的个数 可选,默认无序号 [1,5]

注:多个path的情况下,pathDescriptor的第一和第二参数位是可以继承的;

示例:从城铁上地站到北京体育大学画一条线。

http://st.map.qq.com/api?size=604*300&center=116.31917,40.02984&zoom=14&
paths=color:0x0000FF,weight:5,116.31993,40.03304,116.31634,40.02369