RouteQuery QML Type

RouteQuery 유형은 RouteModel...에 쿼리 매개 변수를 제공하는 데 사용됩니다.. ..

Import Statement:	`import QtLocation 6.8`
Since:	QtLocation 5.5

상속된 멤버를 포함한 모든 멤버 목록

속성

departureTime : date
excludedAreas : list<georectangle>
featureTypes : QList<FeatureType>
maneuverDetail : enumeration
numberAlternativeRoutes : int
routeOptimizations : enumeration
segmentDetail : enumeration
travelModes : enumeration
waypoints : list<coordinate>

방법

void addExcludedArea(georectangle area)
void addWaypoint(coordinate)
void clearExcludedAreas()
void clearWaypoints()
FeatureWeight featureWeight(FeatureType featureType)
void removeExcludedArea(georectangle area)
void removeWaypoint(coordinate)
void resetFeatureWeights()
void setFeatureWeight(FeatureType feature, FeatureWeight weight)

상세 설명

라우팅 쿼리는 라우팅 서비스에 요청하는 데 필요한 모든 파라미터를 패킹하는 데 사용되며, 이를 통해 RouteModel 의 내용을 채울 수 있습니다.

이러한 매개변수에는 통과할 waypoints, 피할 excludedAreas, 사용 중인 travelModes 등 경로의 주요 세부 정보와 경로를 최적화하는 방법 및 경로를 따라 선호하거나 피할 기능(유료 도로, 고속도로 등)에 대한 자세한 기본 설정이 설명되어 있습니다.

RouteQuery 객체는 RouteModel 의 query 속성 값을 채우는 데만 사용되며, 그러면 검색 프로세스를 시작하여 모델을 채울 수 있습니다.

일부 플러그인은 작동을 위해 특정 매개 변수를 허용하거나 요구할 수 있습니다. 이러한 플러그인별 매개변수를 지정하기 위해 MapParameter 요소를 RouteQuery 안에 중첩할 수 있습니다.

사용 예

다음 스니펫은 RouteQuery 객체를 만들어 RouteModel 의 query 속성 값으로 설정하는 불완전한 예시를 보여줍니다.

RouteQuery {
    id: aQuery
}

RouteModel {
    query: aQuery
    autoUpdate: false
}

보다 완전한 예제는 RouteModel 유형에 대한 문서와 Mapviewer 예제를 참조하세요.

RouteModel도 참조하세요 .

속성 문서

departureTime : date

경로를 쿼리할 때 사용할 출발 시간입니다. 기본값은 유효하지 않은 날짜로, 쿼리에 출발 시간이 사용되지 않습니다.

excludedAreas : list<georectangle>

경로가 통과해서는 안 되는 지역.

제외 지역은 RouteQuery 유형 선언의 일부로 설정하거나 제공된 함수를 사용하여 동적으로 설정할 수 있습니다.

addExcludedArea, removeExcludedArea, clearExcludedAreas 를참조하세요 .

featureTypes : QList<FeatureType> [read-only]

경로를 계획할 때 고려할 기능 목록입니다. 가중치가 NeutralFeatureWeight인 기능은 반환되지 않습니다.

RouteQuery.NoFeature - 경로를 계획할 때 고려할 기능이 없습니다.
RouteQuery.TollFeature - 경로를 계획할 때 유료 도로를 고려합니다.
RouteQuery.HighwayFeature - 경로를 계획할 때 고속도로를 고려합니다.
RouteQuery.PublicTransitFeature - 경로를 계획할 때 대중 교통을 고려합니다.
RouteQuery.FerryFeature - 경로를 계획할 때 페리를 고려합니다.
RouteQuery.TunnelFeature - 경로를 계획할 때 터널을 고려합니다.
RouteQuery.DirtRoadFeature - 경로를 계획할 때 비포장 도로를 고려합니다.
RouteQuery.ParksFeature - 경로를 계획할 때 공원을 고려합니다.
RouteQuery.MotorPoolLaneFeature - 경로를 계획할 때 모터 풀 차선을 고려합니다.
RouteQuery.TrafficFeature - 경로를 계획할 때 교통량을 고려합니다.

setFeatureWeight 및 featureWeight 을참조하십시오 .

maneuverDetail : enumeration

라우팅 기동 표현에 사용되는 세부 수준입니다.

Constant	설명
`RouteQuery.NoManeuvers`	경로에 기동을 포함하지 않아야 합니다.
`RouteQuery.BasicManeuvers`	기본 기동이 경로에 포함됩니다.

기본값은 RouteQuery.BasicManeuvers 입니다.

numberAlternativeRoutes : int

경로 요청 시 요청되는 대체 경로의 수입니다. 기본값은 0입니다.

routeOptimizations : enumeration

경로를 계획하는 동안 고려해야 하는 경로 최적화입니다. 값은 OR('|') 연산자와 결합할 수 있습니다.

