Тип QML Address

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

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

Свойства

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

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

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

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

Объект Address имеет свойство 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.