Directions

DirectionsService 클래스

google.maps.DirectionsService 클래스

둘 이상의 장소 사이에서 길찾기를 계산하는 서비스입니다.

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

DirectionsService
DirectionsService()
매개변수: 없음
Google 서버에 경로 쿼리를 보내는 DirectionsService의 새 인스턴스를 만듭니다.
route
route(request[, callback])
매개변수: 
반환 값:  Promise<DirectionsResult>
길찾기 검색을 요청합니다.

DirectionsRequest 인터페이스

google.maps.DirectionsRequest 인터페이스

DirectionsService로 보낼 경로 쿼리입니다.

destination
유형:  string|LatLng|Place|LatLngLiteral
목적지 위치입니다. 지오코딩될 문자열, LatLng 또는 Place로 지정할 수 있습니다. 필수 항목입니다.
origin
유형:  string|LatLng|Place|LatLngLiteral
출발지 위치입니다. 지오코딩될 문자열, LatLng 또는 Place로 지정할 수 있습니다. 필수 항목입니다.
travelMode
유형:  TravelMode
요청된 경로 유형입니다. 필수 항목입니다.
avoidFerries optional
유형:  boolean optional
true인 경우 가능하면 페리를 제외하도록 경로 서비스에 지시합니다. 선택사항입니다.
avoidHighways optional
유형:  boolean optional
true인 경우 가능하면 고속도로를 제외하도록 경로 서비스에 지시합니다. 선택사항입니다.
avoidTolls optional
유형:  boolean optional
true인 경우 가능하면 유료 도로를 제외하도록 경로 서비스에 지시합니다. 선택사항입니다.
drivingOptions optional
유형:  DrivingOptions optional
travelModeDRIVING인 요청에만 적용되는 설정 이 객체는 다른 이동 모드에 영향을 미치지 않습니다.
language optional
유형:  string optional
가능한 경우 결과를 반환할 때 사용할 언어의 언어 식별자입니다. 지원 언어 목록을 참조하세요.
optimizeWaypoints optional
유형:  boolean optional
true로 설정하면 DirectionsService는 경로상의 전반적인 비용을 최소화하기 위해 제공된 중간 경유지를 다시 정렬하려고 시도합니다. 경유지가 최적화된 경우 응답의 DirectionsRoute.waypoint_order를 검사하여 새 순서를 결정합니다.
provideRouteAlternatives optional
유형:  boolean optional
대체 경로 제공 여부를 지정합니다. 선택사항입니다.
region optional
유형:  string optional
지오코딩 요청에 대한 바이어스로 사용되는 지역 코드입니다. 지역 코드는 ccTLD ('최상위 도메인') 두 문자 값을 허용합니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하며, 몇몇 눈에 띄는 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk' (.co.uk)인 반면 ISO 3166-1 코드는 'gb'입니다(기술적으로 '영국 및 북아일랜드'의 경우).
transitOptions optional
유형:  TransitOptions optional
travelMode가 Transit인 요청에만 적용되는 설정 이 객체는 다른 이동 모드에 영향을 미치지 않습니다.
unitSystem optional
유형:  UnitSystem optional
기본값: 원산지에서 사용되는 단위 체계입니다.
거리를 표시하는 데 사용할 기본 단위 체계입니다.
waypoints optional
유형:  Array<DirectionsWaypoint> optional
중간 경유지의 배열입니다. 길찾기는 이 배열의 각 경유지를 거쳐 출발지에서 목적지까지 계산됩니다. 허용되는 최대 경유지 수는 개발자 가이드를 참고하세요. 대중교통 경로에서는 경유지를 사용할 수 없습니다. 선택사항입니다.

DirectionsStatus 상수

google.maps.DirectionsStatus 상수

route()의 호출 완료 시 DirectionsService에서 반환한 상태입니다. 값 또는 상수 이름을 사용하여 지정합니다. 예를 들어 'OK' 또는 google.maps.DirectionsStatus.OK입니다.

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

