บันทึกประจำรุ่น 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 เพื่อรองรับไฟล์ Privacy 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 ใน 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