ลองใช้เดโม

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

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

หากต้องการเริ่มต้นใช้งาน Navigation SDK โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้

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

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

ดาวน์โหลดแอปสาธิต

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

คุณสามารถดาวน์โหลดแอปเดโมต่อไปนี้ได้จาก GitHub ตั้งแต่ Navigation SDK สําหรับ Android เวอร์ชัน 4.1

• การสาธิต 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 และกำหนดค่าระบบเพื่อตรวจหาอุปกรณ์
   • โปรแกรมจำลอง - ใช้เครื่องมือจัดการอุปกรณ์เสมือน Android (AVD) เพื่อกำหนดค่าอุปกรณ์เสมือน เมื่อเลือกโปรแกรมจำลอง ให้ตรวจสอบว่าคุณเลือกภาพที่มี Google APIs

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

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

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

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

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

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

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

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

เริ่มต้นใช้งานโดยคลิกตั้งค่าปลายทาง แล้วเลือกที่อยู่ จากนั้นแอปจะจำลองการเดินทางจากตำแหน่งปัจจุบันของคุณไปยังที่อยู่ดังกล่าว ใช้การวางซ้อนแผงควบคุมเพื่อดูสิ่งที่เกิดขึ้นเมื่อคุณเรียก API เช่น คุณสามารถคลิกดูเมธอดเพื่อลองบังคับให้ 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 ไว้ในรายการ Dependencies

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

กำลังทำงาน

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

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

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

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

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

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