상수	설명
`RouteQuery.ShortestRoute`	여정 길이 최소화
`RouteQuery.FastestRoute`	여정의 이동 시간을 최소화합니다.
`RouteQuery.MostEconomicRoute`	여정 비용 최소화
`RouteQuery.MostScenicRoute`	여정의 경치 잠재력 최대화

기본값은 RouteQuery.FastestRoute 입니다.

segmentDetail : enumeration

라우팅 세그먼트의 표현에 사용되는 세부 수준입니다.

상수	설명
`RouteQuery.NoSegmentData`	경로에 구간 데이터가 포함되지 않아야 합니다.
`RouteQuery.BasicSegmentData`	기본 세그먼트 데이터가 경로에 포함됩니다.

기본값은 RouteQuery.BasicSegmentData 입니다.

travelModes : enumeration

경로를 계획하는 동안 고려해야 하는 여행 모드입니다. 값은 OR('|') 연산자와 결합할 수 있습니다.

상수	설명
`RouteQuery.CarTravel`	자동차를 운전하는 사람에게 경로가 최적화됩니다.
`RouteQuery.PedestrianTravel`	걷는 사람에게 최적화된 경로를 생성합니다.
`RouteQuery.BicycleTravel`	자전거를 타는 사람에게 최적화된 경로를 제공합니다.
`RouteQuery.PublicTransit`	여행 대중교통을 이용하는 사람에게 최적화된 경로입니다.
`RouteQuery.TruckTravel`	트럭을 운전하는 사람에게 최적화된 경로를 제공합니다.

기본값은 RouteQuery.CarTravel 입니다.

waypoints : list<coordinate>

원하는 경로의 경유지 좌표입니다. 경유지는 출발지에서 목적지까지 순서대로 지정해야 합니다. 두 개 이상의 좌표가 필요합니다.

경유지는 RouteQuery 유형 선언의 일부로 설정하거나 제공된 함수를 사용하여 동적으로 설정할 수 있습니다.

addWaypoint, removeWaypoint, clearWaypoints 를참조하세요 .

메서드 문서

void addExcludedArea(georectangle area)

제외 영역(경로가 교차해서는 안 되는 영역)에 지정된 지오렉트릭스 area 를 추가합니다. 동일한 영역은 한 번만 추가할 수 있습니다.

removeExcludedArea 및 clearExcludedAreas 을참조하세요 .

void addWaypoint(coordinate)

경유지 목록에 지정된 coordinate 을 추가합니다. 동일한 좌표를 여러 번 설정할 수 있습니다.

removeWaypoint 및 clearWaypoints도 참조 하세요.

void clearExcludedAreas()

제외된 지역(경로가 통과해서는 안 되는 지역)을 모두 지웁니다.

addExcludedArea 및 removeExcludedArea도 참조 하세요.

void clearWaypoints()

모든 경유지를 지웁니다.

removeWaypoint 및 addWaypoint도 참조 하세요.

FeatureWeight featureWeight(FeatureType featureType)

featureType 의 가중치를 가져옵니다.

featureTypes, setFeatureWeight, resetFeatureWeights도 참조 하세요.

void removeExcludedArea(georectangle area)

지정된 area 을 제외 영역(경로가 통과해서는 안 되는 영역)에서 제거합니다.

addExcludedArea 및 clearExcludedAreas도 참조하십시오 .

void removeWaypoint(coordinate)

경유지 목록에서 지정된 coordinate 을 제거합니다. 동일한 좌표가 여러 번 나타나면 가장 최근에 추가된 좌표 인스턴스가 제거됩니다.

addWaypoint 및 clearWaypoints도 참조 하세요.

void resetFeatureWeights()

모든 피처 가중치를 기본 상태(NeutralFeatureWeight)로 재설정합니다.

featureTypes, setFeatureWeight, featureWeight도 참조 하세요.

void setFeatureWeight(FeatureType feature, FeatureWeight weight)

경로를 계획하는 동안 feature 과 연결할 weight 을 정의합니다.

다음은 사용 가능한 피처 가중치 목록입니다:

상수	설명
`RouteQuery.NeutralFeatureWeight`	피처의 유무는 경로 계획에 영향을 미치지 않습니다.
`RouteQuery.PreferFeatureWeight`	기능이 포함된 경로가 포함되지 않은 경로보다 선호됩니다.
`RouteQuery.RequireFeatureWeight`	기능이 포함된 경로만 고려되며, 그렇지 않으면 경로가 반환되지 않습니다.
`RouteQuery.AvoidFeatureWeight`	기능을 포함하지 않는 경로가 기능을 포함하는 경로보다 우선합니다.
`RouteQuery.DisallowFeatureWeight`	기능을 포함하지 않는 경로만 고려하고 그렇지 않으면 경로를 반환하지 않습니다.

featureTypes, resetFeatureWeights, featureWeight 를참조하세요 .

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.