شارك المقالة
تتبع موقع المستخدم في Flutter أثناء فتح الشاشة بأمان

تتبع موقع المستخدم في Flutter أثناء فتح الشاشة بأمان

شرح تتبع موقع المستخدم في Flutter أثناء فتح الشاشة، باستخدام geolocator وGoogle Maps، مع إدارة StreamSubscription ومعالجة الإذن والدقة والأخطاء.

شرح تتبع موقع المستخدم في Flutter أثناء فتح الشاشة، باستخدام geolocator وGoogle Maps، مع إدارة StreamSubscription ومعالجة الإذن والدقة والأخطاء.

حدد نطاق التتبع أولًا

تتبع موقع المستخدم في Flutter قد يعني تحديث علامة أثناء فتح شاشة التوصيل، أو تشغيل تتبع مستمر في الخلفية. هذا الدرس يركز على الشاشة المفتوحة فقط؛ لا يدعي تنفيذ خدمة خلفية أو متابعة بعد إنهاء التطبيق. اشرح للمستخدم الغرض من التتبع وابدأه بإجراء واضح منه. إعداد الخلفية والإشعارات والمتطلبات الخاصة بالمنصة يحتاج تصميمًا واختبارًا منفصلين عن هذا المثال.

الإذن والقراءة الأولى

نستخدم currentPosition من درس قراءة الموقع الحالي للتحقق من خدمة الجهاز والإذن قبل الاشتراك في stream. توفر القراءة الأولى مركزًا معقولًا لعرض الخريطة. لا تنشئ GoogleMap بموقع غير جاهز ثم تستخدم علامة تعجب لتجاوز الخطأ. في حال فشل الإذن أو الخدمة، تعرض الشاشة رسالة واضحة بدل انتظار متحكم الخريطة إلى أجل غير معلوم.

بدء الاشتراك مرة واحدة

يحفظ المثال StreamSubscription ويمنع إنشاء اشتراك جديد إذا كان موجودًا أو كانت عملية البدء قيد التنفيذ. بدون هذا الحاجز، قد تنشئ كل ضغطة زر مستمعًا إضافيًا يكرر التحديث ويزيد استهلاك البطارية. اضبط distanceFilter حسب وظيفة التطبيق؛ القيمة عشرة أمتار هنا مثال للتحديث عند حركة ملحوظة، وليست معدلًا زمنيًا مضمونًا ولا حدًا ثابتًا مناسبًا لكل مشروع.

التعامل مع الدقة والأخطاء

نتجاهل في المثال تحديثات دقتها المعلنة أسوأ من مئة متر حتى لا نقفز إلى علامة ضعيفة، لكن هذه عتبة قابلة للتغيير وليست معيار جودة عام. ينبغي أن تعرض الواجهة عمر آخر تحديث ودقته إذا كانا مؤثرين في القرار. قد تتوقف الخدمة أو يتغير الإذن أثناء المتابعة، لذلك يوجد onError ورسالة مناسبة. لا تحول الخطأ إلى موقع صفر أو إلى قراءة قديمة دون تنبيه.

تحريك العلامة مقابل تحريك الكاميرا

تحديث position لعلامة ذات MarkerId ثابت يغير موضعها على الخريطة. أما الكاميرا فلن تتبعها تلقائيًا لأن initialCameraPosition تحدد البداية فقط. إذا أضفت زر متابعة للكاميرا، حرّك GoogleMapController بعد جاهزيته وقلّل التحديثات حتى لا تحارب المستخدم أثناء سحب الخريطة يدويًا. المثال يعرض العلامة المتحركة ويترك سياسة متابعة الكاميرا لتصميم التطبيق.

إيقاف المتابعة وإدارة دورة الحياة

يلغي dispose الاشتراك عند إزالة الشاشة ويمنع mounted تحديث واجهة منتهية. قد تبقى الشاشة مركبة عند الانتقال إلى تبويب أو عند وضع التطبيق في الخلفية؛ في المنتج أضف مراقبة دورة الحياة لإيقاف المتابعة عند عدم الحاجة وإعادتها عند الاستئناف بعد فحص الإذن. وجود dispose وحده ليس إثباتًا أن التطبيق لا يطلب موقعًا عندما يصبح غير مرئي.

التتبع لا يحسب الطريق تلقائيًا

