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

Navigation SDK สำหรับ Android เพิ่มการนำทางแบบเลี้ยวต่อเลี้ยวของ Google Maps ลงในแอป Android พร้อมการปรับแต่ง UI และการกำหนดค่าเส้นทาง ซึ่งรวมถึงเลเยอร์ของแผนที่ Maps SDK ดังนั้นแอปที่ใช้ SDK นี้จึงไม่สามารถรวม Maps SDK สำหรับ Android ได้ด้วย

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

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

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

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

  • คุณต้องการการนำทางแบบเลี้ยวต่อเลี้ยวของ Google Maps ภายในแอป Android ของคุณเองเพื่อให้ผู้ใช้ไม่ต้องเปลี่ยนไปใช้แอปอื่น
  • คุณต้องปรับแต่ง UI การนำทางให้ตรงกับแบรนด์ หรือสร้างประสบการณ์การนำทางที่กำหนดเอง
  • คุณต้องใช้การนำทางในแอปสำหรับการขับรถ เดิน ปั่นจักรยาน หรือยานพาหนะ 2 ล้อ
  • คุณต้องไปยังเส้นทางที่วางแผนไว้ด้วย Routes API โดยส่งโทเค็นเส้นทางไปยัง SDK

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

  • คุณกำลังสร้างแอปสำหรับ iOS โปรดใช้ Navigation SDK สำหรับ iOS แทน
  • คุณกำลังสร้างแอปข้ามแพลตฟอร์มด้วย Flutter หรือ React Native โปรดใช้ Google Navigation สำหรับ Flutter และ React Native แทน
  • คุณต้องการเส้นทางฝั่งเซิร์ฟเวอร์, ETA หรือการคำนวณโทเค็นเส้นทาง ไม่ใช่คำแนะนำแบบเลี้ยวต่อเลี้ยวในแอป โปรดใช้ Routes API แทน

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

แพ็กเกจ Navigation SDK สำหรับ Android อย่างเป็นทางการมีดังนี้

  • maven: com.google.android.libraries.navigation:navigation

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

  • ปัญหา: Navigation SDK รวม Maps SDK ไว้แล้ว บิลด์ที่ดึง play-services-maps เข้ามาโดยตรงหรือผ่านทรัพยากร Dependency แบบทรานซิทีฟจะทำให้มีสำเนา Maps SDK ซ้ำกัน วิธีแก้ไข: ยกเว้น com.google.android.gms:play-services-maps จากทรัพยากร Dependency ทั้งหมด (การยกเว้นการกำหนดค่า Gradle หรือการยกเว้น Maven) และนำทรัพยากร Dependency ของ Maps SDK โดยตรงออก ดู /maps/documentation/navigation/android-sdk/android-studio-setup
  • ปัญหา: Navigation SDK 8.0 ขึ้นไปประกาศ minAndroidGradlePluginVersion=9.0.1 ดังนั้นบิลด์ที่มี AGP เวอร์ชันก่อนหน้าจึงไม่สำเร็จ วิธีแก้ไข: อัปเกรดเป็น AGP 9.0.1, Gradle 9.1.0 และ Kotlin 2.3.0 ก่อนสร้างด้วย 8.0+ ดู /maps/documentation/navigation/android-sdk/kotlin-compatibility-migration
  • ปัญหา: การเรียกใช้เมธอดวงจร NavigationView โดยตรงขณะใช้ NavigationFragment หรือการเรียกใช้เมธอดดังกล่าวไม่เป็นไปตามลำดับด้วย NavigationView จะทำให้เกิดข้อผิดพลาด วิธีแก้ไข: ใช้ NavigationFragment ซึ่งจัดการ Lifecycle Callback หากคุณใช้ NavigationView ให้ส่งต่อเมธอดวงจรตามลำดับที่เข้มงวด ดู /maps/documentation/navigation/android-sdk/nav-map-interactions-best-practices
  • ปัญหา: การนำทางจะใช้งานไม่ได้จนกว่าผู้ใช้จะยอมรับข้อกำหนดในการให้บริการของ Google Navigation วิธีแก้ไข: ให้ SDK แสดงข้อความแจ้งในครั้งแรกที่มีการเรียกใช้ Navigator หรือแสดงกล่องโต้ตอบก่อนหน้านั้น (เช่น ระหว่างการลงชื่อสมัครใช้) ด้วย TermsAndConditionsCheckOption / NavigationApi.showTermsAndConditionsDialog ดู /maps/documentation/navigation/android-sdk/route

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

  • Waypoint fromLatLng() และ fromPlaceId(): เลิกใช้งานตั้งแต่วันที่ 10 พฤษภาคม 2021 รายการทดแทน: Waypoint.builder() (Waypoint.Builder) อาการ: นำออกในเวอร์ชัน 3.0 การเรียกจะไม่คอมไพล์กับเวอร์ชัน 3.0 ขึ้นไป ดูคำแนะนำในการย้ายข้อมูล
  • SupportNavigationFragment: เลิกใช้งานตั้งแต่วันที่ 01-10-2026 การเปลี่ยนทดแทน: NavigationFragment อาการ: เลิกใช้งานใน Navigation SDK v8.0.0 ดูคำแนะนำในการย้ายข้อมูล
  • setLocationMarkerEnabled ใน NavigationView และ SupportNavigationFragment: เลิกใช้งานตั้งแต่วันที่ 7 ก.ค. 2023 การเปลี่ยนทดแทน: GoogleMap.setMyLocationEnabled อาการ: นำออกในเวอร์ชัน 5.0.0 (เลิกใช้งานในเวอร์ชัน 4.1) การเรียกจะไม่คอมไพล์กับเวอร์ชัน 5.0 ขึ้นไป
  • DisplayOptions showTrafficLights และ showStopSigns: เลิกใช้งานตั้งแต่วันที่ 1 ตุลาคม 2026 การแทนที่: ไม่จำเป็นต้องแทนที่ เนื่องจากระบบจะเปิดใช้สัญญาณไฟจราจรและป้ายหยุดเสมอในระหว่างการนำทาง อาการ: การเรียกใช้เมธอดเหล่านี้ไม่คอมไพล์กับเวอร์ชัน 8.0.0
  • อาร์ติแฟกต์ Maven com.google.android.maps:navsdk (ที่เก็บส่วนตัว, v4.x) และการดาวน์โหลดแพ็กเกจ AAR: เลิกใช้งานตั้งแต่วันที่ 7 กรกฎาคม 2023 รายการทดแทน: com.google.android.libraries.navigation:navigation จากที่เก็บ Maven google() อาการ: เวอร์ชัน 5.0 ขึ้นไปจะจัดส่งเป็น com.google.android.libraries.navigation:navigation ใน Google Maven เท่านั้น โดยจะไม่มีการเผยแพร่แพ็กเกจ AAR อีกต่อไป ดูคำแนะนำในการย้ายข้อมูล

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

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

Navigation SDK สำหรับ Android: Maps

Navigation SDK สำหรับ Android: คำอธิบายประกอบ Maps

Navigation SDK สำหรับ Android: การจัดสไตล์แผนที่

Navigation SDK สำหรับ Android: การนำทาง