วางแผนเส้นทาง

บางครั้งคุณอาจต้องการวางแผนเส้นทางที่แอปจะแสดงให้ผู้ใช้เห็น การใช้โทเค็นเส้นทางจาก Routes API, Routes Preferred API หรือ Route Optimization API จะช่วยให้คุณระบุ 2 สิ่งต่อไปนี้สำหรับเส้นทางที่วางแผนไว้ได้

  • เส้นประกอบสำหรับเส้นทาง

  • วัตถุประสงค์ของเส้นทาง

ตัวอย่างวัตถุประสงค์ในการกำหนดเส้นทางที่คุณอาจมี ได้แก่

  • ลดเวลาในการนำส่ง: ธุรกิจที่นำส่งอาหารอาจต้องการลดเวลาที่ใช้ในการนำส่งอาหาร

  • ลดระยะเวลาเดินทางหรือการใช้เชื้อเพลิง: ธุรกิจโลจิสติกส์อาจต้องการปรับปรุงประสิทธิภาพของคนขับและลดต้นทุนเชื้อเพลิง

  • ลดเวลาในการเดินทางไปยังจุดหมาย: การดำเนินการจัดส่งบริการอาจต้องการลดเวลาที่ใช้ในการส่งผู้ปฏิบัติงานไปยังคำของาน

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

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

เหตุผลที่ควรใช้โทเค็นเส้นทางสำหรับวัตถุประสงค์ของเส้นทาง

โทเค็นเส้นทางจาก Routes API, Routes Preferred API หรือ Route Optimization API ช่วยให้คุณควบคุมเส้นทางที่ระบุได้มากขึ้น ดังนี้

  • วางแผนเส้นทางล่วงหน้าเพื่อให้ Navigation SDK ใช้

  • เลือกเส้นทางที่ดีที่สุดสำหรับ Navigation SDK เพื่อใช้งาน หากคุณขอโทเค็นเส้นทางเมื่อสร้างเส้นทางใน Routes API คุณจะได้รับโทเค็นเส้นทางสำหรับแต่ละเส้นทางที่สร้างขึ้น จากนั้นคุณสามารถเลือกโทเค็นสำหรับเส้นทางที่ต้องการใช้เมื่อส่งไปยัง Navigation SDK

  • ประเมินราคาล่วงหน้า รวมถึงการประเมินเวลาถึงโดยประมาณและระยะทาง แม้ว่าค่าใช้จ่ายและเวลาจริงอาจแตกต่างกันไป แต่การประมาณนี้จะช่วยลดช่องว่างระหว่างค่าใช้จ่ายของเส้นทางที่คาดไว้กับค่าใช้จ่ายจริง

  • ระบุวัตถุประสงค์ของเส้นทางขั้นสูงเพิ่มเติม เช่น เส้นทางที่เป็นมิตรต่อสิ่งแวดล้อมหรือเส้นทางที่สั้นที่สุด

วิธีการทำงานของโทเค็นเส้นทาง

คุณสามารถใช้ Routes API, Routes Preferred API หรือ Route Optimization API เพื่อวางแผนเส้นทางโดยใช้วัตถุประสงค์ของเส้นทาง คุณสามารถส่งโทเค็นเส้นทางที่แสดงผลจาก API เหล่านี้ไปยัง Navigation SDK เพื่อเป็นแนวทางในการกำหนดเส้นทางของยานพาหนะ

สิ่งที่จะเกิดขึ้นเมื่อคุณขอและใช้โทเค็นเส้นทางมีดังนี้

  1. Routes API, Routes Preferred API หรือ Route Optimization API จะแสดงผลโทเค็นเส้นทางที่เข้ารหัสซึ่งมีเส้นประกอบของเส้นทางและวัตถุประสงค์ของเส้นทาง

  2. คุณส่งโทเค็นเส้นทางไปยัง Navigation SDK

  3. Navigation SDK จะเริ่มการนำทางในเส้นทางที่วางแผนไว้ แม้ว่าจะมีเส้นทางที่เร็วกว่าก็ตาม

  4. ในระหว่างการเดินทาง หากสภาพการจราจรหรือสภาพถนนเปลี่ยนแปลง หรือหากยานพาหนะออกนอกเส้นทางที่วางแผนไว้ Navigation SDK จะคำนวณเส้นทางใหม่ตามวัตถุประสงค์ของเส้นทางและตัวเลือกการกำหนดเส้นทางที่ตั้งค่าไว้ในโทเค็นเส้นทาง

กระบวนการนี้จะช่วยให้เส้นทางจริงใกล้เคียงกับเส้นทางที่วางแผนไว้มากที่สุด

สาเหตุที่ระบบอาจไม่ปฏิบัติตามเส้นทางที่วางแผนไว้อย่างเคร่งครัด

การนำทางจะเริ่มต้นในเส้นทางที่วางแผนไว้ แต่เส้นทางจริงอาจแตกต่างจากเส้นทางดังกล่าวในสถานการณ์ต่อไปนี้

  • ยานพาหนะเริ่มออกตัวจากจุดเริ่มต้นที่วางแผนไว้
  • สภาพการจราจรหรือสภาพถนนเปลี่ยนแปลงระหว่างการเดินทาง
  • ยานพาหนะออกจากเส้นทางที่วางแผนไว้

ความแตกต่างเหล่านี้อาจส่งผลต่อระยะทาง, ETA และคุณภาพการเดินทางที่สำคัญอื่นๆ ที่คุณวางแผนไว้

