Google Maps Intent สำหรับ Android

แอป Google Maps สำหรับ Android มีความต้องการหลายอย่างที่คุณสามารถใช้เพื่อเปิด Google Maps ในโหมดดิสเพลย์ การค้นหา การนำทาง หรือ Street View หากคุณต้องการฝังแผนที่ในแอป โปรดดูคู่มือเริ่มต้นใช้งาน Google Maps API สำหรับ Android

ภาพรวม

Intent ช่วยให้คุณสามารถเริ่มกิจกรรมในแอปอื่นด้วยการอธิบายการทำงานง่ายๆ ที่คุณต้องการ (เช่น "แสดงแผนที่" หรือ "แสดงเส้นทางไปยังสนามบิน") ในออบเจ็กต์ Intent แอป Google Maps สำหรับ Android สนับสนุน Intent ต่างๆ หลายรายการ ซึ่งช่วยให้คุณเปิดแอป Google Maps และดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้

  1. แสดงแผนที่ในตำแหน่งและระดับการซูมที่ระบุ
  2. ค้นหาสถานที่หรือสถานที่ และแสดงบนแผนที่
  3. ขอเส้นทางจากสถานที่หนึ่งไปยังอีกสถานที่หนึ่ง โดยสามารถส่งคืนเส้นทางได้ 3 รูปแบบด้วยกัน ได้แก่ การขับรถ การเดิน การปั่นจักรยาน
  4. แสดงภาพพาโนรามาใน Google Street View

หน้านี้จะอธิบายถึง Intent ที่คุณสามารถใช้กับแอป Google Maps สำหรับ Android ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวกรอง Intent และ Intent หรือ Intent ทั่วไปในแพลตฟอร์ม Android ได้ในเอกสารประกอบสำหรับนักพัฒนาแอป Android

คำขอ Intent

ในการเปิดใช้งาน Google Maps ด้วยความตั้งใจ ก่อนอื่นคุณต้องสร้างออบเจ็กต์ Intent โดยระบุการดำเนินการ, URI และแพ็กเกจ

  • การดำเนินการ: Intent ทั้งหมดของ Google Maps จะเรียกว่า "ดู" — ACTION_VIEW
  • URI: Intent ของ Google Maps ใช้เข้ารหัส URL ซึ่งระบุการดำเนินการที่ต้องการ พร้อมด้วยข้อมูลบางอย่างที่จะใช้ดำเนินการ
  • แพ็กเกจ: การโทรไปที่ setPackage("com.google.android.apps.maps") จะช่วยให้ แอป Google Maps สำหรับ Android จัดการกับ Intent หากไม่ได้ตั้งค่าแพ็กเกจ ระบบจะกำหนดแอปที่สามารถจัดการ Intent ได้ หากมีหลายแอป ระบบอาจถามผู้ใช้ว่าต้องการใช้แอปใด

หลังจากสร้าง Intent คุณขอให้ระบบเปิดแอปที่เกี่ยวข้องได้หลายวิธี วิธีที่ใช้กันโดยทั่วไปคือการส่ง Intent ไปยังเมธอด startActivity() ระบบจะเปิดแอปที่จำเป็น ซึ่งในกรณีนี้คือ Google Maps แล้วเริ่มใช้Activityที่เกี่ยวข้อง

Java

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

Kotlin

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

หากระบบระบุแอปที่ตอบสนองต่อความตั้งใจไม่ได้ แอปของคุณอาจขัดข้อง ด้วยเหตุนี้ คุณจึงควรตรวจสอบก่อนว่าได้ติดตั้งแอปพลิเคชันฝั่งผู้รับแล้วก่อนที่จะแสดง Intent เหล่านี้ให้กับผู้ใช้

หากต้องการยืนยันว่าแอปพร้อมสำหรับการรับ Intent อยู่ ให้เรียกใช้ resolveActivity() ที่ออบเจ็กต์ Intent หากผลลัพธ์ไม่ใช่ null จะมีแอปอย่างน้อย 1 แอปที่จัดการ Intent ได้และเรียกใช้ startActivity() ได้อย่างปลอดภัย หากผลลัพธ์คือ null คุณไม่ควรใช้ Intent และหากเป็นไปได้ คุณควรปิดใช้ฟีเจอร์ที่เรียกใช้ Intent

