الإعداد

توضّح هذه الصفحة الإجراءات التي يجب اتّخاذها لإعداد حزمة تطوير البرامج (SDK) الثلاثية الأبعاد لـ "خرائط Google" لنظام التشغيل iOS وبدء استخدامها. تتضمّن عملية الإعداد ضبط مشروع على Google Cloud وواجهة برمجة تطبيقات لاستخدامهما مع حزمة تطوير البرامج (SDK)، ثم إعداد مشروع Xcode. أكمِل هذه الخطوات قبل إضافة أول خريطة ثلاثية الأبعاد إلى تطبيقك.

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

لاستخدام حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة iOS، يجب أن يستوفي مشروعك وأجهزة الاختبار المتطلبات التالية:

  • الحدّ الأدنى لإصدار iOS: يجب استهداف الإصدار 16.0 من iOS أو إصدار أحدث.
  • ‫Xcode: الإصدار 16.0 من Xcode أو إصدار أحدث

إعداد مشروع على Google Cloud ومفتاح واجهة برمجة التطبيقات

قبل البدء في إنشاء التطبيقات باستخدام حزمة تطوير البرامج (SDK) الثلاثية الأبعاد لـ "خرائط Google" لأجهزة iOS، عليك إعداد مشروع على السحابة الإلكترونية على Google Cloud ومفتاح واجهة برمجة التطبيقات لاستخدامهما مع حزمة تطوير البرامج (SDK) الثلاثية الأبعاد لـ "خرائط Google" لأجهزة iOS من خلال إكمال الخطوات التالية:

الخطوة 1: إعداد مشروعك

وحدة التحكّم

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

    الانتقال إلى صفحة أداة اختيار المشاريع

  2. تأكَّد من تفعيل الفوترة لمشروعك على السحابة الإلكترونية. تأكَّد من تفعيل الفوترة لمشروعك.

    تقدّم Google Cloud فترة تجريبية بدون أي رسوم. تنتهي الفترة التجريبية بعد 90 يومًا أو بعد أن يبلغ حسابك رسومًا بقيمة 300 دولار أمريكي، أيهما أقرب. يمكنك إلغاء الاشتراك في أي وقت. لمزيد من المعلومات، يُرجى الاطّلاع على أرصدة حساب الفوترة والفوترة.

SDK للسحاب

gcloud projects create "PROJECT"

يمكنك الاطّلاع على مزيد من المعلومات حول Google Cloud SDK وتثبيت Cloud SDK والأوامر التالية:

الخطوة 2: تفعيل واجهات برمجة التطبيقات أو حِزم تطوير البرامج (SDK)

لاستخدام "منصة خرائط Google"، يجب تفعيل واجهات برمجة التطبيقات أو حزم تطوير البرامج (SDK) التي تخطّط لاستخدامها مع مشروعك.

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

لتفعيل واجهة برمجة تطبيقات أو حزمة تطوير برامج (SDK) واحدة أو أكثر، اتّبِع الخطوات التالية:

وحدة التحكّم

  1. يمكنك الاطّلاع على واجهات برمجة التطبيقات وحزم تطوير البرامج (SDK) في "منصة خرائط Google" التي يمكنك تفعيلها من خلال الانتقال إلى صفحة مكتبة Maps API في وحدة تحكّم Cloud:

    انتقِل إلى صفحة مكتبة Maps API

  2. انقر على واجهة برمجة التطبيقات أو حزمة تطوير البرامج (SDK) التي تريد تفعيلها.
    • إذا كان الزر يحمل عبارة تفعيل، انقر عليه لتفعيل واجهة برمجة التطبيقات أو حزمة تطوير البرامج (SDK).
    • إذا كان الزر يحمل عبارة إدارة، يعني ذلك أنّ واجهة برمجة التطبيقات أو حزمة تطوير البرامج (SDK) مفعَّلة، ولست بحاجة إلى اتّخاذ أي إجراء آخر.
    • سيؤدي النقر على أيّ من الزرَّين إلى عرض لوحة البيانات الخاصة بواجهة برمجة التطبيقات أو حزمة تطوير البرامج (SDK). (انقر على الزر إيقاف لإزالة واجهة برمجة التطبيقات أو حزمة تطوير البرامج (SDK) من هذا المشروع).

