مخطط عنوان URL في "خرائط Google" لنظام التشغيل iOS

على الأجهزة التي تعمل بنظام التشغيل iOS 9 والإصدارات الأحدث، يمكنك استخدام الروابط العامة لتشغيل "خرائط Google" عندما يكون لديك عنوان URL لخدمة "خرائط Google".

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

لا تحتاج إلى مفتاح Google API لاستخدام مخطّط عنوان URL في "خرائط Google".

يتيح تطبيق "خرائط Google" لأجهزة iOS استخدام الروابط العامة على الأجهزة التي تعمل بنظام التشغيل iOS 9 أو الإصدارات الأحدث.

إذا كان عنوان URL يتطابق مع التعبير العادي التالي، وكان الجهاز يعمل بنظام التشغيل iOS 9 أو إصدار أحدث، ننصحك باستخدام طريقة openURL: ‎ مباشرةً.

(http(s?)://)?
((maps\.google\.{TLD}/)|
 ((www\.)?google\.{TLD}/maps/)|
 (goo.gl/maps/))
.*

على سبيل المثال:

Swift

UIApplication.shared.openURL(URL(string:"https://www.google.com/maps/@42.585444,13.007813,6z")!)

Objective-C

[[UIApplication sharedApplication] openURL:
   [NSURL URLWithString:@"https://www.google.com/maps/@42.585444,13.007813,6z"]];

نظرة عامة

يتيح لك مخطّط عنوان URL تشغيل تطبيق iOS من تطبيق iOS آخر أو من تطبيق ويب. يمكنك ضبط الخيارات في عنوان URL الذي يتم تمريره إلى التطبيق الذي تم تشغيله. يتيح تطبيق "خرائط Google" لأجهزة iOS استخدام مخطّطات عناوين URL التالية:

  • comgooglemaps:// - يتيح لك هذا المخطط تشغيل تطبيق "خرائط Google" لنظام التشغيل iOS وتنفيذ أحد الإجراءات التالية:

    • عرض خريطة في موقع جغرافي ومستوى تكبير محدّدَين
    • البحث عن مواقع جغرافية أو أماكن وعرضها على خريطة
    • طلب اتجاهات من موقع جغرافي إلى آخر يمكن عرض الاتجاهات لأربع وسائل نقل: القيادة والمشي وركوب الدراجات والنقل العام.
    • أضِف ميزة التنقّل إلى تطبيقك.

  • comgooglemapsurl:// - يتيح لك هذا المخطط تشغيل تطبيق "خرائط Google" لنظام التشغيل iOS باستخدام عنوان URL مشتق من موقع "خرائط Google" الإلكتروني على أجهزة الكمبيوتر المكتبي. هذا يعني أنه يمكنك منح المستخدمين تجربة جوال بدلاً من تحميل موقع خرائط Google.

    • يمكن أن يكون عنوان URL الأصلي لـ maps.google.com أو لـ google.com/maps، أو يمكن أن يستخدم أي نطاق بلد صالح من المستوى الأعلى بدلاً من com. يمكنك أيضًا تمرير عناوين URL لإعادة التوجيه في goo.gl/maps.

تشغيل تطبيق "خرائط Google" لأجهزة iOS وتنفيذ وظيفة معيّنة

لتشغيل تطبيق "خرائط Google" لنظام التشغيل iOS وتنفيذ إحدى الوظائف المتوافقة اختياريًا، استخدِم مخطّط عنوان URL بالشكل التالي:

comgooglemaps://?parameters

يتم شرح المَعلمات بالتفصيل لاحقًا في هذا المستند.

التحقّق من توفّر تطبيق "خرائط Google" على الجهاز

قبل عرض أحد عناوين URL هذه للمستخدم في تطبيقك، عليك أولاً التحقّق من تثبيت التطبيق. يمكن لتطبيقك التحقّق من توفّر مخطّط عنوان URL باستخدام الرمز التالي:

Swift

UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)

