공지사항: 새로운 기본 지도 스타일이 곧 Google Maps Platform에 제공될 예정입니다. 이 지도 스타일 지정 업데이트에는 새로운 기본 색상 팔레트, 현대화된 핀, 지도 환경 및 사용성 개선사항이 포함됩니다. 모든 지도 스타일이 2025년 3월에 자동으로 업데이트됩니다. 사용 가능 여부 및 더 일찍 선택하는 방법에 대한 자세한 내용은 Google Maps Platform용 새로운 지도 스타일을 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Directions

DirectionsService 클래스

google.maps.DirectionsService 클래스

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

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

생성자
`DirectionsService`	`DirectionsService()` 매개변수: 없음 Google 서버에 경로 쿼리를 전송하는 `DirectionsService`의 새 인스턴스를 만듭니다.

메서드
`route`	`route(request[, callback])` 매개변수: `request`: `DirectionsRequest` `callback`: `function(DirectionsResult optional, DirectionsStatus): void optional` 반환 값: `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` `travelMode`가 `DRIVING`인 요청에만 적용되는 설정입니다. 이 객체는 다른 이동 수단에는 영향을 미치지 않습니다.
`language optional`	유형: `string optional` 가능한 경우 결과를 반환해야 하는 언어의 언어 식별자입니다. 지원 언어 목록을 참조하세요.
`optimizeWaypoints optional`	유형: `boolean optional` `true`로 설정하면 `DirectionsService`는 제공된 중간 웨이포인트의 순서를 변경하여 경로의 전반적인 비용을 최소화하려고 시도합니다. 경유지가 최적화된 경우 응답에서 `DirectionsRoute.waypoint_order`를 검사하여 새 순서를 확인합니다.
`provideRouteAlternatives optional`	유형: `boolean optional` 대체 경로 제공 여부를 지정합니다. 선택사항입니다.
`region optional`	유형: `string optional` 지오코딩 요청에 대한 바이어스로 사용되는 지역 코드입니다. 지역 코드는 ccTLD ('최상위 도메인') 2자리 값을 허용합니다. 대부분의 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이 아닙니다.

속성
`request`	유형: `DirectionsRequest` 이 결과를 산출한 DirectionsRequest입니다.
`routes`	유형: `Array<DirectionsRoute>` `DirectionsRoute` 배열로, 각 배열에는 구성된 구간과 단계에 관한 정보가 포함됩니다. `DirectionsRequest`가 `provideRouteAlternatives`이 `true`로 설정된 상태로 만들어진 것이 아니라면 경로는 하나만 있습니다.
`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])` 매개변수: `opts`: `DirectionsRendererOptions optional` 지정된 옵션으로 렌더러를 만듭니다. 경로는 지도에 시각적 오버레이로 렌더링되거나 `<div>` 패널에 텍스트 안내로 추가로 렌더링될 수 있습니다.

메서드
`getDirections`	`getDirections()` 매개변수: 없음 반환 값: `DirectionsResult` 렌더러의 현재 길찾기 집합을 반환합니다.
`getMap`	`getMap()` 매개변수: 없음 반환 값: `Map` `DirectionsResult`가 렌더링되는 맵을 반환합니다.
`getPanel`	`getPanel()` 매개변수: 없음 반환 값: `HTMLElement\|null` `DirectionsResult`가 렌더링되는 패널 `<div>`를 반환합니다.
`getRouteIndex`	`getRouteIndex()` 매개변수: 없음 반환 값: `number` 이 `DirectionsRenderer` 객체에서 사용 중인 현재 (0부터 시작하는) 경로 색인을 반환합니다.
`setDirections`	`setDirections(directions)` 매개변수: `directions`: `DirectionsResult` 반환 값: 없음 `DirectionsService`의 결과를 사용하도록 렌더러를 설정합니다. 이 방법으로 유효한 길찾기 집합을 설정하면 렌더러에서 지정한 지도와 패널에 길찾기가 표시됩니다.
`setMap`	`setMap(map)` 매개변수: `map`: `Map` 반환 값: 없음 이 방법은 길찾기를 렌더링할 지도를 지정합니다. `null`를 전달하여 지도에서 경로를 삭제합니다.
`setOptions`	`setOptions(options)` 매개변수: `options`: `DirectionsRendererOptions` 반환 값: 없음 초기화 후 이 `DirectionsRenderer`의 옵션 설정을 변경합니다.
`setPanel`	`setPanel(panel)` 매개변수: `panel`: `HTMLElement optional` 반환 값: 없음 이 메서드는 `<div>`에 경로를 렌더링합니다. `null`를 전달하여 패널에서 콘텐츠를 삭제합니다.
`setRouteIndex`	`setRouteIndex(routeIndex)` 매개변수: `routeIndex`: `number` 반환 값: 없음 렌더링할 `DirectionsResult` 객체에서 경로의 색인 (0부터 시작)을 설정합니다. 기본적으로 배열의 첫 번째 경로가 렌더링됩니다.
상속: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

