เส้นทางไปยังจุดนำทาง

Navigation SDK สำหรับ Android มีวิธีที่ดียิ่งขึ้นในการระบุจุดแวะพักหรือจุดนำทาง ซึ่งให้การกำหนดเส้นทางที่แม่นยำยิ่งขึ้นและประสบการณ์การเดินทางถึงจุดหมายที่ดีขึ้น โดยเฉพาะอย่างยิ่งสำหรับจุดหมายที่มีทางเข้าหลายทางหรือจุดนำทางที่เฉพาะเจาะจง คุณสามารถกำหนดเส้นทางไปยังสถานที่ที่แน่นอนได้โดยใช้ navigationPointToken ซึ่งเป็นสตริงที่เข้ารหัสสถานที่และบริบทเส้นทางเพิ่มเติม นอกจากนี้ คุณยังรวมพิกัดละติจูดและลองจิจูดกับรหัสสถานที่เพื่อเพิ่มบริบทได้ด้วย

ฉากหลัง

ก่อนเวอร์ชัน 7.4 คุณสามารถกำหนด Waypoint ได้โดยใช้พิกัดละติจูดและลองจิจูด หรือ รหัสสถานที่ แม้ว่าการกำหนดเส้นทางไปยังละติจูดและลองจิจูดเพียงอย่างเดียวอาจมีประสิทธิภาพในบางครั้ง แต่ก็อาจทำให้จุดรับส่งไม่เหมาะสม โดยเฉพาะอย่างยิ่งสำหรับสถานที่ขนาดใหญ่ สวนสาธารณะ หรืออาคารที่มีทางเข้าหลายทาง ผลลัพธ์อาจจัดพอดีกับส่วนถนนที่ใกล้ที่สุด ซึ่งอาจไม่ใช่จุดนำทางที่สะดวกหรือถูกต้องที่สุด

ตัวเลือกจุดแวะพักที่ดียิ่งขึ้นช่วยแก้ปัญหานี้ด้วยการอนุญาตให้ระบุบริบทเพิ่มเติม

ใช้โทเค็นจุดนำทาง

หากต้องการกำหนดเส้นทางที่แม่นยำที่สุดไปยังจุดนำทางที่เฉพาะเจาะจง เช่น ทางเข้า ท่าเทียบเรือขนถ่ายสินค้า หรือพื้นที่รับส่งที่กำหนด คุณสามารถใช้ navigationPointToken ได้ คุณจะได้รับโทเค็นนี้โดยการเรียกใช้เมธอด destinations ของ Geocoding API โทเค็นนี้แสดงถึงจุดนำทางที่กำหนดเส้นทางได้และเฉพาะเจาะจงซึ่งเชื่อมโยงกับสถานที่

วิธีระบุโทเค็นจุดนำทาง

1. รับ navigationPointToken จากเมธอด Destinations ของ การตอบกลับ Geocoding API
2. สร้าง Waypoint โดยใช้เมธอด setNavigationPointToken() ใน Builder

หมายเหตุ: เมื่อใช้ setNavigationPointToken() คุณจะใช้ setLatLng() หรือ setPlaceIdString() พร้อมกันไม่ได้ เมธอดเหล่านี้แยกจากกันโดยสิ้นเชิงกับ setNavigationPointToken()

// Assuming 'navPointToken' is a String obtained from the destinations method of the Geocoding API
// Assuming 'destinationName' is a String title for the waypoint

Waypoint waypointWithToken = Waypoint.builder()
    .setTitle(destinationName)
    .setNavigationPointToken(navPointToken)
    .build();

// Use this waypoint in navigator.setDestinations()

ใช้โทเค็นจุดนำทางและโทเค็นเส้นทาง

คุณสามารถดึงข้อมูลโทเค็นจุดนำทางผ่าน Geocoding API ดึงข้อมูลโทเค็นเส้นทางจาก Routes API แล้วส่งทั้งโทเค็นจุดนำทางและโทเค็นเส้นทางไปยัง Navigation SDK วิธีนี้มีประโยชน์ในสถานการณ์ต่างๆ เช่น การแชร์รถหรือการจัดส่ง ซึ่งคุณใช้ Routes API เพื่อคำนวณราคาการเดินทางและต้องการความแม่นยำของโทเค็นจุดนำทาง

โทเค็นเส้นทางจะกำหนดเส้นทางที่ Navigation SDK เลือกให้เป็นเส้นทางที่ใช้ในการกำหนดราคา ซึ่งจะช่วยลดความเสี่ยงในการใช้เส้นทางที่ยาวขึ้นหรือสั้นลงสำหรับการเดินทาง ซึ่งอาจทำให้เกิด "การเปลี่ยนแปลงราคาอย่างกะทันหัน"

