标记自定义
在早期版本的 Consumer SDK 中,您使用 Consumer SDK 的 MarkerStyleOptions
对象自定义标记样式属性。在消费者 SDK v1.0 中,您可以直接使用 Maps SDK 中的 MarkerOptions
对象。
// Centering the marker anchor at (0.5, 0.5) is recommended.
// For vehicle markers, set flat to true to allow the vehicle marker to freely
// rotate flat on the map (rather than always have it face the camera).
MarkerOptions vehicleMarkerOptions = new MarkerOptions()
.flat(true)
.anchor(0.5f, 0.5f)
.icon(vehicleIcon)
.zIndex(1.0f);
consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE);
如果样式尚未设置或者样式选项已设置为 null
,ConsumerMapStyle
会返回给定标记类型由 SDK 指定的默认样式选项。
// ConsumerMapStyle returns the SDK-set default style options if none has been set yet.
MarkerOptions defaultPickupPointStyleOptions = consumerMapStyle.getMarkerStyleOptions(MarkerType.PICKUP_POINT);
// Setting the style to null reverts the style back to the SDK-set default properties.
consumerMapStyle.setMarkerStyleOptions(MarkerType.PICKUP_POINT, /* markerStyleOptions= */ null);
MarkerOptions defaultPickupPointStyleOptions = consumerMapStyle.getMarkerStyleOptions(MarkerType.PICKUP_POINT);
如果您不想从头开始创建新样式,可以修改默认样式。以下示例仅修改了取货图标,并为其余标记选项使用 SDK 的默认设置。
// getMarkerStyleOptions returns the default pickup point style options, since
// the custom style hasn't been set yet.
MarkerOptions pickupPointStyleOptions =
consumerMapStyle.getMarkerStyleOptions(MarkerType.PICKUP_POINT);
// Modify the icon value and set the style.
consumerMapStyle.setMarkerStyleOptions(
pickupPointStyleOptions.icon(pickupPointIcon));
多段线自定义
在早期版本的 Consumer SDK 中,您使用 Consumer SDK 的 PolylineStyleOptions
对象自定义多段线样式属性。在 Consumer SDK v1.0 中,您可以使用 Maps SDK 中的 PolylineOptions
对象自定义多段线的基本样式属性,并使用 TrafficStyle
对象自定义多段线路况的颜色。
Consumer SDK v1.0 的 Alpha 变体中提供路况多段线。如果可以看到路况,则基本多段线的颜色会被路况颜色覆盖。默认情况下,系统不会显示路况信息。TrafficStyle
中未设置的字段由 SDK 指定的默认值填充。
// PolylineOptions is from Maps SDK
PolylineOptions polylineOptions = new PolylineOptions()
.color(color)
.width(width)
.geodesic(geodesic)
.startCap(startCap)
.endCap(endCap)
.zIndex(zIndex);
consumerMapStyle.setPolylineStyleOptions(
PolylineType.ACTIVE_ROUTE, polylineOptions);
// TrafficStyle is from ConsumerSDK
TrafficStyle trafficStyle = TrafficStyle.builder()
.setTrafficVisibility(true)
.setTrafficColor(SpeedType.NO_DATA, Color.GREY)
.setTrafficColor(SpeedType.NORMAL_VALUE, Color.BLUE)
.setTrafficColor(SpeedType.SLOW_VALUE, Color.ORANGE)
.setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
.build();
consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle);
如果未设置任何多段线类型,或者样式选项设置为 null
,ConsumerMapStyle
会返回 SDK 针对给定多段线类型的默认样式选项。这适用于基本 PolylineOptions
和 TrafficStyle
。
// ConsumerMapStyle returns the SDK's default style options if none has been set yet.
PolylineOptions defaultActiveRouteStyleOptions = consumerMapStyle.getPolylineStyleOptions(PolylineType.ACTIVE_ROUTE);
// Setting the style to null reverts the style back to the SDK-set default properties.
consumerMapStyle.setPolylineStyleOptions(
PolylineType.ACTIVE_ROUTE, /* polylineStyleOptions= */ null);
PolylineOptions defaultActiveRouteStyleOptions =
consumerMapStyle.getPolylineStyleOptions(PolylineType.ACTIVE_ROUTE);
如果您不想从头开始创建新样式,可以修改默认样式。以下示例仅修改活跃路线多段线的基本颜色,并针对其余标记选项使用 SDK 的默认样式设置。
// Only customize the remaining route polyline color.
PolylineOptions remainingRouteStyleOptions =
consumerMapStyle.getPolylineStyleOptions(PolylineType.REMAINING_ROUTE);
consumerMapStyle.setPolylineStyleOptions(
remainingRouteStyleOptions.color(Color.DARK_BLUE));