Routes Data

Route 클래스

google.maps.routes.Route 클래스
라이브러리 "routes"

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

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

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

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

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

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

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

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

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

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

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

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

전체 다중선:
  • 요구사항:
  • 기본 스타일이 적용된 전체 경로에 대해 단일 다중선을 만듭니다. 경로 이동 수단에 따라 다중선 스타일을 변경하는 옵션을 전달할 수 있습니다. 추가 맞춤설정을 하려면 Route.path 또는 RouteLeg.path를 사용하여 다중선을 직접 만듭니다.
AlphacreatePopover
createPopover()
매개변수: 없음
반환 값: Promise<PopoverElement>
경로에 사용할 수 있는 데이터를 기반으로 경로의 팝오버를 만들고 지도에서 경로에 주석을 추가하는 데 적합한 방식으로 구성합니다. 현재 Route.localizedValues, Route.path, Route.legs를 사용합니다(사용 가능한 경우).
createWaypointAdvancedMarkers
createWaypointAdvancedMarkers([options])
각 경유지에 대해 'A', 'B', 'C' 등의 라벨이 지정된 경로의 마커를 만듭니다. 마커에 기본 스타일이 적용됩니다. 마커 색인 또는 해당 RouteLeg의 속성을 기반으로 마커 스타일을 변경하는 옵션을 전달할 수 있습니다. 경로에 구간이 없으면 WaypointMarkerDetails.leg 매개변수가 정의되지 않습니다.

중간 경유지를 포함하려면 ComputeRoutesRequest.fields에서 "legs" 필드를 요청해야 합니다.
AlphacreateWaypointMarkers
매개변수:
반환 값: Promise<Array<T>>
경로의 출발지와 목적지에 대한 마커를 만듭니다. customOverride 함수가 지정되지 않는 한 마커에는 기본 스타일이 적용됩니다. 중간 경유지는 현재 지원되지 않습니다.

생성된 마커의 CollisionBehavior는 기본적으로 CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL로 설정됩니다. 생성된 마커에는 기본적으로 현지화된 title ('출발지' 또는 '목적지')가 있으며, 이는 forEach에서 재정의할 수 있습니다. Marker3DElement 및 Marker3DInteractiveElement 마커의 경우 sizePreserved는 기본적으로 true로 설정되며 forEach에서 재정의할 수도 있습니다.
상속됨: toJSON

ComputeRoutesRequest 인터페이스

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

경로를 요청합니다.

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

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

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

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

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

ComputeRoutesExtraComputation 상수

상수 google.maps.routes.ComputeRoutesExtraComputation
라이브러리 "routes"

요청을 완료하는 동안 수행할 추가 계산입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 ComputeRoutesExtraComputationString 유형으로 정의됩니다.

const {ComputeRoutesExtraComputation} = await google.maps.importLibrary("routes");
FLYOVER_INFO_ON_POLYLINE 경로의 플라이오버 정보입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.
FUEL_CONSUMPTION 경로의 예상 연료 소비량입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS 자세한 내용은 웹 서비스 문서를 참고하세요.
NARROW_ROAD_INFO_ON_POLYLINE 경로의 좁은 도로 정보입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.
TOLLS 경로의 통행료 정보입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.
TRAFFIC_ON_POLYLINE 경로의 트래픽 인식 다중선입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.

CreateWaypointMarkersOptions 인터페이스

인터페이스 google.maps.routes.CreateWaypointMarkersOptions<T = MarkerElement|Marker3DElement|MarkerInteractiveElement|Marker3DInteractiveElement>

경유지 마커를 만들기 위한 옵션입니다.

forEach
선택사항
유형: function(T): void optional
생성된 요소를 변경하는 커스텀 함수입니다. 기본 forEach 함수는 각 마커에 A~Z 글리프가 있는 핀을 추가합니다. 다른 동작을 원한다면 이 함수를 재정의하세요.
markerClass
선택사항
유형: new () => T optional
만들 요소의 생성자입니다. 지원되는 유형은 다음과 같습니다.

DirectionalLocationLiteral 인터페이스

interface google.maps.routes.DirectionalLocationLiteral extends LatLngAltitudeLiteral, LatLngLiteral
implemented by DirectionalLocation

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

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

