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
圖示的旋轉角度,模擬車輛在路線上的實際行駛行為。
選取標記選項
如要自訂消費者應用程式的標記,請按照下列步驟操作:
使用 Google 地圖提供的每個標記屬性
MarkerOptions
。使用建構函式建構
MarkerOptions
。使用「Setter」樣式方法指定自訂屬性。
如要使用自己的 UI 元素,請模仿
MarkerOptions
建構函式提供的模式。如要關閉標記,請將
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)