نظرة عامة على العلامات

اختيار النظام الأساسي: Android‏ iOS‏ JavaScript‏

استخدِم علامات لعرض مواقع جغرافية فردية على خريطة. يوضّح لك هذا الدليل كيفية استخدام العلامات المتقدّمة. باستخدام العلامات المتقدّمة، يمكنك إنشاء علامات عالية الأداء وتخصيصها، وإنشاء علامات يسهل الوصول إليها وتستجيب لأحداث gmp-click وإدخالات لوحة المفاتيح. للحصول على تخصيص أكثر تفصيلاً، تتيح العلامات المتقدّمة استخدام HTML وCSS مخصّصَين، بما في ذلك إمكانية إنشاء علامات مخصّصة بالكامل. بالنسبة إلى التطبيقات الثلاثية الأبعاد، يمكنك التحكّم في الارتفاع الذي يظهر عنده العلامة. تتوفّر العلامات المتقدّمة على كل من خرائط النقاط المتجهة والنقطية (مع أنّ بعض الميزات غير متاحة على خرائط النقاط المتجهة). يجب توفير رقم تعريف خريطة لاستخدام "محدّدات المواقع المتقدّمة" (يمكن استخدام DEMO_MAP_ID).

ملاحظة: إذا كانت خريطتك تستخدم علامات قديمة، ننصحك بالانتقال إلى العلامات المتقدّمة.

بدء استخدام العلامات المتقدّمة

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

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

استبدِل رمز العلامة التلقائي بصورة SVG أو PNG مخصّصة.

إنشاء علامات HTML مخصّصة

استخدِم HTML وCSS مخصّصَين لإنشاء علامات تفاعلية مميّزة بصريًا، وإنشاء صور متحركة.

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

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

function initMap() {
  const map = new google.maps.Map(document.getElementById('map'), {
    center: {lat: 37.4239163, lng: -122.0947209},
    zoom: 17,
    mapId: 'DEMO_MAP_ID',
  });

  const marker = new google.maps.marker.AdvancedMarkerElement({
    map,
    position: {lat: 37.4239163, lng: -122.0947209},
  });

  marker.addEventListener('gmp-click', (event) => {
    // Handle the click event.
    // ...
  });
}

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

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

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

• بدء استخدام العلامات المتقدّمة