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: การตั้งค่า
- การตรวจสอบสิทธิ์: JSON Web Token (JWT), คีย์ API
- เปิดใช้ด้วย: บริการ Fleet Engine, Maps SDK สำหรับ Android
- เริ่มต้นใช้งาน: ตั้งค่า Consumer SDK สำหรับ Android
- ข้อมูลอ้างอิง: ข้อมูลอ้างอิง Consumer SDK สำหรับ Android
- นโยบาย: นโยบาย Consumer SDK สำหรับ Android
- บันทึกประจำรุ่น: บันทึกประจำรุ่นของ Consumer SDK สำหรับ Android
แพ็กเกจ Consumer SDK สำหรับ Android อย่างเป็นทางการ
- maven:
com.google.android.libraries.mapsplatform.transportation:transportation-consumer
Consumer SDK สำหรับ Android: สินค้าที่เกี่ยวข้อง
- มักใช้ร่วมกับ: บริการ Fleet Engine, Driver SDK สำหรับ Android, Maps SDK สำหรับ Android
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
ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ
- เพิ่มแผนที่แบบอินเทอร์แอกทีฟที่ปรับแต่งได้ซึ่งติดตามความคืบหน้าของการเดินทางจาก 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