Objective-C

[[UIApplication sharedApplication] canOpenURL:
    [NSURL URLWithString:@"comgooglemaps://"]];

على سبيل المثال، لعرض خريطة لـ "حديقة الأزهر" في القاهرة، يمكنك استخدام الرمز التالي:

Swift

if (UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)) {
  UIApplication.shared.openURL(URL(string:
    "comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic")!)
} else {
  print("Can't use comgooglemaps://");
}

Objective-C

if ([[UIApplication sharedApplication] canOpenURL:
     [NSURL URLWithString:@"comgooglemaps://"]]) {
  [[UIApplication sharedApplication] openURL:
   [NSURL URLWithString:@"comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic"]];
} else {
  NSLog(@"Can't use comgooglemaps://");
}

عرض خريطة

استخدِم مخطّط عنوان URL لعرض الخريطة بمستوى تكبير وموقع جغرافي محدّدَين. يمكنك أيضًا تراكب طرق عرض أخرى أعلى الخريطة أو عرض صور "التجوّل الافتراضي".

المعلّمات

جميع المَعلمات التالية اختيارية. في حال عدم ضبط أي مَعلمات، سيؤدي مخطّط URL إلى تشغيل تطبيق "خرائط Google" لأجهزة iOS.

  • ‫center: تمثّل هذه السمة نقطة مركز إطار عرض الخريطة. يتم تنسيقها كسلسلة من latitude,longitude مفصولة بفواصل.
  • ‫mapmode: لضبط نوع الخريطة المعروضة يمكن ضبطه على: standard أو streetview. وفي حال عدم تحديدها، سيتم استخدام إعدادات التطبيق الحالية.
  • ‫views: لتفعيل طرق عرض معيّنة أو إيقافها، ويمكن ضبطها على: satellite أو traffic أو transit يمكن ضبط قيم متعددة باستخدام فاصلة. إذا تم تحديد المَعلمة بدون قيمة، سيتم محو جميع طرق العرض.
  • ‫zoom: تحدّد مستوى تكبير الخريطة.

يعرض عنوان URL النموذجي هذا الخريطة التي تتوسّطها مدينة نيويورك عند مستوى التكبير 14 مع تفعيل عرض حركة المرور:

comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic

خريطة حركة المرور في نيويورك

في ما يلي بعض الأمثلة الإضافية:

comgooglemaps://?center=37.788463,-122.392545&zoom=12

comgooglemaps://?center=46.414382,10.013988&mapmode=streetview

استخدِم هذا المخطط لعرض طلبات البحث في موقع محدّد في إطار العرض.

المعلّمات

بالإضافة إلى المَعلمات المستخدَمة لعرض خريطة، يتيح محرّك بحث Google استخدام المَعلمة q.

  • ‫q: سلسلة طلب البحث.

عنوان URL هذا هو مثال على عمليات البحث عن "بيتزا" في الموقع الجغرافي المحدّد:

comgooglemaps://?q=Pizza&center=37.759748,-122.427135

مطاعم بيتزا قريبة

في ما يلي بعض الأمثلة الإضافية:

comgooglemaps://?q=Steamers+Lane+Santa+Cruz,+CA&center=37.782652,-122.410126&views=satellite,traffic&zoom=15

comgooglemaps://?q=Google+Japan,+Minato,+Tokyo,+Japan&center=35.660888,139.73073&zoom=15&views=transit

عرض الاتجاهات

استخدِم هذا المخطط لطلب الاتجاهات بين موقعَين جغرافيَّين وعرضها. يمكنك أيضًا تحديد وسيلة النقل.

