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

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

إنشاء مشروع

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

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

لإنشاء مشروع على السحابة الإلكترونية مع تفعيل الفوترة، يُرجى اتّباع الخطوات التالية:

وحدة التحكّم

  1. أنشئ مشروعًا جديدًا على Google Cloud في Cloud Console:

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

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

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

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

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

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

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

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

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

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

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

gcloud

gcloud projects create "PROJECT"

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

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

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

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

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

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

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

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

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

وحدة التحكّم

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

SDK للسحاب

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

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

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

وحدة التحكّم

لعرض واجهات برمجة التطبيقات أو حِزم تطوير البرامج (SDK) التي فعَّلتها، انتقِل إلى صفحة "منصة خرائط Google" في Cloud Console:

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

gcloud

gcloud services list --project "PROJECT"

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

إيقاف مشروع

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

وحدة التحكّم

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

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

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

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

gcloud

gcloud projects delete "PROJECT"

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

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

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

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