Polylinien für Routen anpassen

Plattform auswählen: Android iOS JavaScript

Sie können Polylinien für Routen mithilfe der ConsumerMapStyle.setPolylineStyleOptions-Methode. Wenn Sie eine benutzerdefinierte Polylinie festlegen überschreiben sie die vom Consumer SDK bereitgestellten Standardwerte.

Rufen Sie zum Wiederherstellen der Standardwerte den folgenden Befehl auf: setPolylineStyleOptions mit null für den Parameter PolylineOptions.

Zum Abrufen der aktiven PolylineOptions verwenden Sie getPolylineStyleOptions-Methode.

Weitere Informationen finden Sie unter ConsumerMapStyle.setPolylineStyleOptions.

Polylinientypen für Routen

Sie können die folgenden Arten von Polylinien für Routen anpassen:

  • ACTIVE_ROUTE
  • REMAINING_ROUTE

ACTIVE_ROUTE und REMAINING_ROUTE werden beim Teilen der Fahrt angezeigt und die Route des Fahrzeugs darstellen.

Eigenschaften von Polylinien für Routen

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

  • Verwenden Sie zum Erstellen von PolylineOptions deren Konstruktor.

  • Verwenden Sie „Setter“, um benutzerdefinierte Eigenschaften anzugeben. Stilmethoden. Seit liefert die Methode Standardwerte für jede Eigenschaft. Sie benötigen nur um benutzerdefinierte Werte anzugeben.

  • Zum Deaktivieren der Polylinie setzen Sie visible auf false.

Weitere Informationen finden Sie unter PolylineOptions in der Dokumentation für Android-Entwickler.

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 Reisefreigabe aktiviert ist, kann Ihre App die mithilfe von Polylinien die aktiven und verbleibenden für Ihr Fahrzeug ermitteln.

  • Die aktive Route ist die Route, die das Fahrzeug gerade zurücklegt. Wegpunkt auf der aktiven Fahrt des Nutzers.

  • Die verbleibende Route ist die Strecke, die das Fahrzeug noch zurücklegt. die aktive Route an. Wenn der aktive Wegpunkt der Route der letzte Wegpunkt ist, die verbleibende Route ist nicht vorhanden.

Sie können die Sichtbarkeit aktiver und verbleibender Polylinien in für Ihre App. Standardmäßig ist die aktive Route sichtbar und die verbleibende Route. ist nicht 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 sie aktivieren, zeichnet der Renderer über der Routenpolygone Segmente, die Streckenabschnitte darstellen. nicht normaler Traffic. Sie enthält einen von der Traffic-Bedingung abhängigen Offset. Weitere Informationen finden Sie in der Android-Entwicklerdokumentation zu Polylinie.

Auf Google Maps werden die Verkehrslage vier Geschwindigkeitstypen. Sie können die Farbe für jeden Geschwindigkeitstyp anpassen.

Erstellen Sie ein TrafficStyle-Objekt, um Polylinien für das Verkehrsaufkommen zu aktivieren. und dann durch Aufrufen von setPolylineTrafficStyle() an ConsumerMapStyle übergeben.

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)