Google Maps สําหรับ Android Automotive Intent

คุณสามารถเปิดการนำทางใน Google Maps สำหรับ Android Automotive ผ่าน Intent ของ Android ได้

ภาพรวม

หน้านี้อธิบาย Intent ที่คุณใช้กับ Google Maps สำหรับ Android Automotive ได้ ดูเอกสารประกอบสำหรับนักพัฒนาแอป Android โดยละเอียดได้ที่หัวข้อต่อไปนี้

คำขอ Intent

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

  • การดำเนินการ ระบบจะเรียกใช้ Intent ของ Google Maps ทั้งหมดเป็นการดำเนินการ View ACTION_VIEW

  • URI Intent ของ Google Maps ใช้สตริงที่เข้ารหัส URI ซึ่งระบุการดำเนินการที่เลือก พร้อมกับข้อมูลบางอย่างที่จะใช้ดำเนินการ

  • แพ็กเกจ การเรียกใช้ setPackage("com.google.android.apps.maps") จะช่วยให้มั่นใจว่าแอป Google Maps สำหรับ Android จะจัดการ Intent หากไม่ได้ตั้งค่าแพ็กเกจ ระบบจะกำหนดว่าแอปใดสามารถจัดการ 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 ได้ แอปของคุณอาจขัดข้อง ด้วยเหตุนี้ ให้ตรวจสอบก่อนว่ามีการติดตั้งแอปพลิเคชันที่รับข้อมูลแล้วก่อนที่จะแสดง Intent เหล่านี้ต่อผู้ใช้

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

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

เช่น หากต้องการเปิดการนำทางแบบเลี้ยวต่อเลี้ยวไปยังสวนสัตว์ Taronga ในซิดนีย์ คุณสามารถใช้โค้ดต่อไปนี้

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

สตริงทั้งหมดที่ส่งไปยัง Intent ของ 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"));

แสดงแผนที่

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

geo:latitude,longitude?z=zoom

พารามิเตอร์

  • latitude และ longitude จะกำหนดจุดศูนย์กลางของแผนที่

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

ตัวอย่าง

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

ค้นหาสถานที่

ใช้ Intent นี้เพื่อแสดงคำค้นหาภายในวิวพอร์ตที่ระบุ

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

พารามิเตอร์

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

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

กำหนดผลการค้นหาด้วยพิกัด

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

// 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 ของ Intent จะทำให้ผลลัพธ์เอนเอียงไปยังพื้นที่หนึ่งๆ ดังนี้

// 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 ในรถยนต์รองรับ Intent ที่แสดงหมวดหมู่ที่กำหนดไว้ล่วงหน้าต่อไปนี้เพื่อรองรับการผสานรวมกับรถยนต์

หมวดหมู่ การเข้ารหัสหมวดหมู่ความตั้งใจ
ปั๊มน้ำมัน gas_station
ร้านอาหาร restaurant
ร้านกาแฟ cafe
ที่จอดรถ parking
สถานีชาร์จรถยนต์ไฟฟ้า electric_vehicle_charging_station

Intent ของหมวดหมู่อยู่ในรูปแบบ 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 จะค้นหารายชื่อธุรกิจที่ตรงกับเกณฑ์ หากมีการระบุละติจูดและลองจิจูดที่เฉพาะเจาะจงใน Intent 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

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

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

พารามิเตอร์

