حدد منطقة خدمة في Flutter باستخدام Google Maps وPolygon، وتحقق من النقطة المختارة قبل قبول العنوان، مع سياسة واضحة لحافة المنطقة.
المنطقة المرسومة ليست شرط قبول تلقائيًا
تحديد منطقة خدمة في Flutter يتطلب رسم الحدود ثم التحقق من الإحداثيات التي اختارها العميل. Polygon يوضح الشكل فقط؛ وجوده على الخريطة لا يمنع الضغط خارج المنطقة. افصل القاعدة الجغرافية عن العرض حتى يمكنك اختبارها وحدها، ثم اربط زر قبول العنوان بنتيجتها. الأمثلة هنا لحي صغير، وليست بديلًا عن مراجعة حدود واسعة تعبر خط التاريخ أو مناطق جغرافية معقدة.
تجهيز الحدود وترتيب النقاط
ابدأ بقائمة LatLng تمثل رؤوس المضلع بترتيب متصل حول الحد. لا تجمع نقاطًا عشوائية أو تجعل الأضلاع تتقاطع دون تحديد المعنى المطلوب. في المثال أربع نقاط لمنطقة مستطيلة تقريبية قرب القاهرة، ويعاد استخدامها للرسم والحساب حتى لا تختلف الحدود بينهما. عند جلب الحدود من خادم، افحص عدد النقاط وصحة القيم قبل بناء الخريطة، وتأكد من ترتيب latitude ثم longitude.
سياسة التعامل مع حافة المضلع
containsLocation يختبر وجود النقطة داخل المساحة، ونضيف isLocationOnEdge بهامش متر واحد لقبول الحافة في سياسة هذا المثال. هذا الهامش قرار منتج، وليس ضمانًا لدقة GPS أو لدقة حدودك. إذا كانت سياسة التوصيل تتطلب استبعاد الحافة أو منطقة أمان فعدل القاعدة واختبرها. استخدم الإعداد الهندسي نفسه في حساب الاحتواء والرسم لتقليل المفاجآت عند مقارنة النتيجة بالشكل.
تحديث الحالة مع اللمس والسحب
تبدأ selected بقيمة فارغة، لذلك لا يكون العنوان مقبولًا قبل اختيار المستخدم. عند الضغط على الخريطة أو انتهاء سحب العلامة نخزن النقطة ونحسب allowed من الإحداثيات الحالية. لا تجعل القيمة الابتدائية true كما يحدث في أمثلة تسمح بالاستمرار دون فحص. وإذا استخدمت كاميرا ثابتة ومؤشرًا في منتصف الشاشة، استخرج مركز الكاميرا ثم طبق قاعدة الاحتواء نفسها.
الرسم والتأكيد وظيفتان مستقلتان
الخريطة تعرض المنطقة بشفافية لتبقى أسماء الشوارع مرئية، وتعرض العلامة فقط بعد اختيار النقطة. الزر يعمل داخل Route ويمكنه إعادة LatLng باستخدام Navigator.pop. إن كانت الشاشة جزءًا من تصميم آخر، مرر callback بدل الإغلاق. لا تعتمد على لون الزر وحده؛ أضف نصًا يوضح أن العنوان خارج نطاق الخدمة، مع إمكانية التحريك أو كتابة عنوان بديل.
التحقق من جهة الخادم
تعطيل الزر يحسن تجربة المستخدم لكنه لا يفرض قواعد التوصيل على كل عميل. أعد التحقق من الإحداثيات على الخادم عند حفظ الطلب باستخدام الحدود المعتمدة وإصدارها. قد تتغير منطقة الخدمة بينما الشاشة مفتوحة، لذلك تعامل مع رفض الطلب الجديد برسالة مفهومة. لا تعتبر قيمة قادمة من الهاتف تقول allowed=true إثباتًا مستقلًا على أن النقطة داخل النطاق.
اختبارات النقاط الحدودية
اختبر نقطة في الداخل ونقطة بعيدة ونقطة على ضلع ونقطة على رأس المضلع. أضف حالة عدم اختيار عنوان وحالة تحميل حدود فارغة. لا تستخدم المثال نفسه لحساب دائرة؛ إذا كانت الخدمة محددة بمسافة من فرع فراجع نطاق الخدمة الدائري. ويمكنك تحسين شكل نقطة الاختيار باستخدام أيقونة Marker مخصصة بعد أن تكون قاعدة القبول صحيحة.
الإعداد أو عقد التكامل المطلوب
طبّق الجزء المناسب على مشروعك بعد مراجعة إصدار الحزمة والمنصة؛ قيم الإعداد هنا توضيحية وليست مفاتيح صالحة أو خدمة خلفية منشورة.
flutter pub add google_maps_flutter maps_toolkitمثال الكود المراجع
الكود التالي يوضح نطاق الدرس ولا يغني عن إعداد المنصة أو الخدمات المذكورة أعلاه. اختُبر بتحليل Dart واختبارات المنطق المناسبة؛ تشغيل GPS والخرائط والخدمات الخارجية يحتاج جهازًا وإعداداتك الخاصة.
import 'package:flutter/material.dart';
import 'package:google_maps_flutter/google_maps_flutter.dart';
import 'package:maps_toolkit/maps_toolkit.dart' as geo;
const serviceArea = <LatLng>[
LatLng(30.04, 31.23), LatLng(30.04, 31.25),
LatLng(30.06, 31.25), LatLng(30.06, 31.23),
];
bool insideServiceArea(LatLng point) {
final p = geo.LatLng(point.latitude, point.longitude);
final polygon = serviceArea.map((v) => geo.LatLng(v.latitude, v.longitude)).toList();
return geo.PolygonUtil.containsLocation(p, polygon, false) ||
geo.PolygonUtil.isLocationOnEdge(p, polygon, false, tolerance: 1.0);
}
class ServiceAreaMap extends StatefulWidget {
const ServiceAreaMap({super.key});
@override
State<ServiceAreaMap> createState() => _ServiceAreaMapState();
}
class _ServiceAreaMapState extends State<ServiceAreaMap> {
LatLng? selected;
bool get allowed => selected != null && insideServiceArea(selected!);
@override
Widget build(BuildContext context) => Column(children: [
Expanded(child: GoogleMap(
initialCameraPosition: const CameraPosition(target: LatLng(30.05,31.24), zoom: 13),
onTap: (p) => setState(() => selected = p),
polygons: {Polygon(polygonId: const PolygonId('service'), points: serviceArea,
fillColor: Colors.blue.withValues(alpha: 0.2), strokeWidth: 2)},
markers: {if (selected != null) Marker(markerId: const MarkerId('selected'),
position: selected!, draggable: true, onDragEnd: (p) => setState(() => selected = p))},
)),
ElevatedButton(onPressed: allowed ? () => Navigator.pop(context, selected) : null,
child: const Text('اختيار العنوان')),
]);
}






