Đị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 quan trọng về một điểm đến đến Navigation SDK cho Android, Navigation SDK cho iOS hoặc Routes API để cải thiện tuyến đường và trải nghiệm của tài xế. Điều này rất hữu ích trong những 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 do người dùng nhập.

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

Sau đó, bạn có thể truyền mã thông báo điểm điều hướng (chứa cả toạ độ điểm đến cũng như 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 điểm đến cho tài xế dựa trên Địa điểm liên kết với mã thông báo.

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

Tổng quan

Ví dụ này cho thấy 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 giúp tính toán giá của tuyến đường và hướng dẫn tài xế đến đúng điểm đón.

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

  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 tuyến đường và mã hoá tuyến đường đó trong 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 SDK Điều hướng.
  4. Sử dụng SDK Điều hướng để chỉ đường cho tài xế đế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 liên quan về Routes API, SDK điều hướng cho iOS và SDK điều hướng cho Android.

Sơ đồ này cho thấy cách một ứng dụng đi chung xe hoặc giao hàng sử dụng Geocoding API, Routes API và SDK Điều hướng cho iOS hoặc Android để định tuyến cho tài xế 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 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 đi và một ứng dụng thứ hai để tài xế nhận thông báo về chuyến đi và thông tin định tuyến đến điểm đến.

Hình ảnh này cho thấy ví dụ về một ứng dụng đi chung xe dành cho người tiêu dùng, trong đó điểm đi chung xe được chọn và một ứng dụng dành cho tài xế sử dụng SDK chỉ đường cho Android để chỉ đường chính xác cho tài xế.

Ví dụ về ứng dụng dành cho người tiêu dùng và tài xế

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

Người tiêu dùng chọn điểm trả hàng

Người dùng chọn điểm mà họ muốn, tức 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 tài xế sử dụng SDK Điều hướng cho iOS hoặc Android để tạo một điểm tham chiếu nhằm định tuyến tài xế đến đúng điểm đón.

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