ลองใช้เดโม

เมื่อผสานรวม 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 ที่มีรายการตัวเลือกแก่ผู้ใช้

ผู้ใช้รายใหม่ของ 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 ในกรณีที่ใช้ไลบรารีของบุคคลที่สามที่คาดว่าจะโต้ตอบกับชั้นเรียนนั้น