Route Matrix (beta)

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: ['*']를 사용하지 않는 것이 좋습니다.
  • 필요한 필드만 선택하면 서버에서 계산 주기를 절약할 수 있으므로 지연 시간이 짧은 결과를 반환할 수 있습니다.
  • 프로덕션 작업에 필요한 필드만 선택하면 지연 시간 성능이 안정적으로 유지됩니다. 향후 응답 필드가 추가될 수 있으며 이러한 새 필드에는 추가 계산 시간이 필요할 수 있습니다. 모든 필드를 선택하거나 최상위 수준에서 모든 필드를 선택하면 Google에서 추가하는 새 필드가 응답에 자동으로 포함되므로 성능이 저하될 수 있습니다.
  • 필요한 필드만 선택하면 응답 크기가 작아지므로 네트워크를 통한 로드가 더 빨라집니다.
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
경로에 대한 추가 정보입니다.

ComputeRouteMatrixRequest 인터페이스

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

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

출발지 및 목적지의 카디널리티에는 다음과 같은 여러 크기 제한이 적용됩니다.
  • 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') 자세한 내용은 유니코드 언어 식별자를 참고하세요. 지원되는 언어 목록은 언어 지원을 참고하세요. 이 값을 제공하지 않으면 언어가 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
이 경로를 원점으로 사용하는 모든 경로의 수정자입니다.