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