ลองใช้เดโม

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

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

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

  • ตัวแทน Google Maps Platform สำหรับการเข้าถึงสิ่งต่อไปนี้

    • คีย์ API ที่จัดสรรไว้ให้ใช้กับ SDK การนำทาง คุณต้องระบุ รหัสโปรเจ็กต์ ซึ่งดูได้ในแดชบอร์ดหลักของ Google Cloud Console ใต้ชื่อโปรเจ็กต์
    • อาร์ติแฟกต์ SDK ตรวจสอบว่าได้กำหนดค่าโปรเจ็กต์แล้ว เพื่อใช้ Maven สำหรับ Navigation SDK
    • สำหรับโปรเจ็กต์ที่ใช้เวอร์ชัน 4.99.0 และเวอร์ชันก่อนหน้า หากใช้ Maven ไม่ได้ จะดาวน์โหลดอาร์ติแฟกต์ที่ซิปแล้วได้จาก Google ไดรฟ์ที่แชร์ ไฟล์ไลบรารีแบบคงที่คือ .aar ใน ไดเรกทอรี libs/ ที่มี Navigation SDK ในฐานะ แพ็กเกจ AAR
    • แอปสาธิตอย่างน้อย 1 รายการ
    • Android Studio สภาพแวดล้อมในการพัฒนาที่แนะนำสำหรับการสร้างแอป ด้วย Navigation SDK

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

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

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

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

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

  • การสาธิต GoogleMap: แสดงพฤติกรรมของGoogleMap สำหรับปรับแต่งลักษณะและการนำเสนอแผนที่

หมายเหตุเกี่ยวกับการใช้ Maven

แอปเดโมได้รับการกำหนดค่าให้ดาวน์โหลดอาร์ติแฟกต์ SDK จาก Maven ระยะไกล โดยใช้ปลั๊กอิน Artifact Registry ใน Gradle อย่าลืมทำตาม วิธีการกำหนดค่าโปรเจ็กต์ เพื่อรับสิทธิ์เข้าถึง SDK

การสาธิต Googlenavigation

การสาธิต Google Navigation ล่าสุดมีให้ใช้งานใน 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

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

กำลังทำงาน

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

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

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

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

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

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

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

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

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

ตัวเลือก SwappingMapAndNavActivity

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

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

การสาธิต GoogleMap

การสาธิต Google Navigation ล่าสุดมีให้ใช้งานใน 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

กำลังทำงาน

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

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

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

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

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