RouteModifiers (Automotive)

封裝計算路線時要滿足的一組選用條件。

JSON 表示法 
{
  "avoidTolls": boolean,
  "avoidHighways": boolean,
  "avoidFerries": boolean,
  "avoidIndoor": boolean,
  "vehicleInfo": {
    object (VehicleInfo)
  },
  "tollPasses": [
    enum (TollPass)
  ],
  "avoidTunnels": boolean,
  "avoidVignettes": [
    string
  ],
  "hovPreference": {
    object (HOVPreference)
  }
}
欄位
avoidTolls

boolean

設為 true 時，在合理情況下避開收費道路，讓系統優先選擇不含收費路段的路線。僅適用於 DRIVE 和 TWO_WHEELER RouteTravelMode。
avoidHighways

boolean

設為 true 時，在合理情況下避開高速公路，系統會優先避開不含高速公路的路線。僅適用於 DRIVE 和 TWO_WHEELER RouteTravelMode。
avoidFerries

boolean

設為 true 時，在合理情況下避開渡輪，系統會優先選擇不含渡輪的路線。僅適用於 DRIVE 和TWO_WHEELER RouteTravelMode。
avoidIndoor

boolean

設為 true 時，避免在合理情況下導航到室內，優先選擇不含室內導航的路線。僅適用於 WALK RouteTravelMode。
vehicleInfo

object (VehicleInfo)

指定車輛資訊。
tollPasses[]

enum (TollPass)

封裝過路通行證的相關資訊。如有提供收費通行證，API 會嘗試傳回票證價格。如未提供收費通行證，API 會將收費通行證視為未知，並嘗試傳回現金價格。僅適用於 DRIVE 和 TWO_WHEELER RouteTravelMode。
avoidTunnels

boolean

設為 true 時，在合理情況下避開隧道，讓系統優先選擇不含隧道的路徑。僅適用於 DRIVE 和 TWO_WHEELER RouteTravelMode。「RoutingPreference」必須設為「TRAFFIC_AWARE_OPTIMAL」。v2.computeRouteMatrix 不支援這個欄位。
avoidVignettes[]

string

設為 true 時，在合理的情況下，會避開含有穿插的道路，且會優先避開設有穿插在支援這項功能的國家/地區且沒有穿過穿透的道路。僅適用於 DRIVE 和 TWO_WHEELER RouteTravelMode。「RoutingPreference」必須設為「TRAFFIC_AWARE_OPTIMAL」。必須以 Unicode CLDR 區碼指定國家/地區。支援的國家/地區包括 CH、AT、CZ、HU、SI、SK。v2.computeRouteMatrix 不支援這個欄位。
hovPreference

object (HOVPreference)

指定是否要根據是否有高乘載車輛路線的道路變更路線。v2.computeRouteMatrix 不支援這個欄位。

VehicleInfo

包含車輛資訊，例如車輛排放類型。

JSON 表示法 
{
  "emissionType": enum (VehicleEmissionType),
  "totalAxleCount": integer,
  "totalHeightMm": string,
  "totalLengthMm": string,
  "totalWidthMm": string,
  "totalWeightKg": string,
  "trailerInfo": [
    {
      object (TrailerInfo)
    }
  ]
}
欄位
emissionType

enum (VehicleEmissionType)

說明車輛的排放類型。僅適用於 DRIVE RouteTravelMode。
totalAxleCount

integer

軸總數。如果有設定，必須 >= 2。必須設定「卡車」才會觸發，但於拖車時則為選用選項。當 RouteTravelMode 為 DRIVE 時，v2.computeRouteMatrix 不支援這個欄位。
totalHeightMm

string (int64 format)

車輛高度，包括所有隨附拖車的高度。必須設定成「卡車」或「拖車」才能觸發。當 RouteTravelMode 為 DRIVE 時，v2.computeRouteMatrix 不支援這個欄位。
totalLengthMm

string (int64 format)

車輛長度，包括任何隨附拖車的長度。必須設定成「卡車」或「拖車」才能觸發。當 RouteTravelMode 為 DRIVE 時，v2.computeRouteMatrix 不支援這個欄位。
totalWidthMm

string (int64 format)

車輛寬度，包括任何隨附拖車的寬度。必須設定成「卡車」或「拖車」才能觸發。當 RouteTravelMode 為 DRIVE 時，v2.computeRouteMatrix 不支援這個欄位。
totalWeightKg

string (int64 format)