SDK للسحاب

يؤدي الأمر التالي إلى تفعيل جميع واجهات برمجة التطبيقات Maps API وRoutes API وPlaces API:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

يمكنك الاطّلاع على مزيد من المعلومات حول Google Cloud SDK وتثبيت Cloud SDK والأوامر التالية:

استخدِم هذا الأمر لتفعيل واجهات برمجة التطبيقات الخاصة بالبيئة:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

الخطوة 3: الحصول على مفتاح واجهة برمجة التطبيقات

تتناول هذه الخطوة عملية إنشاء مفتاح واجهة برمجة التطبيقات فقط. إذا كنت تستخدم مفتاح واجهة برمجة التطبيقات في الإنتاج، ننصحك بشدة بتقييد مفتاح واجهة برمجة التطبيقات. يمكنك العثور على مزيد من المعلومات في صفحة استخدام مفاتيح واجهة برمجة التطبيقات الخاصة بالمنتج.

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

وحدة التحكّم

  1. انتقِل إلى صفحة منصة خرائط Google > المفاتيح وبيانات الاعتماد.

    الانتقال إلى صفحة "المفاتيح وبيانات الاعتماد"

  2. اختَر مشروعك إذا طُلب منك ذلك.

  3. نفّذ أيًا مما يلي:

    • إنشاء مفتاح جديد:

      1. انقر على إنشاء بيانات الاعتماد > مفتاح واجهة برمجة التطبيقات.
      2. في لوحة إنشاء مفتاح واجهة برمجة التطبيقات، افتح قائمة اختيار قيود واجهة برمجة التطبيقات.
      3. امسح أي واجهات برمجة تطبيقات لا يحتاجها هذا المفتاح، وتأكَّد من أنّ واجهات برمجة التطبيقات التي تخطّط لاستخدامها تظلّ محدّدة.
      4. انقر على إنشاء. تعرض اللوحة مفتاح واجهة برمجة التطبيقات الجديد.

    • استخدام مفتاح حالي:

      1. انقر على اسم المفتاح.
      2. في قائمة اختيار قيود واجهة برمجة التطبيقات، اختَر واجهات برمجة التطبيقات التي تخطّط لاستخدامها.
      3. انقر على حفظ.

    لا يؤدي اختيار واجهة برمجة تطبيقات هنا إلى تفعيلها. تأكَّد من تفعيل كل واجهة برمجة تطبيقات تختارها في مكتبة واجهة برمجة التطبيقات.

  4. للاطّلاع على سلسلة المفاتيح لاحقًا، انتقِل إلى صفحة المفاتيح وبيانات الاعتماد وانقر على عرض المفتاح للمفتاح المطلوب.

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

SDK للسحاب

استبدِل PROJECT_ID برقم تعريف مشروعك في الأوامر التالية.

  • إنشاء مفتاح جديد: نفِّذ الأمر التالي، واستبدِل DISPLAY_NAME باسم المفتاح. استبدِل SERVICE_NAME باسم الخدمة لواجهة برمجة التطبيقات التي تخطّط لاستخدامها، مثل places.googleapis.com. للسماح بالمزيد من واجهات برمجة التطبيقات، كرِّر العلامة --api-target.

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=SERVICE_NAME

    يمكنك الاطّلاع على مزيد من المعلومات حول Google Cloud SDK وتثبيت Cloud SDK والأوامر التالية:

  • استخدام مفتاح حالي: نفِّذ الأمر التالي، واستبدِل KEY_ID بمعرّف المفتاح. استبدِل SERVICE_NAME باسم الخدمة لواجهة برمجة التطبيقات التي تريد إضافتها. تحتفظ العلامة --append بواجهات برمجة التطبيقات التي يسمح بها المفتاح حاليًا. وبدونها، يستبدلها الأمر.

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=SERVICE_NAME

    يمكنك الاطّلاع على مزيد من المعلومات حول Google Cloud SDK وتثبيت Cloud SDK والأوامر التالية:

    معرّف المفتاح ليس سلسلة المفتاح أو اسم العرض. للعثور عليه، شغِّل gcloud services api-keys list --project="PROJECT_ID". رقم التعريف هو الجزء الأخير من حقل name: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

