地图。

属性名	类型	默认值	说明	最低版本
longitude	number		中心经度
latitude	number		中心纬度
scale	number	16	缩放级别，取值范围为5-18
markers	array		标记点
covers	array		即将移除，请使用 markers
polyline	array		路线
circles	array		圆
controls	array		控件
include-points	array		缩放视野以包含所有给定的坐标点
show-location	boolean		显示带有方向的当前定位点
bindmarkertap	eventhandle		点击标记点时触发
bindcallouttap	eventhandle		点击标记点对应的气泡时触发	1.2.0
bindcontroltap	eventhandle		点击控件时触发
bindregionchange	eventhandle		视野发生变化时触发
bindtap	eventhandle		点击地图时触发

注意: covers 属性即将移除，请使用 markers 替代

markers

标记点用于在地图上显示标记的位置

属性	说明	类型	必填	备注	最低版本
id	标记点id	number	否	marker点击事件回调会返回此id
latitude	纬度	number	是	浮点数，范围 -90 ~ 90
longitude	经度	number	是	浮点数，范围 -180 ~ 180
title	标注点名	string	否
iconpath	显示的图标	string	是	项目目录下的图片路径，支持相对路径写法，以'/'开头则表示相对小程序根目录；也支持临时路径
rotate	旋转角度	number	否	顺时针旋转的角度，范围 0 ~ 360，默认为 0
alpha	标注的透明度	number	否	默认1，无透明
width	标注图标宽度	number	否	默认为图片实际宽度
height	标注图标高度	number	否	默认为图片实际高度
callout	自定义标记点上方的气泡窗口	object	否	{content, color, fontsize, borderradius, bgcolor, padding, boxshadow, display}	1.2.0
label	为标记点旁边增加标签	object	否	{color, fontsize, content, x, y}，可识别换行符，x,y原点是marker对应的经纬度	1.2.0
anchor	经纬度在标注图标的锚点，默认底边中点	object	否	{x, y}，x表示横向(0-1)，y表示竖向(0-1)。{x: .5, y: 1} 表示底边中点	1.2.0

marker 上的气泡 callout

属性	说明	类型
content	文本	string
color	文本颜色	string
fontsize	文字大小	number
borderradius	callout边框圆角	number
bgcolor	背景色	string
padding	文本边缘留白	number
display	'byclick':点击显示; 'always':常显	string

polyline

指定一系列坐标点，从数组第一项连线至最后一项

属性	说明	类型	必填	备注	最低版本
points	经纬度数组	array	是	[{latitude: 0, longitude: 0}]
color	线的颜色	string	否	8位十六进制表示，后两位表示alpha值，如：#000000aa
width	线的宽度	number	否
dottedline	是否虚线	boolean	否	默认false
arrowline	带箭头的线	boolean	否	默认false，开发者工具暂不支持该属性	1.2.0
bordercolor	线的边框颜色	string	否		1.2.0
borderwidth	线的厚度	number	否		1.2.0

circles

在地图上显示圆

属性	说明	类型	必填	备注
latitude	纬度	number	是	浮点数，范围 -90 ~ 90
longitude	经度	number	是	浮点数，范围 -180 ~ 180
color	描边的颜色	string	否	8位十六进制表示，后两位表示alpha值，如：#000000aa
fillcolor	填充颜色	string	否	8位十六进制表示，后两位表示alpha值，如：#000000aa
radius	半径	number	是
strokewidth	描边的宽度	number	否

controls

在地图上显示控件，控件不随着地图移动

属性	说明	类型	必填	备注
id	控件id	number	否	在控件点击事件回调会返回此id
position	控件在地图的位置	object	是	控件相对地图位置
iconpath	显示的图标	string	是	项目目录下的图片路径，支持相对路径写法，以'/'开头则表示相对小程序根目录；也支持临时路径
clickable	是否可点击	boolean	否	默认不可点击

position

属性	说明	类型	必填	备注
left	距离地图的左边界多远	number	否	默认为0
top	距离地图的上边界多远	number	否	默认为0
width	控件宽度	number	否	默认为图片宽度
height	控件高度	number	否	默认为图片高度

地图组件的经纬度必填, 如果不填经纬度则默认值是北京的经纬度。

示例：

<!-- map.wxml -->
<map id="map" longitude="113.324520" latitude="23.099994" scale="14" controls="{{controls}}" bindcontroltap="controltap" markers="{{markers}}" bindmarkertap="markertap" polyline="{{polyline}}" bindregionchange="regionchange" show-location style="width: 100%; height: 300px;"></map>

// map.js
page({
  data: {
    markers: [{
      iconpath: "/resources/others.png",
      id: 0,
      latitude: 23.099994,
      longitude: 113.324520,
      width: 50,
      height: 50
    }],
    polyline: [{
      points: [{
        longitude: 113.3245211,
        latitude: 23.10229
      }, {
        longitude: 113.324520,
        latitude: 23.21229
      }],
      color:"#ff0000dd",
      width: 2,
      dottedline: true
    }],
    controls: [{
      id: 1,
      iconpath: '/resources/location.png',
      position: {
        left: 0,
        top: 300 - 50,
        width: 50,
        height: 50
      },
      clickable: true
    }]
  },
  regionchange(e) {
    console.log(e.type)
  },
  markertap(e) {
    console.log(e.markerid)
  },
  controltap(e) {
    console.log(e.controlid)
  }
})

bug & tip