طرح‌واره نشانی وب Google Maps برای iOS

در دستگاه‌های دارای iOS 9 و بالاتر، می‌توانید از پیوندهای جامع برای راه‌اندازی Google Maps استفاده کنید، به‌شرطی که نشانی وب Google Maps را داشته باشید.

می‌توانید از طرح‌واره نشانی وب Google Maps برای راه‌اندازی برنامه Google Maps برای iOS و انجام جستجو، دریافت درخواست‌های مسیر، و نمایش نماهای نقشه استفاده کنید. وقتی Google Maps را راه‌اندازی می‌کنید، شناسه بسته نرم‌افزاری شما به‌طور خودکار به‌عنوان بخشی از درخواست ارسال می‌شود.

برای استفاده از طرح‌واره نشانی وب Google Maps به کلید Google API نیاز ندارید.

توجه: نشانی‌های وب Maps به شما امکان می‌دهد نشانی وب چندسکویی و جهانی برای راه‌اندازی Google Maps و انجام جستجو، دریافت مسیر، نمایش نماهای نقشه، و نمایش تصاویر سراسرنما بسازید. توصیه می‌کنیم از نشانی‌های وب Maps چندسکویی برای راه‌اندازی Google Maps استفاده کنید، زیرا این نشانی‌های وب جهانی امکان مدیریت گسترده‌تر درخواست‌های Maps را بدون توجه به پلاتفرمی که کاربر در آن قرار دارد فراهم می‌کنند. فقط باید از «طرح‌واره نشانی وب Maps» مختص iOS برای ویژگی‌هایی استفاده کنید که ممکن است فقط در پلاتفرم تلفن همراه کار کنند (برای مثال، ناوبری گام‌به‌گام).

پیوندهای جامع و Google Maps

Google Maps برای iOS از پیوندهای جامع در دستگاه‌های دارای iOS 9 یا بالاتر پشتیبانی می‌کند.

اگر نشانی وب شما با عبارت باقاعده زیر مطابقت دارد و دستگاه از 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")!)

آبجکتیو-سی

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

نمای کلی

طرح‌واره نشانی وب به شما امکان می‌دهد برنامه iOS را از برنامه iOS دیگر یا برنامه وب راه‌اندازی کنید. می‌توانید گزینه‌هایی را در نشانی وب تنظیم کنید که به برنامه راه‌اندازی‌شده منتقل می‌شوند. برنامه Google Maps برای iOS از طرح‌واره‌های نشانی وب زیر پشتیبانی می‌کند:

• comgooglemaps:// - این طرح به شما امکان می‌دهد برنامه Google Maps را برای iOS راه‌اندازی کنید و یکی از چند کنش را انجام دهید:

  • نمایش نقشه در مکان و سطح بزرگ‌نمایی مشخص‌شده.
  • مکان‌ها یا جاها را جستجو کنید و آن‌ها را روی نقشه نمایش دهید.
  • درخواست مسیر از یک مکان به مکان دیگر. مسیرها را می‌توان برای چهار حالت حمل‌ونقل دریافت کرد: رانندگی، پیاده‌روی، دوچرخه‌سواری، و حمل‌ونقل عمومی.
  • به برنامه‌تان پیمایش اضافه کنید.

• comgooglemapsurl:// - این طرح به شما امکان می‌دهد برنامه Google Maps را برای iOS بااستفاده از نشانی وب برگرفته از وب‌سایت Google Maps در رایانه راه‌اندازی کنید. این یعنی می‌توانید به‌جای بار کردن وب‌سایت Google Maps، تجربه تلفن همراه را به کاربرانتان ارائه دهید.

  • نشانی وب اصلی می‌تواند برای maps.google.com یا google.com/maps باشد، یا از هر دامنه کشور سطح بالای معتبری به‌جای com استفاده کند. همچنین می‌توانید نشانی‌های وب تغییرمسیر goo.gl/maps را ارسال کنید.

راه‌اندازی برنامه Google Maps برای iOS و اجرای عملکردی خاص

توجه: از iOS 9 به بعد، برنامه شما باید طرح‌واره‌های نشانی وبی را که باز خواهد کرد اعلام کند. برای اطلاعات بیشتر، شروع به کار را ببینید.

برای راه‌اندازی برنامه Google Maps برای iOS و به‌طور اختیاری انجام یکی از عملکردهای پشتیبانی‌شده، از طرح‌واره نشانی وب به شکل زیر استفاده کنید:

comgooglemaps://?parameters

