ลองใช้เดโม

เมื่อผสานรวม Navigation SDK สำหรับ Android แอปของคุณก็ทำได้ดีกว่าการลิงก์ไปยังมุมมองแผนที่ภายนอก เมื่อใช้การนําทางของ Google Maps แอปของคุณจะดึงข้อมูลแบบไดนามิกและรายงานข้อมูลเกี่ยวกับเส้นทางของผู้ใช้ได้ในหน้าเดียว คู่มือนี้อธิบายวิธีเรียกใช้แอปเดโม Navigation SDK ซึ่งพร้อมใช้งานใน GitHub

เตรียมความพร้อม

หากต้องการเริ่มต้นใช้งาน Navigation SDK โปรดมีรายการดังต่อไปนี้

• คีย์ API ที่จัดสรรไว้ให้ใช้กับ Navigation SDK ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างและการจำกัดคีย์ได้ในการใช้คีย์ API
• อาร์ติแฟกต์ SDK ตรวจสอบว่าได้กำหนดค่าโปรเจ็กต์ให้ใช้ Maven สำหรับ SDK การนำทางแล้ว
• แอปเดโมอย่างน้อย 1 แอป
• Android Studio สภาพแวดล้อมในการพัฒนาซอฟต์แวร์ที่แนะนำสำหรับการสร้างแอปด้วย รหัสการนำทาง SDK

เอกสารประกอบนี้ออกแบบมาสำหรับผู้ที่คุ้นเคยกับการพัฒนาแอป Android และแนวคิดการเขียนโปรแกรมเชิงวัตถุ รวมถึงความคุ้นเคยกับ Google Maps จากมุมมองของผู้ใช้ด้วย

ดาวน์โหลดแอปเดโม

Google มี 2 แอปที่จะช่วยให้คุณเข้าใจสิ่งที่ Navigation SDK มีให้นอกเหนือจาก Google Maps API โดยขึ้นอยู่กับระดับประสบการณ์ของคุณ นักพัฒนาซอฟต์แวร์ที่คุ้นเคยกับ Google Maps API จะมุ่งเน้นที่การสาธิต GoogleNavigation ได้ นักพัฒนาซอฟต์แวร์ที่เพิ่งเริ่มใช้ทั้ง 2 โปรเจ็กต์จะได้รับประโยชน์จากทั้ง 2 แอป

ใน Navigation SDK สำหรับ Android v4.1 แอปเดโมต่อไปนี้มีให้ดาวน์โหลดทั้งใน GitHub

• การสาธิต GoogleNavigation: แสดงการผสานรวมลักษณะการทํางานและมุมมองของ API ที่เกี่ยวข้องกับประสบการณ์ของผู้ใช้ขณะอยู่ในเซสชันการนําทางแบบมีคําแนะนํา

• การสาธิต GoogleMap: แสดงลักษณะการทํางานของอินเทอร์เฟซ GoogleMap แต่ละรายการเพื่อปรับแต่งรูปลักษณ์และการแสดงแผนที่

การสาธิต GoogleNavigation

ตัวอย่าง GoogleNavigation ล่าสุดมีอยู่ใน GitHub

อาคาร

1. ใน Android Studio ให้นําเข้าแอปเดโมและอนุญาตให้ Gradle ทำงาน

2. เปิด local.defaults.properties และอัปเดตค่าของพร็อพเพอร์ตี้ MAPS_API_KEY ดังนี้

     MAPS_API_KEY=YOUR_API_KEY
   

3. คลิกสร้างและตรวจสอบรายละเอียดการใช้งาน SDK

   • ในคลาส Java ให้จดบันทึกรหัสการใช้งาน

   • ใน XML ของเลย์เอาต์ ให้สังเกตการออกแบบเลย์เอาต์และข้อความ

   • ในไฟล์ build.gradle ให้จดบันทึก SDK ใน Dependency

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีเพิ่มคีย์ API ลงในไฟล์ Manifest ได้ในเอกสารประกอบของปลั๊กอิน Gradle สำหรับ Secret

กำลังทำงาน

1. โปรดเชื่อมต่ออุปกรณ์ Android กับคอมพิวเตอร์หรือใช้โปรแกรมจำลอง

   • อุปกรณ์ Android - ดูวิธีการเพื่อเปิดใช้ตัวเลือกสำหรับนักพัฒนาแอปในอุปกรณ์ Android และกำหนดค่าระบบให้ตรวจหาอุปกรณ์
   • โปรแกรมจำลองmdash;ใช้เครื่องมือจัดการอุปกรณ์เสมือน (AVD) ของ Android เพื่อกำหนดค่าอุปกรณ์เสมือน เมื่อเลือกโปรแกรมจำลอง ให้ตรวจสอบว่าคุณเลือกภาพที่มี Google APIs

2. ใน Android Studio ให้คลิกตัวเลือกเมนูเรียกใช้ (หรือไอคอนปุ่มเล่น) แล้วเลือกเป้าหมายการติดตั้งใช้งาน

เมื่อสร้างและเปิดใช้งานแล้ว แอปจะแสดงหน้า Landing Page ที่มีรายการตัวเลือกแก่ผู้ใช้

ตัวเลือก NavViewActivity และ NavFragmentActivity

