SDK điều hướng hiện chỉ được cung cấp cho một số khách hàng. Liên hệ với bộ phận bán hàng để tìm hiểu thêm.

Kiểu bản đồ mới sắp xuất hiện trên Nền tảng Google Maps. Bản cập nhật này để tạo kiểu bản đồ bao gồm một bảng màu mặc định mới và các cải tiến về trải nghiệm bản đồ cũng như khả năng hữu dụng. Tất cả kiểu bản đồ sẽ được cập nhật tự động vào tháng 3 năm 2025. Để biết thêm thông tin về phạm vi cung cấp và cách chọn tham gia sớm hơn, hãy xem bài viết Kiểu bản đồ mới cho Nền tảng Google Maps.

Trang này được dịch bởi Cloud Translation API.

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

Đôi khi, bạn có thể muốn lập kế hoạch cho tuyến đường mà ứng dụng cung cấp cho người dùng. Sử dụng mã thông báo định tuyến từ API Tuyến đường, API ưu tiên cho tuyến đường hoặc API tối ưu hoá tuyến đường có thể giúp bạn xác định hai nội dung cho tuyến đường dự kiến:

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 hàng: Một doanh nghiệp giao đồ ăn có thể muốn giảm thiểu thời gian cần thiết để 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 hậu cầ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 nhân viên vận hành đến yêu cầu công việc.
Giảm chi phí và cải thiện sự an toàn: Một doanh nghiệp đ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 xe và tránh một số khu vực nhất định 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 đường ở Routes API (API tuyến đường) và Polylines và tuyến đường chuyển tiếp Mã thông báo trong API Tối ưu hoá tuyến đường.

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

Với mã thông báo tuyến đường từ Routes API, Route Preferred API hoặc Route Optimization API, 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 nhất có thể.
Chọn tuyến đường tốt nhất để SDK điều hướng sử dụng. Nếu bạn 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 mỗi tuyến đường đã tạo. Sau đó, bạn có thể chọn mã thông báo cho tuyến đường 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 về thời gian đế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 sẽ giúp giảm mức chênh lệ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 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

Bạn có thể sử dụng API Tuyến đường, API Ưu tiên cho tuyến đường, hoặc API Tối ưu hoá 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 về tuyến đường. Bạn có thể truyền mã thông báo tuyến đường được trả về từ bất kỳ API nào trong số này đến SDK chỉ đường để hướng dẫn cách định tuyến xe của bạn.

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

API Tuyến đường, API Ưu tiên cho Tuyến đường hoặc API Tối ưu hoá tuyến đường trả về một mã thông báo tuyến đường đã mã hoá bao gồm hình nhiều đường và mục tiêu tuyến đường.
Bạn truyền mã thông báo tuyến đến SDK Điều hướng.
SDK điều hướng truy xuất tuyến đường hoặc nếu tuyến đường chưa sẵn có do các điều kiện thay đổi, nó truy xuất tuyến phù hợp nhất.
Trong khi lái xe theo tuyến đường, nếu tình trạng giao thông hoặc các điều kiện đường khác thay đổi hoặc nếu xe đi chệ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 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ể khiến tuyến đường đã lên kế hoạch không được tuân thủ chính xác

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 để thực hiện: 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 đã lên 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ề điều kiện đường, 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 thực tế và theo kế hoạch của bạn về quãng đường và thời gian đến dự kiến, cùng các chuyến đi quan trọng khác chất lượng.

Lập kế hoạch 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 truyền mã đó đến SDK điều hướng, như mô tả trong 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 Routes API (API Tuyến đường), Routes Preferred API (API Ưu tiên tuyến) hoặc Route Optimization API (API Tối ưu hoá tuyến đường)

Yêu cầu mã thông báo tuyến bằng một trong các phương thức sau:
- Routes API (API tuyến): computeRoutes. Thông tin khác về việc yêu cầu mã thông báo tuyến đường trong API tuyến đường, hãy xem Tính toán một tuyến đường và Yêu cầu tuyến đường mã thông báo.
- API ưu tiên tuyến: computeCustomRoutes. Để biết thêm thông tin về việc yêu cầu mã thông báo tuyến đường trong API ưu tiên cho tuyến đường, hãy xem phần Lập kế hoạch tuyến đường.
- Route Optimization API: optimizeTours hoặc batchOptimizeTours. Để biết thêm thông tin về cách yêu cầu tuyến đường mã thông báo trong API Tối ưu hoá tuyến đường, hãy xem Nhiều đường chuyển tiếp và tuyến đường Mã thông báo.
Thiết lập yêu cầu API Routes hoặc API Routes Preferred để đáp ứng các yêu cầu về việc sử dụng mã thông báo tuyến:
- Đặt travel_mode thành DRIVING hoặc TWO_WHEELER
- Đặt routing_preference thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL
- KHÔNG sử dụng Via điểm tham chiếu

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

Lưu trữ mã thông báo tuyến: 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. 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",
}

Truyền mã thông báo tuyến đường đến SDK Điều hướng bằng cách sử dụng phương thức Navigator.setDestinations, chỉ định cùng một điểm trung gian đích đến 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)
      .setTravelMode(TravelMode.DRIVING)
      .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, thì hàm này 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 cách sử dụ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);

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 được tạo bởi SDK điều hướng và kế hoạch tuyến đường 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á. Xem 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 đườ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 trung gian giống như bạn đã chỉ định trong API Tuyến đường.