Android Academy · 강의

올바른 위치 권한 처리

포그라운드 위치와 정확한 위치를 다룹니다.

레슨 4/413개 단계

올바른 위치 권한 처리은(는) CoddyKit의 무료 Android Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Android Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Android Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

권한은 선택 사항이 아닙니다

위치 정보는 Android에서 가장 민감한 권한 중 하나입니다. 매니페스트에 선언하는 것만으로는 충분하지 않습니다. 최신 Android에서는 런타임에 사용자에게 요청하고 모든 응답을 적절하게 처리해야 합니다.

이 수업에서는 권한 단계, Compose에서 권한 요청하기, 거부 처리, 그리고 새로운 정확한 위치와 대략적인 위치 및 백그라운드 규칙을 다룹니다.

세 가지 위치 권한

Android는 위치 권한을 다음 단계로 나눕니다.

  • ACCESS_COARSE_LOCATION — 대략적인 위치(약 도시 블록 단위)
  • ACCESS_FINE_LOCATION — 정확한 위치(GPS 수준)
  • ACCESS_BACKGROUND_LOCATION — 앱이 포그라운드에 있지 않을 때의 위치 접근

실제로 필요한 권한만 요청하세요. 백그라운드 접근 권한은 Play 스토어에서 추가 심사를 받습니다.

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- only if truly needed: -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

Compose에서 권한 요청하기

Activity Result API는 권한 대화상자를 표시할 수 있는 런처를 제공합니다. Compose에서는 rememberLauncherForActivityResult와 RequestMultiplePermissions 계약을 사용하세요.

import androidx.activity.compose.rememberLauncherForActivityResult
import androidx.activity.result.contract.ActivityResultContracts

val launcher = rememberLauncherForActivityResult(
    ActivityResultContracts.RequestMultiplePermissions()
) { result ->
    val fine = result[Manifest.permission.ACCESS_FINE_LOCATION] == true
    val coarse = result[Manifest.permission.ACCESS_COARSE_LOCATION] == true
    // react to the user's choice
}

요청 실행하기

권한 배열을 사용하여 launch()를 호출하면 대화상자가 표시됩니다. 일반적으로 화면이 로드될 때 자동으로 실행하기보다는 버튼을 탭했을 때 실행하세요.

Button(onClick = {
    launcher.launch(
        arrayOf(
            Manifest.permission.ACCESS_FINE_LOCATION,
            Manifest.permission.ACCESS_COARSE_LOCATION
        )
    )
}) {
    Text("Enable location")
}

이미 허용되었는지 확인하기

권한이 이미 허용되었다면 다시 요청하지 마세요. 요청을 실행하기 전에 ContextCompat.checkSelfPermission으로 확인하세요.

import androidx.core.content.ContextCompat
import android.content.pm.PackageManager

fun hasFineLocation(context: Context): Boolean {
    return ContextCompat.checkSelfPermission(
        context,
        Manifest.permission.ACCESS_FINE_LOCATION
    ) == PackageManager.PERMISSION_GRANTED
}

정확한 위치와 대략적인 위치

Android 12(API 31)부터는 정확한 위치를 요청했더라도 사용자가 대략적인 위치를 허용할 수 있습니다. 따라서 정확한 위치와 대략적인 위치를 모두 함께 요청해야 하며, 사용자가 대략적인 위치로 낮춰 허용할 수 있다는 점을 받아들여야 합니다.

가능하다면 대략적인 위치에서도 기능이 적절하게 작동하도록 설계하세요.

// Request both — the system shows a Precise/Approximate toggle
launcher.launch(
    arrayOf(
        Manifest.permission.ACCESS_FINE_LOCATION,
        Manifest.permission.ACCESS_COARSE_LOCATION
    )
)
// If only COARSE comes back granted, you got approximate location.

권한 요청 이유 설명하기

사용자가 한 번 거부했다면 Android에서 shouldShowRequestPermissionRationale을 확인할 수 있습니다. 값이 true이면 다시 요청하기 전에 위치 정보가 왜 필요한지 친절하게 설명하세요.

import androidx.core.app.ActivityCompat

val shouldExplain = ActivityCompat.shouldShowRequestPermissionRationale(
    activity,
    Manifest.permission.ACCESS_FINE_LOCATION
)
if (shouldExplain) {
    // show a dialog: "We use your location to find nearby stores"
}

영구 거부 처리하기

사용자가 다시 묻지 않음을 선택했거나 두 번 거부하면 시스템은 더 이상 대화상자를 표시하지 않습니다. 이때는 사용자가 직접 권한을 켤 수 있도록 앱 설정으로 보내는 방법밖에 없습니다.

