Route

Route 클래스

google.maps.routes.Route 클래스

시작, 종료, 중간 경유지를 연결하는 일련의 연결된 도로 세그먼트로 구성된 경로를 포함합니다.

const {Route} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

computeRoutes
computeRoutes(request)
매개변수: 
반환 값:  Promise<{
  routes:Array<Route> optional,
  fallbackInfo:FallbackInfo optional,
  geocodingResults:GeocodingResults optional
}>
출발지, 도착지, 중간 경유지가 주어지면 기본 경로와 선택적 대체 경로를 반환합니다.

참고: 이 메서드를 사용하려면 ComputeRoutesRequest.fields 속성을 설정하여 요청에 응답 필드 마스크를 지정해야 합니다. 값은 필드 경로 목록입니다.

예를 들면 다음과 같습니다.
  • 사용 가능한 모든 필드의 필드 마스크: fields: ['*']
  • 경로 수준 소요 시간, 거리, 경로의 필드 마스크: fields: ['durationMillis', 'distanceMeters', 'path']

와일드 카드 응답 필드 마스크 fields: ['*']는 다음과 같은 이유로 사용하지 않는 것이 좋습니다.
  • 필요한 필드만 선택하면 서버에서 계산 주기를 절약할 수 있으므로 지연 시간이 짧은 결과를 반환할 수 있습니다.
  • 프로덕션 작업에 필요한 필드만 선택하면 지연 시간 성능이 안정적으로 유지됩니다. 향후 더 많은 응답 필드가 추가될 수 있으며, 이러한 새 필드에는 추가 계산 시간이 필요할 수 있습니다. 모든 필드를 선택하거나 최상위 수준에서 모든 필드를 선택하면 추가하는 모든 새 필드가 응답에 자동으로 포함되므로 성능이 저하될 수 있습니다.
  • 필요한 필드만 선택하면 응답 크기가 작아지므로 네트워크를 통한 로드가 빨라집니다.
description
유형:  string optional
경로에 대한 설명입니다.
distanceMeters
유형:  number optional
경로의 이동 거리(미터)입니다.
durationMillis
유형:  number optional
경로를 탐색하는 데 필요한 시간(밀리초)입니다. ComputeRoutesRequest.routingPreference를 TRAFFIC_UNAWARE로 설정하면 이 값은 Route.staticDurationMillis와 동일합니다. ComputeRoutesRequest.routingPreference를 TRAFFIC_AWARE 또는 TRAFFIC_AWARE_OPTIMAL로 설정하면 교통 상황을 고려하여 이 값이 계산됩니다.

참고: 기간이 2^53밀리초를 초과하면 이 값은 Number.POSITIVE_INFINITY입니다.
legs
유형:  Array<RouteLeg> optional
경로를 구성하는 구간 (경유지 간의 경로 세그먼트)의 컬렉션입니다. 각 구간은 via가 아닌 두 경유지 간의 이동에 해당합니다.

예를 들면 다음과 같습니다.
  • 중간 경유지가 없는 경로에는 구간이 하나만 있습니다.
  • via가 아닌 중간 경유지 1개가 포함된 경로에는 구간이 2개 있습니다.
  • 중간 경유지 via 1개가 포함된 경로에는 구간이 1개 있습니다.
구간의 순서는 origin에서 intermediates, destination까지의 경유지 순서와 일치합니다.
localizedValues
유형:  RouteLocalizedValues optional
Route 속성의 텍스트 표현입니다.
optimizedIntermediateWaypointIndices
유형:  Array<number> optional
ComputeRoutesRequest.optimizeWaypointOrder를 true로 설정하면 이 필드에는 중간 경유지의 최적화된 순서가 포함됩니다. 그렇지 않으면 이 필드는 비어 있습니다. 색인은 입력에 제공된 첫 번째 중간 경유지의 경우 0으로 시작합니다.

예를 들어 다음과 같이 입력하면
  • 출발지: LA
  • 중간 경유지: 댈러스, 뱅고어, 피닉스
  • 목적지: 뉴욕
이고 최적화된 중간 경유지 순서가 피닉스, 댈러스, 뱅거인 경우 이 필드는 [2, 0, 1]입니다.
path
유형:  Array<LatLngAltitude> optional
경로 다중선을 그리는 데 사용할 수 있는 경로의 LatLngAltitude 목록입니다. ComputeRoutesRequest.polylineQuality를 설정하여 경로의 세분화 수준을 제어할 수 있습니다.
polylineDetails
유형:  PolylineDetails optional
경로의 세부정보가 포함됩니다.
routeLabels
유형:  Array<RouteLabel> optional
다른 경로와 비교하여 특정 속성을 식별하는 데 유용한 경로의 라벨입니다.
routeToken
유형:  string optional
내비게이션 중에 경로를 재구성하고 경로를 다시 지정하는 경우 경로가 생성될 때의 원래 의도를 반영하기 위해 Navigation SDK에 전달할 수 있는 불투명 토큰입니다. 이 토큰을 불투명 blob으로 취급합니다. 서비스에서 정확히 동일한 경로를 반환하더라도 값이 변경될 수 있으므로 요청 간에 값을 비교하지 마세요.

참고: routeToken는 ComputeRoutesRequest.routingPreference를 TRAFFIC_AWARE 또는 TRAFFIC_AWARE_OPTIMAL로 설정한 요청에만 사용할 수 있습니다. 경유지가 via개인 요청에는 지원되지 않습니다.
speedPaths
유형:  Array<SpeedPath> optional
경로 구간의 섹션 그룹과 해당 속도 측정값입니다. 이 필드를 채우려면 ComputeRoutesRequest.routingPreference를 TRAFFIC_AWARE 또는 TRAFFIC_AWARE_OPTIMAL로 설정해야 하고 ComputeRoutesRequest.extraComputations에 TRAFFIC_ON_POLYLINE가 포함되어야 합니다.
staticDurationMillis
유형:  number optional
교통 상황을 고려하지 않고 경로를 이동하는 데 걸리는 시간입니다.

참고: 기간이 2^53밀리초를 초과하면 이 값은 Number.POSITIVE_INFINITY입니다.
travelAdvisory
유형:  RouteTravelAdvisory optional
경로에 대한 추가 정보입니다.
viewport
유형:  LatLngBounds optional
경로의 표시 영역 경계 상자입니다.
warnings
유형:  Array<string> optional
경로를 표시할 때 표시할 경고 배열입니다.
createPolylines
createPolylines([options])
매개변수: 
반환 값:  Array<Polyline>
사용 가능한 데이터를 기반으로 경로의 다중선을 만듭니다.

