Geospatial API ใช้ VPS ร่วมกับข้อมูล GPS เพื่อสร้างการแปลงภูมิสารสนเทศที่มีความแม่นยำสูง API จะใช้ได้ทุกที่ที่อุปกรณ์ระบุตำแหน่งได้ โดยทำดังนี้
- ในพื้นที่ที่ GPS มีความแม่นยำต่ำ เช่น พื้นที่ในอาคารและสภาพแวดล้อมในเมืองที่มีความหนาแน่นสูง API จะใช้การครอบคลุม VPS เพื่อสร้างการแปลงที่มีความแม่นยำสูง
- ในสภาพแวดล้อมกลางแจ้งที่มีสิ่งกีดขวางจากด้านบนน้อยหรือไม่มีเลย Geospatial API อาจใช้ข้อมูลตำแหน่ง GPS ที่มีอยู่เพื่อสร้างการแปลงภูมิสารสนเทศด้วยความแม่นยำสูง
คุณกำหนดความพร้อมใช้งานของ VPS ได้ที่ตำแหน่งแนวนอนที่กำหนดก่อนที่เซสชัน AR จะเริ่มต้นและใช้เพื่อสร้างประสบการณ์ที่เฉพาะเจาะจงยิ่งขึ้น เช่น ในการนำเสนอ "Enter AR" เฉพาะเมื่อ VPS พร้อมใช้งาน
เปิดใช้ ARCore API
แอปของคุณต้องเปิดใช้ ARCore API เพื่อตรวจสอบความพร้อมใช้งาน VPS
ตรวจสอบความพร้อมใช้งาน VPS ในแอป
Geospatial API สามารถใช้ได้ทุกที่ที่อุปกรณ์สามารถระบุตำแหน่งได้ หากประสบการณ์ AR ขึ้นอยู่กับการครอบคลุม VPS คุณสามารถใช้ GARSession#checkVPSAvailabilityAtCoordinate:completionHandler:
เพื่อรับ GARVPSAvailabilityFuture
ซึ่งเป็นงานแบบไม่พร้อมกันที่ตรวจสอบความพร้อมใช้งาน VPS ในตำแหน่งแนวนอนที่กำหนด
เมื่อมี GARVPSAvailabilityFuture
แล้ว คุณจะดูผลลัพธ์ได้ด้วยแบบสำรวจหรือผ่านทาง Callback
สำรวจผลลัพธ์
ใช้ GARFuture.state
เพื่อดูสถานะของ Future
โดยจะมีสถานะต่างๆ 3 สถานะ ดังนี้
GARFutureStatePending
: การดำเนินการยังไม่สมบูรณ์ จึงยังไม่ทราบผลลัพธ์GARFutureStateCancelled
:GARFuture#cancel
ยกเลิกการดำเนินการแล้ว ระบบจะไม่โทรติดต่อกลับตามที่คุณลงทะเบียนไว้GARFutureStateDone
: การดำเนินการเสร็จสมบูรณ์แล้ว ใช้GARVPSAvailabilityFuture.result
เพื่อดูผลลัพธ์
คุณอาจตรวจสอบ GARFuture.state
ต่อไปจนกว่างานจะเสร็จสมบูรณ์
รับผลลัพธ์ผ่าน Callback
นอกจากนี้ คุณยังรับผลลัพธ์ของ Future
ผ่านการติดต่อกลับได้ด้วย ใช้ GARSession#checkVPSAvailabilityAtCoordinate:completionHandler:
และระบุ completionHandler
ระบบจะเรียกใช้ completionHandler
นี้ในเทรดหลักทันทีหลังจาก Future
มีสถานะ GARFutureStateDone
ยกเลิก Future
ใช้ GARFuture#cancel
เพื่อพยายามยกเลิก Future
เนื่องจากชุดข้อความมีเนื้อหาพร้อมกัน จึงอาจเป็นไปได้ที่ความพยายามในการยกเลิกของคุณไม่สำเร็จ
GARFuture#cancel
จะแสดงผล YES
หากความพยายามนี้สำเร็จ และ NO
ในกรณีอื่นๆ
ใช้ Geospatial API ที่ไม่ครอบคลุม VPS
นอกจากนี้ Geospatial API ยังใช้ในพื้นที่ที่ไม่ครอบคลุม VPS ได้อีกด้วย ในสภาพแวดล้อมกลางแจ้งที่มีสิ่งกีดขวางจากด้านบนเล็กน้อยหรือไม่มีเลย GPS อาจเพียงพอที่จะสร้างท่าทางที่มีความแม่นยำสูง
ขั้นตอนถัดไป
- ดูตำแหน่งทางภูมิศาสตร์ของกล้องของอุปกรณ์เพื่อระบุตำแหน่งที่เจาะจงของอุปกรณ์ผู้ใช้ในชีวิตจริง