ConsumerMapStyle 類別提供 setter 和 getter 方法,可動態自訂標記和折線。您可以使用 ConsumerController.getConsumerMapStyle() 方法,以非同步方式公開這個類別。
即使裝置旋轉,UI 自訂設定仍會保留,直到您卸載 ConsumerController 為止。
自訂標記
如要設定標記類型及其屬性,請使用 ConsumerMapStyle.setMarkerStyleOptions() 方法。自訂標記選項會覆寫 Consumer SDK 提供的預設值。如要還原預設值,請呼叫 setMarkerStyleOptions(),並將 MarkerOptions 參數設為 null。使用 getMarkerStyleOptions() 擷取有效的 MarkerOptions。
選取標記類型
您可以使用及自訂下列標記圖示:
TRIP_PICKUP_POINT:追蹤行程時顯示TRIP_DROPOFF_POINT:追蹤行程時顯示TRIP_INTERMEDIATE_DESTINATIONTRIP_VEHICLE:追蹤行程時顯示在監控行程期間,Consumer SDK 會更新
TRIP_VEHICLE圖示的旋轉角度,模擬實際車輛沿路線行駛的行為。
選取標記選項
如要自訂消費者應用程式的標記,請按照下列步驟操作:
使用 Google 地圖
MarkerOptions為每個標記提供的屬性。使用建構函式建構
MarkerOptions。使用「Setter」樣式方法指定自訂屬性。
您也可以模仿
MarkerOptions建構函式提供的模式,使用自己的 UI 元素。如要關閉標記,請將
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)