Address QML Type

Address QML 유형은 특정 위치를 도로 주소로 나타냅니다. 더 보기...

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

속성

• address : QGeoAddress
• city : string
• country : string
• countryCode : string
• county : string
• district : string
• isTextGenerated : bool
• postalCode : string
• state : string
• street : string
• streetNumber : string (since QtPositioning 6.2)
• text : string

상세 설명

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

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

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

사용 예시

다음 코드 조각은 Address 객체의 선언을 보여줍니다.

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

이 속성은 부울 값을 가지며, true인 경우 주소 속성(address properties)을 기반으로 주소 기반 식별자( text )가 자동으로 생성됨을 나타냅니다. false인 경우, 주소 기반 식별자( text )가 명시적으로 할당되었음을 나타냅니다.

postalCode : string

이 속성은 주소의 우편번호를 서식이 지정된 단일 문자열로 저장합니다.

state : string

이 속성은 주소의 상태를 단일 서식 지정된 문자열로 저장합니다.

street : string

이 속성은 주소의 도로명을 포함합니다.

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 속성에는 영향을 미치지 않습니다.