멀티모달 다중선:
  • 요구사항:
  • 각 멀티모달 경로 세그먼트에 대한 다중선을 만듭니다. 다중선은 세그먼트 이동 수단 및 대중교통 노선 데이터(사용 가능한 경우)에 따라 스타일이 지정됩니다. 이동 수단 및 대중교통 노선에 따라 다중선 스타일을 변경하는 옵션을 전달할 수 있습니다.

교통정보 다중선:
  • 요구사항:
  • 속도 판독값이 이전 구간과 다른 경우 각 경로 구간에 대한 다중선을 만듭니다. 다중선에는 기본 속도 기반 스타일이 적용됩니다. 속도에 따라 다중선 스타일을 변경하는 옵션을 전달할 수 있습니다.

전체 다중선:
  • 요구사항:
  • 기본 스타일이 적용된 전체 경로에 대해 단일 다중선을 만듭니다. 경로 이동 수단에 따라 다중선 스타일을 변경하는 옵션을 전달할 수 있습니다. 추가 맞춤설정을 하려면 Route.path 또는 RouteLeg.path를 사용하여 다중선을 직접 만듭니다.
createWaypointAdvancedMarkers
createWaypointAdvancedMarkers([options])
각 경유지에 대해 'A', 'B', 'C' 등의 라벨이 지정된 경로의 마커를 만듭니다. 마커에 기본 스타일이 적용됩니다. 마커 색인 또는 해당 RouteLeg의 속성을 기반으로 마커 스타일을 변경하는 옵션을 전달할 수 있습니다. 경로에 구간이 없으면 WaypointMarkerDetails.leg 매개변수가 정의되지 않습니다.

중간 경유지를 포함하려면 ComputeRoutesRequest.fields에서 "legs" 필드를 요청해야 합니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

ComputeRoutesRequest 인터페이스

google.maps.routes.ComputeRoutesRequest 인터페이스

경로를 요청합니다.

destination
경로의 목적지입니다. 문자열로 전달되는 값은 주소, 플러스 코드 또는 장소 리소스 이름일 수 있습니다. 경로를 계산할 때 고도 값은 고려되지 않습니다.
fields
유형:  Iterable<string>
가져올 필드의 컬렉션입니다. 모든 필드에 ["*"]를 지정합니다.
origin
경로의 출발지입니다. 문자열로 전달되는 값은 주소, 플러스 코드 또는 장소 리소스 이름일 수 있습니다. 경로를 계산할 때 고도 값은 고려되지 않습니다.
arrivalTime optional
유형:  Date optional
도착 시간입니다.

참고: ComputeRoutesRequest.travelMode가 TRANSIT로 설정된 경우에만 설정할 수 있습니다. ComputeRoutesRequest.departureTime 또는 ComputeRoutesRequest.arrivalTime 중 하나를 지정할 수 있지만 둘 다 지정할 수는 없습니다. 대중교통 경로는 과거 최대 7일 또는 미래 최대 100일까지 사용할 수 있습니다.
computeAlternativeRoutes optional
유형:  boolean optional
경로 외에 대체 경로를 계산할지 여부를 지정합니다. 중간 경유지가 있는 요청에는 대체 경로가 반환되지 않습니다.
departureTime optional
유형:  Date optional
출발 시간입니다. 이 값을 설정하지 않으면 요청을 보낸 시간이 기본값으로 사용됩니다.

참고: ComputeRoutesRequest.travelMode가 TRANSIT로 설정된 경우에만 과거 시간을 지정할 수 있습니다. 대중교통 경로는 과거 최대 7일 또는 미래 최대 100일까지 사용할 수 있습니다.
extraComputations optional
요청을 완료하는 데 사용할 수 있는 추가 계산 목록입니다.

참고: 이러한 추가 계산은 응답에 추가 필드를 반환할 수 있습니다. 이러한 추가 필드는 응답에서 반환되도록 ComputeRoutesRequest.fields에도 지정해야 합니다.
intermediates optional
유형:  Iterable<Waypoint> optional
경로를 따라 정차하거나 지나가는 경유지 집합 (종점 제외)입니다. 중간 경유지는 최대 25개까지 지원됩니다.
language optional
유형:  string optional
BCP-47 언어 코드(예: 'en-US' 또는 'sr-Latn') 자세한 내용은 유니코드 언어 ID를 참고하세요. 지원되는 언어 목록은 언어 지원을 참조하세요. 이 값을 제공하지 않으면 Google Maps JavaScript API 현지화 설정에서 언어가 추론됩니다. 그렇지 않으면 출발지 위치에서 언어가 추론됩니다.
optimizeWaypointOrder optional
유형:  boolean optional
true로 설정하면 서비스는 지정된 중간 경유지를 재정렬하여 경로의 전체 비용을 최소화하려고 시도합니다. 중간 경유지가 경유지인 경우 요청이 실패합니다. 응답에서 Route.optimizedIntermediateWaypointIndices를 사용하여 새 순서를 찾습니다. ComputeRoutesRequest.fields에서 "optimizedIntermediateWaypointIndices"가 요청되지 않으면 요청이 실패합니다. false로 설정하면 응답의 Route.optimizedIntermediateWaypointIndices가 비어 있습니다.
polylineQuality optional
유형:  PolylineQuality optional
다중선 품질에 대한 환경설정을 지정합니다.
region optional
유형:  string optional
ccTLD ('최상위 도메인') 2자리 값으로 지정되는 지역 코드입니다. 자세한 내용은 국가 코드 최상위 도메인을 참고하세요. 이 값을 제공하지 않으면 Google Maps JavaScript API 현지화 설정에서 지역이 추론됩니다. 그렇지 않으면 리전이 원본 위치에서 추론됩니다.
requestedReferenceRoutes optional
유형:  Iterable<ReferenceRoute> optional
기본 경로 외에 요청의 일부로 계산할 참조 경로를 지정합니다. 참조 경로는 기본 경로와 다른 경로 계산 목표를 가진 경로입니다. 예를 들어 FUEL_EFFICIENT 참조 경로 계산에서는 최적의 연비 최적 경로를 생성하는 다양한 매개변수를 고려합니다. 이 기능을 사용할 때는 결과 경로에서 Route.routeLabels를 찾으세요.
routeModifiers optional
유형:  RouteModifiers optional
경로 계산 방식에 영향을 미치는 충족해야 하는 조건 집합입니다. 예를 들어 유료 도로 또는 고속도로와 같이 피해야 할 기능을 지정할 수 있습니다.
routingPreference optional
유형:  RoutingPreference optional
경로를 계산하는 방법을 지정합니다. 서버는 선택한 경로 기본 설정을 사용하여 경로를 계산하려고 시도합니다. 라우팅 환경설정으로 인해 오류가 발생하거나 지연 시간이 너무 길어지면 오류가 반환됩니다. ComputeRoutesRequest.travelMode가 DRIVING 또는 TWO_WHEELER인 경우에만 이 옵션을 지정할 수 있습니다. 그렇지 않으면 요청이 실패합니다.
trafficModel optional
유형:  TrafficModel optional
이동 시간을 계산할 때 사용할 가정을 지정합니다. 이 설정은 이전 평균을 기반으로 한 예상 이동 시간이 포함된 Route.durationMillis 및 RouteLeg.durationMillis 값에 영향을 미칩니다. ComputeRoutesRequest.trafficModel는 ComputeRoutesRequest.routingPreference를 TRAFFIC_AWARE_OPTIMAL로, ComputeRoutesRequest.travelMode를 DRIVING로 설정한 요청에만 사용할 수 있습니다. 기본값은 BEST_GUESS입니다.
transitPreference optional
유형:  TransitPreference optional
TRANSIT 경로에 대해 반환되는 경로에 영향을 미치는 환경설정을 지정합니다.

