ลองใช้เดโม

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

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

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

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

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

หมายเหตุเกี่ยวกับการใช้ 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

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

กำลังวิ่ง

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

    • อุปกรณ์ Android - ดูinstructionsเปิดใช้ตัวเลือกสำหรับนักพัฒนาซอฟต์แวร์ในอุปกรณ์ 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

การสาธิต 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 ได้ในปลั๊กอิน Creleens ลับ

กำลังวิ่ง

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

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

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

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

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

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