INVALID_REQUEST 제공된 DirectionsRequest이(가) 잘못되었습니다.
MAX_WAYPOINTS_EXCEEDED DirectionsRequest에서 너무 많은 DirectionsWaypoint를 제공했습니다. 허용되는 최대 경유지 수는 개발자 가이드를 참고하세요.
NOT_FOUND 출발지, 목적지 또는 경유지 중 적어도 하나를 지오코딩하지 못했습니다.
OK 응답에 유효한 DirectionsResult가 포함되어 있습니다.
OVER_QUERY_LIMIT 웹페이지가 너무 짧은 시간 내에 요청 한도를 초과했습니다.
REQUEST_DENIED 웹페이지에서 길찾기 서비스를 사용할 수 없습니다.
UNKNOWN_ERROR 서버 오류로 인해 길찾기 요청을 처리하지 못했습니다. 다시 시도하면 요청이 성공할 수도 있습니다.
ZERO_RESULTS 출발지와 목적지 사이에서 경로를 찾지 못했습니다.

DirectionsResult 인터페이스

google.maps.DirectionsResult 인터페이스

길찾기 서버에서 가져온 길찾기 응답입니다. DirectionsRenderer를 사용하여 렌더링하거나 이 객체를 파싱하여 직접 렌더링할 수 있습니다. Google Maps Platform 서비스 약관에 명시된 대로 경고와 저작권을 표시해야 합니다. 이 결과는 'JSON'과 비슷하지만 간접적으로 LatLng 객체를 포함하기 때문에 엄격하게 JSON은 아닙니다.

routes
DirectionsRoute의 배열로, 각각은 구성된 구간과 단계에 대한 정보를 포함합니다. provideRouteAlternativestrue로 설정된 DirectionsRequest를 사용하지 않는 경우 경로는 하나만 생성됩니다.
available_travel_modes optional
유형:  Array<TravelMode> optional
사용 가능한 이동 모드의 배열을 포함합니다. 이 필드는 요청이 이동 모드를 지정하고 결과를 얻지 못할 때 반환됩니다. 해당 배열에는 지정된 경유지 집합의 국가에서 사용 가능한 이동 모드가 포함됩니다. 이 필드는 하나 이상의 경유지가 '경유지'인 경우 반환되지 않습니다.
geocoded_waypoints optional
유형:  Array<DirectionsGeocodedWaypoint> optional
DirectionsGeocodedWaypoint로 구성된 배열이며, 각 배열에는 출발지, 목적지 및 경유지의 지오코딩에 대한 정보가 포함됩니다.

DirectionsRenderer 클래스

google.maps.DirectionsRenderer 클래스

DirectionsService에서 가져온 경로를 렌더링합니다.

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

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

DirectionsRenderer
DirectionsRenderer([opts])
매개변수: 
지정된 옵션으로 렌더러를 만듭니다. 경로는 시각적 오버레이로 지도에 렌더링하거나 <div> 패널에서 텍스트 안내로 렌더링됩니다.
getDirections
getDirections()
매개변수: 없음
반환 값:  DirectionsResult
렌더러의 현재 길찾기 집합을 반환합니다.
getMap
getMap()
매개변수: 없음
반환 값:  Map
DirectionsResult가 렌더링되는 지도를 반환합니다.
getPanel
getPanel()
매개변수: 없음
반환 값:  HTMLElement|null
DirectionsResult가 렌더링되는 패널 <div>를 반환합니다.
getRouteIndex
getRouteIndex()
매개변수: 없음
반환 값:  number
DirectionsRenderer 객체에서 사용 중인 현재 (0부터 시작) 경로 색인을 반환합니다.
setDirections
setDirections(directions)
매개변수: 
반환 값: 없음
DirectionsService의 결과를 사용하도록 렌더기를 설정합니다. 이 방법으로 유효한 길찾기 집합을 설정하면 렌더러에서 지정한 지도와 패널에 길찾기가 표시됩니다.
setMap
setMap(map)
매개변수: 
반환 값: 없음
이 방법은 길찾기를 렌더링할 지도를 지정합니다. null를 전달하여 지도에서 경로를 삭제합니다.
setOptions
setOptions(options)
매개변수: 
반환 값: 없음
초기화 후에 이 DirectionsRenderer의 옵션 설정을 변경합니다.
setPanel
setPanel(panel)
매개변수: 
반환 값: 없음
이 메서드는 <div>에서 경로를 렌더링합니다. null를 전달하여 패널에서 콘텐츠를 삭제합니다.
setRouteIndex
setRouteIndex(routeIndex)
매개변수: 
  • routeIndexnumber
반환 값: 없음
렌더링할 DirectionsResult 객체에 0부터 시작하는 경로 색인을 설정합니다. 기본적으로 배열의 첫 번째 경로가 렌더링됩니다.
상속됨: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
directions_changed
function()
인수: 없음
이 이벤트는 렌더링된 경로가 변경되면 새 DirectionsResult가 설정되거나 사용자가 변경사항을 경로 경로로 드래그하면 완료됩니다.