참고: ComputeRoutesRequest.travelMode가 TRANSIT로 설정된 경우에만 지정할 수 있습니다.
travelMode optional
유형:  TravelMode optional
이동 수단을 지정합니다.
units optional
유형:  UnitSystem optional
내비게이션 안내와 같은 표시 필드의 측정 단위를 지정합니다. 경로, 구간, 단계 거리, 소요 시간에 사용되는 측정 단위는 이 값의 영향을 받지 않습니다. 이 값을 제공하지 않으면 출발지 위치에서 표시 단위가 추론됩니다.

ComputeRoutesExtraComputation 상수

google.maps.routes.ComputeRoutesExtraComputation 상수

Route.computeRoutes 요청에 대해 수행할 추가 계산입니다.

const {ComputeRoutesExtraComputation} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

FLYOVER_INFO_ON_POLYLINE 경로의 플라이오버 정보입니다. 이 정보를 반환하려면 ComputeRoutesRequest.fields에 "polylineDetails" 필드를 지정해야 합니다. 이 데이터는 현재 인도의 특정 대도시에서만 채워집니다. 이 기능은 실험용이며 SKU/요금은 변경될 수 있습니다.
FUEL_CONSUMPTION 경로의 예상 연료 소비량입니다.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS 형식이 지정된 HTML 텍스트 문자열로 표시되는 내비게이션 안내입니다. 이 콘텐츠는 있는 그대로 읽어야 하며 표시 전용입니다. 프로그래매틱 방식으로 파싱하지 마세요.
NARROW_ROAD_INFO_ON_POLYLINE 경로의 좁은 도로 정보입니다. 이 정보를 반환하려면 ComputeRoutesRequest.fields에 "polylineDetails" 필드를 지정해야 합니다. 이 데이터는 현재 인도의 특정 대도시에서만 채워집니다. 이 기능은 실험용이며 SKU/요금은 변경될 수 있습니다.
TOLLS 경로의 통행료 정보입니다.
TRAFFIC_ON_POLYLINE 경로의 트래픽 인식 다중선입니다.

DirectionalLocationLiteral 인터페이스

google.maps.routes.DirectionalLocationLiteral 인터페이스

편의상 DirectionalLocation 인스턴스 대신 객체 리터럴이 허용됩니다. 이러한 값은 Maps JS API에서 발견되면 DirectionalLocation로 변환됩니다.

이 인터페이스는 LatLngAltitudeLiteral를 확장합니다.

heading optional
유형:  number optional
교통 흐름의 방향과 연결된 나침반 방향입니다. 방향 값은 0에서 360 사이의 숫자일 수 있습니다. 여기서 0은 정북 방향을, 90은 정동 방향을 지정합니다. 이 필드는 DRIVING 및 TWO_WHEELER ComputeRoutesRequest.travelMode에만 사용할 수 있습니다.
상속됨: altitude, lat, lng

DirectionalLocation 클래스

google.maps.routes.DirectionalLocation 클래스

지리적 지점과 선택적 방향을 캡슐화합니다.

이 클래스는 LatLngAltitude를 확장합니다.

이 클래스는 DirectionalLocationLiteral를 구현합니다.

const {DirectionalLocation} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

상속됨: LatLngAltitude
heading
유형:  number optional
교통 흐름의 방향과 연결된 나침반 방향입니다. 방향 값은 0에서 360 사이의 숫자일 수 있습니다. 여기서 0은 정북 방향을, 90은 정동 방향을 지정합니다. 이 필드는 DRIVING 및 TWO_WHEELER ComputeRoutesRequest.travelMode에만 사용할 수 있습니다.
상속됨: altitude, lat, lng
toJSON
toJSON()
매개변수: 없음
객체로 변환합니다.
상속됨: equals

FallbackInfo 클래스

google.maps.routes.FallbackInfo 클래스

Route.computeRoutes 응답에서 대체 결과가 사용된 방법 및 이유와 관련된 정보입니다. 이 필드가 설정되면 서버가 선호하는 모드와 다른 경로 모드를 대체 모드로 사용했음을 의미합니다.

const {FallbackInfo} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

reason
유형:  FallbackReason optional
원래 응답 대신 대체 응답이 사용된 이유입니다. 이 필드는 대체 모드가 트리거되고 대체 응답이 반환될 때만 채워집니다.
routingMode
유형:  FallbackRoutingMode optional
응답에 사용되는 경로 지정 모드입니다. 대체 모드가 트리거된 경우 모드가 원래 클라이언트 요청에 설정된 경로 설정과 다를 수 있습니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

FallbackReason 상수

google.maps.routes.FallbackReason 상수

Route.computeRoutes 응답에서 대체 응답이 반환된 이유입니다.

const {FallbackReason} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

LATENCY_EXCEEDED 선호하는 경로 모드로 계산을 제시간에 완료할 수 없었지만 대체 모드로 계산된 결과를 반환할 수 있었습니다.
SERVER_ERROR 선호하는 경로 모드로 경로를 계산하는 중에 서버 오류가 발생했지만 대체 모드로 계산된 결과를 반환할 수 있었습니다.

FallbackRoutingMode 상수

google.maps.routes.FallbackRoutingMode 상수

Route.computeRoutes 응답에서 대체 응답이 반환될 때 사용되는 실제 라우팅 모드입니다.

const {FallbackRoutingMode} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

TRAFFIC_AWARE TRAFFIC_AWARE RoutingPreference가 응답을 계산하는 데 사용되었음을 나타냅니다.
TRAFFIC_UNAWARE TRAFFIC_UNAWARE RoutingPreference가 응답을 계산하는 데 사용되었음을 나타냅니다.

