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 時,會在合理的範圍內避開收費路段,優先顯示不含收費道路的路線。僅適用於 DRIVETWO_WHEELER RouteTravelMode

avoidHighways

boolean

設為 true 時,會盡量避開高速公路,並優先採用不含高速公路的路線。僅適用於 DRIVETWO_WHEELER RouteTravelMode

avoidFerries

boolean

設為 true 時,會避免在合理情況下搭乘渡輪,優先顯示不含渡輪的路線。僅適用於 DRIVETWO_WHEELER RouteTravelMode

avoidIndoor

boolean

設為 true 時,應避免在合理情況下進行室內導航,優先顯示不含室內導航的路線。僅適用於 WALK RouteTravelMode

vehicleInfo

object (VehicleInfo)

指定車輛資訊。

tollPasses[]

enum (TollPass)

封裝收費通行證相關資訊。如有提供收費通行證,API 會嘗試傳回票證價格。如未提供收費通行證,API 會將通行費視為不明,並嘗試傳回現金價格。僅適用於 DRIVETWO_WHEELER RouteTravelMode

avoidTunnels

boolean

設為 true 時,會在合理情況下避免隧道,並優先採用不含隧道的路徑。僅適用於 DRIVETWO_WHEELER RouteTravelModeRoutingPreference 必須設為 TRAFFIC_AWARE_OPTIMAL。v2.computeRouteMatrix 不支援這個欄位。

avoidVignettes[]

string

設為 true 時,可避開特定國家/地區設有穿插的道路,優先採用未涵蓋在支援這項功能的國家/地區設有穿插孔的道路。僅適用於 DRIVETWO_WHEELER RouteTravelModeRoutingPreference 必須設為 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。必須設定讓卡車觸發,但拖車時則為選用選項。如果 RouteTravelModeDRIVE,則 v2.computeRouteMatrix 不支援這個欄位。

totalHeightMm

string (int64 format)

車輛高度,包括任何附加拖車的高度。必須設定成卡車或拖車才能觸發。如果 RouteTravelModeDRIVE,則 v2.computeRouteMatrix 不支援這個欄位。

totalLengthMm

string (int64 format)

車輛長度,包括任何連接的拖車長度。必須設定成卡車或拖車才能觸發。如果 RouteTravelModeDRIVE,則 v2.computeRouteMatrix 不支援這個欄位。

totalWidthMm

string (int64 format)

車輛的寬度,包括任何附加拖車的寬度。必須設定成卡車或拖車才能觸發。如果 RouteTravelModeDRIVE,則 v2.computeRouteMatrix 不支援這個欄位。

totalWeightKg

string (int64 format)

車輛重量,包括任何連接的拖車重量。此結構定義的權重是指實際體重,而不是體重評分。必須設定成卡車或拖車才能觸發。如果 RouteTravelModeDRIVE,則 v2.computeRouteMatrix 不支援這個欄位。

trailerInfo[]

object (TrailerInfo)

每部預告片都包含一個項目。如果提供拖車資訊,RoutingPreference 必須設為 TRAFFIC_AWARE_OPTIMAL。如果 RouteTravelModeDRIVE,則 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 印尼。電子卡片由多家銀行提供,用於支付過路費。所有透過銀行的電子卡片都相同,因此只需要一個列舉值。例如:Bank Mandiri 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 AL (美國)
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS 美國
US_CA_FASTRAK 加拿大、美國
US_CA_FASTRAK_CAV_STICKER 表示駕駛人除了 DMV 核發的「Clean Air Vehicle (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 KS,美國。
US_KS_KTAG KS,美國。
US_KS_NATIONALPASS KS,美國。
US_KS_PREPASS_ELITEPASS KS,美國。
US_LA_GEAUXPASS 美國洛杉磯。
US_LA_TOLL_TAG 美國洛杉磯。
US_MA_EZPASSMA 美國麻薩諸塞州
US_MD_EZPASSMD 美國馬裡蘭州。
US_ME_EZPASSME ME,美國
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 美國明尼蘇達州
US_NC_EZPASSNC 美國北卡羅來納州
US_NC_PEACH_PASS 美國北卡羅來納州
US_NC_QUICK_PASS 美國北卡羅來納州
US_NH_EZPASSNH 美國 NH。
US_NJ_DOWNBEACH_EXPRESS_PASS 美國紐澤西州。
US_NJ_EZPASSNJ 美國紐澤西州。
US_NY_EXPRESSPASS 美國紐約州紐約市
US_NY_EZPASSNY 美國紐約州紐約市
US_OH_EZPASSOH 美國俄亥俄州
US_PA_EZPASSPA PA,美國
US_RI_EZPASSRI 美國羅德島州
US_SC_PALPASS SC (美國)
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 WV,美國。
US_WV_MEMORIAL_BRIDGE_TICKETS WV,美國。
US_WV_MOV_PASS WV、美國
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV,美國。

HOVPreference

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

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

boolean

指定是否允許行經 HOV 專用道路以及分享 HOV 車道的路段。根據預設,系統會優先顯示不含 HOV 專用道路的路線。RoutingPreference 必須設為 TRAFFIC_AWARE_OPTIMAL