اتّبِع الخطوات التالية للإعداد باستخدام العلامات المتقدّمة.
الحصول على مفتاح واجهة برمجة التطبيقات وتفعيل Maps JavaScript API
قبل استخدام العلامات المتقدمة، تحتاج إلى وجود سحابة حساب فوترة، وMaps JavaScript API مفعّلة. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد مشروعك على Google Cloud.
الحصول على مفتاح واجهة برمجة التطبيقات
إنشاء معرّف خريطة
لإنشاء معرّف خريطة جديد، اتّبِع الخطوات الواردة في مقالة تخصيص Cloud. اضبط نوع الخريطة على JavaScript، ثم اختَر المتجه أو البطاقة النقطية.
تعديل رمز إعداد الخريطة
يتطلب هذا معرّف الخريطة الذي أنشأته للتو. يمكنك العثور عليها في خرائط Google. إدارة.
حمِّل مكتبة العلامات المتقدّمة من داخل دالة
async
عند الحاجة:const { AdvancedMarkerElement } = await google.maps.importLibrary("marker") as google.maps.MarkerLibrary;
قدِّم معرّف خريطة عند إنشاء مثيل للخريطة باستخدام السمة
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. } });