ดูข้อมูลเพิ่มเติมเกี่ยวกับการระบุ สถานที่โดยใช้โทเค็นจุดนำทางและ การสร้างโทเค็นเส้นทาง ได้ในเอกสารประกอบของ Routes API ดูวิธีวางแผนเส้นทางโดยใช้โทเค็นเส้นทางได้ที่ "วางแผนเส้นทาง"

แผนภาพนี้แสดงวิธีที่แอปแชร์รถหรือแอปจัดส่งจะใช้โทเค็นจุดนำทางและโทเค็นเส้นทางร่วมกัน

แผนภาพกรณีการใช้งานแชร์รถหรือจัดส่ง

รวมรหัสสถานที่กับละติจูดและลองจิจูด

ตั้งแต่เวอร์ชัน 7.4 เป็นต้นไป คุณสามารถระบุ ทั้ง รหัสสถานที่และพิกัดละติจูดและลองจิจูดเมื่อสร้าง Waypoint เมธอดนี้มีประโยชน์เมื่อคุณต้องการระบุจุดที่แน่นอน (ละติจูด/ลองจิจูด) ขณะที่ยังคงระบุบริบทของสถานที่โดยรวม (รหัสสถานที่) ซึ่งช่วยให้ Navigation SDK มอบประสบการณ์การเดินทางถึงจุดหมายที่ดียิ่งขึ้นด้วยการไฮไลต์อาคารจุดหมายหรือแสดงจุดสนใจที่อยู่ใกล้เคียงซึ่งเกี่ยวข้องกับรหัสสถานที่

// Assuming 'placeId' is the Place ID String
// Assuming 'lat' and 'lng' are the double values for latitude and longitude
// Assuming 'destinationName' is a String title for the waypoint

Waypoint waypointWithPlaceIdAndLatLng = Waypoint.builder()
    .setTitle(destinationName)
    .setPlaceIdString(placeId)
    .setLatLng(lat, lng)
    .build();

// Use this waypoint in navigator.setDestinations()

ข้อควรพิจารณา

สิ่งที่จะเกิดขึ้นเมื่อคุณระบุทั้ง placeId และ latlng

• เส้นทางจะกำหนดเป้าหมายหลักไปที่ latlng ที่ระบุ
• ระบบจะใช้ placeId เป็นบริบทเพื่อปรับปรุงประสบการณ์การเดินทางถึงจุดหมาย
• การทำงานสำรอง: หาก SDK กำหนดว่า placeId ที่ระบุสอดคล้องกับฟีเจอร์ที่อยู่ไกลจาก latlng ที่กำหนดมากเกินไป ระบบจะละเว้น placeId ในสถานการณ์นี้ การกำหนดเส้นทางจะไปยัง latlng เท่านั้น และการปรับปรุงประสบการณ์การเดินทางถึงจุดหมายที่เฉพาะเจาะจงของสถานที่จะไม่พร้อมใช้งาน

สรุปการกำหนดค่าจุดอ้างอิงที่ถูกต้อง

วิธีการ	setLatLng()	setPlaceIdString()	setNavigationPointToken()	ลักษณะการทำงานของการกำหนดเส้นทาง	การไฮไลต์จุดหมาย
พิกัดละติจูด/ลองจิจูดเท่านั้น	ตั้งค่า	ไม่ได้ระบุ	ไม่ได้ระบุ	กำหนดเส้นทางไปยังส่วนถนนที่ใกล้กับพิกัดที่กำหนด	แสดงขึ้นหากอนุมานจุดหมายได้อย่างมั่นใจ
รหัสสถานที่เท่านั้น	ไม่ได้ระบุ	ตั้งค่า	ไม่ได้ระบุ	กำหนดเส้นทางไปยังจุดนำทางเริ่มต้นสำหรับรหัสสถานที่	จากรหัสสถานที่
โทเค็นจุดนำทางเท่านั้น	ไม่ได้ระบุ	ไม่ได้ระบุ	ตั้งค่า	กำหนดเส้นทางไปยังจุดนำทางที่แน่นอนซึ่งแสดงโดยโทเค็น	จากจุดหมายที่กำหนดในเมธอด destinations เดิมของคำขอ Geocoding API
รวมพิกัดละติจูด/ลองจิจูดและรหัสสถานที่	ตั้งค่า	ตั้งค่า	ไม่ได้ระบุ	กำหนดเส้นทางไปยังส่วนถนนที่ใกล้กับพิกัดที่กำหนด	จากรหัสสถานที่ แต่จะไม่แสดงหากรหัสสถานที่อยู่ไกลจากพิกัดละติจูด/ลองจิจูดมากเกินไป