패키지, 저장소 및 앱 카테고리 검색

패키지 상세v0.13.2

background_location

Android 및 iOS에서 백그라운드 위치 업데이트를 받기 위한 Flutter 플러그인입니다. iOS는 CoreLocation을, Android는 FusedLocationProvider를 사용합니다.

AndroidiOS
30일 다운로드
478
좋아요
397
Pub 점수
130

패키지 설치

flutter pub add background_location

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

background_location 패키지는 Android 및 iOS 플랫폼에서 백그라운드에서 지속적인 위치 추적을 가능하게 합니다. iOS의 CoreLocation과 Android의 FusedLocationProvider라는 네이티브 API를 활용하여 앱이 비활성 상태이거나 종료된 경우에도 정확하고 효율적인 위치 업데이트를 제공합니다. 피트니스 트래커, 라이드셰어 서비스 또는 자산 모니터링과 같은 지속적인 지리정보가 필요한 앱을 개발하는 개발자를 위해 설계되었으며, 다양한 기기에서 신뢰할 수 있는 성능을 보장합니다. 이 플러그인은 최소한의 설정으로 통합이 간편하며, 구성 가능한 업데이트 간격과 정밀도 설정을 지원합니다.

사용 사례

  • 피트니스 트래킹 앱
  • 라이드셰어링 서비스
  • 자산 모니터링
  • 지오펜싱 애플리케이션
  • 배송 추적

주요 기능

  • 백그라운드 위치 업데이트
  • 크로스 플랫폼 지원 (Android 및 iOS)
  • 네이티브 API 통합
  • 사용자 정의 가능한 정밀도 및 주파수
  • 최소한의 설정 필요

적합한 대상

  • 지속적인 위치 추적을 필요로 하는 앱
  • 실시간 위치 기능을 구축하는 개발자
  • 지오펜싱이 필요한 모바일 애플리케이션
  • 웨어러블 또는 IoT 장치 추적
  • 현장 서비스 또는 물류 소프트웨어

고려 사항

  • 배터리 소모량이 증가할 수 있습니다
  • 백그라운드 액세스를 위해 사용자 권한이 필요합니다
  • iOS 백그라운드 모드는 Xcode에서 활성화되어야 합니다
  • Android 포그라운드 서비스 알림이 필요합니다
  • 정확도는 장치의 하드웨어 및 설정에 따라 달라집니다

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

Background Location

A Flutter plugin to get location updates in the background for both Android and iOS (Requires iOS 10.0+). Uses CoreLocation for iOS and FusedLocationProvider for Android

Getting Started

1: Add this to your pubspec.yaml file:

dependencies:
  background_location: ^0.13.0

2: Install packages from the command line:

flutter pub get

Alternatively, your editor might support flutter packages get. Check the docs for your editor to learn more.

Configuration

For using background_location package you need to add permissions to use location service. Add these permission to your platform.

iOS Platform Permission

in ios/Runner/Info.plist add:

<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>[Describe your purpose for using this permission]</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>[Describe your purpose for using this permission]</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>[Describe your purpose for using this permission]</string>
<key>UIBackgroundModes</key>
<array>
    <string>fetch</string>
    <string>location</string>
</array>

Note: You need to describe your purpose for using the permission in to string value. If not, attempts to access the resource fail, and might even cause your app to crash. And when publishing to the App Store, this can cause your app to be rejected by Apple. Refer to Provide a purpose string (Apple Docummentation).

Android Platform Permission

In android/app/src/main/AndroidManifest.xml add:

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

How to use

Import the package where you wanna use it.

import 'package:background_location/background_location.dart';

Request permissions from the user. You can use permission_handler for this.

Set the notification title, message and icon (Android only). Use await or .then if you wanna start the location service immediately after because it's an asynchronous method

BackgroundLocation.setAndroidNotification(
  title: "Notification title",
  message: "Notification message",
  icon: "@mipmap/ic_launcher",
);

Set the interval between localizations in milliseconds (Android only). Use await or .then if you wanna start the location service immediately after because it's an asynchronous method

BackgroundLocation.setAndroidConfiguration(1000);

Start the location service. This will also ask the user for permission if not asked previously by another package.

// To ensure that previously started services have been stopped, if desired
BackgroundLocation.stopLocationService();

// Then start the service
BackgroundLocation.startLocationService();

Note: There is currently an open issue (#10) where, if the location service is started multiple times, the location callback will get called repeatedly. This can be worked around by calling BackgroundLocation.stopLocationService(); to stop any previous running services (such as from a previous run of the app) before starting a new one.

Start location service by specifying distanceFilter. Defaults to 0 if not specified

BackgroundLocation.startLocationService(distanceFilter : 10);

You can also force the use of Android LocationManager instead of Google's FusedLocationProvider by setting the forceAndroidLocationManager property to true. If not specified, this defaults to false, which uses FusedLocationProvider if it is available, treating LocationManager as a fallback. This setting has no effect on iOS devices.

BackgroundLocation.startLocationService(forceAndroidLocationManager: true);

getLocationUpdates will triggered whenever the location is updated on the device. Provide a callback function to getLocationUpdates to handle location updates.

BackgroundLocation.getLocationUpdates((location) {
  print(location);
});

location is a Class exposing the following properties.

double latitude;
double longitude;
double altitude;
double bearing;
double accuracy;
double speed;
double time;
bool isMock;

To stop listening to location changes you can execute.

BackgroundLocation.stopLocationService();

카테고리

소스 저장소

이 패키지를 사용하는 프로젝트

아직 데이터가 없습니다.