단일 대상 경로 탐색

이 가이드에 따라 Android용 Navigation SDK 이 가이드에서는 Navigation SDK를 앱에 추가합니다. 프로젝트를 설정합니다.

요약

  1. 탐색 프래그먼트 또는 탐색 프래그먼트로 UI 요소를 앱에 추가합니다. 탐색 뷰 이 UI 요소는 양방향 지도와 세부 경로 안내를 추가합니다. 탐색 UI를 추가하는 것입니다.
  2. 위치 정보 액세스 권한을 요청합니다. 앱에서 위치 정보 액세스 권한을 요청해야 합니다. 기기의 위치를 확인합니다.
  3. 다음을 사용하여 SDK 초기화: NavigationApi 클래스에 대해 자세히 알아보세요.

  4. 목적지를 설정하고 Navigator 클래스에 대해 자세히 알아보세요. 여기에는 다음 세 단계가 포함됩니다.

    • 다음을 사용하여 목적지 설정 setDestination()
    • 내비게이션 시작 앱 startGuidance()
    • getSimulator() 사용 경로를 따라 차량의 진척도를 시뮬레이션합니다. (앱 테스트, 디버깅, 시연에 사용할 수 있는 API입니다.)

  5. 앱을 빌드하고 실행합니다.

코드 보기

앱에 UI 요소 추가

이 섹션에서는 양방향 지도와 UI를 추가할 수 있는 두 가지 방법을 설명합니다. 세부 경로 안내 내비게이션을 표시합니다.

SupportNavigationFragment 는 대화형 지도와 세부 경로 안내를 제공합니다. 프래그먼트는 다음과 같이 XML 레이아웃 파일을 작성합니다.

<?xml version="1.0" encoding="utf-8"?>
<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    android:name="com.google.android.libraries.navigation.SupportNavigationFragment"
    android:id="@+id/navigation_fragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

또는 다음에 설명된 대로 프래그먼트를 프로그래매틱 방식으로 생성할 수 있습니다. Android 문서 FragmentActivity.getSupportFragmentManager()

프래그먼트의 대안으로 지도를 표시할 UI 구성요소 탐색 메뉴도 NavigationView

위치 정보 액세스 권한 요청

이 섹션에서는 상세한 위치 정보 액세스 권한을 요청하는 방법을 설명합니다. 자세한 내용은 Android 권한.

  1. Android에서 권한을 <manifest> 요소의 하위 요소로 추가합니다. 매니페스트:

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.navsdksingledestination">
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
</manifest>

  2. 앱에서 런타임 권한을 요청하여 사용자에게 기회 제공 위치 정보 액세스 권한을 부여하거나 거부합니다. 다음 코드는 사용자가 상세한 위치 정보 액세스 권한을 부여했습니다. 부여하지 않은 경우, 해당 권한을 요청합니다.

    if (ContextCompat.checkSelfPermission(this.getApplicationContext(),
        android.Manifest.permission.ACCESS_FINE_LOCATION)
            == PackageManager.PERMISSION_GRANTED) {
    mLocationPermissionGranted = true;
} else {
    ActivityCompat.requestPermissions(this,
            new String[] { android.Manifest.permission.ACCESS_FINE_LOCATION },
            PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION);
}

if (!mLocationPermissionGranted) {
    displayMessage("Error loading Navigation SDK: "
            + "The user has not granted location permission.");
    return;
}

  3. 결과를 처리하도록 onRequestPermissionsResult() 콜백을 재정의합니다. 다음과 같이 설정합니다.

    @Override
public void onRequestPermissionsResult(int requestCode, @NonNull String permissions[],
                                       @NonNull int[] grantResults) {
    mLocationPermissionGranted = false;
    switch (requestCode) {
        case PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION: {
            // If request is canceled, the result arrays are empty.
            if (grantResults.length > 0
                    && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                mLocationPermissionGranted = true;
            }
        }
    }
}

Navigation SDK 초기화

