Route Matrix

RouteMatrix 클래스

google.maps.routes.RouteMatrix 클래스

RouteMatrix.computeRouteMatrix에서 출발지/목적지 쌍 집합에 대해 계산한 경로 행렬

const {RouteMatrix} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.
computeRouteMatrix
computeRouteMatrix(request)
매개변수: 
반환 값:  Promise<{matrix:RouteMatrix}>
출발지와 목적지 목록을 가져와 각 출발지와 목적지 조합의 경로 정보가 포함된 행렬을 반환합니다.

참고: 이 메서드를 사용하려면 ComputeRouteMatrixRequest.fields 속성을 설정하여 요청에 응답 필드 마스크를 지정해야 합니다. 값은 필드 경로 목록입니다.

예를 들면 다음과 같습니다.
  • 사용 가능한 모든 필드의 필드 마스크: fields: ['*']
  • 경로 수준 소요 시간 및 거리의 필드 마스크: fields: ['durationMillis', 'distanceMeters']

와일드 카드 응답 필드 마스크 fields: ['*']는 다음과 같은 이유로 사용하지 않는 것이 좋습니다.
  • 필요한 필드만 선택하면 서버에서 계산 주기를 절약할 수 있으므로 지연 시간이 짧은 결과를 반환할 수 있습니다.
  • 프로덕션 작업에 필요한 필드만 선택하면 지연 시간 성능이 안정적으로 유지됩니다. 향후 더 많은 응답 필드가 추가될 수 있으며, 이러한 새 필드에는 추가 계산 시간이 필요할 수 있습니다. 모든 필드를 선택하거나 최상위 수준에서 모든 필드를 선택하면 추가하는 모든 새 필드가 응답에 자동으로 포함되므로 성능이 저하될 수 있습니다.
  • 필요한 필드만 선택하면 응답 크기가 작아지므로 네트워크를 통한 로드가 빨라집니다.
rows
행렬의 행입니다. 각 행은 출발지에 해당하며, 각각 목적지까지의 경로를 나타내는 RouteMatrixItem 배열을 포함합니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

RouteMatrixRow 클래스

google.maps.routes.RouteMatrixRow 클래스

RouteMatrix.computeRouteMatrix에 전달된 출처에 해당합니다. RouteMatrixItem 목록을 포함하며, 각 항목은 목적지까지의 경로를 나타냅니다.

const {RouteMatrixRow} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.
items
각 목적지의 경로 정보입니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

RouteMatrixItem 클래스

google.maps.routes.RouteMatrixItem 클래스

RouteMatrix.computeRouteMatrix에 전달된 출발지/목적지 쌍에 대해 계산된 경로 정보가 포함됩니다.

const {RouteMatrixItem} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.
condition
유형:  RouteMatrixItemCondition optional
경로를 찾았는지 여부를 나타냅니다.
distanceMeters
유형:  number optional
경로의 이동 거리(미터)입니다.
durationMillis
유형:  number optional
경로를 탐색하는 데 필요한 시간(밀리초)입니다. ComputeRouteMatrixRequest.routingPreference를 TRAFFIC_UNAWARE로 설정하면 이 값은 RouteMatrixItem.staticDurationMillis와 동일합니다. ComputeRouteMatrixRequest.routingPreference를 TRAFFIC_AWARE 또는 TRAFFIC_AWARE_OPTIMAL로 설정하면 교통 상황을 고려하여 이 값이 계산됩니다.

참고: 기간이 2^53밀리초를 초과하면 이 값은 Number.POSITIVE_INFINITY입니다.
error
유형:  RouteMatrixItemError optional
경로를 계산하는 중에 발생한 오류입니다.
fallbackInfo
유형:  FallbackInfo optional
서버가 이 특정 출발지/목적지 쌍에 대해 지정된 환경설정으로 경로를 계산할 수 없는 경우 다른 계산 모드를 사용하도록 대체될 수 있습니다. 대체 응답이 사용되면 이 필드에 대체 응답에 대한 자세한 정보가 포함됩니다. 그렇지 않으면 이 필드가 설정되지 않습니다.
localizedValues
RouteMatrixItem 속성의 텍스트 표현입니다.
staticDurationMillis
유형:  number optional
교통 상황을 고려하지 않고 경로를 이동하는 데 걸리는 시간입니다.

