Dostosowywanie znaczników
We wcześniejszych wersjach pakietu SDK dla konsumenta do dostosowywania właściwości stylu znacznika używany był obiekt MarkerStyleOptions pakietu SDK dla konsumenta. W pakiecie Consumer SDK w wersji 1.0 używasz bezpośrednio obiektu MarkerOptions z pakietu Maps SDK.
// 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);
ConsumerMapStyle zwraca opcje stylu domyślnego określone przez pakiet SDK dla danego typu znacznika, jeśli styl nie został jeszcze ustawiony lub jeśli opcje stylu zostały ustawione na null.
// 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);
Jeśli nie chcesz tworzyć nowego stylu od podstaw, możesz zmodyfikować styl domyślny. W poniższym przykładzie zmodyfikowano tylko ikonę odbioru, a w przypadku pozostałych opcji znacznika użyto domyślnych ustawień pakietu 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));
Dostosowywanie linii łamanej
We wcześniejszych wersjach pakietu SDK dla konsumenta do dostosowywania właściwości stylu linii łamanej używany był obiekt PolylineStyleOptions pakietu SDK dla konsumenta. W pakiecie Consumer SDK w wersji 1.0 używasz obiektu PolylineOptions z pakietu Maps SDK, aby dostosować właściwości stylu podstawowej linii łamanej, oraz obiektu TrafficStyle, aby dostosować kolory natężenia ruchu na linii łamanej.
Linie łamane natężenia ruchu są dostępne w wersji alfa pakietu Consumer SDK w wersji 1.0. Jeśli natężenie ruchu jest widoczne, podstawowy kolor linii łamanej jest zastępowany kolorami natężenia ruchu. Domyślnie ruch nie jest widoczny. Pola w TrafficStyle, które nie są ustawione, są wypełniane wartościami domyślnymi określonymi przez pakiet 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);
ConsumerMapStyle zwraca domyślne opcje stylu pakietu SDK dla danego typu linii łamanej, jeśli nie zostały jeszcze ustawione lub jeśli opcje stylu są ustawione na null. Dotyczy to zarówno podstawowego modelu PolylineOptions, jak i 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);
Jeśli nie chcesz tworzyć nowego stylu od podstaw, możesz zmodyfikować styl domyślny. W tym przykładzie zmieniamy tylko kolor podstawowej aktywnej linii łamanej trasy, a w przypadku pozostałych opcji znacznika używamy domyślnych ustawień stylu pakietu SDK.
// Only customize the remaining route polyline color.
PolylineOptions remainingRouteStyleOptions =
consumerMapStyle.getPolylineStyleOptions(PolylineType.REMAINING_ROUTE);
consumerMapStyle.setPolylineStyleOptions(
remainingRouteStyleOptions.color(Color.DARK_BLUE));