Region, Gcoder(lt, lng) 정보 가져오는 방법

region 정보(예: 서울시 강남구, 서울시 서초구 등) 와 Gcoder(위도 lt, 경도 lng) 는 위치정보 권한을 추가하여 얻어올 수 있습니다. 얻어온 Region 정보와 Gcoder 정보를 SDK로 넘겨주시면 됩니다.

1. AndroidManifest.xml에 퍼미션 추가

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

2. ACCESS_FINE_LOCATION 과 ACCESS_COARSE_LOCATION 어떤 것을 선택 구현할지 비교

아래와 같이 ACCESS_FINE_LOCATION과 ACCESS_COARSE_LOCATION 의 차이점을 참고하셔서 선택 구현 해주시고, 얻어온 Region정보와 Gcoder 정보를 SDK에 넘겨주시면 됩니다.

항목	ACCESS_FINE_LOCATION	ACCESS_COARSE_LOCATION
위치 정확도	고정밀(5~20m)	저정밀(수백 미터 이상)
사용기술	GPS, Wi-Fi, 셀룰러	Wi-Fi, 셀룰러만
배터리 소모	상대적으로 높음	낮음
사용자 동의 요구 수준	높음(민감한 권한)	낮음(덜 민감)
Android 6.0+ 권한 요청	반드시 런타임 요청 필요	마찬가지로 요청 필요

3. ACCESS_FINE_LOCATION 기반 코드(GPS 기반 고정밀 위치정보)

• FINE_LOCATION은 GPS가 켜져 있어야 하며, 고정밀 위치정보 확보가 가능합니다(5~20m 이내).

• 에뮬레이터에서는 정확한 정보를 얻어오지 못하는 경우가 많으니 실기기 테스트 권장합니다.

JAVA

package com.example.locationfine;

import android.Manifest;
import android.content.pm.PackageManager;
import android.location.Address;
import android.location.Geocoder;
import android.location.Location;
import android.os.Bundle;
import android.os.Looper;
import android.util.Log;

import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;

import com.google.android.gms.location.*;

import java.io.IOException;
import java.util.List;
import java.util.Locale;

public class MainActivity extends AppCompatActivity {

    private FusedLocationProviderClient fusedLocationClient;
    private static final int REQ_FINE = 1001;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        fusedLocationClient = LocationServices.getFusedLocationProviderClient(this);
        getPreciseLocation();
    }

    private void getPreciseLocation() {
        if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, REQ_FINE);
            return;
        }

        LocationRequest request = LocationRequest.create()
                .setPriority(LocationRequest.PRIORITY_HIGH_ACCURACY)
                .setInterval(5000)
                .setFastestInterval(2000)
                .setNumUpdates(1);

        fusedLocationClient.requestLocationUpdates(request, new LocationCallback() {
            @Override
            public void onLocationResult(@NonNull LocationResult result) {
                Location location = result.getLastLocation();
                if (location != null) {
                    getAddress(location.getLatitude(), location.getLongitude());
                }
            }
        }, Looper.getMainLooper());
    }

    private void getAddress(double lat, double lng) {
        Geocoder geocoder = new Geocoder(this, Locale.KOREA);
        try {
            List<Address> results = geocoder.getFromLocation(lat, lng, 1);
            if (!results.isEmpty()) {
                Address addr = results.get(0);
                String province = addr.getAdminArea(); // 광역 시/도 (예: 경기도, 서울특별시)
                String city = addr.getLocality(); // 시/군 (예: 김포시, 성남시)
                String district = addr.getSubLocality(); // 구 (예: 분당구, 강남구). 구가 없으면 null 또는 시 이름과 동일할 수 있음.
                Log.d("FINE_LOCATION", "주소: " + province + " " + city + " " + district);
                Log.d("FINE_LOCATION", "위도: " + lat + ", 경도:" + lng);
                // TODO Region, Gcoder(lt, lng)정보를 여기서 넘긴다.
            }
        } catch (IOException e) {
            Log.e("FINE_LOCATION", "Geocoder 실패", e);
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions,
                                           @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);                                           
        if (requestCode == REQ_FINE && grantResults.length > 0 &&
                grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            getPreciseLocation();
        } else {
            Log.e("FINE_LOCATION", "권한 거부됨");
        }
    }
}

KOTLIN

4. ACCESS_COARSE_LOCATION 기반 코드(Wi-Fi/셀룰러 기반 저정밀 위치정보)

• COARSE_LOCATION은 Wi-Fi 또는 셀룰러 연결이 되어 있어야 하며, FINE_LOCATION 위치정보보다는 정밀도가 떨어집니다(수백 미터 이상).

• 에뮬레이터에서는 정확한 정보를 얻어오지 못하는 경우가 많으니 실기기 테스트 권장합니다.

JAVA

package com.example.locationcoarse;

import android.Manifest;
import android.content.pm.PackageManager;
import android.location.Address;
import android.location.Geocoder;
import android.location.Location;
import android.os.Bundle;
import android.os.Looper;
import android.util.Log;

import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;

import com.google.android.gms.location.*;

import java.io.IOException;
import java.util.List;
import java.util.Locale;

public class MainActivity extends AppCompatActivity {

    private FusedLocationProviderClient fusedLocationClient;
    private static final int REQ_COARSE = 1002;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        fusedLocationClient = LocationServices.getFusedLocationProviderClient(this);
        getCoarseLocation();
    }

    private void getCoarseLocation() {
        if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.ACCESS_COARSE_LOCATION}, REQ_COARSE);
            return;
        }

        LocationRequest request = LocationRequest.create()
                .setPriority(LocationRequest.PRIORITY_BALANCED_POWER_ACCURACY)
                .setInterval(5000)
                .setFastestInterval(2000)
                .setNumUpdates(1);

        fusedLocationClient.requestLocationUpdates(request, new LocationCallback() {
            @Override
            public void onLocationResult(@NonNull LocationResult result) {
                Location location = result.getLastLocation();
                if (location != null) {
                    getAddress(location.getLatitude(), location.getLongitude());
                }
            }
        }, Looper.getMainLooper());
    }

    private void getAddress(double lat, double lng) {
        Geocoder geocoder = new Geocoder(this, Locale.KOREA);
        try {
            List<Address> results = geocoder.getFromLocation(lat, lng, 1);
            if (!results.isEmpty()) {
                Address addr = results.get(0);
                String province = addr.getAdminArea(); // 광역 시/도 (예: 경기도, 서울특별시)
                String city = addr.getLocality(); // 시/군 (예: 김포시, 성남시)
                String district = addr.getSubLocality(); // 구 (예: 분당구, 강남구). 구가 없으면 null 또는 시 이름과 동일할 수 있음.
                Log.d("COARSE_LOCATION", "주소: " + province + " " + city + " " + district);
                Log.d("COARSE_LOCATION", "위도: " + lat + ", 경도:" + lng);
                // TODO Region, Gcoder(lt, lng)정보를 여기서 넘긴다.
            }
        } catch (IOException e) {
            Log.e("COARSE_LOCATION", "Geocoder 실패", e);
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions,
                                           @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);                                           
        if (requestCode == REQ_COARSE && grantResults.length > 0 &&
                grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            getCoarseLocation();
        } else {
            Log.e("COARSE_LOCATION", "권한 거부됨");
        }
    }
}

KOTLIN