شارك المقالة
فتح Google Maps من Flutter لعرض الاتجاهات دون API Key

فتح Google Maps من Flutter لعرض الاتجاهات دون API Key

افتح Google Maps من Flutter باستخدام url_launcher ورابط اتجاهات يدعم Android وiOS، دون API Key، مع فحص الإحداثيات ونتيجة فتح…

افتح Google Maps من Flutter باستخدام url_launcher ورابط اتجاهات يدعم Android وiOS، دون API Key، مع فحص الإحداثيات ونتيجة فتح الرابط.

اختر الحل المناسب للمهمة

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

رابط اتجاهات موحد للمنصات

نستخدم صيغة HTTPS الرسمية /maps/dir/ مع api=1 وdestination وtravelmode. يستطيع الرابط فتح التطبيق عندما تسمح المنصة بذلك أو الانتقال إلى واجهة الويب المناسبة. لا يحتاج Maps URL إلى Google API Key؛ لا تضف مفتاحًا إلى query string كما في أمثلة تستخدم google.navigation مع key غير مطلوب. روابط Android الخاصة قد تخدم حالة محددة، لكن الرابط الموحد أسهل كنقطة بداية مشتركة.

بناء Uri بدل تركيب نص غير منضبط

تقبل directionsUrl خط العرض والطول كقيم عددية، وتتحقق من finiteness وحدود الإحداثيات قبل إنشاء Uri. تجنب إدخال نص عنوان غير موثوق مباشرة داخل رابط مبني بالجمع؛ Uri.https يتولى ترميز query parameters. ترتيب الوجهة latitude ثم longitude مهم، لأن عكسهما قد ينتج مكانًا آخر يبدو صالحًا عدديًا. احفظ الإحداثيات الأصلية دون تقريب مفرط يغير مدخل المكان.

نتيجة launchUrl ومعالجة الفشل

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

هل أحتاج إلى إذن GPS؟

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

اختيار وسيلة الانتقال وإعداد الوجهة

المثال يضع driving، ويمكن تعديل travelmode وفق القيم الرسمية وتوفرها في المنطقة. إذا حصلت على المكان عبر اقتراحات البحث، فاحتفظ بمعرف المكان مع إحداثياته لتحسين تحديد الوجهة عند استخدام الخيارات المدعومة. لا تضع سر خادم في الرابط، ولا تمرر معلومات شخصية لا تحتاجها عملية الاتجاهات. اسم الوجهة المخصص في الواجهة يجب أن يطابق المكان الذي سيُفتح حتى لا يفاجأ المستخدم.

الفرق عن رسم مسار داخل التطبيق

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

اختبارات Android وiOS والويب

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

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

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

flutter pub add url_launcher

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

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

import 'package:url_launcher/url_launcher.dart';

Uri directionsUrl(double latitude, double longitude) {
  if (!latitude.isFinite || !longitude.isFinite || latitude.abs()>90 || longitude.abs()>180) {
    throw ArgumentError('Invalid destination');
  }
  return Uri.https('www.google.com', '/maps/dir/', {
    'api': '1', 'destination': '$latitude,$longitude', 'travelmode': 'driving',
  });
}
Future<void> openDirections(double latitude, double longitude) async {
  final opened = await launchUrl(directionsUrl(latitude, longitude),
      mode: LaunchMode.externalApplication);
  if (!opened) throw StateError('Unable to open Google Maps');
}

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

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

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