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