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

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

البدء السريع

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

البدء

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

الخطوة 1

وحدة التحكّم

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

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

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

    تقدّم Google Cloud فترة تجريبية بدون أي رسوم. تنتهي الفترة التجريبية إما بعد 90 يومًا أو بعد أن تتراكم في الحساب رسوم بقيمة 300 دولار أمريكي، أيهما أقرب. يمكنك الإلغاء في أي وقت. لمزيد من المعلومات، يُرجى الاطّلاع على اعتمادات حساب الفوترة والفوترة.

SDK للسحاب

gcloud projects create "PROJECT"

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

الخطوة 2

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

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

لتفعيل واجهة برمجة تطبيقات أو حزمة تطوير برامج واحدة أو أكثر، اتّبِع الخطوات التالية:

وحدة التحكّم

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

    انتقِل إلى صفحة مكتبة Maps API.

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

SDK للسحاب

يؤدي الأمر التالي إلى تفعيل جميع واجهات برمجة التطبيقات Maps وRoutes وPlaces:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.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" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

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

استخدِم الأمر التالي لتفعيل واجهات برمجة التطبيقات الخاصة بالبيئة:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

الخطوة 3

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

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

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

وحدة التحكّم

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

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

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

SDK للسحاب

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

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

اعتمادات حساب الفوترة

  • إذا لم يسبق لك الاشتراك في أي من خدمات Google Cloud أو "منصة خرائط Google" أو Firebase المدفوعة، ولم يسبق لك الاشتراك في الفترة التجريبية المجانية من Google Cloud، ستكون مؤهلاً للاستفادة من الفترة التجريبية المجانية ورصيد الترحيب البالغ 300 دولار أمريكي، ويمكنك إنفاق هذا الرصيد على خدمات "منصة خرائط Google".
  • يوفّر كل رمز تخزين تعريفي في "منصة خرائط Google" مقدارًا محدّدًا من الاستخدام الشهري المجاني، ويظهر ذلك في قائمة الأسعار ويتم توضيحه في الفوترة في "منصة خرائط Google".
  • تقدّم Google أيضًا أرصدة للبرامج العامة مثل المؤسسات غير الربحية والشركات الناشئة والاستجابة للأزمات ووسائل الإعلام الإخبارية والتعليم ووكالات النقل.

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

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