Lên kế hoạch tuyến đường

Đôi khi, bạn có thể muốn lên kế hoạch cho tuyến đường mà ứng dụng của mình cung cấp cho người dùng. Việc sử dụng mã thông báo tuyến đường từ Routes API, Routes Preferred API hoặc Route Optimization API có thể giúp bạn chỉ định 2 điều cho tuyến đường đã lên kế hoạch:

• Đường đa tuyến cho tuyến đường

• Mục tiêu của bạn đối với tuyến đường

Ví dụ: sau đây là một số mục tiêu định tuyến mà bạn có thể có:

• Giảm thiểu thời gian giao hàng: Một doanh nghiệp giao đồ ăn có thể muốn giảm thiểu thời gian giao đồ ăn.

• Giảm thiểu thời gian di chuyển hoặc mức tiêu thụ nhiên liệu: Một doanh nghiệp logistics có thể muốn nâng cao hiệu quả của tài xế và giảm chi phí nhiên liệu.

• Giảm thiểu thời gian đến đích: Một hoạt động điều phối dịch vụ có thể muốn giảm thiểu thời gian để điều phối nhân viên đến địa điểm theo yêu cầu.

• Giảm chi phí và cải thiện độ an toàn: Một doanh nghiệp đi chung xe có thể muốn tìm một tuyến đường ít tốn kém hơn cho người đi xe và tránh một số khu vực vì lý do an toàn.

Quan trọng: Tuyến đường thực tế có thể khác với tuyến đường đã lên kế hoạch do mã thông báo cung cấp. Việc thay đổi tình trạng giao thông, điều kiện đường xá hoặc phương tiện đi lệch khỏi tuyến đường đã cho có thể dẫn đến việc thay đổi tuyến đường. Khi có thay đổi, Navigation SDK sẽ liên tục cố gắng quay lại tuyến đường đã lên kế hoạch. Nếu không thể quay lại, SDK sẽ tuân theo các mục tiêu của tuyến đường trong mã thông báo tuyến đường.

Để biết thêm thông tin về cách lên kế hoạch cho một tuyến đường bằng mã thông báo tuyến đường, hãy xem bài viết Yêu cầu mã thông báo tuyến đường trong Routes API và Chuyển đổi đường đa tuyến và mã thông báo trong Route Optimization API.

Lý do nên sử dụng mã thông báo tuyến đường cho các mục tiêu của tuyến đường

Với mã thông báo tuyến đường từ Routes API, Routes Preferred API hoặc Route Optimization API, bạn có thể kiểm soát nhiều hơn đối với tuyến đường được cung cấp:

• Lên kế hoạch trước cho một tuyến đường để Navigation SDK sử dụng khi có thể.

• Chọn tuyến đường tốt nhất để Navigation SDK sử dụng. Nếu bạn yêu cầu mã thông báo tuyến đường khi tạo tuyến đường trong Routes API, bạn sẽ nhận được mã thông báo tuyến đường cho mỗi tuyến đường được tạo. Sau đó, bạn có thể chọn mã thông báo cho tuyến đường mà bạn muốn sử dụng khi chuyển mã thông báo đó sang Navigation SDK.

• Ước tính trước giá, bao gồm cả thời gian đến dự kiến và khoảng cách. Mặc dù chi phí và thời gian thực tế có thể khác nhau, nhưng việc ước tính này sẽ giảm khoảng cách giữa chi phí dự kiến và chi phí thực tế của tuyến đường.

• Chỉ định các mục tiêu nâng cao hơn cho tuyến đường, chẳng hạn như định tuyến thân thiện với môi trường hoặc tuyến đường ngắn nhất.

Lưu ý: Mã thông báo tuyến đường dành cho một điểm xuất phát và đích đến cụ thể và vào một thời điểm cụ thể. Bạn phải đưa ra yêu cầu mới đối với Routes API, Routes Preferred API hoặc Route Optimization API để có mã thông báo tuyến đường mới.

Cách hoạt động của mã thông báo tuyến đường

Bạn có thể sử dụng Routes API, Routes Preferred API hoặc Route Optimization API để lên kế hoạch cho một tuyến đường bằng các mục tiêu của tuyến đường. Bạn có thể chuyển mã thông báo tuyến đường được trả về từ bất kỳ API nào trong số này sang Navigation SDK để hướng dẫn cách định tuyến cho xe của bạn.

