المحدِّدات

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

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

إمكانية	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 class لضمان الأداء الأمثل.

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

• إضافة علامة