Bật nguồn cấp dữ liệu từng chặng

Nguồn cấp dữ liệu chỉ đường từng chặng chỉ cung cấp thông tin chỉ đường cho những thiết bị không được thiết kế để hướng dẫn chỉ đường dựa trên bản đồ. Nguồn cấp này đưa ra các thao tác sắp tới với những phần tử mà bạn cung cấp:

  • biểu tượng (trái, phải, quay đầu)
  • số rẽ trong bùng binh
  • tên đường
  • khoảng cách và thời gian ước tính đến bước dẫn đường tiếp theo hoặc điểm đến cuối cùng

Bạn có thể sử dụng nguồn cấp dữ liệu từng chặng để tạo trải nghiệm khi giao diện người dùng đầy đủ của SDK Điều hướng không phù hợp, chẳng hạn như cho Android Auto hoặc cho màn hình nhỏ không có ngăn xếp Android đầy đủ. Ví dụ: bạn có thể sử dụng tính năng này cho người lái xe hai bánh, trong đó bạn có thể chiếu thông tin chỉ đường để giúp họ đến đích nhanh hơn và tự tin hơn mà không bị phân tâm.

Để sử dụng SDK, bạn sẽ tạo một dịch vụ và đăng ký dịch vụ đó với SDK Điều hướng cho Android để dịch vụ này có thể nhận thông tin điều hướng mới theo thời gian thực (khoảng một lần mỗi giây trong quá trình điều hướng).

Tài liệu này hướng dẫn bạn cách tạo và đăng ký một dịch vụ chỉ đường nhận thông tin chỉ đường từ SDK và cung cấp trạng thái chỉ đường cho thiết bị nhận.

Tổng quan

Phần này tóm tắt quy trình cấp cao để bật tính năng chỉ đường từng chặng.

Sử dụng tính năng TurnByTurn

Sau đây là các bước cấp cao để bật tính năng chỉ đường từng chặng. Các phần sau đây cung cấp thông tin chi tiết về từng bước.

  1. Tạo một dịch vụ để nhận thông tin cập nhật về hoạt động đi theo chỉ dẫn.

  2. Đăng ký dịch vụ.

  3. Tìm hiểu về trạng thái điều hướng.

Tạo một dịch vụ để nhận thông tin cập nhật về hoạt động đi theo chỉ dẫn

Navigation SDK liên kết với dịch vụ TurnByTurn và gửi thông tin cập nhật về hoạt động đi theo chỉ dẫn cho dịch vụ này thông qua Android Messenger. Bạn có thể tạo một dịch vụ điều hướng mới cho những nội dung cập nhật này hoặc sử dụng một dịch vụ hiện có.

Lợi ích của việc sử dụng dịch vụ để nhận thông tin cập nhật về hoạt động chỉ đường là dịch vụ này có thể hoạt động trong một tiến trình nền riêng biệt.

Dịch vụ trong ví dụ sau đây nhận thông tin chỉ đường và sử dụng TurnByTurnManager để chuyển đổi dữ liệu thành đối tượng NavInfo chứa thông tin chỉ đường.

/**
 *   Receives turn-by-turn navigation information forwarded from NavSDK.
 */
public class NavInfoReceivingService extends Service {
  /** The messenger used by the service to receive nav step updates. */
  private Messenger incomingMessenger;
  private TurnByTurnManager turnByTurnManager;

  private final class IncomingNavStepHandler extends Handler {
    public IncomingNavStepHandler(Looper looper) {
      super(looper);
    }

    @Override
    public void handleMessage(Message msg) {
      // Identify the message through the msg.what field.
      if (TurnByTurnManager.MSG_NAV_INFO == msg.what) {
        // Extract the NavInfo object using the TurnByTurnManager.
        NavInfo navInfo = turnByTurnManager
          .readNavInfoFromBundle(msg.getData()));
      // Do something with the NavInfo
    }
  }
}

@Nullable
@Override
public IBinder onBind(Intent intent) {
  return incomingMessenger.getBinder();
}

@Override
public void onCreate() {
  turnByTurnManager = TurnByTurnManager.createInstance();
  HandlerThread thread =
    new HandlerThread("NavInfoReceivingService",
      Process.THREAD_PRIORITY_DEFAULT);
  thread.start();
  incomingMessenger = new Messenger(
    new IncomingNavStepHandler(thread.getLooper()));
}

Mã thông báo

Bạn có thể xác định thông báo NavInfo thông qua trường Message.what của lớp Message, được đặt thành giá trị của TurnByTurnManager.MSG_NAV_INFO.

Đăng ký dịch vụ để nhận thông tin cập nhật về hoạt động đi theo chỉ dẫn

Các đoạn mã sau đây đăng ký dịch vụ điều hướng.

boolean isNavInfoReceivingServiceRegistered =
          navigator.registerServiceForNavUpdates(
              getPackageName(), NavInfoReceivingService.class.getName(), numNextStepsToPreview);

Bắt đầu và dừng dịch vụ

Dịch vụ chỉ đường sẽ hoạt động miễn là SDK chỉ đường liên kết với dịch vụ đó. Bạn có thể gọi startService() và stopService() theo cách thủ công để kiểm soát vòng đời của dịch vụ chỉ đường, nhưng khi bạn đăng ký dịch vụ của mình với SDK Chỉ đường, dịch vụ của bạn sẽ tự động bắt đầu và chỉ dừng khi bạn huỷ đăng ký. Tuỳ thuộc vào cách thiết lập ứng dụng, bạn có thể cân nhắc bắt đầu một dịch vụ trên nền trước, được mô tả trong tài liệu Android Tổng quan về dịch vụ.

Huỷ đăng ký dịch vụ

Để ngừng nhận thông tin cập nhật về hoạt động đi theo chỉ dẫn, hãy huỷ đăng ký dịch vụ khỏi SDK Điều hướng.

navigator.unregisterServiceForNavUpdates();

Tìm hiểu về trạng thái chỉ đường

Sử dụng NavInfo.getNavState() để lấy trạng thái hiện tại của hoạt động chỉ đường, là một trong những trạng thái sau:

  • Đang trên đường – Trạng thái ENROUTE có nghĩa là chế độ chỉ đường có chỉ dẫn đang hoạt động và người dùng đang đi trên tuyến đường được cung cấp. Thông tin về bước thao tác sắp tới hiện đã có.

  • Đang đổi tuyến đường – REROUTING có nghĩa là quá trình chỉ đường đang diễn ra, nhưng công cụ chỉ đường đang tìm kiếm một tuyến đường mới. Chưa có bước thao tác sắp tới vì chưa có tuyến đường mới. Trong ứng dụng mẫu, thông báo "Đang đổi tuyến đường..." sẽ xuất hiện trong màn hình thông tin chỉ đường. Sau khi tìm thấy tuyến đường, một thông báo NavInfo sẽ được gửi kèm theo trạng thái ENROUTE.

  • Đã dừng – STOPPED có nghĩa là bạn đã kết thúc chế độ chỉ đường. Ví dụ: quá trình chỉ đường sẽ dừng khi người dùng thoát khỏi chế độ chỉ đường trong ứng dụng. Trong ứng dụng mẫu, trạng thái STOPPED sẽ xoá màn hình hiển thị thông tin chỉ đường để không cho các chỉ dẫn bị lưu lại xuất hiện.

Điền vào màn hình nguồn cấp dữ liệu

Giờ đây, khi đã thiết lập dịch vụ chỉ đường từng chặng, bạn có thể sử dụng các phần tử hình ảnh và phần tử văn bản trong phần này để điền thông tin vào thẻ hướng dẫn cho nguồn cấp dữ liệu chỉ đường từng chặng.

Màn hình thiết bị di động hiển thị thông tin về một ngã rẽ trái sắp tới sau 100 feet vào đường W Ahwanee. Ở cuối màn hình, thời gian còn lại để đến đích là 46 phút và khoảng cách còn lại là 39 dặm.

Khi người dùng chuyển sang chế độ chỉ đường, một thẻ chỉ đường sẽ xuất hiện ở trên cùng, chứa dữ liệu chỉ đường được điền sẵn từ Navigation SDK. Hình ảnh liên quan cho thấy một ví dụ về các phần tử chỉ đường thiết yếu này.

Bảng này cho biết các trường thông tin về thông tin chỉ đường và nơi bạn có thể tìm thấy các trường đó.

Các trường cho từng bước điều hướng Các trường cho toàn bộ chuyến đi
Tìm thấy trong StepInfo Tìm thấy trong NavInfo
Tên đường đầy đủ Thời gian còn lại
Biểu tượng thao tác Khoảng cách đến điểm đến
Khoảng cách đến bước tiếp theo
Trường hướng dẫn làn đường

Hướng dẫn làn đường

Navigation SDK biểu thị các làn đường trong thẻ rẽ khi chỉ đường dưới dạng các đối tượng dữ liệu Lane và LaneDirection. Đối tượng Lane đại diện cho một làn đường cụ thể trong quá trình chỉ đường và có một danh sách các đối tượng LaneDirection mô tả tất cả các lượt rẽ có thể thực hiện từ làn đường này.

Cấu hình hướng dẫn làn đường mẫu.

Hướng đi mà người dùng nên chọn trong một làn đường được đánh dấu bằng trường isRecommended.

Ví dụ về hướng dẫn làn đường

Đoạn mã sau đây minh hoạ cách biểu thị dữ liệu của các làn đường hiển thị ở trên.

// Lane 1
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false},
                  {/*laneShape=*/ SLIGHT_LEFT, /*isRecommended=*/ true}]

// Lane 2
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false}]

Tạo biểu tượng cho các thao tác

Enum Maneuver xác định từng thao tác có thể xảy ra trong khi chỉ đường và bạn có thể nhận được thao tác cho một bước nhất định từ phương thức StepInfo.getManeuver().

Bạn phải tạo biểu tượng thao tác và ghép nối các biểu tượng đó với thao tác liên quan. Đối với một số thao tác, bạn có thể thiết lập mối liên kết một-một với một biểu tượng, chẳng hạn như DESTINATION_LEFT và DESTINATION_RIGHT. Tuy nhiên, vì một số thao tác tương tự nhau, nên bạn có thể muốn liên kết nhiều thao tác với một biểu tượng. Ví dụ: TURN_LEFT và ON_RAMP_LEFT đều có thể liên kết với biểu tượng rẽ trái.

Một số thao tác có thêm nhãn clockwise hoặc counterclockwise, mà SDK xác định dựa trên bên lái xe của một quốc gia. Ví dụ: ở những quốc gia lái xe bên trái đường, người lái xe sẽ đi vào vòng xuyến hoặc quay đầu xe theo chiều kim đồng hồ, trong khi ở những quốc gia lái xe bên phải đường, người lái xe sẽ đi theo chiều kim đồng hồ. SDK Điều hướng phát hiện xem một thao tác có xảy ra trong luồng giao thông bên trái hay bên phải hay không và đưa ra thao tác thích hợp. Do đó, biểu tượng thao tác của bạn có thể khác nhau đối với thao tác theo chiều kim đồng hồ và ngược chiều kim đồng hồ.

Mở rộng để xem các biểu tượng mẫu cho nhiều thao tác

