Класс QGeoCodingManagerEngine

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

Этот класс был представлен в Qt 5.6.

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

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

Сигналы

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

В стандартной реализации, 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 для передачи любых данных, специфичных для реализации, в движок.

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

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

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

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

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

void QGeoCodingManagerEngine::finished(QGeoCodeReply *reply)

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

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

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

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

QGeoCodingManagerEngine::~QGeoCodingManagerEngine()

Уничтожает этот движок.

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

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

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

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

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

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

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

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

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

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().