الإعداد

توضّح هذه الصفحة الإجراءات التي يجب اتّخاذها لإعداد حزمة تطوير البرامج (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 والأوامر التالية:

• gcloud projects create

ملاحظة: إذا كنت لا تخطط للاحتفاظ بالموارد التي تنشئها في تمرين تعليمي، أنشئ مشروعًا بدلاً من اختيار مشروع حالي. بعد الانتهاء من التمرين، يمكنك حذف المشروع، ما يؤدي إلى إزالة جميع الموارد المرتبطة به.

الخطوة 2

لاستخدام "منصة خرائط 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
• gcloud services disable

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

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

ملاحظة: يؤدي تفعيل Places API أيضًا إلى تفعيل مكتبة الأماكن وMaps JavaScript API وPlaces SDK for Android و Places SDK for iOS.

الخطوة 3

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

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

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

وحدة التحكّم

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

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

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

SDK للسحاب

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

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

• gcloud services api-keys create

لتفعيل حزمة تطوير البرامج (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، يمكنك إضافة خريطة ثلاثية الأبعاد إلى تطبيقك.