변경 사항 Qt Location
Qt 6의 변경 사항은 프레임워크를 더 효율적이고 사용하기 쉽게 만들기 위한 의도적인 노력의 결과입니다.
저희는 각 릴리스에서 모든 공개 API에 대해 바이너리 및 소스 호환성을 유지하기 위해 노력하고 있습니다. 하지만 Qt를 더 나은 프레임워크로 만들기 위한 노력의 일환으로 일부 변경 사항은 불가피했습니다.
이 주제에서는 Qt Location 에 포함된 변경 사항을 요약하고, 이를 처리하기 위한 지침을 제공합니다.
공개 API의 호환성을 깨는 변경 사항
맵
MapRectangle::backend,MapCircle::backend,MapPolyline::backend및MapPolygon::backend속성이 제거되었습니다.- 이전의 경로 설정 관련 QML 요소 유형인
Route,RouteSegment및RouteManeuver는 이제 값 유형 route, routeSegment 및 routeManeuver 로 변경되었습니다. 더 이상 QML에서 항목으로 인스턴스화할 수 없으며, 해당 속성에 바인딩할 수도 없습니다. - 이전의 매핑(Mapping) 관련 QML 요소 유형인
MapType및CameraCapabilities는 이제 값 유형인 mapType 및 cameraCapabilities 로 변경되었습니다. 이 유형들은 더 이상 QML에서 아이템으로 인스턴스화할 수 없으며, 해당 속성에 바인딩할 수도 없습니다. QGeoRouteLeg클래스와 이에 상응하는 QML 요소인RouteLeg는 QGeoRoute (및 route 유형)로 통합되었습니다. 하나의 경로(route)는 여러 경로의 집합이 될 수 있습니다.- Map 유형은 이제 사용자 입력을 처리하지 않는 최소한의 기능만 제공합니다.
MapGestureArea는 제거되었습니다. MapView 유형은 탭 및 드래그 이벤트와 같은 기본적인 사용자 입력을 처리합니다.
장소
QPlaceImage,QPlaceEditorial및QPlaceReview클래스는 QPlaceContent 로 통합되었습니다.- QPlaceContent API는 QVariant 값 목록에 접근할 수 있도록 변경되었습니다.
- 이전의 QML 요소 유형인
PlaceUser,PlaceRatings,PlaceAttribute,PlaceIcon,PlaceSupplier및PlaceContactDetail는 이제 값 유형인 user, ratings, placeAttribute, icon, supplier 및 contactDetail 가 되었습니다. 더 이상 QML에서 항목으로 인스턴스화할 수 없으며, 해당 속성에 바인딩할 수도 없습니다.
실험용 API
"labs" 상태였던 기능들이 제거되었습니다. 여기에는 단계별 내비게이션을 위한 실험적 프레임워크와 MapObjects 추상화가 포함됩니다.
백엔드 프로바이더 API
백엔드 프로바이더 API는 더 이상 바이너리 및 소스 호환성이 보장되지 않습니다.
기타 API 변경 사항
이 섹션에는 소스 호환성을 깨지 않는 API 개선 사항이 포함되어 있습니다. 다만 이러한 변경 사항이 애플리케이션 로직에 영향을 미칠 수 있으므로, 이에 대해 알아두는 것이 여전히 유용합니다.
© 2026 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.