import android.content.Intent
import android.provider.Settings
import android.net.Uri

fun openAppSettings(context: Context) {
    val intent = Intent(
        Settings.ACTION_APPLICATION_DETAILS_SETTINGS,
        Uri.fromParts("package", context.packageName, null)
    )
    context.startActivity(intent)
}

Accompanist Permissions 사용하기

accompanist-permissions 라이브러리는 이 모든 과정을 Compose에 맞는 상태로 감싸 제공합니다. rememberMultiplePermissionsState는 허용 상태를 추적하고 launchMultiplePermissionRequest() 호출을 제공합니다.

import com.google.accompanist.permissions.rememberMultiplePermissionsState

val permissions = rememberMultiplePermissionsState(
    listOf(
        Manifest.permission.ACCESS_FINE_LOCATION,
        Manifest.permission.ACCESS_COARSE_LOCATION
    )
)

if (permissions.allPermissionsGranted) {
    // show the map / read location
} else {
    Button(onClick = { permissions.launchMultiplePermissionRequest() }) {
        Text("Grant location")
    }
}

백그라운드 위치 권한 규칙

백그라운드 위치 권한은 두 단계로 처리해야 합니다. 먼저 포그라운드 위치 권한(정밀/대략)을 허용받은 다음, 별도로 ACCESS_BACKGROUND_LOCATION을 요청해야 하며, Android 11 이상에서는 시스템 설정 화면이 열립니다. Play 스토어에서는 명확한 사용 근거와 개인정보처리방침을 요구합니다.

앱이 종료된 상태에서도 위치가 실제로 필요한 경우에만 요청해야 합니다. 예를 들면 지오펜싱이나 운동 기록 등이 있습니다.

// Step 1: request foreground first and confirm it's granted.
// Step 2: only then request background:
launcher.launch(
    arrayOf(Manifest.permission.ACCESS_BACKGROUND_LOCATION)
)
// On Android 11+ this sends the user to settings to pick "Allow all the time".

권한으로 보호되는 지도

이제 하나로 연결해 보겠습니다. 권한 상태에 따라 지도 표시를 제한합니다. 권한이 허용된 경우에만 지도를 표시하고, 그렇지 않으면 요청 안내를 표시합니다. 이것이 사용자를 존중하는 표준 패턴입니다.

@Composable
fun LocationGate(permissions: MultiplePermissionsState) {
    when {
        permissions.allPermissionsGranted -> MapScreen()
        else -> Column {
            Text("We need location to show nearby places.")
            Button(onClick = { permissions.launchMultiplePermissionRequest() }) {
                Text("Allow location")
            }
        }
    }
}

빠른 확인

Android 12부터 사용자는 정밀 위치 대신 대략 위치를 선택할 수 있습니다. 이 기능은 권한 요청에 어떤 영향을 줄까요?

복습

이제 위치 권한을 책임감 있게 요청하는 방법을 알게 되었습니다.

  • 매니페스트에 대략/정밀 위치 권한을 선언합니다. 백그라운드 위치 권한은 반드시 필요한 경우에만 선언합니다.
  • Activity Result API 또는 accompanist-permissions를 사용해 실행 중에 요청합니다.
  • 정밀/대략 위치 전환을 지원하려면 정밀 위치와 대략 위치를 함께 요청합니다.
  • 권한 요청 이유를 설명하고, 영구적으로 거부한 사용자는 앱 설정으로 안내합니다.
  • 백그라운드 위치 권한은 별도로 근거를 제시하는 두 단계 흐름으로 처리합니다.

이로써 지도 및 위치 서비스 과정이 끝났습니다. 이제 지도를 표시하고, 사용자를 찾고, 마커를 배치하고, 올바른 방법으로 권한을 요청할 수 있습니다.

무료로 시작

AI 튜터와 함께 Kotlin을(를) 배우세요 — 무료

브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.

코스
36
레슨
152

자주 묻는 질문

“올바른 위치 권한 처리” 강의는 무료인가요?

네 — “올바른 위치 권한 처리” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Android Academy 강의 전체를 잠금 해제할 수 있습니다. Android Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“올바른 위치 권한 처리”에서 뭘 배우나요?

포그라운드 위치와 정확한 위치를 다룹니다. 브라우저에서 직접 실행하는 실습 코드로 Android Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Android Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Android Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.

“올바른 위치 권한 처리” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Android Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Android Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. 지도 표시
  2. 사용자 위치 가져오기
  3. 마커와 카메라
  4. 올바른 위치 권한 처리
← Android Academy(으)로 돌아가기