참고: 기간이 2^53밀리초를 초과하면 이 값은 Number.POSITIVE_INFINITY입니다.
travelAdvisory
유형:  RouteTravelAdvisory optional
경로에 대한 추가 정보입니다.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

ComputeRouteMatrixRequest 인터페이스

google.maps.routes.ComputeRouteMatrixRequest 인터페이스

경로 매트릭스 요청입니다.
destinations
응답 행렬의 열을 결정하는 목적지 배열입니다. 문자열로 전달되는 값은 주소, Plus Code 또는 장소 리소스 이름일 수 있습니다. 고도 값은 고려되지 않습니다.
fields
유형:  Iterable<string>
가져올 필드의 컬렉션입니다. 모든 필드에 ["*"]를 지정합니다.
origins
응답 행렬의 행을 결정하는 출발지 배열입니다. 문자열로 전달되는 값은 주소, Plus Code 또는 장소 리소스 이름일 수 있습니다. 고도 값은 고려되지 않습니다.

출발지와 목적지의 카디널리티에는 다음과 같은 몇 가지 크기 제한이 적용됩니다.
  • string 또는 Place로 지정된 출발지와 목적지의 총 개수는 50개 이하여야 합니다.
  • 출발지 수와 목적지 수의 곱은 625 이하여야 합니다.
  • ComputeRouteMatrixRequest.routingPreference가 TRAFFIC_AWARE_OPTIMAL로 설정된 경우 출발지와 목적지 수의 곱은 100 이하여야 합니다.
  • ComputeRouteMatrixRequest.travelMode가 TRANSIT로 설정된 경우 출발지와 목적지 수의 곱은 100 이하여야 합니다.
arrivalTime optional
유형:  Date optional
도착 시간입니다.

참고: ComputeRouteMatrixRequest.travelMode가 TRANSIT로 설정된 경우에만 설정할 수 있습니다. ComputeRouteMatrixRequest.departureTime 또는 ComputeRouteMatrixRequest.arrivalTime 중 하나를 지정할 수 있지만 둘 다 지정할 수는 없습니다. 대중교통 경로는 과거 최대 7일 또는 미래 최대 100일까지 사용할 수 있습니다.
departureTime optional
유형:  Date optional
출발 시간입니다. 이 값을 설정하지 않으면 요청을 보낸 시간이 기본값으로 사용됩니다.

참고: ComputeRouteMatrixRequest.travelMode가 TRANSIT로 설정된 경우에만 과거 시간을 지정할 수 있습니다. 대중교통 경로는 과거 최대 7일 또는 미래 최대 100일까지 사용할 수 있습니다.
extraComputations optional
요청을 완료하는 데 사용할 수 있는 추가 계산 목록입니다.

참고: 이러한 추가 계산은 응답에 추가 필드를 반환할 수 있습니다. 이러한 추가 필드는 응답에서 반환되도록 ComputeRouteMatrixRequest.fields에도 지정해야 합니다.
language optional
유형:  string optional
BCP-47 언어 코드(예: 'en-US' 또는 'sr-Latn') 자세한 내용은 유니코드 언어 ID를 참고하세요. 지원되는 언어 목록은 언어 지원을 참조하세요. 이 값을 제공하지 않으면 Google Maps JavaScript API 현지화 설정에서 언어가 추론됩니다. 그렇지 않으면 첫 번째 출처의 위치에서 언어가 추론됩니다.
region optional
유형:  string optional
ccTLD ('최상위 도메인') 2자리 값으로 지정되는 지역 코드입니다. 자세한 내용은 국가 코드 최상위 도메인을 참고하세요. 이 값을 제공하지 않으면 Google Maps JavaScript API 현지화 설정에서 지역이 추론됩니다. 그렇지 않으면 첫 번째 원본의 위치에서 리전이 추론됩니다.
routingPreference optional
유형:  RoutingPreference optional
경로 매트릭스를 계산하는 방법을 지정합니다. 서버는 선택한 경로 기본 설정을 사용하여 경로 매트릭스를 계산하려고 시도합니다. 라우팅 환경설정으로 인해 오류가 발생하거나 지연 시간이 너무 길어지면 오류가 반환됩니다. ComputeRouteMatrixRequest.travelMode가 DRIVING 또는 TWO_WHEELER인 경우에만 이 옵션을 지정할 수 있습니다. 그렇지 않으면 요청이 실패합니다.
trafficModel optional
유형:  TrafficModel optional
이동 시간을 계산할 때 사용할 가정을 지정합니다. 이 설정은 이전 평균을 기반으로 한 예상 이동 시간이 포함된 RouteMatrixItem.durationMillis에 반환되는 값에 영향을 미칩니다. ComputeRouteMatrixRequest.trafficModel는 ComputeRouteMatrixRequest.routingPreference를 TRAFFIC_AWARE_OPTIMAL로, ComputeRouteMatrixRequest.travelMode를 DRIVING로 설정한 요청에만 사용할 수 있습니다. 기본값은 BEST_GUESS입니다.
transitPreference optional
유형:  TransitPreference optional
TRANSIT 경로에 대해 반환되는 경로에 영향을 미치는 환경설정을 지정합니다.