GeocodedWaypoint 클래스

google.maps.routes.GeocodedWaypoint 클래스

경유지로 사용되는 위치에 대한 지오코딩입니다. 주소 경유지에만 채워집니다. 주소가 지오코딩된 대상을 확인하기 위한 지오코딩 결과에 대한 세부정보가 포함됩니다.

const {GeocodedWaypoint} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

geocoderStatus
유형:  RPCStatus optional
지오코딩 작업 결과 발생한 상태 코드를 나타냅니다.
intermediateWaypointRequestIndex
유형:  number optional
요청에 있는 해당 중간 경유지의 색인입니다. 해당 경유지가 중간 경유지인 경우에만 채워집니다.
partialMatch
유형:  boolean
지오코더가 원래 요청에 대해 정확히 일치하는 결과를 반환하지 않았지만 요청된 주소의 일부분과 일치함을 나타냅니다. 원래 요청을 검사하여 맞춤법 오류 및/또는 불완전한 주소를 찾아낼 수 있습니다.
placeId
유형:  string
이 결과의 장소 ID입니다.
types
유형:  Array<string>
0개 이상의 유형 태그 형식으로 된 결과 유형입니다. 지원되는 유형은 https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types를 참고하세요.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

GeocodingResults 클래스

google.maps.routes.GeocodingResults 클래스

출발지, 목적지, 중간 경유지의 GeocodedWaypoint를 포함합니다. 주소 경유지에만 채워집니다.

const {GeocodingResults} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

destination
유형:  GeocodedWaypoint optional
목적지의 지오코딩된 경유지입니다.
intermediates
유형:  Array<GeocodedWaypoint> optional
지오코딩된 중간 경유지 목록으로, 각 경유지에는 요청에 지정된 순서대로 경유지의 0부터 시작하는 위치에 해당하는 색인 필드가 포함됩니다.
origin
유형:  GeocodedWaypoint optional
출발지의 지오코딩된 경유지입니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

MultiModalSegment 클래스

google.maps.routes.MultiModalSegment 클래스

경로의 RouteLeg.steps 중 멀티모달 세그먼트에 관한 요약 정보를 제공합니다. 다중 모드 세그먼트는 동일한 TravelMode를 갖는 하나 이상의 연속된 RouteLegStep로 정의됩니다.

const {MultiModalSegment} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

instructions
유형:  string optional
이 멀티모달 세그먼트를 탐색하기 위한 안내입니다.
maneuver
유형:  string optional
이 단계에서 수행할 내비게이션 조작입니다. 가능한 값 목록은 Maneuver를 참고하세요.
stepEndIndex
유형:  number
멀티모달 세그먼트의 끝인 해당 RouteLegStep 색인입니다.
stepStartIndex
유형:  number
멀티모달 세그먼트의 시작인 해당 RouteLegStep 색인입니다.
travelMode
유형:  TravelMode optional
이 멀티모달 세그먼트에 사용되는 이동 수단입니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

PolylineDetailInfo 클래스

google.maps.routes.PolylineDetailInfo 클래스

다중선 구간을 따라 도로 지형지물에 관한 정보를 캡슐화합니다.

const {PolylineDetailInfo} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

endIndex
유형:  number optional
다중선에서 이 도로 지형지물의 종료 색인입니다.
presence
유형:  RoadFeatureState optional
다중선을 따라 도로 지형지물이 있는지 여부를 나타냅니다.
startIndex
유형:  number optional
다중선에 있는 이 도로 지형지물의 시작 색인입니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

PolylineDetails 클래스

google.maps.routes.PolylineDetails 클래스

다중선의 지정된 색인 또는 연속 세그먼트에 해당하는 세부정보입니다. P_0, P_1, … , P_N (0 기반 색인) 지점이 있는 다중선이 주어지면 PolylineDetails는 지정된 간격의 도로 지형지물을 설명합니다.

const {PolylineDetails} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

flyoverInfo
다중선을 따라 표시되는 플라이오버 세부정보입니다.
narrowRoadInfo
다중선을 따라 좁은 도로 세부정보입니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

PolylineQuality 상수

google.maps.routes.PolylineQuality 상수

다중선의 품질을 지정합니다.

const {PolylineQuality} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

HIGH_QUALITY 응답 크기가 증가하는 대신 OVERVIEW보다 많은 포인트를 사용하여 구성된 고품질 다중선을 지정합니다. 더 높은 정밀도가 필요한 경우 이 값을 사용합니다.
OVERVIEW 소수의 점을 사용하여 구성된 개요 다중선을 지정합니다. 이 옵션을 사용하면 HIGH_QUALITY에 비해 요청 지연 시간이 짧습니다. 경로 개요를 표시할 때 이 값을 사용합니다.

ReferenceRoute 상수

google.maps.routes.ReferenceRoute 상수

ComputeRoutesRequest에서 지원되는 참조 경로입니다.

const {ReferenceRoute} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

FUEL_EFFICIENT 연비 최적 경로
SHORTER_DISTANCE 이동 거리가 더 짧은 경로입니다.

RoadFeatureState 상수

google.maps.routes.RoadFeatureState 상수

다중선 구간을 따라 도로 지형지물의 상태를 캡슐화합니다.

const {RoadFeatureState} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

DOES_NOT_EXIST 도로 지형지물이 존재하지 않습니다.
EXISTS 도로 지형지물이 존재합니다.

RouteLabel 상수

google.maps.routes.RouteLabel 상수

다른 경로와 비교할 특정 속성을 식별하는 데 유용한 경로의 라벨입니다.

const {RouteLabel} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

DEFAULT_ROUTE 경로 계산에 반환되는 기본 '최적' 경로입니다.
DEFAULT_ROUTE_ALTERNATE 기본 '최적' 경로의 대안입니다. ComputeRoutesRequest.computeAlternativeRoutes가 지정되면 이와 같은 경로가 반환됩니다.
FUEL_EFFICIENT 연비 최적 경로 이 값으로 라벨이 지정된 경로는 연료 소비와 같은 친환경 매개변수에 최적화된 것으로 판단됩니다.
SHORTER_DISTANCE 이동 거리가 더 짧은 경로입니다. 실험용으로 제공되는 기능입니다.

RouteLeg 클래스

google.maps.routes.RouteLeg 클래스

via 이외의 경유지 간 세그먼트가 포함되어 있습니다.

const {RouteLeg} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

