مرجع سریع نشانی‌های وب Maps

نشانی‌های وب Maps به شما امکان می‌دهد نشانی وب چندسکویی و جهانی بسازید که Google Maps را برای انجام جستجو، دریافت مسیر و ناوبری، نمایش نماهای نقشه، ایجاد فهرست کوتاه مکان‌ها، یا نمایش تمام‌نماهای «نمای خیابان» راه‌اندازی می‌کند. نحو نشانی وب در همه پلاتفرم‌ها یکسان است و به کلید API نیازی نیست.

نشانی‌های وب در Maps: حقایق کلیدی

  • محصول: نشانی‌های وب Maps
  • همچنین با این نام شناخته می‌شود: نشانی‌های وب Google Maps
  • دسته: Maps
  • پلاتفرم: طرح‌واره نشانی وب
  • مرحله راه‌اندازی: GA
  • چرخه حیات: فعال
  • نمای کلی: نمای کلی نشانی‌های وب Maps

نشانی‌های وب Maps: چه زمانی از آن استفاده کنید

در موارد زیر از نشانی‌های وب Maps استفاده کنید:

  • به پیوندی از برنامه Android، برنامه iOS، یا وب‌سایتتان نیاز دارید که Google Maps را برای جستجوی مکان یا نمایش نتایج جستجو باز کند.
  • باید Google Maps را با مسیرهای بین نقاط، به‌طور اختیاری با نقطه‌مسیرها، حالت سفر، یا ناوبری گام‌به‌گام باز کنید.
  • باید Google Maps را در نمای نقشه، فهرست کوتاه مکان‌ها، یا تمام‌نمای «نمای خیابان» بدون استفاده از کلید میانای برنامه‌سازی کاربردی باز کنید.
  • به یک نحو نشانی وب نیاز دارید که در Android،‏ iOS، و مرورگرهای رایانه به‌طور یکسان کار کند.

در موارد زیر از نشانی‌های وب Maps استفاده نکنید:

  • قبلاً «جزئیات جا» را درخواست کرده‌اید و پیوندهای Google Maps ازپیش قالب‌بندی‌شده را برای جایی می‌خواهید (فیلدهای googleMapsUri یا googleMapsLinks). درعوض از Places API (New) استفاده کنید.
  • هنگام راه‌اندازی برنامه Google Maps به ویژگی‌های مختص تلفن همراه نیاز دارید؛ از Google Maps Intents برای Android یا Google Maps URL Scheme برای iOS استفاده کنید.

نشانی‌های وب Maps: راه‌اندازی

  • اسناد استفاده: پارامترهای پُرسمان اختیاری utm_source (نام برنامه شما) و utm_campaign (کنش موردنظر کاربر، برای مثال place_details_search) را به نشانی‌های وب Maps اضافه کنید.
  • شروع به کار: راه‌اندازی نشانی‌های وب Maps
  • اغلب با این میانای برنامه‌سازی کاربردی استفاده می‌شود: Places API (جدید)

نشانی‌های وب Maps: اشتباهات رایج

  • مشکل: نشانی وب جستجویی که فقط طول/عرض جغرافیایی در query دارد، سنجاقی را نشان می‌دهد اما جزئیات مکان را در نقشه یا پانل کناری نشان نمی‌دهد. اصلاح: از query=PLACE_NAME,ADDRESS استفاده کنید یا query_place_id را درکنار query اضافه کنید تا جزئیات مکان خاص نشان داده شود. /maps/documentation/urls/get-started را ببینید.
  • مشکل: پارامترهای شناسه مکان (query_place_id، origin_place_id، destination_place_id، waypoint_place_ids) به‌تنهایی کار نمی‌کنند. اصلاح: همیشه هنگام ارسال پارامتر شناسه مکان، پارامتر پایه منطبق (query، origin، destination، یا waypoints) را اضافه کنید. /maps/documentation/urls/get-started را ببینید.
  • مشکل: پارامتر waypoints در محصولات Google Maps که از نقاط مسیر پشتیبانی نمی‌کنند نادیده گرفته می‌شود و محدودیت‌های شمارش وابسته به پلاتفرم دارد، و dir_action=navigate در جایی که ناوبری دردسترس نیست نادیده گرفته می‌شود. اصلاح: برای پیوندهایی که در مرورگرهای تلفن همراه باز می‌شوند، از حداکثر سه نقطه‌مسیر (درغیراین‌صورت، نه نقطه‌مسیر) استفاده کنید و به عملکرد waypoints یا dir_action=navigate در همه محصولات یا مسیرهای Google Maps وابسته نباشید. /maps/documentation/urls/get-started#directions-action را ببینید.
  • مشکل: Maps و «نمای خیابان» از یک نقطه پایانی @ استفاده می‌کنند، بنابراین نشانی وب نقشه بدون کنش درست ممکن است نقشه را نمایش ندهد. اصلاح: map_action=map را برای نماهای نقشه و map_action=pano را برای تمام‌نماهای «نمای خیابان» تنظیم کنید. /maps/documentation/urls/get-started را ببینید.
  • مشکل: اگر api=1 در نشانی وب Maps وجود نداشته باشد، همه پارامترها نادیده گرفته می‌شوند و Google Maps نمای پیش‌فرض خود را باز می‌کند. اصلاح: api=1 را در همه نشانی‌های وب Maps اضافه کنید (1 تنها مقدار معتبر است). /maps/documentation/urls/get-started#forming-the-url را ببینید.