PySide6.QtPositioning.QGeoAddress

class QGeoAddress

QGeoAddress 类表示 QGeoLocation 的地址。更多

概要

方法

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题,您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述

地址的属性被标准化为美国特征名称,并且可以映射到本地特征级别(例如,州在德国匹配“Bundesland”)。

地址包含一个text()用于显示目的,以及用于访问地址组件的附加属性:

__init__()

默认构造函数。

__init__(other)
Parameters:

其他QGeoAddress

构造other的副本。

city()
Return type:

字符串

返回城市。

另请参阅

setCity()

clear()

清除地址的所有数据字段。

country()
Return type:

字符串

返回国家名称。

另请参阅

setCountry()

countryCode()
Return type:

字符串

根据ISO 3166-1 alpha-3返回国家代码

另请参阅

setCountryCode()

county()
Return type:

字符串

返回县。县被认为是国家以下的第二级行政区划。

另请参阅

setCounty()

district()
Return type:

字符串

返回地区。地区被认为是城市以下的细分。

另请参阅

setDistrict()

isEmpty()
Return type:

布尔

返回此地址是否为空。如果所有字段都为空,则认为该地址为空。

isTextGenerated()
Return type:

布尔

如果text()是从地址元素自动生成的,则返回true,否则如果text()已被显式分配,则返回false。

另请参阅

text() setText()

__ne__(rhs)
Parameters:

rhsQGeoAddress

Return type:

布尔

如果 lhs 地址不等于 rhs,则返回 true,否则返回 false

__eq__(rhs)
Parameters:

rhsQGeoAddress

Return type:

布尔

如果 lhs 地址等于 rhs,则返回 true,否则返回 false

postalCode()
Return type:

字符串

返回邮政编码。

另请参阅

setPostalCode()

setCity(city)
Parameters:

城市 – str

设置city

另请参阅

city()

setCountry(country)
Parameters:

国家 – str

设置country名称。

另请参阅

country()

setCountryCode(countryCode)
Parameters:

countryCode – str

根据ISO 3166-1 alpha-3设置countryCode

另请参阅

countryCode()

setCounty(county)
Parameters:

county – str

设置county

另请参阅

county()

setDistrict(district)
Parameters:

district – str

设置 district

另请参阅

district()

setPostalCode(postalCode)
Parameters:

postalCode – str

设置postalCode

另请参阅

postalCode()

setState(state)
Parameters:

state – str

设置state

另请参阅

state()

setStreet(street)
Parameters:

街道 – str

将街道名称设置为 street

注意

在Qt6之前,这可能还包含诸如单元号、建筑物名称或任何其他可能用于区分一个地址与另一个地址的内容。现在使用setStreetNumber()来设置这些数据。

setStreetNumber(streetNumber)
Parameters:

streetNumber – str

将街道号码设置为 streetNumber

这也可能包含诸如单元号、建筑物名称或任何其他可能用于区分一个地址与另一个地址的内容。

注意

在Qt6之前,此信息由setStreet()方法设置。

setText(text)
Parameters:

文本 – str

如果 text 不为空,则显式地将 text 分配为由 text() 返回的字符串。isTextGenerated() 将返回 false。

如果 text 为空,表示 text() 应该从地址元素自动生成。isTextGenerated() 将返回 true。

另请参阅

text()

state()
Return type:

字符串

返回状态。状态被认为是国家以下的第一个细分。

另请参阅

setState()

street()
Return type:

字符串

返回街道名称。

注意

在Qt6之前,这可能还包含诸如单元号、建筑物名称或任何其他可能用于区分一个地址与另一个地址的内容。现在使用streetNumber()来获取这些数据。

streetNumber()
Return type:

字符串

返回街道号码。

这也可能包含诸如单元号、建筑物名称或任何其他可能用于区分一个地址与另一个地址的内容。

注意

在Qt6之前,这些信息是由street()方法返回的。

swap(other)
Parameters:

其他QGeoAddress

text()
Return type:

字符串

返回地址作为一个格式化的字符串。这是推荐用于向用户显示地址的字符串。它通常采用信封上找到的地址格式,但这并不总是必然的情况。

地址文本是自动生成或明确指定的。这可以通过检查isTextGenerated来确定。

如果向setText()提供了一个空字符串,那么isTextGenerated()将被设置为true,并且text()将返回一个根据countryCode()本地格式化的字符串,该字符串基于地址的元素,如街道、城市等。因为文本字符串是从地址元素生成的,所以像text()、setStreet()、text()这样的一系列调用可能会在每次调用text()时返回不同的字符串。

如果向setText()提供了一个非空字符串,那么isTextGenerated()将被设置为false,并且text()将始终返回显式分配的字符串。调用修改其他元素如setStreet()setCity()等将不会影响text()返回的字符串。

另请参阅

setText()