يوضّح هذا الدليل كيفية إعداد مشروعك على Google Cloud قبل استخدام واجهات برمجة التطبيقات في "منصة خرائط Google". على الرغم من أنّك قد تكون أكملت بعض هذه الخطوات في دليل البدء السريع أو بدء استخدام "منصة خرائط Google"، يقدّم هذا المستند تعليمات إضافية لإدارة مشاريعك.
إنشاء مشروع
لاستخدام "منصة خرائط Google"، يجب أن يكون لديك مشروع لإدارة الخدمات وبيانات الاعتماد والفوترة وواجهات برمجة التطبيقات وحزم تطوير البرامج (SDK).
يتطلّب كل مشروع إعداد الفوترة، ولكن لا تفرض Google رسومًا عليك إلا إذا تجاوز المشروع حصته من الخدمات بدون رسوم.
لإنشاء مشروع على السحابة الإلكترونية مع تفعيل الفوترة، يُرجى اتّباع الخطوات التالية:
وحدة التحكّم
-
أنشئ مشروعًا جديدًا في Google Cloud في وحدة تحكّم Cloud.
-
في صفحة مشروع جديد، املأ المعلومات المطلوبة:
-
اسم المشروع: يمكنك قبول الاسم التلقائي أو إدخال اسم مخصّص.
يمكنك تغيير اسم المشروع في أي وقت. لمزيد من المعلومات، يُرجى الاطّلاع على تحديد المشاريع.
-
رقم تعريف المشروع: يمكنك قبول الرقم التلقائي أو النقر على تعديل لإدخال رقم تعريف مخصّص تستخدمه واجهات Google API كمعرّف فريد لمشروعك.
بعد إنشاء المشروع، لا يمكنك تغيير رقم تعريف المشروع، لذا اختَر رقم تعريف يلبي احتياجاتك طوال مدة المشروع. يُرجى عدم إدراج أي معلومات حساسة في رقم تعريف المشروع.
-
حساب الفوترة: اختَر حساب فوترة للمشروع. إذا لم تكن قد أعددت حساب فوترة أو كان لديك حساب فوترة واحد فقط، لن يظهر لك هذا الخيار.
يجب أن تكون مشرف حساب فوترة أو مدير فوترة مشروع لربط مشروع بحساب فوترة. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على أدوار "فوترة Cloud" في "إدارة الهوية وإمكانية الوصول".
-
الموقع الجغرافي: إذا كانت لديك مؤسسة تريد ربط مشروعك بها، انقر على تصفُّح واختَرها، وإلا اختَر بدون مؤسسة.
لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء المجلدات وإدارتها و العلاقات بين المؤسسات والمشاريع وحسابات الفوترة.
-
-
انقر على إنشاء.
gcloud
gcloud projects create "PROJECT"
يمكنك الاطّلاع على مزيد من المعلومات حول Google Cloud SDK وتثبيت Cloud SDK والأوامر التالية:
تفعيل الفوترة
لنشر تطبيقاتك، عليك تفعيل الفوترة. لا تفرض Google رسومًا على حسابك إذا لم تتجاوز الحصة الشهرية. إذا كان تطبيقك يستخدم موارد تتجاوز الحصة الشهرية، ستفرض Google رسومًا مقابل الاستخدام الإضافي.
إذا كان لديك حساب فوترة عند إنشاء مشروع على السحابة الإلكترونية، ستفعّل Google Cloud الفوترة تلقائيًا في هذا المشروع.
لتفعيل الفوترة في مشروع على السحابة الإلكترونية، يُرجى إكمال الخطوات التالية:
-
في وحدة تحكّم Cloud، انتقِل إلى صفحة الفوترة:
- اختَر مشروعًا على السحابة الإلكترونية أو أنشِئ مشروعًا جديدًا.
-
استنادًا إلى ما إذا كان هناك حساب فوترة أو ما إذا كان مشروع على السحابة الإلكترونية المحدّد مرتبطًا بحساب، تعرض صفحة الفوترة أحد الخيارات التالية:
- إذا كانت الفوترة مفعَّلة لمشروع على السحابة الإلكترونية المحدّد، ستعرض الصفحة تفاصيل حساب الفوترة.
- إذا لم يكن هناك حساب فوترة، ستطلب منك وحدة التحكّم إنشاء حساب فوترة وربطه بالمشروع المحدّد على السحابة الإلكترونية.
- إذا كان هناك حساب فوترة ولم يكن المشروع المحدّد على السحابة الإلكترونية مرتبطًا بحساب فوترة، ستطلب منك وحدة التحكّم تفعيل الفوترة. يمكنك أيضًا النقر على إلغاء، ثم النقر على إنشاء حساب لإنشاء حساب فوترة جديد وربطه.
بعد تفعيل الفوترة، لن يكون هناك حدّ أقصى للمبلغ الذي قد تفرضه Google عليك. للتحكّم بشكل أكبر في التكاليف، يمكنك إنشاء ميزانية وضبط التنبيهات. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الفوترة في "منصة خرائط Google".
تفعيل واجهات برمجة التطبيقات
لاستخدام "منصة خرائط Google"، يجب تفعيل واجهات برمجة التطبيقات أو حزم تطوير البرامج (SDK) التي تخطّط لاستخدامها في مشروعك.
وحدة التحكّم
SDK للسحاب
gcloud services enable \ --project "PROJECT" \ "directions-backend.googleapis.com"
يمكنك الاطّلاع على مزيد من المعلومات حول Google Cloud SDK وتثبيت Cloud SDK والأوامر التالية:
عرض واجهات برمجة التطبيقات المفعَّلة
وحدة التحكّم
للاطّلاع على واجهات برمجة التطبيقات أو حزم تطوير البرامج (SDK) التي فعّلتها، انتقِل إلى صفحة واجهات برمجة التطبيقات والخدمات في "منصة خرائط Google " ضمن وحدة تحكّم Cloud.
الانتقال إلى صفحة "منصة خرائط Google"
- واجهات برمجة التطبيقات الإضافية: واجهات برمجة التطبيقات أو حِزم تطوير البرامج (SDK) هذه غير مفعَّلة.
- إذا كانت الصفحة تعرض بطاقات لواجهات برمجة تطبيقات وخدمات فردية في "خرائط Google"، يعني ذلك أنّك لم تفعّل أي واجهات برمجة تطبيقات أو حِزم تطوير برامج (SDK) بعد.
gcloud
gcloud services list --project "PROJECT"
يمكنك الاطّلاع على مزيد من المعلومات حول Google Cloud SDK وتثبيت Cloud SDK والأوامر التالية:
إيقاف مشروع
لإيقاف الفوترة وإلغاء تخصيص جميع موارد Cloud التي يستخدمها مشروعك على السحابة الإلكترونية، عليك إيقاف المشروع:
وحدة التحكّم
-
انتقِل إلى صفحة إدارة الموارد في وحدة تحكّم Cloud.
-
اختَر مشروع Cloud الذي تريد إيقافه، ثم انقر على حذف.
لمزيد من المعلومات حول إدارة مشاريعك على Cloud، يُرجى الاطّلاع على مقالة إنشاء المشاريع وإدارتها.
gcloud
gcloud projects delete "PROJECT"
يمكنك الاطّلاع على مزيد من المعلومات حول Google Cloud SDK وتثبيت Cloud SDK والأوامر التالية:
الخطوات التالية
بعد إعداد مشروعك على Google Cloud، أنشِئ مفتاح واجهة برمجة التطبيقات وأمِّنه لاستخدام Directions API (الإصدار القديم):
استخدام مفاتيح واجهة برمجة التطبيقات