Chỉ đường đến các điểm điều hướng

Navigation SDK dành cho Android cung cấp các cách nâng cao để chỉ định điểm tham chiếu, giúp định tuyến chính xác hơn và mang lại trải nghiệm đến nơi tốt hơn, đặc biệt là đối với những điểm đến có nhiều lối vào hoặc điểm điều hướng cụ thể. Bạn có thể định tuyến đến các vị trí chính xác bằng navigationPointToken hoặc bằng cách kết hợp toạ độ vĩ độ và kinh độ với Mã địa điểm để thêm ngữ cảnh. Tính năng làm nổi bật điểm đến sẽ tiếp tục được thực hiện nếu có thể.

Thông tin khái quát

Trước phiên bản 7.4, bạn có thể xác định Waypoint bằng cách sử dụng toạ độ vĩ độ và kinh độ hoặc Mã địa điểm. Mặc dù đôi khi có hiệu quả, nhưng việc chỉ định tuyến đến vĩ độ và kinh độ đôi khi có thể dẫn đến các điểm dừng hoặc điểm đón không tối ưu, đặc biệt là đối với các địa điểm lớn, công viên hoặc toà nhà có nhiều lối vào. Kết quả có thể bám theo đoạn đường gần nhất, có thể không phải là điểm điều hướng thuận tiện hoặc chính xác nhất.

Các lựa chọn nâng cao về điểm tham chiếu giải quyết vấn đề này bằng cách cho phép cung cấp thêm ngữ cảnh.

Sử dụng mã thông báo điểm điều hướng

Để định tuyến chính xác nhất đến các điểm điều hướng cụ thể như lối vào, bến tải hàng hoặc khu vực đón khách được chỉ định, bạn có thể sử dụng navigationPointToken. Bạn có thể lấy mã thông báo này bằng cách gọi phương thức destinations của Geocoding API. Mã thông báo này đại diện cho một điểm điều hướng cụ thể, có thể định tuyến được liên kết với một địa điểm.

Cách chỉ định mã thông báo Điểm điều hướng:

1. Lấy navigationPointToken từ phương thức Destinations của phản hồi Geocoding API.
2. Tạo Waypoint bằng phương thức setNavigationPointToken() trong trình tạo.

Lưu ý: Khi sử dụng setNavigationPointToken(), bạn không thể đồng thời sử dụng setLatLng() hoặc setPlaceIdString(). Các phương thức này loại trừ lẫn nhau với setNavigationPointToken().

// Assuming 'navPointToken' is a String obtained from the destinations method of the Geocoding API
// Assuming 'destinationName' is a String title for the waypoint

Waypoint waypointWithToken = Waypoint.builder()
    .setTitle(destinationName)
    .setNavigationPointToken(navPointToken)
    .build();

// Use this waypoint in navigator.setDestinations()

Kết hợp Mã địa điểm và vĩ độ và kinh độ

Kể từ phiên bản 7.4, bạn có thể cung cấp cả Mã địa điểm và toạ độ vĩ độ và kinh độ khi tạo Waypoint. Phương thức này hữu ích khi bạn muốn chỉ định một điểm chính xác (vĩ độ/kinh độ) trong khi vẫn cung cấp ngữ cảnh của địa điểm tổng thể (Mã địa điểm). Điều này cho phép Navigation SDK mang lại trải nghiệm đến nơi phong phú hơn bằng cách làm nổi bật toà nhà đích hoặc hiển thị các điểm tham quan gần đó liên quan đến Mã địa điểm.

// Assuming 'placeId' is the Place ID String
// Assuming 'lat' and 'lng' are the double values for latitude and longitude
// Assuming 'destinationName' is a String title for the waypoint

Waypoint waypointWithPlaceIdAndLatLng = Waypoint.builder()
    .setTitle(destinationName)
    .setPlaceIdString(placeId)
    .setLatLng(lat, lng)
    .build();

// Use this waypoint in navigator.setDestinations()

Lưu ý

Khi bạn cung cấp cả placeId và latlng:

• Tuyến đường chủ yếu nhắm đến latlng được chỉ định.
• placeId được dùng làm ngữ cảnh để nâng cao trải nghiệm đến nơi.
• Dự phòng: Nếu SDK xác định rằng placeId được cung cấp tương ứng với một tính năng quá xa latlng đã cho, thì placeId sẽ bị bỏ qua. Trong trường hợp này, quá trình định tuyến sẽ chỉ diễn ra đến latlng và các tính năng nâng cao trải nghiệm đến nơi dành riêng cho địa điểm sẽ không có sẵn.

Tóm tắt các cấu hình điểm tham chiếu hợp lệ