نظرة عامة على Maps embed API

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

ملاحظة: نحصل على صور "التجوّل الافتراضي" من مصدرَين: Google (صور غير علنية يتحكّم بها المطوّرون) والجمهور (محتوى من إنشاء المستخدمين، أو محتوى علني من إنشاء المستخدمين). يُرجى العِلم أنّه لا يمكن استخدام مصدر واحد فقط لصور "التجوّل الافتراضي" دون المصدر الآخر. مزيد من المعلومات حول سياسة الخصوصية المتعلّقة بصور " التجوّل الافتراضي".

يمكنك ضبط عنوان URL الخاص بـ Maps Embed API كسمة src لإطار iframe. عند ضبط سمة src، يمكن أن تتضمّن المَعلمة المطلوبة q اسم مكان أو عنوانًا أو رمز Plus Codes أو رقم تعريف مكان، مع مراعاة تنسيق عنوان URL:

<iframe
  width="600"
  height="450"
  style="border:0"
  loading="lazy"
  allowfullscreen
  referrerpolicy="no-referrer-when-downgrade"
  src="https://www.google.com/maps/embed/v1/place?key=API_KEY
    &q=Space+Needle,Seattle+WA">
</iframe>

ملاحظة: تتوفّر جميع طلبات Maps Embed API بدون أي تكلفة وبعدد غير محدود من الاستخدامات. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الاستخدام والفوترة.

الخطوات الأولى

• استخدِم أداة إنشاء تلقائية لإطارات iframe لتضمين خريطة في صفحة الويب:

  الانتقال إلى دليل البدء السريع

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

  الإعداد في Cloud Console

• للاطّلاع على فهرس بجميع المَعلمات المحتمَلة لطلب بيانات من واجهة برمجة التطبيقات Maps Embed API، يُرجى الاطّلاع على دليل تضمين خريطة:

  الانتقال إلى دليل تضمين خريطة