distanceMeters
유형:  number
경로 구간의 이동 거리(미터)입니다.
durationMillis
유형:  number optional
경로 구간을 탐색하는 데 필요한 시간(밀리초)입니다. ComputeRoutesRequest.routingPreference를 TRAFFIC_UNAWARE로 설정하면 이 값은 staticDurationMillis와 동일합니다. ComputeRoutesRequest.routingPreference를 TRAFFIC_AWARE 또는 TRAFFIC_AWARE_OPTIMAL로 설정하면 교통 상황을 고려하여 이 값이 계산됩니다.

참고: 기간이 2^53밀리초를 초과하면 이 값은 Number.POSITIVE_INFINITY입니다.
endLocation
유형:  DirectionalLocation optional
이 구간의 종료 위치입니다. 이 위치는 ComputeRoutesRequest.destination과 다를 수 있습니다. 예를 들어 ComputeRoutesRequest.destination가 도로 근처에 있지 않은 경우 이 지점은 도로에 있습니다.
localizedValues
유형:  RouteLegLocalizedValues optional
RouteLeg 속성의 텍스트 표현입니다.
path
경로 구간 다중선을 그리는 데 사용할 수 있는 경로 구간의 LatLngAltitude 목록입니다. ComputeRoutesRequest.polylineQuality를 설정하여 경로의 세분화 수준을 제어할 수 있습니다.
speedPaths
유형:  Array<SpeedPath>
경로 구간 경로의 섹션 그룹과 해당 속도 측정값입니다. 이 필드를 채우려면 ComputeRoutesRequest.routingPreference를 TRAFFIC_AWARE 또는 TRAFFIC_AWARE_OPTIMAL로 설정해야 하고 ComputeRoutesRequest.extraComputations에 TRAFFIC_ON_POLYLINE가 포함되어야 합니다.
startLocation
유형:  DirectionalLocation optional
이 구간의 시작 위치입니다. 이 위치는 ComputeRoutesRequest.origin과 다를 수 있습니다. 예를 들어 ComputeRoutesRequest.origin가 도로 근처에 있지 않은 경우 이 지점은 도로에 있습니다.
staticDurationMillis
유형:  number optional
교통 상황을 고려하지 않고 구간을 이동하는 데 걸리는 시간입니다.

참고: 기간이 2^53밀리초를 초과하면 이 값은 Number.POSITIVE_INFINITY입니다.
steps
유형:  Array<RouteLegStep>
이 구간 내의 세그먼트를 나타내는 단계 배열입니다. 각 단계는 하나의 탐색 안내를 나타냅니다.
stepsOverview
유형:  StepsOverview optional
이 RouteLeg의 단계에 관한 개요 정보입니다. 이 필드는 TRANSIT 경로에만 채워집니다.
travelAdvisory
유형:  RouteLegTravelAdvisory optional
경로 구간에서 사용자에게 알려야 하는 추가 정보(예: 가능한 교통 구역 제한)가 포함됩니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

RouteLegLocalizedValues 클래스

google.maps.routes.RouteLegLocalizedValues 클래스

RouteLeg의 텍스트 표현입니다.

const {RouteLegLocalizedValues} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

distance
유형:  string optional
텍스트 형식의 경로 구간 이동 거리입니다.
distanceLanguage
유형:  string optional
거리 텍스트의 BCP-47 언어 코드입니다(예: 'en-US' 또는 'sr-Latn').

자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참고하세요.
duration
유형:  string optional
텍스트 형식으로 표시되고 쿼리 지역에 맞게 현지화된 기간입니다. 교통 상황을 고려합니다.
durationLanguage
유형:  string optional
기간 텍스트의 BCP-47 언어 코드입니다(예: 'en-US' 또는 'sr-Latn').

자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참고하세요.
staticDuration
유형:  string optional
교통 상황을 고려하지 않은 소요 시간으로, 텍스트 형식으로 표시됩니다.
staticDurationLanguage
유형:  string optional
정적 기간 텍스트의 BCP-47 언어 코드입니다(예: 'en-US' 또는 'sr-Latn').
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

RouteLegStep 클래스

google.maps.routes.RouteLegStep 클래스

RouteLeg의 세그먼트를 포함합니다. 단계는 단일 탐색 안내에 해당합니다. 경로 구간은 단계로 구성됩니다.

const {RouteLegStep} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

distanceMeters
유형:  number
이 단계의 이동 거리(미터)입니다.
endLocation
유형:  DirectionalLocation optional
이 단계의 도착지입니다.
instructions
유형:  string optional
이 단계를 탐색하는 방법입니다.
localizedValues
유형:  RouteLegStepLocalizedValues optional
RouteLegStep 속성의 텍스트 표현입니다.
maneuver
유형:  string optional
이 단계에서 수행할 내비게이션 조작입니다. 가능한 값 목록은 Maneuver를 참고하세요.
path
경로 구간 단계의 LatLngAltitude 목록으로, 경로 구간 단계 다중선을 그리는 데 사용할 수 있습니다. ComputeRoutesRequest.polylineQuality를 설정하여 경로의 세분화 수준을 제어할 수 있습니다. 이 필드를 채우려면 ComputeRoutesRequest.fields에서 "path" 필드를 요청해야 합니다.
startLocation
유형:  DirectionalLocation optional
이 단계의 시작 위치입니다.
staticDurationMillis
유형:  number optional
교통 상황을 고려하지 않고 이 단계를 통과하는 데 걸리는 시간입니다.

참고: 기간이 2^53밀리초를 초과하면 이 값은 Number.POSITIVE_INFINITY입니다.
transitDetails
유형:  TransitDetails optional
이동 수단이 TRANSIT인 경우 이 단계와 관련된 세부정보입니다.
travelMode
유형:  TravelMode optional
이 단계에 사용된 이동 수단입니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

RouteLegStepLocalizedValues 클래스

google.maps.routes.RouteLegStepLocalizedValues 클래스

RouteLegStep 속성의 텍스트 표현입니다.

const {RouteLegStepLocalizedValues} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

distance
유형:  string optional
경로 구간 단계의 이동 거리(텍스트 형식)입니다.
distanceLanguage
유형:  string optional
거리 텍스트의 BCP-47 언어 코드입니다(예: 'en-US' 또는 'sr-Latn').

자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참고하세요.
staticDuration
유형:  string optional
교통 상황을 고려하지 않은 소요 시간으로, 텍스트 형식으로 표시됩니다.
staticDurationLanguage
유형:  string optional
정적 기간 텍스트의 BCP-47 언어 코드입니다(예: 'en-US' 또는 'sr-Latn').

자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참고하세요.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

RouteLegTravelAdvisory 클래스

google.maps.routes.RouteLegTravelAdvisory 클래스

RouteLeg에서 사용자에게 알려야 하는 추가 정보가 포함되어 있습니다.

const {RouteLegTravelAdvisory} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

