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

Distance Matrix

DistanceMatrixService 클래스

google.maps.DistanceMatrixService 클래스

여러 출발지와 목적지 사이의 거리를 계산하기 위한 서비스입니다.

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

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

메서드
`getDistanceMatrix`	`getDistanceMatrix(request[, callback])` 매개변수: `request`: `DistanceMatrixRequest` `callback`: `function(DistanceMatrixResponse optional, DistanceMatrixStatus): void optional` 반환 값: `Promise<DistanceMatrixResponse>` 거리 매트릭스를 요청합니다.

DistanceMatrixRequest 인터페이스

google.maps.DistanceMatrixRequest 인터페이스

출발지 및 목적지 위치 배열과 측정항목 계산을 위한 다양한 옵션이 포함된 DistanceMatrixService에서 전송된 거리 행렬 쿼리입니다.

속성
`destinations`	유형: `Array<string\|LatLng\|LatLngLiteral\|Place>` 거리와 시간을 계산할 때 도착점이 되는 주소 문자열, `LatLng` 또는 `Place` 객체가 포함된 배열 필수 항목입니다.
`origins`	유형: `Array<string\|LatLng\|LatLngLiteral\|Place>` 거리와 시간을 계산할 때 출발점이 되는 출발지 주소 문자열, `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` 가능한 경우 결과를 반환해야 하는 언어의 언어 식별자입니다. 지원 언어 목록을 참조하세요.
`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` 거리를 표시하는 데 사용할 기본 단위 체계입니다. 선택사항이며 기본값은 미터입니다.

DistanceMatrixResponse 인터페이스

google.maps.DistanceMatrixResponse 인터페이스

형식이 지정된 출발지 및 목적지 주소와 각 해당 출발지 주소에 대해 하나씩의 DistanceMatrixResponseRow 시퀀스로 구성된 DistanceMatrixService 요청에 대한 응답입니다.

속성
`destinationAddresses`	유형: `Array<string>` 형식이 지정된 목적지 주소입니다.
`originAddresses`	유형: `Array<string>` 형식이 지정된 출발지 주소입니다.
`rows`	유형: `Array<DistanceMatrixResponseRow>` 출발지 주소에 대응하는 매트릭스의 행입니다.

DistanceMatrixResponseRow 인터페이스

google.maps.DistanceMatrixResponseRow 인터페이스

DistanceMatrixService 요청에 대한 응답의 행으로, 각 해당 도착 주소에 대해 하나씩인 DistanceMatrixResponseElement 시퀀스로 구성됩니다.

속성
`elements`	유형: `Array<DistanceMatrixResponseElement>` 목적지 주소에 대응하는 행의 요소입니다.

DistanceMatrixResponseElement 인터페이스

google.maps.DistanceMatrixResponseElement 인터페이스

하나의 출발지에서 하나의 목적지까지의 시간과 거리를 포함하는 DistanceMatrixService 요청에 대한 응답의 단일 요소입니다.

속성
`distance`	유형: `Distance` 이 출발지-목적지 쌍에 대한 거리입니다. 거리를 알 수 없는 경우 이 속성이 정의되지 않을 수 있습니다.
`duration`	유형: `Duration` 이 출발지-목적지 쌍에 대한 소요시간입니다. 소요시간을 알 수 없는 경우 이 속성이 정의되지 않을 수 있습니다.
`duration_in_traffic`	유형: `Duration` `trafficModel` 속성으로 표시된 교통상황을 고려한 이 출발지-도착지 쌍의 기간입니다. 소요 시간을 알 수 없는 경우 이 속성은 `undefined`일 수 있습니다. 요청 시 `drivingOptions`가 정의된 경우 프리미엄 요금제 고객에게만 제공됩니다.
`fare`	유형: `TransitFare` 이 출발지-도착지 쌍의 총 요금입니다. 대중교통 요청에만 적용됩니다.
`status`	유형: `DistanceMatrixElementStatus` 특정 출발지-목적지 쌍의 상태입니다.

DistanceMatrixStatus 상수

google.maps.DistanceMatrixStatus 상수

거리 매트릭스 요청이 완료되면 DistanceMatrixService에서 반환되는 요청에 관한 일반적인 최상위 상태입니다. 값으로 지정하거나 상수 이름을 사용하여 지정합니다. 예를 들어 'OK' 또는 google.maps.DistanceMatrixStatus.OK입니다.

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

상수
`INVALID_REQUEST`	제공된 요청이 잘못되었습니다.
`MAX_DIMENSIONS_EXCEEDED`	요청에 25개 이상의 출발지 또는 25개 이상의 목적지가 포함되어 있습니다.
`MAX_ELEMENTS_EXCEEDED`	출발지와 목적지의 곱이 쿼리당 한도를 초과합니다.
`OK`	응답에 유효한 결과가 포함되어 있습니다.
`OVER_QUERY_LIMIT`	허용된 시간 내에 너무 많은 요소를 요청했습니다. 잠시 후 다시 시도하면 요청이 성공합니다.
`REQUEST_DENIED`	서비스가 사용자 웹페이지의 길찾기 매트릭스 서비스 사용을 거부했습니다.
`UNKNOWN_ERROR`	서버 오류로 인해 길찾기 매트릭스 요청을 처리하지 못했습니다. 다시 시도하면 요청이 성공할 수도 있습니다.

DistanceMatrixElementStatus 상수

google.maps.DistanceMatrixElementStatus 상수

거리 행렬 요청이 완료되면 DistanceMatrixService에서 반환되는 특정 출발지-목적지 쌍에 관한 요소 수준 상태입니다. 이러한 값은 'OK'와 같이 문자열로 지정됩니다.

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

상수
`NOT_FOUND`	이 출발지 및 목적지 쌍을 지오코딩하지 못했습니다.
`OK`	응답에 유효한 결과가 포함되어 있습니다.
`ZERO_RESULTS`	출발지와 목적지 사이에서 경로를 찾지 못했습니다.

Distance Matrix 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.