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 bạn cung cấp cho người dùng. Việc sử dụng mã thông báo định tuyến từ API Tuyến đường (hoặc API Ưu tiên cho tuyến đường) có thể giúp bạn chỉ định 2 nội dung cho tuyến đường dự kiến của mình:

  • Hình nhiều đường cho tuyến đường

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

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

  • Giảm thiểu thời gian giao đồ ăn: 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 kho vận có thể muốn cải thiện hiệu quả của tài xế và giảm chi phí nhiên liệu.

  • Giảm thiểu thời gian tới đích: Hoạt động điều phối dịch vụ có thể muốn giảm thiểu thời gian cần thiết để đưa toán tử đến yêu cầu công việc.

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

Để 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 phần Yêu cầu mã thông báo tuyến.

Tại sao bạn phải sử dụng mã thông báo tuyến đường cho mục tiêu tuyến đường

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

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

  • Chọn tuyến đường tốt nhất để SDK điều hướng sử dụng. Nếu yêu cầu mã thông báo tuyến đường khi tạo tuyến trong API tuyến đường, bạn sẽ nhận được mã thông báo tuyến đường cho từng tuyến đã 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 truyền mã đó đến SDK điều hướng.

  • Ước tính giá trước, bao gồm cả thông tin ước tính cho giờ đến dự kiến và khoảng cách. Mặc dù chi phí và thời gian thực tế có thể thay đổi, nhưng số liệu ước tính này giúp giảm khoảng cách giữa chi phí dự kiến và chi phí thực tế theo tuyến đường.

  • Chỉ định các mục tiêu tuyến đường nâng cao hơn, chẳng hạn như định tuyến tiết kiệm năng lượng hoặc tuyến đường ngắn nhất.

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

Bạn có thể sử dụng API Tuyến đường hoặc API Ưu tiên tuyến đường để lên kế hoạch cho một tuyến đường bằng cách sử dụng các mục tiêu tuyến đường. API Tuyến đường trả về một mã thông báo tuyến đường mà bạn có thể chuyển đến SDK điều hướng để hướng dẫn cách API này định tuyến xe của bạn.

Dưới đây là những gì sẽ xảy ra khi bạn yêu cầu và sử dụng mã thông báo tuyến đường từ API Tuyến đường:

  1. API Tuyến trả về một mã thông báo định tuyến đã mã hoá, bao gồm các mục tiêu tuyến đường và nhiều đường.

  2. Bạn truyền mã thông báo tuyến đường đến SDK điều hướng.

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

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

Quá trình này sẽ tối đa hoá khoảng cách giữa tuyến đường thực tế với tuyến đường đã lên kế hoạch của bạn.

Lý do có thể không đi theo chính xác tuyến đường dự kiến

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

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, sau đó truyền mã đó đến SDK điều hướng, như mô tả ở các bước sau:

Bước 1: Tạo mã thông báo tuyến đường bằng cách sử dụng API ưu tiên tuyến đường hoặc tuyến đường

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

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

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

Bước 2: Truyền mã thông báo tuyến đường đến SDK điều hướng

  1. Lưu trữ mã thông báo tuyến đường: Trong SDK điều hướng, 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. Truyền mã thông báo tuyến đường đến SDK điều hướng bằng phương thức Navigator.setDestinations, chỉ định cùng các điểm tham chiếu đích mà 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)
      .build();

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 điểm đến đã cho, ứng dụng sẽ trả về RouteStatus.OK.

Để biết thêm thông tin về phương thức này, hãy xem 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 định tuyến.

    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(CustomRoutesOptions.TravelMode.TWO_WHEELER)
          .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);

Cách mã thông báo tuyến đường và SDK điều hướng tương tác

Dưới đây là cách tuyến đường do SDK điều hướng tạo ra và tuyến đường theo 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 tình trạng giao thông và đường sá. Hãy xem phần Tại sao không thể đi theo chính xác tuyến đường dự kiến.

  • 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

  • Lượt theo dõi:

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

    • Mục tiêu của tuyến. Nếu phải điều chỉnh tuyến đường được trả về, SDK điều hướng sẽ sử dụng các mục tiêu tuyến mà bạn đã chỉ định khi yêu cầu mã thông báo tuyến. 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 mà bạn đã chỉ định trong API Tuyến đường.