speedReadingIntervals
유형:  Array<SpeedReadingInterval> optional
교통 밀도를 자세히 보여주는 속도 판독 간격입니다. TRAFFIC_AWARE 및 TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routingPreference의 경우에 적용됩니다. 간격은 겹치지 않고 RouteLeg의 전체 다중선을 포함합니다. 지정된 간격의 시작점은 이전 간격의 종료점과 동일합니다.

예:
  polyline: A ---- B ---- C ---- D ---- E ---- F ---- G 
speedReadingIntervals: [A,C), [C,D), [D,G)
tollInfo
유형:  TollInfo optional
특정 RouteLeg의 통행료에 관한 정보가 포함되어 있습니다. 이 필드는 RouteLeg에 통행료가 예상되는 경우에만 채워집니다. 이 필드가 설정되어 있지만 TollInfo.estimatedPrices가 채워지지 않은 경우 경로 구간에 통행료가 포함되지만 예상 가격은 알 수 없습니다. 이 필드가 비어 있으면 RouteLeg에 통행료가 없습니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

RouteLocalizedValues 클래스

google.maps.routes.RouteLocalizedValues 클래스

Route 속성의 텍스트 표현입니다.

const {RouteLocalizedValues} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

distance
유형:  string optional
텍스트 형식으로 표현된 경로의 이동 거리입니다.
distanceLanguage
유형:  string optional
거리 텍스트의 BCP-47 언어 코드입니다(예: 'en-US' 또는 'sr-Latn').

자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참고하세요.
duration
유형:  string optional
텍스트 형식으로 표시되고 쿼리 지역에 맞게 현지화된 기간입니다. 교통 상황을 고려합니다. 참고: 교통정보를 요청하지 않은 경우 이 값은 staticDuration와 동일합니다.
durationLanguage
유형:  string optional
기간 텍스트의 BCP-47 언어 코드입니다(예: 'en-US' 또는 'sr-Latn').

자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참고하세요.
staticDuration
유형:  string optional
교통 상황을 고려하지 않은 소요 시간으로, 텍스트 형식으로 표시됩니다.
staticDurationLanguage
유형:  string optional
정적 기간 텍스트의 BCP-47 언어 코드입니다(예: 'en-US' 또는 'sr-Latn').
transitFare
유형:  string optional
텍스트 형식으로 표시된 대중교통 요금입니다.
transitFareLanguage
유형:  string optional
대중교통 요금 텍스트의 BCP-47 언어 코드입니다(예: 'en-US' 또는 'sr-Latn').
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

RouteModifiers 인터페이스

google.maps.routes.RouteModifiers 인터페이스

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

avoidFerries optional
유형:  boolean optional
true로 설정하면 가능한 경우 페리를 피하고 페리가 포함되지 않은 경로를 우선적으로 선택합니다. DRIVING 또는 TWO_WHEELER TravelMode에만 적용됩니다.
avoidHighways optional
유형:  boolean optional
true로 설정하면 가능한 경우 고속도로를 피하고 고속도로가 포함되지 않은 경로를 우선적으로 선택합니다. DRIVING 또는 TWO_WHEELER TravelMode에만 적용됩니다.
avoidIndoor optional
유형:  boolean optional
true로 설정하면 가능한 경우 실내 탐색을 피하고 실내 탐색이 포함되지 않은 경로를 선호합니다. WALKING TravelMode에만 적용됩니다.
avoidTolls optional
유형:  boolean optional
true로 설정하면 가능한 경우 유료 도로를 피하고 유료 도로가 포함되지 않은 경로를 우선적으로 선택합니다. DRIVING 또는 TWO_WHEELER TravelMode에만 적용됩니다.
tollPasses optional
유형:  Iterable<string> optional
톨 패스에 관한 정보를 캡슐화합니다. 톨 패스가 제공되면 API는 패스 가격을 반환하려고 시도합니다. 톨 패스가 제공되지 않으면 API는 톨 패스를 알 수 없는 것으로 처리하고 현금 가격을 반환하려고 시도합니다. DRIVING 또는 TWO_WHEELER TravelMode에만 적용됩니다. 유효한 값 목록은 TollPass를 참고하세요.
vehicleInfo optional
유형:  VehicleInfo optional
차량 정보를 지정합니다.

RoutePolylineDetails 인터페이스

google.maps.routes.RoutePolylineDetails 인터페이스

다중선 스타일을 맞춤설정하는 데 사용할 수 있는 다중선에 해당하는 경로 섹션에 관한 세부정보입니다.

speed optional
유형:  Speed optional
이 다중선에 해당하는 경로 구간의 속도 측정값입니다. 교통정보가 있는 경로에만 채워집니다.
transitDetails optional
유형:  TransitDetails optional
이 다중선에 해당하는 경로 섹션의 대중교통 세부정보입니다. 대중교통 정보가 있는 경로에만 채워집니다.
travelMode optional
유형:  TravelMode optional
이 다중선에 해당하는 경로 구간의 이동 수단입니다. 교통정보 다중선의 경우 비어 있습니다.

RoutePolylineOptions 인터페이스

google.maps.routes.RoutePolylineOptions 인터페이스

경로 다중선을 만드는 옵션입니다.

colorScheme optional
유형:  ColorScheme optional
다중선에 사용할 색 구성표입니다. 지도 colorScheme도 FOLLOW_SYSTEM인 상태에서 FOLLOW_SYSTEM로 지정하면 다중선이 지도와 동일한 어두운 모드/밝은 모드로 그려집니다. 지정하지 않으면 Route.createPolylines에서 지도의 colorScheme를 사용하려고 시도하거나 시스템 기본값으로 대체합니다.
polylineOptions optional
다중선의 스타일을 맞춤설정하는 옵션입니다. 경로의 모든 다중선에 적용되는 PolylineOptions 객체이거나 기본 PolylineOptions 및 RoutePolylineDetails를 사용하고 해당 다중선에 적용할 PolylineOptions를 반환하는 함수일 수 있습니다.

RouteTravelAdvisory 클래스

google.maps.routes.RouteTravelAdvisory 클래스

Route에서 사용자에게 알려야 하는 추가 정보가 포함되어 있습니다.

const {RouteTravelAdvisory} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

fuelConsumptionMicroliters
유형:  number optional
예상 연료 소비량(마이크로리터)입니다.

