RouteModifiers

封裝一組選用條件,在計算路線時必須滿足這些條件。

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

boolean

如果設為 true,系統會盡可能避開收費路段,優先選擇不含收費路段的路線。僅適用於DRIVE和TWO_WHEELERRouteTravelMode。

avoidHighways

boolean

如果設為 true,系統會盡可能避開高速公路,優先選擇不含高速公路的路線。僅適用於DRIVE和TWO_WHEELERRouteTravelMode。

avoidFerries

boolean

如果設為 true,系統會盡可能避開渡輪,優先選擇不含渡輪的路線。僅適用於DRIVE和TWO_WHEELERRouteTravelMode。

avoidIndoor

boolean

如果設為 true,系統會盡可能避免室內導航,優先選擇不含室內導航的路徑。僅適用於WALKRouteTravelMode。

vehicleInfo

object (VehicleInfo)

指定車輛資訊。

tollPasses[]

enum (TollPass)

封裝收費通行卡的相關資訊。如果提供收費通行卡,API 會嘗試傳回通行卡價格。如果未提供收費通行卡,API 會將收費通行卡視為未知,並嘗試傳回現金價格。僅適用於DRIVE和TWO_WHEELERRouteTravelMode。

avoidTunnels

boolean

(選用步驟) 如果設為 true,系統會盡可能避開隧道,優先選擇不含隧道的路線。僅適用於DRIVE和TWO_WHEELERRouteTravelMode。RoutingPreference 必須設為 TRAFFIC_AWARE_OPTIMAL。v2.computeRouteMatrix 不支援這個欄位。

VehicleInfo

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

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

enum (VehicleEmissionType)

說明車輛的排放類型。僅適用於DRIVERouteTravelMode。

totalAxleCount

integer

車軸總數。如已設定,則必須介於 2 到 11 之間 (含 2 和 11)。如要觸發卡車運輸,則必須設定這項屬性,但拖車運輸則可選擇是否設定。如果 routingPreference 為 TRAFFIC_AWARE_OPTIMAL,將這個欄位設為 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)

每個預告片都包含一個項目。最多只能有 4 部預告片。如果提供預告片資訊,RoutingPreference 必須設為 TRAFFIC_AWARE_OPTIMAL。提供 trailerInfo 後,路線時間長度會以卡車速度 (時間較長) 計算,而非客車速度。如果 RouteTravelMode 為 DRIVE,則 v2.computeRouteMatrix 不支援這個欄位。

hazardousGoodsTypes[]

enum (HazardousGoodsType)

車輛運送的危險物品清單 (如有)。

VehicleEmissionType

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

列舉
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)

拖車重量。此處的重量是指實際重量,而非重量等級。

HazardousGoodsType

不同類型的危險物質。

列舉
HAZARDOUS_GOODS_TYPE_UNSPECIFIED 未指定危險物品類型。
EXPLOSIVES 爆裂物。
GASES 氣體。
FLAMMABLE 易燃物品。
COMBUSTIBLE 可燃物品。
ORGANIC 有機產品。
POISON 有毒物品。
RADIOACTIVE 放射性商品。
CORROSIVE 腐蝕性物品。
ASPIRATION_HAZARD 吸入性危害物質。
ENVIRONMENTAL_HAZARD 環境有害物質。
OTHER 其他類型的商品。

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 日本 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 CA, USA.
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 DE, USA.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL, USA.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL, USA.
US_FL_EPASS FL, USA.
US_FL_GIBA_TOLL_PASS FL, USA.
US_FL_LEEWAY FL, USA.
US_FL_SUNPASS FL, USA.
US_FL_SUNPASS_PRO FL, USA.
US_IL_EZPASSIL IL, USA.
US_IL_IPASS 美國伊利諾州。
US_IN_EZPASSIN IN, USA.
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_BREAKAWAY 美國密西根州。
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, USA.
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 WV, USA
US_WV_NEWELL_TOLL_BRIDGE_TICKET 美國西維吉尼亞州。