自訂標記

選取平台： 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. 如要使用自己的 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)

後續步驟