Định tuyến bằng mã thông báo điểm điều hướng

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

Mã thông báo điểm điều hướng cho phép bạn gửi thông tin theo bối cảnh chính về một đích đến cho Navigation SDK cho Android, Navigation SDK cho iOS hoặc Routes API để cải thiện trải nghiệm định tuyến và lái xe. Điều này hữu ích trong các trường hợp như giao đồ ăn hoặc đi chung xe, khi điểm đón hoặc trả khách có thể không rõ ràng nếu không có thông tin đầu vào của người dùng.

Để tạo và truyền mã thông báo điểm điều hướng, hãy sử dụng phương thức Destinations của Geocoding API để cho phép người dùng chọn vị trí ưu tiên trong danh sách điểm điều hướng. Lựa chọn của người dùng sẽ trở thành một điểm điều hướng do phương thức Destinations của Geocoding API trả về.

Sau đó, bạn có thể truyền mã thông báo điểm điều hướng (chứa cả toạ độ đích đến và thông tin theo bối cảnh) đến Navigation SDK cho Android hoặc Navigation SDK cho iOS, hoặc Routes API, nơi một điểm tham chiếu được tạo để định tuyến chính xác. SDK Điều hướng sẽ làm nổi bật đích đến cho người lái xe dựa trên Địa điểm mà mã thông báo được liên kết.

Ví dụ: Trường hợp sử dụng dịch vụ đi chung xe

Tổng quan

Ví dụ này minh hoạ cách kết hợp Geocoding API, Routes API và Navigation SDK cho iOS hoặc Android để tạo một ứng dụng đi chung xe có thể tính toán giá của tuyến đường và chỉ đường cho người lái xe đến đúng điểm đón.

Sau đây là các bước tổng quát:

  1. Truy xuất mã thông báo điểm điều hướng thông qua Geocoding API.
  2. Sử dụng Routes API để tính toán một tuyến đường và mã hoá tuyến đường đó trong một mã thông báo tuyến đường.
  3. Truyền cả mã thông báo điểm điều hướng và mã thông báo tuyến đường đến Navigation SDK.
  4. Sử dụng Navigation SDK để chỉ đường cho người lái xe đến đúng điểm đón.

Hãy xem phần Tài liệu đọc thêm để biết các đường liên kết đến tài liệu có liên quan về Routes API, Navigation SDK cho iOS và Navigation SDK cho Android.

Sơ đồ này cho thấy cách một ứng dụng đi chung xe hoặc giao hàng sẽ sử dụng Geocoding API, Routes API và Navigation SDK cho iOS hoặc Android để định tuyến cho người lái xe bằng mã thông báo tuyến đường và mã thông báo điểm điều hướng:

Sơ đồ trường hợp sử dụng dịch vụ đi chung xe hoặc giao hàng
Sơ đồ về trường hợp sử dụng dịch vụ đi chung xe hoặc dịch vụ giao hàng

Ví dụ về dịch vụ đi chung xe

Hãy tưởng tượng một tình huống đi chung xe, trong đó có một ứng dụng để người tiêu dùng đặt chuyến xe và một ứng dụng thứ hai để người lái xe nhận thông báo về chuyến xe và thông tin chỉ đường đến điểm đến.

Hình ảnh này minh hoạ ví dụ về một ứng dụng đi chung xe dành cho người tiêu dùng, trong đó điểm điều hướng được chọn và một ứng dụng dành cho người lái xe sử dụng Navigation SDK cho Android để định tuyến chính xác cho người lái xe.

Ví dụ về ứng dụng dành cho người tiêu dùng và ứng dụng dành cho người lái xe

Khi người tiêu dùng mở ứng dụng tiêu dùng, ứng dụng sẽ gọi phương thức Destinations của Geocoding API và cung cấp cho người tiêu dùng một lựa chọn gồm các điểm điều hướng tiềm năng:

Người tiêu dùng chọn điểm đến

Người dùng chọn điểm ưu tiên của họ, đó là một điểm trong mảng navigationPoints trong nội dung phản hồi của yêu cầu SearchDestinations:

"navigationPoints": [
    {
      "navigationPointToken": <encoded navigation point token>,
      "displayName": "South Entrance",
      "travelModes": ["DRIVE"],
      "usages": ["PICKUP","DROPOFF"],
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389
      }
    }
]

Phần phụ trợ của ứng dụng cung cấp mã thông báo điểm điều hướng cho Routes API để tính toán tuyến đường và truy xuất mã thông báo tuyến đường.

Cuối cùng, cả mã thông báo điểm điều hướng và mã thông báo tuyến đường đều được chuyển đến một ứng dụng di động dành cho người lái xe sử dụng Navigation SDK cho iOS hoặc Android để tạo một điểm tham chiếu nhằm định tuyến người lái xe đến điểm đón chính xác.

Tài liệu đọc thêm