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