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

이 페이지는 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`가 정의된 경우에만 Premium 요금제 고객이 사용할 수 있습니다.
`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`	출발지와 목적지 사이에서 경로를 찾지 못했습니다.