Java

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

Kotlin

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

ตัวอย่างเช่น หากต้องการแสดงแผนที่ของซานฟรานซิสโก คุณสามารถใช้รหัสต่อไปนี้:

Java

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

Kotlin

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

สตริงการค้นหาที่เข้ารหัส URL

สตริงทั้งหมดที่ส่งไปยัง Intent ของ Google Maps จะต้องเข้ารหัส URI เช่น สตริง "1st & Pike, Seattle" ควรเปลี่ยนเป็น 1st%20%26%20Pike%2C%20Seattle คุณสามารถเข้ารหัสช่องว่างในสตริงด้วย %20 หรือแทนที่ด้วยเครื่องหมายบวก (+)

คุณใช้เมธอด android.net.Uri parse() เพื่อเข้ารหัสสตริงได้ เช่น

Java

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

Kotlin

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

การแสดงแผนที่

ใช้ Intent geo: เพื่อแสดงแผนที่ในตำแหน่งและระดับการซูมที่ระบุ

geo:latitude,longitude?z=zoom

พารามิเตอร์

  • latitude และ longitude กำหนดจุดศูนย์กลางของแผนที่
  • z (ไม่บังคับ) ตั้งค่าระดับการซูมเริ่มต้นของแผนที่ ค่าที่ระบบยอมรับมีตั้งแต่ 0 (ทั้งโลก) จนถึง 21 (อาคารเดียว) ขีดจำกัดสูงสุดอาจแตกต่างกันไปโดยขึ้นอยู่กับข้อมูลแผนที่ที่มีอยู่ในตำแหน่งที่เลือก

ตัวอย่าง

Java

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

Kotlin

// Creates an Intent that will load 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)

การค้นหาตำแหน่ง

ใช้ Intent นี้เพื่อแสดงคำค้นหาภายในวิวพอร์ตที่ระบุ เมื่อคำค้นหามีผลรายการเดียว คุณสามารถใช้ Intent นี้เพื่อแสดงหมุด ณ สถานที่หรือที่อยู่ที่เจาะจง เช่น จุดสังเกต ธุรกิจ สถานที่ทางภูมิศาสตร์ หรือเมือง

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

พารามิเตอร์

นอกจากพารามิเตอร์ที่ใช้เพื่อแสดงแผนที่แล้ว Search ยังรองรับพารามิเตอร์ต่อไปนี้ด้วย

  • q กำหนดสถานที่ที่จะไฮไลต์บนแผนที่ คุณต้องระบุพารามิเตอร์ q สำหรับคำขอการค้นหาทั้งหมด ยอมรับสถานที่ตั้งเพื่อใช้เป็นชื่อหรือที่อยู่ของสถานที่ สตริงควรเข้ารหัส URL ดังนั้นที่อยู่ เช่น "City Hall, New York, NY" ควรแปลงเป็น City+Hall,New+York,NY

  • label ให้คุณตั้งค่าป้ายกำกับที่กำหนดเองสถานที่ที่ระบุบนแผนที่ ต้องระบุ label เป็นสตริง

หากคุณผ่านข้อความค้นหาทั่วไป Google แผนที่จะพยายามหาสถานที่ตั้งที่อยู่ใกล้กับละติจูด/ลองจิจูดที่คุณระบุที่ตรงกับเกณฑ์ของคุณ หากไม่ได้ระบุตำแหน่งใดๆ Google แผนที่จะพยายามค้นหารายชื่อที่อยู่ใกล้เคียง เช่น

Java

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

Kotlin

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

กำลังค้นหาร้านอาหารในซานฟรานซิสโก

คุณอาจให้น้ำหนักพิเศษกับผลการค้นหาได้โดยการระบุพารามิเตอร์การซูมพร้อมกับสตริงคำค้นหา ในตัวอย่างด้านล่าง การเพิ่มการซูม 10 เป็นการค้นหาร้านอาหาร ในระดับเมือง แทนที่จะเป็นสถานที่ใกล้เคียง

