Тип QML Address

Тип QML Address представляет конкретное местоположение в виде почтового адреса. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• address : QGeoAddress
• city : строка
• country : строка
• countryCode : строка
• county : строка
• district : строка
• isTextGenerated : логическое
• postalCode : строка
• state : строка
• street : строка
• text : строка

Подробное описание

Адрес используется как единица данных для запросов, таких как (обратное) геокодирование или поиск мест — многие из этих операций либо принимают адрес, либо возвращают его.

Не все свойства адреса обязательно доступны или релевантны во всех частях мира и во всех языковых средах. Свойства district, state и county особенно специфичны для конкретных регионов в различных источниках данных, и часто доступно или полезно только одно или два из них.

Адрес имеет свойство 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 : строка

Это свойство содержит город адреса в виде одной отформатированной строки.

country : строка

Это свойство содержит страну адреса в виде одной отформатированной строки.

countryCode : строка

Это свойство содержит код страны адреса в виде одной отформатированной строки.

county : строка

Это свойство содержит уезд адреса в виде одной отформатированной строки.

district : строка

Это свойство содержит район адреса в виде одной отформатированной строки.

isTextGenerated : логическое

Это свойство содержит логическое значение, которое, если оно истинно, указывает, что text автоматически генерируется из свойств адреса. Если оно ложно, это означает, что свойство text было явно задано.

postalCode : строка

Это свойство содержит почтовый индекс адреса в виде одной отформатированной строки.

state : строка

Это свойство содержит штат адреса в виде одной отформатированной строки.

street : строка

Это свойство содержит улицу адреса, но может также содержать номер квартиры, название здания или любой другой элемент, который может быть использован для различения одного адреса от другого.

text : строка

Это свойство содержит адрес в виде одной отформатированной строки. Это рекомендуемая строка для отображения адреса пользователю. Обычно она соответствует формату адреса, который можно найти на конверте, но это не всегда так.

Адрес text либо автоматически генерируется, либо явно задаётся; это можно определить, проверив isTextGenerated.

Если пустая строка присваивается text, то isTextGenerated будет установлено в true, и text вернёт строку, отформатированную локально в соответствии с countryCode и на основе свойств адреса. Изменение свойств адреса, таких как street, city и т. д., может привести к изменению содержимого text.

Если ненулевая строка присваивается text, то isTextGenerated будет установлено в false, и text всегда вернёт явно заданную строку. Изменение свойств адреса не повлияет на свойство text.