DirectionsRendererOptions 인터페이스

google.maps.DirectionsRendererOptions 인터페이스

이 객체는 DirectionsRenderer 객체에 설정할 수 있는 속성을 정의합니다.

directions optional
유형:  DirectionsResult optional
DirectionsService에서 DirectionsResult 객체로 가져와 지도 또는 <div> 패널에 표시할 경로입니다.
draggable optional
유형:  boolean optional
true인 경우 사용자가 이 DirectionsRenderer에서 렌더링된 경로를 드래그하고 수정하도록 허용합니다.
hideRouteList optional
유형:  boolean optional
기본값: false
이 속성은 렌더러가 경로 패널에 표시된 사용자가 선택할 수 있는 경로 목록을 제공해야 하는지 여부를 나타냅니다.
infoWindow optional
유형:  InfoWindow optional
마커를 클릭하면 텍스트 정보를 렌더링할 InfoWindow입니다. 기존 정보창 콘텐츠를 덮어쓰고 위치를 이동합니다. 정보 창을 지정하지 않으면 DirectionsRenderer에서 자체 정보 창을 만들고 사용합니다. suppressInfoWindowstrue로 설정된 경우 이 속성은 무시됩니다.
map optional
유형:  Map optional
길찾기를 표시할 지도입니다.
markerOptions optional
유형:  MarkerOptions optional
마커에 대한 옵션입니다. DirectionsRenderer로 렌더링된 모든 마커가 이 옵션을 사용합니다.
panel optional
유형:  HTMLElement optional
경로 단계를 표시할 <div>입니다.
polylineOptions optional
유형:  PolylineOptions optional
폴리라인에 대한 옵션입니다. DirectionsRenderer로 렌더링된 모든 다중선은 이 옵션을 사용합니다.
preserveViewport optional
유형:  boolean optional
기본값: false
이 옵션이 true로 설정되거나 지도의 중심이 되고 확대/축소가 설정되지 않은 경우 입력 지도는 중앙에 배치되고 이 경로 집합의 경계 상자로 확대/축소됩니다.
routeIndex optional
유형:  number optional
DirectionsResult 객체 내 경로의 색인입니다. 기본값은 0입니다.
suppressBicyclingLayer optional
유형:  boolean optional
자전거 경로 길찾기를 요청하면 BicyclingLayer의 렌더링을 억제합니다.
suppressInfoWindows optional
유형:  boolean optional
정보창의 렌더링을 억제합니다.
suppressMarkers optional
유형:  boolean optional
마커의 렌더링을 억제합니다.
suppressPolylines optional
유형:  boolean optional
폴리라인의 렌더링을 억제합니다.

DirectionsWaypoint 인터페이스

google.maps.DirectionsWaypoint 인터페이스

DirectionsWaypoint은 출발지에서 목적지로 향하는 이동 경로를 나타냅니다.

location optional
유형:  string|LatLng|LatLngLiteral|Place optional
경유지 위치입니다. 주소 문자열, LatLng 또는 Place일 수 있습니다. 선택사항입니다.
stopover optional
유형:  boolean optional
기본값: true
true인 경우 이 경유지가 출발지와 목적지 사이의 정류장임을 나타냅니다. 이는 경로를 두 구간으로 분할하는 효과가 있습니다. false인 경우, 이 경유지를 통과하는 경로를 선택하되 두 구간으로 분할하지 않아야 함을 나타냅니다. 이는 사용자가 지도에서 경유지를 드래그하는 것에 대한 응답으로 경로를 만들려는 경우에 유용합니다.

DirectionsGeocodedWaypoint 인터페이스

google.maps.DirectionsGeocodedWaypoint 인터페이스

지오코딩된 단일 경유지입니다.

partial_match optional
유형:  boolean optional
요청한 주소의 일부분과 일치하더라도 지오코더가 원래 경유지에 대한 정확한 일치 항목을 반환하지 않았는지 여부입니다.
place_id optional
유형:  string optional
경유지와 연결된 장소 ID입니다. 장소 ID는 Google 지역 데이터베이스 및 Google 지도에 있는 장소를 고유하게 나타냅니다. Places API 개발자 가이드에서 장소 ID에 대해 자세히 알아보세요.
types optional
유형:  Array<string> optional
반환된 지오코딩된 요소의 유형을 나타내는 문자열의 배열입니다. 가능한 문자열 목록은 개발자 가이드의 주소 구성요소 유형 섹션을 참고하세요.

