使用自定义视图创建标记

您可以使用 MarkerView 在 3D 地图上将自定义 Android View 层次结构呈现为标记。借助自定义视图标记，您可以显示锚定到地理坐标的丰富界面布局、互动式微件和视图动画。

注意： 与以较低开销呈现的标准 3D 标记 (Marker)相比，自定义视图标记 (MarkerView)提供更高的自定义程度和互动性。对于包含大量 标记的应用，建议使用通过 Marker 添加的标准 addMarker 实例，以保持最佳性能。

添加自定义视图标记

如需向地图添加自定义视图标记，请创建一个 MarkerViewOptions 实例，使用 setPosition 对象通过 LatLngAltitude 配置其位置，并使用 setContent提供自定义 Android View。 然后，将这些选项传递给 addMarkerView 实例上的 GoogleMap3D 。

如果您未向 setContent提供视图，则 SDK 会创建并呈现默认 PinView。

// Add imports
import android.widget.TextView
import com.google.android.gms.maps3d.model.MarkerViewOptions
import com.google.android.gms.maps3d.model.latLngAltitude

// Create a custom Android View
val badgeView = TextView(context).apply {
    text = "Empire State Building"
    contentDescription = "Marker for Empire State Building"
    setPadding(24, 12, 24, 12)
}

// Configure MarkerViewOptions and add the marker view to the map
val options = MarkerViewOptions().apply {
    position = latLngAltitude {
        latitude = 40.7484
        longitude = -73.9857
        altitude = 100.0
    }
    content = badgeView
}

val markerView = googleMap3D.addMarkerView(options)

自定义默认 PinView

您可以创建具有自定义 PinConfiguration 的 PinView（或使用 setPinConfiguration 更新现有实例），并将其传递给 setContent，从而呈现自定义图钉，而无需构建完全自定义的 Android View。

// Add imports
import android.graphics.Color
import com.google.android.gms.maps3d.model.MarkerViewOptions
import com.google.android.gms.maps3d.model.PinView
import com.google.android.gms.maps3d.model.latLngAltitude
import com.google.android.gms.maps3d.model.pinConfiguration

// Create a customized PinView
val customPinView = PinView(context, pinConfiguration {
    backgroundColor = Color.BLUE
    borderColor = Color.WHITE
})

// Configure MarkerViewOptions and add the marker view to the map
val options = MarkerViewOptions().apply {
    position = latLngAltitude {
        latitude = 40.7484
        longitude = -73.9857
        altitude = 100.0
    }
    content = customPinView
}

val markerView = googleMap3D.addMarkerView(options)

处理互动和动画

由于 MarkerView 封装了 Android View，因此您可以将标准点击监听器和视图 动画直接附加到 getContent返回的视图。

此外， MarkerView 还实现了 Anchorable， 让您可以使用 addPopover将 Popover 锚定到标记视图：

markerView?.content?.setOnClickListener { view ->
    // Animate the view when clicked
    view.animate().rotationBy(90f).setDuration(300).start()
}

配置海拔高度和冲突行为

您可以自定义 MarkerView 的垂直定位方式以及它与重叠的地图标签或 标记的互动方式：

• 海拔高度模式：使用AltitudeMode常量对MarkerViewOptions调用setAltitudeMode。默认情况下， MarkerViewOptions 使用 AltitudeMode.CLAMP_TO_GROUND。
• 冲突行为：使用 CollisionBehavior常量（默认为 CollisionBehavior.REQUIRED）调用 setCollisionBehavior，并在标记发生冲突时使用 setCollisionPriority指定显示优先级。

无障碍功能和移除

您负责在提供给 setContent的自定义 Android View上配置无障碍功能属性，例如 contentDescription。

如需从地图中移除 MarkerView ，请调用 remove：

markerView?.remove()