ข้อมูลอ้างอิงด่วนของ Consumer SDK สำหรับ Android

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

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

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

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

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

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

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

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

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

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

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-consumer

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

  • ปัญหา: หากไม่ได้ตั้งค่าทรัพยากร Dependency ของ Maps SDK เป็นเวอร์ชันที่ชัดเจน Consumer SDK จะใช้ Maps SDK เวอร์ชันขั้นต่ำที่จำเป็น ซึ่งอาจทำให้แอปที่ใช้ฟีเจอร์ใน Maps SDK เวอร์ชันใหม่ๆ เสียหายได้ วิธีแก้ไข: ประกาศเวอร์ชัน play-services-maps ที่กำหนดไว้อย่างชัดเจนควบคู่ไปกับ transportation-consumer ใน Gradle หรือ Maven ดู /maps/documentation/mobility/journey-sharing/on-demand/android/configure-project
  • ปัญหา: การไม่หยุดแชร์เส้นทางหลังจากการเดินทางสิ้นสุดลงจะทำให้เกิดคำขอเครือข่ายที่ไม่จำเป็นไปยัง Fleet Engine และหน่วยความจำรั่วไหล วิธีแก้ไข: เรียกใช้ JourneySharingSession.stop() เมื่อไม่จำเป็นต้องใช้การเดินทางอีกต่อไป เช่น ใน onDestroy() หรือเมื่อการเดินทางเป็น COMPLETE ดู /maps/documentation/mobility/journey-sharing/on-demand/android/share-journey
  • ปัญหา: ConsumerApi.initialize() จะแสดงข้อยกเว้นหากมีอินสแตนซ์ API อยู่แล้ว (2.0.0 ขึ้นไป) วิธีแก้ไข: เรียกใช้ ConsumerApi.getInstance() ก่อน แล้วตรวจสอบ Task ที่แสดงผลเพื่อดูว่ามีอินสแตนซ์อยู่แล้วหรือไม่ ดู /maps/documentation/mobility/services/resources/relnotes_consumer_sdk_android
  • ปัญหา: Consumer SDK เวอร์ชัน 3 และต่ำกว่าไม่รองรับโหมด R8 แบบเต็ม แอปที่กำหนดเป้าหมายเป็น AGP 8.0 ขึ้นไปอาจพบปัญหาเกี่ยวกับบิลด์หรือรันไทม์ วิธีแก้ไข: ตั้งค่า android.enableR8.fullMode=false เมื่อกำหนดเป้าหมายเป็น AGP 8.0 ขึ้นไป และใช้ AGP 7.3 ขึ้นไปกับ Kotlin 2.0 สำหรับ Consumer SDK 3.0 ขึ้นไป ดู /maps/documentation/mobility/journey-sharing/on-demand/android/migration-guide-v3

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

  • ConsumerTrip, ConsumerTripCallback, ConsumerTripManager, ConsumerTripOptions: เลิกใช้งานตั้งแต่วันที่ 15-09-2023 การเปลี่ยนทดแทน: TripModel, TripModelCallback, TripModelManager, TripModelOptions ดูคำแนะนำในการย้ายข้อมูล
  • คลาส Trip และคำอธิบายประกอบ Trip.TripStatus / Trip.TripType (รวมถึง TripInfo#getTripStatus(), TripInfo#getTripType(), TripModelCallback#onTripStatusUpdated): เลิกใช้งานตั้งแต่วันที่ 15 กันยายน 2023 การเปลี่ยนทดแทน: TripInfo.TripStatus / TripInfo.TripType, TripInfo#getCurrentTripStatus(), TripInfo#getCurrentTripType(), TripModelCallback#onTripStatusUpdate ดูคำแนะนำในการย้ายข้อมูล
  • MarkerStyleOptions และ PolylineStyleOptions: เลิกใช้งานตั้งแต่วันที่ 30-11-2021 รายการทดแทน: MarkerOptions และ PolylineOptions (แชร์กับ Maps SDK) อาการ: Consumer SDK ใช้สไตล์เริ่มต้นของตนเองต่อเครื่องหมายหรือประเภทเส้นประกอบ ไม่ใช่ค่าเริ่มต้นของ MarkerOptions ดูคำแนะนำในการย้ายข้อมูล
  • ช่องทางการเผยแพร่ที่เก็บส่วนตัว: เลิกใช้งานแล้ว รายการทดแทน: ที่เก็บ Maven ของ Google (เวอร์ชัน 2.1.0 ขึ้นไป) ดูคำแนะนำในการย้ายข้อมูล

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

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