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

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

ฉากหลัง

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

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

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

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

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

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