이 NavigationApi 클래스는 앱에서 Google을 사용하도록 승인하는 초기화 로직을 제공합니다. 제공합니다. 이 섹션에서는 탐색기를 초기화하는 방법과 앱에서 사용 설정할 수 있는 기타 구성은 다음과 같습니다.

  1. Navigation SDK 초기화 및 탐색기가 내비게이션을 시작할 때 내비게이션을 시작하는 onNavigatorReady() 콜백 있습니다.

  2. 선택사항. 안내 알림 및 백그라운드로 앱을 구성하세요. 서비스는 사용자가 기기에서 앱을 닫을 때 종료됩니다. 이 비즈니스 모델에 따라 달라집니다 원하는 경우 방향 지시 및 위치를 계속해서 표시하는 탐색기 동작 앱이 닫혀도 계속 업데이트됩니다. 대신 kubectl을 종료하려는 경우 최종 사용자가 앱을 닫았을 때 탐색 및 위치 업데이트가 이루어지면 이 구성을 사용합니다

  3. 선택사항. 지원되는 국가에서 도로 제한을 사용 설정하세요. 마지막 숫자를 입력합니다. 이 호출은 한 번만 하면 됩니다. 후속 경로 요청에서 계속 사용합니다. 이 통화는 지원되는 리전으로 나뉩니다 자세한 내용은 Navigation SDK 지원 국가

    NavigationApi.getNavigator(this, new NavigationApi.NavigatorListener() {
            /**
             * Sets up the navigation UI when the navigator is ready for use.
             */
            @Override
            public void onNavigatorReady(Navigator navigator) {
                displayMessage("Navigator ready.");
                mNavigator = navigator;
                mNavFragment = (NavigationFragment) getFragmentManager()
                        .findFragmentById(R.id.navigation_fragment);

                // Optional. Disable the guidance notifications and shut down the app
                // and background service when the user closes the app.
                // mNavigator.setTaskRemovedBehavior(Navigator.TaskRemovedBehavior.QUIT_SERVICE)

                // Optional. Set the last digit of the car's license plate to get
                // route restrictions for supported countries.
                // mNavigator.setLicensePlateRestrictionInfo(getLastDigit(), "BZ");

                // Set the camera to follow the device location with 'TILTED' driving view.
                mNavFragment.getCamera().followMyLocation(Camera.Perspective.TILTED);

                // Set the travel mode (DRIVING, WALKING, CYCLING, TWO_WHEELER, or TAXI).
                mRoutingOptions = new RoutingOptions();
                mRoutingOptions.travelMode(RoutingOptions.TravelMode.DRIVING);

                // Navigate to a place, specified by Place ID.
                navigateToPlace(SYDNEY_OPERA_HOUSE, mRoutingOptions);
            }

            /**
             * Handles errors from the Navigation SDK.
             * @param errorCode The error code returned by the navigator.
             */
            @Override
            public void onError(@NavigationApi.ErrorCode int errorCode) {
                switch (errorCode) {
                    case NavigationApi.ErrorCode.NOT_AUTHORIZED:
                        displayMessage("Error loading Navigation SDK: Your API key is "
                                + "invalid or not authorized to use the Navigation SDK.");
                        break;
                    case NavigationApi.ErrorCode.TERMS_NOT_ACCEPTED:
                        displayMessage("Error loading Navigation SDK: User did not accept "
                                + "the Navigation Terms of Use.");
                        break;
                    case NavigationApi.ErrorCode.NETWORK_ERROR:
                        displayMessage("Error loading Navigation SDK: Network error.");
                        break;
                    case NavigationApi.ErrorCode.LOCATION_PERMISSION_MISSING:
                        displayMessage("Error loading Navigation SDK: Location permission "
                                + "is missing.");
                        break;
                    default:
                        displayMessage("Error loading Navigation SDK: " + errorCode);
                }
            }
        });

대상 설정

이 Navigator 클래스를 통해 탐색 구성, 시작, 중지를 제어할 수 있습니다. 있습니다.

