Tổng quan và các yêu cầu về việc thiết lập

Tài liệu này giải thích quy trình thiết lập Navigation Connect API và liệt kê các yêu cầu về thiết bị của tài xế để sử dụng Navigation Connect API.

Quy trình thiết lập Navigation Connect

Trước khi có thể sử dụng Navigation Connect API, bạn phải hoàn tất các bước thiết lập sau:

  1. Tạo và định cấu hình một dự án trên Google Cloud.
  2. Bật Navigation Connect API và xác minh ứng dụng của bạn.
  3. Thiết lập OAuth để tạo mã thông báo OAuth.
  4. Thiết lập tài khoản dịch vụ để cho phép giao tiếp giữa cơ sở hạ tầng phụ trợ và Google Maps hoặc Waze.

Yêu cầu tối thiểu về thiết bị để sử dụng Navigation Connect

Tài xế phải đáp ứng các yêu cầu này để thiết bị của họ chạy thành công một phiên Navigation Connect. Một phiên sử dụng Navigation Connect API để gửi dữ liệu chuyến đi theo thời gian thực (chẳng hạn như vị trí và thời gian đến dự kiến) đến máy chủ phụ trợ của bạn.

Các phiên bản ứng dụng được hỗ trợ

Thiết bị phải cài đặt Waze phiên bản 5.15.5 trở lên hoặc Google Maps phiên bản 26.14 trở lên.

Đã bật vị trí chính xác

Nhắc tài xế bật quyền truy cập vị trí chính xác trên thiết bị của họ. Waze và Google Maps yêu cầu vị trí chính xác để bắt đầu chỉ đường.

Hộp thoại đồng ý của người lái xe.

Navigation Connect yêu cầu tài xế đồng ý chia sẻ dữ liệu chuyến đi. Bạn không cần kích hoạt hộp thoại đồng ý; Google Maps hoặc Waze sẽ tự động xử lý giao diện người dùng này.

Trong chuyến đi đầu tiên được bắt đầu từ ứng dụng của bạn, Google Maps hoặc Waze sẽ nhắc tài xế chia sẻ dữ liệu chuyến đi của họ.

  • Nếu tài xế nhấn vào Cho phép, Navigation Connect sẽ bắt đầu chia sẻ dữ liệu vị trí theo thời gian thực và Giờ đến dự kiến với phần phụ trợ của bạn.
  • Nếu tài xế nhấn vào Không cho phép hoặc thu hồi sự đồng ý sau đó, Google Maps hoặc Waze sẽ cung cấp chỉ đường từng chặng, nhưng Navigation Connect sẽ không gửi dữ liệu. Phần phụ trợ của bạn sẽ nhận được trạng thái CLIENT_ERROR trong tải trọng dữ liệu chuyến đi.

Tài xế phải xác nhận lại sự đồng ý này sau mỗi 12 tháng.

Bước tiếp theo

Bước đầu tiên để thiết lập Navigation Connect API là tạo và định cấu hình một dự án trên Google Cloud.