SDK trình điều khiển cho iOS là một bộ công cụ ứng dụng di động và là một thành phần của Fleet Engine. SDK này gửi thông tin về vị trí xe, tuyến đường, điểm tham chiếu, quãng đường còn lại và thời gian đến dự kiến của ứng dụng dành cho tài xế từ SDK Điều hướng đến Fleet Engine, cho các chuyến đi theo yêu cầu và nhiệm vụ theo lịch.
Driver SDK cho iOS: thông tin chính
- Sản phẩm: SDK trình điều khiển cho iOS
- Còn gọi là: SDK trình điều khiển, SDK trình điều khiển cho chuyến đi theo yêu cầu, SDK trình điều khiển cho nhiệm vụ theo lịch
- Danh mục: Tuyến đường
- Nền tảng: iOS
- Chạy trên: Ứng dụng khách (mã ứng dụng hoặc trình duyệt)
- Giai đoạn ra mắt: GA
- Vòng đời: Đang hoạt động
- Tổng quan: Tổng quan về SDK trình điều khiển cho iOS
SDK Tài xế cho iOS: trường hợp sử dụng
Sử dụng SDK trình điều khiển cho iOS khi:
- Bạn cần có một ứng dụng dành cho tài xế trên iOS để gửi thông báo cập nhật vị trí của xe theo thời gian thực đến Fleet Engine.
- Bạn cần báo cáo tuyến đường, điểm tham chiếu, quãng đường còn lại và thời gian đến dự kiến từ SDK Điều hướng cho Fleet Engine.
- Bạn cần tài xế quản lý các chuyến đi theo yêu cầu được chỉ định và di chuyển trong một ứng dụng mà không cần chuyển đổi ứng dụng.
- Bạn đang tạo một ứng dụng dành cho tài xế cho các nhiệm vụ theo lịch của Fleet Engine trên iOS.
Không sử dụng SDK Tài xế cho iOS khi:
- Bạn chỉ cần tính năng đường đi từng chặng trong ứng dụng iOS mà không cần tính năng theo dõi của Fleet Engine. Thay vào đó, hãy sử dụng Navigation SDK cho iOS.
- Bạn cần cho hành khách hoặc khách hàng biết tiến trình của chuyến đi hoặc việc giao hàng trong một ứng dụng dành cho người tiêu dùng. Hãy sử dụng SDK dành cho người tiêu dùng cho iOS.
- Bạn cần gửi thông tin cập nhật về dữ liệu xe ngoài vị trí và tuyến đường; những thông tin này sẽ được gửi qua phần phụ trợ của bạn đến Fleet Engine. Hãy sử dụng Dịch vụ Fleet Engine.
- Ứng dụng của tài xế chạy trên Android. Hãy sử dụng Driver SDK cho Android.
SDK trình điều khiển cho iOS: thiết lập
- Xác thực: Khoá API, Mã thông báo web JSON (JWT)
- Đồng thời, hãy bật: SDK Maps dành cho iOS
- Bắt đầu: Thiết lập SDK Tài xế cho iOS
- Tài liệu tham khảo: Tài liệu tham khảo về SDK trình điều khiển cho iOS
- Chính sách: Chính sách về SDK Tài xế cho iOS
- Ghi chú phát hành: Ghi chú phát hành SDK Tài xế cho iOS
Các gói SDK chính thức cho trình điều khiển iOS:
- cocoapods:
GoogleRidesharingDriver - swift_package:
https://github.com/googlemaps/ios-driver-sdk
Driver SDK cho iOS: sản phẩm có liên quan
- Thường dùng với: SDK chỉ đường cho iOS, Dịch vụ Fleet Engine, SDK người tiêu dùng cho iOS
SDK Trình điều khiển cho iOS: các lỗi thường gặp
- Vấn đề: Lần cập nhật xe đầu tiên sau khi khởi động có thể không thành công và xuất hiện thông báo "update_mask cannot be empty" (update_mask không được để trống) khi tham số
updateMasktrống. Cách khắc phục: Luôn cung cấp ít nhất một tên trường trongupdateMaskvà xử lý lỗi này trongGMTDVehicleReporterListenerdidFailVehicleUpdate. Xem /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot. - Vấn đề:
GMSRoadSnappedLocationProviderkhông tiếp tục gửi thông báo cập nhật vị trí khi thiết bị không di chuyển kể từ lần cập nhật gần nhất, chẳng hạn như khi tài xế đang chờ. Cách khắc phục: Để gửi thông báo cập nhật vị trí mới trong khi thiết bị không di chuyển, hãy dừng rồi bắt đầuGMSRoadSnappedLocationProvider(vớiGMTDVehicleReporterđã được thêm làm trình nghe). Xem /maps/documentation/mobility/driver-sdk/on-demand/ios/vehicle-ready. - Vấn đề: Ứng dụng dành cho người tiêu dùng không hiển thị chính xác chuyến đi nếu toạ độ được truyền đến
setDestinations()không khớp với điểm tham chiếu của chuyến đi. Cách khắc phục: Đảm bảo vĩ độ/kinh độ được truyền đếnsetDestinations()khớp với toạ độ điểm tham chiếu của chuyến đi trong Fleet Engine. Xem /maps/documentation/mobility/driver-sdk/on-demand/ios/trip-details. - Vấn đề: Việc sử dụng toán tử phiên bản lạc quan (
~>) có thể dẫn đến các bản dựng không thể dự đoán và không thể lặp lại, đồng thời việc bỏ qua một phiên bản sẽ tải SDK mới nhất, có thể bao gồm các thay đổi có thể gây lỗi hoặc tăng phiên bản iOS tối thiểu. Carthage không được hỗ trợ. Cách khắc phục: Ghim một phiên bản SDK trình điều khiển chính xác trong CocoaPods hoặc Trình quản lý gói Swift, đồng thời kiểm tra ghi chú phát hành trước khi nâng cấp. Xem /maps/documentation/mobility/driver-sdk/on-demand/ios/versions.
SDK Trình điều khiển cho iOS: các tính năng cũ và không dùng nữa
- Lớp
GMTSVehicleMatch: Không dùng nữa. Thay thế: Không cần thay thế trong SDK Trình điều khiển (việc so khớp xe được xử lý trong Fleet Engine). Triệu chứng: Không còn được dùng trong SDK trình điều khiển cho iOS phiên bản 2.2.0 và bị bỏ qua trong tài liệu tham khảo hiện tại về SDK trình điều khiển. Xem hướng dẫn di chuyển. GMTSServiceTypevàfetchAuthTokenForServiceType:authorizationContext:completion:: Không dùng nữa kể từ ngày 29 tháng 11 năm 2021. Thay thế:GMTDAuthorizationfetchTokenWithContext:completion:bằngGMTDAuthorizationContext(chỉ dành cho thông báo xác nhận quyền sở hữu mã xe). Xem hướng dẫn di chuyển.
Những việc bạn có thể làm với SDK Tài xế dành cho iOS
Hãy xem hướng dẫn được liên kết bên dưới cho từng nhiệm vụ hoặc so sánh giữa các sản phẩm trong Trình khám phá chức năng.
- Báo cáo vị trí theo thời gian thực của xe cho dịch vụ Fleet Engine.
- Báo cáo toạ độ vĩ độ/kinh độ của các điểm tham chiếu trong chuyến đi của xe từ SDK Điều hướng đến dịch vụ Fleet Engine.
- Báo cáo quãng đường còn lại của xe đến điểm tham chiếu tiếp theo cho dịch vụ Fleet Engine.
- Báo cáo thời gian đến dự kiến của một chiếc xe tại điểm tham chiếu tiếp theo cho dịch vụ Fleet Engine.
- Báo cáo tuyến đường do SDK Điều hướng cung cấp cho một xe đến dịch vụ Fleet Engine.