تعتبر علامات ارتساء الموقع الجغرافي المكاني نوع من الارتساء الذي يسمح لك بوضع محتوى ثلاثي الأبعاد في العالم الحقيقي.
أنواع ارتساء الأماكن الجيوفضائية
هناك ثلاثة أنواع من علامات الارتساء الجيوفضائية، يتعامل كل منها مع الارتفاع بشكل مختلف:
علامات ارتساء WGS84:
تتيح لك علامات ارتساء WGS84 وضع محتوى ثلاثي الأبعاد في أي خط عرض محدد، وخط الطول والارتفاع.علامات ارتساء التضاريس:
تتيح لك علامات ارتساء التضاريس وضع محتوى باستخدام خطوط العرض خط طول مع ارتفاع نسبي للتضاريس في هذا الموضع. يتم تحديد الارتفاع بالنسبة إلى الأرض أو الطابق كما هو معروف بواسطة VPSتثبيتات الأسطح:
تتيح لك "تثبيتات الأسطح" وضع محتوى باستخدام خطوط العرض خط طول مع ارتفاع نسبي إلى سطح أحد المباني في هذا الموضع. يتم تحديد الارتفاع بالنسبة إلى قمة المبنى كما هو معروف بواسطة هندسة التجوّل الافتراضي. سيتم ضبط هذا الإعداد على ارتفاع التضاريس بشكل افتراضي عندما لا يتم وضعه في مبنى.
WGS84 | التضاريس | على السطح | |
---|---|---|---|
موضع أفقي | خط العرض، خط الطول | خط العرض، خط الطول | خط العرض، خط الطول |
موضع رأسي | نسبةً إلى ارتفاع WGS84 | نسبةً إلى مستوى التضاريس التي تحددها خرائط Google | نسبةً إلى مستوى السطح الذي تحدّده "خرائط Google" |
هل يجب حلّ المشاكل في الخادم؟ | لا | نعم | نعم |
المتطلبات الأساسية
تأكّد من تفعيل واجهة برمجة التطبيقات Geospatial API قبل المتابعة.
وضع علامات ارتساء الجغرافيا المكانية
ويتضمّن كلّ نوع من أنواع الارتساء واجهات برمجة تطبيقات مخصَّصة لإنشائها. يمكنك الاطّلاع على أنواع ارتساءات المواقع الجغرافية المكانية للحصول على مزيد من المعلومات.
إنشاء إعلان ثابت من اختبار نجاح
ويمكنك أيضًا إنشاء مراسي جغرافي مكاني من نتيجة اختبار النتائج.
استخدام التحويل من اختبار النتائج وتحويله إلى GARGeospatialTransform
. استخدِمه لوضع أيٍّ من أنواع الارتساء الثلاثة الموضّحة.
تحوَّل جيوفضائي من خلال تحوّل في الواقع المعزَّز
يوفّر GARSession.geospatialTransformFromTransform:error:
طريقة إضافية لتحديد خط العرض وخط الطول من خلال تحويل "تحويل الواقع المعزّز" إلى "تحويل جغرافي مكاني".
تحوّل في الواقع المعزَّز من تحوّل جغرافي مكاني
تحوِّل GARSession.transformFromGeospatialCoordinate:altitude:eastUpSouthQTarget:error:
موضعًا وارتفاعًا ودورانًا رباعيًا محدّدًا الأرض في ما يتعلق بإطار الإحداثيات من الشرق إلى الأعلى إلى "تحويل الواقع المعزّز" في ما يتعلق بالإحداثيات العالمية GL.
اختيار الطريقة التي تناسب حالة الاستخدام
إنّ كل طريقة لإنشاء إعلان ثابت لها مفاضلات يجب وضعها في الاعتبار:
- عند استخدام هندسة التجوّل الافتراضي، استخدام اختبار النتائج لإرفاق محتوى بالمبنى.
- تفضيل إعلانات ارتساء التضاريس أو سطح الأسطح على علامات ارتساء WGS84 لأنها تستخدم قيم الارتفاع التي تحددها خرائط Google.
تحديد خط العرض وخط الطول لموقع جغرافي
هناك ثلاث طرق يمكنك من خلالها حساب خط العرض وخط الطول لموقع ما:
- يمكنك استخدام Geospatial Creator لعرض محتوى ثلاثي الأبعاد حول العالم وتعزيزه بدون الحاجة إلى الانتقال إلى موقع جغرافي فعليًا. يتيح لك ذلك وضع محتوى مجسم ثلاثي الأبعاد بشكل مرئي باستخدام "خرائط Google" في Unity Editor. وسيتم احتساب خط العرض وخط الطول والتدوير والارتفاع للمحتوى تلقائيًا نيابةً عنك.
- استخدام خرائط Google
- استخدِم Google Earth. لاحظ أن الحصول على هذه الإحداثيات باستخدام Google Earth، على عكس خرائط Google، يمنحك هامش خطأ يصل إلى عدة أمتار.
- الانتقال إلى الموقع الجغرافي
استخدام خرائط Google
للحصول على خط العرض وخط الطول لموقع باستخدام خرائط Google:
انتقل إلى خرائط Google على جهاز الكمبيوتر المكتبي.
انتقل إلى الطبقات > المزيد.
غيِّر نوع الخريطة إلى قمر صناعي وأزِل العلامة من مربّع الاختيار عرض الكرة الأرضية في أسفل يمين الشاشة.
سيؤدي ذلك إلى فرض المنظور الثنائي الأبعاد وإزالة الأخطاء المحتملة التي يمكن أن تنتج عن العرض الثلاثي الأبعاد بزاوية.
على الخريطة، انقر بزر الماوس الأيمن على الموقع الجغرافي واختَر خط الطول/خط العرض لنسخه إلى الحافظة.
استخدام Google Earth
يمكنك حساب خط العرض وخط الطول لموقع من Google Earth بالنقر على الموقع في واجهة المستخدم وقراءة البيانات من تفاصيل العلامة الموضعية.
للحصول على خط العرض وخط الطول لموقع باستخدام Google Earth:
انتقِل إلى Google Earth على كمبيوتر سطح المكتب.
انتقِل إلى قائمة الهامبرغر
واختَر نمط الخريطة.
أوقِف مفتاح المباني الثلاثية الأبعاد.
بعد إيقاف مفتاح المباني ثلاثية الأبعاد، انقر على رمز الدبوس
لإضافة علامة موضعية في الموقع المحدد.
حدّد مشروعًا لتضمين علامتك الموضعية وانقر على حفظ.
في حقل العنوان للعلامة الموضعية، أدخِل اسمًا للعلامة الموضعية.
انقر على سهم الرجوع
في لوحة المشروع واختَر
إجراءات إضافية.
اختر تصدير كملف KML من القائمة.
يعرض ملف KLM خطوط العرض والطول والارتفاع لعلامة موضعية في علامة <coordinates>
مفصولة بفواصل، على النحو التالي:
<coordinates>-122.0755182435043,37.41347299422944,7.420342565583832</coordinates>
لا تستخدم خط العرض وخط الطول من علامات <LookAt>
التي تحدد موضع الكاميرا، وليس الموقع الجغرافي.
الانتقال إلى الموقع الجغرافي
يمكنك حساب ارتفاع الموقع من خلال الذهاب إلى هناك فعليًا وإجراء ملاحظة محلية.
الحصول على الشكل الرباعي للدوران
تستخرج أداة GARGeospatialTransform.eastUpSouthQTarget
الاتجاه من التحويل الجغرافي المكاني وتُنتج رباعيًا يمثل مصفوفة الدوران التي تحوِّل المتّجهًا من الهدف إلى نظام الإحداثيات من الشرق إلى الأعلى والجنوب. X+ نقطة في الشرق، و+Y نقطة لأعلى، و+Z نقطة في الجنوب. تتم كتابة القيم بالترتيب {x, y, z, w}
.
علامات ارتساء WGS84
علامة ارتساء WGS84 هي نوع من الارتساء يسمح لك بوضع محتوى ثلاثي الأبعاد على أي خط عرض وخط طول وارتفاع محدد. إنه يعتمد على التحويل والاتجاه ليتم وضعه في العالم الحقيقي. يتكون الموضع من خطوط الطول والعرض والارتفاع، ويتم تحديدها في نظام الإحداثيات WGS84. يتكون الاتجاه من دوران رباعي.
يتم تسجيل الارتفاع بالأمتار فوق قيمة القطع الناقص للمرجع WGS84 بحيث لا يكون مستوى سطح الأرض صفرًا. تطبيقك مسؤول عن تقديم هذه الإحداثيات لكل ارتساء يتم إنشاؤه.
وضع ارتساء WGS84 على أرض الواقع
تحديد ارتفاع موقع جغرافي
هناك عدة طرق لتحديد ارتفاع الموقع من أجل وضع علامات ارتساء الموقع:
- إذا كان الموقع الجغرافي للارتساء قريبًا من المستخدم فعليًا، يمكنك استخدام ارتفاع مشابه لارتفاع جهاز المستخدم.
- بعد الحصول على خط العرض وخط الطول، استخدِم Elevelation API للحصول على ارتفاع استنادًا إلى مواصفات EGM96. يجب تحويل ارتفاع واجهة برمجة التطبيقات EGM96 إلى واجهة برمجة التطبيقات WGS84 للمقارنة مع ارتفاع
GARGeospatialTransform
. راجع GeoidEval الذي يحتوي على سطر أوامر وواجهة HTML. تقدم واجهة برمجة التطبيقات للخرائط تقارير عن خطوط الطول والعرض وفقًا لمواصفات WGS84 بشكل فوري. - يمكنك الحصول على خط العرض وخط الطول والارتفاع لموقع ما من Google Earth. سيؤدي ذلك إلى ظهور هامش خطأ يصل إلى عدة أمتار. استخدِم خطوط الطول والعرض والارتفاع من علامات
<coordinates>
، ووليس علامات<LookAt>
، في ملف KML. - إذا كان هناك إعلان ثابت بالقرب منك وإذا لم تكن على منحدر شديد، يمكنك استخدام الارتفاع من
GARGeospatialTransform
الكاميرا بدون استخدام مصدر آخر، مثل Maps API.
إنشاء إعلان ثابت في أسفل الصفحة
بعد الحصول على الرباعي الرباعي لخط العرض وخط الطول والارتفاع والتدوير، استخدِم createAnchorWithCoordinate:altitude:eastUpSouthQAnchor:error:
لربط المحتوى بالإحداثيات الجغرافية التي تحدّدها.
NSError *error = nil;
GARAnchor *anchor = [self.garSession createAnchorWithCoordinate:coordinate
altitude:altitude
eastUpSouthQAnchor:eastUpSouthQAnchor
error:&error];
أدوات تثبيت التضاريس
نقطة ارتساء التضاريس هي نوع من الارتساء يتيح لك وضع عناصر الواقع المعزّز باستخدام خطوط الطول والعرض فقط، مع الاستفادة من معلومات VPS للعثور على الارتفاع الدقيق فوق سطح الأرض.
وبدلاً من إدخال الارتفاع المطلوب، يمكنك توفير الارتفاع فوق التضاريس. وعندما تكون القيمة صفرًا، ستكون الارتساء على مستوى الأرض مع التضاريس.
ضبط وضع البحث عن الطائرة
إنّ العثور على المستوى اختياري وليس مطلوبًا لاستخدام علامات الارتساء. تجدر الإشارة إلى أنّه يتم استخدام المستويات الأفقية فقط. ستساعد المستويات الأفقية المحاذاة الديناميكية لمرتكزات التضاريس على الأرض.
استخدِم الرمز ARWorldTrackingConfiguration.PlaneDetection
لاختيار الطريقة التي يرصد بها تطبيقك الطائرات.
إنشاء إعلان ارتساء لتضاريس التضاريس باستخدام واجهة برمجة التطبيقات Async API الجديدة
لإنشاء علامة ارتساء للتضاريس ووضعها، يمكنك الاتصال بالرقم GARSession.createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:completionHandler:error:
.
لن يكون الإعلان الثابت جاهزًا على الفور، بل يجب معالجته. بعد حلّ المشكلة، ستتوفَّر في GARCreateAnchorOnTerrainFuture
.
GARCreateAnchorOnTerrainFuture *future = [self.garSession createAnchorWithCoordinate:coordinate
altitudeAboveTerrain:altitude
eastUpSouthQAnchor:eastUpSouthQTarget
completionHandler:^(GARAnchor *anchor, GARTerrainAnchorState state) {
// handle completion
}
error:&error];
الاطّلاع على حالة المستقبل
سيكون للمستقبل GARFutureState
مرتبط.
الحالة | الوصف |
---|---|
GARFutureStatePending |
لا تزال العملية معلّقة. |
GARFutureStateDone |
اكتملت العملية والنتيجة متاحة. |
GARFutureStateCancelled |
تم إلغاء العملية. |
التحقق من حالة ارتساء التضاريس لنتيجة "المستقبل"
تنتمي GARTerrainAnchorState
إلى العملية غير المتزامنة وهي جزء من النتيجة المستقبلية النهائية.
switch (future.resultTerrainAnchorState) {
case GARTerrainAnchorStateSuccess:
// Terrain anchor finished resolving.
break;
case GARTerrainAnchorStateErrorUnsupportedLocation:
// The requested anchor is in a location that isn't supported by the Geospatial API.
break;
case GARTerrainAnchorStateErrorNotAuthorized:
// An error occurred while authorizing your app with the ARCore API. See
// https://developers.google.com/ar/reference/ios/group/GARTerrainAnchorState#garterrainanchorstateerrornotauthorized
// for troubleshooting steps.
break;
case GARTerrainAnchorStateErrorInternal:
// The Terrain anchor could not be resolved due to an internal error.
break;
default:
break;
}
مثبّتات الأسطح
هي نوع من مثبّتات الأسطح وتشبه إلى حدّ كبير مثبّتات التضاريس أعلاه. ويكمن الاختلاف في أنك ستوفر الارتفاع فوق السطح بدلاً من الارتفاع فوق التضاريس.
إنشاء شريط إعلاني على السطح باستخدام واجهة Async API الجديدة
لن يكون الإعلان الثابت جاهزًا على الفور، بل يجب معالجته.
لإنشاء ثابت في السقف ووضعه، اتّصِل بالرقم GARSession.createAnchorWithCoordinate:altitudeAboveRooftop:eastUpSouthQAnchor:completionHandler:error:
. على غرار علامات ارتساء التضاريس، ستصل أيضًا إلى GARFutureState
المستقبل. يمكنك بعد ذلك الاطّلاع على نتيجة "المستقبل" للوصول إلى GARRooftopAnchorState
.
GARCreateAnchorOnRooftopFuture *future = [self.garSession createAnchorWithCoordinate:coordinate
altitudeAboveRooftop:altitude
eastUpSouthQAnchor:eastUpSouthQTarget
completionHandler:^(GARAnchor *anchor, GARRooftopAnchorState state) {
// handle completion
}
error:&error];
الاطّلاع على حالة المستقبل
سيكون للمستقبل GARFutureState
مرتبط. يُرجى الاطّلاع على الجدول أعلاه.
التحقّق من حالة تثبيت السطح في نتيجة المستقبل
تنتمي GARRooftopAnchorState
إلى العملية غير المتزامنة وهي جزء من النتيجة المستقبلية النهائية.
switch (future.resultRooftopAnchorState) {
case GARRooftopAnchorStateSuccess:
// Rooftop anchor finished resolving.
break;
case GARRooftopAnchorStateErrorUnsupportedLocation:
// The requested anchor is in a location that isn't supported by the Geospatial API.
break;
case GARRooftopAnchorStateErrorNotAuthorized:
// An error occurred while authorizing your app with the ARCore API. See
// https://developers.google.com/ar/reference/ios/group/GARRooftopAnchorState#garrooftopanchorstateerrornotauthorized
// for troubleshooting steps.
break;
case GARRooftopAnchorStateErrorInternal:
// The Rooftop anchor could not be resolved due to an internal error.
break;
default:
break;
}
الخطوات التالية
- تأكَّد من فهم حصة استخدام واجهة برمجة التطبيقات الجغرافية المكانية.