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