İşaretçiler

Kullanıcının dikkatini haritadaki bir konuma çekmek için işaretçileri kullanın. Bu kılavuzda, 3D haritalarda işaretçilerin nasıl kullanılacağı ve özelleştirileceği gösterilmektedir. İşaretçilerin şeklini, boyutunu ve rengini, ayrıca göründükleri yüksekliği kontrol edebilirsiniz. Aşağıdaki örnekte temel bir işaretçi gösterilmektedir:

Maps JavaScript'teki 3D Haritalar, her biri belirli kullanımlar için optimize edilmiş iki farklı işaretçi sınıfı sağlar. Aşağıdaki tabloda, kullanılabilen iki sınıf arasındaki farklılıklar ve denge unsurları gösterilmektedir:

Kapasite MarkerElement Marker3DElement
Özelleştirme Yüksek (Özel HTML öğelerini, temel animasyon API'lerini vb. destekler.) Düşük (Daha az özelleştirilebilir)
Performans Daha düşük etkileşim performansı (çok sayıda işaretçiyle FPS düşüşleri) Daha yüksek etkileşim performansı (Büyük veri kümelerini oluşturmak için optimize edilmiştir)
Önerilen kapasite Yaklaşık 1.000 işaretçiye kadar güvenilir etkileşim performansı 1.000'den fazla işaretçiyi işlemek için önerilir

Rengi, ölçeği ve simge resmini özelleştirme

Varsayılan işaretçinin arka planını, glifini, kenarlık rengini ve boyutunu özelleştirin.

Özel işaretçiler

Varsayılan işaretçi simgesini özel bir SVG kaynağıyla değiştirin.

Grafikli işaretçiler

İşaretçi rakımını ayarlama

İşaretçiyi ekstrüde ederek ve yüksekliği ayarlayarak işaretçi yüksekliğini belirleyebilirsiniz.

Ekstrüde işaretçi

İşaretçilerin tıklama ve klavye etkinliklerine yanıt vermesini sağlama

Bir click etkinlik dinleyicisi ekleyerek işaretçinin tıklamalara ve klavye etkinliklerine yanıt vermesini sağlayın.

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

İşaretçi çakışma davranışını ayarlama

Bir işaretçinin başka bir işaretçi veya harita etiketiyle çakıştığında nasıl davranması gerektiğini belirtin.

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

İşaretçi performansı

Özel HTML işaretçiler (MarkerElement), standart 3D işaretçilere (Marker3DElement) kıyasla daha düşük performans sunar. 1.000'den fazla işaretçi içeren uygulamalarda optimum performans için Marker3dElement sınıfının kullanılması önemle tavsiye edilir.

Sonraki adım