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

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

التكاليف

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

قبل البدء

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

الخطوة 1

وحدة التحكّم

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

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

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

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

SDK للسحاب

gcloud projects create "PROJECT"

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

الخطوة 2

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

وحدة التحكّم

تفعيل واجهة برمجة التطبيقات لميزة "تضمين الخرائط"

SDK للسحاب

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

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

الخطوة 3

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

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

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

وحدة التحكّم

  1. انتقل إلى Google Maps Platform > بيانات الاعتماد.

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

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

SDK للسحاب

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

يمكنك قراءة المزيد عن حزمة تطوير البرامج (SDK) في Google Cloud , تثبيت 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 في متصفح ويب عن طريق سحبه من سطح المكتب إلى متصفحك؛ أو بدلاً من ذلك، فإن النقر نقرًا مزدوجًا على الملف يعمل على وأنظمة التشغيل.

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

تنظيف

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

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

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

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

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