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

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

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

يمكنك ضبط عنوان URL لواجهة برمجة التطبيقات Maps Embed API على أنّه سمة src لإطار div مضمّن. عند ضبط موقع src، يمكن أن تتيح المَعلمة المطلوبة q استخدام اسم مكان أو عنوان أو رمز موقع مفتوح أو رقم تعريف مكان تم ترميزه لعنوان 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:

  الإعداد في Cloud Console

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

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