自定义标记

请选择平台： Android iOS JavaScript

ConsumerMapStyle 类提供了用于为标记和多段线进行动态自定义的 setter 和 getter 方法。您可以使用 ConsumerController.getConsumerMapStyle() 方法异步公开此类。

界面自定义会在设备旋转后保持不变，并在您分离 ConsumerController 之前保持有效。

自定义标记

如需设置标记类型及其属性，请使用 ConsumerMapStyle.setMarkerStyleOptions() 方法。您的自定义标记选项会替换 Consumer SDK 提供的默认值。如需恢复默认值，请为 MarkerOptions 参数使用 null 调用 setMarkerStyleOptions()。使用 getMarkerStyleOptions() 检索有效的 MarkerOptions。

选择标记类型

您可以使用和自定义以下标记图标：

  • TRIP_PICKUP_POINT - 跟踪行程时显示
  • TRIP_DROPOFF_POINT - 跟踪行程时显示
  • TRIP_INTERMEDIATE_DESTINATION

  • TRIP_VEHICLE - 跟踪行程时显示

    在行程监控期间，Consumer SDK 会更新 TRIP_VEHICLE 图标的旋转，以模拟实际车辆在行驶路线时的行为。

选择标记选项

您可以按照以下步骤为您的消费者应用自定义标记：

  1. 使用 Google 地图 MarkerOptions 提供的每个标记的属性。

  2. 使用构造函数构建 MarkerOptions。

  3. 使用“Setter”样式方法指定自定义属性。

  4. 如果您愿意，可以通过模仿 MarkerOptions 构造函数提供的模式来使用自己的界面元素。

  5. 如需关闭标记，请将 visible 属性设置为 false。然后，您可以使用自己的界面元素来替代它。

如需了解详情，请参阅 Google 地图 MarkerOptions。

标记自定义示例

Java

// Initializing marker options.
consumerController
    .getConsumerMapStyle()
    .addOnSuccessListener(
        consumerMapStyle -> {
          consumerMapStyle.setMarkerStyleOptions(
              MarkerType.TRIP_VEHICLE,
              new MarkerOptions()
                  .visible(false));
        });

// Reset marker options to default values.
consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE, null);

Kotlin

// Initializing marker options.
consumerController
  .getConsumerMapStyle()
  .addOnSuccessListener({ consumerMapStyle ->
    consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE, MarkerOptions().visible(false))
  })

// Reset marker options to default values.
consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE, null)

后续步骤