Polylinien für Routen anpassen

Plattform auswählen: Android iOS JavaScript

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

Zum Wiederherstellen der Standardwerte rufen Sie setPolylineStyleOptions mit null für den Parameter PolylineOptions auf.

Zum Abrufen des aktiven PolylineOptions verwenden Sie die Methode getPolylineStyleOptions.

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.

  • Um benutzerdefinierte Eigenschaften anzugeben, verwenden Sie Setter-Stilmethoden. 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 findest du in der Android-Entwicklerdokumentation unter PolylineOptions.

Beispiel

Java

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

Kotlin

// 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 Wegpunkt der aktiven Route der letzte Wegpunkt 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

Java

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

Kotlin

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

Polylinien mit Verkehrserkennung

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 zu Polylinie.

In Google-Karten wird die Verkehrslage als eine 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

Java

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

Kotlin

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