المحدِّدات

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

توفّر "الخرائط الثلاثية الأبعاد" في 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 لضمان الأداء الأمثل.

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

• إضافة علامة