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

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

التكاليف

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

قبل البدء

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

الخطوة 1: إعداد مشروعك

وحدة التحكّم

  1. في وحدة تحكّم Google Cloud، ضمن صفحة اختيار المشروع، انقر على إنشاء مشروع لبدء إنشاء مشروع جديد على السحابة الإلكترونية.

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

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

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

SDK للسحاب

gcloud projects create "PROJECT"

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

الخطوة 2: تفعيل واجهات برمجة التطبيقات أو حِزم تطوير البرامج (SDK)

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

وحدة التحكّم

تفعيل Maps Embed API

SDK للسحاب

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

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

الخطوة 3: الحصول على مفتاح واجهة برمجة التطبيقات

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

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

وحدة التحكّم

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

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

  2. اختَر مشروعك إذا طُلب منك ذلك.

  3. نفّذ أيًا مما يلي:

    • إنشاء مفتاح جديد:

      1. انقر على إنشاء بيانات الاعتماد > مفتاح واجهة برمجة التطبيقات.
      2. في لوحة إنشاء مفتاح واجهة برمجة التطبيقات، افتح قائمة اختيار قيود واجهة برمجة التطبيقات.
      3. أزِل أي واجهات برمجة تطبيقات لا يحتاجها هذا المفتاح، وتأكَّد من بقاء Maps Embed API محدَّدة.
      4. انقر على إنشاء. تعرض اللوحة مفتاح واجهة برمجة التطبيقات الجديد.

    • استخدام مفتاح حالي:

      1. انقر على اسم المفتاح.
      2. في قائمة اختيار قيود واجهة برمجة التطبيقات، اختَر Maps Embed API.
      3. انقر على حفظ.

    لا يؤدي اختيار واجهة برمجة تطبيقات هنا إلى تفعيلها. تأكَّد من تفعيل Maps Embed API في صفحة "مكتبة واجهة برمجة التطبيقات".

  4. للاطّلاع على سلسلة المفاتيح لاحقًا، انتقِل إلى صفحة المفاتيح وبيانات الاعتماد وانقر على عرض المفتاح للمفتاح المطلوب.

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

SDK للسحاب

استبدِل PROJECT_ID برقم تعريف مشروعك في الأوامر التالية.

  • إنشاء مفتاح جديد: نفِّذ الأمر التالي، واستبدِل DISPLAY_NAME باسم المفتاح. 

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=maps-embed-backend.googleapis.com

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

  • استخدام مفتاح حالي: نفِّذ الأمر التالي، واستبدِل KEY_ID بمعرّف المفتاح. تحتفظ العلامة --append بواجهات برمجة التطبيقات التي يسمح بها المفتاح حاليًا. وبدونها، يستبدلها الأمر.

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=maps-embed-backend.googleapis.com

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

    معرّف المفتاح ليس سلسلة المفتاح أو اسم العرض. للعثور عليه، شغِّل gcloud services api-keys list --project="PROJECT_ID". رقم التعريف هو الجزء الأخير من حقل name: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

للاطّلاع على سلسلة المفاتيح، شغِّل gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID".

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

تهانينا! لقد أعددت للتو خريطة وأنشأتها باستخدام Maps Embed API.

جارٍ حذف البيانات

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

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

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

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

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

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

    الإعداد في Cloud Console

  • للاطّلاع على قائمة بالمَعلمات والخيارات الإضافية التي يمكنك إضافتها في iframe:

    تضمين خريطة

  • يمكنك توسيع نطاق مشروعك على "خرائط Google" باستخدام Maps JavaScript API:

    Maps JavaScript API