النقاط القادمة من GPS تصف حركة مرصودة وقد تتذبذب. رسم خط بينها ينتج أثر الحركة، ولا يعني طريق قيادة صالحًا أو تعليمات انعطاف. خدمة المسارات تحتاج نقطة بداية ونهاية ووسيلة انتقال، وهو ما نشرحه في رسم مسار Google Maps. إذا كان الهدف عرض السائق والعميل معًا، استخدم علامات أشخاص بمعرفات مستقرة بدل إعادة إنشاء الخريطة لكل مستخدم.

اختبار على جهاز فعلي

جرب الوقوف دون حركة والمشي وقطع الإنترنت وإطفاء خدمة الموقع وتغيير الإذن من الإعدادات. افتح الشاشة وأغلقها عدة مرات وتأكد من عدم تضاعف الاشتراكات. لا تستخدم نجاح المحاكي دليلًا كافيًا على أداء البطارية أو سلوك الخلفية. احفظ أقل قدر من المواقع اللازمة لعمل الخدمة، وأوقف مشاركة الموقع عندما ينتهي الغرض الذي وافق عليه المستخدم.

الإعداد أو عقد التكامل المطلوب

طبّق الجزء المناسب على مشروعك بعد مراجعة إصدار الحزمة والمنصة؛ قيم الإعداد هنا توضيحية وليست مفاتيح صالحة أو خدمة خلفية منشورة.

flutter pub add geolocator google_maps_flutter

مثال الكود المراجع

الكود التالي يوضح نطاق الدرس ولا يغني عن إعداد المنصة أو الخدمات المذكورة أعلاه. اختُبر بتحليل Dart واختبارات المنطق المناسبة؛ تشغيل GPS والخرائط والخدمات الخارجية يحتاج جهازًا وإعداداتك الخاصة.

ضع الدالة المشتركة التالية في ملف location_access.dart بجانب ملف المثال. لا تنس نقل الملف عند استخدام الاستيراد المحلي.

import 'package:geolocator/geolocator.dart';

Future<Position> currentPosition() async {
  if (!await Geolocator.isLocationServiceEnabled()) {
    throw StateError('location-service-disabled');
  }
  var permission = await Geolocator.checkPermission();
  if (permission == LocationPermission.denied) {
    permission = await Geolocator.requestPermission();
  }
  if (permission != LocationPermission.whileInUse &&
      permission != LocationPermission.always) {
    throw StateError(permission == LocationPermission.deniedForever
        ? 'permission-denied-forever'
        : 'permission-denied');
  }
  return Geolocator.getCurrentPosition(
    locationSettings: const LocationSettings(
      accuracy: LocationAccuracy.high,
      timeLimit: Duration(seconds: 20),
    ),
  );
}
import 'dart:async';
import 'package:flutter/material.dart';
import 'package:geolocator/geolocator.dart';
import 'package:google_maps_flutter/google_maps_flutter.dart';
import 'location_access.dart';

class ForegroundTrackingMap extends StatefulWidget {
  const ForegroundTrackingMap({super.key});
  @override
  State<ForegroundTrackingMap> createState() => _ForegroundTrackingMapState();
}
class _ForegroundTrackingMapState extends State<ForegroundTrackingMap> {
  StreamSubscription<Position>? subscription;
  LatLng? point;
  String status = 'اضغط لبدء التتبع';
  bool starting = false;
  Future<void> start() async {
    if (starting || subscription != null) return;
    setState(() => starting = true);
    try {
      final initial = await currentPosition();
      if (!mounted) return;
      setState(() => point = LatLng(initial.latitude, initial.longitude));
      subscription = Geolocator.getPositionStream(locationSettings:
        const LocationSettings(accuracy: LocationAccuracy.high, distanceFilter: 10))
          .listen((p) {
        if (!mounted || p.accuracy > 100) return;
        setState(() { point = LatLng(p.latitude,p.longitude); status = 'تحديث الموقع'; });
      }, onError: (Object error) { if (mounted) setState(() => status = 'تعذر تحديث الموقع'); });
    } catch (_) { if (mounted) setState(() => status = 'تحقق من خدمة الموقع والإذن'); }
    finally { if (mounted) setState(() => starting = false); }
  }
  @override
  void dispose() { unawaited(subscription?.cancel()); super.dispose(); }
  @override
  Widget build(BuildContext context) => Column(children: [
    Text(status), ElevatedButton(onPressed: starting ? null : start, child: const Text('بدء التتبع')),
    if (point != null) Expanded(child: GoogleMap(
      initialCameraPosition: CameraPosition(target: point!, zoom: 15),
      markers: {Marker(markerId: const MarkerId('me'),position: point!)},
    )),
  ]);
}

مراجع التنفيذ الرسمية

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع