<QMapMarker /> Component API

Props

Prop Type Default Note
title String 设置 Marker 的标题. 当仅设置 <QMapMarker /> 而不给它附加 <QMapCallout /> 时,将展示一个默认的使用 Marker 的 titledescription 的气泡(当设置这两个属性时)。
description String 设置 Marker 的描述. 当仅设置 <QMapMarker /> 而不给它附加 <QMapCallout /> 时,将展示一个默认的使用 Marker的 titledescription 的气泡当设置这两个属性时)。
image ImageSource 用于渲染 Marker 的图片
coordinate LatLngWithType Marker 的位置
flat Boolean false 是否平贴地图(仅 Adr 生效)
identifier String id
draggable Boolean false 是否可以拖拽
stopPropagation Boolean false 停止 onPress 事件的传递,设置为 true 时将阻止 MapView 的 onPress 事件被触发 Note: iOS only. Android 不会传递 onPress 事件 #1132
opacity Float 1.0 Marker 透明度
calloutOffset Float Marker高度 控制气泡偏移量,仅能控制 y 值偏移量,如:10(正数为向上偏移)(Adr: 60001232生效)
centerOffset Point Marker点渲染偏移 控制Maker渲染时相对于坐标点的偏移,正方向为向右向下,(Android仅支持y轴)
zIndex Integer 11 控制Marker显示图层,数字越大显示时会在上层,不指定时先添加在下层,后添加的在上层,默认地图上路线的zIndex为0,路线的转折点为10,为保证marker显示在路线和转折点之上,框架Api默认设置为11

Events

Event Name Returns Notes
onPress { coordinate: LatLng, position: Point } 点击 Marker
onSelect { coordinate: LatLng, position: Point } 地图中的 Marker 被选中,当 Callout 出现前回调 Note: iOS only.
onDeselect { coordinate: LatLng, position: Point } 地图中的 Marker 取消选中,当 Callout 消失时回调 Note: iOS only.
onCalloutPress { coordinate: LatLng, position: Point } Callout 被点击
onDragStart { coordinate: LatLng, position: Point } Marker 开始被拖拽(Marker必须允许拖拽)
onDrag { coordinate: LatLng, position: Point } Marker 被拖拽中(Marker必须允许拖拽)
onDragEnd { coordinate: LatLng, position: Point } Marker 被拖拽完毕,可以通过 setState 重新设置 Marker 的 corrdinate 属性(Marker必须允许拖拽)

Methods

Method Name Arguments Notes
showCallout 显示 Marker 的气泡
hideCallout 隐藏 Marker 的气泡

Types

type LatLng {
  latitude: Number,
  longitude: Number,
}
type LatLngWithType {
  latitude: Number,
  longitude: Number,
  // 以下参数为可选参数,不输入时根据坐标判断
  isAboard: Boolean,
  coordinateType: 'BD09' 
}
type Point {
  x: Number,
  y: Number,
}