DirectionalLocation 클래스

class google.maps.routes.DirectionalLocation extends LatLngAltitude implements DirectionalLocationLiteral, LatLngAltitudeLiteral, LatLngLiteral
library "routes"

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

const {DirectionalLocation} = await google.maps.importLibrary("routes");
상속됨: LatLngAltitude
heading
readonly
유형: number optional
교통 흐름의 방향과 연결된 나침반 방향입니다. 방향 값은 0에서 360 사이의 숫자일 수 있습니다. 여기서 0은 정북 방향을, 90은 정동 방향을 지정합니다. 이 필드는 DRIVING 및 TWO_WHEELER ComputeRoutesRequest.travelMode에만 사용할 수 있습니다.
상속됨: altitude, lat, lng
toJSON
toJSON([key])
매개변수:
  • key: string optional
일반 객체로 변환합니다.
상속됨: equals

FallbackInfo 클래스

google.maps.routes.FallbackInfo 클래스
라이브러리 "routes"

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

const {FallbackInfo} = await google.maps.importLibrary("routes");
reason
readonly
유형: FallbackReason optional
원래 응답 대신 대체 응답이 사용된 이유입니다. 이 필드는 대체 모드가 트리거되고 대체 응답이 반환될 때만 채워집니다.
routingMode
readonly
유형: FallbackRoutingMode optional
응답에 사용되는 경로 지정 모드입니다. 대체 모드가 트리거된 경우 모드가 원래 클라이언트 요청에 설정된 경로 설정과 다를 수 있습니다.
상속됨: toJSON

FallbackReason 상수

상수 google.maps.routes.FallbackReason
라이브러리 "routes"

대체 응답을 사용하는 이유입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 FallbackReasonString 유형으로 정의됩니다.

const {FallbackReason} = await google.maps.importLibrary("routes");
LATENCY_EXCEEDED 선호하는 경로 모드로 계산을 제시간에 완료할 수 없었지만 대체 모드로 계산된 결과를 반환할 수 있었습니다. 자세한 내용은 웹 서비스 문서를 참고하세요.
SERVER_ERROR 선호하는 경로 모드로 경로를 계산하는 중에 서버 오류가 발생했지만 대체 모드로 계산된 결과를 반환할 수 있었습니다. 자세한 내용은 웹 서비스 문서를 참고하세요.

FallbackRoutingMode 상수

상수 google.maps.routes.FallbackRoutingMode
라이브러리 "routes"

반환된 대체 응답에 사용된 실제 라우팅 모드입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 FallbackRoutingModeString 유형으로 정의됩니다.

const {FallbackRoutingMode} = await google.maps.importLibrary("routes");
TRAFFIC_AWARE 자세한 내용은 웹 서비스 문서를 참고하세요.
TRAFFIC_UNAWARE 자세한 내용은 웹 서비스 문서를 참고하세요.

GeocodedWaypoint 클래스

google.maps.routes.GeocodedWaypoint 클래스
라이브러리 "routes"

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

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

GeocodingResults 클래스

google.maps.routes.GeocodingResults 클래스
라이브러리 "routes"

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

const {GeocodingResults} = await google.maps.importLibrary("routes");
destination
readonly
유형: GeocodedWaypoint optional
목적지의 지오코딩된 경유지입니다.
intermediates
readonly
유형: Array<GeocodedWaypoint> optional
지오코딩된 중간 경유지 목록으로, 각 경유지에는 요청에 지정된 순서대로 경유지의 0부터 시작하는 위치에 해당하는 색인 필드가 포함됩니다.
origin
readonly
유형: GeocodedWaypoint optional
출발지의 지오코딩된 경유지입니다.
상속됨: toJSON

MultiModalSegment 클래스

google.maps.routes.MultiModalSegment 클래스
라이브러리 "routes"

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

