Тип QML Address

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

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

Свойства

• address : QGeoAddress
• город : строка
• страна : строка
• код_страны : строка
• графство : строка
• район : строка
• isTextGenerated : логическое
• почтовый_индекс : строка
• штат : строка
• улица : строка
• номер_дома : строка
• текст : строка

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

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

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

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

Пример использования

Следующий фрагмент кода демонстрирует объявление объекта Address.

Address {
    id: address
    street: "53 Brandl St"
    city: "Eight Mile Plains"
    country: "Australia"
    countryCode: "AUS"
}

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

См. также QGeoAddress.

Документация свойств

address : QGeoAddress

Для получения подробностей о том, как использовать это свойство для взаимодействия между C++ и QML, см. "Интерфейсы между C++ и QML кодом".

город : строка

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

страна : строка

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

код_страны : строка

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

графство : строка

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

район : строка

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

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

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

почтовый_индекс : строка

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

штат : строка

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

улица : строка

Это свойство хранит улицу адреса.

[since QtPositioning 6.2] номер_дома : строка

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

Это свойство было введено в QtPositioning 6.2.

текст : строка

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

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

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

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