إعداد مشروعك على Google Cloud

يوضّح هذا الدليل كيفية إعداد مشروعك على Google Cloud قبل استخدام واجهات برمجة التطبيقات Google Maps Platform API. على الرغم من أنّه من المحتمل أنّك أكملت بعضًا من هذه الخطوات في البدء السريع أو صفحة البدء باستخدام "منصة خرائط Google"، فإنه يقدّم هذا الموضوع تعليمات إضافية ومفيدة لإدارة مشاريعك.

إنشاء مشروع

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

يجب إعداد الفوترة لكل مشروع، ولكن لن يتم تحصيل رسوم منك إلا إذا تجاوز أحد المشاريع حصته من الخدمات المجانية.

لإنشاء مشروع على Cloud مع تفعيل الفوترة:

وحدة التحكّم

  1. أنشئ مشروعًا جديدًا على Google Cloud في وحدة تحكّم Cloud:

    إنشاء مشروع جديد

  2. في صفحة مشروع جديد، املأ المعلومات المطلوبة:

    • اسم المشروع: يمكنك قبول الاسم التلقائي أو إدخال اسم مخصّص.

      يمكنك تغيير اسم المشروع في أي وقت. لمزيد من المعلومات، يُرجى الاطّلاع على تحديد المشاريع.

    • معرّف المشروع: يمكنك قبول الإعداد التلقائي أو النقر على تعديل لإدخال معرّف مخصّص تستخدمه واجهات برمجة تطبيقات Google كمعرّف فريد لمشروعك.

      بعد إنشاء المشروع، لا يمكنك تغيير معرّف المشروع، لذا اختَر معرّفًا يناسبك استخدامه طوال مدة المشروع. لا تُدرِج أي معلومات حسّاسة في رقم تعريف المشروع.

    • حساب الفوترة: اختَر حساب فوترة للمشروع. لن يظهر لك هذا الخيار إذا لم يسبق لك إعداد حساب فوترة أو إذا كان لديك حساب فوترة واحد فقط.

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

    • الموقع الجغرافي: إذا كانت لديك مؤسسة تريد ربط مشروعك بها، انقر على تصفّح واختَرها، وإذا لم يكن الأمر كذلك، اختَر "بدون مؤسسة".

      لمزيد من المعلومات، يُرجى الاطّلاع على مقالتَي إنشاء المجلدات وإدارتها والعلاقات بين المؤسسات والمشاريع وحسابات الفوترة.

  3. انقر على إنشاء.

gcloud

gcloud projects create "PROJECT"

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

تفعيل الفوترة

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

إذا كان لديك حساب فوترة عند إنشاء مشروع على Cloud، سيتم تفعيل الفوترة تلقائيًا في ذلك المشروع.

لتفعيل الفوترة في مشروع على Cloud:

  1. في Cloud Console، انتقِل إلى صفحة "الفوترة":
    الانتقال إلى صفحة "الفوترة"
  2. اختَر مشروعًا على السحابة الإلكترونية أو أنشِئه.
  3. استنادًا إلى ما إذا كان هناك حساب فوترة أو ما إذا كان مشروع Cloud المحدّد مرتبطًا بحساب، تعرض صفحة "الفوترة" أحد الخيارَين التاليَين:
    • إذا سبق أن تم تفعيل الفوترة لمشروع Cloud المحدّد، سيتم إدراج تفاصيل حساب الفوترة.
    • إذا لم يكن هناك حساب فوترة، سيُطلب منك إنشاء حساب فوترة وربطه بمشروع Cloud المحدّد.
    • إذا كان هناك حساب فوترة، سيُطلب منك تفعيل الفوترة إذا كان مشروع Cloud الذي اخترته ليس مرتبطًا بحساب فوترة. يمكنك أيضًا النقر على إلغاء ثم النقر على إنشاء حساب لإنشاء حساب فوترة جديد وربطه به.

بعد تفعيل ميزة الفوترة، ما مِن حدّ أقصى للمبلغ الذي قد يتم تحصيله منك. للتحكّم بشكلٍ أكبر في تكاليفك، يمكنك إنشاء ميزانية وضبط تنبيهات. لمزيد من المعلومات، يُرجى الاطّلاع على الفوترة.

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

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

وحدة التحكّم

تفعيل واجهة برمجة التطبيقات Maps Embed API

SDK للسحاب

gcloud services enable \
    --project "PROJECT" \
    "maps-embed-backend.googleapis.com"

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

عرض واجهات برمجة التطبيقات المفعّلة

وحدة التحكّم

لعرض واجهات برمجة التطبيقات أو حِزم تطوير البرامج (SDK) التي فعّلتها، انتقِل إلى صفحة Google Maps Platform في وحدة تحكّم Cloud:

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

gcloud

gcloud services list --project "PROJECT"

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

إغلاق مشروع

يمكنك إيقاف الفوترة وإطلاق جميع موارد Cloud التي يتم استخدامها في مشروعك على Cloud من خلال إغلاق هذا المشروع:

وحدة التحكّم

  1. انتقِل إلى صفحة "المشاريع":

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

  2. اختَر مشروع Cloud الذي تريد إغلاقه، ثم انقر على حذف.

لمزيد من المعلومات عن إدارة مشاريعك على Cloud، يُرجى الاطّلاع على مقالة Cloud Resource Manager: إنشاء المشاريع وإيقافها واستعادتها.

gcloud

gcloud projects delete "PROJECT"

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

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

بعد إعداد مشروعك على Google Cloud، عليك إنشاء مفتاح واجهة برمجة التطبيقات وتأمينه لاستخدام واجهة برمجة التطبيقات Maps Embed API:

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