บันทึกประจำรุ่น SDK สำหรับผู้บริโภคของ iOS

ส่วนนี้มีบันทึกประจำรุ่นสำหรับ Consumer SDK สำหรับ iOS

v10.0.0 (มิถุนายน 2025)

เปลี่ยนแปลง

  • ตอนนี้เราหยุดการรองรับ iOS 15 แล้ว ตอนนี้ iOS เวอร์ชันขั้นต่ำคือ 16.0

การเปลี่ยนแปลง API

  • เพิ่มคลาส GMTSVehicleLocationOptions ซึ่งคุณสามารถใช้พร็อพเพอร์ตี้ serverTime เพื่อกำหนดเวลาที่ Fleet Engine ได้รับการอัปเดตตำแหน่งล่าสุด
  • เพิ่มตัวเริ่มต้น initWithOptions<GMTSVehicleLocationOptions> ใน GMTSVehicleLocation
  • เลิกใช้งานตัวเริ่มต้น initWithLatLng:GMTSLatLng ใน GMTSVehicleLocation แต่ให้ใช้ตัวเริ่มต้น initWithOptions:<GMTSVehicleLocationOptions> แทน

v9.2.1 (เมษายน 2025)

เปลี่ยนแปลง

  • แก้ไขข้อผิดพลาดเกี่ยวกับสัญลักษณ์ที่ไม่ได้กำหนด

v9.2 (มกราคม 2025)

เปลี่ยนแปลง

  • อัปเดตเวอร์ชันจาก 9.0 เป็น 9.2
  • รองรับการจัดรูปแบบแผนที่ในระบบคลาวด์
  • ช่วยให้ผู้ใช้ดึงข้อมูลสถานะ "ตำแหน่งยานพาหนะ" ระหว่างการเดินทางได้
  • แก้ไขปัญหาที่เกิดขึ้นได้ยากซึ่งเส้นหลายส่วนหายไป

v9.0 (กรกฎาคม 2024)

เปลี่ยนแปลง

  • รองรับ Geo iOS SDK เวอร์ชัน 9.0
  • ตอนนี้เราหยุดการรองรับ iOS 14 แล้ว ปัจจุบัน iOS เวอร์ชันขั้นต่ำคือ 15.0
  • รุ่นนี้มีไฟล์ .xcprivacy เพื่อรองรับไฟล์ Manifest ความเป็นส่วนตัวของ Apple
  • รวมการแก้ไขที่อาจเกิดขึ้นสำหรับการขัดข้องที่เกี่ยวข้องกับบันทึกที่พบได้ยาก

v3.3.0 (มีนาคม 2024)

เปลี่ยนแปลง

  • รองรับความเข้ากันได้ของ SDK สำหรับคนขับและผู้บริโภค เพื่อให้สร้างในแอปเดียวกันได้
  • รองรับ Swift Package Manager สำหรับ Driver SDK และ Consumer SDK

v3.2.0 (ธันวาคม 2023)

เปลี่ยนแปลง

  • แก้ไขข้อบกพร่องและอัปเดตเอกสารประกอบ

เลิกใช้

  • เลิกใช้งาน [GMTCMapView initWithCoder] ใน GMTCMapView

v3.1.1 (ตุลาคม 2023)

เปลี่ยนแปลง

  • แก้ไขข้อบกพร่องที่ทำให้ระบบไม่เรียกใช้เมธอด GMSMapViewDelegate

v3.1.0 (ก.ย. 2023)

เปลี่ยนแปลง

  • ตอนนี้ CocoaPod สำหรับ Consumer SDK เป็น .xcframework ซึ่งรองรับทั้งการสร้างอุปกรณ์และการจำลองสำหรับนักพัฒนาแอปทั้งใน Mac ที่ใช้ Intel และ Apple Silicon

v3.0.1 (ส.ค. 2023)

เปลี่ยนแปลง

  • แก้ไขข้อผิดพลาดเกี่ยวกับสัญลักษณ์ที่ไม่ได้กำหนด

v3.0.0 (พฤษภาคม 2023)

