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

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

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

لا تحتاج إلى مفتاح واجهة برمجة تطبيقات Google لاستخدام مخطط عناوين URL لخرائط Google.

"الروابط العامة" و"خرائط Google"

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

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

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

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

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

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

نظرة عامة

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

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

  • عرض خريطة في موقع ومستوى تكبير/تصغير محدد.
  • ابحث عن المواقع الجغرافية أو الأماكن، واعرضها على الخريطة.
  • يمكنك طلب الاتجاهات من موقع جغرافي إلى آخر. يمكن إرجاع الاتجاهات لأربع وسائل نقل: القيادة والمشي وركوب الدراجات والنقل العام.
  • إضافة ميزة التنقل إلى تطبيقك
  • حتى الإصدار 8 من نظام التشغيل iOS، يمكنك إصدار معاودة الاتصال عند اكتمال التطبيق، باستخدام comgooglemaps-x-callback://. غالبًا ما تُستخدم عمليات رد الاتصال لإعادة المستخدم إلى التطبيق الذي فتح خرائط Google لنظام التشغيل iOS في الأصل. لاحظ أنه في نظام iOS 9، يوفر النظام تلقائيًا رابط "الرجوع إلى" في الزاوية اليمنى من شريط الحالة.

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

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

إطلاق تطبيق خرائط Google لنظام التشغيل iOS وتنفيذ وظيفة محددة

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

comgooglemaps://?parameters

أو:

comgooglemaps-x-callback://?parameters

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

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

قبل تقديم أحد عناوين URL هذه إلى مستخدم في تطبيقك، عليك أولاً التأكد من تثبيت التطبيق. يمكن لتطبيقك التحقق من أن مخطط عنوان URL متاح بالتعليمة البرمجية التالية:

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

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

على سبيل المثال، لعرض خريطة لسنترال بارك في نيويورك، يمكنك استخدام الكود التالي:

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://");
}

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 نيويورك ومطار جون إف كينيدي:

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

تحديد عنوان URL لرد الاتصال

إذا أردت تحديد عنوان URL لمعاودة الاتصال، يجب استخدام مخطط عنوان URL comgooglemaps-x-callback://. ويتقيّد هذا المخطط بمواصفات x-callback-url. عند استدعاء تطبيق خرائط Google لنظام التشغيل iOS باستخدام هذا المخطط، سيعرض التطبيق زرًا في الجزء العلوي من الشاشة. سيؤدي النقر على هذا الزر إلى إصدار معاودة الاتصال إلى عنوان URL الذي حددته.

يجب أن تكون الطلبات المُرسَلة إلى comgooglemaps-x-callback:// بالصيغة التالية:

comgooglemaps-x-callback://?parameters

المعلّمات

يقبل مخطط عنوان URL لمعاودة الاتصال x المعلَمات نفسها التي يقبلها مخطط عنوان URL comgooglemaps://، مع المعلَمات الإضافية التالية. كلتا المعلمتين مطلوبتين.

• x-source — اسم التطبيق الذي يرسل طلب معاودة الاتصال x. يُفضَّل استخدام الأسماء المختصرة.
• x-success — عنوان URL المطلوب الاتصال به عند الانتهاء. وغالبًا ما يكون ذلك مخططًا لعنوان URL لتطبيقك، مما يسمح للمستخدمين بالعودة إلى التطبيق الأصلي.

لاحظ أنه يجب على تطبيقك تسجيل مخطط عنوان URL الخاص به حتى يتمكن من الاستجابة لعنوان URL لمعاودة الاتصال.

1. تأكَّد من أنّ تطبيقك قد سجّل مخطط عنوان URL يمكنه الاستجابة لطلب معاودة الاتصال.
2. اضبط تصنيف زر معاودة الاتصال في المعلَمة x-source.
3. مرِّر عنوان URL لرد الاتصال في المعلَمة x-success.

سيطلق المثال التالي تطبيق خرائط Google لنظام التشغيل iOS ويعرض خريطة متمركزة حول نيويورك. سيعرض التطبيق أيضًا زرًا باسم "SourceApp". عند النقر على زر SourceApp (SourceApp)، سيُصدر تطبيق "خرائط Google" لنظام التشغيل iOS استدعاءً إلى مخطط عنوان URL وهمي، sourceapp://?resume=true.

comgooglemaps-x-callback://?center=40.765819,-73.975866&zoom=14
   &x-success=sourceapp://?resume=true
   &x-source=SourceApp