車輛重量，包括所有隨附拖車的重量。在此背景中的體重是指實際體重，而非體重評分。必須設定成「卡車」或「拖車」才能觸發。當 RouteTravelMode 為 DRIVE 時，v2.computeRouteMatrix 不支援這個欄位。
trailerInfo[]

object (TrailerInfo)

每部預告片包含一個項目。如有提供拖車資訊，則 RoutingPreference 必須設為 TRAFFIC_AWARE_OPTIMAL。當 RouteTravelMode 為 DRIVE 時，v2.computeRouteMatrix 不支援這個欄位。

VehicleEmissionType

一組說明車輛排放類型的值。僅適用於 DRIVE RouteTravelMode。

列舉
VEHICLE_EMISSION_TYPE_UNSPECIFIED 未指定排放類型，預設值為 GASOLINE。
GASOLINE 汽油/汽油動力車輛。
ELECTRIC 電動車。
HYBRID 油電混合車 (例如汽油 + 電動車)。
DIESEL 柴油車輛。

TrailerInfo

與車輛連接的個別拖車相關資訊。貨運車輛需提供長度較長的拖車長度。其他屬性為選用屬性。總屬性必須涵蓋所有拖車的屬性。例如，totalHeightMm 必須大於或等於 trailerInfo.height_mm。

JSON 表示法 
{
  "heightMm": string,
  "lengthMm": string,
  "widthMm": string,
  "weightKg": string
}
欄位
heightMm

string (int64 format)

拖車的高度。
lengthMm

string (int64 format)

預告片的長度。
widthMm

string (int64 format)

拖車寬度。
weightKg

string (int64 format)

拖車重量。在此背景中的體重是指實際體重，而非體重評分。

TollPass

我們支援的全球收費通行證清單。

列舉
TOLL_PASS_UNSPECIFIED 未使用。如果使用這個值，要求就會失敗。
AU_ETOLL_TAG 雪梨通行費詳情請參閱 https://www.myetoll.com.au。
AU_EWAY_TAG 雪梨通行費詳情請參閱 https://www.tollpay.com.au。
AU_LINKT 澳洲通行費詳情請參閱 https://www.linkt.com.au/。
AR_TELEPASE 阿根廷收費通行證詳情請參閱 https://telepase.com.ar
BR_AUTO_EXPRESO 巴西通行費詳情請參閱 https://www.autoexpreso.com
BR_CONECTCAR 巴西通行費詳情請參閱 https://conectcar.com。
BR_MOVE_MAIS 巴西通行費詳情請參閱 https://movemais.com。
BR_PASSA_RAPIDO 巴西通行費詳情請參閱 https://pasorapido.gob.do/
BR_SEM_PARAR 巴西通行費詳情請參閱 https://www.semparar.com.br。
BR_TAGGY 巴西通行費詳情請參閱 https://taggy.com.br。
BR_VELOE 巴西通行費詳情請參閱 https://veloe.com.br/site/onde-usar。
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD 加拿大通往美國的邊界。
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD 加拿大通往美國的邊界。
CA_US_BLUE_WATER_EDGE_PASS 美國安大略省與美國密西根州之間的邊界交界。
CA_US_CONNEXION 美國安大略省與美國密西根州之間的邊界交界。
CA_US_NEXUS_CARD 加拿大通往美國的邊界。
ID_E_TOLL 印尼。多家銀行提供的電子卡 (用於支付收費路段)。所有透過銀行的電子卡費用都相同，因此您只需要一個列舉值。例如：曼迪利銀行 https://www.bankmandiri.co.id/e-money - BCA https://www.bca.co.id/flazz - BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG India.
IN_LOCAL_HP_PLATE_EXEMPT 印度，HP 州級車牌豁免。
JP_ETC 日本 ETC。用來收集收費站的電子無線系統。https://www.go-etc.jp/
JP_ETC2 Japan ETC2.0。新版 ETC，為車輛上的車輛裝置和天線提供進一步的折扣，同時提供雙向通訊功能。https://www.go-etc.jp/etc2/index.html
MX_IAVE 墨西哥通行費。https://iave.capufe.gob.mx/#/
MX_PASE 墨西哥 https://www.pase.com.mx
MX_QUICKPASS 墨西哥 https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE 墨西哥
MX_TAG_TELEVIA 墨西哥收費通行證公司。其中一個在墨西哥市營運。詳情請參閱 https://www.televia.com.mx。
MX_TELEVIA 墨西哥收費通行證公司。其中一個在墨西哥市營運。https://www.televia.com.mx
MX_VIAPASS 墨西哥通行費。詳情請參閱 https://www.viapass.com.mx/viapass/web_home.aspx。
US_AL_FREEDOM_PASS 美國阿拉巴馬州
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS 美國阿拉斯，
US_CA_FASTRAK 加拿大、美國
US_CA_FASTRAK_CAV_STICKER 表示駕駛人除了 DMV 發行的乾淨空氣 (CAV) 貼紙外，還持有 FasTrak 貼紙。https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL 美國科羅拉多州
US_CO_GO_PASS 美國科羅拉多州
US_DE_EZPASSDE 美國德國。
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS 美國佛羅裡達州
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD 美國佛羅裡達州
US_FL_EPASS 美國佛羅裡達州
US_FL_GIBA_TOLL_PASS 美國佛羅裡達州
US_FL_LEEWAY 美國佛羅裡達州
US_FL_SUNPASS 美國佛羅裡達州
US_FL_SUNPASS_PRO 美國佛羅裡達州
US_IL_EZPASSIL 美國伊利諾州
US_IL_IPASS 美國伊利諾州
US_IN_EZPASSIN 美國印度
US_KS_BESTPASS_HORIZON 美國堪薩斯州。
US_KS_KTAG 美國堪薩斯州。
US_KS_NATIONALPASS 美國堪薩斯州。
US_KS_PREPASS_ELITEPASS 美國堪薩斯州。
US_LA_GEAUXPASS 美國洛杉磯
US_LA_TOLL_TAG 美國洛杉磯
US_MA_EZPASSMA 美國麻薩諸塞州
US_MD_EZPASSMD 美國馬裡蘭州
US_ME_EZPASSME 美國緬因州
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD 美國密西根州
US_MI_BCPASS 美國密西根州
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG 美國密西根州
US_MI_IQ_PROX_CARD