ผู้ใช้รายใหม่ของ NavSDK มักจะพบว่าตัวเลือก 2 อย่างนี้เป็นประโยชน์มากที่สุด

ตัวเลือกที่ 1: NavViewActivity แสดงลักษณะการทำงานโดยใช้ NavigationView ร่วมกับ Navigator

ตัวเลือกที่ 2: ตัวเลือกที่ 2 ชื่อ NavFragmentActivity แสดงลักษณะการทำงานโดยใช้ SupportNavigationFragment ควบคู่ไปกับ Navigator

เมื่อคลิกตัวเลือกใดตัวเลือกหนึ่งแล้ว คุณจะเห็นข้อมูลต่อไปนี้

• UI การนำทาง
• ปุ่ม "กำหนดปลายทาง" ในเมนูของแอป
• การวางซ้อนที่คุณสามารถโต้ตอบด้วยเพื่อเรียกเมธอดแบบไดนามิกใน API
• เมนูรายการเพิ่มเติมที่มีตัวเลือกเพิ่มเติม

ในการเริ่มต้นใช้งาน ให้คลิกกำหนดปลายทางและเลือกที่อยู่ จากนั้นแอปจะจำลองการเดินทางจากตำแหน่งปัจจุบันของคุณไปยังที่อยู่นั้น ใช้การวางซ้อนแผงควบคุมเพื่อดูสิ่งที่จะเกิดขึ้นเมื่อคุณเรียก API ตัวอย่างเช่น คุณคลิกเมธอด View เพื่อบังคับให้ SDK เข้าสู่โหมดกลางคืนเพื่อดูว่ามีลักษณะเป็นอย่างไร

ตัวเลือก SwappingMapAndNavActivity

SwappingMapAndNavActivity แสดงรูปแบบที่พบได้ทั่วไปต่อไปนี้

• แสดง MapView
• เปลี่ยนเป็น NavigationView เมื่อการนําทางเริ่มต้น
• กลับไปยัง MapView เมื่อการนำทางสิ้นสุด

การสาธิต GoogleMap

ตัวอย่าง GoogleNavigation ล่าสุดมีอยู่ใน GitHub

อาคาร

1. ใน Android Studio ให้นำเข้าแอปเดโมและอนุญาตให้ Gradle ทำงาน

2. เปิด local.defaults.properties และอัปเดตค่าของพร็อพเพอร์ตี้ MAPS_API_KEY ดังนี้

     MAPS_API_KEY=YOUR_API_KEY
   

3. คลิกสร้างและตรวจสอบรายละเอียดการใช้งาน SDK

   • ในคลาส Java ให้จดบันทึกรหัสการใช้งาน

   • ใน XML ของเลย์เอาต์ ให้สังเกตการออกแบบเลย์เอาต์และข้อความ

   • ในไฟล์ build.gradle ให้สังเกต SDK ในทรัพยากร Dependency

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีเพิ่มคีย์ API ลงในไฟล์ Manifest ได้ที่ secrets gradle plugin

กำลังทำงาน

1. โปรดเชื่อมต่ออุปกรณ์ Android กับคอมพิวเตอร์หรือใช้โปรแกรมจำลอง

   • อุปกรณ์ Android โปรดดูคำแนะนำเพื่อเปิดใช้ตัวเลือกของนักพัฒนาซอฟต์แวร์บนอุปกรณ์ Android และกำหนดค่าระบบเพื่อตรวจหาอุปกรณ์
   • โปรแกรมจำลอง ใช้โปรแกรมจัดการอุปกรณ์เสมือน (AVD) ของ Android เพื่อกำหนดค่าอุปกรณ์เสมือน เมื่อเลือกโปรแกรมจำลอง ให้ตรวจสอบว่าคุณเลือกภาพที่มี Google APIs

2. ใน Android Studio ให้คลิกเมนูเรียกใช้ตัวเลือกเมนู (หรือไอคอนปุ่มเล่น) แล้วเลือกเป้าหมายการทำให้ใช้งานได้

เมื่อสร้างและเปิดตัวแล้ว แอปจะแสดงหน้า Landing Page ของรายการเดโมแก่ผู้ใช้

รูปแบบการนำเสนอและโครงสร้างของซอร์สโค้ดที่เกี่ยวข้องนี้น่าจะคุ้นเคยกับผู้ใช้เดโมของ Google Maps SDK เนื่องจากเดโมของ GoogleMap ออกแบบมาให้คล้ายกับแอปเดโม Maps API โดยมีความแตกต่างหลักคือการสาธิตการใช้งาน SDK การนำทางจะให้ผู้ใช้เลือกคลาสการแสดงผลที่ต้องการทดสอบเรียกใช้เดโม: NavigationView หรือ MapView หากทำได้

โดยทั่วไป Google สนับสนุนให้ผู้ใช้งานใช้ NavigationView การสาธิตนี้มีความยืดหยุ่นในการลองใช้ลักษณะการทำงานเหล่านี้ในทั้ง 2 เวอร์ชันในแอปสาธิตของเรา และเลือกเวอร์ชันที่เหมาะกับคุณ เช่น คุณยังอาจจำเป็นต้องใช้ MapView ในกรณีที่ใช้ไลบรารีของบุคคลที่สามที่คาดว่าจะโต้ตอบกับชั้นเรียนนั้น