ลองใช้เดโม

การผสานรวม 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 แอปมีประโยชน์

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

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

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

ผู้ใช้งาน 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 ใน Dependency

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