深層連結

使用者點選微型移動工具路線的搜尋結果時，Google 行動版地圖 (GMM) 會使用一般單車共享動態饋給規格 (GBFS) 動態饋給提供的所選車輛深層連結或 Android「意圖」。

為提供流暢的使用者體驗，本指南將說明深層連結的使用者體驗，並提供合作夥伴相關指引，說明如何設定深層連結格式和準備備用深層連結。

使用者搜尋路線時，即會開始體驗共享單車路線功能，直到在合作夥伴應用程式中解鎖單車為止。這段體驗的摘要如下：

  1. 在 GMM 中，使用者選取微型移動裝置路線：
    1. 使用者選擇出發地和目的地。
    2. 使用者選取微型移動工具做為交通方式。
    3. 使用者選擇要使用的車輛，或使用停靠式車輛時選擇車站。

  2. 使用者在合作夥伴應用程式中解鎖車輛：

    1. 使用者點選 Google 地圖行動版中的按鈕，開啟合作夥伴應用程式。系統會呼叫與動態消息中車輛或車站相關聯的深層連結。如果未提供相關聯的深層連結，系統會改為呼叫「準備備用深層連結」中提供的備用連結。

      1. 安裝合作夥伴應用程式時：深層連結會直接將使用者導向合作夥伴應用程式的預訂頁面，不會重新導向或顯示中介到達網頁。

      2. 如果未安裝合作夥伴應用程式：深層連結會將使用者直接帶往合作夥伴應用程式的安裝頁面，不會重新導向或帶往中介到達網頁。

    2. 合作夥伴應用程式會開啟並載入「車站/自行車畫面」，讓使用者解鎖車輛。

      1. 使用者會看到合作夥伴想顯示的額外資訊，例如停車地點、安全提示和如何解鎖車輛。
      2. 使用者可以解鎖車輛。

  3. 導航

    1. 如要開始行程，使用者必須返回 Google 地圖，然後啟動導航模式。

為了在 Google 地圖、合作夥伴應用程式和合作夥伴應用程式安裝頁面之間提供流暢體驗，且不需額外重新導向，合作夥伴指定動態饋給中提供的深層連結時，必須導入 iOS 通用連結和 Android 應用程式連結。

合作夥伴建構深層連結時，可嵌入任何有助於識別車輛或充電站的資訊，並直接將使用者導向預訂頁面，無須重新導向或使用中繼到達網頁。

合作夥伴可以選擇不使用 bike_id 或 station_id。 此外，您也可以新增追蹤代碼等其他資訊。

以下是深層連結範例：

https://www.example.com/app?event_tag=93581&vid=4917538

Google 一律會在深層連結中附加 client_id 參數，並將值設為 GOOGLE_MAPS，協助合作夥伴判斷深層連結是由 Google 地圖觸發。系統會移除所有現有的 client_id。

以下是新增 client_id 的深層連結範例：

https://www.example.com/app?event_tag=93581&vid=4917538&client_id=GOOGLE_MAPS

合作夥伴也必須為 iOS 和 Android 產生普遍適用的深層連結，不限於個別車輛或停靠站。如果動態饋給未提供所選車輛或停靠站的深層連結，系統會使用這些連結做為備用機制。

合作夥伴產生備用深層連結後，必須在前置實作階段將備用深層連結提供給 Google。