الإعداد

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

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

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