หากต้องการเปิดการนำทาง ให้ใช้ place หรือ q ร่วมกับ waypoints (ไม่บังคับ) หากต้องการทำเครื่องหมายจุดอ้างอิงเป็นสถานีชาร์จ (ไม่บังคับ) โปรดดูหัวข้อส่งแผนการเดินทางด้วยรถยนต์ไฟฟ้าไปยัง Google Maps

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

  • place ตั้งค่าจุดสิ้นสุดเป็นบ้านหรือที่ทำงาน ระบุ "บ้าน" เพื่อนำทางไปยังบ้านของผู้ใช้ และ "ที่ทำงาน" เพื่อนำทางไปยังที่ทำงานของผู้ใช้

  • avoid กำหนดลักษณะที่เส้นทางควรพยายามหลีกเลี่ยง avoid เป็นค่าที่ไม่บังคับและสามารถตั้งค่าเป็นค่าใดค่าหนึ่งหรือหลายค่าต่อไปนี้

    • t สำหรับค่าผ่านทาง
    • h สำหรับทางหลวง
    • f สำหรับเรือเฟอร์รี
  • waypoints ระบุสถานที่ขั้นกลางอย่างน้อย 1 แห่งเพื่อกำหนดเส้นทางไปยังจุดหมายสุดท้ายที่ระบุโดย q คุณระบุจุดอ้างอิงหลายจุดได้โดยใช้อักขระไปป์ (|) เพื่อแยกสถานที่ เช่น Berlin,Germany|Paris,France คุณใช้จุดอ้างอิงได้มากเท่าที่ต้องการ ระบบจะเพิ่มจุดอ้างอิงลงในเส้นทางตามลำดับเดียวกับที่แสดงใน URL จุดอ้างอิงแต่ละจุดอาจเป็นที่อยู่หรือพิกัดละติจูดและลองจิจูดที่คั่นด้วยคอมมา และคุณสามารถมีที่อยู่และพิกัดละติจูดและลองจิจูดใน Intent เดียวกันได้ สตริงควรเป็น URL-escaped ดังนั้นจุดอ้างอิง เช่น "Berlin,Germany|Paris,France" ควรแปลงเป็น Berlin%2CGermany%7CParis%2CFrance

ตัวอย่าง

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

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

หากต้องการเปิดการนำทางแบบเลี้ยวต่อเลี้ยวไปยังที่อยู่ 3 แห่งต่อไปนี้ตามลำดับ ให้ส่ง Taronga Zoo เป็นจุดหมายสุดท้าย q และ Google Sydney กับ Sydney Opera House เป็นจุดอ้างอิง

  1. Google ซิดนีย์

  2. โรงอุปรากรซิดนีย์

  3. สวนสัตว์ Taronga ซิดนีย์ ออสเตรเลีย

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

ใช้ Intent การนำทางแบบหลายจุดหมายนี้เพื่อระบุจุดหมายบางแห่งเป็นจุดชาร์จรถยนต์ไฟฟ้า (EV) Intent นี้ซึ่งขยาย Intent จุดอ้างอิงหลายจุดจะช่วยให้ผู้ขับขี่รักษาระดับการชาร์จแบตเตอรี่ของรถยนต์ไฟฟ้าให้เพียงพอต่อการเดินทางไปยังจุดหมายโดยการซิงค์ข้อมูลจุดชาร์จระหว่างแอปวางแผนการเดินทางด้วยรถยนต์ไฟฟ้ากับ Google Maps

สำหรับจุดชาร์จและจุดประสงค์ในการเดินทาง ให้ทำดังนี้

  • ต้องมีชื่อและละติจูด-ลองจิจูด
  • อาจมีกำลังไฟฟ้าขาออก (ไม่บังคับ) เพื่อใช้ในการคำนวณเวลาในการชาร์จ

Google ใช้ชื่อสถานีชาร์จและละติจูด-ลองจิจูดเพื่อค้นหาสถานที่ตั้งของสถานีชาร์จที่ตรงกันเพื่อแสดงข้อมูลแบบสมบูรณ์ เช่น ประเภทหัวชาร์จ จำนวน ความเร็ว และความพร้อมให้บริการแบบเรียลไทม์ วิธีการชำระเงินที่รองรับ และจุดที่น่าสนใจ (POI) ของโฮสต์ เช่น เส้นทางการขับขี่ภายในลานจอดรถกลางแจ้งสำหรับส่วนสุดท้ายของการนำทาง เวลาทำการ คะแนน เพื่อให้แน่ใจว่าสถานีชาร์จตรงกับข้อมูลของ Google ให้ใช้ <brand name> ที่เฉพาะเจาะจง เช่น ChargePoint

