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