ข้อมูลอ้างอิงฉบับย่อของ Consumer SDK สำหรับ iOS

Consumer SDK สำหรับ iOS ช่วยให้แอปผู้บริโภค iOS ติดตามการเดินทางแบบออนดีมานด์ใน Fleet Engine ได้ คลาสต่างๆ เช่น GMTCTripModel และ GMTCJourneySharingSession จะจำลองข้อมูลการเดินทางและแสดงตำแหน่ง เส้นทาง เวลาถึงโดยประมาณ และระยะทางที่เหลือของยานพาหนะบนแผนที่

Consumer SDK สำหรับ iOS: ข้อมูลสำคัญ

  • ผลิตภัณฑ์: Consumer SDK สำหรับ iOS
  • หรือที่เรียกว่า iOS Consumer SDK
  • หมวดหมู่: เส้นทาง
  • แพลตฟอร์ม: iOS
  • ทำงานใน: ไคลเอ็นต์ (โค้ดแอปหรือเบราว์เซอร์)
  • ระยะการเปิดตัว: GA
  • วงจร: ใช้งานอยู่
  • ภาพรวม: ภาพรวม Consumer SDK สำหรับ iOS

Consumer SDK สำหรับ iOS: กรณีที่ควรใช้

ใช้ Consumer SDK สำหรับ iOS ในกรณีต่อไปนี้

  • คุณต้องมีแอป iOS ที่ผู้บริโภคติดตามการเดินทางแบบออนดีมานด์หรือการเดินทางเพื่อนำส่งที่ Fleet Engine ติดตาม
  • คุณต้องแสดงตำแหน่ง เส้นทาง และสภาพการจราจรแบบเรียลไทม์ของยานพาหนะบนแผนที่ในแอป iOS สำหรับผู้บริโภค
  • คุณต้องแสดงเวลาถึงโดยประมาณสำหรับการรับและส่งผู้โดยสาร รวมถึงระยะทางที่เหลือสำหรับการเดินทางแบบออนดีมานด์ใน iOS
  • คุณใช้ Fleet Engine และ Driver SDK สำหรับการเดินทางแบบออนดีมานด์อยู่แล้ว และต้องการการแชร์เส้นทางฝั่งผู้บริโภค

อย่าใช้ Consumer SDK สำหรับ iOS ในกรณีต่อไปนี้

  • คุณต้องให้ผู้บริโภคติดตามงานหรือการจัดส่งที่กำหนดเวลาไว้ ประสบการณ์ของผู้บริโภคเกี่ยวกับงานที่กำหนดเวลาไว้มีเอกสารประกอบสำหรับ JavaScript โปรดใช้ JavaScript Consumer SDK แทน
  • คุณต้องแชร์ความคืบหน้าของการเดินทางแบบออนดีมานด์ในแอปผู้บริโภค Android ให้ใช้ Consumer SDK สำหรับ Android แทน
  • คุณต้องแชร์ความคืบหน้าของการเดินทางแบบออนดีมานด์ในเว็บแอป โปรดใช้ JavaScript Consumer SDK แทน
  • คุณต้องส่งตำแหน่งของคนขับและสถานะการเดินทางจากแอป iOS ของคนขับไปยัง Fleet Engine โปรดใช้ Driver SDK สำหรับ iOS แทน

Consumer SDK สำหรับ iOS: การตั้งค่า

แพ็กเกจ Consumer SDK อย่างเป็นทางการสำหรับ iOS

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

Consumer SDK สำหรับ iOS: ข้อผิดพลาดที่พบบ่อย

  • ปัญหา: การตรวจสอบการเดินทางไม่สำเร็จพร้อมข้อผิดพลาด 401 UNAUTHENTICATED เมื่อมีการลงชื่อ JWT โดยไม่มีรหัสการเดินทางหรือหมดอายุ วิธีแก้ไข: ให้ผู้ให้บริการโทเค็น (GMTCAuthorization) แสดงผล JWT ที่ออกสำหรับรหัสการเดินทางในบริบทการให้สิทธิ์ แคช JWT ต่อการเดินทาง และรีเฟรชเมื่อหมดอายุ ดู /maps/documentation/mobility/journey-sharing/on-demand/ios/auth-sdk
  • ปัญหา: การตรวจสอบการเดินทางไม่สำเร็จโดยมีข้อผิดพลาด 400 INVALID_ARGUMENT เมื่อชื่อการเดินทางไม่ได้ใช้รูปแบบ providers/{provider_id}/trips/{trip_id} วิธีแก้ไข: ใช้รหัสโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google เป็น provider_id และส่งรหัสโปรเจ็กต์เดียวกันเป็น providerID เมื่อเริ่มต้น SDK ดู /maps/documentation/mobility/journey-sharing/on-demand/ios/init-sdk
  • ปัญหา: แอปยังคงคอยฟังการอัปเดตหลังจากที่การเดินทางเสร็จสมบูรณ์หรือถูกยกเลิก วิธีแก้ไข: เรียกใช้ unregisterSubscriber ในโมเดลการเดินทางเมื่อการเดินทางเสร็จสมบูรณ์หรือถูกยกเลิก ดู /maps/documentation/mobility/journey-sharing/on-demand/ios/share-journey
  • ปัญหา: การติดตั้ง XCFramework ด้วยตนเองจะละเว้นแพ็กเกจทรัพยากรและการตั้งค่าบิลด์ที่จำเป็น เว้นแต่คุณจะเพิ่มไว้ใน Xcode วิธีแก้ไข: ใช้ CocoaPods หากเป็นไปได้ สำหรับการติดตั้งด้วยตนเอง ให้เพิ่ม gRPCCertificates.bundle และ GoogleRidesharingConsumer.bundle ลงในโปรเจ็กต์ ลิงก์เฟรมเวิร์กที่แสดง และเพิ่ม -ObjC ลงใน Other Linker Flags สำหรับการแก้ไขข้อบกพร่องและการเผยแพร่ ดู /maps/documentation/mobility/journey-sharing/on-demand/ios/setup

Consumer SDK สำหรับ iOS: ฟีเจอร์เดิมและฟีเจอร์ที่เลิกใช้งานแล้ว

  • GMTSVehicleLocation -initWithLatLng:latLngAccuracy:heading:headingAccuracy:speed:speedAccuracy:updateTime:isSnappableToRoute: initializer: เลิกใช้งานตั้งแต่วันที่ 1 มิถุนายน 2025 การแทนที่: GMTSVehicleLocation -initWithOptions: ด้วย GMTSVehicleLocationOptions
  • [GMTCMapView initWithCoder]: เลิกใช้งานตั้งแต่วันที่ 1 ธันวาคม 2023 การเปลี่ยนทดแทน: GMTCMapView -initWithOptions:

สิ่งที่คุณทำได้ด้วย Consumer SDK สำหรับ iOS

ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