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

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

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

لست بحاجة إلى مفتاح واجهة برمجة التطبيقات من Google لاستخدام مخطط 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

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

المعلّمات

بالإضافة إلى المَعلمات المستخدَمة لعرض خريطة، يتيح "بحث" استخدام المَعلمة 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