이벤트
`directions_changed`	`function()` 인수: 없음 이 이벤트는 렌더링된 경로가 변경될 때, 즉 새 `DirectionsResult`가 설정될 때 또는 사용자가 경로 변경사항을 드래그하여 완료할 때 실행됩니다.

DirectionsRendererOptions 인터페이스

google.maps.DirectionsRendererOptions 인터페이스

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

속성
`directions optional`	유형: `DirectionsResult optional` 지도 또는 `<div>` 패널에 표시할 경로로, `DirectionsService`에서 `DirectionsResult` 객체로 가져옵니다.
`draggable optional`	유형: `boolean optional` `true`인 경우 사용자가 이 `DirectionsRenderer`에서 렌더링된 경로의 경로를 드래그하고 수정할 수 있습니다.
`hideRouteList optional`	유형: `boolean optional` 기본값: `false` 이 속성은 렌더러가 경로 패널에 표시되는 경로 목록을 사용자가 선택할 수 있도록 제공해야 하는지 여부를 나타냅니다.
`infoWindow optional`	유형: `InfoWindow optional` 마커가 클릭될 때 텍스트 정보를 렌더링할 `InfoWindow`입니다. 기존 정보창 콘텐츠를 덮어쓰고 위치를 이동합니다. 정보 창이 지정되지 않으면 `DirectionsRenderer`가 자체 정보 창을 만들고 사용합니다. `suppressInfoWindows`가 `true`로 설정된 경우 이 속성은 무시됩니다.
`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`인 경우 경로가 이 경유점을 통과하도록 편향되어야 하지만 두 구간으로 분할되어서는 안 된다는 것을 나타냅니다. 이는 사용자가 지도에서 웨이포인트를 드래그할 때 경로를 만들려는 경우에 유용합니다.

속성

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`가 하나 포함되고 중간 기착 경유지가 하나 있는 경로에는 `DirectionsLeg`가 2개 포함됩니다.
`overview_path`	유형: `Array<LatLng>` 이 경로의 전체 과정을 나타내는 `LatLng` 배열입니다. Static Maps API URL과 같이 적은 수의 꼭짓점이 필요한 경우에 맞도록 경로가 단순화됩니다.
`overview_polyline`	유형: `string` overview_path의 경로에 대한 인코딩된 다중선 표현입니다. 이 폴리라인은 최종 길찾기의 대략적인(다듬어진) 경로입니다.
`summary`	유형: `string` 경로의 짧은 텍스트 설명으로, 경로의 이름을 지정하고 대안과 구분하는 데 적합합니다.
`warnings`	유형: `Array<string>` 이 길찾기를 나타낼 때 표시해야 할 경고입니다.
`waypoint_order`	유형: `Array<number>` `optimizeWaypoints`가 `true`로 설정된 경우 이 필드에는 입력 웨이포인트의 재정렬된 순열이 포함됩니다. 예를 들어 입력이 다음과 같고 Origin: Los Angeles Waypoints: Dallas, Bangor, Phoenix Destination: New York 최적화된 출력이 다음과 같이 순서가 지정된 경우 Origin: Los Angeles Waypoints: Phoenix, Dallas, Bangor Destination: New York 이 필드는 값 [2, 0, 1]이 포함된 `Array`입니다. 경유지의 번호 매기기는 0부터 시작됩니다. 입력된 중간 지점 중 `stopover`이 `false`로 설정된 중간 지점이 있으면 경로 최적화를 사용할 수 없으므로 이 필드는 비어 있습니다.
`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`	유형: `Array<DirectionsStep>` `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`	지원 중단됨: `DirectionsStep.end_location`를 사용하세요. 유형: `LatLng` 이 단계의 종료 위치입니다.
`instructions`	유형: `string` 이 단계에 대한 안내입니다.
`lat_lngs`	지원 중단됨: `DirectionsStep.path`를 사용하세요. 유형: `Array<LatLng>` 이 단계의 과정을 설명하는 `LatLng`의 시퀀스입니다. 이 다중선은 단계의 대략적인 (평활화된) 경로입니다.
`maneuver`	유형: `string` 현재 단계에 대해 취할 작업 (`turn-left`, `merge`, `straight` 등)을 포함합니다. 값은 변경될 수 있으며 사전 고지 없이 새로운 값이 도입될 수도 있습니다.
`path`	유형: `Array<LatLng>` 이 단계의 과정을 설명하는 `LatLng`의 시퀀스입니다. 이 다중선은 단계의 대략적인 (평활화된) 경로입니다.
`start_location`	유형: `LatLng` 이 단계의 시작 위치입니다.
`start_point`	지원 중단됨: `DirectionsStep.start_location`를 사용하세요. 유형: `LatLng` 이 단계의 시작 위치입니다.
`travel_mode`	유형: `TravelMode` 이 단계에서 사용된 이동수단입니다.
`distance optional`	유형: `Distance optional` 이 단계에서 다루는 거리입니다. 거리를 알 수 없으므로 이 속성은 `undefined`일 수 있습니다.
`duration optional`	유형: `Duration optional` 이 단계를 수행하는 데 필요한 일반적인 시간으로, 초 단위 및 텍스트 형식으로 나타냅니다. 이 속성은 소요 시간을 알 수 없으므로 `undefined`일 수 있습니다.
`polyline optional`	지원 중단됨: `DirectionsStep.encoded_lat_lngs`를 사용하세요. 유형: `DirectionsPolyline optional` 단계의 인코딩된 다중선 표현을 보유하는 단일 속성 'points'가 있는 객체를 포함합니다. 이 폴리라인은 스텝의 대략적인(다듬어진) 경로입니다.
`steps optional`	유형: `Array<DirectionsStep> optional` 이 단계의 하위 단계입니다. 대중교통 경로의 대중교통이 아닌 구간에 지정됩니다.
`transit optional`	유형: `TransitDetails optional` 이 단계에 관한 대중교통 관련 세부정보입니다. 이 단계의 이동 모드가 `TRANSIT`이 아니면 이 속성은 정의되지 않습니다.
`transit_details optional`	유형: `TransitDetails optional` 이동 모드가 `TRANSIT`인 경우 이 단계와 관련된 세부정보입니다.

DirectionsPolyline 인터페이스

google.maps.DirectionsPolyline 인터페이스

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

속성
`points`	유형: `string` 인코딩된 다중선

장소 인터페이스

google.maps.Place 인터페이스

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

속성
`location optional`	유형: `LatLng\|LatLngLiteral optional` 이 장소로 설명된 항목의 `LatLng`입니다.
`placeId optional`	유형: `string optional` 장소의 장소 ID (예: 비즈니스 또는 관심 장소)입니다. 장소 ID는 Google 지도 데이터베이스에 있는 장소의 고유 식별자입니다. `placeId`는 장소를 식별하는 가장 정확한 방법입니다. 가능하면 `query` 대신 `placeId`를 지정해야 합니다. 장소 ID는 TextSearch와 같은 Places API 요청에서 가져올 수 있습니다. 장소 ID는 Geocoding API에 대한 요청에서도 가져올 수 있습니다. 자세한 내용은 장소 ID 개요를 참고하세요.
`query optional`	유형: `string optional` 장소 (예: 비즈니스 또는 관심 장소)를 설명하는 검색어입니다. 쿼리 예시는 'Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW'입니다. 가능하면 `query` 대신 `placeId`를 지정해야 합니다. API는 쿼리 문자열을 장소로 확인하는 정확성을 보장하지 않습니다. `placeId`와 `query`가 모두 제공되면 오류가 발생합니다.

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`	보행경로 요청을 지정합니다.

