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

على الأجهزة التي تعمل بنظام التشغيل iOS 9 والإصدارات الأحدث، يمكنك استخدام الروابط العالمية لإطلاق Google "خرائط 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 وتنفيذ أحد الإجراءات:

  • عرض خريطة لموقع محدد ومستوى تكبير/تصغير.
  • البحث عن المواقع أو الأماكن، وعرضها على الخريطة.
  • اطلب الاتجاهات من موقع إلى آخر. يمكن إرجاع الاتجاهات لأربعة وسائل نقل: القيادة والمشي وركوب الدراجات والعامة النقل العام.
  • أضف التنقل إلى تطبيقك.
  • من خلال iOS 8، يمكنك إصدار معاودة الاتصال عند اكتمال التطبيق، باستخدام 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 المعلمات نفسها مثل comgooglemaps:// مخطط عنوان URL، مع المعلمات الإضافية التالية. كلتا المعلمتين مطلوبة.

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

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

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

سيطلق المثال التالي تطبيق خرائط Google لنظام التشغيل iOS ويعرض خريطة متعددة في نيويورك. سيعرض التطبيق أيضًا زرًا باسم "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 لمعاودة الاتصال. يمكن للتطبيق التحقّق من توفّر مخطط عناوين 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" تم النقر عليه، فسيتم استخدام تطبيق خرائط 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