Đị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 ngữ cảnh chính về một đích đến cho Navigation SDK cho Android để cải thiện việc định tuyến và trải nghiệm của người 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.

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

Để tạo và truyền mã thông báo điểm điều hướng, hãy sử dụng điểm cuối 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 điểm cuối 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, nơi điểm tham chiếu được tạo để định tuyến chính xác. Đích đến sẽ được Navigation SDK làm nổi bật cho người lái xe dựa trên Địa điểm mà mã thông báo được liên kết.

Cách tạo và gửi mã thông báo điểm chỉ đường đến Nav SDK để định tuyến

Ví dụ: hãy tưởng tượng một trường hợp sử dụng dịch vụ đ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 định tuyến đến đích đến.

Khi người tiêu dùng mở ứng dụng tiêu dùng, ứng dụng sẽ gọi điểm cuối 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
      }
      }
    }
]

Mã thông báo điểm điều hướng trong phản hồi được truyền đến một ứng dụng di động dành cho người lái xe sử dụng Navigation SDK cho Android để tạo một Waypoint nhằm định tuyến người lái xe đến điểm đón chính xác.