พารามิเตอร์

พารามิเตอร์ต่อไปนี้ช่วยให้คุณระบุรายละเอียดของจุดหมายปลายทางและจุดอ้างอิงต่างๆ รวมถึงจุดที่กำหนดให้เป็นสถานีชาร์จ EV

ปลายทางสุดท้าย

หากต้องการตั้งค่าสถานีชาร์จเป็นจุดหมายปลายทางสุดท้าย ให้ใช้คำสั่งต่อไปนี้

  • q: ต้องมีค่าละติจูด-ลองจิจูดของสถานีชาร์จ
  • q_type: 1 ระบุว่าจุดหมายสุดท้ายคือสถานีชาร์จ
  • q_name: ชื่อจุดหมายสุดท้าย ต้องระบุหาก q_type เป็น 1
  • q_power_output_kw: ตัวเลขทศนิยมสำหรับกำลังไฟฟ้าขาออกของสถานีชาร์จในหน่วย กิโลวัตต์ ไม่บังคับ

จุดอ้างอิง

สำหรับจุดอ้างอิง พารามิเตอร์ทั้งหมดจะเป็นอาร์เรย์ของค่าที่ขนานกันและคั่นด้วยไปป์ (|) ในลำดับเดียวกับจุดอ้างอิง โดยไม่รวมจุดหมายปลายทางสุดท้าย ความไม่ตรงกันของจำนวนองค์ประกอบในอาร์เรย์คู่ขนานจะถือว่าเป็น Intent ที่มีรูปแบบไม่ถูกต้อง

หากต้องการเพิ่มจุดอ้างอิงสถานีชาร์จอย่างน้อย 1 จุด ให้ใช้พารามิเตอร์ต่อไปนี้ ซึ่งทั้งหมดเป็นพารามิเตอร์ที่ไม่บังคับ หากมีการทำเครื่องหมายปลายทางใดปลายทางหนึ่งเป็นสถานีชาร์จ ชื่อจุดอ้างอิงจะกลายเป็นข้อมูลที่จำเป็นสำหรับปลายทางนั้น

  • waypoints: รายการจุดอ้างอิงตามที่อธิบายไว้ใน Intent การนำทางแบบเลี้ยวต่อเลี้ยว ต้องเป็นค่าละติจูด-ลองจิจูดสำหรับจุดอ้างอิงของสถานีชาร์จ

  • waypoint_types: ประเภทต่อจุดอ้างอิงที่ระบุเป็นตัวเลข 0 คือจุดแวะพักใดก็ได้ (ค่าเริ่มต้น) และ 1 คือสถานีชาร์จ

  • waypoint_names: ชื่อจุดอ้างอิง ต้องระบุข้อมูลในช่องนี้สำหรับสถานีชาร์จ

  • waypoint_power_outputs_kw: ตัวเลขทศนิยมสำหรับกำลังไฟของสถานีชาร์จในหน่วยกิโลวัตต์ สำหรับสถานีชาร์จ คุณสามารถระบุค่ากำลังไฟฟ้าขาออกของจุดอ้างอิง (ไม่บังคับ) ซึ่งจะใช้เป็นค่าสำรองหากไม่พบสถานีที่ตรงกัน ช่องว่างหมายความว่าไม่มีการระบุค่า

พฤติกรรมด้านประสบการณ์ของผู้ใช้ (UX)

สำหรับจุดประสงค์การเดินทางที่มีจุดหมายหลายแห่ง หน้าจอภาพรวมเส้นทางจะแสดงขึ้น แต่การนำทางจะไม่เริ่มโดยอัตโนมัติ

สำหรับ Intent ที่จัดรูปแบบอย่างถูกต้อง Google Maps จะแสดงหน้าจอภาพรวมเส้นทางสำหรับการเดินทาง หน้าจอภาพรวมเส้นทางจะแสดงจุดอ้างอิงทั้งหมดและจุดหมายสุดท้ายจาก Intent พร้อมคำแนะนำในการชาร์จ (หากมี)

