算繪類型 (光柵和向量)

Maps JavaScript API 提供兩種地圖導入方式:光柵與向量。系統會預設載入光柵地圖,並將地圖載入為以像素為基礎的光柵圖像圖塊的格狀圖,這些圖塊是由 Google 地圖平台伺服器端產生,然後提供給您的網頁應用程式。向量地圖是由向量圖塊組成,這些圖塊會在載入期間使用 WebGL 在用戶端繪製,WebGL 是一種網路技術,可讓瀏覽器存取使用者裝置上的 GPU,以算繪 2D 和 3D 圖形。建議使用向量地圖類型,以提供最佳使用者體驗,因為這類地圖可提供更佳的視覺保真度,以及控制地圖傾斜和標頭的能力。進一步瞭解向量地圖功能

您可以指定 renderingType 地圖選項,或在相關聯的地圖 ID 上設定選項,藉此設定地圖的算繪類型。renderingType 選項會覆寫透過設定地圖 ID 所做的任何轉譯類型設定。

指定 renderingType 選項

使用 renderingType 選項指定地圖的光柵或向量算繪類型 (不需要地圖 ID)。如果是使用 div 元素和 JavaScript 載入的地圖,預設算繪類型為 google.maps.RenderingType.RASTER。請按照下列步驟設定 renderingType 選項:

  1. 載入 RenderingType 程式庫;您可以在載入地圖程式庫時執行此操作:

    const { Map, RenderingType } = await google.maps.importLibrary("maps");
    
  2. 初始化地圖時,請使用 renderingType 選項指定 RenderingType.VECTORRenderingType.RASTER

    map = new Map(
      document.getElementById('map'),
      {
        zoom: 4,
        center: position,
        renderingType: RenderingType.VECTOR,
      }
    );
    

設定向量地圖算繪類型後,您必須為所需的功能設定選項。

  • 如要啟用傾斜功能,請將 tiltInteractionEnabled 地圖選項設為 true,或呼叫 map.setTiltInteractionEnabled(true)
  • 如要啟用平移功能,請將 headingInteractionEnabled 地圖選項設為 true,或呼叫 map.setHeadingInteractionEnabled(true)

如果是使用 <gmp-map> 元素載入的地圖,預設算繪類型為 google.maps.RenderingType.VECTOR,並啟用傾斜和方向控制項。如要使用 <gmp-map> 元素設定算繪類型,請使用 rendering-type 屬性。

使用地圖 ID 設定算繪類型

您也可以使用地圖 ID 指定算繪類型。如要建立新的地圖 ID,請按照「使用雲端式地圖樣式設定 - 取得地圖 ID」一文中的步驟操作。請務必將地圖類型設為「JavaScript」,然後選取「向量」或「光柵」選項。勾選「傾斜」和「旋轉」,即可啟用地圖的傾斜和旋轉功能。這樣一來,您就能透過程式輔助方式調整這些值,而使用者也能直接在地圖上調整傾斜和方向設定。要是使用傾斜或方向會對應用程式造成負面影響,請勿勾選「傾斜」和「旋轉」,這樣就能避免使用者調整這兩項設定。

建立向量地圖 ID

接著,請使用您建立的地圖 ID 更新地圖初始化程式碼。您可以在「地圖管理」頁面中找到地圖 ID。將地圖執行個體化時,請使用 mapId 屬性提供地圖 ID,如下所示:

map = new google.maps.Map(document.getElementById('map'), {
  center: {lat: -34.397, lng: 150.644},
  zoom: 8,
  mapId: 'MAP_ID'
});