경로 다중선 맞춤설정

플랫폼 선택: 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 개발자 문서를 참고하세요.

Google 지도는 교통 상황을 네 가지 속도 유형 중 하나로 표시합니다. 속도 유형별로 색상을 맞춤설정할 수 있습니다.

교통정보를 반영하는 다중선을 사용 설정하려면 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)