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 çizgi 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 Android geliştirici dokümanlarındaki PolylineOptions bölümüne bakın.

Ö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

Yolculuğu paylaşma özelliği etkinleştirildiğinde uygulamanız, aracınızın etkin ve kalan rotasını göstermek için çoklu çizgiler kullanarak kullanıcının deneyimini özelleştirebilir.

  • 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

Poli ç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 uzun çizgileri temsil eden 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ünden biri olarak gösterir. 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)