Google 錢包支援符合 ISO/IEC 18013-5 標準的登機證行動文件 (mDoc)。儲存在 Google 錢包中的符合資格登機證,可佈建為 mDoc 憑證 (mso_mdoc),並與使用者的數位身分證件一起出示給依賴方和驗證方 (例如機場安全檢查站)。
登機證 mDoc 會自動從 Google 錢包中的基礎登機證 (FlightClass 和 FlightObject) 衍生。
結構定義 ID
| 屬性 | 值 |
|---|---|
文件類型 (docType) |
com.google.wallet.boardingpass.1 |
| 命名空間 | com.google.wallet.boardingpass.1 |
| 憑證格式 | mso_mdoc (ISO/IEC 18013-5) |
資料元素
登機證 mDoc 中的所有資料元素都位於 com.google.wallet.boardingpass.1 命名空間下。
| 元素 ID | CBOR 類型 | 必填 | 說明 | Passes API 來源 | 範例 |
|---|---|---|---|---|---|
id |
tstr |
是 | 使用者將登機證儲存至 Google 錢包後,Google 產生的專屬 ID。兩位使用者儲存相同的登機證物件,會有不同的 ID。 | 由 Google 錢包在使用者儲存時產生 | "1313e7d5d3a74b5795ffb6c3ad655778" |
passenger_name |
tstr |
是 | 乘客全名 (與登機證上顯示的姓名相同)。 | flightObject.passengerName |
"Jane Doe" |
passenger_name_record |
tstr |
是 | 航空公司預訂確認碼 (PNR)。 | flightObject.reservationInfo.confirmationCode |
"OWDGV9" |
flight_number |
tstr |
是 | IATA 航空公司代碼和航班編號,兩者以空格分隔。 | flightClass.flightHeader.carrier.carrierIataCode + " " + flightClass.flightHeader.flightNumber |
"UA 1585" |
scheduled_departure_time |
tdate (#6.0(tstr)) |
是 | 預定出發時間戳記,格式須符合 RFC 3339。 | flightClass.localScheduledDepartureDateTime |
"2025-03-01T11:21:00-07:00" |
departure_airport_iata |
tstr |
是 | 出發機場的 3 字母 IATA 機場代碼。 | flightClass.origin.airportIataCode |
"SFO" |
arrival_airport_iata |
tstr |
是 | 抵達機場的 3 字母 IATA 機場代碼。 | flightClass.destination.airportIataCode |
"PVR" |
assurance_level |
tstr |
是 | 登機證的來源和驗證層級。請參閱「保障等級」。 | 由 Google 錢包根據票證擷取來源決定 | "ISSUER_VERIFIED" |
保障等級
Google 錢包支援多種管道的登機證 (例如 Google Wallet API、Gmail 匯入、螢幕截圖或相片),因此 assurance_level 元素會向依賴方指出登機證的來源:
| 值 | 說明 |
|---|---|
ISSUER_VERIFIED |
登機證是由通過驗證的航空公司或發卡機構,直接透過 Google Wallet API 核發。 |
SELF_ATTESTED |
登機證並非由航空公司發卡機構直接提供 (例如,根據使用者提供的螢幕截圖建立,或從 Gmail 匯入)。 |
SELF_ATTESTED_VERIFIED |
登機證是從使用者提供的構件 (例如螢幕截圖) 匯入,Google 已透過加密編譯方式,驗證條碼中嵌入的核發機構數位簽章。 |