حدّث تحريك علامات flutter_map باستخدام Marker.child وAnimationController وMapController، مع فصل اختيار الموقع عن تحريك الكاميرا وإغلاق الموارد.
ماذا نحرّك في هذا الدرس؟
تحريك علامات flutter_map هنا يعني تأثيرًا بصريًا على العلامة المختارة، مع الانتقال بالكاميرا عند اختيار موقع من القائمة. التأثير النابض لا يعني وصول إحداثيات GPS جديدة، وتغيير مركز الكاميرا ليس تغيير موقع الشخص نفسه. المثال يستخدم نقطتين تجريبيتين حتى تفصل بين حالة الاختيار وحالة البيانات وحركة الرسم. إذا كنت تريد تتبع جهاز حي فراجع قراءة تدفق الموقع أولًا.
اختلاف flutter_map عن google_maps_flutter
flutter_map يعرض طبقات خريطة ويمكن أن تكون علامة Marker فيه أي Widget، بينما تعتمد علامة Google Maps عادة على صورة أو وصف bitmap. لا تنقل BitmapDescriptor إلى MarkerLayer. في الإصدارات الحديثة من flutter_map تُستخدم initialCenter وinitialZoom وMarker.child؛ أمثلة center وzoom وbuilder القديمة تحتاج مراجعة قبل نسخها. تمت مراجعة المثال على flutter_map 8.3.2 مع latlong2 للإحداثيات.
اختيار مزود البلاطات ونسب الحقوق
يستقبل المثال tileUrl وattribution من إعدادات تطبيقك بدل تضمين رمز Mapbox منشور داخل الشرح. استخدم عنوان قالب بلاطات يسمح مزوده بالاستخدام المطلوب، واضبط أي مفاتيح أو قيود وفق تعليماته. كون المكتبة مفتوحة المصدر لا يعني أن كل مزود بلاطات مجاني أو يسمح بتنزيل واسع أو استعمال إنتاجي دون شروط. لا تخفِ اسم المزود وحقوق البيانات؛ تظهر في المثال عبر RichAttributionWidget.
بناء الحركة دون إعادة إنشاء المتحكم
ننشئ AnimationController مرة واحدة على مستوى State ونستخدم repeat(reverse: true) لإعطاء نبض متكرر. AnimatedBuilder يحصر التحديث البصري في العلامة بدل إعادة بناء الشاشة كلها مع كل إطار. يتغير scale بين قيم صغيرة ومحددة، وتبقى مساحة Marker كافية للحجم الأكبر حتى لا تقص الحركة. إذا فضّل المستخدم تقليل الحركة، أوقف التكرار واعرض علامة ثابتة واضحة بدل جعل الاختيار معتمدًا على النبض فقط.
ربط القائمة بالعلامة المختارة
تخزن selected فهرس الموقع، ويختار كل زر نقطة واحدة ثم يحدث لونها وتأثيرها. تستخدم MapController.move لتحريك الكاميرا بعد جاهزية الخريطة. تغيير initialCenter لاحقًا ليس بديلًا مضمونًا عن تحريك متحكم خريطة موجودة بالفعل. عند استبدال الأزرار بـPageView، اربط onPageChanged بقاعدة الاختيار نفسها، واحتفظ بمعرف ثابت إذا كانت قائمة النقاط تتغير أو يعاد ترتيبها.
تجنب التكرار وتسرب الموارد
لا تنشئ AnimationController أو MapController داخل build، ولا تنشئ مؤقتًا جديدًا لكل إطار. dispose يغلق الموارد الخاصة بالشاشة عند إزالتها. إذا أضفت PageController أغلقه أيضًا، وإذا ربطت الشاشة بتدفق شبكة فألغ الاشتراك. العلامات التي تُزال من المجال المرئي قد تعاد بناؤها، لذلك احتفظ بحالة الاختيار في الشاشة أو مدير الحالة، وليس داخل عنصر علامة يفترض أن يظل حيًا دائمًا.
الأداء مع علامات كثيرة
النبض مناسب لعلامة مختارة أو عدد محدود، لكنه ليس تصميمًا جيدًا بالضرورة لآلاف العلامات المتحركة. ابدأ بقياس زمن الإطار على جهاز فعلي، وخفف الحركة والظلال والصور الكبيرة عند الحاجة. افصل تحديث الموقع الحقيقي عن الحركة الزخرفية ولا تعِد تحميل البلاطات لتغيير حجم أيقونة. عند عرض أشخاص متعددين استفد من تنظيم البيانات والمعرفات المستقرة مع مراعاة اختلاف نوع Marker بين المكتبتين.
اختبار الانتقال والحالات الحدية
جرب اختيارًا سريعًا بين النقطتين، ثم إغلاق الشاشة وإعادة فتحها، وتأكد أن المتحكم لا يستخدم بعد dispose. اختبر فشل مزود البلاطات وبقاء عناصر التحكم ورسالة الخطأ واضحة. تأكد من أن تأثير العلامة لا يغطي نصوص الأزرار أو نسب الحقوق. المثال يقدم بنية واجهة قابلة للتطوير، ولا يتضمن خدمة مسارات أو تتبع خلفية أو مفتاحًا جاهزًا للاستخدام من حساب شخص آخر.
الإعداد أو عقد التكامل المطلوب
طبّق الجزء المناسب على مشروعك بعد مراجعة إصدار الحزمة والمنصة؛ قيم الإعداد هنا توضيحية وليست مفاتيح صالحة أو خدمة خلفية منشورة.
flutter pub add flutter_map latlong2مثال الكود المراجع
الكود التالي يوضح نطاق الدرس ولا يغني عن إعداد المنصة أو الخدمات المذكورة أعلاه. اختُبر بتحليل Dart واختبارات المنطق المناسبة؛ تشغيل GPS والخرائط والخدمات الخارجية يحتاج جهازًا وإعداداتك الخاصة.
import 'package:flutter/material.dart';
import 'package:flutter_map/flutter_map.dart';
import 'package:latlong2/latlong.dart';
class AnimatedLocationsMap extends StatefulWidget {
const AnimatedLocationsMap({super.key, required this.tileUrl, required this.attribution});
final String tileUrl, attribution;
@override
State<AnimatedLocationsMap> createState() => _AnimatedLocationsMapState();
}
class _AnimatedLocationsMapState extends State<AnimatedLocationsMap>
with SingleTickerProviderStateMixin {
final controller = MapController();
late final animation = AnimationController(vsync: this,
duration: const Duration(milliseconds: 800))..repeat(reverse: true);
final points = const [LatLng(30.0444,31.2357), LatLng(30.05,31.24)];
int selected = 0;
bool ready = false;
@override
void dispose() { animation.dispose(); controller.dispose(); super.dispose(); }
@override
Widget build(BuildContext context) => Column(children: [
Expanded(child: FlutterMap(
mapController: controller,
options: MapOptions(initialCenter: points.first, initialZoom: 13,
onMapReady: () => ready = true),
children: [
TileLayer(urlTemplate: widget.tileUrl, userAgentPackageName: 'com.example.maps'),
MarkerLayer(markers: [for (var i=0; i<points.length; i++) Marker(
point: points[i], width: 56, height: 56,
child: AnimatedBuilder(animation: animation, builder: (context, child) =>
Transform.scale(scale: i == selected ? 0.8 + animation.value * 0.2 : 0.8,
child: Icon(Icons.location_pin, size: 48,
color: i == selected ? Colors.orange : Colors.blue))),
)]),
RichAttributionWidget(attributions: [TextSourceAttribution(widget.attribution)]),
],
)),
Wrap(children: [for(var i=0; i<points.length; i++) TextButton(
onPressed: () { if (!ready) return; setState(() => selected = i); controller.move(points[i],13); },
child: Text('الموقع ${i+1}'),
)]),
]);
}






