اهداف Google Maps برای Android

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

برای پلاتفرم‌های «سیستم عامل Android Automotive» (AAOS)، ملاحظات خاصی وجود دارد و هدف‌های اضافی دردسترس است. برای جزئیات بیشتر، به مستندات اهداف Google Maps ویژه Android Automotive مراجعه کنید.

نمای کلی

قصدها به شما امکان می‌دهند با توصیف کنشی که می‌خواهید انجام دهید (مثل «نمایش نقشه» یا «نمایش مسیرهای فرودگاه») در یک شیء Intent، فعالیتی را در برنامه دیگری شروع کنید. برنامه Google Maps برای Android از چندین هدف مختلف پشتیبانی می‌کند و به شما امکان می‌دهد برنامه Google Maps را راه‌اندازی کنید و یکی از چهار کنش زیر را انجام دهید:

  1. نقشه‌ای را در مکان و سطح بزرگ‌نمایی مشخصی نمایش می‌دهد.
  2. مکان‌ها یا جاها را جستجو کنید و آن‌ها را در نقشه نمایش دهید.
  3. درخواست مسیر از یک مکان به مکان دیگر. مسیرها را می‌توان برای سه روش حمل‌ونقل برگرداند: رانندگی، پیاده‌روی، دوچرخه‌سواری.
  4. نمایش تصاویر تمام‌نما در «نمای خیابان Google».

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

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

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

  • کنش: همه هدف‌های Google Maps به‌عنوان کنش «مشاهده» فراخوانده می‌شوند — ACTION_VIEW.
  • نشانی وب: هدف‌های Google Maps از نشانی‌های وب کدبندی‌شده با نشانی وب استفاده می‌کنند که کنش انتخابی را به‌همراه برخی داده‌ها برای انجام کنش مشخص می‌کنند.
  • بسته: Calling 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 gmmIntentUri = Uri.parse("google.streetview:cbll=46.414382,10.013988");
// Create an Intent from gmmIntentUri. Set the action to ACTION_VIEW
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
// 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);

کاتلین

// Create a Uri from an intent string. Use the result to create an Intent.
val gmmIntentUri = Uri.parse("google.streetview:cbll=46.414382,10.013988")
// Create an Intent from gmmIntentUri. Set the action to ACTION_VIEW
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
// 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)

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

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

جاوا

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

کاتلین

mapIntent.resolveActivity(packageManager)?.let {
    ...
}

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

جاوا

Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
if (mapIntent.resolveActivity(getPackageManager()) != null) {
    startActivity(mapIntent);
}

کاتلین

val gmmIntentUri = Uri.parse("geo:37.7749,-122.4194")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
mapIntent.resolveActivity(packageManager)?.let {
    startActivity(mapIntent)
}

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

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

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

جاوا

Uri gmmIntentUri =
    Uri.parse("geo:37.7749,-122.4192?q=" + Uri.encode("1st & Pike, Seattle"));

کاتلین

val gmmIntentUri =
    Uri.parse("geo:37.7749,-122.4192?q=" + Uri.encode("1st & Pike, Seattle"))

نمایش نقشه

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

geo:latitude,longitude?z=zoom

پارامترها

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

نمونه‌ها

جاوا

// Creates an Intent that loads 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);

کاتلین

// Creates an Intent that loads a map of San Francisco
val gmmIntentUri = Uri.parse("geo:37.7749,-122.4194")
val mapIntent = 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
geo:0,0?q=latitude,longitude(label)

پارامترها

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

  • ‫q مکان(های) موردنظر برای برجسته شدن در نقشه را تعریف می‌کند. پارامتر q برای همه درخواست‌های «جستجو» الزامی است. مکان را به‌صورت نام مکان یا نشانی می‌پذیرد. رشته باید کدبندی نشانی وب شود، بنابراین نشانی‌ای مثل City Hall, New York, NY باید به City+Hall,New+York,NY تبدیل شود.

  • ‫label به شما امکان می‌دهد برچسب سفارشی را در مکانی که روی نقشه شناسایی شده است تنظیم کنید. ‫label باید به‌عنوان «رشته» مشخص شود.

اگر عبارت جستجوی کلی را ارسال کنید، Google Maps تلاش می‌کند مکانی را در نزدیکی عرض و طول جغرافیایی که مشخص کرده‌اید پیدا کند که با معیارهای شما مطابقت داشته باشد. اگر مکانی مشخص نشده باشد، 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);
// Search for restaurants in San Francisco.
Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?q=restaurants");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

کاتلین

// Search for restaurants nearby.
val gmmIntentUri = Uri.parse("geo:0,0?q=restaurants")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)
// Search for restaurants in San Francisco.
val gmmIntentUri =
    Uri.parse("geo:37.7749,-122.4194?q=restaurants")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)