เปลี่ยนแปลง

  • นำตัวเริ่มต้นที่เลิกใช้งานแล้วออกใน GMTCMapView
  • แก้ไขการดึงโทเค็นการให้สิทธิ์อย่างต่อเนื่องหลังจากนำผู้ติดตามทั้งหมดออกจาก GMTCTripModel แล้ว
  • ขณะนี้เราได้หยุดการรองรับ iOS 13 แล้ว ตอนนี้ iOS เวอร์ชันขั้นต่ำคือ 14.0
  • เวอร์ชันขั้นต่ำที่รองรับใหม่ของ Xcode คือ 14.0 โปรดทราบการเลิกใช้งานในบันทึกประจำรุ่นของ Xcode 14 เกี่ยวกับการสิ้นสุดการรองรับการสร้างด้วยบิตโค้ด
  • ตามนโยบายการรองรับเวอร์ชันระบบปฏิบัติการบนอุปกรณ์เคลื่อนที่ เราจะหยุดการรองรับ สำหรับ iOS 13 ตั้งแต่ Consumer SDK สำหรับ iOS v3.0.0 ระบบปฏิบัติการเวอร์ชันขั้นต่ำใหม่ที่รองรับคือ iOS 14 SDK เวอร์ชันก่อนหน้าจะยังคงรองรับ iOS 13 ต่อไป หาก การอ้างอิงไม่ได้ระบุหมายเลขเวอร์ชัน IDE จะโหลด SDK เวอร์ชันล่าสุด และบิลด์ใหม่ของแอปจะไม่รองรับ iOS 13 ระบุ เวอร์ชันของ Consumer SDK สำหรับ iOS ในการขึ้นอยู่กับการสร้างของแอปพลิเคชัน เพื่อควบคุมเวลาที่คุณเพิ่มระบบปฏิบัติการขั้นต่ำที่รองรับสำหรับแอปเวอร์ชันใหม่

ประกาศ

หยุดการรองรับ iOS 14 - 15 พฤษภาคม 2023

ตามนโยบายการรองรับเวอร์ชันระบบปฏิบัติการบนอุปกรณ์เคลื่อนที่ เราจะ หยุดการรองรับ iOS 14 ใน SDK สำหรับผู้บริโภคเวอร์ชันหลักที่กำลังจะเปิดตัวสำหรับ iOS

SDK สำหรับผู้บริโภคสำหรับ iOS เวอร์ชันที่เปิดตัวตั้งแต่ไตรมาสที่ 2 ของปี 2024 จะรองรับ iOS 15 เป็นอย่างน้อย SDK เวอร์ชันก่อนหน้าจะยังคงรองรับ iOS 14 ต่อไป

หากการอ้างอิงไม่ได้ระบุหมายเลขเวอร์ชัน IDE จะโหลด SDK เวอร์ชันล่าสุด และบิลด์ใหม่ของแอปจะไม่รองรับ iOS 14

ระบุ เวอร์ชันของ Consumer SDK สำหรับ iOS ในทรัพยากร Dependency ของบิลด์แอปพลิเคชันเพื่อ ควบคุมเวลาที่คุณเพิ่มระบบปฏิบัติการขั้นต่ำที่รองรับสำหรับแอปเวอร์ชันใหม่

v2.2.0 (กุมภาพันธ์ 2023)

เปลี่ยนแปลง

  • อัปเดต URL สำหรับข้อกำหนดและเงื่อนไขในไฟล์ส่วนหัวเป็นลิงก์ที่ถูกต้อง และแก้ไขปัญหาเล็กๆ น้อยๆ อื่นๆ เกี่ยวกับเครื่องหมายวรรคตอน
  • แก้ไขการสะกด เครื่องหมายวรรคตอน และข้อผิดพลาดเล็กๆ น้อยๆ อื่นๆ ในเอกสาร

v2.1.0 (12 กันยายน 2022)

เปลี่ยนแปลง

  • แก้ไขข้อบกพร่องและอัปเดตเอกสารประกอบ

v2.0.0 (18 กรกฎาคม 2022)

เปลี่ยนแปลง

  • นำบริการจุดสิ้นสุดออก ซึ่งรวมถึง

    • GMTSTerminalPoint
    • GMTSTerminalPointAccessPoint
    • GMTSTerminalPointTravelMode
    • GMTSTerminalPointsVehicleSearchPreference
    • GMTSTravelModeETA

  • ตอนนี้เราได้หยุดการรองรับ iOS 12 แล้ว ตอนนี้ iOS เวอร์ชันขั้นต่ำคือ 13.0