للاطّلاع على سلسلة المفاتيح، شغِّل gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID".

لتفعيل حزمة تطوير البرامج (SDK)، يُرجى الاطّلاع على صفحة حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة iOS في Google Cloud Console. لمزيد من المعلومات حول إكمال هذه الخطوات، يُرجى الاطّلاع على مقالة بدء استخدام "منصة خرائط Google".

إعداد مشروع Xcode

يشرح هذا القسم كيفية إنشاء مشروع Xcode وإعداده لاستخدامه مع حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة iOS.

بعد تفعيل الفوترة وإنشاء مفتاح واجهة برمجة التطبيقات، يمكنك إعداد مشروع Xcode الذي تستخدمه لتطوير تطبيقك.

الخطوة 1: تثبيت البرنامج المطلوب

لإنشاء مشروع باستخدام حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة iOS، يجب تنزيل وتثبيت ما يلي:

  • الإصدار 16.0 من Xcode أو إصدار أحدث

الخطوة 2: إنشاء مشروع Xcode وتثبيت حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة iOS

Swift Package Manager

يمكن تثبيت حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة iOS باستخدام Swift Package Manager.

لإضافة حزمة تطوير البرامج (SDK) إلى مشروع جديد أو حالي، اتّبِع الخطوات التالية:

  • افتح Xcode project‏ أو workspace، ثم انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة.
  • أدخِل https://github.com/googlemaps/ios-maps-3d-sdk كعنوان URL، واضغط على Enter لسحب الحزمة، ثم انقر على "إضافة حزمة" (Add Package).
  • من نافذة اختيار منتجات الحزمة، تأكَّد من أنّه ستتم إضافة "GoogleMaps3D" إلى الهدف الرئيسي المحدّد. بعد إتمام الخطوة السابقة، انقر على إضافة حزمة.
  • للتحقّق من التثبيت، انتقِل إلى لوحة عام في الهدف. في الأطر والمكتبات والمحتوى المضمّن، من المفترض أن تظهر لك الحِزم المثبَّتة. يمكنك أيضًا الاطّلاع على قسم Package Dependencies (تبعيات الحزمة) في Project Navigator (متصفّح المشروع) للتحقّق من الحزمة وإصدارها.

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

Swift Package Manager

أضِف مفتاح واجهة برمجة التطبيقات إلى نقطة الدخول الرئيسية لتطبيقك (أو في أي وقت قبل تحميل الخريطة) على النحو التالي.

  1. أضِف عبارة الاستيراد التالية: 
    import GoogleMaps3D
  2. أضِف الطريقة التالية. استبدِل YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات الخاص بك. 
    struct ContentView: View {
  init () {
    Map.apiKey = "YOUR_API_KEY"
  }

  var body: some View {
    Map(mode: .hybrid)
  }
}

الخطوة 4 (اختيارية): فحص ملف Apple Privacy Manifest

تتطلّب Apple تفاصيل خصوصية التطبيقات على متجر التطبيقات.

يتم تضمين ملف Apple Privacy Manifest في حزمة الموارد الخاصة بحزمة تطوير البرامج (SDK). للتأكّد من تضمين ملف بيان الخصوصية وفحص محتواه، يمكنك إنشاء أرشيف لتطبيقك وإنشاء تقرير خصوصية من الأرشيف.

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

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