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

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

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

يمكنك ضبط عنوان URL لواجهة برمجة التطبيقات Maps Embed API كسمة src لإطار iframe. عند ضبط السمة src، يمكن أن تتيح المَعلمة q المطلوبة استخدام اسم مكان أو عنوان أو رمز Plus Code أو رقم تعريف مكان تم إلغاء ترميزه في عنوان URL:

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

قد لا تكون العيّنات متاحة في منطقتك.

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

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

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

  الانتقال إلى Quickstart

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

  الإعداد في Cloud Console

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

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