เลิกใช้

  • เลิกใช้งานตัวเริ่มต้นในคลาสสาธารณะ GMTCMapView

ประกาศ

เราจะหยุดการรองรับ (เลิกใช้งาน) iOS 13 ในการอัปเดตเวอร์ชันหลักปี 2023 สำหรับ Consumer iOS SDK เวอร์ชัน iOS ขั้นต่ำที่รองรับคือ iOS 14 โดยจะเริ่มตั้งแต่เดือนมิถุนายน 2023 ลูกค้าควรเตรียมพร้อมโดยเปลี่ยนแฟล็กการรองรับเวอร์ชันขั้นต่ำในโค้ดก่อนที่จะอัปเดต

v1.0.6 (24 มีนาคม 2022)

แก้ไขข้อบกพร่องภายใน

v1.0 (7 ธันวาคม 2021)

iOS เวอร์ชันขั้นต่ำที่รองรับสำหรับการเปิดตัวนี้คือ 12.0

การเปลี่ยนแปลง API

การเปลี่ยนแปลงการตรวจสอบสิทธิ์

  • SDK จะเรียกใช้ getToken() สำหรับการติดตั้งใช้งานอินเทอร์เฟซ AuthTokenFactory สำหรับ gRPC แต่ละรายการ SDK จะดำเนินการนี้โดยการสกัดกั้นการเรียกใช้ Fleet Engine จากนั้นแนบ JWT ที่ส่งคืนจาก getToken() ไปยังส่วนหัวการให้สิทธิ์ HTTP โปรดทราบว่าคุณต้องเป็นผู้สร้างโทเค็นที่ถูกต้อง กล่าวคือ โทเค็นที่ยังไม่หมดอายุและมีคำกล่าวอ้างที่เหมาะสม

  • เปลี่ยน GMTSAuthorization เป็น GMTCAuthorization แล้ว

  • นำ GMTSServiceType ออกแล้ว

การเปลี่ยนแปลงข้อมูลการเดินทางและการเรียกกลับ

  • อัปเดตชื่อพร็อพเพอร์ตี้การเดินทาง: remainingDistanceOfActiveRouteInMeters

  • เพิ่มการอัปเดตข้อมูลการจราจรไปยัง GMTCTripModelSubscriber

  • เพิ่มคุณสมบัติ remainingDistanceOfCurrentRouteInMeters

  • เพิ่มคุณสมบัติใหม่ให้กับ GMTSTripPropertyFields:

    • GMTSTripPropertyFieldRemainingDistanceOfActiveRouteInMeters
    • GMTSTripPropertyFieldDistanceOfRemainingRouteInMetersGMTSTripPropertyFieldActiveRoute
    • GMTSTripPropertyFieldActiveRouteTrafficGMTSTripPropertyFieldRemainingRoute
    • GMTSTripPropertyFieldRemainingRouteTraffic

  • เพิ่มพร็อพเพอร์ตี้ใหม่ remainingDistanceOfActiveRouteInMeters และ distanceOfRemainingRouteInMeters ใน GMTSTrip

  • RegisterSubscriber เริ่มการตรวจสอบการเดินทางโดยอัตโนมัติสำหรับ tripModel UnregisterSubscriber จะหยุดการตรวจสอบเมื่อไม่มีสมาชิกอีกต่อไป ModelState และ ModelOptions ถูกเปลี่ยนชื่อเป็น state และ options ตามลำดับ stop และ start ถูกลบออกจากส่วนหัวสาธารณะ

    • เปลี่ยนชื่อ modelState เป็น state แล้ว
    • เปลี่ยนชื่อ modelOptions เป็น options แล้ว
    • ลบ start() และ stop() ใน TripModel

การเปลี่ยนแปลง API อื่นๆ

  • นำ GMTSTripPreview และ GMTSTripPreviewVehicleOptions ออกแล้ว

  • ลบบริการเลือกจุดรับซึ่งรวมถึง:

    • GMTSPickupPointArea
    • GMTSPickupPointGroup
    • GMTSPickupPointMatch

การหยุดรองรับ iOS 12 - 18 ตุลาคม 2021

