Класс QGeoCodingManager

Класс QGeoCodingManager предоставляет поддержку операций геокодирования. Подробнее...

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

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

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

Сигналы

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

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

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

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

Класс QGeoCodingManager предоставляет поддержку операций геокодирования.

Функции geocode() и reverseGeocode() возвращают объекты QGeoCodeReply, которые управляют этими операциями и сообщают о результате операций и любых возникших ошибках.

Функции geocode() и reverseGeocode() могут использоваться для преобразования экземпляров QGeoAddress в экземпляры QGeoCoordinate и наоборот.

Функция geocode() также перегружена, чтобы позволить пользователю выполнить операцию геокодирования по свободному тексту, если предоставленная строка может быть интерпретирована как адрес, она может быть геокодирована в информацию о координатах.

К экземплярам QGeoCodingManager можно получить доступ с помощью QGeoServiceProvider::geocodingManager().

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

[virtual] QGeoCodingManager::~QGeoCodingManager()

Удаляет этот менеджер.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

QGeoCodeReply *QGeoCodingManager::geocode(const QString &address, int limit = -1, int offset = 0, const QGeoShape &bounds = QGeoShape())

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

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

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

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

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

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

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

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

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

QLocale QGeoCodingManager::locale() const

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

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

QString QGeoCodingManager::managerName() const

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

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

int QGeoCodingManager::managerVersion() const

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

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

QGeoCodeReply *QGeoCodingManager::reverseGeocode(const QGeoCoordinate &coordinate, const QGeoShape &bounds = QGeoShape())

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

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

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

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

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

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

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

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

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

void QGeoCodingManager::setLocale(const QLocale &locale)

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

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

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

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