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