دليل البدء السريع لميزة "الموقع الجغرافي المكاني" على نظام التشغيل iOS

يوضح لك دليل البدء السريع لواجهة برمجة التطبيقات ARCore Geospatial API كيفية تشغيل نموذج تطبيق في Xcode توضح واجهة برمجة التطبيقات Geospatial API.

للحصول على دليل حول تطوير تطبيقك باستخدام Geospatial API، يُرجى الاطّلاع على دليل المطوّر حول البيانات الجغرافية في نظام التشغيل iOS.

يمكنك الاطّلاع على مقدّمة إلى ARCore Geospatial API لمزيد من المعلومات للحصول على معلومات حول واجهة برمجة التطبيقات Geospatial API.

إذا كنت حديث العهد بتطوير التطبيقات باستخدام ARCore، يمكنك الاطّلاع على البدء.

المتطلبات الأساسية

  • الإصدار 13.0 من Xcode أو إصدار أحدث
  • Cocoapods 1.4.0 أو إصدار أحدث في حال استخدام Cocoapods
  • جهاز Apple متوافق مع ARKit ويعمل بنظام التشغيل iOS 12.0 أو إصدار أحدث (مطلوب النشر بالإصدار 12.0 أو إصدار أحدث من نظام التشغيل iOS)

إعداد نموذج التطبيق

مشروع GeospatialExample المضمّن في ARCore SDK لنظام التشغيل iOS لوصف التعليمات البرمجية التي تستدعي واجهة برمجة التطبيقات Geospatial API.

  1. استنساخ أو نزّل ملف حزمة تطوير البرامج (SDK) من ARCore لنظام التشغيل iOS من GitHub للحصول على نموذج رمز التطبيق.

  2. افتح نافذة Terminal أو Finder، ثم انتقل إلى المجلد الذي استنسخته. أو تنزيل حزمة SDK.

  3. انتقِل إلى مجلد arcore-ios-sdk-master/Examples.

  4. افتح المجلد أمثلة، واختَر المجلد GeospatialExample. انقر على فتح.

إعداد مشروع على Google Cloud

قبل استخدام نظام تحديد المواقع المرئي (VPS) في تطبيقك، يجب أولاً: تفعيل ARCore API في مشروع جديد أو حالي على Google Cloud رغم أن واجهة برمجة التطبيقات Geospatial API تعمل مع لكل من تفويض مفتاح واجهة برمجة التطبيقات و بدون مفتاح، وبالنسبة لدليل البدء السريع هذا، استخدم واجهة برمجة التطبيقات الطريقة الأساسية.

إعداد التفويض

لإجراء طلبات بيانات من واجهة برمجة التطبيقات Geospatial API على VPS، يحتاج نموذج التطبيق إلى إذن. استخدام مفتاح واجهة برمجة تطبيقات غير مقيد. إذا كنت تستخدم مفتاح واجهة برمجة تطبيقات مقيّدًا، يجب أيضًا توفير معرّف حزمة لربطه بمفتاح واجهة برمجة التطبيقات.

  1. في XCode، في نموذج التطبيق GeospatialExample، افتح ViewController.m ملف والبحث عن your-api-key.

  2. أضِف مفتاح واجهة برمجة التطبيقات إلى GARSession: الصِق مفتاح واجهة برمجة التطبيقات الذي نسخته من الخطوة السابقة على النص، your-api-key (اترك علامتَي الاقتباس)، كما المعروضة:

    self.garSession = [GARSession sessionWithAPIKey:@"your-api-key"
                               bundleIdentifier:nil
                                          error:&error];

إعداد حزمة ARCore SDK

يأتي تطبيق GeospatialExample مع Podfile تم إعداده مسبقًا مع إصدارات ARCore SDK وإصدارات iOS التي تحتاج إليها. لتثبيت هذه التبعيات، افتح نافذة المحطة الطرفية وشغِّل pod install من المجلد الذي يتضمّن مشروع Xcode الموجودة.

يؤدي ذلك إلى إنشاء ملف .xcworkspace ستستخدمه لاحقًا لإنشاء التطبيق وتشغيله.

إنشاء نموذج التطبيق وتشغيله

  1. في Xcode، اختر ملف مساحة العمل GeospatialExample، وانقر على التوقيع الإمكانات.

  2. ضَع علامة في المربّع إدارة التوقيع تلقائيًا.

  3. في الحقل الفريق، أدخِل اسم فريق.

    يمكنك استخدام Bundle Identifier التلقائي (معرّف الحزمة) لتشغيل التطبيق من Xcode، ولكن فيجب عليك تغييره إذا كنت تستخدم GeospatialExample كإجراء بديل لموقعك تطبيق في مرحلة الإنتاج.

  4. عليك توصيل جهازك لتشغيل نموذج التطبيق.

  5. أنشِئ تطبيق GeospatialExample وشغِّله من ملف .xcworkspace إلى وإطلاقه على جهازك.

    لتجنُّب أخطاء الإصدار، تأكَّد من إنشاء ميزات من ".xcworkspace". وليس ملف .xcodeproj.

من المفترض أن تتمكّن من رؤية عرض الكاميرا، بالإضافة إلى معلومات تصحيح الأخطاء التي تصف التحويل الجغرافي الحالي لجهازك. أثناء فحص البيئة من حولك، لاحظ أن قيم الثقة في تحديد الموضع قد تتغير كلما إذا كنت في منطقة تتوفر فيها أقلمة VPS.

عند التأكُّد من ARCore في الموقع الجغرافي وعنوان جهازك، يمكنك وضع ثبُت في موقعك الحالي باستخدام التحويل الجغرافي المكاني.

قد تكون دقة تحديد الموضع منخفضة جدًا في حال عدم توفّر معلومات VPS. يجب أن يكون التطبيق متصلاً بالإنترنت، ويجب أن يكون الموقع الجغرافي معروفًا لخدمة الخادم الافتراضي (VPS). للحصول على أفضل النتائج، شغِّل نموذج التطبيق في الخارج (وليس في الأماكن المغلقة) خلال ساعات النهار.

بالإضافة إلى ذلك، إذا كنت في منطقة لا تتيح استخدام VPS أو كانت إشارات GPS غير متاحة. قد تحتاج إلى تعديل حدود الثقة في التطبيق لكي لوضع ارتساء.

لضبط الحدود الدنيا:

  1. في Xcode، افتح الملف ViewController.m وتصفَّح للوصول إلى ما يلي: :

    // Thresholds for 'good enough' accuracy. These can be tuned for the
// application. We use both 'low'
// and 'high' values here to avoid flickering state changes.
static const CLLocationAccuracy kHorizontalAccuracyLowThreshold = 10;
static const CLLocationAccuracy kHorizontalAccuracyHighThreshold = 20;
static const CLLocationDirectionAccuracy kHeadingAccuracyLowThreshold = 15;
static const CLLocationDirectionAccuracy kHeadingAccuracyHighThreshold = 25;

  2. عدِّل هذه القيم حسب الحاجة. وكلما ارتفعت القيمة، انخفضت الدقة أقل.

    ويسمح خفض الدقة للتطبيق بالعرض بشكل أكبر في وضع علامة ارتساء. اطّلِع على تعديل دقة التحويل للحصول على مزيد من المعلومات.

الخطوات التالية

مراجعة دليل مطوّري البرامج الجغرافية المكانية لنظام التشغيل iOS وبدء الإنشاء باستخدام واجهة برمجة التطبيقات Geospatial API.