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

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

البدء السريع

إذا لم يسبق لك استخدام Google Cloud Console لإنشاء حساب فوترة أو مشروع، انقر على الزر البدء الذي ينقل إلى تجربة إعداد interactive في 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 Maps Platform، يجب تفعيل واجهات برمجة التطبيقات أو حِزم تطوير البرامج (SDK) التي تخطّط لاستخدامها مع مشروعك.

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

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

وحدة التحكّم

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

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

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

SDK للسحاب

يُفعِّل الأمر التالي جميع واجهات برمجة التطبيقات في "خرائط Google" و"الطرق" و"الأماكن":

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 والأوامر التالية:

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

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 والأوامر التالية:

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

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

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

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