Класс QGeoCodingManagerEngine

Класс QGeoCodingManagerEngine предоставляет интерфейс и удобные методы для разработчиков плагинов QGeoServiceProvider, желающих добавить поддержку операций геокодирования. Подробнее...

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

Открытые функции

• 34 открытых функций, унаследованных от QObject

Сигналы

• 2 сигнала, унаследованных от QObject

Дополнительные унаследованные члены

• 1 свойство, унаследованное от QObject
• 1 открытый слот, унаследованный от QObject
• 1 открытая переменная, унаследованная от QObject
• 10 статических открытых членов, унаследованных от QObject
• 9 защищенных функций, унаследованных от QObject
• 2 защищенные переменные, унаследованные от QObject

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

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

В реализации по умолчанию, supportsGeocoding() и supportsReverseGeocoding() возвращают false, в то время как geocode() и reverseGeocode() вызывают QGeoCodeReply::UnsupportedOptionError.

Если поставщик услуг поддерживает геокодирование, подкласс должен предоставить реализацию geocode() и вызвать setSupportsGeocoding(true) в какой-то момент времени перед вызовом geocode().

Аналогично, если поставщик услуг поддерживает обратное геокодирование, подкласс должен предоставить реализацию reverseGeocode() и вызвать setSupportsReverseGeocoding(true) в какой-то момент времени перед вызовом reverseGeocode().

Подкласс QGeoCodingManagerEngine часто использует подкласс QGeoCodeReply в качестве внутренней реализации, чтобы добавить данные, специфичные для движка (такие как объект QNetworkReply для сетевых служб), в экземпляры QGeoCodeReply, используемые движком.

См. также QGeoCodingManager.

Документация по функциям-членам

QGeoCodingManagerEngine::QGeoCodingManagerEngine(const QVariantMap &parameters, QObject *parent = nullptr)

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

[virtual] QGeoCodingManagerEngine::~QGeoCodingManagerEngine()

Удаляет этот движок.

[signal] void QGeoCodingManagerEngine::error(QGeoCodeReply *reply, QGeoCodeReply::Error error, QString errorString = QString())

Этот сигнал испускается, когда в обработке reply обнаружена ошибка. Вероятно, последует сигнал QGeoCodingManagerEngine::finished().

Ошибка будет описана кодом ошибки error. Если errorString не пусто, она будет содержать текстовое описание ошибки.

Этот сигнал и QGeoCodeReply::error() будут испущены одновременно.

Примечание: Не удаляйте объект reply в слоте, подключенном к этому сигналу. Используйте deleteLater() вместо этого.

[signal] void QGeoCodingManagerEngine::finished(QGeoCodeReply *reply)

Этот сигнал испускается, когда обработка reply завершена.

Если reply::error() равно QGeoCodeReply::NoError, то обработка завершилась успешно.

Этот сигнал и QGeoCodeReply::finished() будут испущены одновременно.

Примечание: Не удаляйте объект reply в слоте, подключенном к этому сигналу. Используйте deleteLater() вместо этого.

[virtual] QGeoCodeReply *QGeoCodingManagerEngine::geocode(const QGeoAddress &address, const QGeoShape &bounds)

Начинает геокодирование адреса address. Геокодирование — это процесс поиска координат, соответствующих заданному адресу.

Возвращается объект QGeoCodeReply, который можно использовать для управления операцией геокодирования и получения результатов.

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

Если supportsGeocoding() возвращает false, произойдет QGeoCodeReply::UnsupportedOptionError.

После завершения операции QGeoCodeReply::locations() можно использовать для получения результатов, которые будут состоять из списка объектов QGeoLocation. Эти объекты представляют собой комбинацию координат и данных адреса.

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

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

Пользователь отвечает за удаление возвращенного объекта reply, хотя это можно сделать в слоте, подключенном к QGeoCodingManagerEngine::finished(), QGeoCodingManagerEngine::error(), QGeoCodeReply::finished() или QGeoCodeReply::error() с помощью deleteLater().

[virtual] QGeoCodeReply *QGeoCodingManagerEngine::geocode(const QString &address, int limit, int offset, const QGeoShape &bounds)

Начинает геокодирование местоположения, соответствующего address.

Возвращается объект QGeoCodeReply, который можно использовать для управления операцией геокодирования и получения результатов.

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

После завершения операции, можно использовать QGeoCodeReply::locations() для получения результатов, которые будут представлять собой список объектов QGeoLocation. Эти объекты представляют собой комбинацию координат и данных адреса.

Если limit равно -1, будет возвращен весь набор результатов, в противном случае будет возвращено не более limit результатов.

Параметр offset используется для того, чтобы геокодирование-сервис не возвращал первые offset результатов.

Результаты limit и offset используются вместе для реализации постраничной навигации.

Если bounds не равен null и является допустимой формой QGeoShape, она будет использована для ограничения результатов теми, которые содержатся в bounds.

Пользователь отвечает за удаление возвращенного объекта ответа, хотя это можно сделать в слоте, подключенном к QGeoCodingManagerEngine::finished(), QGeoCodingManagerEngine::error(), QGeoCodeReply::finished() или QGeoCodeReply::error() с помощью deleteLater().

QLocale QGeoCodingManagerEngine::locale() const

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

См. также setLocale().

QString QGeoCodingManagerEngine::managerName() const

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

Сочетание managerName() и managerVersion() должно быть уникальным среди реализаций плагинов.

int QGeoCodingManagerEngine::managerVersion() const

Возвращает версию этой реализации движка.

Сочетание managerName() и managerVersion() должно быть уникальным среди реализаций плагинов.

[virtual] QGeoCodeReply *QGeoCodingManagerEngine::reverseGeocode(const QGeoCoordinate &coordinate, const QGeoShape &bounds)

Начинает обратное геокодирование координаты coordinate. Обратное геокодирование — это процесс поиска адреса, соответствующего заданным координатам.

Будет возвращен объект QGeoCodeReply, который можно использовать для управления операцией обратного геокодирования и возврата результатов операции.

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

Если supportsReverseGeocoding() возвращает false, произойдет QGeoCodeReply::UnsupportedOptionError.

В этот момент QGeoCodeReply::locations() можно использовать для получения результатов, которые будут представлять собой список объектов QGeoLocation. Эти объекты представляют собой комбинацию координат и данных адреса.

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

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

Если bounds не равен null и является допустимой формой QGeoShape, она будет использована для ограничения результатов теми, которые содержатся в bounds.

Пользователь отвечает за удаление возвращенного объекта ответа, хотя это можно сделать в слоте, подключенном к QGeoCodingManagerEngine::finished(), QGeoCodingManagerEngine::error(), QGeoCodeReply::finished() или QGeoCodeReply::error() с помощью deleteLater().

void QGeoCodingManagerEngine::setLocale(const QLocale &locale)

Устанавливает язык, который будет использовать этот менеджер, в locale.

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

Используемый по умолчанию язык — это системный язык, если он не установлен.

См. также locale().