참고: 연료 소비량이 2^53마이크로리터를 초과하면 이 값은 Number.POSITIVE_INFINITY입니다.
routeRestrictionsPartiallyIgnored
유형:  boolean optional
Route에 요청된 이동 수단 또는 경로 수정자에 적합하지 않은 제한사항이 있을 수 있습니다.
speedReadingIntervals
유형:  Array<SpeedReadingInterval> optional
교통 밀도를 자세히 보여주는 속도 판독 간격입니다. TRAFFIC_AWARE 및 TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routingPreference의 경우에 적용됩니다. 간격은 겹치지 않고 Route의 전체 다중선을 포함합니다. 지정된 간격의 시작점은 이전 간격의 종료점과 동일합니다.

예:
  polyline: A ---- B ---- C ---- D ---- E ---- F ---- G 
speedReadingIntervals: [A,C), [C,D), [D,G)
tollInfo
유형:  TollInfo optional
Route의 통행료에 관한 정보가 포함됩니다. 이 필드는 Route에 통행료가 예상되는 경우에만 채워집니다. 이 필드가 설정되어 있지만 TollInfo.estimatedPrices가 채워지지 않은 경우 경로에 통행료가 포함되지만 예상 가격은 알 수 없습니다. 이 필드가 비어 있으면 Route에 통행료가 없습니다.
transitFare
유형:  Money optional
제공된 경우 이 Route의 총요금 또는 티켓 비용이 포함됩니다. 이 속성은 TRANSIT ComputeRoutesRequest.travelMode 및 모든 대중교통 단계에 대해 요금 정보를 사용할 수 있는 경로의 경우에만 반환됩니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

RoutingPreference 상수

google.maps.routes.RoutingPreference 상수

경로를 계산할 때 고려해야 할 요소입니다.

const {RoutingPreference} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

TRAFFIC_AWARE 실시간 교통 상황을 고려하여 경로를 계산합니다. TRAFFIC_AWARE_OPTIMAL와 달리 지연 시간을 크게 줄이기 위해 일부 최적화가 적용됩니다.
TRAFFIC_AWARE_OPTIMAL 대부분의 성능 최적화를 적용하지 않고 실시간 교통 상황을 고려하여 경로를 계산합니다. 이 값을 사용하면 지연 시간이 가장 길어집니다.
TRAFFIC_UNAWARE 실시간 교통 상황을 고려하지 않고 경로를 계산합니다. 교통 상황이 중요하지 않거나 적용되지 않는 경우에 적합합니다. 이 값을 사용하면 지연 시간이 가장 짧습니다.

속도 상수

google.maps.routes.Speed 상수

교통정보 데이터를 기반으로 한 다중선 속도 분류입니다.

const {Speed} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

NORMAL 정상 속도, 교통 지연 없음
SLOW 서행이 감지되었습니다. 트래픽이 보통입니다.
TRAFFIC_JAM 교통 지연

SpeedPath 인터페이스

google.maps.routes.SpeedPath 인터페이스

경로 구간의 LatLngAltitude를 구간의 속도 측정값과 함께 그룹화합니다.

path
이 속도 경로가 포함하는 경로입니다.
speed optional
유형:  Speed optional
경로의 속도 측정값입니다.

SpeedReadingInterval 클래스

google.maps.routes.SpeedReadingInterval 클래스

다중선 또는 경로의 연속 세그먼트에 대한 교통 밀도 표시기입니다. P_0, P_1, … , P_N (0부터 시작하는 색인) 지점이 있는 경로가 주어지면 SpeedReadingInterval는 구간의 교통 밀도를 설명합니다.

const {SpeedReadingInterval} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

endPolylinePointIndex
유형:  number optional
다중선에서 이 간격의 종료 색인입니다.
speed
유형:  Speed optional
이 간격의 트래픽 속도입니다.
startPolylinePointIndex
유형:  number optional
다중선에서 이 간격의 시작 색인입니다.
toJSON
toJSON()
매개변수: 없음
반환 값: 없음
객체로 변환합니다.

StepsOverview 클래스

google.maps.routes.StepsOverview 클래스

RouteLeg.steps 목록에 대한 개요 정보를 제공합니다.

const {StepsOverview} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

multiModalSegments
RouteLeg.steps의 다양한 멀티모달 세그먼트에 대한 요약 정보입니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

TollInfo 클래스

google.maps.routes.TollInfo 클래스

Route 또는 RouteLeg의 통행료 정보를 캡슐화합니다.

const {TollInfo} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

estimatedPrices
유형:  Array<Money> optional
해당 Route 또는 RouteLeg의 통행료 금액입니다. 이 목록에는 통행료 정산소에서 청구할 것으로 예상되는 각 통화의 금액이 포함됩니다. 일반적으로 이 목록에는 단일 통화로 통행료가 부과되는 경로의 항목이 하나만 포함됩니다. 국제 여행의 경우 이 목록에는 다양한 통화의 통행료를 반영하는 여러 항목이 포함될 수 있습니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

TransitAgency 클래스

google.maps.routes.TransitAgency 클래스

대중교통 기관에 관한 정보입니다.

const {TransitAgency} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

name
유형:  string optional
이 대중교통 기관의 이름입니다.
phoneNumber
유형:  string optional
대중교통 기관의 언어별 형식의 전화번호입니다.
url
유형:  URL optional
대중교통 기관의 URL입니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

TransitDetails 클래스

google.maps.routes.TransitDetails 클래스

경로의 대중교통 단계에 관한 추가 정보입니다.

const {TransitDetails} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

arrivalStop
유형:  TransitStop optional
단계의 도착 정류장에 관한 정보입니다.
arrivalTime
유형:  Date optional
단계의 도착 예정 시간입니다.
departureStop
유형:  TransitStop optional
단계의 출발 정류장에 관한 정보입니다.
departureTime
유형:  Date optional
단계의 예상 출발 시간입니다.
headsign
유형:  string optional
이 노선의 이동 방향을 지정하며 차량이나 출발 정류장에 표시됩니다. 방향은 대부분의 경우 종착역입니다.
headwayMillis
유형:  number optional
현재 동일한 정류장의 예상 배차 간격을 밀리초 단위로 지정합니다. 예를 들어 배차 간격 값이 600,000인 경우 버스를 놓치면 다음 버스까지 10분을 기다려야 합니다.

참고: 배차 간격이 2^53밀리초를 초과하면 이 값은 Number.POSITIVE_INFINITY입니다.
stopCount
유형:  number
출발 정류장에서 도착 정류장까지의 정류장 수입니다. 이 개수에는 도착 정류장은 포함되지만 출발 정류장은 제외됩니다. 예를 들어 정류장 A에서 출발하여 정류장 B와 C를 지나 정류장 D에 도착하는 경로의 경우 stopCount는 3입니다.
transitLine
유형:  TransitLine optional
단계에서 사용되는 대중교통 노선에 관한 정보입니다.
tripShortText
유형:  string optional
승객에게 대중교통 이동을 식별하기 위해 일정 및 표지판에 표시되는 텍스트입니다. 서비스 날짜 내에서 이동을 고유하게 식별하는 텍스트입니다. 예를 들어 '538'은 평일 15시 10분에 캘리포니아주 산호세에서 캘리포니아주 새크라멘토로 출발하는 암트랙 열차의 tripShortText입니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

