Google Maps برای Android Automotive Intents

ازطریق Android intents، می‌توانید ناوبری را در Google Maps برای Android Automotive راه‌اندازی کنید.

نمای کلی

این صفحه هدف‌هایی را که می‌توانید با Google Maps برای Android Automotive استفاده کنید شرح می‌دهد. برای مستندات دقیق توسعه‌دهنده Android، موارد زیر را ببینید:

درخواست‌های هدف

برای راه‌اندازی Google Maps ویژه Android Automotive با هدف، ابتدا باید شیء Intent را ایجاد کنید و کنش، شناسه منبع یکسان، و بسته آن را مشخص کنید.

  • کنش. همه هدف‌های Google Maps به‌عنوان کنش «مشاهده» فراخوانی می‌شوند، ACTION_VIEW.

  • URI. هدف‌های Google Maps از رشته‌های کدگذاری‌شده URI استفاده می‌کنند که کنش انتخاب‌شده را به‌همراه برخی‌از داده‌های لازم برای انجام کنش مشخص می‌کند.

  • بسته. فراخوانی setPackage("com.google.android.apps.maps") تضمین می‌کند که برنامه Google Maps برای Android، «هدف» را مدیریت می‌کند. اگر بسته تنظیم نشده باشد، سیستم تعیین می‌کند کدام برنامه‌ها می‌توانند Intent را مدیریت کنند. اگر چند برنامه دردسترس باشد، ممکن است از شما پرسیده شود که می‌خواهید از کدام برنامه استفاده کنید.

پس‌از ایجاد Intent، می‌توانید به روش‌های مختلفی از سیستم درخواست کنید برنامه مربوطه را راه‌اندازی کند. یک روش رایج این است که Intent را به روش startActivity() ارسال کنید. سیستم برنامه لازم را راه‌اندازی می‌کند، در این مورد، Google Maps، و Activity مربوطه را شروع می‌کند.

// Create a Uri from an intent string. Use the result to create an Intent.
Uri mapIntentUri =
Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia");
// Create an Intent from mapIntentUri. Set the action to ACTION_VIEW
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
// Make the Intent explicit by setting the Google Maps package
mapIntent.setPackage("com.google.android.apps.maps");
// Attempt to start an activity that can handle the Intent
startActivity(mapIntent);

اگر سیستم نتواند برنامه‌ای را که می‌تواند به Intent پاسخ دهد شناسایی کند، ممکن است برنامه‌تان ازکار بیفتد. به همین دلیل، ابتدا بررسی کنید که برنامه گیرنده نصب شده باشد و سپس یکی از این هدف‌ها را به کاربر ارائه دهید.

برای تأیید اینکه برنامه‌ای برای دریافت هدف دردسترس است، resolveActivity() را در شیء Intent خود فراخوانی کنید. اگر نتیجه غیرتهی باشد، حداقل یک برنامه وجود دارد که می‌تواند هدف را مدیریت کند و تماس با startActivity() ایمن است. اگر نتیجه تهی است، نباید از هدف استفاده کنید و درصورت امکان، ویژگی‌ای را که هدف را فراخوانی می‌کند غیرفعال کنید.

if (mapIntent.resolveActivity(getPackageManager()) != null) {
...
}

برای مثال، برای راه‌اندازی ناوبری گام‌به‌گام به باغ‌وحش تارونگا در سیدنی، می‌توانید از کد زیر استفاده کنید:

Uri mapIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
if (mapIntent.resolveActivity(getPackageManager()) != null) {
startActivity(mapIntent);
}

رشته‌های پُرسمان کدبندی‌شده URI

همه رشته‌های ارسال‌شده به هدف‌های Google Maps باید با URI کدگذاری شده باشند. برای مثال، رشته «1st & Pike, Seattle» باید به 1st%20%26%20Pike%2C%20Seattle تبدیل شود. فاصله‌ها در رشته را می‌توان با %20 کدگذاری کرد یا با علامت جمع (+) جایگزین کرد.

می‌توانید از روش android.net.Uri encode() برای کدبندی رشته‌هایتان استفاده کنید. برای مثال:

