بدء استخدام "منصة خرائط Google"

تعرض هذه الصفحة الخطوات الأساسية المطلوبة لبدء استخدام أي من واجهات برمجة التطبيقات وحِزم تطوير البرامج (SDK) على "منصة خرائط Google".

التشغيل السريع

إذا لم يسبق لك استخدام Google Cloud Console لإنشاء حساب فوترة أو مشروع، انقر على زر البدء الذي يؤدي إلى تجربة إعداد تفاعلية في Cloud Console للمستخدمين الجدد:

البدء

يمكنك بدلاً من ذلك إكمال خطوات الإعداد المطلوبة من خلال النقر على علامات التبويب التالية:

الخطوة 1

وحدة التحكم

1. في Google Cloud Console، انقر على إنشاء مشروع في صفحة أداة اختيار المشروع لبدء إنشاء مشروع جديد على Cloud.

   الانتقال إلى صفحة أداة اختيار المشروع

2. تأكَّد من تفعيل الفوترة لمشروعك على السحابة الإلكترونية. تأكَّد من تفعيل الفوترة لمشروعك.

   ملاحظة: على الرغم من أنّه عليك إعداد حساب فوترة لإعداد مشروع على السحابة الإلكترونية، لا يتوفّر الاستخدام الفعلي لواجهة برمجة التطبيقات embed API بدون أي رسوم.

   تقدّم خدمة Google Cloud فترة تجريبية مجانية تبلغ 0.00 دولار أمريكي. تنتهي الفترة التجريبية إما في نهاية 90 يومًا أو بعد تراكم رسوم بقيمة 300 دولار أمريكي (أو ما يعادله بالعملة المحلية) على الحساب، أيهما أقرب. ويمكنك الإلغاء في أي وقت. تتميّز "منصة خرائط Google" برصيد شهري متكرر بقيمة 200 دولار أمريكي. لمزيد من المعلومات، يُرجى الاطّلاع على أرصدة حساب الفوترة والفوترة.

Cloud SDK

gcloud projects create "PROJECT"

يمكنك الاطّلاع على مزيد من المعلومات عن حزمة SDK في Google Cloud وتثبيت SDK للسحابة الإلكترونية والأوامر التالية:

• gcloud projects create

الخطوة 2

لاستخدام "منصة خرائط Google"، يجب تفعيل واجهات برمجة التطبيقات أو حِزم SDK التي تخطط لاستخدامها مع مشروعك.

تجدر الإشارة إلى أن بعض عمليات الدمج تتطلب منك تفعيل العديد من واجهات برمجة التطبيقات/حِزم تطوير البرامج (SDK). وإذا لم تكن متأكدًا من واجهات برمجة التطبيقات أو حِزم تطوير البرامج (SDK) التي تريد تفعيلها، يمكنك محاولة استخدام أداة اختيار واجهة برمجة التطبيقات أو الرجوع إلى المستندات المتعلّقة بواجهة برمجة التطبيقات/حزمة تطوير البرامج (SDK) التي تريد استخدامها.

لتفعيل واجهة برمجة تطبيقات أو حزمة تطوير برامج (SDK) واحدة أو أكثر:

وحدة التحكم

1. يمكنك الاطّلاع على واجهات برمجة التطبيقات وحِزم تطوير البرامج (SDK) في "منصة خرائط Google" التي يمكنك تفعيلها من خلال الانتقال إلى صفحة "مكتبة واجهة برمجة تطبيقات الخرائط" في Cloud Console:

   انتقِل إلى صفحة مكتبة API للخرائط.

2. انقر على واجهة برمجة التطبيقات أو حزمة تطوير البرامج (SDK) التي تريد تفعيلها.
   • إذا ظهر على الزرّ تفعيل، انقر على الزر لتفعيل واجهة برمجة التطبيقات أو حزمة تطوير البرامج (SDK).
   • إذا كان الزرّ يحمل عبارة إدارة، يعني ذلك أنّه سبق تفعيل واجهة برمجة التطبيقات أو حزمة تطوير البرامج (SDK) وليس عليك اتخاذ أي إجراء آخر.
   • وسيؤدي النقر على أي من الزرين إلى عرض لوحة بيانات واجهة برمجة التطبيقات أو حزمة تطوير البرامج (SDK). (انقر على الزر إيقاف لإزالة واجهة برمجة التطبيقات أو حزمة تطوير البرامج (SDK) من هذا المشروع).

