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

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

التكاليف

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

قبل البدء

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

الخطوة 1

وحدة التحكّم

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

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

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

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

SDK للسحاب

gcloud projects create "PROJECT"

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

الخطوة 2

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

وحدة التحكّم

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

SDK للسحاب

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

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

الخطوة 3

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

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

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

وحدة التحكّم

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

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

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

SDK للسحاب

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

يمكنك قراءة المزيد عن حزمة تطوير البرامج (SDK) في Google Cloud , تثبيت 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. في مربّع الحوار، اكتب رقم تعريف المشروع وانقر على إيقاف لحذف المشروع.

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