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

ضع خريطة تفاعلية أو بانوراما للتجوّل الافتراضي على صفحة الويب الخاصة بك عن طريق طلب HTTP - لا يلزم وجود JavaScript.

التكاليف

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

قبل البدء

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

الخطوة 1

وحدة التحكّم

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

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

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

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

SDK للسحاب

gcloud projects create "PROJECT"

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

الخطوة 2

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

وحدة التحكّم

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

SDK للسحاب

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

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

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