Uri mapIntentUri = Uri.parse("google.navigation:q=" + Uri.encode("1st & Pike, Seattle"));

نمایش نقشه

از هدف geo: برای نمایش نقشه در مکان و سطح بزرگ‌نمایی مشخص‌شده استفاده کنید. برای مثال:

geo:latitude,longitude?z=zoom

پارامترها

  • latitude و longitude نقطه مرکزی نقشه را تنظیم می‌کنند.

  • z به‌طور اختیاری سطح بزرگ‌نمایی اولیه نقشه را تنظیم می‌کند. محدوده مقادیر پذیرفته‌شده از ۰ (کل جهان) تا ۲۱ (ساختمان‌های مجزا) است. حد بالا می‌تواند بسته به داده‌های نقشه موجود در مکان انتخاب‌شده متفاوت باشد.

مثال

// Creates an intent that will load a map of San Francisco
Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

جستجوی موقعیت مکانی

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

geo:latitude,longitude?q=query
geo:0,0?q=my+street+address

پارامترها

علاوه‌بر پارامترهای استفاده‌شده برای نمایش نقشه، «جستجو» از این پارامتر پشتیبانی می‌کند:

  • q جاهایی را که باید در نقشه برجسته شود تعریف می‌کند. پارامتر q برای همه درخواست‌های «جستجو» الزامی است. مکان را به‌صورت نام مکان یا نشانی می‌پذیرد. رشته باید URL-escaped باشد، بنابراین نشانی‌ای مثل «City Hall, New York, NY» باید به City+Hall%2CNew+York%2CNY تبدیل شود.

نتایج جستجوی سوگیری با مختصات

هنگام جستجوی مکانی بسیار خاص، اگر طول و عرض جغرافیایی در پارامتر q گنجانده شده باشد، الزاماً به آن‌ها نیازی نیست. بااین‌حال، اگر نشانی دقیق را نمی‌دانید یا پُرسمان مبهم است، می‌توانید با مشخص کردن مختصات، نتایج جستجو را سوگیری کنید. برای مثال، انجام جستجوی نشانی برای «خیابان اصلی» ممکن است نتایج بسیار زیادی را برگرداند:

// Searching for "101 Main Street" with no lat/long might return too many results
Uri gmmIntentUri = Uri.parse("geo:0,0?q=101+main+street");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

افزودن طول و عرض جغرافیایی به URI هدف، نتایج را به‌سمت منطقه خاصی متمایل می‌کند:

// Searches for "101 Main Street" near San Francisco
Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?q=101+main+street");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

جستجو درطول مسیر

اگر قصد جستجوی geo:latitude,longitude?q=query درطول ناوبری ارسال شود، جستجویی درطول مسیر راه‌اندازی می‌شود و طول و عرض جغرافیایی نادیده گرفته می‌شود.

جستجوی دسته‌های ازپیش تعریف‌شده

برای پشتیبانی از ادغام با خودرو، Google Maps در خودرو از هدفی پشتیبانی می‌کند که این دسته‌های ازپیش تعریف‌شده را نمایش می‌دهد:

دسته کدبندی دسته هدف
پمپ‌بنزین gas_station
رستوران restaurant
کافه cafe
پارکینگ parking
ایستگاه شارژ خودرو برقی electric_vehicle_charging_station

قصد دسته به‌صورت geo:lat,lng?c=category است.

صرف‌نظر از تنظیمات منطقه زبانی کاربر، از c=<pre-defined category> استفاده کنید. Google Maps نتایج مرتبط را در منطقه زبانی مناسب برای این دسته نمایش می‌دهد. برای مثال:

// Search for gas stations nearby
Uri gmmIntentUri = Uri.parse("geo:0,0?c=gas_station");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

جستجوی دسته‌ای دیگر

اگر عبارت جستجوی عمومی (مانند «رستوران‌ها» یا «کافه‌ها») را در منطقه کاربر ارسال کنید، Google Maps ویژه Android Automotive فهرستگان‌های کسب‌وکار مطابق با معیارها را جستجو می‌کند. اگر طول و عرض جغرافیایی خاصی در هدف geo: ارائه شده باشد، جستجو حول آن مکان انجام می‌شود. اگر مکانی مشخص نشده باشد (مثلاً geo:0,0)، Google Maps سعی می‌کند فهرستگان‌های کسب‌وکار اطراف را پیدا کند. برای مثال:

// Search for restaurants nearby
Uri gmmIntentUri = Uri.parse("geo:0,0?q=restaurants");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

می‌توانید با مشخص کردن پارامتر بزرگ‌نمایی همراه با رشته پُرسمان، نتایج جستجو را بیشتر سوگیری کنید. در مثال زیر، افزودن بزرگ‌نمایی 10 تلاش می‌کند رستوران‌ها را در سطح شهر به‌جای اطراف پیدا کند:

Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?z=10&q=restaurants");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

راه‌اندازی ناوبری گام‌به‌گام

برای اسناد مربوط به راه‌اندازی ناوبری گام‌به‌گام در سایر دستگاه‌های Android، به راه‌اندازی ناوبری گام‌به‌گام در Google Maps Intents برای Android مراجعه کنید.

از این هدف برای راه‌اندازی ناوبری Google Maps با مسیرهای گام‌به‌گام به یک یا چند نشانی یا مختصات مشخص‌شده استفاده کنید. مسیرها همیشه از مکان فعلی کاربر ارائه می‌شود.

google.navigation:q=a+street+address
google.navigation:q=latitude,longitude
google.navigation:place=placename

پارامترها

برای راه‌اندازی پیمایش، از place یا q با waypoints (اختیاری) استفاده کنید. برای علامت‌گذاری اختیاری نقطه‌مسیر به‌عنوان ایستگاه شارژ، به ارسال برنامه سفر خودرو برقی به Google Maps مراجعه کنید.

  • q نقطه پایانی را برای جستجوهای ناوبری تنظیم می‌کند. این مقدار می‌تواند طول و عرض جغرافیایی یا نشانی قالب‌بندی‌شده پُرسمان باشد. اگر رشته پُرسمانی باشد که بیش‌از یک نتیجه برمی‌گرداند، اولین نتیجه انتخاب خواهد شد.

  • place نقطه پایانی را روی خانه یا محل کار تنظیم می‌کند. برای پیمایش به خانه کاربر، home را مشخص کنید و برای پیمایش به محل کار کاربر، work را مشخص کنید.

  • avoid ویژگی‌هایی را تنظیم می‌کند که مسیر باید سعی کند از آن‌ها اجتناب کند. avoid اختیاری است و می‌تواند روی یک یا چند مورد از موارد زیر تنظیم شود:

    • t برای عوارضی
    • h برای بزرگراه‌ها
    • ‫f برای کشتی‌ها
  • waypoints یک یا چند مکان واسطه را برای مسیریابی جهت‌ها به مقصد نهایی مشخص‌شده توسط q تعیین می‌کند. می‌توانید چند نقطه‌مسیر را بااستفاده از نویسه خط عمودی (|) برای جدا کردن مکان‌ها مشخص کنید—برای مثال، Berlin,Germany|Paris,France. می‌توانید از هر تعداد نقطه‌مسیر که لازم است استفاده کنید. نقطه‌مسیرها به همان ترتیبی که در نشانی وب فهرست شده‌اند به مسیر اضافه خواهند شد. هر نقطه‌مسیر می‌تواند نشانی یا مختصات طول و عرض جغرافیایی جداشده با کاما باشد؛ و می‌توانید نشانی‌ها و مختصات طول و عرض جغرافیایی را در یک قصد داشته باشید. رشته‌ها باید URL-escaped باشند، بنابراین نقاط‌مسیر مانند «Berlin,Germany|Paris,France» باید به Berlin%2CGermany%7CParis%2CFrance تبدیل شوند.

مثال‌ها

این Intent ناوبری گام‌به‌گام به باغ‌وحش تارونگا در سیدنی استرالیا را درخواست می‌کند:

Uri mapIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

اگر ترجیح می‌دهید عوارض پرداخت نکنید یا سوار کشتی نشوید، می‌توانید مسیریابی‌ای درخواست کنید که سعی می‌کند از این موقعیت‌ها اجتناب کند:

