Тип 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.