شارك المقالة
عرض مواقع الأشخاص على خريطة Flutter بعلامات مستقرة

عرض مواقع الأشخاص على خريطة Flutter بعلامات مستقرة

نظّم عرض مواقع الأشخاص على خريطة Flutter باستخدام MarkerId ثابت وبيانات typed، مع تحديث الأيقونات خارج build وإظهار وقت آخر…

نظّم عرض مواقع الأشخاص على خريطة Flutter باستخدام MarkerId ثابت وبيانات typed، مع تحديث الأيقونات خارج build وإظهار وقت آخر موقع.

نموذج البيانات أهم من عدد العلامات

عرض مواقع الأشخاص على خريطة Flutter يبدأ ببيانات واضحة لكل شخص: معرف ثابت واسم وإحداثيات ووقت تحديث. لا تستخدم الاسم وحده كمعرف، لأن شخصين قد يحملان الاسم نفسه أو قد يغير أحدهما اسمه. المثال يعرّف PersonPoint بدل خرائط dynamic المتفرقة، ويحوّل البيانات إلى Set<Marker> من خلال دالة منفصلة قابلة للاختبار قبل توصيلها بالشبكة أو الشاشة.

فصل القراءة عن الرسم

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

معرفات ثابتة ونسخة حديثة لكل شخص

إذا وصلت سجلات مكررة للمعرف نفسه، يحتفظ المثال بالأحدث حسب updatedAt. النتيجة علامة واحدة لكل معرف بدل مضاعفة الأشخاص على الخريطة. افحص صلاحية الإحداثيات قبل الرسم، ولا تحول بيانات تالفة تلقائيًا إلى صفر. في تدفق لحظي، اجعل مصدر الحقيقة خريطة keyed by id ثم اشتق العلامات منها؛ عند الحذف يجب أن تختفي العلامة من اللقطة التالية.

تحميل الصور والأيقونات مرة واحدة

تستقبل الدالة قاموس icons جاهزًا، وتستخدم العلامة الافتراضية إذا لم تجهز أيقونة الشخص. تحميل صور الشبكة أو تحويل assets إلى bitmaps لا يجب أن يحدث داخل build. نفذ التحميل في طبقة مستقلة واحتفظ بنتائجه ثم حدّث الحالة عند اكتمال دفعة مناسبة. تفاصيل تجهيز الصور موضحة في تغيير أيقونة Marker، ويمكن مشاركة الأيقونة نفسها لعدة أشخاص بدل تخزين نسخة لكل علامة.

عرض وقت آخر تحديث

موقع مرسوم لا يعني أن صاحبه موجود الآن في المكان نفسه. يخفف المثال شفافية العلامة بعد مرور خمس دقائق، وهي سياسة عرض تجريبية يمكنك تعديلها. أظهر وقت آخر تحديث أو وصفًا مناسبًا للمستخدم، واحسب الفرق من أوقات موثوقة مع مراعاة اختلاف ساعة الجهاز. لا تعرض بيانات قديمة تحت وصف مباشر، ولا تستنتج حالة اتصال الشخص من وصول موقع سابق فقط.

تحريك الكاميرا عند اختيار شخص

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

التحديث اللحظي ودورة الحياة

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

اختبارات تكشف الأخطاء مبكرًا

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

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

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

flutter pub add google_maps_flutter

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

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

import 'package:google_maps_flutter/google_maps_flutter.dart';

class PersonPoint {
  const PersonPoint(this.id, this.name, this.point, this.updatedAt);
  final String id, name;
  final LatLng point;
  final DateTime updatedAt;
}
Set<Marker> buildPeopleMarkers(Iterable<PersonPoint> people,
    Map<String, BitmapDescriptor> icons, DateTime now) {
  final latest = <String, PersonPoint>{};
  for (final p in people) {
    if (p.id.isEmpty || p.point.latitude.abs()>90 || p.point.longitude.abs()>180 ||
        !p.point.latitude.isFinite || !p.point.longitude.isFinite) continue;
    final prior = latest[p.id];
    if (prior == null || p.updatedAt.isAfter(prior.updatedAt)) latest[p.id] = p;
  }
  return latest.values.map((p) => Marker(
    markerId: MarkerId(p.id), position: p.point,
    icon: icons[p.id] ?? BitmapDescriptor.defaultMarker,
    alpha: now.difference(p.updatedAt) > const Duration(minutes: 5) ? 0.5 : 1,
    infoWindow: InfoWindow(title: p.name, snippet: 'آخر تحديث: ${p.updatedAt.toIso8601String()}'),
  )).toSet();
}

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

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

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