시작하기

Android용 Navigation SDK를 통합하면 앱을 외부 지도뷰에 연결하는 것 이상을 수행할 수 있습니다. Google 지도 내비게이션을 사용하면 앱에서 운전자의 여정에 관한 데이터의 동적 검색 및 단일 보기 보고를 제공할 수 있습니다.

이 가이드에서는 Android 스튜디오 프로젝트와 Navigation SDK를 통합하고 SDK와 함께 제공되는 데모 앱을 실행하는 방법을 보여줍니다.

Navigation SDK는 앱에서 탐색을 위한 모양과 오디오를 제어할 수 있는 정적 라이브러리 (.aar)입니다. 라이브러리에 관한 자세한 내용은 별도의 창에서 Navigation SDK 참조 (Javadoc)를 여세요.

준비

Android용 Navigation SDK를 시작하려면 다음 항목이 있어야 합니다.

  • 다음 항목에 액세스할 수 있는 Google Maps Platform 담당자:

    • Navigation SDK와 함께 사용하도록 프로비저닝된 API 키 Google Cloud 콘솔 기본 대시보드의 프로젝트 이름 아래에서 확인할 수 있는 프로젝트 ID를 제공해야 합니다.

    • 다음이 포함된 ZIP 파일입니다.

      • Navigation SDK가 aar 번들로 포함된 libs/ 디렉터리의 정적 라이브러리 파일 .aar
      • 라이선스를 위한 텍스트 파일과 이용약관 및 계약 링크입니다.
      • Android 스튜디오에서 새 프로젝트로 가져올 데모 앱 Gradle 및 Maven을 사용하여 Android 스튜디오에서 데모 앱을 빌드하기 위한 앱 파일

  • Android 스튜디오 - Navigation SDK로 앱을 빌드하는 데 권장되는 개발 환경 이 문서는 Android 개발 및 객체 지향 프로그래밍 개념에 익숙한 개발자를 위해 작성되었습니다. 개발자는 사용자의 관점에서 Google 지도에도 익숙해야 합니다.

SDK, 데모 앱, 문서 받기

SDK 파일을 다운로드하고 압축을 푼 후 데모 앱을 검사하고 실행할 수 있습니다.

데모 앱은 NavigationFragment 클래스를 구현하는 빌드와 NavigationView 클래스를 구현하는 변형을 제공합니다. NavigationFragment 변형은 기본적으로 실행되며 다음 이미지와 같이 탐색 경로를 표시합니다.

  1. 원하는 파일 관리자를 사용하여 SDK 파일이 있는 디렉터리로 이동합니다.

  2. Navigation SDK 라이브러리를 demo 프로젝트의 app/libs 디렉터리에 복사합니다.

    예를 들어 Linux 터미널에서 cp libs/*.aar demo/app/libs를 실행할 수 있습니다.

  3. Android 스튜디오에서 데모 앱을 가져와서 Gradle이 실행되도록 합니다.

  4. 앱의 AndroidManifest.xml을 열고 API_KEY 속성 값을 업데이트합니다.

    <?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.navigationapidemo" >

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/_AppTheme" >

        <meta-data
            android:name="com.google.android.geo.API_KEY"
            android:value="YOUR_API_KEY"/>
    </application>
</manifest>

  5. 빌드를 클릭하고 SDK 구현 세부정보를 검토합니다.

    • 자바 클래스에서 구현 코드를 확인합니다.

    • 레이아웃 xml에서 레이아웃 디자인과 텍스트를 확인합니다.

    • build.gradle 파일에서 종속 항목의 SDK를 확인합니다.

앱 실행

  1. Android 기기를 컴퓨터에 연결하거나 에뮬레이터를 사용합니다.

    • Android 기기: instructions를 참고하여 Android 기기에서 개발자 옵션을 사용 설정하고 기기를 감지하도록 시스템을 구성합니다.
    • 에뮬레이터: Android Virtual Device (AVD) Manager를 사용하여 가상 기기를 구성합니다. 에뮬레이터를 선택할 때 Google API가 포함된 이미지를 선택해야 합니다.

  2. Android 스튜디오에서 Run 메뉴 옵션 (또는 재생 버튼 아이콘)을 클릭하고 배포 대상을 선택합니다.

  3. 내비게이션 데모 앱에서 Set Destination을 선택한 후 표시되는 메시지에 따라 위치를 선택하고 시뮬레이션된 내비게이션을 시작합니다.

뷰 변형 빌드

데모 앱에는 뷰 변형이 포함되어 있습니다.

  1. Android 스튜디오에서 데모 앱을 열고 Build 창의 Build Variants 탭을 클릭합니다.

  2. Build Variants 창에서 viewDebug를 선택하면 파일 목록이 변경됩니다.

  3. NavigationView 클래스의 SDK 구현 세부정보를 검토합니다.

    • NavViewActivity.java에서 구현 코드를 확인합니다.

    • Activity_Nav_View.xml에서 레이아웃 디자인과 텍스트를 확인합니다.

  4. 앱을 빌드하고 실행합니다. 앱 이름이 변경되어 빌드된 버전을 나타냅니다. 그렇지 않으면 렌더링 객체만 달라집니다.

다음 단계

자체 앱에 Android용 Navigation SDK를 통합합니다.