เพื่อตอบสนองต่อการเปลี่ยนแปลงในส่วนการอ้างอิงภายในของเรา เราจึงหยุดการรองรับ iOS 12 ในเวอร์ชันหลักถัดไปของ Consumer SDK สำหรับ iOS

Consumer SDK สำหรับ iOS v2.0 ขึ้นไปจะรองรับเฉพาะอุปกรณ์ที่ใช้ iOS 13 ขึ้นไป SDK เวอร์ชันก่อนหน้าจะยังคงรองรับ iOS 12

หากการอ้างอิงใน CocoaPods หรือ Carthage ไม่ได้ ระบุหมายเลขเวอร์ชัน Xcode จะโหลดเวอร์ชันล่าสุดและบิลด์ใหม่ของ แอปจะไม่รองรับ iOS 12

อย่าลืมระบุเวอร์ชันในการขึ้นต่อกันของบิลด์ของแอปพลิเคชันเพื่อควบคุมเวลาที่คุณเพิ่มระบบปฏิบัติการขั้นต่ำที่รองรับสำหรับแอปเวอร์ชันใหม่ ดูตัวอย่างการระบุเวอร์ชันในเอกสารประกอบของ Maps SDK สำหรับ iOS ดูคำแนะนำเกี่ยวกับแนวทางปฏิบัติแนะนำในการบำรุงรักษาแอป

v0.11.0 (30 ก.ย. 2021)

การเปลี่ยนแปลง

  • เพิ่มการตรวจหาการขัดข้องระหว่างการเริ่มต้น SDK นอกจากนี้ ยังมีตัวเลือกในการเลือกไม่ใช้โดยใช้ setAbnormalTerminationReportingEnabled: API ใน GMTCServices

การเปลี่ยนแปลง API

อัปเดตคำนำหน้าชื่อสำหรับทุกคลาส:

  • GRC -> GMTC เช่น GRCMapView -> GMTCMapView
  • GRS -> GMTS เช่น GRSTrip -> GMTSTrip

อัปเดต GMTSAuthorization API แล้ว

  • เพิ่มคีย์ใหม่ kGMTSAuthorizationContextKeyTaskID สำหรับระบุรหัสงานใน authorizationContext เมื่อมีการเรียกใช้ fetchAuthTokenForServiceType:authorizationContext:completion:

  • อัปเดต enum GMTSServiceType แล้ว

    ค่าเดิม ค่าใหม่
    GMTSServiceTypeUnknown GMTSServiceTypeUnspecified
    GMTSServiceTypeTripService
    GMTSServiceTypeVehicleService GMTSServiceTypeVehicle
    GMTSServiceTypeTerminalPointService
    GMTSServiceTypeTask

v0.10.0 (3 พฤษภาคม 2021)

การเปลี่ยนแปลง

เลิกใช้งานการรองรับ iOS 10.x ตอนนี้ iOS เวอร์ชันขั้นต่ำที่รองรับคือ 11.0

การเปลี่ยนแปลง API

v0.9.0 (25 มกราคม 2021)

การปรับปรุง

การเปลี่ยนแปลง API

  • เปิดตัว GRCMutablePolylineStyleOptions สำหรับการปรับแต่งเส้นหลายเส้น ซึ่งใช้เพื่อเปิดใช้การแสดงผลเส้นหลายเส้นของการจราจรสำหรับการแชร์การเดินทางได้
  • เพิ่มการเรียกกลับการอัปเดตข้อมูลการจราจรใน GRCTripModelSubscriber:
  • เปิดตัว GRSTrafficData
  • เพิ่มพร็อพเพอร์ตี้ใหม่ใน GRSTripWaypoint สำหรับการเข้าถึงข้อมูลการเข้าชม ดังนี้
  • เพิ่มวิธีการใหม่ใน GRSTrip สำหรับการเข้าถึงข้อมูลการเข้าชม

v0.6.7 (23 มีนาคม 2020)

