The QGeoAddress class represents an address of a QGeoLocation. More...
Header: | #include <QGeoAddress> |
CMake: | find_package(Qt6 COMPONENTS Positioning REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
qmake: | QT += positioning |
Since: | Qt 5.2 |
QGeoAddress(QGeoAddress &&other) | |
QGeoAddress(const QGeoAddress &other) | |
QGeoAddress() | |
QGeoAddress & | operator=(QGeoAddress &other) |
QGeoAddress & | operator=(const QGeoAddress &address) |
~QGeoAddress() | |
QString | city() const |
void | clear() |
QString | country() const |
QString | countryCode() const |
QString | county() const |
QString | district() const |
bool | isEmpty() const |
bool | isTextGenerated() const |
QString | postalCode() const |
void | setCity(const QString &city) |
void | setCountry(const QString &country) |
void | setCountryCode(const QString &countryCode) |
void | setCounty(const QString &county) |
void | setDistrict(const QString &district) |
void | setPostalCode(const QString &postalCode) |
void | setState(const QString &state) |
void | setStreet(const QString &street) |
void | setStreetNumber(const QString &streetNumber) |
void | setText(const QString &text) |
QString | state() const |
QString | street() const |
QString | streetNumber() const |
QString | text() const |
size_t | qHash(const QGeoAddress &address, size_t seed = 0) |
bool | operator!=(const QGeoAddress &lhs, const QGeoAddress &rhs) |
bool | operator==(const QGeoAddress &lhs, const QGeoAddress &rhs) |
The address' attributes are normalized to US feature names and can be mapped to the local feature levels (for example State matches "Bundesland" in Germany).
The address contains a text() for displaying purposes and additional properties to access the components of an address:
[since 6.2]
QGeoAddress::QGeoAddress(QGeoAddress &&other)
Constructs a geo address object by moving from other.
Note: The moved-from QGeoAddress object can only be destroyed or assigned to. The effect of calling other functions than the destructor or one of the assignment operators is undefined.
This function was introduced in Qt 6.2.
Constructs a copy of other.
Default constructor.
[default, since 6.2]
QGeoAddress &QGeoAddress::operator=(QGeoAddress &other)
Move-assigns the other to this address and returns a reference to this address.
Note: The moved-from QGeoAddress object can only be destroyed or assigned to. The effect of calling other functions than the destructor or one of the assignment operators is undefined.
This function was introduced in Qt 6.2.
Assigns the given address to this address and returns a reference to this address.
Destroys this address.
Returns the city.
See also setCity().
Clears all of the address' data fields.
Returns the country name.
See also setCountry().
Returns the country code according to ISO 3166-1 alpha-3
See also setCountryCode().
Returns the county. The county is considered the second subdivision below country.
See also setCounty().
Returns the district. The district is considered the subdivison below city.
See also setDistrict().
Returns whether this address is empty. An address is considered empty if all of its fields are empty.
Returns true if QGeoAddress::text() is automatically generated from address elements, otherwise returns false if text() has been explicitly assigned.
See also text() and setText().
Returns the postal code.
See also setPostalCode().
Sets the city.
See also city().
Sets the country name.
See also country().
Sets the countryCode according to ISO 3166-1 alpha-3
See also countryCode().
Sets the county.
See also county().
Sets the district.
See also district().
Sets the postalCode.
See also postalCode().
Sets the state.
See also state().
Sets the street name to street.
Note: Before Qt6 this could also contain things like a unit number, a building name, or anything else that might be used to distinguish one address from another. Use setStreetNumber() to set this data now.
See also street() and setStreetNumber().
[since 6.2]
void QGeoAddress::setStreetNumber(const QString &streetNumber)
Sets the street number to streetNumber.
This may also contain things like a unit number, a building name, or anything else that might be used to distinguish one address from another.
Note: Before Qt6 this information was set by setStreet() method.
This function was introduced in Qt 6.2.
See also streetNumber() and setStreet().
If text is not empty, explicitly assigns text as the string to be returned by text(). isTextGenerated() will return false.
If text is empty, indicates that text() should be automatically generated from the address elements. isTextGenerated() will return true.
See also text().
Returns the state. The state is considered the first subdivision below country.
See also setState().
Returns the street name.
Note: Before Qt6 this could also contain things like a unit number, a building name, or anything else that might be used to distinguish one address from another. Use streetNumber() to obtain this data now.
See also setStreet() and streetNumber().
[since 6.2]
QString QGeoAddress::streetNumber() const
Returns the street number.
This may also contain things like a unit number, a building name, or anything else that might be used to distinguish one address from another.
Note: Before Qt6 this information was returned by street() method.
This function was introduced in Qt 6.2.
See also setStreetNumber() and street().
Returns the address as a single formatted string. It is the recommended string to use to display the address to the user. It typically takes the format of an address as found on an envelope, but this is not always necessarily the case.
The address text is either automatically generated or explicitly assigned. This can be determined by checking isTextGenerated.
If an empty string is provided to setText(), then isTextGenerated() will be set to true
and text() will return a string which is locally formatted according to countryCode() and based on the elements of the address such as street, city and so on. Because the text string is generated from the address elements, a sequence of calls such as text(), setStreet(), text() may return different strings for each invocation of text().
If a non-empty string is provided to setText(), then isTextGenerated() will be set to false
and text() will always return the explicitly assigned string. Calls to modify other elements such as setStreet(), setCity() and so on will not affect the resultant string from text().
See also setText().
Returns the hash value for the address, using seed for the calculation.
Returns true
if lhs address is not equal to rhs, otherwise returns false
.
Returns true
if lhs address is equal to rhs, otherwise returns false
.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qgeoaddress.html