Android용 Maps SDK v3.1.0 베타 사용

Android용 Maps SDK 버전 3.1.0 베타는 이전 버전과 동일한 API 표시 경로(모든 클래스 및 메서드는 동일하게 유지됨)를 사용하는 새로운 구현이며, 다음과 같은 새로운 기능을 사용해 볼 수 있습니다.

  • 지도 맞춤설정
  • 마커 충돌 처리
  • 다중선 맞춤설정

이 가이드에서는 새로운 기능을 사용하는 방법에 대해 설명합니다.

지도 맞춤설정(베타)

클라우드 기반 지도 스타일 지정은 지도의 스타일을 더욱 쉽게 맞춤설정하고 관리할 수 있는 다양한 도구와 기능을 제공합니다. 지도 API 및 SDK를 사용하여 코드에 스타일을 지정하는 대신, Google Cloud 콘솔에서 지도를 관리하고 지도에 스타일을 지정할 수 있습니다. 자세한 내용은 Android 지도 맞춤설정 개요를 참고하세요.

마커 충돌 처리(베타)

충돌이 발생할 경우 맞춤 마커를 기본 지도 라벨보다 우선 적용해야 할지 여부를 지정할 수 있으며, 맞춤 마커 간 상대적 우선순위를 표시할 수도 있습니다. 자세한 내용은 마커 충돌 처리(Android)를 참조하세요.

다중선 맞춤설정(베타)

다중선의 모양을 맞춤설정하는 방법은 여러 가지가 있습니다.

  • 여러 색상의 다중선에서는 다중선 선분을 다른 색상으로 설정합니다.
  • 그라데이션 다중선에서는 두 가지 색상의 그라데이션을 사용하여 다중선에 색상을 지정합니다.
  • 스탬프 처리된 다중선에서는 반복 비트맵을 사용하여 다중선의 스타일을 지정합니다.

여러 색상의 다중선 만들기

StyleSpan 객체를 만들고 addSpan() 또는 addSpans() 메서드를 사용하여 이 객체를 PolylineOptions에 추가함으로써 다중선의 선분 색상을 개별적으로 지정할 때 스팬을 적용할 수 있습니다. 기본적으로 배열의 각 항목에서는 해당 선분의 색상을 설정합니다. 다음 예에서는 선분 색상을 설정하여 빨간색 및 초록색 선분이 포함된 다중선을 만드는 방법을 소개합니다.

Kotlin



val line = map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(StyleSpan(Color.RED))
        .addSpan(StyleSpan(Color.GREEN))
)

Java


Polyline line = map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(new StyleSpan(Color.RED))
        .addSpan(new StyleSpan(Color.GREEN)));

그라데이션 다중선 만들기

2개의 32비트 ARGB(alpha-red-green-blue) 정수로 획의 시작 색상과 종료 색상을 지정하여 그라데이션을 정의할 수 있습니다. PolylineOptions.addSpan()을 호출하여 도형의 옵션 객체에서 이 속성을 설정합니다. 다음 예에서는 우드랜드 파크 동물원에서 미국 워싱턴주 커클랜드까지 빨간색-노란색 그라데이션 다중선을 만드는 방법을 소개합니다.

Kotlin



val line = map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(
            StyleSpan(
                StrokeStyle.gradientBuilder(
                    Color.RED,
                    Color.YELLOW
                ).build()
            )
        )
)

Java


Polyline line = map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(new StyleSpan(StrokeStyle.gradientBuilder(Color.RED, Color.YELLOW).build())));

스탬프 처리된 다중선 만들기

다중선의 모양을 반복되는 비트맵 질감으로 설정할 수 있습니다. 이렇게 하려면 TextureStyle의 StampStyle을 만든 후 다음과 같이 PolylineOptions.addSpan()을 호출하여 도형의 옵션 객체에서 이 속성을 설정합니다.

Kotlin



val stampStyle =
    TextureStyle.newBuilder(BitmapDescriptorFactory.fromResource(R.drawable.walking_dot)).build()
val span = StyleSpan(StrokeStyle.colorBuilder(Color.RED).stamp(stampStyle).build())
map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(span)
)

Java


StampStyle stampStyle =
        TextureStyle.newBuilder(BitmapDescriptorFactory.fromResource(R.drawable.walking_dot)).build();
StyleSpan span = new StyleSpan(StrokeStyle.colorBuilder(Color.RED).stamp(stampStyle).build());
map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(span));

베타 버전과 호환되는 유틸리티 라이브러리 가져오기

Google Maps Android API 유틸리티 라이브러리를 사용 중인 경우, 다음 방법으로 프로젝트 종속 항목을 업데이트하여 기존 버전을 베타 호환 버전으로 대체해야 합니다.

  1. build.gradle 파일에서 베타 버전과 호환되는 유틸리티 라이브러리를 가져옵니다. 
    implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
  2. build.gradle에서 다음 명령어를 삭제하여 베타 버전에서 호환되지 않는 유틸리티 라이브러리를 삭제합니다. 
    implementation 'com.google.maps.android:android-maps-utils:1.3.1'

샘플 실행

GitHub의 Google 샘플 저장소에는 v3.1.0 베타 Android용 Maps SDK를 사용하는 방법을 보여주는 샘플 앱이 포함되어 있습니다.