Tài liệu tham khảo nhanh về SDK Người tiêu dùng cho iOS

SDK Người tiêu dùng cho iOS cho phép các ứng dụng dành cho người tiêu dùng trên iOS theo dõi các chuyến đi theo yêu cầu trong Fleet Engine. Các lớp của thư viện này, chẳng hạn như GMTCTripModel và GMTCJourneySharingSession, lập mô hình dữ liệu chuyến đi và cho thấy vị trí, tuyến đường, thời gian đến dự kiến và quãng đường còn lại của xe trên bản đồ.

SDK Người tiêu dùng dành cho iOS: thông tin chính

  • Sản phẩm: SDK Người tiêu dùng dành cho iOS
  • Còn được gọi là: SDK Người tiêu dùng iOS
  • 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 Người tiêu dùng cho iOS

SDK Người tiêu dùng cho iOS: trường hợp sử dụng

Sử dụng Consumer SDK cho iOS khi:

  • Bạn cần có một ứng dụng iOS, nơi người tiêu dùng theo dõi chuyến đi hoặc chuyến giao hàng theo yêu cầu mà Fleet Engine theo dõi.
  • Bạn cần hiển thị vị trí theo thời gian thực gần đúng, tuyến đường và tình trạng giao thông theo thời gian thực của một chiếc xe trên bản đồ trong một ứng dụng iOS dành cho người tiêu dùng.
  • Bạn cần cho biết thời gian đến dự kiến (ETA) của điểm đón và điểm trả khách, cũng như quãng đường còn lại cho một chuyến đi theo yêu cầu trên iOS.
  • Bạn đã sử dụng Fleet Engine và SDK trình điều khiển cho các chuyến đi theo yêu cầu và cần có tính năng chia sẻ hành trình cho người tiêu dùng.

Không sử dụng Consumer SDK cho iOS khi:

  • Bạn cần người tiêu dùng theo dõi các nhiệm vụ hoặc lô hàng đã lên lịch; trải nghiệm của người tiêu dùng về nhiệm vụ đã lên lịch được ghi lại cho JavaScript. Hãy sử dụng JavaScript Consumer SDK.
  • Bạn cần chia sẻ tiến trình của chuyến đi theo yêu cầu trong một ứng dụng Android 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 Android.
  • Bạn cần chia sẻ tiến trình của chuyến đi theo yêu cầu trong một ứng dụng web. Hãy sử dụng SDK JavaScript cho người dùng.
  • Bạn cần gửi vị trí của tài xế và trạng thái chuyến đi từ ứng dụng iOS của tài xế đến Fleet Engine. Hãy sử dụng Driver SDK cho iOS.

SDK Người tiêu dùng dành cho iOS: thiết lập

Các gói SDK chính thức cho người tiêu dùng dành cho iOS:

  • cocoapods: GoogleRidesharingConsumer
  • swift_package: https://github.com/googlemaps/ios-consumer-sdk

SDK Người tiêu dùng cho iOS: các lỗi thường gặp

  • Vấn đề: Không giám sát được chuyến đi và gặp lỗi 401 UNAUTHENTICATED khi JWT được ký mà không có mã chuyến đi hoặc đã hết hạn. Cách khắc phục: Yêu cầu nhà cung cấp mã thông báo (GMTCAuthorization) trả về một JWT được cấp cho mã chuyến đi trong bối cảnh uỷ quyền, lưu mã đó vào bộ nhớ đệm cho mỗi chuyến đi và làm mới mã đó khi hết hạn. Xem /maps/documentation/mobility/journey-sharing/on-demand/ios/auth-sdk.
  • Vấn đề: Tính năng giám sát chuyến đi không hoạt động và trả về lỗi 400 INVALID_ARGUMENT khi tên chuyến đi không sử dụng định dạng providers/{provider_id}/trips/{trip_id}. Cách khắc phục: Sử dụng mã dự án trên Google Cloud làm provider_id và truyền cùng một mã dự án làm providerID khi bạn khởi chạy SDK. Xem /maps/documentation/mobility/journey-sharing/on-demand/ios/init-sdk.
  • Vấn đề: Ứng dụng tiếp tục theo dõi thông tin cập nhật sau khi chuyến đi hoàn tất hoặc bị huỷ. Cách khắc phục: Gọi unregisterSubscriber trên mô hình chuyến đi khi chuyến đi hoàn tất hoặc bị huỷ. Xem /maps/documentation/mobility/journey-sharing/on-demand/ios/share-journey.
  • Vấn đề: Các bản cài đặt XCFramework thủ công sẽ bỏ qua các gói tài nguyên và chế độ cài đặt bản dựng bắt buộc, trừ phi bạn thêm các gói và chế độ cài đặt đó vào Xcode. Cách khắc phục: Sử dụng CocoaPods nếu có thể. Đối với các bản cài đặt thủ công, hãy thêm gRPCCertificates.bundle và GoogleRidesharingConsumer.bundle vào dự án, liên kết các khung được liệt kê và thêm -ObjC vào Other Linker Flags (Cờ trình liên kết khác) để gỡ lỗi và phát hành. Xem /maps/documentation/mobility/journey-sharing/on-demand/ios/setup.

SDK Người tiêu dùng dành cho iOS: các tính năng cũ và không dùng nữa

  • Trình khởi chạy GMTSVehicleLocation -initWithLatLng:latLngAccuracy:heading:headingAccuracy:speed:speedAccuracy:updateTime:isSnappableToRoute:: Không dùng nữa kể từ ngày 1 tháng 6 năm 2025. Thay thế: GMTSVehicleLocation -initWithOptions: bằng GMTSVehicleLocationOptions.
  • [GMTCMapView initWithCoder]: Không dùng nữa kể từ ngày 1 tháng 12 năm 2023. Thay thế: GMTCMapView -initWithOptions:.

Những việc bạn có thể làm với SDK Người tiêu dùng 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.