Uri mapIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&avoid=tf");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

یا اگر ترجیح می‌دهید به خانه‌تان پیمایش کنید، از این عبارت استفاده کنید:

Uri mapIntentUri = Uri.parse("google.navigation:place=home");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

برای راه‌اندازی ناوبری گام‌به‌گام به سه نشانی زیر به‌ترتیب، «باغ‌وحش تارونگا» را به‌عنوان مقصد نهایی q، و «Google سیدنی» و «سالن اپرای سیدنی» را به‌عنوان نقطه‌مسیرها ارسال کنید:

  1. Google Sydney

  2. تالار اپرای سیدنی

  3. باغ‌وحش تارونگا، سیدنی استرالیا

Uri mapIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&waypoints=Google+Sydney%7CSydney+Opera+House");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

مشابه q، می‌توانید هرکدام از نقطه‌مسیرها را به‌جای نشانی با طول و عرض جغرافیایی جداشده با کاما نشان دهید. برای مثال، برای راه‌اندازی همان ناوبری درحالی‌که طول و عرض جغرافیایی «تالار اپرای سیدنی» را به‌جای نشانی آن ارسال می‌کنید:

Uri mapIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&waypoints=Google+Sydney%7C-33.856159,151.215256");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

ارسال برنامه سفر با خودرو برقی به Google Maps

از این هدف پیمایش چندمقصدی برای مشخص کردن برخی‌از مقصدها به‌عنوان ایستگاه‌های شارژ خودرو برقی (EV) استفاده کنید. این هدف، که هدف چند نقطه‌مسیر را گسترش می‌دهد، به رانندگان کمک می‌کند تا با همگام‌سازی اطلاعات ایستگاه شارژ بین برنامه‌های برنامه‌ریزی سفر خودرو برقی و Google Maps، شارژ باتری خودرو برقی را برای رسیدن به مقصد حفظ کنند.

برای ایستگاه‌های شارژ، هدف‌های سفر:

  • باید حاوی نام و طول و عرض جغرافیایی باشد
  • می‌تواند به‌طور اختیاری حاوی خروجی برق باشد که برای محاسبه زمان شارژ استفاده می‌شود

Google از نام ایستگاه شارژ و طول و عرض جغرافیایی برای پیدا کردن مکان ایستگاه شارژ منطبق استفاده می‌کند تا داده‌های غنی مانند انواع رابط، مجموع، سرعت، و دردسترس بودن هم‌زمان، روش‌های پرداخت پشتیبانی‌شده، و نقاط موردعلاقه (POI) میزبان را نمایش دهد. برای مثال، مسیرهای رانندگی در پارکینگ‌های روباز برای بخش نهایی پیمایش، ساعات کاری، رده‌بندی‌ها. برای اطمینان از اینکه ایستگاه‌های شارژ با داده‌های Google مطابقت داشته باشند، از <brand name> خاصی استفاده کنید—برای مثال، ChargePoint.

پارامترها

پارامترهای زیر به شما امکان می‌دهند جزئیات مقصد نهایی و هر نقطه‌مسیر را مشخص کنید، ازجمله مواردی که به‌عنوان ایستگاه شارژ خودرو برقی تعیین شده‌اند.

مقصد نهایی

برای تنظیم ایستگاه شارژ به‌عنوان مقصد نهایی، از این عبارت استفاده کنید:

  • q: باید حاوی مقدار طول و عرض جغرافیایی ایستگاه شارژ باشد.
  • q_type: 1 مشخص می‌کند که مقصد نهایی ایستگاه شارژ است.
  • ‫q_name: نام مقصد نهایی. اگر q_type 1 باشد، الزامی است.
  • ‫q_power_output_kw: عدد اعشاری برای توان خروجی ایستگاه شارژ برحسب کیلووات. اختیاری.

نقطه‌مسیرها

