自定义基本标记

请选择平台： Android iOS JavaScript

纽约市的 3D 图像，其中包含帝国大厦，上方漂浮着三个自定义数字标记，包括一个标有“King Kong”字样的卡通大猩猩

您可以使用 pinConfiguration 构造函数自定义标记的外观。pinConfiguration 构造函数提供了一些方法，用于更改背景和边框颜色、字形文本和颜色、海拔高度、要使用的图片，以及用于进一步自定义的其他选项。

以下代码示例展示了如何创建新标记并使用一些可用的自定义选项来设置其样式：

map.addMarker(
 markerOptions {
   position = sanFrancisco
   style = pinConfiguration {
     backgroundColor = Color.GREEN
     borderColor = Color.GREEN
     glyph = Glyph.fromColor(Color.RED)
   }
 }
)

本页面介绍了如何通过以下方式自定义标记：

缩放标记
更改背景颜色
更改边框颜色
向字形添加文字
使用图片作为标记
移除标记

缩放标记

如需缩放标记，请使用 scale 选项：

map.addMarker(
 markerOptions {
   position = sanFrancisco
   style = pinConfiguration {
     scale = 3.14
   }
 }
)

更改背景颜色

使用 PinElement.background 选项可在构建期间更改标记的背景颜色：

map.addMarker(
 markerOptions {
   position = sanFrancisco
   style = pinConfiguration {
     backgroundColor = Color.GREEN
   }
 }
)

更改边框颜色

使用 markerOptions.borderColor 选项可在构建期间更改标记的边框颜色：

map.addMarker(
 markerOptions {
   position = sanFrancisco
   style = pinConfiguration {
     borderColor = Color.GREEN
   }
 }
)

向字形添加文字

使用 markerOptions.glyph 方法可将默认字形替换为文本字符。标记的文字字形会随标记一起缩放：

map.addMarker(
 markerOptions {
   position = sanFrancisco
   style = pinConfiguration {
     glyph = Glyph.fromText("G")
   }
 }
)

使用图片作为标记

Map.addMarker(markerOptions {
  position = latLngAltitude {
      latitude = 40.7484
      longitude = -73.9857
      altitude = 100.0
  }
  zIndex = 1
  label = "Empire State Building"
  isExtruded = true
  isDrawnWhenOccluded = true
  altitudeMode = AltitudeMode.RELATIVE_TO_MESH
  setStyle(ImageView(R.drawable.ook))
})

移除标记

使用 Marker.remove() 从地图中移除标记：

marker.remove();