على الأجهزة التي تعمل بنظام التشغيل 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/))
.*
على سبيل المثال،
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://
و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
. باستخدام مخطط عنوان URLcomgooglemapsurl://
.
- يمكن أن يكون عنوان URL الأصلي لعنوان
إطلاق تطبيق خرائط Google لنظام التشغيل iOS وتنفيذ وظيفة معينة
لتشغيل تطبيق خرائط Google لنظام التشغيل iOS، ويمكنك اختياريًا تنفيذ أحد الوظائف المعتمدة، يمكنك استخدام مخطط عنوان URL بالشكل التالي:
comgooglemaps://?parameters
أو:
comgooglemaps-x-callback://?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¢er=37.759748,-122.427135
في ما يلي بعض الأمثلة الإضافية:
comgooglemaps://?q=Steamers+Lane+Santa+Cruz,+CA¢er=37.782652,-122.410126&views=satellite,traffic&zoom=15
comgooglemaps://?q=Google+Japan,+Minato,+Tokyo,+Japan¢er=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¢er=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¢er=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 لمعاودة الاتصال.
- تأكد من أن التطبيق سجّل مخطط عنوان URL يمكنه الاستجابة إلى طلب معاودة الاتصال.
- مرِّر تصنيف زر معاودة الاتصال في المعلَمة
x-source
. - أدخِل عنوان 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.
مع التعليمة البرمجية التالية:
Swift
UIApplication.shared.canOpenURL(URL(string:"comgooglemaps-x-callback://")!)
Objective-C
[[UIApplication sharedApplication] canOpenURL:
[NSURL URLWithString:@"comgooglemaps-x-callback://"]];
هذا مثال على عنوان URL يتيح للمستخدمين الرجوع إلى تطبيق ما بعد البحث عن حلوى.
comgooglemaps-x-callback://?q=dessert¢er=37.759748,-122.427135
&x-success=sourceapp://?resume=true
&x-source=Nom+Nom
جارٍ إضافة ميزة التنقل إلى تطبيقك
يُعد إطلاق تطبيق خرائط Google لنظام التشغيل iOS مع طلب الاتجاهات طريقة سهلة
منح المستخدمين إمكانية الوصول إلى الاتّجاهات المفصّلة من خلال تطبيقك. يمكنك استخدام
إما مخطَّطات عناوين URL comgooglemaps://
أو comgooglemaps-x-callback://
.
يعرض مقتطف الرمز هذا كيفية استخدام مخطَّط comgooglemaps-x-callback://
من أجل
وطلب الاتجاهات، ثم الرجوع إلى تطبيقك عندما يصبح المستخدم جاهزًا. تشير رسالة الأشكال البيانية
المستخدم تنفيذ ما يلي:
- تأكَّد من أنّ مخطط عنوان URL
comgooglemaps-x-callback://
متاح. - يمكنك تشغيل تطبيق "خرائط Google" لأجهزة iOS وطلب الاتجاهات إلى مطار أبوظبي في مدينة نيويورك. اترك عنوان البداية فارغًا لطلب الاتجاهات من الموقع الجغرافي الحالي للمستخدم.
- إضافة زر يحمل اسم "AirApp" إلى تطبيق خرائط Google لنظام التشغيل iOS. الزر
يتم تحديد التصنيف من خلال المعلمة
x-source
. - يمكنك استدعاء مخطط عنوان URL الوهمي
sourceapp://
، عندما ينقر المستخدمون على زر الرجوع.
Swift
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.")
}
Objective-C
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، ما يوفر للمستخدمين أفضل تجربة مع الإعلانات المدمجة مع المحتوى.
- استبدِل المخطط
http://
أوhttps://
بـcomgooglemapsurl://
. - إذا كنت تريد استخدام معاودة الاتصال، يمكنك تضمين
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:
Swift
UIApplication.shared.canOpenURL(URL(string:"comgooglemaps-x-callback://")!)
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
مثال على طلب الاتّجاهات إلى "برج طوكيو" مع 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