自訂標記

選取平台： 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 圖示的旋轉方向，模擬實際車輛行駛路線的行為。

注意：如要獲得最逼真的動畫結果，請為 TRIP_VEHICLE 使用頂視角，並將車輛前端朝上。

注意：標記圖示不會根據行程的實際車輛類型而變更。

選取標記選項

如要為消費者應用程式自訂標記，請按照下列步驟操作：

1. 使用 Google 地圖 MarkerOptions 提供的每個標記屬性。

2. 使用建構函式建構 MarkerOptions。

3. 使用「Setter」樣式方法指定自訂屬性。

   注意： 由於 SDK 會為每個標記屬性提供預設值，因此請只針對要變更的值指定自訂屬性。

4. 如果您偏好使用自己的 UI 元素，請模仿 MarkerOptions 建構函式提供的模式。

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)

後續步驟

• 自訂路線折線