위치 데이터

모바일 애플리케이션의 고유한 기능 중 하나는 위치 인식입니다. 모바일 사용자는 어디서나 기기를 휴대하므로 앱에 위치 인식 기능을 추가하면 사용자에게 더욱 상황에 맞는 경험을 제공할 수 있습니다.

코드 샘플

GitHub의 ApiDemos 저장소에는 지도에서 위치의 사용 방법을 보여주는 샘플이 포함되어 있습니다.

위치 데이터 사용하기

Android 기기에서 사용할 수 있는 위치 데이터에는 (여러 기술 조합을 사용하여 찾아낸) 기기의 정확한 현재 위치, 이동 방향과 수단, 기기가 사전 정의된 지리적 경계나 지오펜싱 위로 움직였는지 여부가 포함됩니다. 애플리케이션의 필요에 따라 여러 가지 위치 데이터 사용 방법 중에서 선택할 수 있습니다.

  • 내 위치 레이어를 사용하면 간단한 방법으로 기기의 위치를 지도에 표시할 수 있지만 데이터는 제공되지 않습니다.
  • 위치 데이터에 대한 모든 프로그래매틱 요청에 Google Play 서비스 Location API를 사용하는 것이 좋습니다.
  • LocationSource 인터페이스를 사용하면 맞춤 위치 제공업체를 선택할 수 있습니다.

위치 정보 액세스 권한

앱에서 사용자의 위치에 액세스해야 하는 경우 앱에 관련 Android 위치 정보 액세스 권한을 추가하여 권한을 요청해야 합니다.

Android에서는 ACCESS_COARSE_LOCATIONACCESS_FINE_LOCATION, 두 가지 위치 정보 액세스 권한을 제공합니다. 선택한 권한에 따라 API에서 반환하는 위치의 정확도가 결정됩니다. 필요한 정확도 수준에 따라 Android 위치 정보 액세스 권한 중 하나만 요청하면 됩니다.

  • android.permission.ACCESS_COARSE_LOCATION – API에서 WiFi 또는 모바일 데이터(또는 둘 다)를 사용하여 기기의 위치를 결정할 수 있습니다. API에서는 정확도가 도시 블록 1개 정도의 오차 수준으로 위치를 반환합니다.
  • android.permission.ACCESS_FINE_LOCATION – API에서 위성 위치 확인 시스템(GPS), WiFi 및 모바일 데이터 등 이용 가능한 위치 제공자를 사용하여 최대한 정확하게 위치를 결정할 수 있습니다.

앱 매니페스트에 권한 추가

다음 권한 중 하나를 Android 매니페스트에서 <manifest> 요소의 하위 요소로 추가합니다. 대략적 위치 정보 액세스 권한:

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

상세한 위치 정보 액세스 권한:

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

런타임 권한 요청

Android 6.0(Marshmallow)에서는 사용자의 앱 설치 및 업그레이드 과정을 간소화한 새로운 권한 처리 모델을 소개합니다. 앱이 API 수준 23 이상을 타겟팅하는 경우 새 권한 모델을 사용할 수 있습니다.

앱이 새 권한 모델을 지원하고 기기에서 Android 6.0(Marshmallow) 이상이 실행되는 경우 사용자가 앱을 설치하거나 업그레이드할 때 권한을 부여할 필요가 없습니다. 앱에서 런타임에 필요한 권한이 있는지 확인하고 권한이 없는 경우 권한을 요청해야 합니다. 시스템은 사용자에게 권한을 요청하는 대화상자를 표시합니다.

최고의 사용자 환경을 제공하려면 상황에 따라 권한을 요청하는 것이 중요합니다. 위치가 앱의 작동에 필수적인 경우 앱 시작 시 위치 정보 액세스 권한을 요청해야 합니다. 이 작업을 처리하는 좋은 방법은 사용자에게 권한이 필요한 이유를 설명하는 시작 페이지 화면 또는 마법사를 사용하는 것입니다.

앱에서 일부 기능에만 권한이 필요한 경우 앱에서 권한이 필요한 작업을 실행할 때 위치 정보 액세스 권한을 요청해야 합니다.

사용자가 권한을 부여하지 않은 경우 앱에서 적절히 처리해야 합니다. 예를 들어 특정 기능에 권한이 필요한 경우 앱에서 해당 기능을 사용 중지할 수 있습니다. 앱이 제대로 작동하는 데 권한이 필수적인 경우 앱에서 모든 기능을 사용 중지하고 사용자에게 권한을 부여해야 한다고 알릴 수 있습니다.