درحال جستجوی
  رستوران‌ها در سانفرانسیسکو
شکل ۱. درحال جستجوی رستوران‌ها در سانفرانسیسکو

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

جاوا

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);

کاتلین

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

جستجوی نشانی خاصی سنجاقی را در آن مکان نمایش می‌دهد.

جاوا

Uri gmmIntentUri = Uri.parse("geo:0,0?q=1600 Amphitheatre Parkway, Mountain+View, California");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

کاتلین

val gmmIntentUri =
    Uri.parse("geo:0,0?q=1600 Amphitheatre Parkway, Mountain+View, California")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)

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

جاوا

// Searching for 'Main Street' returns too many results.
Uri gmmIntentUri = Uri.parse("geo:0,0?q=101+main+street");

کاتلین

// Searching for 'Main Street' returns too many results.
val gmmIntentUri = Uri.parse("geo:0,0?q=101+main+street")

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

جاوا

// Searches for '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);

کاتلین

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

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

جاوا

// Display a label at the location of Google's Sydney office.
Uri gmmIntentUri = Uri.parse("geo:0,0?q=-33.8666,151.1957(Google+Sydney)");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

کاتلین

// Display a label at the location of Google's Sydney office.
val gmmIntentUri =
    Uri.parse("geo:0,0?q=-33.8666,151.1957(Google+Sydney)")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)

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

جاوا

// Display the location of Google, San Francisco using a global plus code.
Uri gmmIntentUri = Uri.parse("http://plus.codes/849VQJQ5+XX");
// Equivalently, define the same location using a local plus code.
gmmIntentUri = Uri.parse("https://plus.codes/QJQ5+XX,San%20Francisco");
// Construct and use the Intent as in the preceding examples.

کاتلین

// Display the location of Google, San Francisco using a global plus code.
var gmmIntentUri = Uri.parse("http://plus.codes/849VQJQ5+XX")
// Equivalently, define the same location using a local plus code.
gmmIntentUri = Uri.parse("https://plus.codes/QJQ5+XX,San%20Francisco")
// Construct and use the Intent as in the preceding examples.

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

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

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

پارامترها

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

  • ‫mode روش حمل‌ونقل را تعیین می‌کند. ‫mode اختیاری است و می‌تواند روی یکی از موارد زیر تنظیم شود:

    • ‫d برای رانندگی (پیش‌فرض)
    • ‫b برای دوچرخه‌سواری
    • ‫l برای موتورسیکلت
    • ‫w برای پیاده‌روی
  • avoid ویژگی‌هایی را تنظیم می‌کند که مسیر باید سعی کند از آن‌ها اجتناب کند. ‫avoid اختیاری است و می‌تواند روی یک یا چند مورد از موارد زیر تنظیم شود:

    • ‫t برای عوارضی
    • ‫h برای بزرگراه‌ها
    • ‫f برای کشتی

نمونه‌ها

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

جاوا

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

کاتلین

val gmmIntentUri =
    Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)
مسیرها
  به باغ‌وحش تارونگا
شکل ۲. مسیرها به باغ‌وحش تارونگا

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

جاوا

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

کاتلین

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

اگر ترجیح می‌دهید کمی ورزش کنید، می‌توانید درعوض درخواست مسیر دوچرخه‌سواری کنید.

جاوا

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

کاتلین

val gmmIntentUri =
    Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&mode=b")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)

اگر ترجیح می‌دهید از موتورسیکلت استفاده کنید، می‌توانید درخواست کنید که مسیرها شامل جاده‌های باریک و مسیرهای غیرقابل‌دسترس برای خودروها باشد. دستور زیر intent مسیری در هند برمی‌گرداند.

جاوا

Uri gmmIntentUri = Uri.parse("google.navigation:q=Connaught+Place,+New+Delhi,Delhi&mode=l");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

کاتلین

val gmmIntentUri =
    Uri.parse("google.navigation:q=Connaught+Place,+New+Delhi,Delhi&mode=l")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)

نمایش تمام‌نمای «نمای خیابان»

برای راه‌اندازی «نمای خیابان Google»، از هدف google.streetview استفاده کنید. «نمای خیابان Google» نماهای تمام‌نمایی از مکان‌های تعیین‌شده در سراسر منطقه تحت پوشش خود ارائه می‌دهد. کره‌های عکس همیاری‌شده کاربر و مجموعه‌های ویژه «نمای خیابان» نیز دردسترس هستند.

google.streetview:cbll=latitude,longitude&cbp=0,bearing,0,zoom,tilt
google.streetview:panoid=id&cbp=0,bearing,0,zoom,tilt

پارامترها