DrivingOptions 인터페이스

google.maps.DrivingOptions 인터페이스

이동 모드가 DRIVING로 설정된 경우 DirectionsRequest를 구성합니다.

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

속성

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 인터페이스

이동 모드가 TRANSIT으로 설정된 경우 DirectionsRequest에 포함할 TransitOptions 객체입니다.

속성
`arrivalTime optional`	유형: `Date optional` 경로의 원하는 도착 시간으로, Date 객체로 지정됩니다. Date 객체는 1970년 1월 1일 이후 경과된 시간을 밀리초 단위로 측정합니다. 도착 시간이 지정되면 출발 시간은 무시됩니다.
`departureTime optional`	유형: `Date optional` 경로의 원하는 출발 시간으로, Date 객체로 지정됩니다. Date 객체는 1970년 1월 1일 이후 경과된 시간을 밀리초 단위로 측정합니다. 출발 시간 또는 도착 시간이 지정되지 않은 경우 시간을 '현재'로 간주합니다.
`modes optional`	유형: `Array<TransitMode> optional` 버스나 기차와 같이 선호하는 대중교통 수단 1개 이상 환경설정이 지정되지 않으면 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번가 지역선').
`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`의 거리를 미터 단위로 표시해야 함을 지정합니다.

거리 인터페이스

google.maps.Distance 인터페이스

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

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

Duration 인터페이스

google.maps.Duration 인터페이스

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

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

시간 인터페이스

google.maps.Time 인터페이스

Date 객체, 현지화된 문자열, 시간대로 표시된 시간입니다.

속성
`text`	유형: `string` 시간 값을 나타내는 문자열입니다. 이 시간은 대중교통 정류장의 시간대로 표시됩니다.
`time_zone`	유형: `string` 이 정류장이 있는 시간대입니다. 값은 IANA 시간대 데이터베이스에 정의된 시간대의 이름입니다(예: 'America/New_York').
`value`	유형: `Date` 이 출발 또는 도착 시간으로, JavaScript Date 객체로 지정됩니다.

DirectionsTravelMode 상수

google.maps.DirectionsTravelMode 상수

DirectionsUnitSystem 상수

google.maps.DirectionsUnitSystem 상수