GeoLocation

• 유저의 위치 정보를 이용한 서비스

퍼미션 부여

• android.permission.ACCESS_COARSE_LOCATION: 와이파이 또는 모바일 데이터를 사용하여 기기의 위치 정보 획득. 정확도는 도시 블록 1개 정도의 오차 수준
• android.permission.ACCESS_FINE_LOCATION: 위성, 와이파이 및 모바일 데이터 등 위치 정보 제공자를 사용하여 최대한 정확하게 위치를 결정함.
• android.permission.ACCESS_BACKGROUND_LOCATION: Android 10 (API Level 29) 이상에서 백그라운드 상태에서 위치 정보에 접근할 때 필요

Location Provider

• GPS: GPS 위성을 이용하여 위치 정보 획득 (가장 높은 정확도, but 음영 지역이 많음.)
• Network: 이동 통신사 망 정보를 이용하여 위치 정보 획득 (지하철 안이나 건물 안과 같이 GPS에서 음영 지역인 곳도 위치 추적할 수 있음.)
• Wifi: 와이파이의 AP 정보를 이용하여 위치 정보 획득
• Passive: 다른 앱에서 이용한 마지막 위치 정보 획득

• 폰에 어떤 위치 정보 제공자가 있는지 파악하려면?

• 현 시점에서 사용 가능한 프로퍼티를 획득하려면?

• 기본적으로 위도/경도는 도/분/초로 표시되는데 일반적인 시스템에서는 실수형 타입으로 제공된다.
  ex) 37도 30분 30초 → 37.5도

• 유저 위치 정보를 획득하는 대표적인 방법으로는 LocationManager과 Fused API가 있다.

---

LocationManager

• 플랫폼 API에서 제공되는 시스템 서비스

val manager = getSystemService(LOCATION_SERVICE) as LocationManager 

• 위치 정보 획득은 LocationManager의 getLastKnownLocation() 함수를 이용
• 결과값은 Location 객체로 전달됨.
  • getAccuracy(): 정확도
  • getLatitude(): 위도
  • getLongitude(): 경도
  • getTime(): 위치 정보 획득 시간

val location: Location? = manager.getLastKnownLocation(LocationManager.GPS_PROVIDER)

• 지속적으로 위치를 획득해야 한다면, LocationListener 사용

실습 예제

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

package com.tutorial.c81

import android.Manifest
import android.content.pm.PackageManager
import android.location.LocationManager
import android.os.Bundle
import android.widget.TextView
import android.widget.Toast
import androidx.activity.result.contract.ActivityResultContracts
import androidx.appcompat.app.AppCompatActivity
import androidx.core.content.ContextCompat

class MainActivity : AppCompatActivity() {
    lateinit var resultView: TextView
    lateinit var manager: LocationManager

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        resultView = findViewById(R.id.resultView)
        manager = getSystemService(LOCATION_SERVICE) as LocationManager

        val launcher = registerForActivityResult(
            ActivityResultContracts.RequestPermission()
        ) { isGranted ->
            if(isGranted){
                getLocation()
            }else{
                Toast.makeText(this, "denied...", Toast.LENGTH_SHORT).show()
            }
        }

        val status = ContextCompat.checkSelfPermission(this,
            "android.permission.ACCESS_FINE_LOCATION")
        if(status == PackageManager.PERMISSION_GRANTED){
            getLocation()
        }else{
            launcher.launch(Manifest.permission.ACCESS_FINE_LOCATION)
        }
    }

    private fun getLocation() {
        val location = manager.getLastKnownLocation(LocationManager.GPS_PROVIDER)
        location?.let {
            val latitude = location.latitude
            val longitude = location.longitude
            val accuracy = location.accuracy
            val time = location.time
            resultView.text = "$latitude\n $longitude\n $accuracy\n $time"
        }
    }
}

---

Fused API

• 위치 정보를 획득할 때 여러가지 상황을 고려해야 한다.
• 낮은 전력 소모, 정확도 향상, 간단한 API 등
• 정보 획득과 관련된 코드의 복잡도를 줄이기 위해 구글에서 제공하는 API가 Fused Location Provider

implementation 'com.google.android.gms:play-services:12.0.1'

Fused Location Provider의 핵심 클래스 2가지

• FusedLocationProviderClient: 위치 정보 획득
• GoogleApiClient: 위치 정보 제공자를 이용하기 위한 준비, 다양한 콜백 함수 제공
• GoogleApiClient에는 GoogleApiClient.ConnectionCallbacks와 GoogleApiClient.OnConnectionFailedListener 인터페이스를 구현한 객체를 지정

• FusedLocationProviderClient의 getLastLocation() 함수를 이용해 위치 획득
• 결과값은 addOnSuccessListener() 함수에 등록한 OnSuccessListener 구현 객체의 onSuccess() 함수가 호출되며 전달됨.

