Tổng quan về Navigation Connect API

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

Navigation Connect API là một dịch vụ kết nối việc sử dụng tính năng chỉ đường của Google Maps và Waze với hệ thống doanh nghiệp của bạn. Dịch vụ này sử dụng mã thông báo uỷ quyền chuyến đi cùng với một đường liên kết sâu trong ứng dụng của bạn, để tài xế có thể nhấn vào một đường liên kết hoặc nút để bắt đầu chỉ đường trong ứng dụng tiêu dùng mà họ chọn. Trong khi tài xế đang đi theo chỉ dẫn trong chuyến đi, bạn có thể nhận dữ liệu vị trí theo thời gian thực liên tục, chẳng hạn như vị trí trực tiếp, thời gian đến dự kiến (ETA) có độ chính xác cao và trạng thái vòng đời chuyến đi.

Navigation Connect API cung cấp một giải pháp thay thế gọn nhẹ cho Navigation SDK bằng cách sử dụng các ứng dụng Google Maps và Waze độc lập để định tuyến thay vì yêu cầu bạn xây dựng và nhúng một giao diện chỉ đường tuỳ chỉnh vào ứng dụng của mình. Dịch vụ này liên kết an toàn phiên của tài xế trở lại phần phụ trợ của bạn. Khi bắt đầu một chuyến đi, tài xế sẽ thấy giao diện chỉ đường quen thuộc với hai điểm bổ sung: lời nhắc đồng ý chia sẻ dữ liệu chuyến đi (bắt buộc 12 tháng một lần) và nút quay lại có thương hiệu để quay lại ứng dụng của bạn.

Lý do bạn nên sử dụng Navigation Connect API

Với Navigation Connect API, bạn có thể tích hợp thông tin vị trí chuyến đi và thông tin cập nhật về ETA theo thời gian thực từ Google Maps hoặc Waze trực tiếp vào các quy trình phụ trợ của mình. Điều này giúp bạn đưa ra các quyết định kinh doanh quan trọng và chia sẻ thông tin cập nhật chính xác với khách hàng, trong khi tài xế sử dụng ứng dụng chỉ đường mà họ thích, Google Maps hoặc Waze.

Dưới đây là các ví dụ về trường hợp sử dụng:

  • Tăng tính minh bạch cho dịch vụ đi chung xe: Cung cấp cho khách hàng và hành khách đi chung xe thông tin cập nhật chính xác theo thời gian thực về vị trí của tài xế và thời gian đến dự kiến.
  • Cải thiện tính năng theo dõi giao hàng: Thông báo cho khách hàng về thời gian giao hàng hoặc giao đồ ăn chính xác dựa trên dữ liệu giao thông và định tuyến trực tiếp.
  • Cải thiện việc quản lý và điều phối đội xe: Đưa ra quyết định điều phối sáng suốt cho đội xe hoặc lực lượng lao động di động cung cấp các dịch vụ theo yêu cầu (chẳng hạn như hỗ trợ khi xe hỏng, bảo trì hoặc vận chuyển) bằng cách theo dõi vị trí trực tiếp của tài xế.

Những việc bạn có thể làm với Navigation Connect API