美國密西根州這個票證類型已不存在，因此已淘汰。
US_MI_IQ_TAG 美國密西根州
US_MI_MACKINAC_BRIDGE_MAC_PASS 美國密西根州
US_MI_NEXPRESS_TOLL 美國密西根州
US_MN_EZPASSMN MN、美國。
US_NC_EZPASSNC 美國北卡羅來納州
US_NC_PEACH_PASS 美國北卡羅來納州
US_NC_QUICK_PASS 美國北卡羅來納州
US_NH_EZPASSNH 美國新罕布夏，
US_NJ_DOWNBEACH_EXPRESS_PASS 美國紐澤西州。
US_NJ_EZPASSNJ 美國紐澤西州。
US_NY_EXPRESSPASS 美國紐約
US_NY_EZPASSNY 美國紐約
US_OH_EZPASSOH 美國俄亥俄州。
US_PA_EZPASSPA 美國賓州
US_RI_EZPASSRI 美國羅裡，
US_SC_PALPASS 美國卡羅來納
US_TX_AVI_TAG 美國德克薩斯州
US_TX_BANCPASS 美國德克薩斯州
US_TX_DEL_RIO_PASS 美國德克薩斯州
US_TX_EFAST_PASS 美國德克薩斯州
US_TX_EAGLE_PASS_EXPRESS_CARD 美國德克薩斯州
US_TX_EPTOLL 美國德克薩斯州
US_TX_EZ_CROSS 美國德克薩斯州
US_TX_EZTAG 美國德克薩斯州
US_TX_FUEGO_TAG 美國德克薩斯州
US_TX_LAREDO_TRADE_TAG 美國德克薩斯州
US_TX_PLUSPASS 美國德克薩斯州
US_TX_TOLLTAG 美國德克薩斯州
US_TX_TXTAG 美國德克薩斯州
US_TX_XPRESS_CARD 美國德克薩斯州
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD 美國猶他州
US_VA_EZPASSVA 美國維吉尼亞州
US_WA_BREEZEBY 美國華盛頓州
US_WA_GOOD_TO_GO 美國華盛頓州
US_WV_EZPASSWV 美國西維吉尼亞州
US_WV_MEMORIAL_BRIDGE_TICKETS 美國西維吉尼亞州
US_WV_MOV_PASS 美國西維吉尼亞州
US_WV_NEWELL_TOLL_BRIDGE_TICKET 美國西維吉尼亞州

HOVPreference

指定是否要根據是否有高乘載車輛 (高乘載車輛) 的道路或車道變更路線。

JSON 表示法 
{
  "allowHov": boolean
}
欄位
allowHov

boolean

指定是否允許在高乘載車輛專用道及共用高乘載車輛道的路段之外轉送車輛。根據預設，系統會優先遵循不含高乘載車輛通行的道路。「RoutingPreference」必須設為「TRAFFIC_AWARE_OPTIMAL」。