다음 코드 샘플에서는 내 위치 레이어를 사용 설정하기 전에 지원 라이브러리를 사용하여 권한을 확인합니다.

    if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION)
                    == PackageManager.PERMISSION_GRANTED) {
        mMap.setMyLocationEnabled(true);
    } else {
        // Show rationale and request permission.
    }
    

다음 샘플에서는 지원 라이브러리에서 ActivityCompat.OnRequestPermissionsResultCallback을 구현하여 권한 요청의 결과를 처리합니다.

    @Override
    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
        if (requestCode == MY_LOCATION_REQUEST_CODE) {
          if (permissions.length == 1 &&
              permissions[0] == Manifest.permission.ACCESS_FINE_LOCATION &&
              grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            mMap.setMyLocationEnabled(true);
        } else {
          // Permission was denied. Display an error message.
        }
    }
    

Android 런타임 권한에 대한 더 많은 코드 샘플 및 권장사항을 보려면 Android 권한 모델 문서를 참고하세요.

내 위치 레이어

내 위치 레이어와 내 위치 버튼을 사용하면 지도에 사용자의 현재 위치를 표시할 수 있습니다. 지도에 내 위치 레이어를 사용 설정하려면 mMap.setMyLocationEnabled()를 호출하세요.

다음 샘플에서는 내 위치 레이어의 간단한 사용법을 보여줍니다.

public class MyLocationDemoActivity extends FragmentActivity
        implements OnMyLocationButtonClickListener,
            OnMyLocationClickListener,
            OnMapReadyCallback {

      private GoogleMap mMap;

      @Override
      protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.my_location_demo);

        SupportMapFragment mapFragment =
            (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.map);
        mapFragment.getMapAsync(this);
      }

      @Override
      public void onMapReady(GoogleMap map) {
        mMap = map;
        // TODO: Before enabling the My Location layer, you must request
        // location permission from the user. This sample does not include
        // a request for location permission.
        mMap.setMyLocationEnabled(true);
        mMap.setOnMyLocationButtonClickListener(this);
        mMap.setOnMyLocationClickListener(this);
      }

      @Override
      public void onMyLocationClick(@NonNull Location location) {
        Toast.makeText(this, "Current location:\n" + location, Toast.LENGTH_LONG).show();
      }

      @Override
      public boolean onMyLocationButtonClick() {
        Toast.makeText(this, "MyLocation button clicked", Toast.LENGTH_SHORT).show();
        // Return false so that we don't consume the event and the default behavior still occurs
        // (the camera animates to the user's current position).
        return false;
      }
    }
    

내 위치 레이어가 사용 설정되면 지도 오른쪽 상단에 내 위치 버튼이 표시됩니다. 사용자가 버튼을 클릭하면 카메라가 기기의 현재 위치에 지도의 중심을 맞춥니다(기기의 현재 위치를 알고 있는 경우). 기기가 움직이지 않는 경우 위치가 지도에 파란색 점으로 표시되고 기기가 움직이는 경우 V자형 아이콘으로 표시됩니다.

다음 스크린샷의 오른쪽 상단에는 내 위치 버튼, 지도의 중앙에는 내 위치가 파란색 점으로 표시되어 있습니다.

UiSettings.setMyLocationButtonEnabled(false)를 호출하여 내 위치 버튼이 표시되지 않도록 할 수 있습니다.

앱에서 다음과 같은 이벤트에 응답할 수 있습니다.

출처: Google 서비스 약관

사용자 개인정보 보호,
사용자에게 정보 제공

항상 사용자에게 데이터 사용 방법을 알리고 개별 사용자를 식별할 수 없도록 합니다. 사용자의 위치를 사용하기 전에 사용자 동의를 받고 사용자가 언제든지 동의를 철회할 수 있도록 허용합니다.

자세히 알아보기

Google Play 서비스 Location API

Google Play 서비스 Location API는 Android 애플리케이션에 위치 인식 기능을 추가하기 위해 자주 사용되는 메서드입니다. 이 메서드에는 다음 작업을 처리할 수 있는 기능이 포함되어 있습니다.

  • 기기 위치 파악
  • 위치 변경 수신
  • 기기 이동 시 교통수단 모드 파악
  • 사전 정의된 지역(지오펜싱이라고 함) 만들기 및 모니터링

Location API를 사용하면 전력 효율적인 위치 인식 애플리케이션을 쉽게 빌드할 수 있습니다. Maps SDK for Android와 마찬가지로 Location API는 Google Play 서비스 SDK의 일부로 배포됩니다. Location API에 대한 자세한 내용은 Android 교육 과정의 위치 인식 가능한 앱 만들기 또는 Location API 참조를 참고하세요. 코드 예는 Google Play 서비스 SDK의 일부로 포함되어 있습니다.