const {MultiModalSegment} = await google.maps.importLibrary("routes");
instructions
readonly
유형: string optional
이 멀티모달 세그먼트를 탐색하기 위한 안내입니다.
maneuver
readonly
유형: string optional
이 단계에서 수행할 내비게이션 조작입니다. 가능한 값 목록은 Maneuver를 참고하세요.
stepEndIndex
readonly
유형: number
멀티모달 세그먼트의 끝인 해당 RouteLegStep 색인입니다.
stepStartIndex
readonly
유형: number
멀티모달 세그먼트의 시작인 해당 RouteLegStep 색인입니다.
travelMode
readonly
유형: TravelMode optional
이 멀티모달 세그먼트에 사용되는 이동 수단입니다.
상속됨: toJSON

PolylineDetailInfo 클래스

google.maps.routes.PolylineDetailInfo 클래스
라이브러리 "routes"

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

const {PolylineDetailInfo} = await google.maps.importLibrary("routes");
endIndex
readonly
유형: number optional
다중선에서 이 도로 지형지물의 종료 색인입니다.
presence
readonly
유형: RoadFeatureState optional
다중선을 따라 도로 지형지물이 있는지 여부를 나타냅니다.
startIndex
readonly
유형: number optional
다중선에 있는 이 도로 지형지물의 시작 색인입니다.
상속됨: toJSON

PolylineDetails 클래스

google.maps.routes.PolylineDetails 클래스
라이브러리 "routes"

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

const {PolylineDetails} = await google.maps.importLibrary("routes");
flyoverInfo
readonly
다중선을 따라 표시되는 플라이오버 세부정보입니다.
narrowRoadInfo
readonly
다중선을 따라 좁은 도로 세부정보입니다.
상속됨: toJSON

PolylineQuality 상수

상수 google.maps.routes.PolylineQuality
라이브러리 "routes"

다중선의 품질을 지정하는 값 집합입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 PolylineQualityString 유형으로 정의됩니다.

const {PolylineQuality} = await google.maps.importLibrary("routes");
HIGH_QUALITY 고품질 다중선을 지정합니다. 이 다중선은 OVERVIEW보다 많은 포인트를 사용하여 구성되며 응답 크기가 증가합니다. 자세한 내용은 웹 서비스 문서를 참고하세요.
OVERVIEW 소수의 포인트를 사용하여 구성된 개요 다중선을 지정합니다. 자세한 내용은 웹 서비스 문서를 참고하세요.

ReferenceRoute 상수

상수 google.maps.routes.ReferenceRoute
라이브러리 "routes"

ComputeRoutesRequest에서 지원되는 참조 경로입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 ReferenceRouteString 유형으로 정의됩니다.

const {ReferenceRoute} = await google.maps.importLibrary("routes");
FUEL_EFFICIENT 연비 최적 경로 자세한 내용은 웹 서비스 문서를 참고하세요.
SHORTER_DISTANCE 이동 거리가 더 짧은 경로입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.

RoadFeatureState 상수

상수 google.maps.routes.RoadFeatureState
라이브러리 "routes"

다중선 구간을 따라 도로 지형지물의 상태를 캡슐화합니다. 자세한 내용은 웹 서비스 문서를 참고하세요.

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 RoadFeatureStateString 유형으로 정의됩니다.

const {RoadFeatureState} = await google.maps.importLibrary("routes");
DOES_NOT_EXIST 도로 지형지물이 존재하지 않습니다. 자세한 내용은 웹 서비스 문서를 참고하세요.
EXISTS 도로 지형지물이 존재합니다. 자세한 내용은 웹 서비스 문서를 참고하세요.

RouteLabel 상수

상수 google.maps.routes.RouteLabel
라이브러리 "routes"

자세한 내용은 웹 서비스 문서를 참고하세요.

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 RouteLabelString 유형으로 정의됩니다.

const {RouteLabel} = await google.maps.importLibrary("routes");
DEFAULT_ROUTE 경로 계산에 반환되는 기본 '최적' 경로입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.
DEFAULT_ROUTE_ALTERNATE 기본 '최적' 경로의 대안입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.
FUEL_EFFICIENT 연비 최적 경로 자세한 내용은 웹 서비스 문서를 참고하세요.
SHORTER_DISTANCE 이동 거리가 더 짧은 경로입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.

RouteLeg 클래스

google.maps.routes.RouteLeg 클래스
라이브러리 "routes"

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

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

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

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

RouteLegLocalizedValues 클래스

google.maps.routes.RouteLegLocalizedValues 클래스
라이브러리 "routes"