TransitLine 클래스

google.maps.routes.TransitLine 클래스

대중교통 노선에 관한 정보입니다.

const {TransitLine} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

agencies
유형:  Array<TransitAgency>
이 대중교통 노선을 운영하는 대중교통 기관입니다.
color
유형:  string optional
이 노선의 표지판에 흔히 사용되는 색상입니다. 16진수로 표시됩니다.
iconURL
유형:  URL optional
이 노선과 연결된 아이콘의 URL입니다.
name
유형:  string optional
대중교통 노선의 전체 이름입니다(예: '8 Avenue Local').
shortName
유형:  string optional
이 대중교통 노선의 짧은 이름입니다. 이 이름은 일반적으로 'M7' 또는 '355'와 같은 노선 번호입니다.
textColor
유형:  string optional
이 노선의 표지판에 흔히 사용되는 텍스트의 색상입니다. 16진수로 표시됩니다.
url
유형:  URL optional
대중교통 기관에서 제공하는 대중교통 노선의 URL입니다.
vehicle
유형:  TransitVehicle optional
이 대중교통 노선에서 운행되는 운송 수단의 유형입니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

TransitPreference 인터페이스

google.maps.routes.TransitPreference 인터페이스

반환되는 경로에 영향을 미치는 TRANSIT 기반 경로의 환경설정입니다.

allowedTransitModes optional
유형:  Iterable<TransitMode> optional
TRANSIT 경로를 가져올 때 사용할 이동 수단 집합입니다. 기본값은 지원되는 모든 이동 수단입니다.
routingPreference optional
유형:  TransitRoutePreference optional
지정 시 반환되는 TRANSIT 경로에 영향을 미치는 경로 환경설정입니다.

TransitStop 클래스

google.maps.routes.TransitStop 클래스

대중교통 정류장에 관한 정보입니다.

const {TransitStop} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

location
유형:  DirectionalLocation optional
위도/경도 좌표와 선택적 방향으로 표현된 정류장 위치입니다.
name
유형:  string optional
대중교통 정류장의 이름입니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

TransitVehicle 클래스

google.maps.routes.TransitVehicle 클래스

대중교통 경로에 사용되는 차량에 관한 정보입니다.

const {TransitVehicle} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

iconURL
유형:  URL optional
이 운송 수단 유형과 연결된 아이콘의 URL입니다.
localIconURL
유형:  URL optional
지역 교통 표지판을 기반으로 이 운송 수단 유형과 연결되는 아이콘의 URL입니다.
name
유형:  string optional
이 차량의 이름입니다(대문자로 표기).
nameLanguage
유형:  string optional
차량 이름 텍스트의 BCP-47 언어 코드입니다(예: 'en-US' 또는 'sr-Latn').

자세한 내용은 https://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참고하세요.
vehicleType
유형:  string optional
사용된 차량 유형입니다.

가능한 값 목록은 https://developers.google.com/maps/documentation/routes/reference/rpc/google.maps.routing.v2#transitvehicletype을 참고하세요.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

VehicleEmissionType 상수

google.maps.routes.VehicleEmissionType 상수

차량의 배출 유형을 설명하는 값 집합입니다. DRIVING 이동 수단에만 적용됩니다.

const {VehicleEmissionType} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.

DIESEL 디젤 연료 차량입니다.
ELECTRIC 전기 구동 차량입니다.
GASOLINE 휘발유/석유 연료 차량입니다.
HYBRID 하이브리드 연료 (예: 휘발유 + 전기) 차량입니다.

VehicleInfo 인터페이스

google.maps.routes.VehicleInfo 인터페이스

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

emissionType optional
유형:  VehicleEmissionType optional
차량의 배출가스 유형을 설명합니다. DRIVING 이동 수단에만 적용됩니다.

Waypoint 인터페이스

google.maps.routes.Waypoint 인터페이스

경로의 경유지를 나타냅니다.

location
경유지의 위치입니다. 문자열은 주소, Plus Code 또는 장소 리소스 이름일 수 있습니다.
sideOfRoad optional
유형:  boolean optional
이 경유지의 위치가 차량이 도로의 특정 측면에 정차하는 것을 선호함을 나타냅니다. 이 값을 설정하면 경로가 위치를 통과하므로 차량이 도로 중앙에서 위치가 치우친 도로변에 정차할 수 있습니다. 이 옵션은 DRIVING 및 TWO_WHEELER ComputeRoutesRequest.travelMode에만 적용됩니다.
vehicleStopover optional
유형:  boolean optional
차량이 승차 또는 하차를 위해 정차하는 경유지임을 나타냅니다. 이 값을 설정하면 계산된 경로에 승차 및 하차에 적합하지 않은 도로의 via 이외의 경유지가 포함되지 않습니다. 이 옵션은 DRIVING 및 TWO_WHEELER ComputeRoutesRequest.travelMode에만 작동하며 Waypoint.location가 string 또는 Place가 아닌 경우에만 작동합니다.
via optional
유형:  boolean optional
이 경유지를 정류장이 아닌 주요 지점으로 표시합니다. ComputeRoutesRequest의 via가 아닌 각 경유지에 대해 Route.computeRoutes는 Route.legs 배열에 항목을 추가하여 해당 구간의 경유지에 대한 세부정보를 제공합니다.

경유하지 않고 이 경유지를 통과하도록 경로를 설정하려면 이 값을 true로 설정합니다. 경유지는 Route.legs 배열에 항목을 추가하지 않지만 경유지를 통해 여정을 라우팅합니다.

참고:
  • 이 값은 중간 지점인 경유지에서만 설정할 수 있습니다. 터미널 경유지에 이 필드를 설정하면 요청이 실패합니다.
  • ComputeRoutesRequest.optimizeWaypointOrder가 true로 설정된 경우 이 필드를 true로 설정할 수 없습니다. 그렇지 않으면 요청이 실패합니다.

WaypointMarkerDetails 인터페이스

google.maps.routes.WaypointMarkerDetails 인터페이스

마커 스타일을 맞춤설정하는 데 사용할 수 있는 경유지에 관한 세부정보입니다.

index
유형:  number
마커의 색인입니다.
totalMarkers
유형:  number
경로의 총 마커 수입니다.
leg optional
유형:  RouteLeg optional
마커가 속한 구간입니다. 경로에 구간이 없으면 비어 있습니다.