標記

您可以使用標記，吸引使用者注意地圖上的某個位置。本指南說明如何在 3D 地圖中使用及自訂標記。您可以控管標記的形狀、大小和顏色，以及顯示高度。以下範例顯示基本標記：

Maps JavaScript 的 3D 地圖提供兩種標記類別，分別針對特定用途進行最佳化。下表列出兩種可用類別的差異和優缺點：

功能	MarkerElement	Marker3DElement
自訂	高 (支援自訂 HTML 元素、核心動畫 API 等)	低 (可自訂程度較低)
效能	互動效能較低 (標記數量過多時，每秒影格數會下降)	互動效能較高 (已針對大型資料集算繪作業進行最佳化)
建議容量	最多可與約 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) 的效能低於標準 3D 標記 (Marker3DElement)。如果應用程式有超過 1,000 個標記，強烈建議使用 Marker3dElement 類別，確保效能最佳。

下一步

• 新增標記