การปรับปรุง

  • ระบบจะไม่แสดงเส้นหลายเหลี่ยมของเส้นทางเมื่อสถานะการเดินทางเป็น ARRIVED_AT_PICKUP
  • เราได้ปรับปรุงการติดตามยานพาหนะที่ออกนอกเส้นทางแล้ว (ต้องใช้ DriverSDK 1.15)
    • การติดตามยานพาหนะจะไม่ปรับยานพาหนะให้ตรงกับเส้นทางเมื่อยานพาหนะขับผ่านจุดรับ
    • การติดตามยานพาหนะช่วยให้แสดงยานพาหนะที่อยู่นอกถนนได้ เช่น ในลานจอดรถที่ไม่ได้แมป
  • ระบบจะไม่บังคับให้ไอคอนยานพาหนะใช้เส้นทางที่ล้าสมัยอีกต่อไปเมื่อปลายทางของคนขับ ไม่ตรงกับปลายทางใน Fleet Engine
  • ตอนนี้เราจะทิ้งคำตอบการเดินทางที่ล้าสมัยแล้ว

v0.6.3 (16 ธันวาคม 2019)

การเปลี่ยนแปลง

  • เพิ่มบันทึกสำหรับเวลาในการตอบสนองของคำขอการเดินทาง

  • เพิ่มบันทึกข้อผิดพลาดในการตอบกลับการเดินทาง

v0.5.4(86.0) (7 สิงหาคม 2019)

ฟีเจอร์ใหม่

  • รองรับจุดหมายหลายแห่งสำหรับการแชร์การเดินทาง

การเปลี่ยนแปลง API

  • เพิ่มสถานะการเดินทางใหม่ใน GRSTripStatus แล้ว

    • GRSTripStatusEnrouteToIntermediateDestination
    • GRSTripStatusArrivedAtIntermediateDestination

  • เพิ่มพร็อพเพอร์ตี้ใหม่ลงใน GRSTrip แล้ว

    • intermediateDestinations
    • intermediateDestinationIndex

  • เพิ่ม API การเรียกกลับใหม่ไปยัง GRCTripServiceSubscriber

    • - (void)tripService:(GRCTripService *)service didUpdateETAToNextWaypoint:(NSTimeInterval)nextWaypointETA;

    • - (void)tripService:(GRCTripService *)service didUpdateIntermediateDestinations: (nullable NSArray<GRSTerminalLocation *> *)intermediateDestinations;

  • เพิ่ม enum ประเภทเครื่องหมายใหม่ลงใน GRCMapViewMarkerType

    • GRCMapViewMarkerTypeIntermediateDestination

  • เพิ่ม enum ประเภทเครื่องหมายใหม่ที่ปรับแต่งได้ลงใน GRCCustomizableMarkerType

    • GRCCustomizableMarkerTypeIntermediateDestination

  • เพิ่ม mapViewCustomerState ใหม่ลงใน GRCMapViewCustomerState แล้ว

    • GRCMapViewCustomerStateJourneySharing

  • ระบบได้ลบสมาชิก 4 คนออกจาก GRCMapViewCustomerState แล้วmapViewCustomerState

    • GRCMapViewCustomerStateWaitingForPickup
    • GRCMapViewCustomerStateArrivedAtPickup
    • GRCMapViewCustomerStateEnRoute
    • GRCMapViewCustomerStateEndOfTrip

  • ระบบได้ลบ API การเรียกกลับของ mapView 4 รายการออกจาก GRCMapView

    • -(void)mapViewDidStartWaitingForPickup:(GRCMapView *)mapview;
    • -(void)mapViewDidUpdateDueToDriverArrived:(GRCMapView *)mapview;
    • -(void)mapViewDidStartTripEnroute:(GRCMapView *)mapview;
    • -(void)mapViewDidCompleteTrip:(GRCMapView *)mapview;

  • เราได้เพิ่ม API สำหรับการเรียกกลับใหม่ลงใน GRCMapView

    • - (void)mapViewDidStartJourneySharing:(GRCMapView *)mapView;

การปรับปรุง

  • อัปเดตเวลาถึงโดยประมาณของจุดแวะพักที่เหลือทั้งหมดเมื่อเวลาถึงโดยประมาณของจุดแวะพักแรกใน รายการมีการเปลี่ยนแปลง

  • บังคับให้กล้องจัดกึ่งกลางโดยอัตโนมัติเมื่อคนขับมาถึงจุดรับ

  • ขอบเขตของกล้องจะรวมทั้งตำแหน่งรับและส่งหลังจากจองการเดินทางแล้ว และก่อนที่ตำแหน่งของยานพาหนะที่ตรงกันจะพร้อมใช้งาน