برای نقاط‌مسیر، همه پارامترها آرایه‌های موازی و جداشده با خط عمودی (|) از مقادیر با همان ترتیب نقاط‌مسیر هستند، به‌جز مقصد نهایی. عدم تطابق در تعداد عناصر در آرایه‌های موازی به‌عنوان قصد بدشکل درنظر گرفته می‌شود.

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

  • waypoints: فهرست نقطه‌مسیرها همان‌طور که در هدف ناوبری گام‌به‌گام شرح داده شده است. باید مقدار طول و عرض جغرافیایی برای نقطه‌مسیرهای ایستگاه شارژ باشد.

  • waypoint_types: انواع هر نقطه‌مسیر که به‌صورت عدد مشخص شده است. ‫0 هر توقفی است (مقدار پیش‌فرض) و 1 ایستگاه شارژ است.

  • ‫waypoint_names: نام نقاط‌مسیر. این فیلد برای ایستگاه‌های شارژ الزامی است.

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

رفتار تجربه کاربری (UX)

برای مقصدهای سفر با چند مقصد، صفحه نمای کلی مسیر نمایش داده می‌شود، اما ناوبری به‌طور خودکار شروع نمی‌شود.

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

برای هر نقطه‌مسیر یا مقصد نهایی که به‌عنوان ایستگاه شارژ علامت‌گذاری شده باشد، Google Maps مکان منطبقی را در پایگاه داده Google جستجو خواهد کرد. برای اطمینان از اینکه بهترین اطلاعات ممکن برای ایستگاه‌های شارژ نمایش داده می‌شود:

  • اگر موردی منطبق پیدا شود، Google Maps از داده‌های Google برای نمایش ایستگاه شارژ در میانای کاربر (UI) و ارائه توصیه شارژ برای ایستگاه شارژ استفاده می‌کند.

  • اگر مطابقت پیدا نشود، از داده‌های ارائه‌شده در هدف برای ایستگاه شارژ (طول و عرض جغرافیایی، نام، و توان خروجی) برای نمایش این ایستگاه شارژ در میانای کاربر و ارائه توصیه شارژ در این ایستگاه شارژ استفاده می‌شود.

مثال‌ها

مثال‌های زیر نشان می‌دهند که چگونه می‌توان برای سناریوهای مختلف برنامه‌ریزی سفر با خودرو برقی، ازجمله پیمایش ازطریق چندین ایستگاه شارژ و مدیریت خروجی‌های برق ناشناخته، قصدها را ساخت.

پیمایش به مقصد نهایی ازطریق چند ایستگاه شارژ

هدف زیر با عبور از دو ایستگاه شارژ ChargePoint و Evie به مقصد نهایی، یعنی Port Macquarie NSW، می‌رود.

مقصدها به‌ترتیب:

  1. ایستگاه شارژ ChargePoint (مکان: -۳۲.۹۵۹۹۱۸۸، ۱۵۱.۶۲۴۰۸۰۶، توان خروجی: ۶.۶ کیلووات)

  2. ایستگاه شارژ Evie (مکان: -۳۱٫۹۴۳۲۵۳۹، ۱۵۲٫۴۶۹۹۸۰۸، توان خروجی: ۳۵۰ کیلووات)

  3. پورت مک‌کواری، نیو ساوت ولز

Uri mapIntentUri =
    Uri.parse(
        "google.navigation:q=Port+Macquarie+NSW"
            + "&waypoints=-32.9599188%2C151.6240806%7C-31.9432539%2C152.4699808"
            + "&waypoint_types=1%7C1"
            + "&waypoint_names=ChargePoint+Charging+Station%7CEvie+Charging+Station"
            + "&waypoint_power_outputs_kw=6.6%7C350");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

توان خروجی نامشخص

اگر مقدار توان خروجی مشخص نیست، جایگاه مربوطه را در waypoint_power_outputs_kw خالی بگذارید. یا اگر همه جایگاه‌ها خالی است، نیازی به مشخص کردن پارامتر waypoint_power_outputs_kw نیست.

مقصدها به‌ترتیب:

  1. ایستگاه شارژ ChargePoint (مکان: -۳۲.۹۵۹۹۱۸۸،۱۵۱.۶۲۴۰۸۰۶، توان خروجی: نامشخص)

  2. پورت مک‌کواری، نیو ساوت ولز

