مخطط عنوان 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:// - يتيح لك هذا المخطط إطلاق تطبيق "خرائط 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 باستخدام الرمز التالي:

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

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

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

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

إذا كان تطبيقك يتيح الوصول إلى عنوان URL حالي على "خرائط Google"، مثلاً على صفحة ويب أو في قاعدة بيانات، يمكنك استخدام هذا المخطط لفتح عنوان 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:

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

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