Navigator 컨테이너 이미지를 가져올 수 있다면 Waypoint 이 여정을 시작했을 것입니다. 경로를 계산한 후 SupportNavigationFragment 은 지도에 경로를 나타내는 폴리라인과 있습니다.

    private void navigateToPlace(String placeId, RoutingOptions travelMode) {
        Waypoint destination;
        try {
            destination = Waypoint.builder().setPlaceIdString(placeId).build();
        } catch (Waypoint.UnsupportedPlaceIdException e) {
            displayMessage("Error starting navigation: Place ID is not supported.");
            return;
        }

        // Create a future to await the result of the asynchronous navigator task.
        ListenableResultFuture<Navigator.RouteStatus> pendingRoute =
                mNavigator.setDestination(destination, travelMode);

        // Define the action to perform when the SDK has determined the route.
        pendingRoute.setOnResultListener(
                new ListenableResultFuture.OnResultListener<Navigator.RouteStatus>() {
                    @Override
                    public void onResult(Navigator.RouteStatus code) {
                        switch (code) {
                            case OK:
                                // Hide the toolbar to maximize the navigation UI.
                                if (getActionBar() != null) {
                                    getActionBar().hide();
                                }

                                // Enable voice audio guidance (through the device speaker).
                                mNavigator.setAudioGuidance(
                                        Navigator.AudioGuidance.VOICE_ALERTS_AND_GUIDANCE);

                                // Simulate vehicle progress along the route for demo/debug builds.
                                if (BuildConfig.DEBUG) {
                                    mNavigator.getSimulator().simulateLocationsAlongExistingRoute(
                                            new SimulationOptions().speedMultiplier(5));
                                }

                                // Start turn-by-turn guidance along the current route.
                                mNavigator.startGuidance();
                                break;
                            // Handle error conditions returned by the navigator.
                            case NO_ROUTE_FOUND:
                                displayMessage("Error starting navigation: No route found.");
                                break;
                            case NETWORK_ERROR:
                                displayMessage("Error starting navigation: Network error.");
                                break;
                            case ROUTE_CANCELED:
                                displayMessage("Error starting navigation: Route canceled.");
                                break;
                            default:
                                displayMessage("Error starting navigation: "
                                        + String.valueOf(code));
                        }
                    }
                });
    }

앱 빌드 및 실행

  1. 컴퓨터에 Android 기기를 연결합니다. Android 스튜디오 따르기 하드웨어 기기에서 앱 실행 방법 안내 또는 다음을 사용하여 가상 기기를 구성할 수 있습니다. Android Virtual Device (AVD) Manager 에뮬레이터를 선택할 때 Google API가 포함된 이미지를 선택해야 합니다.
  2. Android 스튜디오에서 Run 메뉴 옵션 또는 재생 버튼 아이콘을 클릭합니다. 표시되는 메시지에 따라 기기를 선택합니다.

사용자 환경 개선을 위한 힌트

  • 사용자는 전에 Google 내비게이션 서비스 약관에 동의해야 합니다. 내비게이션을 사용할 수 있게 됩니다. 승인은 한 번만 수행하면 됩니다. 작성자: 기본적으로 탐색기를 처음 실행할 때 SDK에서 수락하라는 메시지가 표시됩니다. 호출됩니다. 원하는 경우 내비게이션 서비스 약관 대화상자를 트리거할 수 있습니다. 앱 UX 흐름의 초기 지점(예: 가입 또는 로그인 단계)에서 TermsAndConditionsCheckOption
  • 내비게이션 품질과 도착예정시간의 정확성을 크게 개선하려면 다음을 사용하세요. 위도/경도가 아닌 경유지를 초기화하는 장소 ID 좌표입니다.
  • 이 샘플은 에 대한 특정 장소 ID에서 목적지 경유지를 시드니 오페라 하우스. 이 장소 ID 찾기를 통해 장소 ID에 대한 액세스를 예로 들 수 있습니다.