Uri mapIntentUri =
    Uri.parse(
        "google.navigation:q=Port+Macquarie+NSW"
            + "&waypoints=-32.9599188%2C151.6240806"
            + "&waypoint_types=1"
            + "&waypoint_names=ChargePoint+Charging+Station");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

علامت‌گذاری مقصد نهایی به‌عنوان ایستگاه شارژ

برای علامت‌گذاری مقصد نهایی به‌عنوان ایستگاه شارژ، پارامترهای q_type، q_name، و q_power_output_kw را مشخص کنید.

مقصدها به‌ترتیب:

  1. باغ‌وحش تارونگا، سیدنی استرالیا

  2. ایستگاه شارژ ChargePoint (مکان: -۳۲٫۹۵۹۹۱۸۸،۱۵۱٫۶۲۴۰۸۰۶، توان خروجی: نامشخص)

  3. ایستگاه شارژ Evie (مکان: -۳۱٫۹۴۳۲۵۳۹، ۱۵۲٫۴۶۹۹۸۰۸، خروجی برق: ۳۵۰ کیلووات)

Uri mapIntentUri =
    Uri.parse(
        "google.navigation:q=-31.9432539,152.4699808&q_type=1&q_name=Evie+Charging+Station&q_power_output_kw=350"
            + "&waypoints=Taronga+Zoo%2C+Sydney+Australia%7C-32.9599188%2C151.6240806"
            + "&waypoint_types=0%7C1"
            + "&waypoint_names=%7CChargePoint+Charging+Station"
            + "&waypoint_power_outputs_kw=%7C");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

قصد کنش

قصد کنش‌های زیر با رابط‌ها دردسترس است:

