Location QML Type

위치 유형에는 위치 데이터가 저장됩니다. 더 보기...

Import Statement: import QtPositioning

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

속성

address : Address
boundingShape : geoshape (since QtPositioning 6.2)
coordinate : coordinate
location : QGeoLocation

상세 설명

위치 유형은 인간적인 의미에서 지리적 '위치'를 나타냅니다. 특정 coordinate, address 및 bounding shape 로 구성됩니다. bounding shape 은 이 위치를 볼 때 표시할 권장 지역을 나타냅니다.

위치 유형은 GeocodeModel 과 같은 검색 모델의 콘텐츠로 가장 흔히 볼 수 있습니다. GeocodeModel 이 특정 쿼리에 대해 검색된 위치 목록을 반환하는 경우, 위치 개체로 표시됩니다.

사용 예

다음은 간단한 Location 객체를 선언하는 예시입니다:

Location {
    coordinate {
        latitude: -27.3
        longitude: 153.1
    }
    address: Address {
        ...
    }
}

속성 문서

address : Address

이 속성은 위치의 주소 세부 정보를 검색하는 데 사용할 수 있는 위치의 주소를 보유합니다.

boundingShape : geoshape [since QtPositioning 6.2]

이 속성에는 위치를 표시할 때 사용할 권장 지역이 저장됩니다. 예를 들어, 건물의 위치에는 건물을 중심으로 한 지역이 있을 수 있지만 이 지역은 주변 지리적 컨텍스트를 표시하기에 충분히 넓습니다.

참고: 이 속성의 변경() 신호는 현재 객체의 내용만 변경되는 경우가 아니라 전체 객체가 변경되는 경우에만 발생합니다.

참고: 이 프로퍼티는 Qt6에서 boundingBox 프로퍼티 대신 도입되었습니다. georectangle 대신 geoshape 를 반환합니다. QGeoShape::boundingGeoRectangle()를 사용하여 도형의 경계 georectangle 를 얻습니다.

반환된 도형을 특정 유형으로 변환해야 하는 경우 geoshape 의 type 속성을 QtPositioning.shapeToRectangle()와 같은 QtPositioning 의 편의 메서드와 함께 사용합니다.

이 프로퍼티는 QtPositioning 6.2에 도입되었습니다.

coordinate : coordinate

이 속성은 위치의 위도, 경도 및 고도를 검색하는 데 사용할 수 있는 위치의 정확한 지리적 좌표를 보유합니다.

참고: 이 속성의 변경() 신호는 현재 객체의 내용만 변경되는 경우가 아니라 전체 객체가 변경되는 경우에만 발생합니다.

location : QGeoLocation

이 프로퍼티를 사용하여 C++와 QML 간 인터페이스하는 방법에 대한 자세한 내용은"C++와 QML 코드 간 인터페이스"를 참조하세요.

참고: 이 속성은 전체 지리적 위치 정보를 업데이트하므로 이 속성을 사용하면 다른 모든 속성에 대한 모든 바인딩이 깨지게 됩니다.

© 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.