สำหรับจุดอ้างอิงหรือจุดหมายปลายทางสุดท้ายที่ทำเครื่องหมายเป็นสถานีชาร์จ Google Maps จะค้นหาสถานที่ที่ตรงกันในฐานข้อมูลของ Google โปรดทำดังนี้เพื่อให้มั่นใจว่าระบบจะแสดงข้อมูลที่ดีที่สุดสำหรับสถานีชาร์จ

  • หากพบข้อมูลที่ตรงกัน Google Maps จะใช้ข้อมูลใน Google เพื่อแสดงสถานีชาร์จในอินเทอร์เฟซผู้ใช้ (UI) และให้คำแนะนำในการชาร์จสำหรับสถานีชาร์จนั้น

  • หากไม่พบรายการที่ตรงกัน ระบบจะใช้ข้อมูลที่ระบุใน Intent สำหรับสถานีชาร์จ (ละติจูด-ลองจิจูด ชื่อ และกำลังไฟฟ้า) เพื่อแสดงสถานีชาร์จนี้ใน UI และให้คำแนะนำในการชาร์จที่สถานีชาร์จนี้

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีสร้าง Intent สำหรับสถานการณ์การวางแผนการเดินทางด้วย EV ต่างๆ รวมถึงการนำทางผ่านสถานีชาร์จหลายแห่งและการจัดการเอาต์พุตพลังงานที่ไม่รู้จัก

นำทางไปยังจุดหมายสุดท้ายโดยผ่านสถานีชาร์จหลายแห่ง

Intent ต่อไปนี้จะนำทางไปยังจุดหมายปลายทางสุดท้ายคือ Port Macquarie NSW โดยผ่านสถานีชาร์จ 2 แห่ง ได้แก่ ChargePoint และ Evie

ปลายทางตามลำดับ:

  1. สถานีชาร์จ ChargePoint (ตำแหน่ง: -32.9599188,151.6240806, กำลังไฟฟ้าขาออก: 6.6kw)

  2. สถานีชาร์จ Evie (ตำแหน่ง: -31.9432539,152.4699808, กำลังไฟฟ้า: 350 กิโลวัตต์)

  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 (ตำแหน่ง: -32.9599188,151.6240806, กำลังไฟฟ้า: ไม่ทราบ)

  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. สวนสัตว์ Taronga ซิดนีย์ ออสเตรเลีย

  2. สถานีชาร์จ ChargePoint (ตำแหน่ง: -32.9599188,151.6240806, เอาต์พุตพลังงาน: ไม่ทราบ)

  3. สถานีชาร์จ Evie (สถานที่ตั้ง: -31.9432539,152.4699808, เอาต์พุตพลังงาน: 350 กิโลวัตต์)

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

ความตั้งใจในการดำเนินการ

Intent การดำเนินการต่อไปนี้พร้อมอินเทอร์เฟซพร้อมใช้งานแล้ว

การทำงาน คำอธิบาย
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 จะย้อนกลับไปยังหน้าจอก่อนหน้าใน UI
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 จะพูดเวลาถึงโดยประมาณของจุดหมาย (เช่น 9:15 น.)
geo.action:?act=time_to_destination หากผู้ใช้กำลังนำทาง Google Maps จะพูดเวลาที่คาดว่าจะถึงจุดหมาย (เช่น 15 นาที)
geo.action:?act=exit_navigation ออกจากการนำทาง
geo.action:?act=select_search_result&id=0 หากผลการค้นหาแสดงบนหน้าจอ (ดังที่แสดงในรูปภาพประกอบ) การดำเนินการนี้จะเริ่มการนำทางไปยังผลการค้นหาที่ n โดยอิงตามพารามิเตอร์รหัสที่ระบุ โปรดทราบว่าดัชนีจะเริ่มจาก 0 (นั่นคือ geo.action:?act=select_search_result&id=0 จะเลือกผลการค้นหารายการแรกในรายการ)

ผลการค้นหาจะแสดงบนหน้าจอ