Java

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

Kotlin

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)

การค้นหาที่อยู่ที่เจาะจงจะแสดงหมุดที่ตำแหน่งนั้น

Java

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

Kotlin

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 แต่ส่งผ่านที่อยู่เป็นสตริงการค้นหา เมื่อค้นหาสถานที่ที่เฉพาะเจาะจงมาก คุณไม่จำเป็นต้องใช้ละติจูดและลองจิจูด อย่างไรก็ตาม หากคุณไม่ทราบที่อยู่ที่แน่ชัด คุณอาจ พยายามให้น้ำหนักกับผลการค้นหาด้วยการระบุพิกัด เช่น การค้นหาที่อยู่โดยใช้คำว่า "ถนนหลัก" จะให้ผลการค้นหามากเกินไป

Java

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

Kotlin

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

การเพิ่มละติจูด/ลองจิจูดลงใน URI ของ Intent จะให้น้ำหนักพิเศษกับผลลัพธ์ไปยังพื้นที่เฉพาะ ดังนี้

Java

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

Kotlin

// 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 เป็นพิกัดละติจูด/ลองจิจูดเท่านั้น

Java

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

Kotlin

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

นอกจากนี้ คุณยังแสดงหมุดในตำแหน่งที่ทราบโดยใช้Plus Code แทนที่อยู่หรือละติจูด/ลองจิจูดได้

Java

// 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 examples above

Kotlin

// 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 examples above

กำลังเปิดการนำทางแบบเลี้ยวต่อเลี้ยว

ใช้เจตนานี้เพื่อเปิดการนำทางของ Google แผนที่พร้อมเส้นทางแบบเลี้ยวต่อเลี้ยวไปยังที่อยู่หรือพิกัดที่ระบุไว้ เส้นทางจะแสดงจากตำแหน่งปัจจุบันของผู้ใช้เสมอ

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

พารามิเตอร์

  • q: ตั้งค่าจุดสิ้นสุดสำหรับการค้นหาด้วยการนำทาง ค่านี้อาจเป็นพิกัดละติจูด ลองจิจูด หรือที่อยู่ที่มีการจัดรูปแบบการค้นหา หากเป็นสตริงการค้นหาที่แสดงผลลัพธ์มากกว่า 1 รายการ ระบบจะเลือกผลลัพธ์แรก

  • mode กำหนดวิธีการเดินทาง โหมดเป็นตัวเลือกที่ไม่บังคับ และสามารถกำหนดเป็นโหมดใดโหมดหนึ่งต่อไปนี้

    • d สำหรับการขับรถ (ค่าเริ่มต้น)
    • b สำหรับการปั่นจักรยาน
    • l สำหรับมอเตอร์ไซค์
    • w สำหรับการเดิน
  • avoid กำหนดสถานที่ที่เส้นทางควรหลีกเลี่ยง การหลีกเลี่ยงเป็นตัวเลือกที่ไม่บังคับ และสามารถกำหนดอย่างใดอย่างหนึ่งต่อไปนี้

    • t สำหรับค่าผ่านทาง
    • h สำหรับทางหลวง
    • fสำหรับเรือข้ามฟาก

ตัวอย่าง

Intent ด้านล่างนี้จะขอการนำทางแบบเลี้ยวต่อเลี้ยวไปยังสวนสัตว์ทารองก้า ในซิดนีย์ออสเตรเลีย

Java

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

Kotlin

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)

เส้นทางไปสวนสัตว์ Taronga Zoo

หากคุณไม่ต้องการจ่ายค่าผ่านทางหรือนั่งเรือข้ามฟาก คุณสามารถขอกำหนดเส้นทางที่จะหลีกเลี่ยงสิ่งเหล่านั้น

Java

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

Kotlin

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)

หากต้องการออกกำลังกายเล็กน้อย คุณสามารถขอเส้นทางจักรยานแทนได้

Java

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

Kotlin

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)

หากต้องการใช้มอเตอร์ไซค์ 2 ล้อ คุณก็ขอให้เส้นทางมีถนนแคบๆ และทางเดินที่รถยนต์เข้าไม่ได้ intent ด้านล่างแสดงเส้นทางในอินเดีย

