المحدِّدات

استخدِم العلامات للفت انتباه المستخدم إلى موقع جغرافي على الخريطة. يوضّح هذا الدليل كيفية استخدام العلامات وتخصيصها في الخرائط الثلاثية الأبعاد. يمكنك التحكّم في شكل العلامات وحجمها ولونها، بالإضافة إلى الارتفاع الذي تظهر عنده. يعرض المثال التالي علامة أساسية:

توفّر "خرائط ثلاثية الأبعاد" في Maps JavaScript فئتَين مختلفتَين من العلامات، تم تحسين كل منهما لاستخدامات محدّدة. يوضّح الجدول التالي الاختلافات والمفاضلات بين الفئتَين المتاحتَين:

إمكانية	MarkerElement	Marker3DElement
التخصيص	عالية (تتوافق مع عناصر HTML المخصّصة وواجهات برمجة التطبيقات الأساسية للرسومات المتحركة وما إلى ذلك)	منخفض (خيارات تخصيص أقل)
الأداء	انخفاض أداء التفاعل (انخفاض عدد اللقطات في الثانية مع عدد كبير من العلامات)	أداء تفاعلي أفضل (تم تحسينه لعرض مجموعات البيانات الكبيرة)
السعة المقترَحة	أداء موثوق للتفاعل مع ما يصل إلى 1,000 علامة تقريبًا	يُنصح باستخدامه للتعامل مع أكثر من 1,000 علامة

تخصيص اللون والمقياس وصورة الرمز

تخصيص خلفية العلامة التلقائية والرمز الرسومي ولون الحدود وحجمها

استبدِل رمز المحدّد التلقائي بمورد SVG مخصّص.

ضبط ارتفاع العلامة

يمكنك ضبط ارتفاع العلامة عن طريق بثق العلامة وتحديد الارتفاع.

جعل العلامات تستجيب للأحداث الناتجة عن النقر ولوحة المفاتيح

اجعل علامة تستجيب للنقرات وأحداث لوحة المفاتيح من خلال إضافة أداة معالجة الأحداث click.

const interactiveMarker = new Marker3DInteractiveElement({
    position,
    gmpPopoverTargetElement: popover,
});
index.js

ضبط سلوك تصادم العلامة

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

const marker = new Marker3DElement({
    position: { lat, lng },
    // Try setting a different collision behavior here.
    collisionBehavior: 'REQUIRED',
});
index.js

أداء العلامة

تقدّم علامات HTML المخصّصة (MarkerElement) أداءً أقل من علامات ثلاثية الأبعاد العادية (Marker3DElement). بالنسبة إلى التطبيقات التي تتضمّن أكثر من 1,000 علامة، يُنصح بشدة باستخدام فئة Marker3dElement لضمان أفضل أداء.

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

• إضافة علامة