Polylinien für Routen anpassen

Plattform auswählen: Android iOS JavaScript

Sie passen Routenpolylinien mit der Methode ConsumerMapStyle.setPolylineStyleOptions an. Wenn Sie benutzerdefinierte Polylinienoptionen festlegen, werden die Standardwerte des Consumer SDK überschrieben.

Standardwerte wiederherstellen: 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.

Polylinien für Routen

Sie können die folgenden Arten von Routenpolylinien anpassen:

  • ACTIVE_ROUTE
  • REMAINING_ROUTE

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

Eigenschaften von Routenpolylinien

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

  • Verwenden Sie den Konstruktor, um PolylineOptions zu erstellen.

  • Benutzerdefinierte Eigenschaften angeben: Verwenden Sie Methoden im „Setter“-Stil. Da die Methode Standardwerte für jede Eigenschaft bereitstellt, müssen Sie nur benutzerdefinierte Werte angeben.

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

Weitere Informationen finden Sie 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 Funktion zum Teilen von Routen aktiviert ist, kann Ihre App die Nutzererfahrung anpassen, indem sie Polylinien verwendet, um die aktive und die verbleibende Route für Ihr Fahrzeug anzuzeigen.

  • Die aktive Route 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 nach der aktiven Route noch zurücklegen muss. Wenn der aktive Routen-Wegpunkt der letzte Wegpunkt der Fahrt ist, ist die verbleibende Route nicht vorhanden.

Sie können die Sichtbarkeit von aktiven und verbleibenden Polylinien in Ihrer App anpassen und steuern. Standardmäßig ist die aktive Route sichtbar und die verbleibende Route nicht.

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 Verkehrsdaten

Die Verkehrsebene der Polylinie ist standardmäßig deaktiviert. Wenn Sie diese Option aktivieren, werden Segmente über der Routen-Polylinie gerendert, die Abschnitte mit nicht normalem Verkehrsaufkommen darstellen. Sie enthält einen Offset, der von der Verkehrslage abhängt. Weitere Informationen finden Sie in der Android-Entwicklerdokumentation unter Polyline.

In Google Maps wird die Verkehrslage als einer 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.
int orange = Color.rgb(255, 165, 0);
TrafficStyle trafficStyle = TrafficStyle.builder()
  .setTrafficVisibility(true)
  .setTrafficColor(SpeedType.NO_DATA, Color.GREY)
  .setTrafficColor(SpeedType.NORMAL, Color.BLUE)
  .setTrafficColor(SpeedType.SLOW, orange)
  .setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
  .build();

consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle);

Kotlin

// TrafficStyle is part of the Consumer SDK.
val orange = Color.rgb(255, 165, 0)
val trafficStyle =
  TrafficStyle.builder()
    .setTrafficVisibility(true)
    .setTrafficColor(SpeedType.NO_DATA, Color.GRAY)
    .setTrafficColor(SpeedType.NORMAL, Color.BLUE)
    .setTrafficColor(SpeedType.SLOW, orange)
    .setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
    .build()

consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle)