🐦 Flutter 네이티브 패키지_Geolocator로 위치 정보 얻기

위치 정보 얻기
https://pub.dev/packages/geolocator

1. Android

android 폴더 > app 폴더 > src 폴더 > profile 폴더 > AndroidManifest.xml 파일

안드로이드에서 geolocator를 이용하려면 AndroidManifest.xml 파일에 퍼미션을 선언해야 함. AndroidManifest.xml 은 안드로이드 앱을 실행하는 데 필요한 다양한 정보를 설정하는 파일이며 이곳에 퍼미션을 설정함. 안드로이드에서 실행되는 앱이 사용자의 현재 위치를 얻으려면 AndroidManifest.xml 에 퍼미션을 다음처럼 선언해야 함.

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

2. iOS

ios 폴더 > Runner 폴더 > info.plist 파일

iOS에서 실행되는 앱이 사용자의 현재 위치를 얻으려면 iOS 앱의 info.plist 파일에 다음처럼 키를 등록해야 함.

<key>NSLocationWhenInUseUsageDescription</key>
<string>This app needs access to location when open.</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>This app needs access to location when in the background.</string>

📍 현재 위치 얻기

안드로이드와 iOS 설정을 했으면 이제 다트 코드에서 geolocator 패키지를 이용해 현재 위치를 얻으면 됨. geolocator 의 모든 기능은 Geolocator 클래스의 함수로 제공함.

먼저 현재 위치를 얻기 전에 기기에서 위치 정보 획득 기능이 활성화되었는지를 판단해야 함. 상황에 따라 기기 설정 등으로 위치 추적이 불가능할 수 있기 때문. 이는 Geolocator.isLocationServiceEnabled() 함수를 호출하면 쉽게 알아낼 수 있음. 이 함수의 반환값이 true 면 활성 상태, false 이면 비활성 상태라는 의미임.

// 위치 정보 획득 가능한지 확인
bool serviceEnabled = await Geolocator.isLocationServiceEnabled();
if (!servieEnabled) {
	return Future.error('Location services are disabled.');
}

기기에서 위치 추적 기능이 활성 상태라고 하면 그다음으로 퍼미션 설정을 확인함. 위치 추적은 사용자에게 민감한 기능이므로 허용할지를 사용자가 선택할 수 있게 하고 있음. 만약 사용자가 앱의 위치 추적 기능을 거부했다면 코드에서 위치를 가져올 수 없음. 앱에 위치 추적 퍼미션이 설정됐는지는 Geolocator.checkPermission() 함수로 쉽게 알 수 있음. 이 함수의 반환 값은 LocationPermission 객체이며 이 값이 Location.denied 라면 퍼미션이 거부된 상태임.

// 위치 추적 퍼미션 확인
LocationPermission permission = await Geolocator.checkPermission();
if (permission == LocationPermission.denied) {
	permission = await Geolocator.requestPermission();
    if (permission == LocationPermission.denied) {
    	return Future.error('permissions are denied');
    }
}

퍼미션이 거부된 상태에서는 위치를 가져올 수 없으므로 사용자에게 퍼미션을 허용해 달라고 다이얼로그를 띄워야 함. 퍼미션 조정 다이얼로그를 띄우는 함수는 GeoLocatior.requestPermission(). 그런데 사용자가 다시 거부할 수 있으므로 다이얼로그가 닫힐 때 사용자가 어떻게 조정했는지를 GeoLocation. requestPersmission() 함수의 결괏값으로 받아 다시 한번 퍼미션을 확인해야 함.

만약 위치 추적 퍼미션을 정상으로 부여했다면 이제 위치를 얻을 수 있음. 이때 Geolocator.getCurrentPosition() 함수를 이용함. 이 함수의 반환값인 Position 객체가 현재 위치에 해당하는 값임. 위치는 위도와 경도 값이며 Position 객체의 latitude, longitude 속성으로 얻음. latitude와 Longitude는 double 타입의 실수임.

// 현재 위치 구하기
Position position = await Geolocator.getCurrentPosition();
setState(() {
	latitude = position.latitude.toString();
    longitude = position.longitude.toString();
});

📍 현재 위치 활용하기

gelolocator 패키지를 활용해 현재 위치를 알려주는 앱을 만들어 볼 것임. 네이티브 코드와 연동해야 하므로 안드로이드와 iOS 각각에서 테스트해보려 함.

1단계. 패키지 등록하기

pubspec.yaml 파일을 열고 dependencies 항목에 다음처럼 패키지를 등록한 후 <Pub Get> 을 클릭.

dependencies:
  geolocator: ^8.2.1

2단계. 다트파일 작성하기

lib 하위에 있는main.dart 파일에 다음처럼 코드를 작성.

import 'package:flutter/material.dart';
import 'package:geolocator/geolocator.dart';

void main() => runApp(new MyApp());

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return new MaterialApp(
      theme: new ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: NativePluginWidget(),
    );
  }
}

class NativePluginWidget extends StatefulWidget {
  @override
  NativePluginWidgetState createState() => NativePluginWidgetState();
}

class NativePluginWidgetState extends State<NativePluginWidget> {
  String? latitude;
  String? longitude;

  getGeoData() async {
    LocationPermission permission = await Geolocator.checkPermission();
    if (permission == LocationPermission.denied) {
      permission = await Geolocator.requestPermission();
      if (permission == LocationPermission.denied) {
        return Future.error('permissions are denied');
      }
    }

    Position position await Geolocator.getCurrentPosition();
    setState(() {
      latitude.position.latitude.toString();
      longitude.position.longitude.toString();
    });
  }

  @override
  void initState() {
    super.initState();
    getGeoData();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text("Geolocator")),
      body: Container(
        color: Colors.indigo,
        child: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: (<Widget>[
              Text(
                'MyLocation',
                style: TextStyle(
                  color: Colors.white,
                  fontWeight: FontWeight.bold,
                  fontSize: 20,
                ),
              ),
              Text(
                'latitude : ${latitude}',
                style: TextStyle(
                  color: Colors.white,
                  fontWeight: FontWeight.bold,
                  fontSize: 20,
                ),
              ),
              Text(
                'longitude: ${longitude}',
                style: TextStyle(
                  color: Colors.white,
                  fontWeight: FontWeight.bold,
                  fontSize: 20,
                ),
              ),
            ]),
          ),
        ),
      ),
    );
  }
}

3단계. 안드로이드 설정하기

안드로이드 메인 환경 파일을 열고 퍼미션을 선언한다. 이 파일은 android/app/src/main 디렉터리에 있음. 이 파일을 열어 다음처럼 퍼미션을 선언함.

<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.flutter_lab">
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
  ...(생략)...
</manifest>

그런다음 안드로이드 AVD로 테스트하기 위해 가상의 위치 정보를 설정함. AVD 상단의 도구에서 가장 오른쪽의 Extended Controls 라고 하는 아이콘을 클릭함.

다음처럼 에뮬레이터 설정 창이 뜨면 왼쪽 메뉴에서 Location 을 선택하고 지도에서 임의의 지점을 클릭함. 그리고 지도 아래에 SAVE POINT 를 클릭한 후 Set Location을 클릭하면 지도에서 선택한 지점의 위치가 현재 기기의 위치로 설정됨.

4단계. 안드로이드 에뮬레이터에서 앱 실행하기

1단계에서 작성한 main.dart 파일을 안드로이드 에뮬레이터에서 실행해 결과를 확인함. 앱을 실행하면 다음 그림처럼 기기의 위치 정보에 접근을 허용할 것인지 묻는 창이 나타남. 여기서 While using the app (앱 사용 중에만 허용) 이나 Only this time(이번만 허용) 을 클릭하면 현재 위치가 출력되고, Don't allow(허용 안 함) 을 클릭하면 'permissions are denied' 메시지가 출력됨.

5단계. iOS 설정하기

iOS의 info.plist 파일에 키를 선언함. 이 파일은 iOS/Runner 디렉터리에 있음. info.plist 파일을 열고 마지막 부분에 다음처럼 키를 등록함

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  	...(생략)...
	<key>NSLocationWhenInUseUsageDescription</key>
	<string>This app needs access to location when open.</string>
	<key>NSLocationAlwaysUsageDescription</key>
	<string>This app needs access to location when in the background.</string>
</dict>
</plist>

그런 다음 iOS 시뮬레이터로 테스트하기 위해 가상의 위치 정보를 설정함. 시뮬레이터에서 Features > Location > Custom Location 메뉴를 클릭함.

5단계. iOS 시뮬레이터에서 앱 빌드하기

1단계에서 작성한 main.dart 파일을 Xcode의 iOS 시뮬레이터에서 실행해 결과를 확인함.

출처: https://product.kyobobook.co.kr/detail/S000200832185