ลองใช้เดโม

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

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

หากต้องการเริ่มต้นใช้งาน Navigation 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 ได้ในเอกสารประกอบของปลั๊กอิน Secrets Gradle

เรียกใช้

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

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

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

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

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

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

ตัวเลือกที่ 2: ตัวเลือกที่ 2 ชื่อ NavFragmentActivity แสดงลักษณะการทำงานโดยใช้ NavigationFragment ควบคู่กับ 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

เรียกใช้

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

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

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

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

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

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