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