کنش شرح
geo.action:?act=mute همه راهنمای گفتاری پیمایش را صامت می‌کند.
geo.action:?act=unmute راهنمای گفتاری ناوبری را صدادار می‌کند.
geo.action:?act=show_traffic خطوط ترافیک را روی نقشه نشان می‌دهد.
geo.action:?act=hide_traffic خطوط ترافیک را در نقشه پنهان می‌کند.
geo.action:?act=show_satellite تصاویر ماهواره‌ای را روی نقشه نشان می‌دهد.
geo.action:?act=hide_satellite تصاویر ماهواره‌ای را در نقشه پنهان می‌کند.
geo.action:?act=show_alternates Google Maps صفحه مسیرهای جایگزین را باز می‌کند (فقط هنگام پیمایش کار می‌کند).
geo.action:?act=route_overview Google Maps صفحه نمای کلی مسیر را باز می‌کند (فقط هنگام ناوبری کار می‌کند).
geo.action:?act=query_next_turn ‫Google Maps پیچ بعدی را می‌گوید (فقط هنگام پیمایش کار می‌کند).
geo.action:?act=distance_to_next_turn Google Maps فاصله تا پیچ بعدی را می‌گوید (فقط هنگام پیمایش کار می‌کند).
geo.action:?act=time_to_next_turn Google Maps زمان رسیدن به پیچ بعدی را می‌گوید (فقط هنگام پیمایش کار می‌کند).
geo.action:?act=distance_to_destination Google Maps فاصله تا مقصد را می‌گوید (فقط هنگام پیمایش کار می‌کند).
geo.action:?act=go_back Google Maps به صفحه قبلی در واسط کاربر برمی‌گردد.
geo.action:?act=my_location Google Maps نقشه را روی مکان کاربر متمرکز می‌کند.
geo.action:?act=show_map Google Maps همه کارت‌های باز را می‌بندد و به نمای نقشه برمی‌گردد.
geo.action:?act=query_current_road Google Maps جاده فعلی را می‌گوید.
geo.action:?act=query_destination Google Maps مقصد را می‌گوید.
geo.action:?act=traffic_report Google Maps گزارش ترافیک را می‌خواند.
geo.action:?act=clear_search_results Google Maps صفحه نتایج جستجو را می‌بندد (اگر باز باشد).
geo.action:?act=open_destination_input Google Maps صفحه جستجوی ورودی مقصد را باز می‌کند.
geo.action:?act=apply_electric_vehicle_connector_filter فیلتر نوع رابط را برای نتایج جستجوی ایستگاه شارژ خودرو برقی اعمال می‌کند.
geo.action:?act=remove_electric_vehicle_connector_filter فیلتر نوع رابط را برای نتایج جستجوی ایستگاه شارژ خودرو برقی برمی‌دارد.
geo.action:?act=apply_electric_vehicle_payment_filter فیلتر پرداخت را برای نتایج جستجوی ایستگاه شارژ خودرو برقی اعمال می‌کند.
geo.action:?act=remove_electric_vehicle_payment_filter فیلتر پرداخت را برای نتایج جستجوی ایستگاه شارژ خودرو برقی برمی‌دارد.
geo.action:?act=apply_electric_vehicle_fast_charging_filter فیلتر شارژ سریع را برای نتایج جستجوی ایستگاه شارژ خودرو برقی اعمال می‌کند.
geo.action:?act=remove_electric_vehicle_fast_charging_filter فیلتر شارژ سریع را برای نتایج جستجوی ایستگاه شارژ خودرو برقی برمی‌دارد.
geo.action:?act=avoid_tolls اگر کاربر درحال ناوبری باشد، به Google Maps می‌گوید از مسیرهای دارای عوارض اجتناب کند. اگر مسیر فعلی عوارض داشته باشد، ممکن است این کار باعث تغییر مسیر شود.
geo.action:?act=allow_tolls اگر کاربر درحال ناوبری باشد، به Google Maps می‌گوید مسیرهای دارای عوارض را مجاز کند. اگر اجازه دادن به عوارض باعث شود مسیر بهتری دردسترس قرار گیرد، ممکن است این کار به تغییر مسیر منجر شود.
geo.action:?act=avoid_ferries اگر کاربر درحال ناوبری باشد، به Google Maps می‌گوید از مسیرهای دارای کشتی خودروبر اجتناب کند. اگر مسیر فعال فعلی دارای کشتی باشد، این کار ممکن است منجر به تغییر مسیر شود.
geo.action:?act=allow_ferries اگر کاربر درحال ناوبری باشد، به Google Maps می‌گوید مسیرهای دارای کشتی را مجاز کند. اگر اجازه دادن به کشتی‌های خودروبر باعث شود مسیر بهتری دردسترس قرار گیرد، ممکن است این کار به تغییر مسیر منجر شود.
geo.action:?act=avoid_highways اگر کاربر درحال ناوبری باشد، به Google Maps می‌گوید از مسیرهای دارای بزرگراه اجتناب کند. اگر مسیر فعال فعلی بزرگراه داشته باشد، این کار ممکن است به تغییر مسیر منجر شود.
geo.action:?act=allow_highways اگر کاربر درحال ناوبری باشد، به Google Maps می‌گوید مسیرهای دارای بزرگراه را مجاز کند. اگر اجازه دادن به بزرگراه‌ها باعث شود مسیر بهتری دردسترس قرار گیرد، ممکن است این کار به تغییر مسیر منجر شود.
geo.action:?act=eta اگر کاربر درحال پیمایش باشد، Google Maps زمان برآوردی ورود به مقصد را می‌گوید (برای مثال، ۹:۱۵ صبح).
geo.action:?act=time_to_destination اگر کاربر درحال پیمایش باشد، Google Maps زمان موردانتظار برای رسیدن به مقصد را می‌گوید (برای مثال، ۱۵ دقیقه).
geo.action:?act=exit_navigation از ناوبری خارج می‌شود.
geo.action:?act=select_search_result&id=0 اگر نتایج جستجو روی صفحه‌نمایش نشان داده شود (همان‌طور که در تصویر همراه نشان داده شده است)، این کنش پیمایش به نتیجه n را براساس پارامتر شناسه ارائه‌شده شروع می‌کند. توجه داشته باشید که نمایه مبتنی بر ۰ است (یعنی geo.action:?act=select_search_result&id=0 اولین نتیجه را در فهرست انتخاب می‌کند).

نتایج جستجو
    روی صفحه‌نمایش نشان داده می‌شود