RouteQuery QML Type

RouteQuery 유형은 RouteModel 에 쿼리 매개변수를 전달하는 데 사용됩니다. 더 보기...

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

속성

• 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)

상세 설명

RouteQuery는 라우팅 서비스에 요청을 보내는 데 필요한 모든 매개변수를 묶어두는 데 사용되며, 이를 통해 RouteModel 의 내용을 채울 수 있습니다.

이러한 매개변수는 통과해야 할 waypoints, 피해야 할 excludedAreas, 사용 중인 travelModes 와 같은 경로의 주요 세부 정보는 물론, 경로를 최적화하는 방법 및 경로상에서 선호하거나 피해야 할 기능(유료 도로, 고속도로 등)에 대한 세부적인 선호 사항도 설명합니다.

RouteQuery 객체는 RouteModel 의 query 속성 값을 채우는 데만 사용되며, 이를 통해 모델을 채우기 위한 검색 프로세스를 시작할 수 있습니다.

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

사용 예

다음 코드 조각은 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

경로 설정 기동을 표현하는 데 사용될 세부 수준.

기본값은 ‘ RouteQuery.BasicManeuvers ’입니다.

numberAlternativeRoutes : int

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

routeOptimizations : enumeration

경로 계획 시 고려해야 할 경로 최적화 사항입니다. 값들은 OR('|') 연산자를 사용하여 결합할 수 있습니다.

기본값은 RouteQuery.FastestRoute 입니다.

segmentDetail : enumeration

라우팅 세그먼트를 표현할 때 사용될 세부 수준.

기본값은 ` RouteQuery.BasicSegmentData`입니다.

travelModes : enumeration

경로를 계획할 때 고려해야 할 이동 수단입니다. 값들은 OR('|') 연산자를 사용하여 결합할 수 있습니다.

기본값은 RouteQuery.CarTravel 입니다.

waypoints : list<coordinate>

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

웨이포인트는 ` RouteQuery ` 유형 선언의 일부로 설정하거나, 제공된 함수를 사용하여 동적으로 설정할 수 있습니다.

addWaypoint, removeWaypoint 및 clearWaypoints도 참조하십시오 .

메서드 문서

void addExcludedArea(geoRectangle area)

지정된 geoRectangle 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 ’을 정의합니다.

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

featureTypes, resetFeatureWeights 및 featureWeight도 참조하십시오 .