Cấu trúc và thành phần

Việc triển khai Tiến trình chuyến đi và đơn đặt hàng bao gồm xử lý một số thành phần Giải pháp gọi xe và giao hàng theo yêu cầu – Fleet Engine, Consumer SDK và Driver SDK:

  • Fleet Engine là dịch vụ phụ trợ Giải pháp gọi xe và giao hàng theo yêu cầu. Hộp cát về quyền riêng tư chịu trách nhiệm quản lý các chuyến đi và trạng thái của phương tiện. Thư viện này xử lý các giao dịch giữa SDK trình điều khiển, SDK người dùng và dịch vụ phụ trợ của bạn. Dịch vụ này có thể giao tiếp với Fleet Engine bằng cách thực hiện lệnh gọi REST hoặc gRPC.

  • SDK người dùng là một thư viện ứng dụng mà bạn tích hợp vào ứng dụng dành cho người tiêu dùng. SDK này chịu trách nhiệm trình bày trải nghiệm chia sẻ hành trình, bao gồm cả hoạt động theo dõi tuyến đường của người lái, quãng đường còn lại và giờ đến dự kiến. Consumer SDK có thể dành cho thiết bị di động (Android hoặc iOS) hoặc dành cho web (JavaScript).

  • SDK trình điều khiển là một thư viện ứng dụng khách mà bạn tích hợp vào ứng dụng dành cho người lái xe. SDK này chịu trách nhiệm cập nhật Fleet Engine về vị trí, tuyến đường, quãng đường còn lại và giờ đến dự kiến của người lái xe. Ngoài ra, SDK này cũng bao bọc SDK Điều hướng, cung cấp hướng dẫn chỉ đường từng chặng cho người lái xe. Để biết thêm thông tin, hãy xem bài viết Điều hướng bằng Google Maps.

Sơ đồ cấu trúc sau đây cho thấy mối quan hệ giữa các thành phần này:

Cấu trúc

Chuyến đi, phương tiện di chuyển và điểm tham chiếu

Việc tạo ứng dụng Tiến trình chuyến đi và đơn đặt hàng bao gồm thao tác với các chuyến đi, phương tiện di chuyển và điểm tham chiếu.

Chuyến đi

Một chuyến đi đại diện cho một hành trình – chuyến đi vận chuyển người tiêu dùng (hoặc bữa ăn mà họ đã đặt) từ một điểm đến lấy hàng đến điểm trả xe, bao gồm cả các điểm trung gian trong quá trình di chuyển.

Theo phương thức lập trình, đối tượng Trip sẽ đóng gói vị trí đón, điểm đến, vị trí hiện tại của xe, tuyến đường đi, điểm tham chiếu trung gian và loại chuyến đi (dành riêng hoặc dùng chung).

Phương tiện vận tải

Xe đại diện cho một loại xe trong nhóm thiết bị của bạn. Theo phương thức lập trình, đối tượng Vehicle sẽ đóng gói vị trí của xe, danh sách các chuyến đi hiện tại và danh sách các điểm tham chiếu hiện tại.

Điểm tham chiếu

Điểm tham chiếu biểu thị một vị trí dọc theo một tuyến đường. Đó có thể là vị trí đón khách, điểm trả khách hoặc một mốc quan trọng chỉ để đi qua. Về mặt lập trình, đối tượng Waypoint chứa vị trí của điểm tham chiếu dưới dạng tập hợp các toạ độ địa lý, loại điểm tham chiếu và giá trị nhận dạng của chuyến đi bao gồm điểm tham chiếu.

Cả chuyến đi và phương tiện đều chứa điểm tham chiếu:

  • Một tập hợp các điểm tham chiếu của chuyến đi chứa tất cả các điểm tham chiếu liên quan đến chuyến đi. Dữ liệu này có thể bao gồm các điểm tham chiếu cho các chuyến đi khác nếu một chuyến đi được chia sẻ với các chuyến đi khác.

  • Tập hợp các điểm tham chiếu của xe chứa tất cả các điểm tham chiếu còn lại cho xe, bao gồm cả các điểm tham chiếu cho nhiều chuyến đi.

Luồng mẫu

Biểu đồ sau đây cho thấy quy trình điển hình của chuyến đi và tiến trình của đơn đặt hàng. Để biết thêm thông tin, hãy xem bài viết Tạo và hiển thị một chuyến đi duy nhất.

Biểu đồ trình tự

Các bước sau đây mô tả cách thiết lập quy trình mẫu:

  1. Tạo một chiếc xe, bật tính năng chia sẻ vị trí rồi đặt trạng thái của xe thành trực tuyến. Bạn tạo phương tiện di chuyển thông qua Fleet Engine. Bạn có thể đặt trạng thái xe thành trực tuyến thông qua Fleet Engine hoặc qua Driver SDK.

  2. So khớp khách hàng với xe của bạn. Bạn có thể sử dụng phương thức SearchVehicles() để tìm danh sách xe tiềm năng trong nhóm xe của mình.

  3. Tạo một chuyến đi trong Fleet Engine, chỉ định xe cho chuyến đi đó, liên kết chuyến đi đó với ứng dụng của người tiêu dùng cũng như cung cấp cho tài xế địa điểm nhận xe và trả xe.

  4. SDK trình điều khiển sẽ tự động cập nhật thời gian đến dự kiến, khoảng cách và tuyến đường trong chuyến đi. Bạn có trách nhiệm cập nhật trạng thái của chuyến đi.

Để bắt đầu triển khai Tiến trình chuyến đi và đơn đặt hàng, hãy xem phần Tạo và hiển thị một chuyến đi một điểm đến.