RouteLeg의 텍스트 표현입니다.

const {RouteLegLocalizedValues} = await google.maps.importLibrary("routes");
distance
readonly
유형: string optional
텍스트 형식의 경로 구간 이동 거리입니다.
distanceLanguage
readonly
유형: string optional
거리 텍스트의 BCP-47 언어 코드입니다(예: 'en-US' 또는 'sr-Latn').

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

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

RouteLegStep 클래스

google.maps.routes.RouteLegStep 클래스
라이브러리 "routes"

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

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

참고: 기간이 2^53밀리초를 초과하면 이 값은 Number.POSITIVE_INFINITY입니다.
transitDetails
readonly
유형: TransitDetails optional
이동 수단이 TRANSIT인 경우 이 단계와 관련된 세부정보입니다.
travelMode
readonly
유형: TravelMode optional
이 단계에 사용된 이동 수단입니다.
상속됨: toJSON

RouteLegStepLocalizedValues 클래스

google.maps.routes.RouteLegStepLocalizedValues 클래스
라이브러리 "routes"

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

const {RouteLegStepLocalizedValues} = await google.maps.importLibrary("routes");
distance
readonly
유형: string optional
경로 구간 단계의 이동 거리(텍스트 형식)입니다.
distanceLanguage
readonly
유형: string optional
거리 텍스트의 BCP-47 언어 코드입니다(예: 'en-US' 또는 'sr-Latn').

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

자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참고하세요.
상속됨: toJSON

RouteLegTravelAdvisory 클래스

google.maps.routes.RouteLegTravelAdvisory 클래스
라이브러리 "routes"

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

const {RouteLegTravelAdvisory} = await google.maps.importLibrary("routes");
speedReadingIntervals
readonly
유형: 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
readonly
유형: TollInfo optional
특정 RouteLeg의 통행료에 관한 정보가 포함되어 있습니다. 이 필드는 RouteLeg에 통행료가 예상되는 경우에만 채워집니다. 이 필드가 설정되어 있지만 TollInfo.estimatedPrices가 채워지지 않은 경우 경로 구간에 통행료가 포함되지만 예상 가격은 알 수 없습니다. 이 필드가 비어 있으면 RouteLeg에 통행료가 없습니다.
상속됨: toJSON

RouteLocalizedValues 클래스

google.maps.routes.RouteLocalizedValues 클래스
라이브러리 "routes"

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

const {RouteLocalizedValues} = await google.maps.importLibrary("routes");
distance
readonly
유형: string optional
텍스트 형식으로 표현된 경로의 이동 거리입니다.
distanceLanguage
readonly
유형: string optional
거리 텍스트의 BCP-47 언어 코드입니다(예: 'en-US' 또는 'sr-Latn').

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

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

RouteModifiers 인터페이스

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

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

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

RoutePolyline3DOptions 인터페이스

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

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

polylineOptions
선택사항
3D 다중선의 스타일을 맞춤설정하는 옵션입니다.
trafficPolylinesDisabled
선택사항
유형: boolean optional
교통정보를 반영하는 다중선을 사용 중지할지 여부입니다. 트래픽 인식 다중선은 routingPreference가 TRAFFIC_AWARE 또는 TRAFFIC_AWARE_OPTIMAL로 설정된 경우에만 사용할 수 있습니다.

RoutePolylineDetails 인터페이스

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

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

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

RoutePolylineOptions 인터페이스

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

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

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

RouteTravelAdvisory 클래스

google.maps.routes.RouteTravelAdvisory 클래스
라이브러리 "routes"

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

const {RouteTravelAdvisory} = await google.maps.importLibrary("routes");
fuelConsumptionMicroliters
readonly
유형: number optional
예상 연료 소비량(마이크로리터)입니다.

