الإعداد

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

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

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

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

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

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

الخطوة 1

وحدة التحكّم

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

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

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

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

SDK للسحاب

gcloud projects create "PROJECT"

مزيد من المعلومات عن Google Cloud SDK وتثبيت Cloud SDK والأوامر التالية:

الخطوة 2

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

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

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

وحدة التحكّم

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

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

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

SDK للسحاب

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

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 والأوامر التالية:

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

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

الخطوة 3

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

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

لإنشاء مفتاح واجهة برمجة التطبيقات، اتّبِع الخطوات التالية:

وحدة التحكّم

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

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

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

SDK للسحاب

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

مزيد من المعلومات عن Google Cloud SDK وتثبيت Cloud SDK والأوامر التالية:

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

إعداد مشروع Xcode

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

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

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

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

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

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

Swift Package Manager

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

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

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

الخطوة 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

تتطلّب Apple تفاصيل خصوصية التطبيق للتطبيقات على App Store.

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

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

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