실습 예제

package com.tutorial.c82

import android.Manifest
import android.content.pm.PackageManager
import android.os.Bundle
import android.widget.TextView
import android.widget.Toast
import androidx.activity.result.contract.ActivityResultContracts
import androidx.appcompat.app.AppCompatActivity
import androidx.core.content.ContextCompat
import com.google.android.gms.common.ConnectionResult
import com.google.android.gms.common.api.GoogleApiClient
import com.google.android.gms.location.FusedLocationProviderClient
import com.google.android.gms.location.LocationServices

class MainActivity : AppCompatActivity() {
    lateinit var resultView: TextView
    lateinit var providerClient: FusedLocationProviderClient

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        resultView = findViewById(R.id.resultView)

        val apiClient = GoogleApiClient.Builder(this)
            .addApi(LocationServices.API)
            .addConnectionCallbacks(connectionCallback)
            .addOnConnectionFailedListener(connectionFailedCallback)
            .build()

        providerClient = LocationServices.getFusedLocationProviderClient(this)

        val launcher = registerForActivityResult(
            ActivityResultContracts.RequestPermission()
        ){
            if(it){
                apiClient.connect()
            }else{
                Toast.makeText(this, "denied...", Toast.LENGTH_SHORT).show()
            }
        }

        val status = ContextCompat.checkSelfPermission(this,
            "android.permission.ACCESS_FINE_LOCATION")
        if(status == PackageManager.PERMISSION_GRANTED){
            apiClient.connect()
        }else{
            launcher.launch(Manifest.permission.ACCESS_FINE_LOCATION)
        }
    }

    private val connectionCallback = object: GoogleApiClient.ConnectionCallbacks {
        // 위치 정보 제공자가 사용 가능한 상태가 되었을 때
        override fun onConnected(p0: Bundle?) {
            providerClient.lastLocation.addOnSuccessListener {
                val latitude = it?.latitude
                val longitude = it?.longitude
                resultView.text = "$latitude, $longitude"
            }
        }

        // 위치 정보 제공자가 사용 불가능한 상태가 되었을 때
        override fun onConnectionSuspended(p0: Int) {

        }
    }

    private val connectionFailedCallback = object: GoogleApiClient.OnConnectionFailedListener {
        override fun onConnectionFailed(p0: ConnectionResult) {

        }
    }
}

---

GoogleMap

• play-service 라이브러이에서 지도 뷰는 프래그먼트로 제공한다.

• GoogleMap이라는 클래스가 지도를 출력한다.

실습 예제

implementation 'com.google.android.gms:play-services:12.0.1'

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

    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
    <uses-permission android:name="android.permission.INTERNET"/>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.AndroidLab">
        
        <uses-library android:name="org.apache.http.legacy" android:required="false"/>
        <meta-data
            android:name="com.google.android.maps.v2.API_KEY"
            android:value=""/>
        <meta-data
            android:name="com.google.android.gms.version"
            android:value="@integer/google_play_services_version"/>
        
        <activity
            android:name=".MainActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

package com.tutorial.c83

import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import com.google.android.gms.maps.CameraUpdateFactory
import com.google.android.gms.maps.GoogleMap
import com.google.android.gms.maps.OnMapReadyCallback
import com.google.android.gms.maps.SupportMapFragment
import com.google.android.gms.maps.model.CameraPosition
import com.google.android.gms.maps.model.LatLng

class MainActivity : AppCompatActivity(), OnMapReadyCallback {
    var googleMap: GoogleMap? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        (supportFragmentManager.findFragmentById(R.id.mapView) as SupportMapFragment)
            .getMapAsync(this)
    }

    override fun onMapReady(p0: GoogleMap?) {
        googleMap = p0
        val latLng = LatLng(37.566610, 126.978403) // 서울 시청의 위치
        val position = CameraPosition.Builder() // 보여줄 지도 위치 설정
            .target(latLng)
            .zoom(16f)
            .build()
        googleMap?.moveCamera(CameraUpdateFactory.newCameraPosition(position))
    }
}

SHA-1 지문 얻기

Settings > Experimental > Do not build Gradle task list during Gradle sync 체크 해제

안드로이드 스튜디오 오른쪽에 Gradle 탭 > signingReport

cf) 테스트용이 아니라, 정식 앱을 위한 SHA-1 키를 얻으려면 어플리케이션을 빌드하면서 사인했던 키를 이용해야 한다.

Google Maps Platform에서 API 키 얻기

https://developers.google.com/maps/documentation/android-sdk/get-api-key

아래 value에 API 키를 등록해준다.

<uses-library android:name="org.apache.http.legacy" android:required="false"/>
<meta-data
     android:name="com.google.android.maps.v2.API_KEY"
     android:value="~~~~~"/>
<meta-data
     android:name="com.google.android.gms.version"
     android:value="@integer/google_play_services_version"/>