همه نشانی‌های وب google.streetview باید شامل پارامتر cbll یا panoid باشد:

  • cbll عرض جغرافیایی و طول جغرافیایی را به‌عنوان مقادیر جداشده با کاما می‌پذیرد (46.414382,10.013988). برنامه تمام‌نمایی را که به این مکان نزدیک‌تر است نشان می‌دهد. ازآنجایی‌که تصاویر «نمای خیابان» به‌طور دوره‌ای بازآوری می‌شود و ممکن است عکس‌ها هر بار از موقعیت‌های کمی متفاوت گرفته شوند، ممکن است وقتی تصاویر به‌روزرسانی می‌شود، مکان شما به پانورامای دیگری منتقل شود.

  • panoid شناسه تمام‌نمای خاصی است. اگر هم panoid و هم cbll مشخص شده باشد، Google Maps از شناسه پانوراما استفاده می‌کند. شناسه‌های پانوراما برای برنامه Android از شیء StreetViewPanoramaLocation دردسترس است.

  • cbp یک پارامتر اختیاری است که جهت اولیه دوربین را تنظیم می‌کند. پارامتر cbp ۵ مقدار جداشده با کاما می‌گیرد که همه آن‌ها اختیاری هستند. مهم‌ترین مقادیر، مقادیر دوم، چهارم، و پنجم هستند که به‌ترتیب جهت، بزرگ‌نمایی، و کجی را تنظیم می‌کنند. از مقادیر اول و سوم پشتیبانی نمی‌شود و باید روی 0 تنظیم شود.

    • bearing: جهت قطب‌نمای دوربین را برحسب درجه در جهت عقربه‌های ساعت از شمال نشان می‌دهد. شمال واقعی ۰، شرق ۹۰، جنوب ۱۸۰، غرب
      1. مقادیر منتقل‌شده به پوشش‌های جهت؛ یعنی ۰°، ۳۶۰°، و ۷۲۰° همه به یک جهت اشاره می‌کنند. زاویه انحراف به‌عنوان دومین از پنج مقدار جداشده با کاما تعریف می‌شود.
    • zoom: سطح بزرگ‌نمایی دوربین را تنظیم می‌کند. سطح بزرگ‌نمایی پیش‌فرض روی ۰ تنظیم شده است. زوم ۱ درشت‌نمایی را دوبرابر می‌کند. بزرگ‌نمایی بین ۰ و حداکثر سطح بزرگ‌نمایی برای پانورامای کنونی محدود شده است. این یعنی هر مقداری که خارج از این محدوده باشد به نزدیک‌ترین مقدار افراطی که در محدوده قرار دارد تنظیم می‌شود. برای مثال، مقدار -۱ به ۰ تنظیم می‌شود. «بزرگ‌نمایی» چهارمین مقدار از پنج مقدار جداشده با کاما است.
    • tilt: زاویه دوربین را به‌سمت بالا یا پایین مشخص می‌کند. محدوده از -۹۰ تا ۰ تا ۹۰ است، با ۹۰ که مستقیماً به پایین نگاه می‌کند، ۰ که در مرکز افق قرار دارد، و -۹۰ که مستقیماً به بالا نگاه می‌کند.

نمونه‌ها

در زیر چند نمونه از استفاده از هدف «نمای خیابان» آورده شده است.

جاوا

// Displays an image of the Swiss Alps.
Uri gmmIntentUri = Uri.parse("google.streetview:cbll=46.414382,10.013988");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);
// Uses a PanoID to show an image from Maroubra beach in Sydney, Australia.
Uri gmmIntentUri = Uri.parse("google.streetview:panoid=Iaa2JyfIggYAAAQfCZU9KQ");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);
// Opens Street View between two Pyramids in Giza. The values passed to the
// cbp parameter angles the camera slightly up, and towards the east.
Uri gmmIntentUri = Uri.parse("google.streetview:cbll=29.9774614,31.1329645&cbp=0,30,0,0,-15");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

کاتلین

// Displays an image of the Swiss Alps.
val gmmIntentUri =
    Uri.parse("google.streetview:cbll=46.414382,10.013988")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)
// Uses a PanoID to show an image from Maroubra beach in Sydney, Australia.
val gmmIntentUri =
    Uri.parse("google.streetview:panoid=Iaa2JyfIggYAAAQfCZU9KQ")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)
// Opens Street View between two Pyramids in Giza. The values passed to the
// cbp parameter angles the camera slightly up, and towards the east.
val gmmIntentUri =
    Uri.parse("google.streetview:cbll=29.9774614,31.1329645&cbp=0,30,0,0,-15")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)
اهرام در «نمای خیابان»
شکل ۳. اهرام در «نمای خیابان»