Route 클래스
google.maps.routes.Route 클래스
시작, 종료, 중간 경유지를 연결하는 일련의 연결된 도로 구간으로 구성된 경로를 포함합니다.
const {Route} = await google.maps.importLibrary("routes")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
정적 메소드 | |
|---|---|
computeRoutes |
computeRoutes(request)매개변수:
반환 값:
Promise<{일련의 터미널 및 중간 경유지가 주어지면 기본 경로와 선택적 대체 경로를 반환합니다. 참고: 이 메서드를 사용하려면 ComputeRoutesRequest.fields 속성을 설정하여 요청에 응답 필드 마스크를 지정해야 합니다. 값은 필드 경로 목록입니다. 예를 들면 다음과 같습니다.
다음과 같은 이유로 와일드 카드 응답 필드 마스크 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 |
경로를 구성하는 구간 (경유지 간 경로 세그먼트)의 모음입니다. 각 구간은 두 개의 비 via 경유지 사이의 이동에 해당합니다. 예를 들면 다음과 같습니다.
origin에서 intermediates, destination로 이어지는 경유지의 순서와 일치합니다. |
localizedValues |
유형:
RouteLocalizedValues optionalRoute의 속성을 텍스트로 표현한 것입니다. |
optimizedIntermediateWaypointIndices |
유형:
Array<number> optionalComputeRoutesRequest.optimizeWaypointOrder를 true로 설정하면 이 필드에 최적화된 중간 경유지 순서가 포함됩니다. 그렇지 않으면 이 필드는 비어 있습니다. 색인은 입력에 제공된 첫 번째 중간 경유지에 대해 0부터 시작합니다. 예를 들어 다음과 같이 입력하는 경우:
[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 |
경로의 섹션과 해당 속도 판독값의 그룹화입니다. 이 필드를 채우려면 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])매개변수:
사용 가능한 데이터를 기반으로 경로의 폴리라인을 만듭니다. 멀티모달 다중선:
교통 다중선:
전체 다중선:
|
createWaypointAdvancedMarkers |
createWaypointAdvancedMarkers([options])매개변수:
반환 값:
Promise<Array<AdvancedMarkerElement>>각 경유지에 대해 '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 |
유형:
Iterable<ComputeRoutesExtraComputation> optional요청을 완료하는 데 사용할 수 있는 추가 계산 목록입니다. 참고: 이러한 추가 계산으로 인해 응답에 추가 필드가 반환될 수 있습니다. 이러한 추가 필드는 응답에 반환되도록 ComputeRoutesRequest.fields에도 지정해야 합니다. |
intermediates optional |
경로를 따라 정차하거나 통과할 수 있는 경유지 집합입니다 (터미널 지점 제외). 최대 25개의 중간 경유지가 지원됩니다. |
language optional |
유형:
string optionalBCP-47 언어 코드(예: 'en-US' 또는 'sr-Latn') 자세한 내용은 유니코드 언어 식별자를 참고하세요. 지원되는 언어 목록은 언어 지원을 참고하세요. 이 값을 제공하지 않으면 언어가 Google Maps JavaScript API 현지화 설정에서 추론됩니다. 그렇지 않으면 언어가 출처의 위치에서 추론됩니다. |
optimizeWaypointOrder optional |
유형:
boolean optionaltrue로 설정하면 서비스는 지정된 중간 경유지를 재정렬하여 경로의 전체 비용을 최소화하려고 시도합니다. 중간 경유지가 경유지인 경우 요청이 실패합니다. 대답에서 Route.optimizedIntermediateWaypointIndices을 사용하여 새로운 순서를 찾습니다. ComputeRoutesRequest.fields에서 "optimizedIntermediateWaypointIndices"를 요청하지 않으면 요청이 실패합니다. false로 설정되면 응답의 Route.optimizedIntermediateWaypointIndices가 비어 있습니다. |
polylineQuality optional |
유형:
PolylineQuality optional폴리라인 품질에 대한 환경설정을 지정합니다. |
region optional |
유형:
string optionalccTLD ('최상위 도메인') 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 optionalTRANSIT 경로에 반환되는 경로에 영향을 미치는 환경설정을 지정합니다. 참고: 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응답에 사용된 라우팅 모드입니다. 대체가 트리거된 경우 모드가 원래 클라이언트 요청에 설정된 라우팅 환경설정과 다를 수 있습니다. |
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 |
유형:
Array<PolylineDetailInfo>다중선을 따라 오버플라이 세부정보입니다. |
narrowRoadInfo |
유형:
Array<PolylineDetailInfo>다중선을 따라 좁은 도로 세부정보입니다. |
메서드 | |
|---|---|
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 optionalRouteLeg의 속성을 텍스트로 표현한 것입니다. |
path |
유형:
Array<LatLngAltitude>경로 구간의 LatLngAltitude 목록입니다. 경로 구간 다중선을 그리는 데 사용할 수 있습니다. 경로의 세부사항은 ComputeRoutesRequest.polylineQuality을 설정하여 제어할 수 있습니다. |
speedPaths |
경로 구간 경로의 섹션 그룹과 해당 속도 판독값입니다. 이 필드를 채우려면 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 optionalRouteLegStep의 속성을 텍스트로 표현한 것입니다. |
maneuver |
유형:
string optional이 단계에서 실행할 탐색 동작입니다. 가능한 값 목록은 Maneuver를 참고하세요. |
path |
유형:
Array<LatLngAltitude>경로 구간 단계를 그리는 데 사용할 수 있는 경로 구간 단계의 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의 전체 폴리라인을 포함합니다. 지정된 간격의 시작점은 이전 간격의 종료점과 동일합니다. 예: |
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 |
avoidHighways optional |
유형:
boolean optional |
avoidIndoor optional |
유형:
boolean optional |
avoidTolls optional |
유형:
boolean optional |
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|(function(PolylineOptions, RoutePolylineDetails): 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 optionalRoute에 요청된 이동 모드 또는 경로 수정자에 적합하지 않은 제한이 있을 수 있습니다. |
speedReadingIntervals |
유형:
Array<SpeedReadingInterval> optional트래픽 밀도를 자세히 설명하는 속도 읽기 간격 TRAFFIC_AWARE 및 TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routingPreference의 경우에 적용됩니다. 인터벌은 겹침 없이 Route의 전체 폴리라인을 포함합니다. 지정된 간격의 시작점은 이전 간격의 종료점과 동일합니다. 예: |
tollInfo |
유형:
TollInfo optionalRoute의 통행료에 관한 정보를 포함합니다. 이 필드는 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 |
유형:
Array<LatLngAltitude>이 속도 경로가 포함하는 경로입니다. |
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()매개변수: 없음
반환 값: None
객체로 변환합니다. |
StepsOverview 클래스
google.maps.routes.StepsOverview 클래스
RouteLeg.steps 목록에 관한 개요 정보를 제공합니다.
const {StepsOverview} = await google.maps.importLibrary("routes")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
속성 | |
|---|---|
multiModalSegments |
유형:
Array<MultiModalSegment>RouteLeg.steps의 다양한 멀티모달 세그먼트에 관한 요약 정보입니다. |
메서드 | |
|---|---|
toJSON |
toJSON()매개변수: 없음
반환 값:
Object객체로 변환합니다. |
TollInfo 클래스
google.maps.routes.TollInfo 클래스
Route 또는 RouteLeg의 통행료 정보를 캡슐화합니다.
const {TollInfo} = await google.maps.importLibrary("routes")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
속성 | |
|---|---|
estimatedPrices |
|
메서드 | |
|---|---|
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'은 평일 오후 3시 10분에 캘리포니아주 새너제이에서 캘리포니아주 새크라멘토로 출발하는 Amtrak 열차의 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> optionalTRANSIT 경로를 가져올 때 사용할 이동 수단 집합입니다. 기본값은 지원되는 모든 이동 수단입니다. |
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 |
경유지의 위치입니다. 문자열은 주소, 플러스 코드 또는 장소 리소스 이름일 수 있습니다. |
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 배열에 항목을 추가하지는 않지만 경유지를 통해 여정을 라우팅합니다. 참고:
|
WaypointMarkerDetails 인터페이스
google.maps.routes.WaypointMarkerDetails
인터페이스
마커 스타일을 맞춤설정하는 데 사용할 수 있는 경유지에 관한 세부정보입니다.
속성 | |
|---|---|
index |
유형:
number마커의 색인입니다. |
totalMarkers |
유형:
number경로의 총 마커 수입니다. |
leg optional |
유형:
RouteLeg optional마커가 속한 구간입니다. 경로에 구간이 없는 경우 비어 있습니다. |