自訂基本標記

選取平台： 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();