البدء السريع لواجهة برمجة تطبيقات تضمين الخرائط

ضع خريطة تفاعلية، أو بانوراما في "التجوّل الافتراضي" على صفحة الويب باستخدام طلب HTTP بسيط، بدون الحاجة إلى JavaScript.

التكاليف

تتوفر جميع طلبات واجهة برمجة التطبيقات Maps inline API بدون أي رسوم وباستخدام غير محدود. ومع ذلك، لا تزال جميع الطلبات تتطلّب مفتاح Google Cloud API صالحًا. لمزيد من المعلومات، يمكنك الاطّلاع على الاستخدام والفوترة.

قبل البدء

لإنشاء خريطة مضمّنة في صفحة الويب، أكمل خطوات الإعداد المطلوبة بالنقر على علامات التبويب التالية:

الخطوة 1

وحدة التحكّم

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

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

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

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

Cloud SDK

gcloud projects create "PROJECT"

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

الخطوة 2

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

وحدة التحكّم

تفعيل Maps تضمين API

Cloud SDK

gcloud services enable \
    --project "PROJECT" \
    "maps-embed-backend.googleapis.com"

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

الخطوة 3

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

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

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

وحدة التحكّم

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

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

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

Cloud SDK

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

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

إنشاء إطار iframe

انقر على الخيارات التالية وأضِف موقعًا جغرافيًا ومفتاح واجهة برمجة التطبيقات لإنشاء إطار iframe لصفحتك على الويب. للحصول على معلمات وخيارات إضافية، راجع تضمين خريطة.

اختبار إطار iframe

للاطلاع على إطار iframe في نافذة متصفح HTML:

  1. افتح محرِّر النصوص التلقائي. ينبغي أن تكون لديك أدوات تحرير نصوص مثل TextEdit أو Microsoft Windows Notepad مثبتة على جهازك افتراضيًا.
  2. أنشئ ملف HTML وحدِّد اسمه index.html.

  3. أضِف الرمز التالي مع إطار iframe الذي أنشأته أعلاه:

    <html>
  <!-- Replace this code comment with your iframe. -->
</html>

  4. احفظ ملف HTML index.html.

  5. حمِّل ملف HTML في متصفح ويب من خلال سحبه من سطح المكتب إلى متصفحك، أو بدلاً من ذلك، يعمل النقر مرّتين على الملف في معظم أنظمة التشغيل.

تهانينا! لقد قمت للتو بإعداد وإنشاء خريطة باستخدام واجهة برمجة تطبيقات Maps inline API.

جارٍ التنظيف

يمكنك حذف مشروعك على Google Cloud لإيقاف الفوترة لجميع الموارد المستخدَمة في هذا المشروع.

  1. في Google Cloud Console، انتقِل إلى صفحة إدارة الموارد:

    الانتقال إلى صفحة "إدارة الموارد"

  2. إذا كان المشروع الذي تخطّط لحذفه مرفقًا بمؤسسة، اختَر قائمة المؤسسة في أعلى الصفحة ووسِّعها.
  3. في قائمة المشاريع، اختَر المشروع الذي تريد حذفه وانقر على حذف.
  4. في مربّع الحوار، اكتب معرّف المشروع وانقر على إيقاف التشغيل لحذف المشروع.

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