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 của 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 2 đ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 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 theo thời gian thực và thông tin cập nhật về ETA 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à ví dụ về các trường hợp sử dụng:

  • Tăng tính minh bạch của 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 quá trình 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 bị 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à thông tin cập nhật về ETA 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, khoảng cách còn lại và thời gian đã trôi qua trong suốt chuyến đi.
  • Theo dõi vòng đời của 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 còn lại 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 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 của tài xế (tuyến đường hoàn chỉnh hiện đang được chỉ đường trong ứng dụng) để đảm bảo bạn chỉ nhận được tuyến đường còn lại (đoạn đường từ vị trí hiện tại của tài xế đến điểm đến).
    • 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.
  • Nhập dữ liệu linh hoạt: Sử dụng dữ liệu chuyến đi theo thời gian thực bằng cách gọi trực tiếp API REST hoặc truyền trực tuyến 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à khoảng cách 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 theo thời gian thực của chuyến đi, bao gồm:

  • Trạng thái và siêu dữ liệu của chuyến đi
  • Vị trí hiện tại (vĩ độ/kinh độ)
  • Thời gian đến dự kiến (ETA)
  • Khoảng cách 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 sau.
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 Truyề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à các dữ liệu chuyến đi khác.