شارك المقالة
الحصول على اسم المدينة والدولة في Flutter من الموقع الحالي

الحصول على اسم المدينة والدولة في Flutter من الموقع الحالي

تعلّم الحصول على اسم المدينة والدولة في Flutter عبر geolocator للإحداثيات وgeocoding للعنوان، مع معالجة الأذونات ونتائج العنوان الفارغة.

تعلّم الحصول على اسم المدينة والدولة في Flutter عبر geolocator للإحداثيات وgeocoding للعنوان، مع معالجة الأذونات ونتائج العنوان الفارغة.

الإحداثيات تختلف عن العنوان

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

الحزم والمنصات المدعومة

المثال يراجع واجهة geocoding 5 التي تستخدم Geocoding() لاستدعاء عمليات التحويل، مع geolocator 14 للموقع. لا تخلط الاستدعاءات العامة من نسخ قديمة مع واجهة الإصدار الجديد. راجع ملف القفل في مشروعك قبل النقل. دعم الحزمة الأساسية لا يعني أن كل إضافة تعمل على المنصات نفسها؛ اختبر المنصة المستهدفة وراجع قائمة دعم geocoding قبل اعتماد الكود للويب أو سطح المكتب.

طلب الإذن في الوقت المناسب

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

تحويل الموقع إلى مدينة ودولة

بعد نجاح قراءة Position نمرر latitude وlongitude إلى Geocoding().placemarkFromCoordinates. قد تعود عدة عناوين مرتبة بحسب صلتها بالموقع، وقد تكون النتيجة فارغة أو بعض حقولها مفقودة. لذلك لا نفترض وجود locality دائمًا؛ نستخدم subAdministrativeArea كبديل ثم نعرض المنطقة الإدارية والدولة بعد تصفية القيم الفارغة. هذه سياسة عرض قابلة للتعديل وليست ضمانًا بأن كل نقطة لها مدينة مسجلة.

كيفية عرض النتيجة في الشاشة

استدع currentCity من زر أو طبقة الحالة، وأظهر حالة تحميل ثم النتيجة أو رسالة خطأ قابلة لإعادة المحاولة. الكود يعيد نص العنوان، ولا يحتوي واجهة كاملة أو طلب إذن تلقائيًا عند كل build. عند انتظار النتيجة داخل StatefulWidget تحقق من mounted قبل تحديث الواجهة. إذا غيّر المستخدم موقعه أو أغلق الشاشة أثناء الطلب، تجاهل الاستجابة القديمة بدل استبدال بيانات أحدث بها.

الدقة وحدود خدمات العناوين

العنوان الناتج وصف تقريبي لموضع الإحداثيات، ولا يثبت عنوان السكن أو حدود المدينة قانونيًا. تختلف أسماء الأحياء وترجمتها وتوفرها بين الأنظمة والمناطق. خدمات geocoding الخاصة بالمنصة لها حدود استخدام وقد تعيد IO_ERROR أو خطأ شبكة؛ لا ترسل طلبًا لكل تغير طفيف في GPS. خزّن آخر نتيجة مؤقتًا حسب حاجة الشاشة وحدثها عند انتقال ملحوظ أو طلب صريح من المستخدم.

ماذا لو أردت البحث باسم مكان؟

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

اختبارات قبل الاعتماد في الإنتاج

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

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

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

flutter pub add geolocator geocoding

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

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

Future<String> currentCity() async {
  final p = await currentPosition();
  final places = await Geocoding().placemarkFromCoordinates(p.latitude, p.longitude);
  if (places.isEmpty) return 'العنوان غير متاح';
  final place = places.first;
  final city = (place.locality?.isNotEmpty ?? false)
      ? place.locality
      : place.subAdministrativeArea;
  final values = [city, place.administrativeArea, place.country]
      .whereType<String>().where((v) => v.trim().isNotEmpty).toSet();
  return values.isEmpty ? 'العنوان غير متاح' : values.join('، ');
}

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

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

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