التشغيل السريع لـ Maps Include API

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

التكاليف

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

قبل البدء

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

الخطوة 1

وحدة التحكّم

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

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

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

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

Cloud SDK

gcloud projects create "PROJECT"

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

الخطوة 2

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

وحدة التحكّم

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

Cloud SDK

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

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

الخطوة 3

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

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

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

وحدة التحكّم

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

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

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

Cloud SDK

gcloud alpha 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 في متصفح الويب عن طريق سحبه من سطح المكتب إلى المتصفح، أو عمل النقر المزدوج على الملف مع معظم أنظمة التشغيل.

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

التنظيف

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

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

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

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

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