كما هو الحال مع مخطط عنوان URL لـ comgooglemaps://، يجب أولاً أن تتحقّق من توفّر تطبيق "خرائط Google" لنظام التشغيل iOS على الجهاز، ومن أنّه يتوافق مع مخطط عنوان URL لرد الاتصال من x. يمكن لتطبيقك التحقق من توفُّر مخطط عنوان URL باستخدام الرمز التالي:

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

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

هذا مثال على عنوان URL يتيح للمستخدمين الرجوع إلى التطبيق بعد البحث عن الحلوى.

comgooglemaps-x-callback://?q=dessert&center=37.759748,-122.427135
   &x-success=sourceapp://?resume=true
   &x-source=Nom+Nom

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

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

ويوضح مقتطف الرمز هذا كيفية استخدام مخطط comgooglemaps-x-callback:// لطلب الاتجاهات، ثم العودة إلى تطبيقك عندما يكون المستخدم جاهزًا. ستقوم التعليمات البرمجية بما يلي:

1. تحقَّق من توفُّر مخطط عنوان URL لـ comgooglemaps-x-callback://.
2. فعِّل تطبيق "خرائط Google" لأجهزة iOS واطلب اتجاهات الوصول إلى مطار جون إف كينيدي في مدينة نيويورك. اترك عنوان البدء فارغًا لطلب الاتجاهات من الموقع الجغرافي الحالي للمستخدم.
3. أضف زرًا باسم "AirApp" إلى تطبيق "خرائط Google" لنظام التشغيل iOS. ويتم تحديد تصنيف الزر من خلال المَعلمة x-source.
4. ويمكنك استدعاء مخطط عنوان URL الوهمي sourceapp:// عندما ينقر المستخدم على زر الرجوع.

let testURL = URL(string: "comgooglemaps-x-callback://")!
if UIApplication.shared.canOpenURL(testURL) {
  let directionsRequest = "comgooglemaps-x-callback://" +
    "?daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York" +
    "&x-success=sourceapp://?resume=true&x-source=AirApp"

  let directionsURL = URL(string: directionsRequest)!
  UIApplication.shared.openURL(directionsURL)
} else {
  NSLog("Can't use comgooglemaps-x-callback:// on this device.")
}

NSURL *testURL = [NSURL URLWithString:@"comgooglemaps-x-callback://"];
if ([[UIApplication sharedApplication] canOpenURL:testURL]) {
  NSString *directionsRequest = @"comgooglemaps-x-callback://" +
      @"?daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York" +
      @"&x-success=sourceapp://?resume=true&x-source=AirApp";
  NSURL *directionsURL = [NSURL URLWithString:directionsRequest];
  [[UIApplication sharedApplication] openURL:directionsURL];
} else {
  NSLog(@"Can't use comgooglemaps-x-callback:// on this device.");
}

إطلاق تطبيق خرائط Google لنظام التشغيل iOS من عنوان URL لسطح المكتب في خرائط Google

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

1. استبدِل http:// أو https:// بالمخطط comgooglemapsurl://.
2. إذا كنت تريد استخدام معاودة الاتصال، عليك تضمين المَعلمتَين x-source وx-success. ويتقيّد هذا المخطط بمواصفات x-callback-url.

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

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

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

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

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

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

[[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

مثال على طلب الاتجاهات إلى برج طوكيو من خلال x-callback:

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

http://maps.google.com/maps?f=d&daddr=Tokyo+Tower,+Tokyo,+Japan&sll=35.6586,139.7454&sspn=0.2,0.1&nav=1

في المثال التالي، سيتم تشغيل تطبيق خرائط Google لنظام التشغيل iOS وعرض خريطة تتضمن الاتجاهات إلى برج طوكيو، كما هو محدّد في عنوان URL الأصلي لخرائط Google (أعلاه). سيعرض التطبيق أيضًا زرًا باسم "SourceApp". عند النقر على زر SourceApp (SourceApp)، سيُصدر تطبيق "خرائط Google" لنظام التشغيل iOS استدعاءً إلى مخطط عنوان URL وهمي sourceapp://?resume=true.

comgooglemapsurl://maps.google.com/maps?f=d&daddr=Tokyo+Tower,+Tokyo,+Japan&sll=35.6586,139.7454&sspn=0.2,0.1&nav=1
    &x-source=SourceApp
    &x-success=sourceapp://?resume=true