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

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

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

ดูข้อมูลเบื้องต้นเกี่ยวกับ ARCore Geospatial API สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ 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. เปิดโฟลเดอร์ samples เลือกโฟลเดอร์ geospatial_java แล้วคลิก Open

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

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

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

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

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

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

ความแม่นยำของตำแหน่งอาจต่ำเกินไปในกรณีที่ไม่มีข้อมูล 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. ปรับค่าเหล่านี้ตามต้องการ ยิ่งค่าสูงเท่าใด ความแม่นยําจะยิ่งต่ำลงเท่านั้น

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

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