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

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

التكاليف

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

قبل البدء

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

الخطوة 1

وحدة التحكّم

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

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

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

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

Cloud SDK

gcloud projects create "PROJECT"

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

الخطوة 2

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

وحدة التحكّم

تفعيل واجهة برمجة التطبيقات لميزة "تضمين الخرائط"

Cloud SDK

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

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

الخطوة 3

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

مفتاح واجهة برمجة التطبيقات هو معرّف فريد يصادق على الطلبات المرتبطة بمشروعك لأغراض الاستخدام والفوترة. يجب أن يكون لديك مفتاح واجهة برمجة تطبيقات واحد على الأقل مرتبط بمشروعك.

لإنشاء مفتاح واجهة برمجة التطبيقات:

وحدة التحكّم

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

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

  2. في صفحة بيانات الاعتماد، انقر على إنشاء بيانات اعتماد > مفتاح واجهة برمجة التطبيقات.
    يعرض مربع الحوار تم إنشاء مفتاح واجهة برمجة التطبيقات مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه حديثًا.
  3. انقر على إغلاق.
    يتم عرض مفتاح واجهة برمجة التطبيقات الجديد في صفحة بيانات الاعتماد ضمن مفاتيح واجهة برمجة التطبيقات.
    (يُرجى الحرص على تقييد مفتاح واجهة برمجة التطبيقات قبل استخدامه في قناة الإصدار العلني).

Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

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

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

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

التنظيف

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

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

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

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

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