البدء

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

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

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

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

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

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

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

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

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

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

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

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

إنشاء علامة متقدّمة تلقائية