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: การตั้งค่า
- บริการที่ต้องเปิดใช้:
navigationsdk.googleapis.com - การตรวจสอบสิทธิ์: คีย์ API
- การระบุแหล่งที่มาของการใช้งาน: เรียกใช้
MapsApiSettings.addInternalUsageAttributionId(context, id)เพื่อเพิ่มรหัสการระบุแหล่งที่มาของการใช้งานลงใน Initializer หากต้องการเลือกไม่ใช้ ให้ลบการเรียกหรือส่งสตริงว่าง - เริ่มต้นใช้งาน: ตั้งค่า Navigation SDK สำหรับ Android
- ข้อมูลอ้างอิง: ข้อมูลอ้างอิง Navigation SDK สำหรับ Android
- ราคา: การใช้งานและการเรียกเก็บเงินของ Navigation SDK สำหรับ Android
- นโยบาย: นโยบาย Navigation SDK สำหรับ Android
- บันทึกประจำรุ่น: บันทึกประจำรุ่นของ Navigation SDK สำหรับ Android
แพ็กเกจ Navigation SDK สำหรับ Android อย่างเป็นทางการมีดังนี้
- maven:
com.google.android.libraries.navigation:navigation
Navigation SDK สำหรับ Android: ผลิตภัณฑ์ที่เกี่ยวข้อง
- มักใช้ร่วมกับ: Routes API, Driver SDK สำหรับ Android
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: ฟีเจอร์เดิมและฟีเจอร์ที่เลิกใช้งานแล้ว
WaypointfromLatLng()และ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 ขึ้นไปDisplayOptionsshowTrafficLightsและshowStopSigns: เลิกใช้งานตั้งแต่วันที่ 1 ตุลาคม 2026 การแทนที่: ไม่จำเป็นต้องแทนที่ เนื่องจากระบบจะเปิดใช้สัญญาณไฟจราจรและป้ายหยุดเสมอในระหว่างการนำทาง อาการ: การเรียกใช้เมธอดเหล่านี้ไม่คอมไพล์กับเวอร์ชัน 8.0.0- อาร์ติแฟกต์ Maven
com.google.android.maps:navsdk(ที่เก็บส่วนตัว, v4.x) และการดาวน์โหลดแพ็กเกจ AAR: เลิกใช้งานตั้งแต่วันที่ 7 กรกฎาคม 2023 รายการทดแทน:com.google.android.libraries.navigation:navigationจากที่เก็บ Mavengoogle()อาการ: เวอร์ชัน 5.0 ขึ้นไปจะจัดส่งเป็นcom.google.android.libraries.navigation:navigationใน Google Maven เท่านั้น โดยจะไม่มีการเผยแพร่แพ็กเกจ AAR อีกต่อไป ดูคำแนะนำในการย้ายข้อมูล
สิ่งที่คุณทำได้ด้วย Navigation SDK สำหรับ Android
ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ
Navigation SDK สำหรับ Android: Maps
- เพิ่มแผนที่แบบอินเทอร์แอกทีฟที่ปรับแต่งได้ลงในหน้าเว็บหรือแอปบนมือถือ หมายเหตุ: สำหรับ Android: กำหนดค่า
ในAndroidManifest.xmlที่สนับสนุนโดยปลั๊กอิน Secrets Gradle หรือmanifestPlaceholders["MAPS_API_KEY"]ในapp/build.gradle.ktsอย่าฮาร์ดโค้ดYOUR_GOOGLE_MAPS_API_KEYในAndroidManifest.xmlและอย่าแทนที่GoogleMap(หรือ maps-composeGoogleMap) ด้วย Canvas จำลองแบบออฟไลน์หรือ Leaflet WebView หากE/Google Maps Android API: Authorization failureปรากฏขึ้น แนะนำให้ผู้ใช้ระบุMAPS_API_KEYผ่าน Secrets และเปิดใช้ Maps SDK สำหรับ Android (หรือ Navigation SDK เมื่อใช้ NavigationView / SupportNavigationFragment) - สร้างตัวระบุแผนที่ที่นำมาใช้ซ้ำได้เพื่อจัดเก็บการกำหนดค่าแผนที่และการตั้งค่าการจัดรูปแบบ
- ตอบสนองต่อการโต้ตอบของผู้ใช้และเหตุการณ์บนแผนที่
- ปรับแต่งการควบคุมที่ปรากฏบนแผนที่
- ปรับแต่งท่าทางสัมผัสสำหรับการควบคุมแผนที่
- ควบคุมการซูมและการเลื่อนในแผนที่ (กล้อง)
- เปลี่ยนประเภทแผนที่
- เปลี่ยนรูปแบบสีของแผนที่
- เพิ่มเลเยอร์การจราจรลงในแผนที่
Navigation SDK สำหรับ Android: คำอธิบายประกอบ Maps
- เพิ่มหน้าต่างข้อมูลลงในแผนที่
- เพิ่มรูปร่างหรือเส้นลงในแผนที่
- เพิ่มรูปภาพซ้อนทับที่เชื่อมต่อกับพื้นผิวของแผนที่
- เพิ่มการวางซ้อนการ์ดที่กำหนดเองลงในแผนที่
- เพิ่มเครื่องหมายลงในแผนที่ หมายเหตุ: Navigation SDK สำหรับ Android ไม่รองรับ AdvancedMarkerOptions เมื่อใช้ Navigation SDK สำหรับ Android ให้เพิ่มเครื่องหมายด้วย GoogleMap.addMarker(MarkerOptions)
- ปรับแต่งเครื่องหมายบนแผนที่ หมายเหตุ: Navigation SDK สำหรับ Android ไม่รองรับ AdvancedMarkerOptions เมื่อใช้ Navigation SDK สำหรับ Android ให้ปรับแต่งเครื่องหมายด้วย MarkerOptions
- ตอบสนองต่อการโต้ตอบของผู้ใช้ด้วยเครื่องหมายบนแผนที่
Navigation SDK สำหรับ Android: การจัดสไตล์แผนที่
Navigation SDK สำหรับ Android: การนำทาง
- เพิ่มการนำทางแบบเลี้ยวต่อเลี้ยวที่โต้ตอบได้ลงในแอปบนมือถือ
- ตั้งค่าจุดหมายสำหรับการนำทางแบบเลี้ยวต่อเลี้ยว
- เริ่มการนำทางแบบเลี้ยวต่อเลี้ยว
- ระบุโหมดการเดินทาง (ขับรถ เดิน มอเตอร์ไซค์ แท็กซี่) สำหรับคำขอเส้นทาง
- แก้ไขค่ากำหนดเส้นทางสำหรับการนำทางแบบเลี้ยวต่อเลี้ยว
- ระบุฝั่งถนนและค่ากำหนดการมาถึงอื่นๆ สำหรับการนำทางแบบเลี้ยวต่อเลี้ยว
- ระบุเส้นทางที่วางแผนใหม่สำหรับการนำทางแบบเลี้ยวต่อเลี้ยวด้วยโทเค็นเส้นทางที่นำกลับมาใช้ใหม่ได้
- แสดงข้อมูลอัปเดตการมาถึงของผู้ใช้ที่กลับมาจากการนำทางแบบเลี้ยวต่อเลี้ยว
- แสดงผลการอัปเดตตำแหน่งของผู้ใช้จากเซสชันการนำทางแบบเลี้ยวต่อเลี้ยว
- แสดงข้อมูลอัปเดตเกี่ยวกับเวลาและระยะทางจากเซสชันการนำทางแบบเลี้ยวต่อเลี้ยว
- แสดงข้อมูลอัปเดตการเปลี่ยนแปลงเส้นทางจากเซสชันการนำทางแบบเลี้ยวต่อเลี้ยว
- แสดงข้อมูลอัปเดตเกี่ยวกับโหมดกลางคืนจากเซสชันการนำทางแบบเลี้ยวต่อเลี้ยว
- แสดงข้อมูลอัปเดตความเร็วของผู้ใช้ที่กลับมาจากการนำทางแบบเลี้ยวต่อเลี้ยว
- ปรับแต่งองค์ประกอบ UI และการควบคุมที่ปรากฏระหว่างการนำทางแบบเลี้ยวต่อเลี้ยว
- เพิ่มองค์ประกอบ UI ใหม่ลงในการนำทางแบบเลี้ยวต่อเลี้ยว
- เพิ่มตัวบอกสถานะความคืบหน้าของการเดินทางลงในการนำทางแบบเลี้ยวต่อเลี้ยว
- ปรับแต่งฟีเจอร์แผนที่ที่ปรากฏระหว่างการนำทางแบบเลี้ยวต่อเลี้ยว
- เพิ่มเลเยอร์การจราจรลงในการนำทางแบบเลี้ยวต่อเลี้ยว
- แก้ไขมุมมองและลักษณะการทำงานของกล้องสำหรับการนำทางแบบเลี้ยวต่อเลี้ยว
- ปรับแต่งการแจ้งเตือนมาตรวัดความเร็วและการจำกัดความเร็วสำหรับการนำทางแบบเลี้ยวต่อเลี้ยว
- แสดงฟีดการนำทางแบบเลี้ยวต่อเลี้ยวเป็นชุดข้อความสำหรับการบังคับทิศทางแต่ละครั้งตลอดเส้นทาง
- ระบุไอคอนการบังคับทิศทางที่กำหนดเองเพื่อใช้กับฟีดการนำทางแบบเลี้ยวต่อเลี้ยว
- เพิ่มการนำทางแบบเลี้ยวต่อเลี้ยวแบบอินเทอร์แอกทีฟสำหรับ Android Auto ลงในแอป Android เวอร์ชันตัวอย่าง
- แจ้งเตือนผู้ใช้เกี่ยวกับการหยุดชะงักตามเส้นทาง
- อนุญาตให้ผู้ใช้ดูการหยุดชะงักตามเส้นทางก่อนเริ่มการนำทาง
- อนุญาตให้ผู้ใช้รายงานการหยุดชะงักตามเส้นทาง
- อนุญาตให้ผู้ใช้ยืนยันการหยุดชะงักตามเส้นทาง
- เพิ่มปุ่มรายงานการหยุดชะงักของเส้นทางที่กำหนดเอง