Polylinien für Routen anpassen

Plattform auswählen: Android iOS JavaScript

Sie können Routen-Polylinien mit der Methode ConsumerMapStyle.setPolylineStyleOptions anpassen. Wenn Sie benutzerdefinierte Polylinienoptionen festlegen, werden die vom Consumer SDK bereitgestellten Standardwerte überschrieben.

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

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

Weitere Informationen finden Sie unter ConsumerMapStyle.setPolylineStyleOptions.

Polylinientypen für Routen

Sie können die folgenden Arten von Routen-Polylinien anpassen:

• ACTIVE_ROUTE
• REMAINING_ROUTE

ACTIVE_ROUTE und REMAINING_ROUTE werden angezeigt, während eine Fahrt verfolgt wird, und stellen die Route des Fahrzeugs dar.

Eigenschaften der Polylinie für die Route

In Google Maps sind für jede Polylinie in PolylineOptions anpassbare Eigenschaften verfügbar.

• PolylineOptions wird mit dem Konstruktor erstellt.

• Wenn Sie benutzerdefinierte Eigenschaften angeben möchten, verwenden Sie Methoden im „Setter“-Stil. Da die Methode Standardwerte für jedes Attribut 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

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 „Fahrt teilen“ aktiviert ist, kann Ihre App die Nutzererfahrung mithilfe von Polylinien anpassen, um die aktive und verbleibende Route für Ihr Fahrzeug anzuzeigen.

• Die aktive Route ist der Pfad, den das Fahrzeug jetzt zurücklegt, um den nächsten Wegpunkt auf der aktiven Fahrt des Nutzers zu erreichen.

• Die verbleibende Route ist der Weg, den das Fahrzeug noch über die aktive Route hinaus zurücklegen muss. Wenn der Wegpunkt der aktiven Route der letzte Wegpunkt der Fahrt ist, gibt es keine verbleibende Route.

Sie können die Sichtbarkeit aktiver und verbleibender 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)

Verkehrsabhängige Polylinien

Die Verkehrsebene der Polylinie ist standardmäßig deaktiviert. Wenn Sie sie aktivieren, zeichnet der Renderer Segmente über der Polylinie der Route, die Abschnitte mit ungewöhnlichem Verkehrsaufkommen darstellen. Sie enthält einen Versatz, der von der Verkehrslage abhängt. Weitere Informationen finden Sie in der Android-Entwicklerdokumentation unter Polyline.

In Google Maps wird die Verkehrslage durch einen 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 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)