Sau đây là những điều xảy ra khi bạn yêu cầu và sử dụng mã thông báo tuyến đường:

1. Routes API, Routes Preferred API hoặc Route Optimization API trả về mã thông báo tuyến đường đã mã hoá, bao gồm hình nhiều đường của tuyến đường và các mục tiêu của tuyến đường.

2. Bạn chuyển mã thông báo tuyến đường sang Navigation SDK.

3. Navigation SDK truy xuất tuyến đường hoặc nếu tuyến đường không có sẵn do điều kiện thay đổi, thì SDK sẽ truy xuất tuyến đường phù hợp nhất.

4. Trong khi lái xe trên tuyến đường, nếu tình trạng giao thông hoặc các điều kiện đường xá khác thay đổi hoặc nếu xe đi lệch khỏi tuyến đường đã lên kế hoạch, thì các tuyến đường đã sửa đổi sẽ liên tục cố gắng khớp với tuyến đường tốt nhất dựa trên các mục tiêu của tuyến đường trong mã thông báo.

Quá trình này giúp tối đa hoá mức độ gần gũi giữa tuyến đường thực tế và tuyến đường đã lên kế hoạch.

Lý do tuyến đường đã lên kế hoạch có thể không được tuân thủ chính xác

Hãy xem tuyến đường đã lên kế hoạch và các mục tiêu của tuyến đường là các nguyên tắc cần tuân thủ: chúng không mang tính bắt buộc. Bạn có thể thấy sự khác biệt giữa tuyến đường đã lên kế hoạch và tuyến đường do tính năng chỉ đường bằng giọng nói cung cấp do sự khác biệt về điều kiện đường xá, vị trí xuất phát hoặc các tham số khác đã thay đổi kể từ khi bạn tạo tuyến đường đã lên kế hoạch. Sự khác biệt này có thể dẫn đến sự không khớp giữa mục tiêu đã lên kế hoạch và mục tiêu thực tế về khoảng cách và thời gian đến dự kiến, cũng như các yếu tố quan trọng khác của chuyến đi.

Lưu ý:Theo phương pháp hay nhất, hãy luôn yêu cầu mã thông báo tuyến đường mới mỗi khi bạn đặt đích đến trong Navigation SDK và lên kế hoạch cho một số biến thể để tránh mọi tác động đến doanh nghiệp của bạn.

Lên kế hoạch cho một tuyến đường bằng mã thông báo tuyến đường

Bạn có thể lên kế hoạch cho một tuyến đường bằng cách tạo mã thông báo tuyến đường rồi chuyển mã thông báo đó sang Navigation SDK, như mô tả trong các bước sau:

Bước 1: Tạo mã thông báo tuyến đường bằng Routes API, Routes Preferred API hoặc Route Optimization API

1. Yêu cầu mã thông báo tuyến đường bằng một trong các phương thức sau:

   • Routes API: computeRoutes. Để biết thêm thông tin về cách yêu cầu mã thông báo tuyến đường trong Routes API, hãy xem Tính toán tuyến đường và Yêu cầu mã thông báo tuyến đường.

   • Routes Preferred API: computeCustomRoutes. Để biết thêm thông tin về cách yêu cầu mã thông báo tuyến đường trong Routes Preferred API, hãy xem bài viết Lên kế hoạch cho một tuyến đường.

   • Route Optimization API: optimizeTours hoặc batchOptimizeTours. Để biết thêm thông tin về cách yêu cầu mã thông báo tuyến đường trong Route Optimization API, hãy xem bài viết Chuyển đổi đường đa tuyến và mã thông báo tuyến đường.

2. Thiết lập yêu cầu Routes API hoặc Routes Preferred API để đáp ứng các yêu cầu về việc sử dụng mã thông báo tuyến đường:

   • Đặt travel_mode thành DRIVE hoặc TWO_WHEELER
   • Đặt routing_preference thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL
   • KHÔNG sử dụng điểm tham chiếu Via

Lưu ý: Bạn có thể chỉ định các giá trị chính xác cho điểm xuất phát và đích đến, chẳng hạn như lối vào, bến bốc dỡ hàng hoặc khu vực đón khách được chỉ định, trong mã thông báo tuyến đường bằng cách sử dụng mã thông báo điểm điều hướng.