DirectionsRoute 인터페이스

google.maps.DirectionsRoute 인터페이스

DirectionsResult의 구간 집합을 포함하는 단일 경로입니다. 이 객체는 'JSON'과 비슷하지만 직접 및 간접적으로 LatLng 객체를 포함하기 때문에 엄격하게 JSON은 아닙니다.

bounds
유형:  LatLngBounds
이 경로의 경계입니다.
copyrights
유형:  string
이 경로에 대해 표시할 저작권 텍스트입니다.
legs
유형:  Array<DirectionsLeg>
DirectionsLeg의 배열로, 각각은 구성 단계에 대한 정보를 포함합니다. 각 경유지 경유지나 목적지에 대해 하나의 구간이 지정됩니다. 따라서 중간 기착 경유지 경유지가 없는 경로에는 DirectionsLeg 1개가 포함되고 중간 기착 경유지 경유지 1개가 있는 경로에는 2개가 포함됩니다.
overview_path
유형:  Array<LatLng>
이 경로의 전체 과정을 나타내는 LatLng의 배열입니다. Static Maps API URL과 같이 적은 수의 꼭짓점이 필요한 경우에 맞도록 경로가 단순화됩니다.
overview_polyline
유형:  string
Overview_path에서 경로의 인코딩된 다중선 표현입니다. 이 폴리라인은 최종 길찾기의 대략적인(다듬어진) 경로입니다.
summary
유형:  string
경로에 대한 짧은 텍스트 설명을 포함합니다. 경로와 대체 경로의 이름을 보여주고 차이를 설명합니다.
warnings
유형:  Array<string>
이 길찾기를 나타낼 때 표시해야 할 경고입니다.
waypoint_order
유형:  Array<number>
optimizeWaypointstrue로 설정된 경우 이 필드에 입력 경유지의 재정렬된 순열이 포함됩니다. 예를 들어 입력값이 다음과 같다면
출발지: Los Angeles
경유지: 댈러스, 뱅고어, 피닉스
목적지: 뉴욕
및 최적화된 출력은 다음과 같이 정렬되었습니다.
출발지: 로스앤젤레스
경유지: 피닉스, 댈러스, 뱅고어
대상: 뉴욕
이 필드는 Array , 2를 포함하는 Array입니다. 경유지의 번호 매기기는 0부터 시작됩니다.
입력 경유지에 false로 설정된 stopover이 있는 경우 이 쿼리에 대해 경로 최적화를 사용할 수 없으므로 이 필드는 비어 있습니다.
fare optional
유형:  TransitFare optional
전체 대중교통 이동에 대한 총 요금입니다. 대중교통 요청에만 적용됩니다.

DirectionsLeg 인터페이스

google.maps.DirectionsLeg 인터페이스

DirectionsResult의 단계 집합으로 구성된 단일 구간입니다. 구간 내 일부 필드는 일부 요청에 대해 반환되지 않을 수 있습니다. 이 결과는 'JSON'과 비슷하지만 직접 및 간접적으로 LatLng 객체를 포함하기 때문에 엄격하게 JSON은 아닙니다.

end_address
유형:  string
이 구간의 목적지 주소입니다. 이 콘텐츠는 있는 그대로 읽어야 합니다. 형식이 지정된 주소를 프로그래매틱 방식으로 파싱하지 마세요.
end_location
유형:  LatLng
DirectionsService에서는 가장 가까운 교통수단 옵션 (일반적으로 도로)을 사용하여 출발 지점과 도착 지점 사이의 거리를 계산합니다. end_location은 실제 지오코딩된 목적지를 나타내며, 예를 들어 도로가 이 구간의 목적지와 가깝지 않은 경우 마지막 단계의 end_location와 다를 수 있습니다.
start_address
유형:  string
이 구간의 출발지 주소입니다. 이 콘텐츠는 있는 그대로 읽어야 합니다. 형식이 지정된 주소를 프로그래매틱 방식으로 파싱하지 마세요.
start_location
유형:  LatLng
DirectionsService에서는 가장 가까운 교통수단 옵션 (일반적으로 도로)을 사용하여 출발 지점과 도착 지점 사이의 거리를 계산합니다. start_location은 실제 지오코딩된 출발지를 나타내며, 예를 들어 도로가 이 구간의 출발지와 가깝지 않은 경우 첫 번째 단계의 start_location와 다를 수 있습니다.
steps
DirectionsStep의 배열로, 각각은 이 구간의 개별 단계에 관한 정보를 포함합니다.
traffic_speed_entry
유형:  Array<?>
구간의 교통 속도에 관한 정보입니다.
via_waypoints
유형:  Array<LatLng>
이 구간을 따라 원래 요청에 지정된 경유지가 아닌 경유지의 배열입니다.

