경로 다중선 맞춤설정

플랫폼 선택: Android iOS JavaScript

경로 폴리라인은 ConsumerMapStyle.setPolylineStyleOptions 메서드를 사용하여 지도 가장자리에 패딩을 추가할 수 있습니다. 맞춤 다중선을 설정하는 경우 소비자 SDK에서 제공하는 기본값을 재정의합니다.

기본값을 복원하려면 setPolylineStyleOptions PolylineOptions 매개변수의 경우 null 포함

활성 PolylineOptions를 가져오려면 다음을 사용합니다. getPolylineStyleOptions 메서드를 사용하여 지도 가장자리에 패딩을 추가할 수 있습니다.

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

다중선 유형 경로

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

  • ACTIVE_ROUTE
  • REMAINING_ROUTE

여정을 공유하는 동안 ACTIVE_ROUTE 및 REMAINING_ROUTE이(가) 표시됩니다. 은 차량 경로를 나타냅니다.

경로 다중선 속성

Google 지도는 각 폴리라인에 사용할 수 있는 맞춤설정 가능한 속성을 PolylineOptions

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

  • 맞춤설정된 속성을 지정하려면 'Setter'를 사용합니다. style 메서드를 사용합니다. 이후 이 메서드는 각 속성의 기본값을 제공하므로 커스텀 값을 지정할 수 있습니다.

  • 다중선을 끄려면 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)