참고: 연료 소비량이 2^53마이크로리터를 초과하면 이 값은 Number.POSITIVE_INFINITY입니다.
routeRestrictionsPartiallyIgnored
readonly
유형: boolean optional
Route에 요청된 이동 수단 또는 경로 수정자에 적합하지 않은 제한사항이 있을 수 있습니다.
speedReadingIntervals
readonly
유형: 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
readonly
유형: TollInfo optional
Route의 통행료에 관한 정보가 포함됩니다. 이 필드는 Route에 통행료가 예상되는 경우에만 채워집니다. 이 필드가 설정되어 있지만 TollInfo.estimatedPrices가 채워지지 않은 경우 경로에 통행료가 포함되지만 예상 가격은 알 수 없습니다. 이 필드가 비어 있으면 Route에 통행료가 없습니다.
transitFare
readonly
유형: Money optional
제공된 경우 이 Route의 총요금 또는 티켓 비용이 포함됩니다. 이 속성은 TRANSIT ComputeRoutesRequest.travelMode 및 모든 대중교통 단계에 대해 요금 정보를 사용할 수 있는 경로의 경우에만 반환됩니다.
상속됨: toJSON

RoutingPreference 상수

상수 google.maps.routes.RoutingPreference
라이브러리 "routes"

경로를 계산할 때 고려해야 할 요소를 지정하는 값 집합입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 RoutingPreferenceString 유형으로 정의됩니다.

const {RoutingPreference} = await google.maps.importLibrary("routes");
TRAFFIC_AWARE 실시간 교통 상황을 고려하여 경로를 계산합니다. 자세한 내용은 웹 서비스 문서를 참고하세요.
TRAFFIC_AWARE_OPTIMAL 대부분의 성능 최적화를 적용하지 않고 실시간 교통 상황을 고려하여 경로를 계산합니다. 자세한 내용은 웹 서비스 문서를 참고하세요.
TRAFFIC_UNAWARE 실시간 교통 상황을 고려하지 않고 경로를 계산합니다. 자세한 내용은 웹 서비스 문서를 참고하세요.

속도 상수

상수 google.maps.routes.Speed
라이브러리 "routes"

교통정보 데이터를 기반으로 한 다중선 속도 분류입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 SpeedString 유형으로 정의됩니다.

const {Speed} = await google.maps.importLibrary("routes");
NORMAL 정상 속도, 교통 지연 없음 자세한 내용은 웹 서비스 문서를 참고하세요.
SLOW 서행이 감지되었습니다. 트래픽이 보통입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.
TRAFFIC_JAM 교통 지연 자세한 내용은 웹 서비스 문서를 참고하세요.

SpeedPath 인터페이스

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

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

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

SpeedReadingInterval 클래스

google.maps.routes.SpeedReadingInterval 클래스
라이브러리 "routes"

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

const {SpeedReadingInterval} = await google.maps.importLibrary("routes");
endPolylinePointIndex
readonly
유형: number optional
다중선에서 이 간격의 종료 색인입니다.
speed
readonly
유형: Speed optional
이 간격의 트래픽 속도입니다.
startPolylinePointIndex
readonly
유형: number optional
다중선에서 이 간격의 시작 색인입니다.

StepsOverview 클래스

google.maps.routes.StepsOverview 클래스
라이브러리 "routes"

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

const {StepsOverview} = await google.maps.importLibrary("routes");
multiModalSegments
readonly
RouteLeg.steps의 다양한 멀티모달 세그먼트에 대한 요약 정보입니다.
상속됨: toJSON

TollInfo 클래스

google.maps.routes.TollInfo 클래스
라이브러리 "routes"

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

const {TollInfo} = await google.maps.importLibrary("routes");
estimatedPrices
readonly
유형: Array<Money> optional
해당 Route 또는 RouteLeg의 통행료 금액입니다. 이 목록에는 통행료 정산소에서 청구할 것으로 예상되는 각 통화의 금액이 포함됩니다. 일반적으로 이 목록에는 단일 통화로 통행료가 부과되는 경로의 항목이 하나만 포함됩니다. 국제 여행의 경우 이 목록에는 다양한 통화의 통행료를 반영하는 여러 항목이 포함될 수 있습니다. 통행료가 예상되지만 예상 가격을 알 수 없는 경우 이 필드는 빈 배열일 수 있습니다.
상속됨: toJSON

TransitAgency 클래스

google.maps.routes.TransitAgency 클래스
라이브러리 "routes"

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

