Android용 Navigation SDK를 통합하면 앱을 외부 지도뷰에 연결하는 것 이상을 수행할 수 있습니다. Google 지도 내비게이션을 사용하면 앱에서 운전자의 여정에 관한 데이터의 동적 검색 및 단일 보기 보고를 제공할 수 있습니다.
이 가이드에서는 Android 스튜디오 프로젝트를 설명하고 탐색 SDK를 통합하는 방법 및 데모 애플리케이션을 실행하는 방법을 보여줍니다.
Navigation SDK는 앱에서 탐색을 위한 모양과 오디오를 제어할 수 있는 정적 라이브러리입니다. 라이브러리에 관한 자세한 내용은 별도의 창에서 Navigation SDK 참조(Javadoc)를 여세요.
준비
Navigation SDK를 시작하려면 다음 항목이 있어야 합니다.
다음 항목에 액세스할 수 있는 Google Maps Platform 담당자:
- Navigation SDK와 함께 사용하도록 프로비저닝된 API 키 Google Cloud 콘솔 기본 대시보드의 프로젝트 이름 아래에서 확인할 수 있는 프로젝트 ID를 제공해야 합니다.
- SDK 아티팩트 Navigation SDK에 Maven을 사용하도록 프로젝트가 구성되었는지 확인합니다.
- v4.99.0 이하를 사용하는 프로젝트 Maven을 사용할 수 없는 경우 공유 Google 드라이브에서 압축된 아티팩트를 다운로드할 수 있습니다. 정적 라이브러리 파일은 Navigation SDK가 AAR 번들으로 포함된
libs/디렉터리의 .aar입니다. - 1개 이상의 데모 앱
Android 스튜디오 - Navigation SDK로 앱을 빌드하는 데 권장되는 개발 환경
이 문서는 Android 개발 및 객체 지향 프로그래밍 개념에 익숙한 개발자를 위해 작성되었습니다. 개발자는 사용자의 관점에서 Google 지도에도 익숙해야 합니다.
데모 앱 다운로드
Google에서는 사용자의 경험 수준에 따라 Google 지도 API 외에 Navigation SDK가 제공하는 기능을 이해하는 데 도움이 되는 두 가지 앱을 제공합니다. Google 지도 API에 익숙한 개발자는 GoogleNavigation 데모에 집중할 수 있습니다. 두 프로젝트를 모두 처음 사용하는 개발자에게는 두 앱이 모두 유용합니다.
Android용 Navigation SDK v4.1부터 다음 데모 앱을 모두 공유 Google 드라이브에서 다운로드할 수 있습니다.
GoogleNavigation 데모: 안내 탐색 세션에서 사용자 환경과 관련된 API 동작 및 뷰의 통합을 보여줍니다.
GoogleMap 데모: 지도의 분위기와 표현을 맞춤설정하는
GoogleMap인터페이스의 개별 동작을 보여줍니다.
Maven 사용에 대한 참고사항
데모 앱은 Gradle의 Artifact Registry 플러그인을 사용하여 원격 Maven 저장소에서 SDK 아티팩트를 다운로드하도록 구성됩니다. SDK에 액세스하려면 프로젝트 구성 안내를 따라야 합니다.
GoogleNavigation 데모
최신 GoogleNavigation 데모는 공유 Google 드라이브의 루트에서 사용할 수 있습니다. 앱의 이전 버전은 '보관 파일'에 있습니다. 4.1 이전 버전의 경우 앱이 동일한 ZIP 파일에 AAR과 함께 번들로 제공됩니다.
건물
Android 스튜디오에서 데모 앱을 가져오고 Gradle이 실행되도록 허용합니다.
local.defaults.properties를 열고MAPS_API_KEY속성의 값을 업데이트합니다.MAPS_API_KEY=YOUR_API_KEY빌드를 클릭하고 SDK 구현 세부정보를 검토합니다.
Java 클래스에서 구현 코드를 확인합니다.
레이아웃 XML에서 레이아웃 디자인과 텍스트를 확인합니다.
build.gradle파일에서 종속 항목의 SDK를 확인합니다.
API 키가 매니페스트에 추가되는 방법에 관한 자세한 내용은 Secrets Gradle 플러그인 문서를 참고하세요.
실행 중
Android 기기를 컴퓨터에 연결하거나 에뮬레이터를 사용합니다.
- Android 기기: instructions를 참고하여 Android 기기에서 개발자 옵션을 사용 설정하고 기기를 감지하도록 시스템을 구성합니다.
- 에뮬레이터: Android Virtual Device (AVD) Manager를 사용하여 가상 기기를 구성합니다. 에뮬레이터를 선택할 때 Google API가 포함된 이미지를 선택해야 합니다.
Android 스튜디오에서 Run 메뉴 옵션(또는 재생 버튼 아이콘)을 클릭한 다음 배포 대상을 선택합니다.
앱이 빌드 및 실행될 때 옵션 목록의 방문 페이지를 사용자에게 표시합니다.
NavViewActivity 및 NavFragmentActivity 옵션
NavSDK를 처음 도입한 사용자는 이 두 옵션이 가장 유용할 것입니다.
옵션 1: NavViewActivity는 NavigationView를 Navigator과 함께 사용하는 동작을 보여줍니다.
옵션 2: 두 번째 옵션인 NavFragmentActivity에서는 Navigator과 함께 SupportNavigationFragment를 사용하는 동작을 보여줍니다.
이러한 옵션 중 하나를 클릭하면 다음 내용이 표시됩니다.
- 탐색 UI
- 앱 메뉴의 '목적지 설정' 버튼
- API에서 메서드를 동적으로 호출하기 위해 상호작용할 수 있는 오버레이
- 더 많은 옵션이 있는 더보기 메뉴
시작하려면 목적지 설정을 클릭하고 주소를 선택합니다. 그러면 앱에서 현재 위치에서 해당 주소로 이동하는 경로를 시뮬레이션합니다. 제어판 오버레이를 사용하여 API 호출 시 발생하는 결과를 확인합니다. 예를 들어 View Methods를 클릭하여 SDK를 야간 모드로 강제 전환하여 어떻게 표시되는지 확인할 수 있습니다.
SwappingMapAndNavActivity 옵션
SwappingMapAndNavActivity는 다음과 같은 일반적인 패턴을 보여줍니다.
MapView표시- 탐색이 시작될 때
NavigationView로 전환 - 탐색 종료 시
MapView으로 반환
GoogleMap 데모
최신 GoogleNavigation 데모는 공유 Google 드라이브의 루트에서 사용할 수 있습니다. 앱의 이전 버전은 '보관 파일'에 있습니다.
건물
Android 스튜디오에서 데모 앱을 가져오고 Gradle이 실행되도록 허용합니다.
local.defaults.properties를 열고MAPS_API_KEY속성의 값을 업데이트합니다.MAPS_API_KEY=YOUR_API_KEY빌드를 클릭하고 SDK 구현 세부정보를 검토합니다.
Java 클래스에서 구현 코드를 확인합니다.
레이아웃 XML에서 레이아웃 디자인과 텍스트를 확인합니다.
build.gradle파일에서 종속 항목의 SDK를 확인합니다.
API 키가 매니페스트에 추가되는 방법에 관한 자세한 내용은 secrets gradle 플러그인을 참고하세요.
실행 중
Android 기기를 컴퓨터에 연결하거나 에뮬레이터를 사용합니다.
- Android 기기 instructions를 참고하여 Android 기기에서 개발자 옵션을 사용 설정하고 기기를 감지하도록 시스템을 구성합니다.
- 에뮬레이터: Android Virtual Device (AVD) Manager를 사용하여 가상 기기를 구성합니다. 에뮬레이터를 선택할 때 Google API가 포함된 이미지를 선택해야 합니다.
Android 스튜디오에서 Run 메뉴 옵션 (또는 재생 버튼 아이콘)을 클릭한 다음 배포 대상을 선택합니다.
앱이 빌드 및 실행될 때 데모 목록의 방문 페이지를 사용자에게 표시합니다.
Google Maps SDK 데모 사용자는 이 프레젠테이션 패턴과 소스 코드의 구조를 숙지하고 있어야 합니다. 이는 GoogleMap 데모가 지도 API 데모 앱과 유사하게 설계되었기 때문입니다. 주요 차이점은 Navigation SDK 데모를 사용하면 NavigationView 또는 MapView(해당하는 경우) 중 사용자가 데모를 테스트하고 실행할 뷰 클래스를 선택할 수 있다는 것입니다.
Google에서는 일반적으로 채택자에게 NavigationView를 사용하는 것이 좋습니다.
이 데모에서는 두 가지 버전의 데모 앱에서 이러한 동작을 유연하게 시도해 보고
적합한 방식을 선택할 수 있습니다. 예를 들어 이 클래스와 상호작용할 것으로 예상되는 서드 파티 라이브러리를 사용하는 상황에서는 여전히 MapView를 사용해야 할 수 있습니다.