Bước 2: Chuyển mã thông báo tuyến đường sang Navigation SDK

1. Lưu trữ mã thông báo tuyến đường: Trong Navigation SDK, hãy thiết lập một chuỗi để lưu trữ mã thông báo tuyến đường. Ví dụ:

   String routeToken = "route token returned by Routes API";

   Ví dụ về mã thông báo tuyến đường được trả về:

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

2. Chuyển mã thông báo tuyến đường sang Navigation SDK bằng phương thức Navigator.setDestinations, chỉ định các điểm tham chiếu đích đến giống như bạn đã sử dụng khi tạo mã thông báo tuyến đường:

   setDestinations(List destinations, CustomRoutesOptions customRoutesOptions, DisplayOptions displayOptions);

   Ví dụ:

   CustomRoutesOptions customRoutesOptions =
         CustomRoutesOptions.builder()
         .setRouteToken(routeToken)
         .setTravelMode(TravelMode.DRIVING)
         .build();

Lưu ý: Nếu bạn cần đi lại trên cùng một tuyến đường, hãy yêu cầu mã thông báo tuyến đường mới.

Phương thức Navigator.setDestinations trả về trạng thái của yêu cầu. Nếu tìm thấy một tuyến đường từ vị trí của xe đến đích đến đã cho, thì phương thức này sẽ trả về RouteStatus.OK.

Để biết thêm thông tin về phương thức này, hãy xem bài viết Navigator.setDestinations.

Ví dụ

Ví dụ về mã sau đây minh hoạ cách chỉ định một tuyến đường đã lên kế hoạch bằng mã thông báo tuyến đường.

    ArrayList <Waypoint> destinations = Lists.newArrayList();
    Waypoint waypoint1 =
       Waypoint.builder()
          .setLatLng(10, 20)
          .setTitle("title")
          .setVehicleStopover(true)
          .build();
    destinations.add(waypoint1);
    Waypoint waypoint2 =
       Waypoint.builder()
          .setPlaceId("ChIJYV-J-ziuEmsRIMyoFaMedU4")
          .setTitle("title")
          .setVehicleStopover(true)
           .build()
    destinations.add(waypoint2);

    String routeToken = "route token returned by Routes API";

    CustomRoutesOptions customRoutesOptions =
       CustomRoutesOptions.builder()
          .setRouteToken(routeToken)
          .setTravelMode(TravelMode.DRIVING)
          .build();

    // Existing flow to get a Navigator.
    NavigationApi.getNavigator(...);

    // Existing flow for requesting routes.
    ListenableResultFuture<RouteStatus> routeStatusFuture =
        navigator.setDestinations(destinations, customRoutesOptions);

    // Or with display options.
    DisplayOptions displayOptions = new DisplayOptions();

    ListenableResultFuture<RouteStatus> routeStatusFuture =
        navigator.setDestinations(destinations, customRoutesOptions, displayOptions);

Lưu ý: Bạn có thể định cấu hình tối đa 25 điểm tham chiếu.

Cách mã thông báo tuyến đường và Navigation SDK tương tác

Sau đây là cách tuyến đường do Navigation SDK tạo và tuyến đường đã lên kế hoạch trong mã thông báo tuyến đường tương tác:

• Ghi đè mọi đích đến đã đặt trước đó.

• Sử dụng vị trí xuất phát của xe.

• Điều chỉnh theo điều kiện đường xá và tình trạng giao thông. Xem bài viết Lý do tuyến đường đã lên kế hoạch có thể không được tuân thủ chính xác.

• Bỏ qua các tuỳ chọn liên quan đến định tuyến sau đây vì không cần thiết:

  • avoidsHighways
  • avoidsTolls
  • avoidsFerries
  • licensePlateRestriction

• Tuân theo:

  • Các tuỳ chọn liên quan đến điểm tham chiếu, chẳng hạn như tuỳ chọn ưu tiên bên đường.

  • Mục tiêu của tuyến đường. Nếu Navigation SDK phải điều chỉnh tuyến đường được trả về, thì SDK sẽ sử dụng các mục tiêu của tuyến đường mà bạn đã chỉ định khi yêu cầu mã thông báo tuyến đường. Vì lý do này, bạn nên sử dụng các tuỳ chọn liên quan đến điểm tham chiếu giống như bạn đã chỉ định trong Routes API.