v0.4.5(28.0) (26 มิถุนายน 2019)

ฟีเจอร์ใหม่

  • รองรับการแชร์การเดินทางด้วยการแชร์รถ

การเปลี่ยนแปลง API

  • ระบบนำช่อง type ออกจาก GRSTerminalLocation แล้ว

การแก้ไขข้อบกพร่อง

  • ตอนนี้ภาพเคลื่อนไหวของเส้นทางจะเกิดขึ้นเมื่อส่วนของเส้นทางซิงค์กันเท่านั้น ซึ่งจะช่วยปรับปรุงประสบการณ์ของผู้ใช้

  • แก้ไขปัญหาที่การเรียก API isMarkerStyleOptionsCustomizedForType: สำหรับ GRCCustomizableMarkerTypeSelectedDropoffPoint จะแสดงผลเป็น NO เสมอ

v0.4.3 (17 พฤษภาคม 2019)

ฟีเจอร์ใหม่

  • การสนับสนุนแบบต่อเนื่องสำหรับการแชร์การเดินทาง
  • ตอนนี้การแชร์เส้นทางรองรับอัตราการรายงานตำแหน่งยานพาหนะแบบไดนามิกแล้ว

การเปลี่ยนแปลง API

GRCMapViewMarkerType

ค่าเดิม ค่าใหม่
GRCMapViewMarkerTypeSelectedPickup GRCMapViewMarkerTypeSelectedPickupPoint
GRCMapViewMarkerTypeSelectedDropoff GRCMapViewMarkerTypeSelectedDropoffPoint
GRCMapViewMarkerTypePickupCandidate GRCMapViewMarkerTypeSuggestedPickupPoint
GRCMapViewMarkerTypeHighlightedPickupPoint
GRCMapViewMarkerTypeTripPreviewPickupPoint
GRCMapViewMarkerTypeTripPreviewDropoffPoint
GRCMapViewMarkerTypeTripPickupPoint
GRCMapViewMarkerTypeTripDropoffPoint

GRCMapView

ค่าเดิม ค่าใหม่
redrawRidesharingOverlays

โปรโตคอล GRCTripServiceSubscriber

ค่าเดิม ค่าใหม่
tripService:didUpdateTripRoute: tripService:didUpdateActiveRoute:
tripService:didUpdateRemainingDistance tripService:didUpdateActiveRouteRemainingDistance
tripService:didUpdateRemainingWaypoints

GRCPolylineType

ค่าเดิม ค่าใหม่
GRCPolylineTypeTripRoute GRCPolylineTypeActiveRoute
GRCPolylineTypeTripPreviewAutoRoute GRCPolylineTypePreviewAutoRoute
GRCPolylineTypeTripPreviewTaxiRoute GRCPolylineTypePreviewTaxiRoute
GRCPolylineTypeTripPreviewTruckRoute GRCPolylineTypePreviewTruckRoute
GRCPolylineTypeTripPreviewTwoWheelerRoute GRCPolylineTypePreviewTwoWheelerRoute
GRCPolylineTypeRemainingRoute

GRCPolylineStyleOptions

ค่าเดิม ค่าใหม่
zIndex

GRSTrip

ค่าเดิม ค่าใหม่
ที่พัก remainingWaypoints แห่ง
ที่พัก route แห่ง
ที่พัก remainingDistanceInMeters แห่ง
GRSTripWaypoint

การปรับปรุง

  • ลดการใช้เครือข่ายสำหรับการแชร์การเดินทาง
  • ตอนนี้ระบบจะไฮไลต์ตัวเลือกการรับสินค้าที่เลือกไว้
  • ใช้ได้กับ Maps SDK v3.1.0

การแก้ไขข้อบกพร่อง

  • แก้ไขปัญหาที่เครื่องหมายไม่ตอบสนองต่อการแตะเป็นครั้งที่ 2
  • แก้ไขปัญหาที่ขอบเขตกล้องของ mapView บางครั้งแสดงวิวพอร์ตที่ไม่คาดคิดในตอนแรกหลังจากจองการเดินทาง
  • แก้ไขปัญหาเกี่ยวกับ SDK Version API