Navigation Connect API cho phép bạn nhận thông tin vị trí theo thời gian thực và Giờ đến dự kiến từ Google Maps hoặc Waze trực tiếp trong phần phụ trợ của mình.

  • Theo dõi chuyến đi một cách không xâm phạm: Theo dõi chuyến đi mà không thay đổi lựa chọn của tài xế về việc sử dụng Google Maps hoặc Waze hay sửa đổi trải nghiệm người dùng của họ.
  • Truy cập vào dữ liệu vị trí theo thời gian thực: Liên tục nhận thông tin vị trí của tài xế theo thời gian thực, quãng đường còn lại và thời gian đã trôi qua trong suốt chuyến đi.
  • Theo dõi vòng đời chuyến đi: Định cấu hình tần suất cập nhật cho dữ liệu chuyến đi để theo dõi chính xác trạng thái của chuyến đi và biết ngay khi tài xế đang trên đường, đã đến hoặc tạm dừng chuyến đi.
  • Sử dụng và chia sẻ ETA: Truy xuất thông tin cập nhật về ETA có độ chính xác cao nhờ các thuật toán định tuyến trực tiếp của Google.
  • Theo dõi tuyến đường và tình trạng giao thông còn lại (chỉ Waze): Nhận đường nhiều đoạn đang hoạt động và tình trạng giao thông theo thời gian thực từ vị trí hiện tại của tài xế đến điểm đến cuối cùng, giống hệt như trong Waze.
    • Cắt bớt động: Khi xe di chuyển, Navigation Connect sẽ tự động cắt bớt đường nhiều đoạn đang hoạt động để đảm bảo bạn chỉ nhận được phần còn lại của chuyến đi.
    • Tần suất cập nhật: Tuyến đường và tình trạng giao thông sẽ tự động cập nhật khi tính toán lại tuyến đường, chủ động định tuyến lại phía máy khách hoặc thay đổi tình trạng giao thông.
  • Tiếp nhận dữ liệu một cách linh hoạt: Sử dụng dữ liệu chuyến đi theo thời gian thực bằng cách sử dụng các lệnh gọi API REST trực tiếp hoặc truyền phát thông tin cập nhật một cách hiệu quả bằng cách sử dụng gói thuê bao Google Cloud Pub/Sub.

Cách hoạt động của Navigation Connect API

Navigation Connect API chấp nhận yêu cầu CreateTrip chứa giá trị nhận dạng ứng dụng di động và cấu hình phiên của bạn. Dịch vụ này tạo một thực thể chuyến đi duy nhất và trả về một mã thông báo chuyến đi. Sau đó, mã thông báo này sẽ được thêm vào một đường liên kết sâu của Google Maps hoặc Waze. Sau khi tài xế khởi chạy tính năng chỉ đường và cấp quyền đồng ý, dịch vụ này sẽ xử lý dữ liệu về lộ trình di chuyển theo thời gian thực và trả về thông tin cập nhật về đo từ xa, bao gồm vị trí, Giờ đến dự kiến và quãng đường còn lại.

Tài nguyên

Bảng sau đây tóm tắt các tài nguyên có sẵn thông qua Navigation Connect API cùng với dữ liệu mà API này trả về. Để biết thông tin chi tiết cụ thể, hãy xem tài liệu tham khảo về Navigation Connect API.

Tài nguyên dữ liệu Dữ liệu được trả về

Giá trị nhận dạng ứng dụng di động và thông tin xác thực ở định dạng JSON.

Xem bài viết Tạo chuyến đi.

Một mã thông báo chuyến đi duy nhất dùng để khởi chạy kết nối trong Google Maps hoặc Waze.

Xem bài viết Khởi chạy Google Maps hoặc Waze.

Mã chuyến đi duy nhất và phương thức lấy hoặc chuyển đến ở định dạng JSON.

Xem bài viết Truy xuất dữ liệu chuyến đi.

Dữ liệu đo từ xa chuyến đi theo thời gian thực, bao gồm:

  • Trạng thái và siêu dữ liệu chuyến đi
  • Vị trí hiện tại (vĩ độ/kinh độ)
  • Thời gian đến dự kiến (ETA)
  • Quãng đường và thời gian còn lại

Xem bài viết Xử lý dữ liệu chuyến đi.

Cách sử dụng Navigation Connect API

1 Thiết lập Bắt đầu bằng cách Thiết lập dự án trên Google Cloud và hoàn tất các hướng dẫn tiếp theo.
2 Tạo chuyến đi Gửi lệnh gọi Navigation Connect API để tạo chuyến đi có mã nhận dạng duy nhất và lưu mã thông báo.
3 Khởi chạy Google Maps hoặc Waze Chuyển mã thông báo chuyến đi và khởi chạy Google Maps hoặc Waze để bật tính năng chia sẻ dữ liệu chuyến đi.
4 Truy xuất dữ liệu chuyến đi Gửi lệnh gọi Navigation Connect API để truy xuất dữ liệu chuyến đi. Bạn có thể chọn đăng ký nhận thông tin cập nhật bằng Google Cloud Pub/Sub.
5 Xử lý dữ liệu chuyến đi Tìm hiểu cách xử lý trạng thái chuyến đi và dữ liệu chuyến đi khác.