الإعداد

هذا المنتج أو الميزة تجريبية (قبل طرحها للجميع). قد يكون الدعم المقدَّم للمنتجات والميزات في مرحلة ما قبل الإصدار العلني محدودًا، وقد لا تكون التغييرات التي يتم إجراؤها على المنتجات والميزات في مرحلة ما قبل الإصدار العلني متوافقة مع الإصدارات الأخرى من مرحلة ما قبل الإصدار العلني. تخضع "عروض مرحلة ما قبل الإطلاق" لالبنود الخاصة بخدمة "منصّة خرائط Google". لمزيد من المعلومات، يُرجى الاطّلاع على أوصاف مراحل الإطلاق.

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

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

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

الخطوة 1

وحدة التحكّم

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

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

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

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

SDK للسحاب

gcloud projects create "PROJECT"

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

• gcloud projects create

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

الخطوة 2

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

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

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

وحدة التحكّم

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

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

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

SDK للسحاب

يُفعِّل الأمر التالي جميع واجهات برمجة التطبيقات في "خرائط Google" و"الطرق" و"الأماكن":

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

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

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

ملاحظة: يؤدي تفعيل واجهة برمجة تطبيقات الأماكن إلى تفعيل مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط وحزمة تطوير البرامج (SDK) للأماكن لنظام Android وحزمة تطوير البرامج (SDK) للأماكن لنظام 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

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

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

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

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

أداة إدارة حِزم Swift

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

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