自定义标记

请选择平台： 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 的构造函数构建 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)

后续步骤