이 제품 또는 기능은 GA 이전 실험 출시 단계 (GA 이전)에 있습니다. GA 이전 제품과 기능은 지원이 제한될 수 있으며, GA 이전 제품과 기능이 변경된 경우 다른 GA 이전 버전과 호환되지 않을 수 있습니다. GA 이전 버전 제품 및 서비스에는 Google Maps Platform 서비스별 약관이 적용됩니다. 자세한 내용은 출시 단계 설명을 참조하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

RouteModifiers (Automotive)

JSON 표현
VehicleInfo
- JSON 표현
VehicleEmissionType
TrailerInfo
- JSON 표현
TollPass
HOVPreference
- JSON 표현

경로를 계산할 때 충족할 선택적 조건 집합을 캡슐화합니다.

JSON 표현

JSON 표현
{ "avoidTolls": boolean, "avoidHighways": boolean, "avoidFerries": boolean, "avoidIndoor": boolean, "vehicleInfo": { object (`VehicleInfo`) }, "tollPasses": [ enum (`TollPass`) ], "avoidTunnels": boolean, "avoidVignettes": [ string ], "hovPreference": { object (`HOVPreference`) } }

{
  "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`로 설정해야 합니다. 국가는 유니코드 CLDR 지역 코드로 지정해야 합니다. 지원되는 국가는 스위스, 오스트리아, 체코, 헝가리, SI, SK입니다. 이 필드는 v2.computeRouteMatrix에서 지원되지 않습니다.
`hovPreference`	`object (HOVPreference)` 다인승 차량을 위한 도로가 있는지 여부에 따라 경로를 변경할지 여부를 지정합니다. 이 필드는 v2.computeRouteMatrix에서 지원되지 않습니다.

VehicleInfo

차량 배출 유형과 같은 차량 정보를 포함합니다.

JSON 표현

JSON 표현
{ "emissionType": enum (`VehicleEmissionType`), "totalAxleCount": integer, "totalHeightMm": string, "totalLengthMm": string, "totalWidthMm": string, "totalWeightKg": string, "trailerInfo": [ { object (`TrailerInfo`) } ] }

{
  "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

Google에서 지원하는 전 세계 유료 도로 목록입니다.

열거형
`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`	인도네시아 통행료 결제에 사용되는 여러 은행에서 제공하는 전자 카드입니다. 은행을 통한 모든 전자 카드에는 요금이 동일하게 청구되므로 하나의 enum 값만 필요합니다. 예: 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`	Japan 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`	AK, USA입니다.
`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`	IL, USA입니다.
`US_IL_IPASS`	IL, USA입니다.
`US_IN_EZPASSIN`	인도, 미국.
`US_KS_BESTPASS_HORIZON`	KS, 미국.
`US_KS_KTAG`	KS, 미국.
`US_KS_NATIONALPASS`	KS, 미국.
`US_KS_PREPASS_ELITEPASS`	KS, 미국.
`US_KY_RIVERLINK`	KY, USA
`US_LA_GEAUXPASS`	LA, USA입니다.
`US_LA_TOLL_TAG`	LA, USA입니다.
`US_MA_EZPASSMA`	MA, USA
`US_MD_EZPASSMD`	의학 박사, 미국.
`US_ME_EZPASSME`	ME, USA
`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`	뉴햄프셔주, 미국.
`US_NJ_DOWNBEACH_EXPRESS_PASS`	뉴저지주입니다.
`US_NJ_EZPASSNJ`	뉴저지주입니다.
`US_NY_EXPRESSPASS`	뉴욕, 미국.
`US_NY_EZPASSNY`	뉴욕, 미국.
`US_OH_EZPASSOH`	오, 미국.
`US_PA_EZPASSPA`	PA, USA입니다.
`US_RI_EZPASSRI`	RI, USA
`US_SC_PALPASS`	SC, USA
`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`	워싱턴 D.C.로 이동합니다.
`US_WA_GOOD_TO_GO`	워싱턴 D.C.로 이동합니다.
`US_WV_EZPASSWV`	WV, USA.
`US_WV_MEMORIAL_BRIDGE_TICKETS`	WV, USA.
`US_WV_MOV_PASS`	미국 웨스트버지니아주
`US_WV_NEWELL_TOLL_BRIDGE_TICKET`	WV, USA.

HOVPreference

점유율이 높은 다인승 차량 (HOV) 도로나 차선을 기준으로 경로를 변경할지 지정합니다.

JSON 표현
{ "allowHov": boolean }

입력란

입력란
`allowHov`	`boolean` 다인승 차량을 위한 차선을 공유하는 도로 구간과 더불어 다인승 차량 전용 도로에서도 경로를 허용할지 지정합니다. 기본적으로 다인승 전용 도로가 포함되지 않은 경로가 우선 적용됩니다. `RoutingPreference`은 `TRAFFIC_AWARE_OPTIMAL`로 설정해야 합니다.

allowHov

boolean

다인승 차량을 위한 차선을 공유하는 도로 구간과 더불어 다인승 차량 전용 도로에서도 경로를 허용할지 지정합니다. 기본적으로 다인승 전용 도로가 포함되지 않은 경로가 우선 적용됩니다. RoutingPreference은 TRAFFIC_AWARE_OPTIMAL로 설정해야 합니다.