تستخدِم Geospatial API مجموعة من بيانات VPS وGPS لإنشاء أوضاع جيوفضائية عالية الدقة. يمكن استخدام واجهة برمجة التطبيقات في أي مكان يمكن للجهاز تحديد موقعه الجغرافي فيه:
- في المناطق التي تكون فيها دقة نظام تحديد المواقع العالمي (GPS) منخفضة، مثل المساحات الداخلية والبيئات الحضرية ذات الكثافة السكانية العالية، ستعتمد واجهة برمجة التطبيقات على تغطية VPS لإنشاء أوضاع ذات دقة عالية.
- في البيئات الخارجية مع وجود عوائق قليلة أو عدم وجود عوائق علوية، قد تتمكن واجهة برمجة التطبيقات Geospatial API من استخدام بيانات الموقع المتاحة لنظام تحديد المواقع العالمي (GPS) لإنشاء أوضاع جيوفضائية بدقة عالية.
يمكنك تحديد مدى توفّر VPS في موضع أفقي معيّن قبل بدء جلسة الواقع المعزّز واستخدامه لإنشاء تجارب أكثر تحديدًا، على سبيل المثال، لعرض زر "بدء الواقع المعزّز" فقط عندما يكون VPS متاحًا.
تفعيل واجهة برمجة تطبيقات ARCore
يجب أن يفعّل تطبيقك واجهة برمجة تطبيقات ARCore للتحقّق من مدى توفّر VPS.
التحقّق من توفّر الخادم الظاهري في تطبيقك
يمكن استخدام واجهة برمجة التطبيقات Geospatial API في أي مكان يمكن للجهاز تحديد موقعه الجغرافي فيه. إذا كانت تجربة الواقع المعزّز تعتمد على تغطية VPS، يمكنك استخدام AREarthManager.CheckVpsAvailabilityAsync() للحصول على VpsAvailabilityPromise، وهي مهمة غير متزامنة تتحقّق من توفّر VPS في موضع أفقي معيّن.
بعد الحصول على VpsAvailabilityPromise، يمكنك الحصول على النتيجة من خلال الاستطلاع.
استطلاع النتيجة
استخدِم VpsAvailabilityPromise.State للحصول على حالة InterruptiblePromise. هناك ثلاث حالات مختلفة:
Pending: لم تكتمل العملية بعد، لذلك لا تتوفّر أي نتائج.Cancelled: تم إلغاء العملية من قِبلVpsAvailabilityPromise.Cancel(). ولن يتمّ استدعاء أيّ مكالمة تلقائية مسجّلة.Done: اكتملت العملية. استخدِمVpsAvailabilityPromise.Resultللحصول على النتيجة.
يمكنك مواصلة التحقّق من VpsAvailabilityPromise.State إلى أن تكتمل المهمة.
إلغاء InterruptiblePromise
استخدِم VpsAvailabilityPromise.Cancel() لمحاولة إلغاء InterruptiblePromise. بسبب موازاة سلاسل المحادثات، قد لا تنجح محاولة الإلغاء التي أجريتها.
استخدام واجهة برمجة التطبيقات Geospatial API بدون تغطية VPS
يمكن أيضًا استخدام واجهة برمجة التطبيقات Geospatial API في المناطق التي لا تتوفّر فيها تغطية VPS. في البيئات الخارجية التي تتضمّن عددًا قليلاً من العوائق العلوية أو لا تتضمّن أيّ منها، قد يكون نظام تحديد المواقع العالمي (GPS) كافيًا لإنشاء وضعية بدقة عالية.
الخطوات التالية
- احصل على الوضع الجغرافي المكاني لكاميرا الجهاز لتحديد الموقع الجغرافي الدقيق لجهاز المستخدم في العالم الفعلي.