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
- Xác thực: Mã thông báo web JSON (JWT)
- Đồng thời, hãy bật: Dịch vụ Fleet Engine
- Bắt đầu: Thiết lập Consumer SDK cho iOS
- Tài liệu tham khảo: Tài liệu tham khảo về SDK Người tiêu dùng cho iOS
- Chính sách: Chính sách về SDK người tiêu dùng cho iOS
- Ghi chú phát hành: Ghi chú phát hành SDK Người tiêu dùng cho iOS
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
Consumer SDK cho iOS: sản phẩm có liên quan
- Thường dùng với: Dịch vụ Fleet Engine, Driver SDK cho iOS, Driver SDK cho Android, SDK bản đồ dành cho iOS
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
UNAUTHENTICATEDkhi 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_ARGUMENTkhi tên chuyến đi không sử dụng định dạngproviders/{provider_id}/trips/{trip_id}. Cách khắc phục: Sử dụng mã dự án trên Google Cloud làmprovider_idvà truyền cùng một mã dự án làmproviderIDkhi 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
unregisterSubscribertrê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.bundlevàGoogleRidesharingConsumer.bundlevào dự án, liên kết các khung được liệt kê và thêm-ObjCvà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ằngGMTSVehicleLocationOptions. [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.
- Thêm một bản đồ tương tác, có thể tuỳ chỉnh để theo dõi tiến trình của một chuyến đi từ Fleet Engine đến một ứng dụng di động.
- Thêm một hình nhiều đường cho tuyến đường để theo dõi chuyến đi từ Fleet Engine đến bản đồ trên trang web hoặc ứng dụng di động.
- Cập nhật tiến trình của chuyến đi dọc theo một tuyến đường trên bản đồ trong trang web hoặc ứng dụng di động cho một chuyến đi trong Fleet Engine.
- Thay đổi kiểu đường, hình nhiều đường và đa giác trên bản đồ theo dõi tiến trình của một chuyến đi từ Fleet Engine.
- Hiển thị hoặc ẩn các đối tượng trên bản đồ theo dõi tiến trình của một chuyến đi từ Fleet Engine.
- Thay đổi kiểu biểu tượng và nhãn văn bản trên bản đồ theo dõi tiến trình của một chuyến đi từ Fleet Engine.
- Áp dụng các kiểu bản đồ khác nhau cho các mức thu phóng khác nhau trên bản đồ theo dõi tiến trình của một chuyến đi từ Fleet Engine.
- Thay đổi mật độ địa điểm trên bản đồ theo dõi tiến trình của một chuyến đi từ Fleet Engine. Thử nghiệm Lưu ý: Tính năng hỗ trợ Kiểu bản đồ dựa trên đám mây trong SDK Người tiêu dùng đã được phát hành rộng rãi, trong khi tính năng kiểm soát mật độ địa điểm yêu thích là một tính năng Kiểu bản đồ dựa trên đám mây thử nghiệm (chỉ được hỗ trợ trên kiểu bản đồ sáng).
- Thay đổi kiểu của toà nhà trên bản đồ theo dõi tiến trình của một chuyến đi từ Fleet Engine. Thử nghiệm Lưu ý: Tính năng hỗ trợ Kiểu bản đồ dựa trên đám mây trong SDK Người tiêu dùng đã được phát hành rộng rãi, trong khi tính năng tuỳ chỉnh kiểu toà nhà 3D và dấu chân là một tính năng Kiểu bản đồ dựa trên đám mây thử nghiệm (chỉ được hỗ trợ trên kiểu bản đồ sáng).
- Thay đổi kiểu của các địa danh trên bản đồ theo dõi tiến trình của một chuyến đi từ Fleet Engine. Thử nghiệm Lưu ý: Tính năng hỗ trợ Tạo kiểu bản đồ dựa trên đám mây trong SDK Người tiêu dùng đã được phát hành rộng rãi, trong khi tính năng tuỳ chỉnh biểu tượng địa danh là một tính năng Tạo kiểu bản đồ dựa trên đám mây thử nghiệm (chỉ được hỗ trợ trên các kiểu bản đồ sáng).
- Tuỳ chỉnh điểm đánh dấu trên bản đồ để theo dõi tiến trình của một chuyến đi từ Fleet Engine.
- Tuỳ chỉnh hình nhiều đường của tuyến đường trên bản đồ theo dõi tiến trình của một chuyến đi từ Fleet Engine.