경로 다중선 맞춤설정

플랫폼 선택: Android iOS JavaScript

ConsumerMapStyle.setPolylineStyleOptions 메서드를 사용하여 경로 폴리라인을 맞춤설정합니다. 맞춤 폴리라인 옵션을 설정하면 Consumer SDK에서 제공하는 기본값이 재정의됩니다.

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

활성 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 객체를 구성한 다음 ConsumerMapStyle에 setPolylineTrafficStyle()을 호출하여 전달합니다.

예

자바

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