Anpassung von Version 1 des Android Consumer SDK

Markierungen anpassen

In früheren Versionen des Consumer SDKs haben Sie das MarkerStyleOptions-Objekt des Consumer SDKs verwendet, um Eigenschaften des Markierungsstils anzupassen. Im Consumer SDK v1.0 verwenden Sie das MarkerOptions-Objekt direkt aus dem 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);

Hinweis :Da MarkerStyleOptions und die zugehörigen Standardstileinstellungen eingestellt werden, definiert das Consumer SDK eigene Standardstileinstellungen für jeden Markierungs- oder Polylinientyp. Die in MarkerOptions enthaltenen Standardstileinstellungen werden nicht mehr verwendet.

ConsumerMapStyle gibt die vom SDK festgelegten Standardstiloptionen für einen bestimmten Markierungstyp zurück, wenn der Stil noch nicht festgelegt wurde oder die Stiloptionen auf null gesetzt wurden.

// 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);

Wenn Sie keinen neuen Stil von Grund auf neu erstellen möchten, können Sie den Standardstil ändern. Im folgenden Beispiel wird nur das Symbol für die Abholstelle geändert. Für die restlichen Markierungsoptionen werden die Standardeinstellungen des SDK verwendet.

// 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));

Polylinienanpassung

In früheren Versionen des Consumer SDKs haben Sie das PolylineStyleOptions-Objekt des Consumer SDKs verwendet, um Polylinienstileigenschaften anzupassen. Im Consumer SDK v1.0 verwenden Sie das PolylineOptions-Objekt aus dem Maps SDK, um die Eigenschaften des Polylinienstils für die Basiskarte anzupassen, und das TrafficStyle-Objekt, um die Farben für Polylinien für den Verkehr anzupassen.

Verkehrspolylinien sind in der Alphaversion des Consumer SDK v1.0 verfügbar. Wenn Verkehrsbehinderungen sichtbar sind, wird die Farbe der Basispolylinie von den Farben für Verkehrsbehinderungen überschrieben. Traffic ist standardmäßig nicht sichtbar. Nicht festgelegte Felder in TrafficStyle werden mit den vom SDK angegebenen Standardwerten ausgefüllt.

// 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 gibt die Standardstiloptionen des SDK für einen bestimmten Polylinientyp zurück, wenn noch keine festgelegt wurden oder die Stiloptionen auf null gesetzt sind. Das gilt sowohl für die BasisPolylineOptions als auch für die 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);

Wenn Sie keinen neuen Stil von Grund auf neu erstellen möchten, können Sie den Standardstil ändern. Im folgenden Beispiel wird nur die Farbe der Polylinie der aktiven Route geändert. Für die restlichen Markierungsoptionen werden die Standardstileinstellungen des SDKs verwendet.

// Only customize the remaining route polyline color.
PolylineOptions remainingRouteStyleOptions =
     consumerMapStyle.getPolylineStyleOptions(PolylineType.REMAINING_ROUTE);
consumerMapStyle.setPolylineStyleOptions(
  remainingRouteStyleOptions.color(Color.DARK_BLUE));