Cloud SDK

gcloud services enable \
    --project "PROJECT" \
    "directions-backend.googleapis.com" \
    "distance-matrix-backend.googleapis.com" \
    "addressvalidation.googleapis.com" \
    "tileaerialview.googleapis.com" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "places-backend.googleapis.com" \
    "pollen.googleapis.com" \
    "roads.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

يمكنك الاطّلاع على مزيد من المعلومات عن حزمة SDK في Google Cloud وتثبيت SDK للسحابة الإلكترونية والأوامر التالية:

• gcloud services enable
• gcloud services disable

ملاحظة: يؤدي تفعيل واجهة برمجة تطبيقات الأماكن أيضًا إلى تفعيل مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط وحزمة تطوير برامج الأماكن على نظام التشغيل Android وحزمة تطوير برامج الأماكن على نظام التشغيل iOS.

الخطوة 3

يتم تنفيذ هذه الخطوة فقط في عملية إنشاء مفتاح واجهة برمجة التطبيقات. إذا كنت تستخدم مفتاح واجهة برمجة التطبيقات في الإنتاج، ننصحك بشدة بحظر مفتاح واجهة برمجة التطبيقات. ويمكنك العثور على مزيد من المعلومات في صفحة استخدام مفاتيح واجهة برمجة التطبيقات المخصّصة للمنتج.

مفتاح واجهة برمجة التطبيقات هو معرّف فريد يصادق على الطلبات المرتبطة بمشروعك لأغراض الاستخدام والفوترة. يجب أن يكون لديك مفتاح واجهة برمجة تطبيقات واحد على الأقل مرتبط بمشروعك.

لإنشاء مفتاح واجهة برمجة التطبيقات:

وحدة التحكم

1. انتقِل إلى صفحة منصة خرائط Google > بيانات الاعتماد.

   الانتقال إلى صفحة "بيانات الاعتماد"

2. في صفحة بيانات الاعتماد، انقر على إنشاء بيانات اعتماد > مفتاح واجهة برمجة التطبيقات.
   يعرض مربّع الحوار تم إنشاء مفتاح واجهة برمجة التطبيقات مفتاح واجهة برمجة التطبيقات الذي أنشأته حديثًا.
3. انقر على إغلاق.
   يتم إدراج مفتاح واجهة برمجة التطبيقات الجديد في صفحة بيانات الاعتماد ضمن مفاتيح واجهة برمجة التطبيقات.
   (احرص على حظر مفتاح واجهة برمجة التطبيقات قبل استخدامه في عملية الإنتاج).

Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

يمكنك الاطّلاع على مزيد من المعلومات عن حزمة SDK في Google Cloud وتثبيت SDK للسحابة الإلكترونية والأوامر التالية:

• gcloud alpha services api-keys create

أرصدة حساب الفوترة

بعد إنشاء حساب ومشروع فوترة، تصبح مؤهلاً للحصول على فترة تجريبية بدون رسوم بقيمة 300 دولار أمريكي على منصة Google Cloud والحصول على رصيد شهري متكرر بقيمة 200 دولار أمريكي (أو ما يعادله بالعملة المحلية) من "منصة خرائط Google". لمزيد من المعلومات، اطّلِع على أرصدة حساب الفوترة.

الخطوات التالية

بعد الانتهاء من عملية الإعداد، يمكنك البدء في استخدام واجهات برمجة التطبيقات وحِزم تطوير البرامج (SDK) في "منصة خرائط Google". لمعرفة المزيد، يُرجى الاطّلاع على أدلة "نظرة عامة" و"مطوّري البرامج" و"البدء" لواجهة برمجة التطبيقات أو حزمة تطوير البرامج (SDK) التي تهمك. يتم إدراج واجهات برمجة التطبيقات وحِزم تطوير البرامج (SDK) في مستندات "منصة خرائط Google" (حسب المنتج) وواجهات برمجة التطبيقات في "منصة خرائط Google" (حسب النظام الأساسي).