경로 다중선 맞춤설정

플랫폼 선택: Android iOS JavaScript

ConsumerMapStyle.setPolylineStyleOptions 메서드를 사용하여 경로 폴리라인을 맞춤설정합니다. 맞춤 폴리라인 옵션을 설정하면 Consumer 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 개발자 문서의 Polyline을 참고하세요.

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

교통 상황을 고려하는 다중선을 사용 설정하려면 TrafficStyle 객체를 구성한 다음 setPolylineTrafficStyle()를 호출하여 ConsumerMapStyle에 전달합니다.

예

자바

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