الإعداد والعرض التوضيحي

اختيار النظام الأساسي: Android iOS

توضّح هذه الصفحة كيفية إعداد مكتبة برامج الخدمات الخاصة بحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS.

لتجربة هذه الأدوات، يمكنك اتّخاذ أحد الإجراءين أدناه:

إضافة مكتبة برامج الخدمات الخاصة بحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS إلى مشروع Xcode

اتّبِع الخطوات التالية لإضافة مكتبة الأدوات إلى مساحة عمل Xcode:

استخدام Swift Package Manager

  1. إذا لم يكن لديك مشروع Xcode بعد، أنشئ مشروعًا الآن واحفظه على جهازك. (إذا كنت جديدًا في مجال تطوير تطبيقات iOS، أنشئ مشروعًا جديدًا واختَر نموذج تطبيق iOS. في Xcode 11.7 أو الإصدارات الأقدم، أنشئ تطبيقًا ذا عرض واحد.)
  2. أضِف حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS كملف تابع. يمكنك الاطّلاع على تثبيت حزمة تطوير البرامج (SDK) لمعرفة الخيارات.
  3. في مشروع Xcode، انتقِل إلى ملف -> حِزم Swift -> إضافة موارد الاعتمادية للحزمة.
  4. في النافذة المعروضة، أدخِل عنوان URL لمستودع مكتبة برامج الخدمات الخاصة بحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS https://github.com/googlemaps/google-maps-ios-utils وانقر على التالي.
  5. في النافذة التالية، انقر على خيار الدائرة الإصدار، ثم انقر على حتى الإصدار الرئيسي التالي من القائمة المنسدلة، وأدخِل الإصدار الأخير من "مكتبة برامج الخدمات الخاصة بحزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع iOS" (على سبيل المثال، "6.0.0").
  6. انقر على القائمة المنسدلة بجانب الإضافة إلى المشروع، واختَر مشروعك، ثم انقر على إضافة حزمة.

إضافة مفتاح واجهة برمجة التطبيقات إلى تطبيقك

راجِع إعداد مشروع Xcode للحصول على تعليمات حول إنشاء مفتاح واجهة برمجة تطبيقات وإضافته إلى مشروع Xcode.

إنشاء المشروع وتشغيله

بعد إضافة مفتاح واجهة برمجة التطبيقات، أنشئ المشروع وشغِّله.

استخدام أداة في تطبيقك

يمكنك الاطّلاع على المستندات الخاصة بكل أداة للحصول على مزيد من المعلومات حول كيفية استخدامها في تطبيقك:

تثبيت التطبيق التجريبي وتشغيله

تتضمّن مكتبة الأدوات المساعدة تطبيقًا تجريبيًا يمكنك تثبيته ثم تجربة كل أداة مساعدة.

ثبِّت التطبيق التجريبي باتّباع الخطوات التالية:

استخدام الملفات من GitHub

  1. نزِّل أرشيف عيّنة التعليمات البرمجية من GitHub وفكّ ضغط الأرشيف. يمكنك بدلاً من ذلك استنساخ المستودع في دليل محلي: 
    git clone https://github.com/googlemaps/google-maps-ios-utils.git
  2. افتح نافذة طرفية، وانتقِل إلى الدليل الذي وسّعت فيه نطاق الملفات النموذجية، ثم انتقِل إلى دليل النماذج المناسب للغة التي تريد استخدامها:

    Swift

    cd google-maps-ios-utils/samples/SwiftDemoApp
open SwiftDemoApp.xcodeproj

    Objective-C

    cd google-maps-ios-utils/samples/ObjCDemoApp
open ObjCDemoApp.xcodeproj

إضافة مفتاح واجهة برمجة التطبيقات إلى التطبيق التجريبي

في الحصول على مفتاح واجهة برمجة تطبيقات، يمكنك إنشاء مفتاح واجهة برمجة تطبيقات لتطبيقك. والآن، أضِف هذا المفتاح إلى مشروع Xcode الخاص بالتطبيق التجريبي.

Swift

أضِف مفتاح واجهة برمجة التطبيقات إلى AppDelegate.swift على النحو التالي:

  1. أضِف عبارة الاستيراد التالية: 
    import GoogleMaps
  2. عدِّل السطر التالي لإضافة مفتاح واجهة برمجة التطبيقات بين علامتَي الاقتباس المزدوجتَين: 
    // Change this key to a valid key registered with the demo app bundle id.
let mapsAPIKey = ""

Objective-C

أضِف مفتاح واجهة برمجة التطبيقات إلى AppDelegate.m على النحو التالي:

  1. أضِف عبارة الاستيراد التالية: 
    @import GoogleMaps;
  2. عدِّل السطر التالي لإضافة مفتاح واجهة برمجة التطبيقات بين علامتَي الاقتباس المزدوجتَين: 
    // Change this key to a valid key registered with the demo app bundle id.
static NSString *const kMapsAPIKey = @"";

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

بعد إضافة مفتاح واجهة برمجة التطبيقات، أنشئ المشروع وشغِّله:

  • إذا كنت تستخدم إصدار العرض التوضيحي من Swift، يمكنك اختيار الأداة التي تريد عرضها في التطبيق.
  • إذا كنت تستخدم إصدار Objective-C من العرض التوضيحي، سيظهر لك العرض التوضيحي لأداة تجميع العلامات. يمكنك بعد ذلك تعديل إصدار العرض التوضيحي بلغة Objective-C لتجربة كل أداة. يُرجى الاطّلاع على قسم إضافة أداة إلى تطبيقك أدناه لمزيد من المعلومات.