المعلّمات

  • ‫saddr: لضبط نقطة البداية لعمليات البحث عن الاتجاهات يمكن أن يكون هذا خط عرض أو خط طول أو عنوانًا منسقًا لطلب البحث. إذا كانت سلسلة طلب بحث تعرض أكثر من نتيجة واحدة، سيتم اختيار النتيجة الأولى. إذا تُركت القيمة فارغة، سيتم استخدام الموقع الجغرافي الحالي للمستخدم.
  • ‫daddr: لضبط نقطة النهاية لعمليات البحث عن الاتجاهات له التنسيق والسلوك نفسهما مثل saddr.
  • ‫directionsmode: وسيلة النقل يمكن ضبطها على: driving أو transit أو bicycling أو walking.

يعرض عنوان URL في المثال اتجاهات النقل العام بين Google NYC ومطار JFK:

comgooglemaps://?saddr=Google+Inc,+8th+Avenue,+New+York,+NY&daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York&directionsmode=transit

اتجاهات النقل العام

في ما يلي بعض الأمثلة الإضافية:

comgooglemaps://?saddr=Google,+1600+Amphitheatre+Parkway,+Mountain+View,+CA+94043&daddr=Google+Inc,+345+Spear+Street,+San+Francisco,+CA&center=37.422185,-122.083898&zoom=10

comgooglemaps://?saddr=2025+Garcia+Ave,+Mountain+View,+CA,+USA&daddr=Google,+1600+Amphitheatre+Parkway,+Mountain+View,+CA,+United+States&center=37.423725,-122.0877&directionsmode=walking&zoom=17

إضافة ميزة التنقّل إلى تطبيقك

يتيح تشغيل تطبيق "خرائط Google" لنظام التشغيل iOS مع طلب الاتجاهات للمستخدمين الوصول إلى الاتجاهات المفصّلة من تطبيقك. يمكنك استخدام مخطط عنوان URL comgooglemaps://.

تشغيل تطبيق "خرائط Google" لأجهزة iOS من عنوان URL لخدمة "خرائط Google" على الكمبيوتر المكتبي

إذا كان بإمكان تطبيقك الوصول إلى عنوان URL حالي في "خرائط Google"، مثل عنوان URL على صفحة ويب أو في قاعدة بيانات، يمكنك استخدام هذا المخطط لفتح عنوان URL في تطبيق "خرائط Google" لأجهزة iOS، ما يقدّم للمستخدمين أفضل تجربة على الأجهزة الجوّالة.

  • استبدِل المخطط http:// أو https:// بـ comgooglemapsurl://.

تنسيقات عناوين URL المتوافقة مع "خرائط Google"

يتيح المخطط comgooglemapsurl:// استخدام عناوين URL التي تتطابق مع هذا التعبير العادي، حيث يشير {TLD} إلى أي نطاق بلد صالح من المستوى الأعلى. تمت إضافة فواصل الأسطر للتوضيح:

(http(s?)://)?
((maps\.google\.{TLD}/)|
 ((www\.)?google\.{TLD}/maps/)|
 (goo.gl/maps/))
.*

التحقّق من توفّر تطبيق "خرائط Google"

عليك أولاً التحقّق من توفّر تطبيق "خرائط Google" لنظام التشغيل iOS على الجهاز، ومن أنّه يتوافق مع مخطّط عنوان URL:

Swift

UIApplication.shared.canOpenURL(URL(string:"comgooglemapsurl://")!)

Objective-C

[[UIApplication sharedApplication] canOpenURL:
   [NSURL URLWithString:@"comgooglemapsurl://"]];

أمثلة

مثال على عنوان URL عام في "خرائط Google":

عنوان URL الأصلي على "خرائط Google":

https://www.google.com/maps/preview/@42.585444,13.007813,6z

باستخدام مخطّط عنوان URL:

comgooglemapsurl://www.google.com/maps/preview/@42.585444,13.007813,6z

مثال على عنوان URL عام في "خرائط Google":

عنوان URL الأصلي على "خرائط Google":

https://maps.google.com/?q=@37.3161,-122.1836

باستخدام مخطّط عنوان URL:

comgooglemapsurl://maps.google.com/?q=@37.3161,-122.1836