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.

So stellen Sie die Standardwerte wieder her: Rufen Sie setPolylineStyleOptions mit null für den Parameter PolylineOptions auf.

So rufen Sie die aktiven PolylineOptions ab: Verwenden Sie die getPolylineStyleOptions Methode.

Weitere Informationen finden Sie unter ConsumerMapStyle.setPolylineStyleOptions.

Routenpolylinien-Typen

Sie können die folgenden Routenpolylinien-Typen anpassen:

  • ACTIVE_ROUTE
  • REMAINING_ROUTE

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

Routenpolylinien-Eigenschaften

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

  • So erstellen Sie PolylineOptions : Verwenden Sie den Konstruktor.

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

  • So deaktivieren Sie die Polylinie: Legen Sie visible auf false fest.

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

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 Option „Fahrt teilen“ 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 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 Wegpunkt der aktiven Route der letzte Wegpunkt der Fahrt ist, gibt es keine verbleibende Route.

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)

Verkehrsabhängige Polylinien

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

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

So aktivieren Sie verkehrsabhängige Polylinien: 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)