البدء

اختيار النظام الأساسي: Android‏ iOS‏ JavaScript‏

اتّبِع الخطوات التالية لإعداد العلامات المتقدّمة.

الحصول على مفتاح واجهة برمجة تطبيقات وتفعيل Maps JavaScript API

قبل استخدام العلامات المتقدّمة، تحتاج إلى مشروع على السحابة الإلكترونية يحتوي على حساب فوترة، مع تفعيل Maps JavaScript API. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد مشروعك على Google Cloud.

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

إنشاء معرّف خريطة

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

إنشاء معرّف خريطة اتجاهية

تعديل رمز إعداد الخريطة

يتطلّب ذلك رقم تعريف الخريطة الذي أنشأته للتو. ويمكن العثور عليه في صفحة إدارة الخرائط.

  1. تحميل Maps JavaScript API

  2. حمِّل مكتبة العلامات المتقدّمة من داخل دالة async عند الحاجة:

    const { AdvancedMarkerElement } = await google.maps.importLibrary("marker") as google.maps.MarkerLibrary;

  3. قدِّم معرّف خريطة عند إنشاء مثيل للخريطة باستخدام السمة mapId. يمكن أن يكون هذا معرّف خريطة تقدّمه أنت أو DEMO_MAP_ID.

    const map = new
google.maps.Map(document.getElementById('map'), {
  center: {lat: -34.397, lng: 150.644},
  zoom: 8,
  mapId: 'YOUR_MAP_ID'
});

التحقّق من إمكانات الخريطة (اختياري)

تتطلّب "العلامات المتقدّمة" رقم تعريف خريطة. في حال عدم توفّر رقم تعريف الخريطة، لا يمكن تحميل محدّدات المواقع المتقدّمة. كخطوة لتحديد المشاكل وحلّها، يمكنك إضافة مستمع mapcapabilities_changed للاشتراك في تغييرات إمكانات الخريطة. يُعدّ استخدام Map Capabilities اختياريًا، ويُنصح به فقط لأغراض الاختبار وتحديد المشاكل وحلّها، أو لأغراض الاحتياط أثناء التشغيل.

// Optional: subscribe to map capability changes.
map.addListener('mapcapabilities_changed', () => {
  const mapCapabilities = map.getMapCapabilities();

  if (!mapCapabilities.isAdvancedMarkersAvailable) {
    // Advanced markers are *not* available, add a fallback.
  }
});

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

إضافة علامة إلى خريطة