เมื่อผสานรวม 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
สร้าง
ใน Android Studio ให้นำเข้าแอปเดโมและอนุญาตให้ Gradle ทำงาน
เปิด
local.defaults.properties
และอัปเดตค่าของพร็อพเพอร์ตี้MAPS_API_KEY
ดังนี้MAPS_API_KEY=YOUR_API_KEY
คลิกสร้างและตรวจสอบรายละเอียดการใช้งาน SDK
ในคลาส Java ให้จดบันทึกรหัสการใช้งาน
ใน XML ของเลย์เอาต์ ให้สังเกตการออกแบบเลย์เอาต์และข้อความ
ในไฟล์
build.gradle
ให้สังเกต SDK ในทรัพยากร Dependency
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีเพิ่มคีย์ API ลงในไฟล์ Manifest ได้ในเอกสารประกอบปลั๊กอิน Secrets Gradle
กำลังวิ่ง
โปรดเชื่อมต่ออุปกรณ์ Android กับคอมพิวเตอร์หรือใช้โปรแกรมจำลอง
- อุปกรณ์ Android - ดูinstructionsเปิดใช้ตัวเลือกสำหรับนักพัฒนาซอฟต์แวร์ในอุปกรณ์ Android และกำหนดค่าระบบให้ตรวจหาอุปกรณ์
- โปรแกรมจำลองmdash;ใช้เครื่องมือจัดการอุปกรณ์เสมือน (AVD) ของ Android เพื่อกำหนดค่าอุปกรณ์เสมือน เมื่อเลือกโปรแกรมจำลอง โปรดเลือก รูปภาพที่มี Google APIs
ใน Android Studio ให้คลิกเมนูเรียกใช้ตัวเลือกเมนู (หรือไอคอนปุ่มเล่น) แล้วเลือกเป้าหมายการทำให้ใช้งานได้
หลังจากที่สร้างและเปิดตัวแล้ว แอปจะแสดงหน้า Landing Page ของรายการตัวเลือกแก่ผู้ใช้
ตัวเลือก NavViewActivity และ NavFragmentActivity
ผู้ใช้รายใหม่ของ 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
สร้าง
ใน Android Studio ให้นำเข้าแอปเดโมและอนุญาตให้ Gradle ทำงาน
เปิด
local.defaults.properties
และอัปเดตค่าของพร็อพเพอร์ตี้MAPS_API_KEY
ดังนี้MAPS_API_KEY=YOUR_API_KEY
คลิกสร้างและตรวจสอบรายละเอียดการใช้งาน SDK
ในคลาส Java ให้จดบันทึกรหัสการใช้งาน
ใน XML ของเลย์เอาต์ ให้สังเกตการออกแบบเลย์เอาต์และข้อความ
ในไฟล์
build.gradle
ให้สังเกต SDK ในทรัพยากร Dependency
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีเพิ่มคีย์ API ลงในไฟล์ Manifest ได้ในปลั๊กอิน Creleens ลับ
กำลังวิ่ง
โปรดเชื่อมต่ออุปกรณ์ Android กับคอมพิวเตอร์หรือใช้โปรแกรมจำลอง
- อุปกรณ์ Android โปรดดู instructions เปิดใช้ตัวเลือกของนักพัฒนาซอฟต์แวร์ในอุปกรณ์ Android และกำหนดค่า ระบบเพื่อตรวจหาอุปกรณ์
- โปรแกรมจำลอง ใช้เครื่องมือจัดการอุปกรณ์เสมือน (AVD) ของ Android เพื่อกำหนดค่าอุปกรณ์เสมือน เมื่อเลือกโปรแกรมจำลอง โปรดเลือก รูปภาพที่มี Google APIs
ใน Android Studio ให้คลิกเมนูเรียกใช้ตัวเลือกเมนู (หรือไอคอนปุ่มเล่น) แล้วเลือกเป้าหมายการทำให้ใช้งานได้
เมื่อสร้างและเปิดตัวแอปแล้ว แอปจะแสดงหน้า Landing Page ของรายการเดโมแก่ผู้ใช้
รูปแบบการนำเสนอนี้และโครงสร้างที่สอดคล้องกันของซอร์สโค้ดเป็นที่คุ้นเคยสำหรับผู้ใช้การสาธิต Google Maps SDK เนื่องจากเดโมของ GoogleMap ออกแบบมาให้คล้ายกับแอปเดโม Maps API โดยมีความแตกต่างหลักคือการสาธิตการใช้งาน SDK การนำทางจะให้ผู้ใช้เลือกคลาสการแสดงผลที่ต้องการทดสอบเรียกใช้เดโม: NavigationView
หรือ MapView
หากทำได้
โดยทั่วไป Google สนับสนุนให้ผู้ใช้ใช้ NavigationView
การสาธิตนี้ให้ความยืดหยุ่นในการลองใช้ลักษณะการทำงานเหล่านี้กับทั้ง 2 เวอร์ชันในแอปเดโมของเรา และเลือกแบบที่เหมาะกับคุณ เช่น คุณยังอาจจำเป็นต้องใช้ MapView
ในกรณีที่ใช้ไลบรารีของบุคคลที่สามที่คาดว่าจะโต้ตอบกับชั้นเรียนนั้น