경로 다중선 맞춤설정

플랫폼 선택: Android iOS JavaScript

ConsumerMapStyle.setPolylineStyleOptions 메서드를 사용하여 경로 다중선 선을 맞춤설정합니다. 맞춤 다중선 옵션을 설정하면 소비자 SDK에서 제공하는 기본값이 재정의됩니다.

기본값을 복원하려면 PolylineOptions 매개변수에 null를 사용하여 setPolylineStyleOptions를 호출합니다.

활성 PolylineOptions를 가져오려면 getPolylineStyleOptions 메서드를 사용합니다.

자세한 내용은 ConsumerMapStyle.setPolylineStyleOptions를 참고하세요.

경로 폴리라인 유형

다음과 같은 경로 다중선 유형을 맞춤설정할 수 있습니다.

  • ACTIVE_ROUTE
  • REMAINING_ROUTE

ACTIVE_ROUTE 및 REMAINING_ROUTE는 경로를 따라 표시되며 차량의 경로를 나타냅니다.

경로 다중선 속성

Google 지도에서는 PolylineOptions의 각 다중선에 사용할 수 있는 맞춤설정 가능한 속성을 제공합니다.

  • PolylineOptions를 빌드하려면 생성자를 사용합니다.

  • 맞춤설정된 속성을 지정하려면 'Setter' 스타일 메서드를 사용하세요. 이 메서드는 각 속성에 기본값을 제공하므로 맞춤 값만 지정하면 됩니다.

  • 다중선을 사용 중지하려면 visible을 false로 설정합니다.

자세한 내용은 Android 개발자 문서의 PolylineOptions를 참고하세요.

예

자바

// 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)

활성 경로 및 남은 경로

경로 공유를 사용 설정하면 앱에서 다중선으로 사용자 환경을 맞춤설정하여 차량의 활성 경로와 남은 경로를 표시할 수 있습니다.

  • 활성 경로는 소비자의 활성 이동에서 다음 웨이포인트에 도달하기 위해 차량이 현재 이동 중인 경로입니다.

  • 나머지 경로는 차량이 활성 경로를 지나 아직 이동해야 하는 경로입니다. 활성 경로 웨이포인트가 마지막 이동 웨이포인트인 경우 나머지 경로는 존재하지 않습니다.

앱에서 활성 및 남은 다중선의 표시 상태를 맞춤설정하고 제어할 수 있습니다. 기본적으로 활성 경로는 표시되고 남은 경로는 표시되지 않습니다.

예

자바

// 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)

교통 인식 다중선

다중선의 트래픽 레이어는 기본적으로 사용 중지되어 있습니다. 이 옵션을 사용 설정하면 렌더러가 경로 다중선 위에 비정상적인 트래픽 구간을 나타내는 구간을 그립니다. 트래픽 상황에 따라 오프셋이 포함됩니다. 자세한 내용은 Android 개발자 문서의 다중선을 참고하세요.

Google 지도에서는 교통상황을 4가지 속도 유형 중 하나로 나타냅니다. 속도 유형별로 색상을 맞춤설정할 수 있습니다.

트래픽 인식 다중선을 사용 설정하려면 TrafficStyle 객체를 만든 다음 setPolylineTrafficStyle()를 호출하여 ConsumerMapStyle에 전달합니다.

예

자바

// 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)