Back to Qt.io
Contact Us Blog Download Qt

Address QML Type

주소 QML 유형은 특정 위치를 도로명 주소로 나타냅니다. 자세히...

Import Statement: import QtPositioning

속성

상세 설명

주소는 (역)지오코딩 또는 장소 검색과 같은 쿼리의 데이터 단위로 사용되며, 이러한 작업의 대부분은 주소를 받거나 주소를 반환합니다.

주소의 모든 속성이 반드시 전 세계 모든 지역 및 모든 로캘에서 사용 가능하거나 관련성이 있는 것은 아닙니다. district , state 및 county 속성은 특히 많은 데이터 소스에서 지역별로 다르며, 이 중 하나 또는 두 개만 사용 가능하거나 유용한 경우가 많습니다.

주소에는 형식이 지정된 문자열을 포함하는 text 속성이 있습니다. 이는 사용자에게 주소를 표시하는 데 권장되는 방법이며 일반적으로 봉투에 있는 주소 형식을 사용하지만 항상 그런 것은 아닙니다. text 는 street, city 등과 같은 구성 주소 속성에서 자동으로 생성될 수도 있지만 명시적으로 지정할 수도 있습니다. 자세한 내용은 text 을 참조하세요.

사용 예

다음 코드 스니펫은 주소 객체의 선언을 보여줍니다.

Address {
    id: address
    street: "53 Brandl St"
    city: "Eight Mile Plains"
    country: "Australia"
    countryCode: "AUS"
}

이를 예를 들어 지오코딩 쿼리의 값으로 사용하여 주소의 정확한 경도와 위도를 얻을 수 있습니다.

QGeoAddress 를참조하세요 .

속성 문서

address : QGeoAddress

이 속성을 사용하여 C++과 QML 간 인터페이스하는 방법에 대한 자세한 내용은"C++과 QML 코드 간 인터페이스"를 참조하세요.


city : string

이 속성은 주소의 도시를 단일 형식의 문자열로 보유합니다.


country : string

이 속성은 주소의 국가를 단일 형식의 문자열로 보유합니다.


countryCode : string

이 속성은 주소의 국가 코드를 단일 형식의 문자열로 보유합니다.


county : string

이 속성은 주소의 카운티를 단일 형식의 문자열로 보유합니다.


district : string

이 속성은 주소의 구를 단일 형식의 문자열로 보유합니다.


isTextGenerated : bool

이 속성은 참이면 주소 속성에서 text 이 자동으로 생성되었음을 나타내는 부울을 보유합니다. 거짓이면 text 주소가 명시적으로 할당되었음을 나타냅니다.


postalCode : string

이 속성은 주소의 우편번호를 단일 형식의 문자열로 보유합니다.


state : string

이 속성은 주소의 상태를 단일 형식의 문자열로 보유합니다.


street : string

이 속성은 주소의 거리를 보유합니다.

참고: Qt6 이전에는 이 속성에 동호수, 건물 이름 등 주소를 다른 주소와 구별하는 데 사용할 수 있는 다른 항목도 포함할 수 있었습니다. Qt6부터는 이러한 정보에 streetNumber 속성을 사용합니다.


streetNumber : string [since QtPositioning 6.2]

이 속성은 동호수, 건물 이름 또는 한 주소를 다른 주소와 구별하는 데 사용될 수 있는 다른 모든 것과 같은 주소의 도로 번호를 보유합니다.

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


text : string

이 프로퍼티는 주소를 단일 형식의 문자열로 저장합니다. 사용자에게 주소를 표시하는 데 사용하는 것이 권장되는 문자열입니다. 일반적으로 봉투에 있는 주소 형식을 취하지만 항상 그런 것은 아닙니다.

text 주소는 자동으로 생성되거나 명시적으로 할당되며, isTextGenerated 을 확인하여 확인할 수 있습니다.

빈 문자열이 text 에 할당된 경우 isTextGenerated 은 true로 설정되고 text 는 countryCode 에 따라 주소의 속성에 따라 로컬로 형식이 지정된 문자열을 반환합니다. street , city 등과 같은 주소 속성을 수정하면 text 의 내용이 변경될 수 있습니다.

비어 있지 않은 문자열이 text 에 할당된 경우 isTextGenerated 은 false로 설정되고 text 은 항상 명시적으로 할당된 문자열을 반환합니다. 주소 속성을 수정해도 text 속성에는 영향을 미치지 않습니다.


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