Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

Distance Matrix (deprecated)

DistanceMatrixService 클래스

google.maps.DistanceMatrixService 클래스
라이브러리 "routes"

const {DistanceMatrixService} = await google.maps.importLibrary("routes");

생성자
`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` 선택사항	유형: `boolean optional` `true`인 경우 거리 행렬 서비스에 가능한 경우 페리를 피하도록 지시합니다. 선택사항입니다.
`avoidHighways` 선택사항	유형: `boolean optional` `true`인 경우 거리 행렬 서비스에 가능한 한 고속도로를 피하도록 지시합니다. 선택사항입니다.
`avoidTolls` 선택사항	유형: `boolean optional` `true`인 경우 거리 행렬 서비스에서 가능한 경우 유료 도로를 피하도록 지시합니다. 선택사항입니다.
`drivingOptions` 선택사항	유형: `DrivingOptions optional` `travelMode`가 `DRIVING`인 요청에만 적용되는 설정입니다. 이 객체는 다른 이동 수단에는 영향을 미치지 않습니다.
`language` 선택사항	유형: `string optional` 가능한 경우 결과를 반환할 언어의 언어 식별자입니다. 지원 언어 목록을 참조하세요.
`region` 선택사항	유형: `string optional` 지오코딩 요청에 대한 바이어스로 사용되는 지역 코드입니다. 지역 코드는 ccTLD ('최상위 도메인') 2자리 값을 허용합니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하지만 일부 특별한 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk' (`.co.uk`)이지만 ISO 3166-1 코드는 'gb'입니다(엄밀히 말하면 'The United Kingdom of Great Britain and Northern Ireland'의 항목).
`transitOptions` 선택사항	유형: `TransitOptions optional` `travelMode`가 TRANSIT인 요청에만 적용되는 설정입니다. 이 객체는 다른 이동 수단에는 영향을 미치지 않습니다.
`unitSystem` 선택사항	유형: `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 상수
라이브러리 "routes"

거리 행렬 요청이 완료되면 DistanceMatrixService에서 반환하는 요청에 관한 최상위 상태입니다. 값 또는 상수의 이름을 사용하여 지정합니다. 예를 들어 'OK' 또는 google.maps.DistanceMatrixStatus.OK입니다.

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 DistanceMatrixStatusString 유형으로 정의됩니다.

const {DistanceMatrixStatus} = await google.maps.importLibrary("routes");

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

DistanceMatrixElementStatus 상수

google.maps.DistanceMatrixElementStatus 상수
라이브러리 "routes"

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

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 DistanceMatrixElementStatusString 유형으로 정의됩니다.

const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes");

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