Geospatial API ใช้ VPS ร่วมกับข้อมูล GPS เพื่อสร้างท่าทางทางภูมิศาสตร์ที่มีความแม่นยำสูง API จะใช้ได้ทุกที่ที่อุปกรณ์ระบุตำแหน่งได้ โดยทำดังนี้
- ในพื้นที่ที่ GPS มีความแม่นยำต่ำ เช่น ในพื้นที่ในอาคารและสภาพแวดล้อมในเมืองที่หนาแน่น API จะใช้การครอบคลุม VPS เพื่อสร้างท่าทางที่มีความแม่นยำสูง
- ในสภาพแวดล้อมกลางแจ้งที่มีสิ่งกีดขวางจากด้านบนน้อยหรือไม่มีเลย Geospatial API จะสามารถใช้ข้อมูลตำแหน่ง GPS ที่มีอยู่เพื่อสร้างท่าทางทางภูมิศาสตร์ด้วยความแม่นยำสูง
คุณกำหนดความพร้อมใช้งานของ VPS ได้ที่ตำแหน่งแนวนอนที่กำหนดก่อนที่เซสชัน AR จะเริ่มต้นและใช้เพื่อสร้างประสบการณ์ที่เฉพาะเจาะจงยิ่งขึ้น เช่น ในการนำเสนอ "Enter AR" เฉพาะเมื่อ VPS พร้อมใช้งาน
เปิดใช้ ARCore API
แอปของคุณต้องเปิดใช้ ARCore API เพื่อตรวจสอบความพร้อมใช้งาน VPS
เมื่อเปิดใช้ ARCore API แล้ว คุณจะตรวจสอบความพร้อมใช้งาน VPS ได้โดยไม่ต้องมีสิ่งต่อไปนี้
- รหัสปัจจุบันที่ทํางาน
Session
(ก่อนเรียกใช้Session.resume()
) - การตั้งค่า
GeospatialMode
ตรวจสอบความพร้อมใช้งาน VPS ในแอป
Geospatial API สามารถใช้ได้ทุกที่ที่อุปกรณ์สามารถระบุตำแหน่งได้ หากประสบการณ์ AR ขึ้นอยู่กับการครอบคลุม VPS คุณสามารถใช้ Session.checkVpsAvailabilityAsync()
เพื่อรับ VpsAvailabilityFuture
ซึ่งเป็นงานแบบไม่พร้อมกันที่ตรวจสอบความพร้อมใช้งาน VPS ในตำแหน่งแนวนอนที่กำหนด
เมื่อมี VpsAvailabilityFuture
แล้ว คุณจะดูผลลัพธ์ได้ด้วยแบบสำรวจหรือผ่านทาง Callback
สำรวจผลลัพธ์
ใช้ Future.getState()
เพื่อดูสถานะของ Future
โดยจะมีสถานะต่างๆ 3 สถานะ ดังนี้
PENDING
: การดำเนินการยังไม่สมบูรณ์ จึงยังไม่ทราบผลลัพธ์CANCELLED
:Future.cancel()
ยกเลิกการดำเนินการแล้ว ระบบจะไม่โทรติดต่อกลับตามที่คุณลงทะเบียนไว้DONE
: การดำเนินการเสร็จสมบูรณ์แล้ว ใช้VpsAvailabilityFuture.getResult()
เพื่อดูผลลัพธ์
คุณอาจตรวจสอบ Future.getState()
ต่อไปจนกว่างานจะเสร็จสมบูรณ์
Java
// Obtain a VpsAvailabilityFuture and store it somewhere. VpsAvailabilityFuture future = session.checkVpsAvailabilityAsync(latitude, longitude, null); // Poll VpsAvailabilityFuture later, for example, in a render loop. if (future.getState() == FutureState.DONE) { switch (future.getResult()) { case AVAILABLE: // VPS is available at this location. break; case UNAVAILABLE: // VPS is unavailable at this location. break; case ERROR_NETWORK_CONNECTION: // The external service could not be reached due to a network connection error. break; // Handle other error states, e.g. ERROR_RESOURCE_EXHAUSTED, ERROR_INTERNAL, ... } }
Kotlin
// Obtain a VpsAvailabilityFuture and store it somewhere. val future = session.checkVpsAvailabilityAsync(latitude, longitude, null) // Poll VpsAvailabilityFuture later, for example, in a render loop. if (future.state == FutureState.DONE) { when (future.result) { VpsAvailability.AVAILABLE -> { // VPS is available at this location. } VpsAvailability.UNAVAILABLE -> { // VPS is unavailable at this location. } VpsAvailability.ERROR_NETWORK_CONNECTION -> { // The external service could not be reached due to a network connection error. } else -> { TODO("Handle other error states, e.g. ERROR_RESOURCE_EXHAUSTED, ERROR_INTERNAL, ...") } } }
รับผลลัพธ์ผ่าน Callback
นอกจากนี้ คุณยังรับผลลัพธ์ของ Future
ผ่านการติดต่อกลับได้ด้วย ใช้ Session.checkVpsAvailabilityAsync()
และระบุ callback
ระบบจะเรียกใช้ callback
นี้ในเทรดหลักทันทีหลังจาก Future
มีสถานะ DONE
Java
session.checkVpsAvailabilityAsync( latitude, longitude, result -> { // Callback is called on the Main thread. switch (result) { // Handle the VpsAvailability result as shown above. // For example, show UI that enables your AR view. } });
Kotlin
session.checkVpsAvailabilityAsync(latitude, longitude) { result -> // Callback is called on the Main thread. // Handle the VpsAvailability result as shown above. // For example, show UI that enables your AR view. TODO("Handle VpsAvailability " + result) }
ยกเลิก Future
ใช้ Future.cancel()
เพื่อพยายามยกเลิก Future
เนื่องจากชุดข้อความมีเนื้อหาพร้อมกัน จึงอาจเป็นไปได้ที่ความพยายามในการยกเลิกของคุณไม่สำเร็จ
Future.cancel()
จะแสดงผล true
หากความพยายามนี้สำเร็จ และ false
ในกรณีอื่นๆ
ใช้ Geospatial API ที่ไม่ครอบคลุม VPS
นอกจากนี้ Geospatial API ยังใช้ในพื้นที่ที่ไม่ครอบคลุม VPS ได้อีกด้วย ในสภาพแวดล้อมกลางแจ้งที่มีสิ่งกีดขวางจากด้านบนเล็กน้อยหรือไม่มีเลย GPS อาจเพียงพอที่จะสร้างท่าทางที่มีความแม่นยำสูง
ขั้นตอนถัดไป
- ดูตำแหน่งทางภูมิศาสตร์ของกล้องของอุปกรณ์เพื่อระบุตำแหน่งที่เจาะจงของอุปกรณ์ผู้ใช้ในชีวิตจริง