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

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

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

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

<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 تلقائية لتضمين خريطة في صفحة الويب:

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

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

  الإعداد في Cloud Console

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

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