Polylinien für Routen anpassen

Sie können Routenpolylinien mit der Methode ConsumerMapStyle.setPolylineStyleOptions anpassen. Wenn Sie benutzerdefinierte Polylinienoptionen festlegen, werden die Standardwerte des Consumer SDK überschrieben.

Wenn Sie die Standardwerte wiederherstellen möchten, rufen Sie setPolylineStyleOptions mit null für den Parameter PolylineOptions auf.

Verwenden Sie die Methode getPolylineStyleOptions, um die aktive PolylineOptions abzurufen.

Weitere Informationen finden Sie unter ConsumerMapStyle.setPolylineStyleOptions.

Polylinientypen für Routen

Sie können die folgenden Polylinientypen für Routen anpassen:

• ACTIVE_ROUTE
• REMAINING_ROUTE

ACTIVE_ROUTE und REMAINING_ROUTE werden angezeigt, während Sie einer Fahrt folgen, und stellen die Route des Fahrzeugs dar.

Eigenschaften von Routenpolylinien

Google Maps bietet für jede Polylinie in PolylineOptions anpassbare Eigenschaften.

• Verwenden Sie den Konstruktor, um PolylineOptions zu erstellen.

• Verwenden Sie Methoden im Stil von „Setter“, um benutzerdefinierte Eigenschaften anzugeben. Da die Methode Standardwerte für jede Property bereitstellt, müssen Sie nur benutzerdefinierte Werte angeben.

• Wenn Sie die Polylinie deaktivieren möchten, setzen Sie visible auf false.

Weitere Informationen finden Sie in der Android-Entwicklerdokumentation unter PolylineOptions.

Beispiel

// Initializing polyline style options.
consumerController
    .getConsumerMapStyle()
    .addOnSuccessListener(
        consumerMapStyle -> {
          consumerMapStyle.setPolylineStyleOptions(
              PolylineType.ACTIVE_ROUTE,
              new PolylineOptions()
                  .visible(false));
        });

// Reset polyline options to default values.
consumerMapStyle.setPolylineStyleOptions(PolylineType.ACTIVE_ROUTE, null);

// Initializing polyline options.
consumerController
  .getConsumerMapStyle()
  .addOnSuccessListener({ consumerMapStyle ->
    consumerMapStyle.setPolylineStyleOptions(
      PolylineType.ACTIVE_ROUTE,
      PolylineOptions().visible(false)
    )
  })

// Reset polyline options to default values.
consumerMapStyle.setPolylineStyleOptions(PolylineType.ACTIVE_ROUTE, null)

Aktive und verbleibende Route

Wenn die Freigabe von Fahrten aktiviert ist, kann Ihre App die Nutzung für Nutzer mithilfe von Polylinien anpassen, um die aktive und verbleibende Route für Ihr Fahrzeug anzuzeigen.

• Der aktive Weg ist der Weg, den das Fahrzeug gerade zurücklegt, um den nächsten Wegpunkt der aktiven Fahrt des Nutzers zu erreichen.

• Die verbleibende Route ist der Weg, den das Fahrzeug noch zurücklegen muss, nachdem es die aktive Route passiert hat. Wenn der aktive Wegpunkt der Route der letzte Wegpunkt der Fahrt ist, existiert die verbleibende Route nicht.

Sie können die Sichtbarkeit aktiver und verbleibender Polylinien in Ihrer App anpassen und steuern. Standardmäßig ist nur die aktive Route sichtbar.

Beispiel

// Initializing polyline options.
consumerController
    .getConsumerMapStyle()
    .addOnSuccessListener(
        consumerMapStyle -> {
          consumerMapStyle.setPolylineStyleOptions(
              PolylineType.ACTIVE_ROUTE,
              new PolylineOptions()
                  .color(Color.BLUE));
          consumerMapStyle.setPolylineStyleOptions(
              PolylineType.REMAINING_ROUTE,
              new PolylineOptions()
                  .color(Color.BLACK)
                  .width(5)
                  .visible(true));
        });

// Reset polyline options to default values.
consumerMapStyle.setPolylineStyleOptions(PolylineType.ACTIVE_ROUTE, null);
consumerMapStyle.setPolylineStyleOptions(PolylineType.REMAINING_ROUTE, null);

// Initializing polyline options.
consumerController
  .getConsumerMapStyle()
  .addOnSuccessListener({ consumerMapStyle ->
    {
      consumerMapStyle.setPolylineStyleOptions(
        PolylineType.ACTIVE_ROUTE,
        PolylineOptions().color(Color.BLUE)
      )

      consumerMapStyle.setPolylineStyleOptions(
        PolylineType.REMAINING_ROUTE,
        PolylineOptions().color(Color.BLACK).width(5).visible(true)
      )
    }
  })

// Reset polyline options to default values.
consumerMapStyle.setPolylineStyleOptions(PolylineType.ACTIVE_ROUTE, null)

consumerMapStyle.setPolylineStyleOptions(PolylineType.REMAINING_ROUTE, null)

Verkehrsabhängige Polylinien

Die Verkehrsebene der Polylinie ist standardmäßig deaktiviert. Wenn Sie diese Option aktivieren, zeichnet der Renderer Segmente über der Routenpolylinie, die Abschnitte mit nicht normalem Verkehr darstellen. Sie enthält einen Versatz, der von der Verkehrslage abhängt. Weitere Informationen finden Sie in der Android-Entwicklerdokumentation für Polyline.

In Google Maps werden die Verkehrsbedingungen mithilfe von vier Geschwindigkeitstypen dargestellt. Sie können die Farbe für jeden Geschwindigkeitstyp anpassen.

Wenn Sie verkehrsabhängige Polylinien aktivieren möchten, erstellen Sie ein TrafficStyle-Objekt und übergeben Sie es dann an ConsumerMapStyle, indem Sie setPolylineTrafficStyle() aufrufen.

Beispiel

// TrafficStyle is part of the Consumer SDK.
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);

// TrafficStyle is part of the Consumer SDK.
val 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)