대체 경로에서 지원 중단됨 버전 3.27은 대체 경로에 via_waypoints을 추가하는 API의 마지막 버전입니다.

경로 서비스를 사용하여 드래그 가능한 경로를 구현할 때는 대체 경로 드래그를 사용 중지하는 것이 좋습니다. 기본 경로만 드래그 가능합니다. 사용자는 대체 경로와 일치할 때까지 기본 경로를 드래그할 수 있습니다.

arrival_time optional
유형:  Time optional
이 구간의 예상 도착 시간입니다. Transit 요청에만 적용됩니다.
departure_time optional
유형:  Time optional
이 구간의 예상 출발 시간입니다. Transit 요청에만 적용됩니다.
distance optional
유형:  Distance optional
이 구간에서 다루는 총 거리입니다. 거리를 알 수 없는 경우 이 속성이 정의되지 않을 수 있습니다.
duration optional
유형:  Duration optional
이 구간의 총 소요시간입니다. 소요 시간을 알 수 없으므로 이 속성은 undefined일 수 있습니다.
duration_in_traffic optional
유형:  Duration optional
trafficModel 속성에 표시된 교통상황을 고려하여 이 구간의 총 소요시간입니다. 소요 시간을 알 수 없으므로 이 속성은 undefined일 수 있습니다.

DirectionsStep 인터페이스

google.maps.DirectionsStep 인터페이스

DirectionsResult의 단일 DirectionsStep 일부 필드는 undefined일 수 있습니다. 이 객체는 'JSON'과 비슷하지만 직접적으로 LatLng 객체를 포함하기 때문에 엄격하게 JSON은 아닙니다.

encoded_lat_lngs
유형:  string
단계의 인코딩된 다중선 표현입니다. 이는 단계의 대략적인 (다듬어진) 경로입니다.
end_location
유형:  LatLng
이 단계의 종료 위치입니다.
end_point
유형:  LatLng
이 단계의 종료 위치입니다.
instructions
유형:  string
이 단계에 대한 안내입니다.
lat_lngs
유형:  Array<LatLng>
이 단계의 코스를 설명하는 LatLng의 시퀀스 이는 단계의 대략적인 (다듬어진) 경로입니다.
maneuver
유형:  string
현재 단계 (turn-left, merge, straight 등)에서 실행할 작업을 포함합니다. 값은 변경될 수 있으며, 예고 없이 새로운 값이 도입될 수 있습니다.
path
유형:  Array<LatLng>
이 단계의 코스를 설명하는 LatLng의 시퀀스 이는 단계의 대략적인 (다듬어진) 경로입니다.
start_location
유형:  LatLng
이 단계의 시작 위치입니다.
start_point
유형:  LatLng
이 단계의 시작 위치입니다.
travel_mode
유형:  TravelMode
이 단계에서 사용된 이동수단입니다.
distance optional
유형:  Distance optional
이 단계에서 다루는 거리입니다. 거리를 알 수 없는 경우 이 속성은 undefined일 수 있습니다.
duration optional
유형:  Duration optional
이 단계를 수행하는 데 필요한 일반적인 시간으로, 초 단위 및 텍스트 형식으로 나타냅니다. 소요 시간을 알 수 없으므로 이 속성은 undefined일 수 있습니다.
polyline optional
유형:  DirectionsPolyline optional
단계의 인코딩된 다중선 표현을 포함하는 단일 속성 '포인트'가 포함된 객체를 포함합니다. 이 폴리라인은 스텝의 대략적인(다듬어진) 경로입니다.
steps optional
유형:  Array<DirectionsStep> optional
이 단계의 하위 단계입니다. 대중교통 경로의 비대면 섹션에 지정됩니다.
transit optional
유형:  TransitDetails optional
이 단계에 대한 대중교통별 세부정보입니다. 이 단계의 이동수단이 TRANSIT이 아니면 이 속성이 정의되지 않습니다.
transit_details optional
유형:  TransitDetails optional
이동수단이 TRANSIT인 경우 이 단계와 관련된 세부정보입니다.

