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

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

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

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

إذا كنت جديدًا في مجال التطوير باستخدام ARCore، يُرجى الاطّلاع على البدء.

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

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

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

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

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

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

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

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

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

لاستخدام نظام تحديد المواقع المرئي (VPS)، يجب ربط تطبيقك بمشروع على Google Cloud تم تفعيله لواجهة برمجة تطبيقات ARCore.

يجب تفعيل ARCore API في مشروعك على Google Cloud. إذا كنت بحاجة إلى إنشاء المشروع، فقم بما يلي:

  1. يُرجى الانتقال إلى إنشاء مشروع في Google Cloud Platform.

  2. أدخِل اسم مشروع مناسبًا، واختَر موقعًا جغرافيًا له.

  3. انقر على إنشاء.

  4. في الشريط الجانبي، اختَر واجهات برمجة التطبيقات والخدمات، ثم المكتبة.

  5. ابحث عن ARCore API، واختَرها وانقر على تفعيل.

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

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

  1. في مشروعك على Google Cloud، احصل على مفتاح واجهة برمجة التطبيقات كما هو موضَّح في إنشاء مفتاح واجهة برمجة التطبيقات.

  2. انسخ مفتاح واجهة برمجة التطبيقات كما ستلصقه في خطوة لاحقة.

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

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

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

إعداد حزمة تطوير برامج ARCore

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

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

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

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

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

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

    يمكنك استخدام معرِّف الحزمة التلقائي لتشغيل التطبيق من 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.