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

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

التكاليف

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

قبل البدء

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

الخطوة 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 التي تخطّط لاستخدامها مع مشروعك.

وحدة التحكّم

تفعيل Maps Embed API

SDK للسحاب

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

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

الخطوة 3

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

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

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

وحدة التحكّم

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

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

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

SDK للسحاب

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

يمكنك الاطّلاع على مزيد من المعلومات حول Google Cloud SDK و تثبيت 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 Embed API.

تنظيف

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

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

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

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

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

  • ابدأ التطوير باستخدام Maps Embed API من خلال إعداد مشروعك على Google Cloud باتّباع الخطوات التالية:

    الإعداد في Cloud Console

  • للاطّلاع على قائمة بالخيارات والمعلَمات الإضافية التي يمكنك إضافتها في إطار iframe:

    تضمين خريطة

  • توسيع نطاق مشروعك على "خرائط Google" باستخدام Javascript API:

    Maps Javascript API