شارك المقالة
عرض الموقع الحالي في Flutter مع صلاحيات geolocator وGoogle Maps

عرض الموقع الحالي في Flutter مع صلاحيات geolocator وGoogle Maps

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

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

ما الذي ينجزه هذا المثال؟

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

جهّز الخريطة قبل الوصول إلى الجهاز

اتبع إعداد Google Maps على المنصات حتى تعمل خريطة ذات مركز ثابت. أضف geolocator إلى pubspec.yaml وراجع متطلبات نسخة الحزمة والمنصة. في Android أضف ACCESS_COARSE_LOCATION، وأضف ACCESS_FINE_LOCATION إذا كانت وظيفتك تحتاج دقة أعلى. على iOS وضّح سبب الاستخدام في NSLocationWhenInUseUsageDescription. لا تطلب إذن الخلفية لهذا المثال؛ هو مخصص لقراءة الموقع أثناء استخدام الشاشة.

الخدمة والإذن حالتان منفصلتان

تتحقق currentPosition أولًا من isLocationServiceEnabled، ثم تقرأ checkPermission وتطلب الإذن فقط عندما يكون denied. قبول الإذن لا يضمن تشغيل خدمة الموقع، ورفضه الدائم لا يُحل باستدعاء requestPermission مرات متتابعة. اعرض للمستخدم سبب الحاجة للموقع وخيار فتح الإعدادات عندما يختار ذلك. إذا رفض الإذن، أبقِ وظائف التطبيق غير المرتبطة بالموقع متاحة قدر الإمكان.

مهلة قراءة الموقع وحالات الواجهة

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

عرض GoogleMap دون وصول مبكر للقيم

تظل الخريطة غير معروضة حتى تصبح point غير فارغة. عند وصول Position نحوله إلى LatLng وننشئ CameraPosition بالمركز الصحيح. ValueKey في المثال يعيد إنشاء الخريطة عند طلب نقطة مختلفة ليبقى المثال واضحًا؛ في تطبيق كبير احتفظ بالمتحكم وحرك الكاميرا بدل إعادة إنشاء العرض كل مرة. استخدم myLocationEnabled فقط بعد الإذن، وتذكر أنه لا ينفذ عملية طلب الإذن عنك.

تفادي التحديث بعد إغلاق الشاشة

كل انتظار غير متزامن قد ينتهي بعد خروج المستخدم. لذلك نفحص mounted قبل setState، ولا ننشئ CameraPosition كمتغير static يعتمد على Position لم يُقرأ بعد. افصل أخطاء رفض الإذن عن مهلة الانتظار وخطأ المنصة إذا احتجت رسائل أكثر تحديدًا في منتجك. لا تعرض التفاصيل التقنية للمستخدم النهائي، لكن احتفظ بسجل تشخيص لا يحتوي موقعه الدقيق دون حاجة.

اختبار واقعي قبل النشر

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

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

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

<!-- Direct children of manifest, outside application -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

<!-- In ios/Runner/Info.plist: a truthful reason for location access -->
<key>NSLocationWhenInUseUsageDescription</key>
<string>نستخدم موقعك عند طلبك لعرضه على الخريطة.</string>

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

الكود التالي يوضح نطاق الدرس ولا يغني عن إعداد المنصة أو الخدمات المذكورة أعلاه. اختُبر بتحليل 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 'package:flutter/material.dart';
import 'package:google_maps_flutter/google_maps_flutter.dart';
import 'location_access.dart';

class CurrentLocationMap extends StatefulWidget {
  const CurrentLocationMap({super.key});
  @override
  State<CurrentLocationMap> createState() => _CurrentLocationMapState();
}
class _CurrentLocationMapState extends State<CurrentLocationMap> {
  LatLng? point;
  String? error;
  bool busy = false;
  Future<void> locate() async {
    setState(() { busy = true; error = null; });
    try {
      final p = await currentPosition();
      if (!mounted) return;
      setState(() => point = LatLng(p.latitude, p.longitude));
    } catch (_) {
      if (mounted) setState(() => error = 'تعذر تحديد الموقع. تحقق من الخدمة والإذن.');
    } finally {
      if (mounted) setState(() => busy = false);
    }
  }
  @override
  Widget build(BuildContext context) => Scaffold(
    body: point == null
        ? Center(child: Text(error ?? 'اضغط الزر لتحديد موقعك'))
        : GoogleMap(
            key: ValueKey(point),
            initialCameraPosition: CameraPosition(target: point!, zoom: 15),
            myLocationEnabled: true,
          ),
    floatingActionButton: FloatingActionButton(
      onPressed: busy ? null : locate,
      child: busy ? const CircularProgressIndicator() : const Icon(Icons.my_location),
    ),
  );
}

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

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

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