Tài liệu tham khảo nhanh về SDK Trình điều khiển cho iOS

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

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

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ố updateMask trống. Cách khắc phục: Luôn cung cấp ít nhất một tên trường trong updateMask và xử lý lỗi này trong GMTDVehicleReporterListener didFailVehicleUpdate. Xem /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot.
  • Vấn đề: GMSRoadSnappedLocationProvider khô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 đầu GMSRoadSnappedLocationProvider (với GMTDVehicleReporter đã đượ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 đến setDestinations() 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.
  • GMTSServiceType và fetchAuthTokenForServiceType:authorizationContext:completion:: Không dùng nữa kể từ ngày 29 tháng 11 năm 2021. Thay thế: GMTDAuthorization fetchTokenWithContext:completion: bằng GMTDAuthorizationContext (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.