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