Rota çoklu çizgilerini özelleştirin

Platform seçin: Android iOS JavaScript

Rota çoklu çizgilerini özelleştirmek için ConsumerMapStyle.setPolylineStyleOptions yöntemini çağırın. Özel çoklu çizgi ayarlarsanız bu seçenekler, Tüketici SDK'sı tarafından sağlanan varsayılan değerleri geçersiz kılar.

Varsayılan değerleri geri yüklemek için setPolylineStyleOptions PolylineOptions parametresi için null ile.

Etkin PolylineOptions değerini almak için şunu kullanın: getPolylineStyleOptions yöntemini kullanabilirsiniz.

Daha fazla bilgi için bkz. ConsumerMapStyle.setPolylineStyleOptions.

Rota çoklu çizgi türleri

Aşağıdaki rota çoklu çizgisi türlerini özelleştirebilirsiniz:

  • ACTIVE_ROUTE
  • REMAINING_ROUTE

Yolculuk paylaşımı sırasında ACTIVE_ROUTE ve REMAINING_ROUTE gösterilir. aracın rotasını temsil eder.

Çoklu çizgi özellikleri

Google Haritalar, Google Haritalar'daki her bir çoklu çizgi için PolylineOptions

  • PolylineOptions derlemek için oluşturucusunu kullanın.

  • Özelleştirilmiş özellikleri belirtmek için "Setter"ı kullanın. stil yöntemleri. Başlangıç yöntem her mülk için varsayılan değerler sağlar. Yalnızca değerini girin.

  • Çoklu çizgiyi devre dışı bırakmak için visible değerini false olarak ayarlayın.

Daha fazla bilgi için bkz. PolylineOptions başlıklı makaleyi inceleyin.

Örnek

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)

Etkin ve Kalan Rota

Yolculuk paylaşımı etkinleştirildiğinde, uygulamanız kullanıcının etkin ve kalan öğeleri göstermek için çoklu çizgileri kullanma deneyimi aracınızın rotası.

  • Etkin rota, aracın ulaşmak için ilerlediği yoldur tüketicinin aktif yolculuğundaki bir sonraki ara noktadır.

  • Kalan rota, aracın geçmesi gereken yoldur aktif rota. Etkin rota ara noktası son yolculuk ara noktası olduğunda, kalan rota mevcut değil.

Etkin ve kalan çoklu çizgilerin görünürlüğünü özelleştirebilir ve kontrol edebilirsiniz: en iyi şekilde yararlanabilirsiniz. Varsayılan olarak, etkin rota ve kalan rota görünür görünür değil.

Örnek

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)

Trafiğe duyarlı çoklu çizgiler

Çoklu çizginin trafik katmanı varsayılan olarak devre dışıdır. Bu özelliği etkinleştirdiğinizde oluşturucu, rotanın çoklu çizgisinin üzerine doğru esnek noktaları gösteren segmentler çizer. trafikle ilgili sonuçlar sunar. Trafik durumuna bağlı olarak bir ofset içerir. Daha fazla bilgi için Polyline ile ilgili Android Geliştirici dokümanlarına göz atın.

Google haritalar, trafik koşullarını dört hız türü. Her hız türü için rengi özelleştirebilirsiniz.

Trafiğe duyarlı çoklu çizgileri etkinleştirmek için bir TrafficStyle nesnesi oluşturun ve ardından setPolylineTrafficStyle() numaralı telefonu arayarak ConsumerMapStyle hizmetine iletebilir.

Örnek

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)