Java

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

Kotlin

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)

การแสดงภาพพาโนรามาของ Street View

ใช้ Intent google.streetview เพื่อเปิด Google Street View ในพื้นที่ที่ครอบคลุม Google Street View จะแสดงทัศนียภาพแบบพาโนรามาจากตำแหน่งที่กำหนดไว้ นอกจากนี้ยังมีภาพ 360 องศาที่ผู้ใช้ส่งมาและคอลเล็กชันพิเศษของ Street View

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

พารามิเตอร์

URI google.streetview ทั้งหมดต้องมีพารามิเตอร์ cbll หรือ panoid

  • cbll ยอมรับละติจูดและลองจิจูดเป็นค่าที่คั่นด้วยเครื่องหมายจุลภาค (46.414382,10.013988) แอปจะแสดงภาพพาโนรามาที่ถ่ายไว้ใกล้กับตำแหน่งนี้มากที่สุด เนื่องจากภาพ Street View มีการรีเฟรชเป็นระยะๆ และภาพถ่ายอาจถ่ายจากตำแหน่งที่แตกต่างกันเล็กน้อยในแต่ละครั้ง จึงอาจเป็นไปได้ว่าตำแหน่งของคุณอาจสแนปไปยังภาพพาโนรามาที่แตกต่างกันเมื่อมีการอัปเดตภาพ

  • panoid คือรหัสพาโนรามาที่เฉพาะเจาะจง Google Maps จะใช้รหัสพาโนรามาหากระบุทั้ง panoid และ cbll รหัสพาโนรามาใช้ได้ในแอป Android จากออบเจ็กต์ StreetViewPanoramaLocation

  • cbp เป็นพารามิเตอร์ที่ไม่บังคับซึ่งปรับการวางแนวเริ่มต้นของกล้อง พารามิเตอร์ cbp ใช้ค่าที่คั่นด้วยคอมมา 5 ค่า ซึ่งทั้งหมดนี้จะไม่บังคับ ค่าที่สำคัญที่สุดคือค่าที่สอง สี่ และห้า ซึ่งจะกำหนดทิศทาง การซูม และการเอียงตามลำดับ ระบบไม่รองรับค่าที่ 1 และ 3 และควรตั้งค่าเป็น 0

    • bearing: บอกทิศทางเข็มทิศของกล้องตามเข็มนาฬิกาจากทิศเหนือ ทิศเหนือจริงคือ 0 ทิศตะวันออกคือ 90 ทิศใต้คือ 180 ทิศตะวันตกคือ 270 ค่าที่ส่งไปยังทิศทางว่าจะตัดค่า ซึ่งก็คือ 0°, 360° และ 720° ในทิศทางเดียวกัน แบริ่งหมายถึงค่าที่คั่นด้วยคอมมา ซึ่งมาจาก 5 ค่า
    • zoom: ตั้งค่าระดับการซูมของกล้อง ระดับการซูมเริ่มต้นตั้งไว้ที่ 0 การซูม 1 จะเพิ่มการขยายเป็น 2 เท่า การซูมจะอยู่ระหว่าง 0 ถึงระดับการซูมสูงสุดสำหรับภาพพาโนรามาปัจจุบัน ซึ่งหมายความว่าค่าใดๆ ที่อยู่นอกช่วงนี้จะได้รับการตั้งค่าเป็นจุดสูงสุดที่อยู่ในช่วง เช่น ค่า -1 จะถูกตั้งค่าเป็น 0 Zoom เป็นค่าที่สี่จากค่าที่คั่นด้วยเครื่องหมายจุลภาคจำนวน 5 ค่า
    • tilt: ระบุมุมขึ้นหรือลงของกล้อง โดยมีช่วงอยู่ที่ -90 ถึง 0 ถึง 90 โดย 90 มองลงแบบตรง 0 อยู่กึ่งกลางขอบฟ้า และ -90 มองตรง

ตัวอย่าง

ด้านล่างคือตัวอย่างการใช้ Intent ของ Street View

Java

// 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 will angle 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);

Kotlin

// 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 will angle 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)

พีระมิดใน Street View