المحدِّدات

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

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

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

• إضافة علامة