Directions다중선 인터페이스

google.maps.DirectionsPolyline 인터페이스

DirectionsStep의 다중선을 설명하는 points 속성이 포함된 객체입니다.

points
유형:  string

Place 인터페이스

google.maps.Place 인터페이스

DirectionsRequest 또는 DistanceMatrixRequest에 대한 장소를 찾거나 식별하거나 설명하는 데 필요한 정보가 포함됩니다. 여기에서 '장소'는 업체, 관심 장소 또는 지리적 위치를 의미합니다. 장소 정보를 가져오는 방법은 PlacesService를 참고하세요.

location optional
유형:  LatLng|LatLngLiteral optional
이 장소에서 설명하는 항목의 LatLng입니다.
placeId optional
유형:  string optional
장소의 장소 ID (예: 업체 또는 관심 장소) 장소 ID는 Google 지도 데이터베이스에 있는 장소의 고유 식별자입니다. placeId는 장소를 식별하는 가장 정확한 방법입니다. 가능하면 query가 아닌 placeId를 지정해야 합니다. Places API에 대한 모든 요청(예: TextSearch)에서 장소 ID를 검색할 수 있습니다. Geocoding API에 대한 요청에서 장소 ID를 가져올 수도 있습니다. 자세한 내용은 장소 ID 개요를 참고하세요.
query optional
유형:  string optional
장소 (비즈니스 또는 관심 장소 등)를 설명하는 검색어입니다. 예를 들면 '퀘이, 상층, 해외 승객 터미널 5 힙슨 로드, 더 록스 NSW'입니다. 가능하면 query가 아닌 placeId를 지정해야 합니다. API는 쿼리 문자열을 특정 장소로 확인하는 정확성을 보장하지 않습니다. placeIdquery가 모두 제공되면 오류가 발생합니다.

TravelMode 상수

google.maps.TravelMode 상수

DirectionsRequest에서 지정할 수 있는 유효한 이동 수단과 DirectionsStep에서 반환된 이동 수단입니다. 값 또는 상수 이름을 사용하여 지정합니다. 예를 들어 'BICYCLING' 또는 google.maps.TravelMode.BICYCLING입니다.

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

BICYCLING 자전거 경로 길찾기 요청을 지정합니다.
DRIVING 운전경로 요청을 지정합니다.
TRANSIT 대중교통 경로 요청을 지정합니다.
WALKING 보행경로 요청을 지정합니다.

DriverOptions 인터페이스

google.maps.DrivingOptions 인터페이스

이동수단을 DRIVING로 설정하면 DirectionsRequest를 구성합니다.

departureTime
유형:  Date
경로의 원하는 출발 시간으로, Date 객체로 지정됩니다. Date 객체는 1970년 1월 1일 이후의 시간을 밀리초 단위로 측정합니다. DrivingOptions가 유효하려면 지정해야 합니다. 출발 시간은 현재 시간 또는 미래의 특정 시간으로 설정해야 합니다. 과거 시간으로 설정할 수는 없습니다.
trafficModel optional
유형:  TrafficModel optional
교통상황을 예측할 때 사용할 기본 가정입니다. 기본값은 BEST_GUESS입니다.

TrafficModel 상수

google.maps.TrafficModel 상수

트래픽의 지속 시간을 예측할 때 사용할 가정입니다. DirectionsRequest 또는 DistanceMatrixRequest의 일부로 지정됩니다. 값 또는 상수 이름을 사용하여 지정합니다. 예를 들어 'bestguess' 또는 google.maps.TrafficModel.BEST_GUESS입니다.

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

BEST_GUESS 이전 트래픽 데이터를 사용하여 예상 트래픽 시간을 추정하세요.
OPTIMISTIC 이전 트래픽 데이터를 사용하여 예상 이동 시간을 예측할 수 있습니다.
PESSIMISTIC 이전 트래픽 데이터를 사용하여 교통상황에 대한 기간을 비관적으로 예측합니다.

TransitOptions 인터페이스

google.maps.TransitOptions 인터페이스

이동수단이 교통카드로 설정된 경우 DirectionsRequest에 포함될 TransitOptions 객체입니다.

