البدء

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

الحصول على مفتاح واجهة برمجة التطبيقات وتفعيل 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 للاشتراك في تغييرات إمكانات الخريطة. إنّ استخدام إمكانات الخريطة اختياري، ولا يُنصَح به إلا لأغراض الاختبار وتحديد المشاكل وحلّها، أو لأغراض الرجوع إلى الإعدادات التلقائية في وقت التشغيل.

// 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.
  }
});

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

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