نشانیهای وب 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
نشانیهای وب در 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 را ببینید.