Navigation SDK cho Android cung cấp các cách nâng cao để chỉ định điểm tham chiếu hoặc điểm đi theo chỉ dẫn, 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 các điểm đến có nhiều lối vào hoặc điểm đi theo chỉ dẫn cụ thể. Bạn có thể định tuyến đến các vị trí chính xác bằng cách sử dụng navigationPointToken, đây là một chuỗi mã hoá vị trí và bối cảnh tuyến đường bổ sung. Bạn cũng có thể kết hợp toạ độ vĩ độ và kinh độ với Mã địa điểm để có thêm bối cảnh.
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 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 một vĩ độ và kinh độ đôi khi có thể dẫn đến các điểm trả khách hoặc đón khách không tối ưu, đặc biệt là đối với các địa điểm, công viên hoặc toà nhà lớn có nhiều lối vào. Kết quả có thể khớp với đoạn đường gần nhất, nhưng có thể không phải là điểm đi theo chỉ dẫn thuận tiện hoặc chính xác nhất.
Các lựa chọn điểm tham chiếu nâng cao giải quyết vấn đề này bằng cách cho phép cung cấp thêm bối cảnh.
Sử dụng mã thông báo điểm điều hướng
Để có tuyến đường chính xác nhất đến các điểm điều hướng cụ thể như lối vào, bến bốc dỡ 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. Điểm này đại diện cho một điểm điều hướng cụ thể, có thể định tuyến và 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:
- Lấy
navigationPointTokentừ phương thức Điểm đến của phản hồi Geocoding API. - Tạo
Waypointbằng phương thứcsetNavigationPointToken()trong trình tạo.
// 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()
Sử dụng mã thông báo điểm điều hướng và mã thông báo tuyến đường
Bạn có thể truy xuất mã thông báo điểm điều hướng thông qua Geocoding API, truy xuất mã thông báo tuyến đường từ Routes API, sau đó truyền cả mã thông báo điểm điều hướng và mã thông báo tuyến đường đến SDK Điều hướng. Điều này rất hữu ích trong các trường hợp như đi chung xe hoặc giao hàng, khi bạn sử dụng Routes API để tính giá chuyến đi và muốn có độ chính xác của mã thông báo điểm điều hướng.
Với mã thông báo tuyến đường, SDK Điều hướng sẽ bắt đầu điều hướng trên cùng một tuyến đường mà bạn đã sử dụng để tính giá. Điều này giúp giảm nguy cơ sử dụng các tuyến đường dài hơn hoặc ngắn hơn cho chuyến đi, có thể gây ra tình trạng "giá tăng đột biến".
Hãy xem tài liệu về Routes API để biết thêm thông tin về cách chỉ định một vị trí bằng mã thông báo điểm đi theo chỉ dẫn và tạo mã thông báo tuyến đường. Hãy xem phần "Lên kế hoạch cho tuyến đường" để tìm hiểu cách lên kế hoạch cho tuyến đường bằng mã thông báo tuyến đường.
Sơ đồ này cho thấy cách một ứng dụng đi chung xe hoặc giao hàng sử dụng mã thông báo điểm đi theo chỉ dẫn và mã thông báo tuyến đường cùng nhau:
Kết hợp Mã địa điểm với 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 bối cảnh của địa điểm tổng thể (Mã địa điểm). Nhờ đó, SDK Điều hướng có thể 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 đến hoặc hiển thị các điểm yêu thích lân cậ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 bối cảnh để nâng cao trải nghiệm khi đế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 so vớilatlngđã cho, thìplaceIdsẽ bị bỏ qua. Trong trường hợp này, việc định tuyến sẽ chỉ tiếp tục đếnlatlngvà các tính năng nâng cao trải nghiệm đến dành riêng cho địa điểm sẽ không hoạt động.
Tóm tắt các cấu hình điểm tham chiếu hợp lệ
| Phương thức | setLatLng() |
setPlaceIdString() |
setNavigationPointToken() |
Hành vi định tuyến | Làm nổi bật đích đến |
|---|---|---|---|---|---|
| Chỉ toạ độ vĩ độ/kinh độ | tập hợp | vắng mặt | vắng mặt | Tuyến đường đến đoạn đường gần nhất với toạ độ đã xác định | Hiển thị nếu có thể suy luận điểm đến với độ tin cậy cao |
| Chỉ mã địa điểm | vắng mặt | tập hợp | vắng mặt | Tuyến đường đến điểm đi theo chỉ dẫn mặc định cho Mã địa điểm | Mã địa điểm đi |
| Chỉ mã thông báo điểm điều hướng | vắng mặt | vắng mặt | tập hợp | Tuyến đường đến điểm điều hướng chính xác được mã thông báo đại diện | Từ điểm đến được xác định trong yêu cầu phương thức điểm đến ban đầu của Geocoding API |
| Kết hợp toạ độ vĩ độ/kinh độ và Mã địa điểm | tập hợp | tập hợp | vắng mặt | Tuyến đường đến đoạn đường gần nhất với toạ độ đã xác định | Từ Mã địa điểm, mặc dù không hiển thị nếu Mã địa điểm quá xa toạ độ vĩ độ/kinh độ |