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