自訂標記

選取平台： Android iOS JavaScript

ConsumerMapStyle 類別提供 setter 和 getter 方法，並可自訂標記和折線的動態自訂功能。您可以使用 ConsumerController.getConsumerMapStyle() 方法，以非同步方式公開此類別。

在裝置旋轉時，UI 自訂設定會持續保留，並在您卸除 ConsumerController 前持續生效。

自訂標記

如要設定標記類型及其屬性，請使用 ConsumerMapStyle.setMarkerStyleOptions() 方法。您的自訂標記選項會覆寫 Consumer SDK 提供的預設值。如要還原預設值，請使用 null 為 MarkerOptions 參數呼叫 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 建構函式提供的模式，藉此使用自己的 UI 元素。

  5. 如要關閉標記，請將 visible 屬性設為 false。接著，您就可以使用自己的 UI 元素。

詳情請參閱 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)

後續步驟