新增大眾運輸票證的連結

新增大眾運輸票證連結的方式有四種。

  • 使用 TransitClass.LinksModuleData 新增與 TransitClass 相關聯的所有大眾運輸票證的連結。
  • 使用 TransitObject.LinksModuleData 新增特定大眾運輸票證 TransitObject 的連結。
  • 使用 TransitObject.appLinkData 將應用程式連結放在特定票證的底部。
  • 使用 TransitClass.appLinkData 將應用程式連結放在該類別的所有傳送作業底部。

應用程式連結的一項優點是,可讓行動號召將使用者導向 Google 錢包中的品牌體驗。含有這項功能的連結會顯示在票證底部。

功能範例

發證機構名稱 Applink 資料範例
核發單位

針對特定大眾運輸票證,請將 TransitObject.appLinkData 欄位設為應用程式或網站的 URI 或套件名稱。

請參考下列原始碼中 appLinkData 欄位的格式和結構定義:displayText 欄位的字元數上限為 30 個半形字元。

  {
    "id": string,
    "classId": string,
    …
    …
    …
    "appLinkData": {
      "androidAppLinkInfo": {
        "appTarget": {
          "packageName": "com.google.android.gm",
        }
      },
      "webAppLinkInfo": {
        "appTarget": {
           "targetUri": {
              "uri": "https://mail.google.com/mail/",
              "description": "Web link for Gmail"
           }
        }
      }
      "displayText": {
        "defaultValue": {
           "value": "Our awesome app!"
        }
      }
    }
  }
為了方便後代使用,以下實作方式也適用。
{
  "id": string,
  "classId": string,
  …
  …
  …
  "appLinkData": {
    "androidAppLinkInfo": {
      "appTarget": {
        "targetUri": {
          "uri": "https://play.google.com/store/apps/details?id=com.google.android.gm",
            "description": "Play store link for Gmail app"
        }
      }
    }
  }
}