arrivalTime optional
유형:  Date optional
경로의 원하는 도착 시간입니다. 날짜 객체로 지정됩니다. Date 객체는 1970년 1월 1일 이후의 시간을 밀리초 단위로 측정합니다. 도착 시간이 지정되면 출발 시간은 무시됩니다.
departureTime optional
유형:  Date optional
경로의 원하는 출발 시간으로, 날짜 객체로 지정됩니다. Date 객체는 1970년 1월 1일 이후의 시간을 밀리초 단위로 측정합니다. 출발 시간과 도착 시간이 모두 지정되지 않은 경우 시간은 '지금'으로 간주됩니다.
modes optional
유형:  Array<TransitMode> optional
버스나 기차와 같은 하나 이상의 선호하는 교통수단입니다. 환경설정이 지정되지 않으면 API는 기본 최적 경로를 반환합니다.
routingPreference optional
유형:  TransitRoutePreference optional
도보 이동과 같이 대중교통 경로에 대한 선호도를 편향할 수 있는 선호도. 환경설정이 지정되지 않으면 API는 기본 최적 경로를 반환합니다.

TransitMode 상수

google.maps.TransitMode 상수

유효한 대중교통 모드입니다(예: TransitOptions에서 지정할 수 있는 버스). 값 또는 상수 이름을 사용하여 지정합니다. 예를 들어 'BUS' 또는 google.maps.TransitMode.BUS입니다.

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

BUS 버스를 선호하는 이동수단으로 지정합니다.
RAIL 철도를 선호하는 이동수단으로 지정합니다.
SUBWAY 지하철을 선호하는 이동수단으로 지정합니다.
TRAIN 기차를 선호하는 이동수단으로 지정합니다.
TRAM 트램을 선호하는 교통수단으로 지정합니다.

TransitRoutePreference 상수

google.maps.TransitRoutePreference 상수

TransitOptions에 지정할 수 있는 유효한 대중교통 경로 유형입니다. 값 또는 상수 이름을 사용하여 지정합니다. 예를 들어 'LESS_WALKING' 또는 google.maps.TransitRoutePreference.LESS_WALKING입니다.

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

FEWER_TRANSFERS 경로 계산 시 환승 횟수를 제한하도록 지정합니다.
LESS_WALKING 경로 계산 시 도보 이동을 제한해야 함을 지정합니다.

TransitFare 인터페이스

google.maps.TransitFare 인터페이스

값과 통화로 구성된 DirectionsRoute 의 요금입니다.

currency
유형:  string
요금에 적용되는 통화를 나타내는 ISO 4217 통화 코드입니다.
value
유형:  number
지정된 요금에 대한 요금의 currency 값입니다.

TransitDetails 인터페이스

google.maps.TransitDetails 인터페이스

이 단계에서 사용되는 출발, 도착 및 교통수단에 대한 세부정보입니다.

arrival_stop
유형:  TransitStop
이 대중교통 단계의 도착 정류장입니다.
arrival_time
유형:  Time
이 단계의 도착 시간으로, Time 객체로 지정됩니다.
departure_stop
유형:  TransitStop
이 대중교통 단계의 출발 정류장입니다.
departure_time
유형:  Time
이 단계의 출발 시간으로, Time 객체로 지정됩니다.
headsign
유형:  string
이 노선에서 이동하는 방향입니다. 차량이나 출발 정류장에 표시되어 있습니다.
headway
유형:  number
이 정류장에서 해당 차량 사이의 예상 시간(초)입니다.
line
유형:  TransitLine
이 단계에 사용된 대중교통 노선에 대한 세부정보입니다.
num_stops
유형:  number
이 단계의 정류장 수입니다. 도착 정류장은 포함되지만, 출발 정류장은 포함되지 않습니다.
trip_short_name
유형:  string
예를 들어 통근 열차로 이동하는 기차 번호를 식별하기 위해 승객을 위한 대중교통 이동을 식별하기 위해 일정 및 표지판에 표시되는 텍스트입니다. 텍스트는 서비스 제공일 중의 이동을 고유하게 식별합니다.

TransitStop 인터페이스

google.maps.TransitStop 인터페이스

대중교통 정류장 또는 역에 대한 세부정보입니다.

location
유형:  LatLng
이 정류장의 위치입니다.
name
유형:  string
대중교통 정류장의 이름입니다.

TransitLine 인터페이스

google.maps.TransitLine 인터페이스

이 대중교통 단계를 운행하는 대중교통 노선에 대한 정보입니다.