วางแผนเส้นทางโดยใช้โทเค็นเส้นทาง

คุณวางแผนเส้นทางได้โดยสร้างโทเค็นเส้นทางแล้วส่งไปยัง Navigation SDK ตามที่อธิบายไว้ในขั้นตอนต่อไปนี้

ขั้นตอนที่ 1: สร้างโทเค็นเส้นทางโดยใช้ Routes API, Routes Preferred API หรือ Route Optimization API

  1. ขอโทเค็นเส้นทางด้วยวิธีใดวิธีหนึ่งต่อไปนี้

  2. ตั้งค่าคำขอ Routes API หรือ Routes Preferred API ให้เป็นไปตามข้อกำหนดสำหรับการใช้โทเค็นเส้นทาง ดังนี้

    • ตั้งค่า travelMode เป็น DRIVE หรือ TWO_WHEELER
    • ตั้งค่า routingPreference เป็น TRAFFIC_AWARE หรือ TRAFFIC_AWARE_OPTIMAL
    • อย่าใช้จุดอ้างอิง Via จุด

ขั้นตอนที่ 2: ส่งโทเค็นเส้นทางไปยัง Navigation SDK

  1. จัดเก็บโทเค็นเส้นทาง: ใน Navigation SDK ให้ตั้งค่าสตริงเพื่อจัดเก็บโทเค็นเส้นทาง เช่น

    let routeToken = "route token returned by Routes API"

    ตัวอย่างโทเค็นเส้นทางที่แสดงผล

    {
// Other fields
"routeToken": "CqMBCjoKCJQOor5DHcwiEhBon3XpHXFnVvDeWMwd9PpAGgz6wtnFDKIBrAHTARpCApUDSggAAAAACjcrP3gBEAQaTApKChgKDQoCCAERAAAAAACAZkAR3SQGgZUXdUASEggAEAMQBhATEBIYAkIEGgIIBSIYChZ2VEJiWlBPSkk1aU5wUVRzNTV5d0FRKAEiFQBcJuds-Efh-2QZhOMTtUCCxEVL_g",
}

  2. ส่งโทเค็นเส้นทางไปยัง Navigation SDK โดยใช้ mapView.navigator.setDestinations ระบุจุดอ้างอิงปลายทางเดียวกันกับที่ใช้เมื่อสร้างโทเค็นเส้นทาง

    mapView.navigator?.setDestinations([waypoint1, waypoint2], routeToken: routeToken, callback: {...})

    เมธอด setDestinations จะส่งสถานะของคำขอไปยัง Callback หากพบเส้นทางจากตำแหน่งของผู้ใช้ไปยังปลายทางที่ระบุ สถานะจะเป็น .OK (GMSRouteStatusOK)

สถานการณ์ที่มีจุดแวะพักหลายจุด

คุณกำหนดค่าจุดอ้างอิงได้สูงสุด 25 จุด

วิธีการเดินทาง setDestinations ไม่รองรับการเดินทางที่มีจุดแวะพักหลายแห่ง ใช้ continueToNextDestinationWithCompletion() เพื่อเลื่อนจุดอ้างอิงไปยังช่วงถัดไปของการเดินทาง

ตัวอย่าง

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีดึงข้อมูลเส้นทางที่วางแผนไว้

Swift

let location = CLLocationCoordinate2D(latitude: 47.67, longitude: -122.20)
let waypoint1 = GMSNavigationWaypoint(location: location, title: "waypoint from location")!
let waypoint2 = GMSNavigationWaypoint(placeID: "samplePlaceID", title: "waypoint from Place ID")!

let routeToken = "route token returned by Routes API"
mapView.navigator?.setDestinations([waypoint1, waypoint2], routeToken: routeToken, callback: {...})

Objective-C

CLLocationCoordinate2D location = CLLocationCoordinate2DMake(47.67, -122.20);
GMSNavigationWaypoint *waypoint1 = [[GMSNavigationWaypoint alloc] initWithLocation:location title:@"waypoint from location"];
GMSNavigationWaypoint *waypoint2 = [[GMSNavigationWaypoint alloc] initWithPlaceID:@"samplePlaceID"
                                                                            title:@"waypoint from Place ID"];
NSString *routeToken = @"route token returned by Routes API";

[mapView.navigator setDestinations:@[waypoint1, waypoint2]
                        routeToken:routeToken
                          callback:^(GMSRouteStatus routeStatus){...}];

วิธีที่โทเค็นเส้นทางและ Navigation SDK โต้ตอบกัน

Navigation SDK จะจัดการเส้นทางที่วางแผนไว้ดังนี้

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

    • avoidsHighways
    • avoidsTolls
    • avoidsFerries
    • licensePlateRestriction
    • โหมดการเดินทางที่ตั้งค่าไว้ในแอป

  • ทำตามการตั้งค่าต่อไปนี้เมื่อคำนวณหรือปรับเส้นทาง

    • วัตถุประสงค์ของเส้นทางจากโทเค็นเส้นทาง เช่น เส้นทางที่เป็นมิตรต่อสิ่งแวดล้อมหรือเส้นทางที่สั้นที่สุด หาก Navigation SDK ต้องปรับเส้นทาง ระบบจะใช้วัตถุประสงค์ของเส้นทางที่คุณระบุไว้เมื่อขอโทเค็นเส้นทาง

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