Biểu tượng mẫu Thao tác từng chặng
DEPART
UNKNOWN
STRAIGHT
ON_RAMP_UNSPECIFIED
OFF_RAMP_UNSPECIFIED
NAME_CHANGE
TURN_RIGHT
ON_RAMP_RIGHT
TURN_LEFT
ON_RAMP_LEFT
TURN_SLIGHT_RIGHT
ON_RAMP_SLIGHT_RIGHT
OFF_RAMP_SLIGHT_RIGHT
TURN_SLIGHT_LEFT
ON_RAMP_SLIGHT_LEFT
OFF_RAMP_SLIGHT_LEFT
TURN_SHARP_RIGHT
ON_RAMP_SHARP_RIGHT
OFF_RAMP_SHARP_RIGHT
TURN_SHARP_LEFT
ON_RAMP_SHARP_LEFT
OFF_RAMP_SHARP_LEFT
TURN_U_TURN_COUNTERCLOCKWISE
ON_RAMP_U_TURN_COUNTERCLOCKWISE
OFF_RAMP_U_TURN_COUNTERCLOCKWISE
TURN_U_TURN_CLOCKWISE
ON_RAMP_U_TURN_CLOCKWISE
OFF_RAMP_U_TURN_CLOCKWISE
ROUNDABOUT_SHARP_RIGHT_COUNTERCLOCKWISE
ROUNDABOUT_SHARP_RIGHT_CLOCKWISE
ROUNDABOUT_RIGHT_COUNTERCLOCKWISE
ROUNDABOUT_RIGHT_CLOCKWISE
ROUNDABOUT_SLIGHT_RIGHT_COUNTERCLOCKWISE
ROUNDABOUT_SLIGHT_RIGHT_CLOCKWISE
ROUNDABOUT_STRAIGHT_COUNTERCLOCKWISE
ROUNDABOUT_STRAIGHT_CLOCKWISE
ROUNDABOUT_SLIGHT_LEFT_COUNTERCLOCKWISE
ROUNDABOUT_SLIGHT_LEFT_CLOCKWISE
ROUNDABOUT_LEFT_COUNTERCLOCKWISE
ROUNDABOUT_LEFT_CLOCKWISE
ROUNDABOUT_SHARP_LEFT_COUNTERCLOCKWISE
ROUNDABOUT_SHARP_LEFT_CLOCKWISE
ROUNDABOUT_U_TURN_COUNTERCLOCKWISE
ROUNDABOUT_U_TURN_CLOCKWISE
ROUNDABOUT_COUNTERCLOCKWISE
ROUNDABOUT_CLOCKWISE
ROUNDABOUT_EXIT_COUNTERCLOCKWISE
ROUNDABOUT_EXIT_CLOCKWISE
MERGE_RIGHT
OFF_RAMP_RIGHT
MERGE_LEFT
OFF_RAMP_LEFT
FORK_RIGHT
TURN_KEEP_RIGHT
ON_RAMP_KEEP_RIGHT
OFF_RAMP_KEEP_RIGHT
FORK_LEFT
TURN_KEEP_LEFT
ON_RAMP_KEEP_LEFT
OFF_RAMP_KEEP_LEFT
MERGE_UNSPECIFIED
DESTINATION
DESTINATION_RIGHT
DESTINATION_LEFT
FERRY_BOAT
FERRY_TRAIN

Sử dụng biểu tượng được tạo

Một danh sách nhỏ các biểu tượng được tạo do Navigation SDK cung cấp.

Để hỗ trợ các trường hợp sử dụng Android Auto, Navigation SDK hỗ trợ việc tạo biểu tượng hướng dẫn thao tác và làn đường. Các biểu tượng này phù hợp với hướng dẫn về kích thước hình ảnh của Thư viện ứng dụng cho ô tô của Android Auto, trong đó đề xuất nhắm đến hộp giới hạn 500 x 74 dp. Xem setsLaneImage và CarIcon trong tài liệu tham khảo về Android để biết thông tin chi tiết.

Ví dụ về quá trình tạo biểu tượng

NavigationUpdatesOptions options =
  NavigationUpdatesOptions.builder()
             .setNumNextStepsToPreview(numNextStepsToPreview)
             .setGeneratedStepImagesType(GeneratedStepImagesType.BITMAP)
             .setDisplayMetrics(getResources().getDisplayMetrics())
             .build();
boolean isRegistered =
          navigator.registerServiceForNavUpdates(
              getPackageName(),
              NavInfoReceivingService.class.getName(),
              options);

Sau khi bạn bật tính năng tạo biểu tượng, đối tượng StepInfo TurnbyTurn sẽ điền các biểu tượng vào trường maneuverBitmap và lanesBitmap.

Bước tiếp theo