پارامترها در ادامه این سند به‌طور دقیق شرح داده شده‌اند.

بررسی دردسترس بودن برنامه Google Maps در دستگاه

قبل‌از اینکه یکی از این نشانی‌های وب را به کاربر در برنامه‌تان ارائه دهید، ابتدا باید تأیید کنید که برنامه نصب شده است. برنامه شما می‌تواند با کد زیر بررسی کند که طرح‌واره نشانی وب دردسترس است یا نه:

Swift

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

آبجکتیو-سی

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

آبجکتیو-سی

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

نمایش نقشه

از طرح‌واره نشانی وب برای نمایش نقشه در سطح بزرگ‌نمایی و مکان مشخص‌شده استفاده کنید. همچنین می‌توانید نماهای دیگر را روی نقشه‌تان قرار دهید یا تصاویر «نمای خیابان» را نمایش دهید.

پارامترها

همه پارامترهای زیر اختیاری هستند. اگر پارامتری تنظیم نشده باشد، طرح‌واره نشانی وب برنامه Google Maps را برای iOS راه‌اندازی خواهد کرد.

• center: این نقطه مرکزی نمای نقشه است. به‌صورت رشته جداشده با کاما از latitude,longitude قالب‌بندی شده است.
• ‫mapmode: نوع نقشه نشان‌داده‌شده را تنظیم می‌کند. می‌تواند روی این موارد تنظیم شود: standard یا streetview. اگر مشخص نشده باشد، از تنظیمات فعلی برنامه استفاده خواهد شد.
• views: نماهای خاصی را روشن/خاموش می‌کند. می‌تواند روی این موارد تنظیم شود: satellite، traffic، یا transit. بااستفاده از جداکننده کاما می‌توان چندین مقدار تنظیم کرد. اگر پارامتر بدون مقدار مشخص شود، همه نماها پاک خواهد شد.
• zoom: سطح بزرگ‌نمایی نقشه را مشخص می‌کند.

این نشانی وب نمونه، نقشه را با مرکزیت نیویورک در بزرگ‌نمایی ۱۴ با نمای ترافیک روشن نشان می‌دهد:

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: رشته پُرسمان برای جستجوی شما.

این نشانی وب نمونه برای جستجوی «پیتزا» در اطراف مکان مشخص‌شده است:

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.

نشانی وب نمونه مسیرهای حمل‌ونقل عمومی بین 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 Maps برای iOS با درخواست مسیرها به کاربران شما امکان می‌دهد از برنامه شما به ناوبری گام‌به‌گام دسترسی داشته باشند. می‌توانید از طرح‌واره نشانی وب comgooglemaps:// استفاده کنید.

راه‌اندازی برنامه Google Maps برای iOS از نشانی وب Google Maps در رایانه

اگر برنامه‌تان به نشانی وب Google Maps ازپیش موجودی دسترسی دارد، مثلاً در صفحه وب یا در پایگاه داده، می‌توانید از این طرح برای باز کردن نشانی وب در برنامه Google Maps برای iOS استفاده کنید و بدین‌ترتیب بهترین تجربه تلفن همراه را به کاربرانتان ارائه دهید.

• طرح http:// یا https:// را با comgooglemapsurl:// جایگزین کنید.

قالب‌های نشانی وب پشتیبانی‌شده Google Maps

طرح comgooglemapsurl:// از نشانی‌های وبی پشتیبانی می‌کند که با این عبارت باقاعده مطابقت داشته باشند، که در آن {TLD} به هر دامنه کشور سطح بالای معتبری اشاره دارد. شکست‌های خط برای شفافیت اضافه شده است:

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

بررسی دردسترس بودن برنامه Google Maps

ابتدا بررسی کنید که برنامه Google Maps برای iOS در دستگاه دردسترس باشد و از طرح‌واره نشانی وب پشتیبانی کند:

Swift

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

آبجکتیو-سی

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

مثال‌ها

نمونه‌ای از نشانی وب عمومی Google Maps:

نشانی وب اصلی Google Maps:

https://www.google.com/maps/preview/@42.585444,13.007813,6z

استفاده از طرح‌واره نشانی وب:

comgooglemapsurl://www.google.com/maps/preview/@42.585444,13.007813,6z

نمونه‌ای از نشانی وب عمومی Google Maps:

نشانی وب اصلی Google Maps:

https://maps.google.com/?q=@37.3161,-122.1836

استفاده از طرح‌واره نشانی وب:

comgooglemapsurl://maps.google.com/?q=@37.3161,-122.1836