自定义标记

请选择平台： 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 图标的旋转，以模拟实际车辆在行驶路线时的行为。

注意：为了获得最逼真的动画效果，请为 TRIP_VEHICLE 使用顶视图视角，并将车辆前端朝上。

注意：标记图标不会根据行程的实际车辆类型而更改。

选择标记选项

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

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

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

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

   注意 ：由于 SDK 为每个标记属性提供了默认值，因此请仅为要更改的值指定自定义属性。

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)

后续步骤

• 自定义路线多段线