class QGeoAddress#

The QGeoAddress class represents an address of a QGeoLocation . 更多信息…

摘要#

方法#

备注

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

详细描述#

地址的属性已规范化为美国特征名称，并可以映射到本地特征级别（例如，在美国对应的是“州”级别）。

地址包含一个用于显示的 text() 和其他属性，用于访问地址的各个部分

__init__(other)#
参数:

other – QGeoAddress

从 other 构造一个副本。

__init__()

默认构造函数。

city()#
返回类型:

str

返回城市。

参见

setCity()

clear()#

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

country()#
返回类型:

str

返回国家名称。

参见

setCountry()

countryCode()#
返回类型:

str

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

county()#
返回类型:

str

返回县。县被视为位于国家以下的第二个行政区划。

参见

setCounty()

district()#
返回类型:

str

返回区。区被视为位于城市以下的行政区划。

参见

setDistrict()

isEmpty()#
返回类型:

bool

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

isTextGenerated()#
返回类型:

bool

当text()由地址元素自动生成时返回true，否则当text()被显式分配时返回false。

参见

text() setText()

__ne__(rhs)
参数:

rhs – QGeoAddress

返回类型:

bool

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

__eq__(rhs)
参数:

rhs – QGeoAddress

返回类型:

bool

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

postalCode()
返回类型:

str

返回邮编。

setCity(city)
参数:

city – 字符串

设置city。

参见

city()

setCountry(country)
参数:

country – 字符串

设置国家名称country。

参见

country()

setCountryCode(countryCode)
参数:

countryCode – 字符串

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

参见

countryCode()

setCounty(county)
参数:

county – 字符串

设置county。

参见

county()

setDistrict(district)
参数:

district – 字符串

设置district。

参见

district()

setPostalCode(postalCode)#
参数:

postalCode – 字符串

设置 postalCode。

参见

postalCode()

setState(state)#
参数:

state – 字符串

设置 state。

参见

state()

setStreet(street)#
参数:

street – 字符串

设置街道名为 street。

备注

在 Qt6 之前，这里还可以包含单元编号、楼名或任何其他可能用于区别地址的信息。现在请使用 setStreetNumber() 来设置这些数据。

参见

street() setStreetNumber()

setStreetNumber(streetNumber)#
参数:

streetNumber – 字符串

设置街道编号为 streetNumber。

这也可以包含单元编号、楼名或任何其他可能用于区别地址的信息。

备注

在 Qt6 之前，这些信息是由 setStreet() 方法设置的。

参见

streetNumber() setStreet()

setText(text)#
参数:

text – 字符串

如果 text 不为空，则显式地将 text 赋值给由 text() 返回的字符串。 isTextGenerated() 将返回 false。

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

参见

text()

state()#
返回类型:

str

返回州信息。州被视为位于国家之下的第一级行政区。

参见

setState()

street()#
返回类型:

str

返回街道名称。

备注

在Qt6之前，这也可以包含一些可能用来区分不同地址的信息，比如单元号、建筑物名称等。现在可以使用 streetNumber() 方法来获取这些数据。

参见

setStreet() streetNumber()

streetNumber()#
返回类型:

str

返回街道号。

这也可以包含单元编号、楼名或任何其他可能用于区别地址的信息。

备注

在Qt6之前，此信息通过 street() 方法返回。

参见

setStreetNumber() street()

swap(other))#
参数:

other – QGeoAddress

text()#
返回类型:

str

以单个格式化的字符串形式返回地址。这是向用户显示地址的推荐字符串。它通常采用信封上地址的格式，但这并不总是必然的。

地址文本要么是自动生成，要么是显式分配。这可以通过检查 isTextGenerated 来确定。

如果向 setText() 提供了一个空字符串，则 isTextGenerated() 将被设置为 true，并且 text() 将返回一个根据 countryCode() 本地格式化并基于地址元素（如街道、城市等）构建的字符串。因为文本字符串是从地址元素生成的，所以 text() 在每次调用时可能返回不同的字符串。

如果向 setText()方法 提供非空字符串，则 isTextGenerated()方法 会被设置为 false，并且text() 方法将始终返回显式指定的字符串。对如 setStreet()方法 ， setCity()方法 等其他元素的调用不会影响 text() 方法的结果字符串。

参见

setText()