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

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

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

إنشاء مشروع

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

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

لإنشاء مشروع على السحابة الإلكترونية مع تفعيل الفوترة:

وحدة التحكّم

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

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

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

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

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

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

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

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

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

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

  3. حدِّد إنشاء.

gcloud

gcloud projects create "PROJECT"

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

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

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

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

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

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

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

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

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

حزمة تطوير برامج الأماكن لأجهزة Android (جديدة)

وحدة التحكّم

تفعيل Places API (جديدة)

Cloud SDK

gcloud services enable \
    --project "PROJECT" \
    "places.googleapis.com"

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

حزمة تطوير برامج الأماكن لأجهزة Android

وحدة التحكّم

تفعيل Places API

Cloud SDK

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

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

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

وحدة التحكّم

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

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

gcloud

gcloud services list --project "PROJECT"

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

إيقاف مشروع

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

وحدة التحكّم

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

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

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

gcloud

gcloud projects delete "PROJECT"

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

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

بعد إعداد مشروعك على Google Cloud، يجب إنشاء مفتاح واجهة برمجة التطبيقات وتأمينه لاستخدام حزمة تطوير برامج الأماكن الحالية لنظام التشغيل Android أو حزمة تطوير البرامج للأماكن المخصّصة لنظام التشغيل Android (جديد):

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