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