새로운 지도 스타일이 곧 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` 지오코딩 요청에 대한 바이어스로 사용되는 지역 코드입니다. 지역 코드에는 2자리 ccTLD ('최상위 도메인') 값이 허용됩니다. 대부분의 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 인터페이스

DistanceMatrixService 요청에 대한 응답으로, 형식이 지정된 출발지 및 목적지 주소와 일련의 DistanceMatrixResponseRow(해당하는 각 출발지 주소당)로 구성됩니다.

속성
`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`	출발지와 목적지 사이에서 경로를 찾지 못했습니다.