自訂標記

選取平台： Android iOS JavaScript

自訂地圖中加入的標記外觀與風格。您可以透過兩種方式自訂地圖中新增的標記外觀和風格：

1. 依類型設定標記樣式：指定 MarkerOptions 物件，以設定同類型標記的樣式。您指定的變更會在每個標記建立後套用，並覆寫任何預設選項。如需範例，請參閱本指南的「使用 MarkerOptions 變更標記樣式」一節。

2. 根據資料設定標記樣式：指定自訂函式，以便根據資料設定標記樣式。您可以根據旅程分享或外部來源的資料設定樣式：

   • 行程分享資料：行程分享會將標記資料傳遞至自訂化函式，包括標記代表的物件類型：車輛、起點、路線點或目的地。標記樣式會根據標記元素的目前狀態而變更。例如，車輛完成行程前剩餘的路線點數量。

   • 外部來源：您可以將行程分享資料與 Fleet Engine 外部來源的資料相結合，也可以根據該資訊設定標記樣式。

   如需相關範例，請參閱本指南中的「使用自訂函式變更標記樣式」一節。

3. 為標記新增點擊處理機制：如需範例，請參閱「新增點擊處理機制」。

標記自訂選項

兩種選項都會在 FleetEngineTripLocationProviderOptions 下，使用 Google Maps JavaScript API 中的下列自訂參數：

• vehicleMarkerCustomization
• originMarkerCustomization
• waypointMarkerCustomization
• destinationMarkerCustomization

使用 MarkerOptions 變更標記的樣式

以下範例說明如何使用 MarkerOptions 物件設定車輛標記樣式。您可以按照這個模式，使用「標記自訂選項」中列出的任何標記自訂項目，自訂任何標記的樣式。

JavaScript

deliveryVehicleMarkerCustomization = {
  cursor: 'grab'
};

TypeScript

deliveryVehicleMarkerCustomization = {
  cursor: 'grab'
};

使用自訂函式變更標記的樣式

以下範例說明如何使用自訂函式設定車輛標記樣式。您可以按照這個模式，使用「標記自訂選項」中列出的任何標記自訂參數，自訂任何標記的樣式。

JavaScript

vehicleMarkerCustomization =
  (params) => {
    var distance = params.trip.remainingWaypoints.length;
    params.marker.setLabel(`${distance}`);
  };

TypeScript

vehicleMarkerCustomization =
  (params: TripMarkerCustomizationFunctionParams) => {
    const distance = params.trip.remainingWaypoints.length;
    params.marker.setLabel(`${distance}`);
};

在標記中加入點擊處理方式

以下範例說明如何為車輛標記新增點擊處理。請按照這個模式，使用標記自訂選項中列出的任何標記自訂參數，為任何標記新增點擊處理功能。

JavaScript

vehicleMarkerCustomization =
  (params) => {
    if (params.isNew) {
      params.marker.addListener('click', () => {
        // Perform desired action.
      });
    }
  };

TypeScript

vehicleMarkerCustomization =
  (params: TripMarkerCustomizationFunctionParams) => {
    if (params.isNew) {
      params.marker.addListener('click', () => {
        // Perform desired action.
      });
    }
  };

後續步驟

• 自訂路線折線