การเริ่มต้นใช้งาน Geospatial อย่างรวดเร็วสำหรับ Android

การเริ่มต้นอย่างรวดเร็วสำหรับ ARCore Geospatial API นี้จะแสดงวิธีเรียกใช้แอปตัวอย่าง ใน Android Studio ที่แสดง Geospatial API

สำหรับคู่มือในการพัฒนาแอปของคุณด้วย Geospatial API โปรดดูที่ คู่มือนักพัฒนาซอฟต์แวร์ภูมิสารสนเทศสำหรับ Android (Kotlin/Java) หรือ คู่มือนักพัฒนาซอฟต์แวร์ภูมิสารสนเทศสำหรับ Android NDK (C)

ดูข้อมูลเพิ่มเติมเกี่ยวกับ Geospatial API ได้ที่ข้อมูลเบื้องต้นเกี่ยวกับ ARCore Geospatial API

หากคุณเพิ่งเริ่มพัฒนาโดยใช้ ARCore โปรดดูการเริ่มต้นใช้งาน

ข้อกำหนด

การรองรับอุปกรณ์

โปรดดูรายการอุปกรณ์ทั้งหมดที่รองรับ ได้รับการรับรองให้ทำงานร่วมกับ ARCore สำหรับ Geospatial API หนึ่งในคีย์ ชิ้นส่วนฮาร์ดแวร์ที่จำเป็นต้องใช้คือเครื่องวัดค่าความเข้มข้นของสนามแม่เหล็กที่ตรงกับ Geospatial API อุปกรณ์ที่มีมาตรความเข้มสนามแม่เหล็กที่ไม่เป็นไปตามข้อกำหนดจะไม่รองรับ

ซอฟต์แวร์

  • เวอร์ชันล่าสุดของ บริการ Google Play สำหรับ AR ติดตั้งในอุปกรณ์ที่รองรับแล้ว

  • Android Studio เวอร์ชัน 3.0 ขึ้นไป สำหรับแพลตฟอร์ม Android SDK เวอร์ชัน 7.0 (API ระดับ 24) ขึ้นไป

  • ARCore SDK สำหรับ Android ซึ่งคุณดูได้ 2 วิธีดังนี้

    • ดาวน์โหลดจาก GitHub และดึงข้อมูลลงในเครื่อง

    • โคลนที่เก็บด้วยคำสั่งต่อไปนี้ 

      git clone https://github.com/google-ar/arcore-android-sdk.git

เปิดและตั้งค่าแอปตัวอย่าง

โปรเจ็กต์ geospatial_java ที่มาพร้อมกับ ARCore SDK สําหรับ Android จะอธิบายโค้ดที่เรียกใช้ Geospatial API

  1. ใน Android Studio ให้ไปที่เมนูไฟล์ แล้วคลิกเปิด

  2. ไปที่โฟลเดอร์โปรเจ็กต์สำหรับ arcore-android-sdk

  3. เปิดโฟลเดอร์ ตัวอย่าง จากนั้นเลือกโฟลเดอร์ geospatial_java และ คลิกเปิด

ตั้งค่าโปรเจ็กต์ Google Cloud

เมื่อต้องการใช้ Visual Positioning System (VPS) แอปของคุณจะต้องเชื่อมโยงกับ โปรเจ็กต์ Google Cloud ที่เปิดใช้สำหรับ ARCore API โปรดดู ใช้ ARCore API ใน Google Cloud เพื่อตั้งค่าการให้สิทธิ์ คุณสามารถเลือกการให้สิทธิ์คีย์ API หรือแบบไม่ใช้คีย์ก็ได้

เรียกใช้แอปตัวอย่าง

ใน Android Studio ให้เรียกใช้แอปตัวอย่าง

คุณควรเห็นมุมมองกล้องพร้อมข้อมูลการแก้ไขข้อบกพร่องที่อธิบาย ตำแหน่งภูมิสารสนเทศปัจจุบันของอุปกรณ์ ขณะที่คุณสแกนสภาพแวดล้อมรอบตัว จะเห็นได้ว่าค่าความเชื่อมั่นของความแม่นยำในการระบุตำแหน่งอาจเปลี่ยนแปลง เมื่อคุณเคลื่อนที่ไปมา หากอยู่ในพื้นที่ที่รองรับการแปล VPS

เมื่อ ARCore มั่นใจในตำแหน่งและส่วนหัวของอุปกรณ์แล้ว คุณสามารถวาง ยึดตำแหน่งตำแหน่งปัจจุบันโดยใช้การระบุตำแหน่งทางภูมิศาสตร์

ความแม่นยำของตำแหน่งอาจต่ำเกินไปหากไม่มีข้อมูล VPS แอปต้องเชื่อมต่ออินเทอร์เน็ต และ VPS จะต้องทราบตำแหน่ง เรียกใช้แอปตัวอย่างกลางแจ้ง (ไม่ใช่ในอาคาร) ในเวลากลางวันเพื่อให้ได้ผลลัพธ์ที่ดีที่สุด

นอกจากนี้ หากคุณอยู่ในพื้นที่ที่ไม่รองรับ VPS หรือสัญญาณ GPS ไม่พร้อมให้บริการ ให้เพียงพอ คุณอาจต้องปรับเกณฑ์ความเชื่อมั่นในแอปเพื่อให้ เพื่อวาง Anchor

วิธีปรับเกณฑ์

  1. ใน Android Studio ให้เปิด GeospatialActivity และไปที่ ส่วนต่อไปนี้:

    // The thresholds that are required for horizontal and heading accuracies before entering into the
// LOCALIZED state. Once the accuracies are equal or less than these values, the app will
// allow the user to place anchors.
private static final double LOCALIZING_HORIZONTAL_ACCURACY_THRESHOLD_METERS = 10;
private static final double LOCALIZING_HEADING_ACCURACY_THRESHOLD_DEGREES = 15;

  2. ปรับค่าเหล่านี้ตามต้องการ ยิ่งค่าสูงเท่าไร ความแม่นยำจะลดลงเท่านั้น

    การลดความแม่นยำช่วยให้แอปมีความยืดหยุ่นมากขึ้นในการวางจุดยึด ดูข้อมูลเพิ่มเติมที่หัวข้อปรับความแม่นยำของท่าทาง

ขั้นตอนถัดไป