パッケージ、リポジトリ、アプリカテゴリを検索

パッケージ詳細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();

カテゴリー

ソースリポジトリ

このパッケージを使用しているプロジェクト

データはまだありません。