agencies
유형:  Array<TransitAgency>
이 대중교통 노선을 운영하는 대중교통 기관입니다.
color
유형:  string
이 대중교통 노선의 표지판에 일반적으로 사용되는 색상으로, 16진수 문자열로 표시됩니다.
icon
유형:  string
이 선과 연결된 아이콘의 URL입니다.
name
유형:  string
이 대중교통 노선의 전체 이름입니다(예: '8 Avenue Local').
short_name
유형:  string
이 대중교통 노선의 짧은 이름입니다(예: 'E').
text_color
유형:  string
이 대중교통 노선의 표지판에 일반적으로 사용되는 텍스트 색상으로, 16진수 문자열로 표시됩니다.
url
유형:  string
이 대중교통 노선에 해당하는 기관의 URL입니다.
vehicle
유형:  TransitVehicle
사용된 차량의 유형입니다(예: 기차 또는 버스).

TransitAgency 인터페이스

google.maps.TransitAgency 인터페이스

대중교통 노선을 운영하는 기관에 대한 정보입니다.

name
유형:  string
대중교통 기관의 이름입니다.
phone
유형:  string
대중교통 기관의 전화번호입니다.
url
유형:  string
대중교통 기관의 URL입니다.

TransitVehicle 인터페이스

google.maps.TransitVehicle 인터페이스

대중교통 노선에서 운행되는 차량에 대한 정보입니다.

icon
유형:  string
이 노선에서 사용되는 차량 유형에 해당하는 아이콘의 URL입니다.
local_icon
유형:  string
보다 일반적인 아이콘 대신 이 지역에서 사용되는 차량 유형에 해당하는 아이콘의 URL입니다.
name
유형:  string
이 운송 수단 유형의 이름입니다(예: '기차' 또는 '버스').
type
유형:  VehicleType
사용된 차량의 유형입니다(예: 기차, 버스, 페리).

VehicleType 상수

google.maps.VehicleType 상수

차량 유형에 사용할 수 있는 값입니다.

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

BUS 버스
CABLE_CAR 일반적으로 지상에서 케이블로 운영되는 차량입니다. 공중 케이블카는 GONDOLA_LIFT 유형일 수 있습니다.
COMMUTER_TRAIN 통근 열차
FERRY 페리
FUNICULAR 케이블로 당겨서 가파른 경사를 오르는 차량입니다.
GONDOLA_LIFT 공중 케이블카
HEAVY_RAIL 철도
HIGH_SPEED_TRAIN 고속 열차
INTERCITY_BUS 시외버스
METRO_RAIL 경전철.
MONORAIL 모노레일
OTHER 기타 차량
RAIL 기차
SHARE_TAXI 공유 택시는 버스의 일종으로 경로에 있는 승객을 태우고 승차할 수 있습니다. 일반적으로 택시는 미니버스를 사용합니다.
SUBWAY 지하철
TRAM 지상철
TROLLEYBUS 트롤리 버스

UnitSystem 상수

google.maps.UnitSystem 상수

DirectionsRequest에 지정할 수 있는 유효한 단위 체계입니다.

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

IMPERIAL DirectionsResult의 거리를 야드파운드 단위로 표현해야 함을 지정합니다.
METRIC DirectionsResult의 거리를 미터 단위로 표현해야 함을 지정합니다.

Distance 인터페이스

google.maps.Distance 인터페이스

숫자 값과 표시 문자열로 나타낸 거리입니다.

text
유형:  string
요청에 지정된 UnitSystem를 사용하는 거리 값의 문자열 표현입니다.
value
유형:  number
거리입니다(미터 단위).

Duration 인터페이스

google.maps.Duration 인터페이스

숫자 값과 표시 문자열로 나타낸 소요시간입니다.

text
유형:  string
소요시간 값을 나타낸 문자열입니다.
value
유형:  number
소요시간입니다(초 단위).

Time 인터페이스

google.maps.Time 인터페이스

시간을 날짜 객체, 현지화된 문자열 및 시간대로 표현한 것입니다.

text
유형:  string
시간 값을 나타내는 문자열입니다. 이 시간은 대중교통 정류장의 시간대로 표시됩니다.
time_zone
유형:  string
이 정류장이 위치한 지역의 시간대입니다. 값은 IANA 시간대 데이터베이스에 정의된 시간대의 이름입니다(예: 'America/New_York').
value
유형:  Date
이 출발 또는 도착 시간으로 자바스크립트 날짜 객체로 지정됩니다.

DirectionsTravelMode 상수

google.maps.DirectionsTravelMode 상수

DirectionsUnitSystem 상수

google.maps.DirectionsUnitSystem 상수