ส่วนนี้ประกอบด้วยบันทึกประจำรุ่นของ Consumer SDK สำหรับ Android
ประกาศ: การหยุดรองรับ API ระดับ 23, 24 และ 25 ชั่วคราว
เพื่อให้เป็นไปตามนโยบายการรองรับเวอร์ชันระบบปฏิบัติการบนมือถือ เราจะระงับการรองรับ Android 6 และ 7 (API ระดับ 23, 24 และ 25) ใน Consumer SDK สำหรับ Android เวอร์ชันหลักที่กำลังจะเปิดตัว
Consumer SDK สำหรับ Android เวอร์ชันที่เปิดตัวตั้งแต่ไตรมาสที่ 4 ของปี 2025 จะรองรับ Android 8 (API ระดับ 26) เป็นอย่างน้อย SDK เวอร์ชันก่อนหน้าจะยังคงรองรับ Android 6 และ 7 ต่อไป
หากทรัพยากร Dependency ไม่ได้ระบุหมายเลขเวอร์ชัน IDE จะโหลด SDK เวอร์ชันใหม่ล่าสุด และบิลด์ใหม่ของแอปจะไม่รองรับ Android 6 และ 7
ระบุเวอร์ชันของ Consumer SDK สำหรับ Android ในทรัพยากร Dependency ของบิลด์ของแอปพลิเคชันเพื่อควบคุมเวลาที่คุณเพิ่มระบบปฏิบัติการขั้นต่ำที่รองรับสำหรับแอปเวอร์ชันใหม่
5.0.0 (9 พฤศจิกายน 2026)
- เพิ่มการรองรับโหมดเต็มรูปแบบ R8 ตอนนี้กฎ ProGuard ของ SDK จะเก็บคลาสผู้ให้บริการ gRPC ที่โหลดโดยการสะท้อนไว้ ดังนั้นแอปที่เปิดใช้โหมดเต็มรูปแบบ R8 จะไม่ล้มเหลวเมื่อเริ่มต้นระบบด้วย
Unable to load OkHttpChannelProviderอีกต่อไป
การแก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่การพยายามเชื่อมต่ออย่างปลอดภัยกับ Fleet Engine อาจค้างอยู่โดยไม่มีกำหนดหากพร็อกซีของผู้ให้บริการระดับกลางหยุดทำงานระหว่างการตั้งค่าการเชื่อมต่อ ซึ่งทำให้การอัปเดตสถานะการเดินทางและการติดตามยานพาหนะไม่รีเฟรชในเครือข่ายมือถือบางเครือข่าย ตอนนี้ Consumer SDK จะบังคับใช้การหมดเวลาการเชื่อมต่อและกู้คืนโดยอัตโนมัติเมื่อมีการเชื่อมต่อใหม่
การเปลี่ยนแปลงทรัพยากร Dependency และการกำหนดค่า
ตั้งแต่ Consumer SDK สำหรับ Android เวอร์ชัน 5.0.0 เป็นต้นไป จะมีข้อกำหนดขั้นต่ำใหม่ดังนี้
- เวอร์ชัน Android ขั้นต่ำที่รองรับคือ Android 7.0 (API ระดับ 24)
- แอปต้องอัปเกรดเป็น Kotlin 2.4
ตอนนี้ SDK สร้างขึ้นด้วยเครื่องมือต่อไปนี้
- อัปเกรดปลั๊กอิน Android Gradle เป็น 9.2.0
- อัปเกรด Gradle เป็น 9.4.1
4.1.0 (26 พฤษภาคม 2026)
- การปรับปรุงภายใน: ย้ายข้อมูลพื้นที่เก็บข้อมูลภายในไปยัง Jetpack DataStore
การเปลี่ยนแปลงทรัพยากร Dependency และการกำหนดค่า
- อัปเกรดเวอร์ชันทรัพยากร Dependency ของ Kotlin เป็น v2.3.0
- อัปเกรดปลั๊กอิน Android Gradle เป็น 8.13.2 แล้ว
- อัปเกรด Gradle เป็น 8.13
- อัปเกรดไลบรารี Desugar เป็น 2.1.5
- อัปเกรด Maps SDK เป็น 20.0.0 และอัปเดตทรัพยากร Dependency ของ GMS Core ต่อไปนี้
- play-services-location: 21.3.0
- play-services-tasks: 18.4.1
- play-services-common: 18.1.0
- play-services-basement: 18.1.0
- เพิ่มทรัพยากร Dependency ของ Jetpack Datastore (androidx.datastore:datastore-core:1.2.0, androidx.datastore:datastore-guava:1.2.0)
4.0.0 (3 ตุลาคม 2025)
- การปรับปรุงภายใน
3.2.0 (26 มิถุนายน 2025)
- การปรับปรุงการบันทึกภายใน
การเปลี่ยนแปลงทรัพยากร Dependency และการกำหนดค่า
- ตั้งแต่ Consumer SDK สำหรับ Android เวอร์ชัน 3.2.0 เป็นต้นไป แอปต้องอัปเกรดเป็น Kotlin 2.1
การแก้ไขข้อบกพร่อง
- ใช้ความยาวของเส้นประกอบแทนระยะทางในอากาศสำหรับการตัดสินใจเกี่ยวกับภาพเคลื่อนไหวภายใน
3.1.0 (10 มีนาคม 2025)
- การปรับปรุงการบันทึกภายใน
3.0.0 (6 ธันวาคม 2024)
การเปลี่ยนแปลงทรัพยากร Dependency และการกำหนดค่า
- ตั้งแต่ Consumer SDK สำหรับ Android เวอร์ชัน 3.0.0 เป็นต้นไป แอปต้องอัปเกรดเป็น Kotlin 2.0 ดูคำแนะนำในการย้ายข้อมูล Consumer SDK 3.0 สำหรับ Android
- ตอนนี้ targetSdk สำหรับ Consumer SDK คือ Android 14 (ระดับ API 34) ซึ่งเป็นข้อกำหนดสำหรับแอปทั้งหมดที่ติดตั้งใช้งานใน Google Play Store ตั้งแต่เดือนสิงหาคม 2024 เป็นต้นไป ดูปฏิบัติตามข้อกำหนดระดับ API เป้าหมายของ Google Play
2.99.0 (25 พฤศจิกายน 2024)
การแก้ไขข้อบกพร่อง
- แก้ไขข้อผิดพลาด ANR ที่เกิดขึ้นเมื่อ
ConsumerApi.cleanUp()ใช้เวลานานเกินไปในการดำเนินการ เราจะทยอยเปิดตัวฟีเจอร์นี้ (เริ่มจาก 0%) เมื่อผสานรวมรุ่นแล้ว - แก้ไขปัญหาที่คนขับได้รับข้อผิดพลาด gRPC พร้อมรหัส "INTERNAL" และข้อความ "Panic! นี่คือข้อบกพร่อง" เราจะทยอยเปิดตัวฟีเจอร์นี้ (เริ่มจาก 0%) เมื่อผสานรวมรุ่นแล้ว
2.3.0 (2 สิงหาคม 2024)
การเปลี่ยนแปลง API
เพิ่มการรองรับการจัดรูปแบบแผนที่ในระบบคลาวด์ ซึ่งช่วยให้คุณสร้างประสบการณ์การใช้งานแผนที่ถนนที่ปรับแต่งเองสำหรับผู้ใช้ได้โดยไม่ต้องอัปเดตโค้ดของแอปทุกครั้งที่ทำการเปลี่ยนแปลงรูปแบบแผนที่ ดูข้อมูลเพิ่มเติมได้ที่จัดรูปแบบแผนที่ด้วยการจัดรูปแบบแผนที่ในระบบคลาวด์
เพิ่มเมธอด
getServerTimeMillis()ลงในVehicleLocationเพื่อระบุเวลาที่ Fleet Engine ได้รับการอัปเดตตำแหน่ง
2.2.0 (7 พฤษภาคม 2024)
การเปลี่ยนแปลง API
- เพิ่ม API การสนับสนุนสำหรับการผสานรวม Jetpack Compose ฟีเจอร์นี้เป็นฟีเจอร์ทดลอง โปรดติดต่อตัวแทนเพื่อสอบถามรายละเอียดเกี่ยวกับการผสานรวมกับ Jetpack Compose
2.1.0 (17 มกราคม 2024)
การแก้ไขข้อบกพร่อง
- แก้ไขข้อขัดข้องที่เกิดขึ้นเมื่อมีการเริ่มต้น SDK มากกว่า 1 ครั้งตลอดวงจรการใช้งานแอปพลิเคชัน
การเปลี่ยนแปลง API
- เปิดตัวเมธอดเพื่อดึงข้อมูลอินสแตนซ์
GoogleMapที่สร้างโดย SDK (ConsumerGoogleMap.getGoogleMap()) - เปิดตัว API เพื่อดึงข้อมูลอินสแตนซ์
Markerที่ SDK สร้างขึ้นเพื่อแสดงถึงยานพาหนะ (ConsumerController.getConsumerMarker()) - เปิดตัว API เพื่อรับข้อมูลอัปเดตที่คาดการณ์ไว้ของไคลเอ็นต์เกี่ยวกับเวลาและระยะทางระหว่างการแชร์เส้นทาง (
ProjectedRouteEta)
1.99.2 (3 พฤศจิกายน 2023)
แก้ไขข้อขัดข้องที่เกิดขึ้นเมื่อ SDK เริ่มต้นจากกระบวนการระยะไกลซึ่งแยกจากแอปพลิเคชัน
แก้ไขข้อขัดข้องที่เกิดขึ้นขณะเรียกใช้ภาพเคลื่อนไหวของกล้องและมีพื้นที่แนวตั้งหรือแนวนอนไม่เพียงพอสำหรับการเว้นระยะห่างจากขอบ ปัญหานี้เกิดขึ้นเฉพาะในโปรแกรมแสดงผลแผนที่เวอร์ชันล่าสุดเท่านั้น
แก้ไขข้อบกพร่องที่ทำให้การเดินทางช่วงแรกของการเดินทางแบบต่อเนื่องถูกตัดออกเมื่อการเดินทางช่วงที่ 2 ผ่านถนนเส้นเดียวกัน
ปัญหา
ConsumerApi.initialize()จะแสดงข้อยกเว้นหากมีการเรียกใช้เมื่อมีอินสแตนซ์ API อยู่แล้ว วิธีแก้ปัญหานี้คือให้เรียกใช้ConsumerApi.getInstance()ก่อน แล้วประเมินTaskที่แสดงผลเพื่อดูว่ามีอินสแตนซ์ API อยู่แล้วหรือไม่
2.0.0 (15 กันยายน 2023)
ประกาศ: การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
ข้อกำหนดระดับ API ขั้นต่ำได้รับการอัปเดตจาก 21 เป็น 23
อัปเดตข้อกำหนดเวอร์ชัน Maps SDK จาก v17.0.0 เป็น v18.1.0
ข้อกำหนดเวอร์ชันไลบรารีมาตรฐาน Kotlin ขั้นต่ำได้รับการอัปเดตจาก v1.6.10 เป็น v1.9.0
อัปเดตเวอร์ชันทรัพยากร Dependency ของบริการ Google Play
ข้อกำหนดเวอร์ชันไลบรารี play-services-base ขั้นต่ำได้รับการอัปเดตจาก v18.0.1 เป็น v18.2.0
ข้อกำหนดเวอร์ชันขั้นต่ำของไลบรารี play-services-basement ได้รับการอัปเดตจาก v18.0.0 เป็น v18.2.0
ข้อกำหนดเวอร์ชันไลบรารี play-services-location ขั้นต่ำได้รับการอัปเดตจาก v17.0.0 เป็น v21.0.1
ข้อกำหนดเวอร์ชันขั้นต่ำของไลบรารี play-services-tasks ได้รับการอัปเดตจาก v18.0.1 เป็น v18.0.2
เพิ่มไลบรารี androidx.room:room-runtime โดยตั้งค่าข้อกำหนดเวอร์ชันขั้นต่ำเป็น v2.5.2
อัปเดตเวอร์ชันทรัพยากร Dependency ต่อไปนี้
ข้อกำหนดเวอร์ชันไลบรารี android-maps-utils ขั้นต่ำได้รับการอัปเดตจาก v0.4.2 เป็น v3.5.2
ข้อกำหนดเวอร์ชันขั้นต่ำของ com.google.android.datatransport:transport-backend-cct ได้รับการอัปเดตจาก v3.0.0 เป็น v3.1.9
ข้อกำหนดเวอร์ชันขั้นต่ำของ com.google.android.datatransport:transport-runtime ได้รับการอัปเดตจาก v3.0.1 เป็น v3.1.9
ข้อกำหนดเวอร์ชัน androidx.lifecycle:lifecycle-extensions ขั้นต่ำได้รับการอัปเดตจาก v2.0.0 เป็น v2.2.0
ข้อกำหนดเวอร์ชันขั้นต่ำของ androidx.lifecycle:lifecycle-common-java8 ได้รับการอัปเดตจาก v2.0.0 เป็น v2.6.1
ข้อกำหนดเวอร์ชัน androidx.appcompat:appcompat ขั้นต่ำได้รับการอัปเดตจาก v1.0.0 เป็น v1.6.1
ข้อกำหนดเวอร์ชัน androidx.fragment:fragment ขั้นต่ำได้รับการอัปเดตจาก v1.0.0 เป็น v1.6.1
นำ API ที่เลิกใช้งานก่อนหน้านี้ออก ได้แก่
ConsumerTrip,ConsumerTripCallback,ConsumerTripManager,ConsumerTripOptionsโดยแทนที่ด้วยTripModel,TripModelCallback,TripModelManagerและTripModelOptionsตอนนี้แอปที่ใช้ Consumer SDK ต้องมี
targetSdkVersionของ API 31 ขึ้นไป และcompileSdkVersionของ API 33 ขึ้นไปตอนนี้แอปที่ใช้ Consumer SDK ต้องเปิดใช้การรองรับไลบรารี Java 8 ดูวิธีการอัปเดตได้ที่ https://developer.android.com/studio/write/java8-support
แอปที่ใช้ Proguard หรือ Dexguard ต้องย้ายข้อมูลไปยัง R8 ดูข้อมูลเพิ่มเติมได้ที่ https://developer.android.com/build/shrink-code
แอปที่ใช้ Consumer SDK ต้องเปิดใช้กระบวนการ Desugaring ดูวิธีการได้ที่ https://developer.android.com/studio/write/java8-support#library-desugaring
ตอนนี้เมธอด
ConsumerApi.initialize()จะแสดงข้อยกเว้นหากมีการเรียกใช้เมื่อมีอินสแตนซ์ API ที่สร้างไว้แล้ว ต้องใช้Taskที่ConsumerApi.getInstance()แสดงผลเพื่อระบุว่ามีอินสแตนซ์ API ที่สร้างไว้ก่อนหน้านี้หรือไม่
ประกาศ: การเลิกใช้งาน API
เลิกใช้งานคลาสคำอธิบายประกอบ
Trip.TripStatusและTrip.TripTypeแล้วเพิ่มคลาสคำอธิบายประกอบTripInfo.TripStatusและTripInfo.TripTypeเพื่อแทนที่ในการเปลี่ยนแปลงนี้ เราจะเลิกใช้งาน
TripModelCallback#onTripStatusUpdated(TripInfo tripInfo, @Trip.TripStatus int status)และเพิ่มTripModelCallback#onTripStatusUpdate(TripInfo tripInfo, @TripInfo.TripStatus int status)เข้ามาแทนการเปลี่ยนแปลงนี้รวมถึงการเลิกใช้งาน
TripInfo#getTripStatus()และเพิ่มTripInfo#getCurrentTripStatus()เข้ามาแทนการเปลี่ยนแปลงนี้รวมถึงการเลิกใช้งาน
TripInfo#getTripType()และเพิ่มTripInfo#getCurrentTripType()เข้ามาแทน
เลิกใช้งานคลาส
Trip
การเปลี่ยนแปลงอื่นๆ และการแก้ไขข้อบกพร่อง
รองรับการขอใช้โปรแกรมแสดงผล Maps SDK เวอร์ชันล่าสุด ดูรายละเอียดได้ที่โปรแกรมแสดงผลแผนที่ใหม่
รองรับช่วง Maps SDK ตั้งแต่เวอร์ชัน v18.1.0 (รวม) ถึง v19.0.0 (ไม่รวม)
แก้ไขข้อผิดพลาด "เกินกำหนดเวลา" สำหรับการสื่อสารภายในระหว่าง SDK กับแบ็กเอนด์ของ Google
แก้ไขปัญหาการแสดงผลสำหรับหน้าจอขนาดเล็กและโหมดการแสดงภาพซ้อนภาพ
คำแนะนำในการย้ายข้อมูล
1.99.1 (31 สิงหาคม 2023)
การแก้ไขข้อบกพร่อง
แก้ไขข้อขัดข้องที่เกิดขึ้นเมื่อกิจกรรมหรือส่วนย่อยของโฮสต์ SDK ถูกทำลาย
แก้ไขข้อขัดข้องที่เกิดขึ้นเมื่อขนาดของ MapView เป็น 0 (ความสูงหรือความกว้าง)
แก้ไขข้อขัดข้องที่เกิดขึ้นเมื่อฉายภาพตำแหน่งของยานพาหนะบนเส้นประกอบของเส้นทาง
การปรับปรุง
- ป้องกันไม่ให้ SDK ขัดข้องเมื่อมีการไซด์โหลดแอปพลิเคชันแบบโฮสต์ และไม่มีทรัพยากรภาพเริ่มต้น
1.99.0 (22 มิถุนายน 2023)
การแก้ไขข้อบกพร่อง
แก้ไขปัญหาการแสดงผลสำหรับหน้าจอขนาดเล็กและโหมดการแสดงภาพซ้อนภาพ
แก้ไขปัญหายานพาหนะกะพริบระหว่างการแชร์เส้นทาง
1.2.1 (7 มิถุนายน 2023)
การแก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องที่ทำให้ยานพาหนะกะพริบระหว่างการแชร์เส้นทาง
1.2.0 (21 พฤศจิกายน 2022)
การแก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องที่ทำให้ระบบรายงานการเข้าชมที่ว่างเปล่าใน Callback
onTripActiveRouteTrafficUpdated
ฟีเจอร์ใหม่
- ตอนนี้ "เส้นประกอบที่คำนึงถึงการจราจร" พร้อมให้บริการในเวอร์ชันสำหรับผู้ใช้ทั่วไปแล้ว
1.1.2 (27 ตุลาคม 2022)
การแก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องที่ทำให้เส้นประกอบของเส้นทางหายไปหลังจากเริ่ม
JourneySharingSessionมากกว่า 1 ครั้งสำหรับTripModel
ประกาศ: การหยุดให้การสนับสนุน Android 5 (25 กรกฎาคม 2022)
สำหรับ SDK เวอร์ชัน v1.1.1 เราจะให้การสนับสนุนเพิ่มเติมอีก 1 ปีสำหรับแอปที่ทำงานบน Android 5 ทั้งระดับ API 21 และ 22
การดำเนินการนี้หมายความว่าอย่างไร
Consumer SDK ที่ทำงานในแอป Android จะรองรับ Android 5 (API ระดับ 21) เป็นอย่างต่ำจนถึงวันที่ 30 มิถุนายน 2023
หลังจากวันที่ 30 มิถุนายน 2023 เราจะรองรับเฉพาะ Android API ระดับ 23 ขึ้นไปเท่านั้น กล่าวคือ เราจะหยุดรองรับ Android API ระดับ 21 และ 22 ใน SDK ทุกเวอร์ชันหลังจากวันที่ดังกล่าว ซึ่งหมายความว่าข้อบกพร่องที่เกี่ยวข้องกับ Android 21 หรือ 22 ใน SDK เวอร์ชันใดก็ตาม (รวมถึง 4.x) จะไม่ได้รับการแก้ไข และเราไม่รับประกันว่า SDK จะทำงานได้อย่างถูกต้อง
v1.1.1 (25 กรกฎาคม 2022)
การเปลี่ยนแปลงการขึ้นต่อกัน
- ดาวน์เกรดระดับ API ขั้นต่ำของ Android ที่รองรับเป็น 21
v1.1.0 (28 เมษายน 2022)
- การปรับปรุงภายใน
v1.0.19 (17 มีนาคม 2022)
การแก้ไขข้อบกพร่อง
- แก้ไขหน่วยความจำรั่วไหลในคลาส
ConsumerApi
v1.0.14 (30 พฤศจิกายน 2021)
ตอนนี้ระดับ API ขั้นต่ำของ Android ที่รองรับคือ 23
การเปลี่ยนแปลง API
การเปลี่ยนแปลงคลาส
ConsumerTripและConsumerTripManager- ล้างชื่อเมธอดบางชื่อเพื่อให้ความหมายชัดเจนยิ่งขึ้น และเพื่อให้สอดคล้องกับแพลตฟอร์ม iOS
การเปลี่ยนแปลงใน
ConsumerTripCallback,ConsumerTripและTripInfoเปลี่ยนชื่อคลาสบางชื่อเพื่อให้สอดคล้องกับ iOS เปิดตัว
TripModel,TirpModelManagerและTripModelOptionsเพื่อเลิกใช้งานConsumerTrip,ConsumerTripManagerและConsumerTripOptionsล้างชื่อเมธอดบางชื่อ แก้ไขหรือเพิ่มความคิดเห็น JavaDoc ลงในเมธอดเพื่อสื่อความหมายที่ชัดเจนยิ่งขึ้น
ปรับปรุงการจัดการข้อผิดพลาด
การปรับแต่งการจัดรูปแบบ
Wrapper เดิมที่เลิกใช้งานแล้ว
MarkerStyleOptionsและPolylineStyleOptionsเลิกใช้งานแล้วและแทนที่ด้วยMarkerOptionsและPolylineOptionsซึ่งทั้ง 2 รายการแชร์กับ Maps SDK
การตรวจสอบข้อขัดข้อง
เพิ่มการตรวจจับและการบันทึกข้อขัดข้อง
- เราได้เพิ่มตัวเลือกเพื่อให้คุณเลือกไม่ใช้ฟังก์ชันนี้ได้ ซึ่งเป็นส่วนหนึ่งของความพยายามในวงกว้างด้านภูมิศาสตร์เพื่อตรวจสอบข้อขัดข้อง
การเปลี่ยนแปลงการตรวจสอบสิทธิ์
- นำเมธอดที่ไม่จำเป็นออกจากอินเทอร์เฟซการตรวจสอบสิทธิ์
- นำพารามิเตอร์
ServiceTypeออกแล้ว
- นำพารามิเตอร์
v0.9.28 (18 พฤษภาคม 2021)
การเปลี่ยนแปลง API
- อัปเดตเมธอด
ConsumerTripCallbackทั้งหมดให้ใช้TripInfoเป็นพารามิเตอร์ - เพิ่ม
ConsumerTrip.isRefreshing()ซึ่งระบุว่าConsumerTripกำลังอัปเดตตัวเองด้วยข้อมูลการเดินทางใหม่จาก Fleet Engine หรือไม่ - เพิ่ม
ConsumerTripCallback.onTripRemainingRouteDistanceUpdated()แล้ว - เพิ่ม
ConsumerTripCallback.onTripRemainingRouteUpdated()แล้ว - แทนที่ประเภทการแสดงผล Guava (
ImmutableSet,ImmutableList) ด้วยคลาสที่เทียบเท่าjava.util การเปลี่ยนแปลงชื่อแพ็กเกจ:
- com.google.android.libraries.ridesharing.common.AuthTokenContext -> com.google.android.libraries.ridesharing.consumer.auth.AuthTokenContext
- com.google.android.libraries.ridesharing.common.AuthTokenFactory -> com.google.android.libraries.ridesharing.consumer.auth.AuthTokenFactory
com.google.android.libraries.ridesharing.common.FleetEngineServiceType -> com.google.android.libraries.ridesharing.consumer.auth.FleetEngineServiceType - com.google.android.libraries.ridesharing.common.model.Trip
-> com.google.android.libraries.ridesharing.consumer.model.Trip - com.google.android.libraries.ridesharing.common.model.Vehicle -> com.google.android.libraries.ridesharing.consumer.model.Vehicle
การเปลี่ยนแปลงการติดตั้งใช้งาน
- แก้ไขภาวะแข่งขันที่ SDK อาจขัดข้องจากการโต้ตอบกับแผนที่ก่อนที่จะพร้อมใช้งาน
- SDK ไม่มีสำเนา
io.grpcที่ไม่ได้ผ่านการสร้างความสับสนอีกต่อไป - แก้ไขข้อบกพร่องเกี่ยวกับเส้นประกอบการจราจรที่กะพริบในอุปกรณ์บางรุ่น ตอนนี้กลุ่มการจราจรจะมีปลายโค้งมน
v0.9.15 (7 ตุลาคม 2020)
การเปลี่ยนแปลง API
- รุ่นนี้เปิดตัวเส้นประกอบที่รับรู้การจราจร
- เพิ่ม
TripInfo.getActiveRouteTraffic()และTripInfo.getRemainingRouteTraffic()แล้ว- เพิ่ม
ConsumerTripCallback.onTripActiveRouteTrafficUpdated()และConsumerTripCallback.onTripRemainingRouteTrafficUpdated()เพื่อระบุเมื่อการเข้าชมมีการเปลี่ยนแปลง - เพิ่ม
PolylineStyleOptionsสำหรับการปรับแต่งการเข้าชม (setTrafficEnabled(),setTrafficColorNoData(),setTrafficColorNormal(),setTrafficColorSlow(),setTrafficColorTrafficJam()) - เปิดเผย
PolylineStyleOptions.TRAFFIC_Z_INDEX_ADDITION - เพิ่ม
TripWaypoint.getTrafficData()แล้ว - เพิ่มประเภทข้อมูล
TrafficDataแล้ว - เพิ่ม
ConsumerController.hideAllSessions()แล้วConsumerController.showSession()ไม่ยอมรับค่า Null เป็นอาร์กิวเมนต์อีกต่อไป
- เพิ่ม
v0.9.9 (15 กรกฎาคม 2020)
การเปลี่ยนแปลง API
- การเปลี่ยนแปลงครั้งสำคัญนี้เป็นการนำสถาปัตยกรรมแบบโมดูลมาใช้ โดยมีความสัมพันธ์ที่ชัดเจนยิ่งขึ้นระหว่างเลเยอร์ข้อมูลเท่านั้น (เช่น
ConsumerTripManager) และเลเยอร์อินเทอร์เฟซผู้ใช้ (เช่นJourneySharingSession) ดูข้อมูลเกี่ยวกับการย้ายข้อมูลไปยังสถาปัตยกรรมใหม่ได้ที่คำแนะนำในการย้ายข้อมูลแบบโมดูล - ตอนนี้ออบเจ็กต์ConsumerTripได้มาจากConsumerTripManager.getTrip()แล้วConsumerTrip.unregisterCallbackเปลี่ยนชื่อเป็นConsumerTrip.unregisterTripCallbackแล้วConsumerTrip.isCallbackRegisteredเปลี่ยนชื่อเป็นConsumerTrip.isTripCallbackRegisteredแล้ว- เพิ่ม
ConsumerTrip.setConsumerTripOptions()และConsumerTrip.getConsumerTripOptions()แล้ว - นำ
ConsumerTrip.setAutoRefreshInterval()ออกแล้ว
- นำ API การแชร์ที่ไม่ใช่การเดินทางออก
- นำแผนที่ความหนาแน่นของยานพาหนะออกแล้ว
- นำสถานะตัวอย่างการเดินทางออกแล้ว
- นำสถานะการเลือกการรับสินค้าออกแล้ว
- นำสถานะการเลือกจุดส่งออกแล้ว
- นำประเภทเครื่องหมายต่อไปนี้ออก:
SELECTED_PICKUP_POINT,SUGGESTED_PICKUP_POINT,HIGHLIGHTED_PICKUP_POINTและSELECTED_DROPOFF_POINT
- เปลี่ยน
OnConsumerMarkerClickCallbackและConsumerMapReadyCallbackจากอินเทอร์เฟซเป็นคลาสนามธรรม - เพิ่ม
ConsumerController.getCameraUpdate(),ConsumerController.isAutoCameraEnabled()และConsumerController.enableAutoCamera()แล้ว - นำ FAB ที่กำหนดเองและเมธอดที่เกี่ยวข้องออก (
ConsumerController.isMyLocationFabEnabledและConsumerController.setMyLocationFabEnabled)
การเปลี่ยนแปลงการติดตั้งใช้งาน
ConsumerTripCallbackไม่ว่าจะลงทะเบียนโดยมีหรือไม่มีLifecycleOwnerจะไม่ยกเลิกการลงทะเบียนโดยอัตโนมัติในTripStatus.COMPLETEหรือTripStatus.CANCELEDอีกต่อไป- ตอนนี้ระบบจะเปิดใช้ AutoCamera โดยค่าเริ่มต้น และจะไม่เปิดใช้หรือปิดใช้ตัวเองอีกครั้ง
ก่อนหน้านี้ กล้องอัตโนมัติจะเปิดใช้ใหม่โดยอัตโนมัติใน
TripStatus.ARRIVED_AT_PICKUPและปิดใช้เองเมื่อผู้ใช้โต้ตอบกับแผนที่ระหว่างการแชร์เส้นทาง - เราได้ปรับปรุงภาพเคลื่อนไหวของยานพาหนะในการแชร์เส้นทางดังนี้
- ตอนนี้ภาพเคลื่อนไหวการแชร์เส้นทางจะจัดการสถานการณ์ที่ยานพาหนะอาจเดินทางกลับตามเส้นทางที่เดินทางไปแล้วอย่างถูกต้องตามกฎหมาย
- ตอนนี้ยานพาหนะจะเคลื่อนไหวเป็นเส้นตรงแทนที่จะประมาณเส้นทางระหว่างจุดต่างๆ เมื่ออัลกอริทึมพิจารณาว่าเหมาะสม
- ไม่จำเป็นต้องใช้สิทธิ์
FINE_LOCATIONอีกต่อไป
การเปลี่ยนแปลงอื่นๆ
- อัปเดตเวอร์ชันทรัพยากร Dependency ต่อไปนี้
- com.google.android.datatransport:transport-api:2.2.0
- com.google.android.datatransport:transport-backend-cct:2.2.0
- com.google.android.datatransport:transport-runtime:2.2.0
v0.9.1 (23 มีนาคม 2020)
การเปลี่ยนแปลง API
- เพิ่ม
TripInfo.getVehicleId(),TripInfo.getNumberOfPassengers(),TripInfo.getIntermediateDestinationIndex(),TripInfo.getTripActiveRoute()และTripInfo.getTripRemainingRoute()แล้ว - เพิ่มคลาส
optionsที่ใช้ระหว่างการเริ่มต้นConsumerApiซึ่งช่วยให้ตั้งค่าที่อยู่FleetEngineแบบไดนามิกได้ หากไม่ได้เรียกใช้ API ด้วยค่าFleetEngineระบบจะพยายามดึงค่าจากไฟล์ Manifest ของ Android หรือกลับไปใช้ค่าเริ่มต้น
การปรับปรุง
- ระบบจะไม่แสดงเส้นประกอบของเส้นทางเมื่อสถานะการเดินทางเป็น
ARRIVED_AT_PICKUP - ปรับปรุงการติดตามยานพาหนะนอกเส้นทาง (ต้องใช้ DriverSDK 1.15) ดังนี้
- การติดตามยานพาหนะจะไม่ล็อกยานพาหนะไว้กับเส้นทางเมื่อยานพาหนะขับผ่านจุดรับ
- การติดตามยานพาหนะช่วยให้แสดงยานพาหนะนอกถนนได้ เช่น ในลานจอดรถที่ไม่ได้ระบุไว้ในแผนที่
- ตอนนี้ไอคอนยานพาหนะจะอัปเดตเมื่อจุดหมายของคนขับไม่ตรงกับจุดหมายใน Fleet Engine
v0.8.6 (16 ธันวาคม 2019)
การเปลี่ยนแปลง API
เพิ่ม
TripInfo.getVehicleLocation()แล้วConsumerMapViewไม่ใช่เวอร์ชันสุดท้ายอีกต่อไป
การเปลี่ยนแปลงการติดตั้งใช้งาน
- ตอนนี้ระบบจะคำนวณระยะทางที่เหลือของช่วงที่ใช้งานอยู่โดยใช้ระยะทางของเซิร์ฟเวอร์ (รายงานคนขับ + เส้นทางคงที่ หากมี) แทนการสแนปในเครื่อง การเปลี่ยนแปลงนี้จะทำให้ค่าระยะทางที่เหลือมีความแม่นยำมากขึ้น
การเปลี่ยนแปลงอื่นๆ
ต้องใช้ทรัพยากร Dependency ใหม่ ดูรายละเอียดได้ที่ไฟล์ .pom
- com.google.android.datatransport:transport-api:2.0.0
- com.google.android.datatransport:transport-backend-cct:2.0.2
- com.google.android.datatransport:transport-runtime:2.0.0
เพิ่มบันทึกสำหรับเวลาในการตอบสนองของคำขอการเดินทาง
เพิ่มบันทึกสำหรับข้อผิดพลาดในการตอบกลับการเดินทาง
หมายเหตุ
- ตั้งแต่เวอร์ชัน 0.8.1 เป็นต้นมา Consumer SDK สำหรับ Android จะจัดส่งเป็นไฟล์เก็บถาวรแบบ ZIP ที่ผ่านการ Jetify แล้ว ดูข้อมูลเกี่ยวกับวิธี De-jetify ได้ที่ Jetifier: Reverse mode
v0.8.1 (13 กันยายน 2019)
ฟีเจอร์ใหม่
การรองรับ ConsumerMapView
ตอนนี้อาร์ติแฟกต์ ODRD จะจัดส่งในที่เก็บ Maven แทนไฟล์ ZIP .aar ดูข้อมูลเพิ่มเติมได้ที่หัวข้อเพิ่ม Consumer SDK ลงในแอป
การเปลี่ยนแปลง API
เพิ่ม
ConsumerController.disableAutoCamera()เป็นฟังก์ชันตรงข้ามกับcenterMapForState()แล้วตอนนี้
VehicleLocation.getUpdateTime()จะแสดงผลเป็น Long ซึ่งแสดงการประทับเวลา (เป็นมิลลิวินาที)ปรับอินเทอร์เฟซ
AuthTokenFactoryให้เรียบง่ายขึ้นเพื่อแสดงเมธอดเดียวสำหรับการสร้างโทเค็น เปลี่ยนAuthTokenFactoryจากอินเทอร์เฟซเป็นคลาสแอบสแตรกต์เพื่อให้เข้ากันได้แบบย้อนหลังใน Java7 การเปลี่ยนแปลงนี้เข้ากันได้แบบย้อนหลัง แต่วิธีการเดิมสำหรับการสร้างโทเค็นบริการเดียวจะเลิกใช้งานแล้ว และจะถูกนำออกในที่สุด
การเปลี่ยนแปลงการติดตั้งใช้งาน
ตอนนี้ชิ้นงานจะอยู่ตรงกลางของไอคอน ซึ่งจะช่วยลดการออฟเซ็ตของเงา
setStateถึงJOURNEY_SHARING onStartTripMonitoring()แทนที่จะรอสถานะการเดินทางที่ตรวจสอบแสดงข้อมูลสำหรับการอัปเดตข้อมูลการเดินทางครั้งแรกเสมอ แม้ว่าข้อมูลการเดินทางจะไม่ซิงค์กันก็ตาม
เพิ่ม Android Map Utils เป็นทรัพยากร Dependency ที่ระบุ
การแก้ไขข้อบกพร่อง
- แก้ไขไวยากรณ์การส่งออก ProGuard ที่ใช้งานไม่ได้สำหรับ grpc keep
v0.7.0 (7 สิงหาคม 2019)
ฟีเจอร์ใหม่
- การรองรับหลายปลายทางสำหรับการแชร์เส้นทาง
การเปลี่ยนแปลง API
วิธีการใหม่สำหรับ
ConsumerTripCallbackonTripIntermediateDestinationsUpdated()onTripETAToNextTripWaypointUpdated()
ConsumerControllerวิธีใหม่getIntermediateDestinations()setIntermediateDestinations(List<TerminalLocation> intermediateDestinations)
TripStatusesใหม่TripStatus.ENROUTE_TO_INTERMEDIATE_DESTINATIONTripStatus.ARRIVED_AT_INTERMEDIATE_DESTINATION
TripWaypointรายใหม่getETAMillis()getDistanceMeters()
เพิ่มชั้นเรียน
TripInfoแล้ว- คุณสามารถดู
TripInfoสำหรับการเดินทางที่ดำเนินอยู่ได้ด้วยConsumerTripManager.getActiveTripInfo()
- คุณสามารถดู
เพิ่ม
WaypointType.INTERMEDIATE_DESTINATIONแล้วเพิ่ม
MarkerType.TRIP_INTERMEDIATE_DESTINATIONแล้วสร้าง
ConsumerMapState.JOURNEY_SHARINGจากConsumerMapStatesที่ผสานรวมแล้วENROUTE_TO_PICKUP,ARRIVED_AT_PICKUP,ENROUTE_TO_DROPOFFและCOMPLETEอัปเดต
StateChangeCallbacksแล้วเพิ่ม
onStateJourneySharing()แล้วนำ
onStateWaitingForPickup(),onStateDriverArrived(),onStateEnroute()และonStateEndofTrip()ออกแล้ว
การแก้ไขข้อบกพร่อง
แก้ไขข้อบกพร่องที่ระบบไม่ตัดเส้นทางไปยังตำแหน่งของยานพาหนะเมื่อการตรวจสอบการเดินทางเริ่มต้นขึ้นระหว่างการเดินทางที่ดำเนินอยู่ (ไม่ใช่ที่ต้นทางของเส้นทาง)
แก้ไขข้อบกพร่องที่ระบบไม่เรียกใช้ Callback ของการเดินทางสำหรับ Listener ที่ลงทะเบียนใน TripManager หลังจากที่ TripManager ดึงข้อมูลการเดินทางแล้ว
ตอนนี้การซูมกล้องจะรวมเฉพาะเส้นทางที่ใช้งานอยู่และจุดอ้างอิงการเดินทางถัดไป (จุดอ้างอิงที่เป็นของการเดินทาง) แม้ว่าขาที่เหลือจะมองเห็นได้ แต่การซูมจะไม่รวมขานั้นไว้ ก่อนหน้านี้ จุดส่งผู้โดยสารจะรวมอยู่ในการซูมเมื่อยานพาหนะอยู่ระหว่างทางไปรับหรือมาถึงจุดรับแล้ว แต่ตอนนี้ไม่เป็นเช่นนั้นแล้ว
การปรับปรุง
ป้อนข้อมูลคนขับในจุดอ้างอิงที่เหลือจุดที่ 0 (ระบบจะแสดงรายการจุดอ้างอิงที่เหลือจาก
ConsumerTripCallback.onTripRemainingWaypointsUpdatedและTripInfo.getRemainingWaypoints()อัปเดต ETA ของจุดอ้างอิงที่เหลือทั้งหมดเมื่อ ETA ของจุดอ้างอิงแรกในรายการเปลี่ยนแปลง
บังคับให้เปิดใช้กล้องอัตโนมัติอีกครั้งเฉพาะเมื่อคนขับมาถึงจุดรับเท่านั้น ก่อนหน้านี้ กล้องอัตโนมัติจะรีเซ็ตเป็นเปิดใช้ทุกครั้งที่สถานะการเดินทางเปลี่ยนแปลง ระบบจะยังคงเปิดใช้กล้องอัตโนมัติโดยค่าเริ่มต้น กล้องอัตโนมัติจะไม่เปิดใช้อีกครั้งหากมีการตั้งค่าการเดินทางใหม่ที่ใช้งานอยู่โดยไม่มีการเรียกใช้
startTripMonitoring()ใหม่
v0.6.1 (26 มิถุนายน 2019)
ฟีเจอร์ใหม่
- การรองรับการแชร์เส้นทางสำหรับคาร์พูล
การเปลี่ยนแปลง API
ตอนนี้
ConsumerController.getConsumerMapStyle()จะแสดงผลเป็นConsumerMapStyleแทนTask<ConsumerMapStyle>เพิ่ม
PolylineStyle.setZIndex()แล้ว
การแก้ไขข้อบกพร่อง
ตอนนี้ภาพเคลื่อนไหวของเส้นทางจะแสดงเมื่อส่วนของเส้นทางซิงค์กันเท่านั้น ซึ่งจะช่วยปรับปรุงประสบการณ์ของผู้ใช้
แก้ไข "การกะพริบ" ของยานพาหนะระหว่างการประมาณค่าในช่วงภาพเคลื่อนไหวเมื่อการอัปเดตตำแหน่งคนขับอยู่ใกล้กัน
แก้ไขข้อบกพร่องที่ยานพาหนะเริ่มที่ต้นเส้นทางแทนที่จะเป็นตำแหน่งที่อัปเดตล่าสุดเมื่อการตรวจสอบการเดินทางเริ่มขึ้นระหว่างการเดินทางที่ดำเนินอยู่
แสดงเส้นประกอบของเส้นทางที่ใช้งานอยู่เหนือเส้นทางที่เหลือเมื่อทับซ้อนกัน
การปรับปรุง
- ตอนนี้ให้แสดงคลาส gRPC
Statusด้วยเมธอดที่ไม่ได้ผ่านการสร้างความสับสน
v0.5.1.01 (17 พฤษภาคม 2019)
ฟีเจอร์ใหม่
- การรองรับการแชร์เส้นทางแบบต่อเนื่อง
การเปลี่ยนแปลง API
- ชั้นเรียน
ConsumerControllerใหม่
PolylineType
| ค่าเดิม | ค่าใหม่ |
|---|---|
TRIP_PREVIEW_AUTO_ROUTE |
PREVIEW_AUTO_ROUTE |
TRIP_PREVIEW_TAXI_ROUTE |
PREVIEW_TAXI_ROUTE |
TRIP_PREVIEW_TRUCK_ROUTE |
PREVIEW_TRUCK_ROUTE |
TRIP_PREVIEW_TWO_WHEELER_ROUTE |
PREVIEW_TWO_WHEELER_ROUTE |
TRIP_ROUTE |
ACTIVE_ROUTE |
REMAINING_ROUTE |
ConsumerTripCallback
| ค่าเดิม | ค่าใหม่ |
|---|---|
onTripRouteUpdated |
onTripActiveRouteUpdated |
onTripRemainingDistanceUpdated |
onTripActiveRouteRemainingDistanceUpdated |
onTripRemainingWaypointsUpdated() |
ConsumerController
- ตอนนี้คุณตั้งค่า Callback สำหรับสถานะต่างๆ ได้โดยไม่ต้องเข้าสู่สถานะ
| วิธีการ | การติดต่อกลับ |
|---|---|
startPickupSelection |
setPickupSelectionCallback |
startDropoffSelection |
setDropoffSelectionCallback |
startTripPreview |
setTripPreviewSelectionCallback |
ConsumerController.setLanguage(String languageCode)ช่วยให้คุณตั้งค่าภาษาที่ใช้ในการเรียก FleetEngine ได้ (เช่น สำหรับคำอธิบายจุดรับ)
การปรับปรุง
- ตอนนี้สถานะการเลือกจุดส่งมีหมุดที่ลากได้แล้ว
- นำภาพเคลื่อนไหวของกล้องในสถานะ
INITIALIZEออกแล้ว - แทนที่
ManagedChannelBuilderด้วยAndroidChannelBuilderแล้ว