const {TransitAgency} = await google.maps.importLibrary("routes");
name
readonly
유형: string optional
이 대중교통 기관의 이름입니다.
phoneNumber
readonly
유형: string optional
대중교통 기관의 언어별 형식의 전화번호입니다.
url
readonly
유형: URL optional
대중교통 기관의 URL입니다.
상속됨: toJSON

TransitDetails 클래스

google.maps.routes.TransitDetails 클래스
라이브러리 "routes"

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

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

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

TransitLine 클래스

google.maps.routes.TransitLine 클래스
라이브러리 "routes"

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

const {TransitLine} = await google.maps.importLibrary("routes");
agencies
readonly
이 대중교통 노선을 운영하는 대중교통 기관입니다.
color
readonly
유형: string optional
이 노선의 표지판에 흔히 사용되는 색상입니다. 16진수로 표시됩니다.
iconURL
readonly
유형: URL optional
이 노선과 연결된 아이콘의 URL입니다.
name
readonly
유형: string optional
대중교통 노선의 전체 이름입니다(예: '8 Avenue Local').
shortName
readonly
유형: string optional
이 대중교통 노선의 짧은 이름입니다. 이 이름은 일반적으로 'M7' 또는 '355'와 같은 노선 번호입니다.
textColor
readonly
유형: string optional
이 노선의 표지판에 흔히 사용되는 텍스트의 색상입니다. 16진수로 표시됩니다.
url
readonly
유형: URL optional
대중교통 기관에서 제공하는 대중교통 노선의 URL입니다.
vehicle
readonly
유형: TransitVehicle optional
이 대중교통 노선에서 운행되는 운송 수단의 유형입니다.
상속됨: toJSON

TransitPreference 인터페이스

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

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

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

TransitStop 클래스

google.maps.routes.TransitStop 클래스
라이브러리 "routes"

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

const {TransitStop} = await google.maps.importLibrary("routes");
location
readonly
유형: DirectionalLocation optional
위도/경도 좌표와 선택적 방향으로 표현된 정류장 위치입니다.
name
readonly
유형: string optional
대중교통 정류장의 이름입니다.
상속됨: toJSON

TransitVehicle 클래스

google.maps.routes.TransitVehicle 클래스
라이브러리 "routes"

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

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

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

가능한 값 목록은 https://developers.google.com/maps/documentation/routes/reference/rpc/google.maps.routing.v2#transitvehicletype을 참고하세요.
상속됨: toJSON

VehicleEmissionType 상수

상수 google.maps.routes.VehicleEmissionType
라이브러리 "routes"

차량의 배출 유형을 설명하는 값 집합입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 VehicleEmissionTypeString 유형으로 정의됩니다.

const {VehicleEmissionType} = await google.maps.importLibrary("routes");
DIESEL 디젤 연료 차량입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.
ELECTRIC 전기 구동 차량입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.
GASOLINE 휘발유/석유 연료 차량입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.
HYBRID 하이브리드 연료 (예: 휘발유 + 전기) 차량입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.

VehicleInfo 인터페이스

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

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

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

Waypoint 인터페이스

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

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

location
경유지의 위치입니다. 문자열은 주소, Plus Code 또는 장소 리소스 이름일 수 있습니다.
sideOfRoad
선택사항
유형: boolean optional
이 경유지의 위치가 차량이 도로의 특정 측면에 정차하는 것을 선호함을 나타냅니다. 이 값을 설정하면 경로가 위치를 통과하므로 차량이 도로 중앙에서 위치가 치우친 도로변에 정차할 수 있습니다. 이 옵션은 DRIVING 및 TWO_WHEELER ComputeRoutesRequest.travelMode에만 적용됩니다.
vehicleStopover
선택사항
유형: boolean optional
차량이 승차 또는 하차를 위해 정차하는 경유지임을 나타냅니다. 이 값을 설정하면 계산된 경로에 승차 및 하차에 적합하지 않은 도로의 via 이외의 경유지가 포함되지 않습니다. 이 옵션은 DRIVING 및 TWO_WHEELER ComputeRoutesRequest.travelMode에만 작동하며 Waypoint.location가 string 또는 Place가 아닌 경우에만 작동합니다.
via
선택사항
유형: 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
선택사항
유형: RouteLeg optional
마커가 속한 구간입니다. 경로에 구간이 없으면 비어 있습니다.