Để nhận thông tin cập nhật về dữ liệu chuyến đi từ Google Maps hoặc Waze, hãy định cấu hình phần phụ trợ bằng một trong các lựa chọn sau:
- Phương thức kéo bằng Navigation Connect API hoặc
- Phương thức đẩy dựa trên sự kiện sử dụng Google Cloud Pub/Sub.
Cách 1: Sử dụng Navigation Connect API
Để tìm nạp trạng thái chuyến đi mới nhất theo cách thủ công, hãy gọi phương thức GetTrip bằng mã chuyến đi duy nhất.
Mẫu sau đây cho biết cách gọi API từ dòng lệnh bằng cách sử dụng Thông tin xác thực mặc định của ứng dụng (ADC) để uỷ quyền cho yêu cầu giữa máy chủ với máy chủ.
#!/bin/bash
gcloud auth application-default login
access_token="$(gcloud auth application-default print-access-token)"
# Call the GetTrip method
curl -X GET "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips/TRIP_ID" \
-H "Authorization: Bearer ${access_token}" \
-H "Content-Type: application/json"
Tuỳ chỉnh định dạng hình nhiều đường
Nếu đã bật tính năng báo cáo tuyến đường còn lại trong quá trình tạo chuyến đi, bạn có thể tuỳ chỉnh cách biểu thị hình nhiều đường của tuyến đường còn lại được trả về khi gọi phương thức GetTrip.
Để chọn định dạng cho hình nhiều đường, hãy thêm tham số routePolylineFormat vào yêu cầu của bạn. Các định dạng được hỗ trợ bao gồm:
ENCODED: Chuỗi hình nhiều đường được mã hoá chuẩn (5 dấu thập phân).S2ENCODED: S2Polyline được mã hoá.GEO_JSON: Định dạng LineString GeoJSON.
Cách 2: Sử dụng Google Cloud Pub/Sub
Để nhận thông tin cập nhật thường xuyên về chuyến đi, hãy đăng ký một chủ đề Google Cloud Pub/Sub. Sau khi tài xế đồng ý, Navigation Connect sẽ gửi thông tin cập nhật trực tiếp đến chủ đề của bạn.
Để xem phần giới thiệu về tính năng nhắn tin, hãy xem phần Bắt đầu nhanh Pub/Sub.
Các phần sau đây mô tả cách sử dụng Google Cloud Pub/Sub để nhận dữ liệu từ một phiên đi theo chỉ dẫn bằng Google Maps hoặc Waze.
1. Tạo một chủ đề
Tạo một chủ đề có tên chính xác là navigation_connect_trip_notifications trong dự án trên đám mây của Google Cloud, như sau:
- Bật Pub/Sub API.
- Chuyển đến trang chủ đề Pub/Sub trong Google Cloud Console.
- Nhấp vào Tạo chủ đề.
Nhập
navigation_connect_trip_notificationsvào trường Mã chủ đề.Nhấp vào Tạo.
Bảng điều khiển hiển thị tên chủ đề đầy đủ là projects/project-number/topics/navigation_connect_trip_notifications, trong đó project-number là số dự án duy nhất của bạn.
2. Cấp quyền xuất bản cho tài khoản dịch vụ Navigation Connect
Google sử dụng một tài khoản dịch vụ để xuất bản thông tin cập nhật về chuyến đi lên các chủ đề của Google Cloud Pub/Sub. Để nhận thông tin cập nhật về chủ đề của bạn, hãy cấp quyền projects.topics.publish cho chủ đề này cho tài khoản dịch vụ sau: geo-navigation-connect-pubsub@system.gserviceaccount.com.
Để biết thêm thông tin, hãy xem tài liệu về Pub/Sub về chế độ kiểm soát quyền truy cập.
3. Tích hợp với phần phụ trợ
Để xử lý thông tin cập nhật, hãy viết một ứng dụng phía máy chủ để xác thực và đăng ký chủ đề của bạn. Sử dụng Thư viện ứng dụng Pub/Sub để đơn giản hoá quy trình phát triển. Để thử nghiệm, bạn cũng có thể sử dụng GCloud CLI và Google Console.
4. Kiểm tra gói thuê bao
Xác minh chế độ thiết lập bằng gcloud CLI hoặc Google Cloud Console.
gcloud CLI
Kéo tin nhắn từ một gói thuê bao (ví dụ: my-sub) bằng lệnh sau:
gcloud pubsub subscriptions pull my-sub --auto-ack
Google Cloud Console
Trong Google Cloud Console, hãy thực hiện các bước sau:
- Mở trang Gói thuê bao.
- Chọn gói thuê bao của bạn rồi nhấp vào thẻ Tin nhắn.
- Nhấp vào Pull (Kéo).
Bước tiếp theo
Sau khi bạn bắt đầu nhận được dữ liệu chuyến đi, hãy phân tích cú pháp dữ liệu đó để sử dụng trong hệ thống và ứng dụng của bạn.