RouteRequestRouteMatrixQueryParamProperties interface

선택적 표준 시간대 오프셋이 있는 dateTime정의된 대로 값으로 서식이 지정된 대상 지점의 도착 날짜 및 시간입니다. 표준 시간대 오프셋을 지정하지 않으면 대상 지점의 오프셋으로 간주됩니다.

예:

• 2023-12-19T16:39:57
• 2023-12-19T16:39:57-08:00

arriveAt 매개 변수는 departAt, minDeviationDistance 또는 minDeviationTime함께 사용할 수 없습니다.

arriveAt?: string | Date

속성 값

경로를 결정할 때 경로 계산에서 피해야 하는 항목을 지정합니다. 한 요청에서 여러 번 지정할 수 있습니다( 예: '&avoid=motorways&avoid=tollRoads&avoid=ferries'). 경로 범위 요청에서 이미UsedRoads 값을 사용하면 안 됩니다.

avoid?: ("tollRoads" | "motorways" | "ferries" | "unpavedRoads" | "carpools" | "alreadyUsedRoads" | "borderCrossings")[]

속성 값

다양한 유형의 교통 정보(없음, 기록, 라이브)와 기본 최적 예상 이동 시간을 사용하여 추가 이동 시간을 반환할지 여부를 지정합니다.

computeTravelTimeFor?: "none" | "all"

속성 값

선택적 표준 시간대 오프셋이 있는 dateTime정의된 대로 값으로 서식이 지정된 원점에서 출발 날짜 및 시간입니다. 표준 시간대 오프셋을 지정하지 않으면 원점의 오프셋으로 간주됩니다.

• 기본값: now
• 기타 값: dateTime

예:

• 2023-12-19T16:39:57
• 2023-12-19T16:39:57-08:00

departAt 매개 변수는 arriveAt함께 사용할 수 없습니다.

departAt?: string | Date

속성 값

스릴 넘치는 경로에 대한 언덕의 정도. 이 매개 변수는 routeType=thrilling과 함께만 사용할 수 있습니다.

hilliness?: "low" | "normal" | "high"

속성 값

요청된 경로의 유형입니다.

routeType?: "fastest" | "shortest" | "eco" | "thrilling"

속성 값

경로 응답에서 보고되는 섹션 유형을 지정합니다.

예를 들어 sectionType = 보행자에 적합한 구역만 반환됩니다. 한 요청에서 여러 번 지정할 수 있습니다(예: '§ionType=carTrain§ionType=pedestrian§ionType=motorway'). 기본 sectionType은 travelMode 입력을 참조합니다. 기본적으로 travelMode는 자동차로 설정됩니다.

sectionType?: ("carTrain" | "country" | "ferry" | "motorway" | "pedestrian" | "tollRoad" | "tollVignette" | "traffic" | "travelMode" | "tunnel" | "carpool" | "urban")[]

속성 값

가능한 값:

• true - 라우팅 중에 사용 가능한 모든 트래픽 정보를 고려하세요.
• false - 라우팅 중에 현재 트래픽 데이터를 무시합니다. 라우팅 중에는 현재 트래픽 데이터가 무시되지만, 기록 트래픽이 효과적인 도로 속도에 미치는 영향은 여전히 통합되어 있습니다.

traffic?: boolean

속성 값

요청된 경로에 대한 이동 모드입니다. 정의되지 않은 경우 기본값은 'car'입니다. 요청된 travelMode를 전체 경로에 사용할 수 없습니다. 요청된 travelMode를 특정 섹션에 사용할 수 없는 경우 해당 섹션에 대한 응답의 travelMode 요소는 "other"가 됩니다. 여행 모드 버스, 오토바이, 택시 및 밴은 BETA 기능입니다. 일부 영역에서는 전체 제한 데이터를 사용할 수 없습니다.

travelMode?: "pedestrian" | "car" | "truck" | "taxi" | "bus" | "van" | "motorcycle" | "bicycle"

속성 값

차량의 차축당 무게(kg)입니다. 값이 0이면 액슬당 가중치 제한이 고려되지 않습니다.

vehicleAxleWeight?: number

속성 값

차량의 높이(미터)입니다. 값이 0이면 높이 제한이 고려되지 않습니다.

vehicleHeight?: number

속성 값

차량의 길이(미터)입니다. 값이 0이면 길이 제한이 고려되지 않습니다.

vehicleLength?: number

속성 값

위험 물질로 분류되고 일부 도로에서 제한될 수 있는 화물 유형입니다. 사용 가능한 vehicleLoadType 값은 미국 Hazmat 클래스 1~9와 다른 국가/지역에서 사용할 일반 분류입니다. USHazmat로 시작하는 값은 미국 라우팅을 위한 것이고 다른 모든 국가/지역에는 otherHazmat을 사용해야 합니다. vehicleLoadType을 여러 번 지정할 수 있습니다. 이 매개 변수는 현재 travelMode=truck에 대해서만 고려됩니다.

vehicleLoadType?: "USHazmatClass1" | "USHazmatClass2" | "USHazmatClass3" | "USHazmatClass4" | "USHazmatClass5" | "USHazmatClass6" | "USHazmatClass7" | "USHazmatClass8" | "USHazmatClass9" | "otherHazmatExplosive" | "otherHazmatGeneral" | "otherHazmatHarmfulToWater"

속성 값

차량의 최대 속도(km/hour)입니다. 차량 프로필의 최대 속도는 차량이 고속도로에서 허용되는지 여부를 확인하는 데 사용됩니다.

• 값이 0이면 경로 계획 중에 차량에 대한 적절한 값이 결정되고 적용됩니다.

• 경로 계획 중에 0이 아닌 값이 재정의될 수 있습니다. 예를 들어 현재 트래픽 흐름은 시속 60km입니다. 차량 최대 속도를 시속 50km로 설정하면 라우팅 엔진은 현재 상황이므로 60km/시속을 고려합니다. 차량의 최대 속도는 80km/시속으로 제공되지만 현재 교통 흐름은 시속 60km인 경우 라우팅 엔진은 시속 60km를 다시 사용합니다.

vehicleMaxSpeed?: number

속성 값

차량의 무게(킬로그램)입니다.

vehicleWeight?: number

속성 값

차량 너비(미터)입니다. 값이 0이면 너비 제한이 고려되지 않습니다.

vehicleWidth?: number

속성 값

요청을 동기적으로 실행할지 여부를 나타내는 부울입니다. true로 설정하면 요청이 120초 미만으로 완료되면 사용자에게 200 응답이 표시됩니다. 그렇지 않으면 사용자는 즉시 202 응답을 받게 됩니다. 202 응답에 대한 자세한 내용은 API 설명을 참조하세요. 비동기 요청대해서만 지원됩니다.

waitForResults?: boolean

속성 값

스릴 넘치는 경로에 대한 회전의 수준. 이 매개 변수는 routeType=thrilling과 함께만 사용할 수 있습니다.

windingness?: "low" | "normal" | "high"

속성 값