تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

اختَر النظام الأساسي: Android iOS JavaScript

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

إنشاء مفاتيح واجهة برمجة التطبيقات

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

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

وحدة التحكّم

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

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

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

Cloud SDK

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

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

تحتاج إلى مفتاح واجهة برمجة التطبيقات هذا عند إنشاء مشروع Xcode كما هو موضَّح في إعداد مشروع Xcode.

تقييد مفاتيح واجهة برمجة التطبيقات

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

لتقييد مفتاح واجهة برمجة تطبيقات:

وحدة التحكّم

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

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

  2. اختَر مفتاح واجهة برمجة التطبيقات الذي تريد إعداد قيود عليه. تظهر صفحة موقع مفتاح واجهة برمجة التطبيقات.
  3. ضمن القيود الرئيسية، اضبط القيود التالية:
    • قيود التطبيق:
      1. اختَر تطبيقات iOS.
      2. لقبول الطلبات من تطبيق iOS باستخدام معرّف الحزمة الذي تقدّمه، اختَر معرّف حزمة iOS المناسب من القائمة.
    • قيود واجهة برمجة التطبيقات:
      1. انقر على تقييد المفتاح.
      2. اختَر Maps SDK for iOS من القائمة المنسدلة Select APIs (اختيار واجهات برمجة التطبيقات). إذا لم تكن حزمة تطوير البرامج (SDK) للخرائط متوفّرة لنظام التشغيل iOS، عليك تفعيلها.
  4. لإنهاء التغييرات التي أجريتها، انقر على حفظ.

Cloud SDK

يمكنك إدراج المفاتيح الحالية.

gcloud services api-keys list --project="PROJECT"

محو القيود الحالية على المفتاح الحالي.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

يمكنك ضبط قيود جديدة على المفتاح الحالي.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api_target="maps-ios-backend.googleapis.com"
    --allowed-bundle-ids="BUNDLE_NAME"

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

بعد أن حصلت على مفتاح واجهة برمجة التطبيقات لميزة "خرائط Google" SDK لنظام التشغيل iOS، أصبحت جاهزًا للبدء.

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

بعد أن تمكّنت من إنشاء مفتاح واجهة برمجة تطبيقات، عليك إنشاء مشروع Xcode وضبطه على النحو الموضّح في إعداد مشروع Xcode.