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

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

ฉากหลัง

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

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

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

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

วิธีกำหนดโทเค็นจุดนำทาง

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

หมายเหตุ: เมื่อใช้ 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()

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

ตั้งแต่เวอร์ชัน 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()	ลักษณะการกำหนดเส้นทาง	การไฮไลต์ปลายทาง
พิกัดละติจูด/ลองจิจูดเท่านั้น	ตั้งค่า	ไม่ได้ระบุ	ไม่ได้ระบุ	เส้นทางไปยังส่วนถนนที่ใกล้กับพิกัดที่กำหนดมากที่สุด	แสดงหากอนุมานปลายทางได้อย่างมั่นใจสูง
รหัสสถานที่เท่านั้น	ไม่ได้ระบุ	ตั้งค่า	ไม่ได้ระบุ	เส้นทางไปยังจุดนำทางเริ่มต้นสำหรับรหัสสถานที่	รหัสสถานที่ต้นทาง
โทเค็นจุดนำทางเท่านั้น	ไม่ได้ระบุ	ไม่ได้ระบุ	ตั้งค่า	เส้นทางไปยังจุดนำทางที่แน่นอนซึ่งแสดงโดยโทเค็น	จากปลายทางที่กำหนดไว้ในคำขอเมธอดปลายทางเดิมของ Geocoding API
รวมพิกัดละติจูด/ลองจิจูดและรหัสสถานที่	ตั้งค่า	ตั้งค่า	ไม่ได้ระบุ	เส้นทางไปยังส่วนถนนที่ใกล้กับพิกัดที่กำหนดมากที่สุด	จากรหัสสถานที่ แม้ว่าจะไม่แสดงหากรหัสสถานที่อยู่ไกลจากพิกัดละติจูด/ลองจิจูดมากเกินไป