Đặt điểm đến cho xe

Phần này trình bày cách thiết lập điểm đến của xe sau máy chủ khớp với một chuyến đi với một chiếc xe.

Trước khi bắt đầu

Phần này yêu cầu bạn phải hoàn thành các bước sau:

• Khởi chạy SDK trình điều khiển
• Chuẩn bị xe sẵn sàng
• Tạo một chuyến đi trong Fleet Engine

Đặt điểm đến trong ứng dụng trình điều khiển

Sau khi ghép nối người tiêu dùng với người lái xe, bạn phải định cấu hình thông tin trong ứng dụng trình điều khiển bằng cách thực hiện các bước sau:

1. Truy xuất điểm đến của xe từ bộ sưu tập điểm tham chiếu trong Nhóm Engine, được GetTrip(), UpdateTrip() và GetVehicle() trả về.

2. Đặt đích đến bằng cách gọi phương thức SDK điều hướng dành cho Android setDestination().

   Lưu ý: Để ứng dụng dành cho người dùng thông thường hiển thị chính xác chuyến đi, hãy đảm bảo vĩ độ/kinh độ địa lý đã cung cấp cho setDestination() khớp với điểm tham chiếu của chuyến đi. Để biết thêm thông tin, hãy xem hướng dẫn Định tuyến đến một điểm đến và Định tuyến đến nhiều điểm đến.

Các ví dụ sau đây minh hoạ cách thiết lập điểm đến trong trình điều khiển .

Java

private void navigateToLocation(LatLng locationLatLng, RoutingOptions routingOptions) {
  Waypoint destination = Waypoint.newBuilder().setLocation(locationLatLng).build();

  // Create a future to await the result of the asynchronous navigator task.
  ListenableResultFuture<Navigator.RouteStatus> pendingRoute =
      mNavigator.setDestination(destination, travelMode);

  // Define the action to perform when the SDK has determined the route.
  pendingRoute.setOnResultListener(
      new ListenableResultFuture.OnResultListener<Navigator.RouteStatus>() {
        @Override
        public void onResult(Navigator.RouteStatus code) {
          switch (code) {
            case OK:
              // Hide the toolbar to maximize the navigation UI.
              if (getActionBar() != null) {
                getActionBar().hide();
              }

              // Enable voice audio guidance (through the device speaker).
              mNavigator.setAudioGuidance(
                  Navigator.AudioGuidance.VOICE_ALERTS_AND_GUIDANCE);

              // Simulate vehicle progress along the route for demo/debug builds.
              if (BuildConfig.DEBUG) {
                mNavigator.getSimulator().simulateLocationsAlongExistingRoute(
                    new SimulationOptions().speedMultiplier(5));
              }

              // Start turn-by-turn guidance along the current route.
              mNavigator.startGuidance();
              break;
            // Handle error conditions returned by the navigator.
            case NO_ROUTE_FOUND:
              displayMessage("Error starting navigation: No route found.");
              break;
            case NETWORK_ERROR:
              displayMessage("Error starting navigation: Network error.");
              break;
            case ROUTE_CANCELED:
              displayMessage("Error starting navigation: Route canceled.");
              break;
            default:
              displayMessage("Error starting navigation: "
                  + String.valueOf(code));
          }
        }
      });
}

Kotlin

private fun navigateToLocation(locationLatLng: LatLng, travelMode: RoutingOptions) {
  val destination = Waypoint.newBuilder().setLocation(locationLatLng).build()

  // Create a future to await the result of the asynchronous navigator task.
  val pendingRoute = mNavigator.setDestination(destination, travelMode)

  // Define the action to perform when the SDK has determined the route.
  pendingRoute.setOnResultListener(
    object : ListenableResultFuture.OnResultListener<Navigator.RouteStatus>() {
      override fun onResult(code: Navigator.RouteStatus) {
        when (code) {
          Navigator.RouteStatus.OK -> {
            // Hide the toolbar to maximize the navigation UI.
            getActionBar()?.hide()

            // Enable voice audio guidance (through the device speaker).
            mNavigator.setAudioGuidance(Navigator.AudioGuidance.VOICE_ALERTS_AND_GUIDANCE)

            // Simulate vehicle progress along the route for demo/debug builds.
            if (BuildConfig.DEBUG) {
              mNavigator
                .getSimulator()
                .simulateLocationsAlongExistingRoute(SimulationOptions().speedMultiplier(5))
            }

            // Start turn-by-turn guidance along the current route.
            mNavigator.startGuidance()
          }
          Navigator.RouteStatus.NO_ROUTE_FOUND -> {
            displayMessage("Error starting navigation: No route found.")
          }
          Navigator.RouteStatus.NETWORK_ERROR -> {
            displayMessage("Error starting navigation: Network error.")
          }
          Navigator.RouteStatus.ROUTE_CANCELED -> {
            displayMessage("Error starting navigation: Route canceled.")
          }
          else -> {
            displayMessage("Error starting navigation: ${code.name}")
          }
        }
      }
    }
  )
}