이 제품 또는 기능은 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 지역 코드로 지정해야 합니다. 지원되는 국가는 CH, AT, CZ, HU, SI, SK입니다. 이 필드는 v2.computeRouteMatrix에서 지원되지 않습니다.
`hovPreference`	`object (HOVPreference)` HOV가 적용되는 도로의 존재 여부에 따라 경로를 변경할지 지정합니다. 이 필드는 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`	인도네시아 통행료를 지불하는 데 사용되는 여러 은행에서 제공하는 전자 카드입니다. 은행을 통한 모든 e-카드는 동일하게 청구되므로 하나의 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`	알래스카주, 미국.
`US_CA_FASTRAK`	미국 캘리포니아주.
`US_CA_FASTRAK_CAV_STICKER`	운전자가 DMV에서 발급한 청정 공기 차량 (CAV) 스티커와 함께 FasTrak 패스를 보유하고 있음을 나타냅니다. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
`US_CO_EXPRESSTOLL`	CO, USA입니다.
`US_CO_GO_PASS`	CO, USA입니다.
`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`	IN, USA
`US_KS_BESTPASS_HORIZON`	미국 캔자스주
`US_KS_KTAG`	미국 캔자스주
`US_KS_NATIONALPASS`	미국 캔자스주
`US_KS_PREPASS_ELITEPASS`	미국 캔자스주
`US_KY_RIVERLINK`	미국 켄터키 주입니다.
`US_LA_GEAUXPASS`	LA, 미국
`US_LA_TOLL_TAG`	LA, 미국
`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`	미국 미네소타주입니다.
`US_NC_EZPASSNC`	미국 노스캐롤라이나 주입니다.
`US_NC_PEACH_PASS`	미국 노스캐롤라이나 주입니다.
`US_NC_QUICK_PASS`	미국 노스캐롤라이나 주입니다.
`US_NH_EZPASSNH`	NH, USA(미국)입니다.
`US_NJ_DOWNBEACH_EXPRESS_PASS`	미국 뉴저지주입니다.
`US_NJ_EZPASSNJ`	미국 뉴저지주입니다.
`US_NY_EXPRESSPASS`	뉴욕시, 미국.
`US_NY_EZPASSNY`	뉴욕시, 미국.
`US_OH_EZPASSOH`	오, 미국.
`US_PA_EZPASSPA`	펜실베이니아주: 미국.
`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`	워싱턴주.
`US_WA_GOOD_TO_GO`	워싱턴주.
`US_WV_EZPASSWV`	미국 웨스트버지니아주에 있습니다.
`US_WV_MEMORIAL_BRIDGE_TICKETS`	미국 웨스트버지니아주에 있습니다.
`US_WV_MOV_PASS`	미국 웨스트버지니아주
`US_WV_NEWELL_TOLL_BRIDGE_TICKET`	미국 웨스트버지니아주에 있습니다.

HOVPreference

사람이 많은 차량 (HOV)이 있는 도로 또는 차선이 있는지에 따라 경로를 변경할지 여부를 지정합니다.

JSON 표현
{ "allowHov": boolean }

입력란

입력란
`allowHov`	`boolean` 다인승 전용 차선을 공유하는 도로 구간 외에도 다인승 전용 도로를 이용할 수 있는지 여부를 지정합니다. 기본적으로 다인승 전용 도로가 포함되지 않은 경로가 우선적으로 고려됩니다. `RoutingPreference`은 `TRAFFIC_AWARE_OPTIMAL`로 설정해야 합니다.

allowHov

boolean

다인승 전용 차선을 공유하는 도로 구간 외에도 다인승 전용 도로를 이용할 수 있는지 여부를 지정합니다. 기본적으로 다인승 전용 도로가 포함되지 않은 경로가 우선적으로 고려됩니다. RoutingPreference은 TRAFFIC_AWARE_OPTIMAL로 설정해야 합니다.