참고: ComputeRouteMatrixRequest.travelMode가 TRANSIT로 설정된 경우에만 지정할 수 있습니다.
travelMode optional
유형:  TravelMode optional
이동 수단을 지정합니다.
units optional
유형:  UnitSystem optional
표시 필드의 측정 단위를 지정합니다. 이 값을 제공하지 않으면 첫 번째 출발지의 위치에서 표시 단위가 추론됩니다.

ComputeRouteMatrixExtraComputation 상수

google.maps.routes.ComputeRouteMatrixExtraComputation 상수

RouteMatrix.computeRouteMatrix 요청에 대해 수행할 추가 계산입니다.

const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.
TOLLS 행렬 항목의 통행료 정보입니다.

RouteMatrixItemCondition 상수

google.maps.routes.RouteMatrixItemCondition 상수

특정 출발지/목적지 쌍의 경로 상태입니다.

const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.
ROUTE_EXISTS 경로를 찾았습니다.
ROUTE_NOT_FOUND 경로를 찾을 수 없습니다.

RouteMatrixItemError 클래스

google.maps.routes.RouteMatrixItemError 클래스

특정 출발지/목적지 쌍의 RouteMatrix.computeRouteMatrix 중에 발생한 오류입니다.

이 클래스는 Error를 확장합니다.

const {RouteMatrixItemError} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

RouteMatrixItemLocalizedValues 클래스

google.maps.routes.RouteMatrixItemLocalizedValues 클래스

RouteMatrixItem의 텍스트 표현입니다.

const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes")를 호출하여 액세스합니다.
Maps JavaScript API의 라이브러리를 참고하세요.
distance
유형:  string optional
경로 행렬 항목의 이동 거리(텍스트 형식)입니다.
distanceLanguage
유형:  string optional
거리 텍스트의 BCP-47 언어 코드입니다(예: 'en-US' 또는 'sr-Latn').

자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참고하세요.
duration
유형:  string optional
텍스트 형식으로 표시되고 쿼리 지역에 맞게 현지화된 기간입니다. 교통 상황을 고려합니다.

참고: 교통정보를 요청하지 않은 경우 이 값은 RouteMatrixItemLocalizedValues.staticDuration와 동일합니다.
durationLanguage
유형:  string optional
기간 텍스트의 BCP-47 언어 코드입니다(예: 'en-US' 또는 'sr-Latn').

자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참고하세요.
staticDuration
유형:  string optional
교통 상황을 고려하지 않은 소요 시간으로, 텍스트 형식으로 표시됩니다.
staticDurationLanguage
유형:  string optional
정적 기간 텍스트의 BCP-47 언어 코드입니다(예: 'en-US' 또는 'sr-Latn').
transitFare
유형:  string optional
텍스트 형식으로 표시되는 대중교통 요금입니다.
transitFareLanguage
유형:  string optional
대중교통 요금 텍스트의 BCP-47 언어 코드입니다(예: 'en-US' 또는 'sr-Latn').

자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참고하세요.
toJSON
toJSON()
매개변수: 없음
반환 값:  Object
객체로 변환합니다.

RouteMatrixOrigin 인터페이스

google.maps.routes.RouteMatrixOrigin 인터페이스

ComputeRouteMatrixRequest의 단일 출처입니다.
waypoint
원본의 위치입니다. 문자열로 전달되는 값은 주소 또는 플러스 코드일 수 있습니다. 고도 값은 고려되지 않습니다.
routeModifiers optional
유형:  RouteModifiers optional
이 위치를 출발지로 사용하는 모든 경로의 수정자입니다.