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: การตั้งค่า
- การตรวจสอบสิทธิ์: JSON Web Token (JWT)
- เปิดใช้บริการ Fleet Engine ด้วย
- เริ่มต้นใช้งาน: ตั้งค่า Consumer SDK สำหรับ iOS
- ข้อมูลอ้างอิง: ข้อมูลอ้างอิง Consumer SDK สำหรับ iOS
- นโยบาย: นโยบาย Consumer SDK สำหรับ iOS
- บันทึกประจำรุ่น: บันทึกประจำรุ่นของ Consumer SDK สำหรับ iOS
แพ็กเกจ Consumer SDK อย่างเป็นทางการสำหรับ iOS
- cocoapods:
GoogleRidesharingConsumer - swift_package:
https://github.com/googlemaps/ios-consumer-sdk
Consumer SDK สำหรับ iOS: สินค้าที่เกี่ยวข้อง
- มักใช้ร่วมกับ: บริการ Fleet Engine, Driver SDK สำหรับ iOS, Driver SDK สำหรับ Android, Maps SDK สำหรับ iOS
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
ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ
- เพิ่มแผนที่แบบอินเทอร์แอกทีฟที่ปรับแต่งได้ซึ่งติดตามความคืบหน้าของการเดินทางจาก Fleet Engine ไปยังแอปบนอุปกรณ์เคลื่อนที่
- เพิ่มเส้นประกอบของเส้นทางที่ติดตามการเดินทางจาก Fleet Engine ไปยังแผนที่ในหน้าเว็บหรือแอปบนอุปกรณ์เคลื่อนที่
- อัปเดตความคืบหน้าของการเดินทางตามเส้นทางในแผนที่บนหน้าเว็บหรือแอปบนอุปกรณ์เคลื่อนที่สำหรับการเดินทางของ Fleet Engine
- เปลี่ยนรูปแบบของถนน เส้นประกอบ และรูปหลายเหลี่ยมในแผนที่ที่ติดตามความคืบหน้าของการเดินทางจาก Fleet Engine
- แสดงหรือซ่อนองค์ประกอบในแผนที่ซึ่งติดตามความคืบหน้าของการเดินทางจาก Fleet Engine
- เปลี่ยนรูปแบบของไอคอนและป้ายกำกับข้อความบนแผนที่ที่ติดตามความคืบหน้าของการเดินทางจาก Fleet Engine
- ใช้รูปแบบแผนที่ที่แตกต่างกันกับระดับการซูมที่แตกต่างกันในแผนที่ที่ติดตามความคืบหน้าของการเดินทางจาก Fleet Engine
- เปลี่ยนความหนาแน่นของสถานที่บนแผนที่ที่ติดตามความคืบหน้าของการเดินทางจาก Fleet Engine เวอร์ชันทดลอง หมายเหตุ: การรองรับการจัดรูปแบบแผนที่ในระบบคลาวด์ใน Consumer SDK เป็นเวอร์ชัน GA ส่วนการควบคุมความหนาแน่นของจุดที่น่าสนใจเป็นฟีเจอร์การจัดรูปแบบแผนที่ในระบบคลาวด์เวอร์ชันทดลอง (รองรับเฉพาะรูปแบบแผนที่แบบสว่างเท่านั้น)
- เปลี่ยนรูปแบบของอาคารในแผนที่ที่ติดตามความคืบหน้าของการเดินทางจาก Fleet Engine เวอร์ชันทดลอง หมายเหตุ: การรองรับการจัดรูปแบบแผนที่ในระบบคลาวด์ใน Consumer SDK เป็นเวอร์ชัน GA ส่วนการปรับแต่งรูปแบบอาคาร 3 มิติและพื้นที่ทำงานเป็นฟีเจอร์การจัดรูปแบบแผนที่ในระบบคลาวด์เวอร์ชันทดลอง (รองรับเฉพาะรูปแบบแผนที่แบบ Light เท่านั้น)
- เปลี่ยนรูปแบบของจุดสังเกตบนแผนที่ที่ติดตามความคืบหน้าของการเดินทางจาก Fleet Engine เวอร์ชันทดลอง หมายเหตุ: การรองรับการจัดรูปแบบแผนที่ในระบบคลาวด์ใน Consumer SDK เป็นเวอร์ชัน GA ส่วนการปรับแต่งไอคอนจุดสังเกตเป็นฟีเจอร์การจัดรูปแบบแผนที่ในระบบคลาวด์เวอร์ชันทดลอง (รองรับเฉพาะรูปแบบแผนที่แบบสว่างเท่านั้น)
- ปรับแต่งเครื่องหมายบนแผนที่ซึ่งติดตามความคืบหน้าของการเดินทางจาก Fleet Engine
- ปรับแต่งเส้นประกอบของเส้นทางบนแผนที่ซึ่งติดตามความคืบหน้าของการเดินทางจาก Fleet Engine