Класс QGeoServiceProvider

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

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

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

Типы публичного доступа

Публичные функции

Статические публичные члены

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

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

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

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

Подклассы QGeoServiceProvider гарантируют, что предоставляемые ими различные службы совместимы.

В данный момент с Qt поставляются два плагина GeoServices. Они доступны по своим именам провайдеров:

• "mapbox" -> Служба Mapbox
• "here" -> Службы HERE
• "osm" -> Службы OpenStreetMap
• "esri" -> Службы ESRI

Каждый провайдер служб должен следовать соглашению об именовании для имён параметров/ключей, специфичных для службы. Они используют имя провайдера в качестве префикса для всех имён параметров. Например, провайдер службы HERE требует параметр here.app_id. При загрузке провайдера передаются только те параметры, имена параметров которых начинаются с имени провайдера. Это предотвращает совместное использование чувствительных параметров, таких как конфиденциальные token или app_id параметры с другими плагинами.

Обратитесь к документации конкретного плагина GeoServices, чтобы получить полный список доступных имён параметров/ключей и значений.

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

Перечисление QGeoServiceProvider::Ошибка

Описание ошибки, связанной с загрузкой и настройкой плагина поставщика услуг.

enum QGeoServiceProvider::GeocodingFeatureflags QGeoServiceProvider::GeocodingFeatures

Описание геокодирующих возможностей, поддерживаемых поставщиком геосервиса.

Тип GeocodingFeatures является типом-синонимом для QFlags<GeocodingFeature>. Он хранит результат объединения по оператору OR значений GeocodingFeature.

enum QGeoServiceProvider::MappingFeatureflags QGeoServiceProvider::MappingFeatures

Описание возможностей отображения, поддерживаемых поставщиком геосервиса.

Тип MappingFeatures является типом-синонимом для QFlags<MappingFeature>. Он хранит результат объединения по оператору OR значений MappingFeature.

enum QGeoServiceProvider::NavigationFeatureflags QGeoServiceProvider::NavigationFeatures

Описание функций навигации, поддерживаемых поставщиком геосервиса.

Тип NavigationFeatures является типом-синонимом для QFlags<NavigationFeature>. Он хранит логическое ИЛИ сочетание значений NavigationFeature.

перечисление QGeoServiceProvider::PlacesFeatureфлаги QGeoServiceProvider::PlacesFeatures

Описание функций мест, поддерживаемых поставщиком геосервисов.

Тип PlacesFeatures является типом-синонимом для QFlags<PlacesFeature>. Он хранит логическое ИЛИ сочетание значений PlacesFeature.

перечисление QGeoServiceProvider::RoutingFeatureфлаги QGeoServiceProvider::RoutingFeatures

Описание функций маршрутизации, поддерживаемых поставщиком геосервисов.

Тип RoutingFeatures является типом-синонимом для QFlags<RoutingFeature>. Он хранит логическое ИЛИ сочетание значений RoutingFeature.

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

QGeoServiceProvider::QGeoServiceProvider(const QString &providerName, const QVariantMap &parameters = QVariantMap(), bool allowExperimental = false)

Создаёт QGeoServiceProvider, у которого бэкенд имеет имя providerName, используя предоставленные parameters.

Если несколько плагинов имеют одинаковое значение providerName, будет использован плагин с наивысшей reported providerVersion().

Если allowExperimental имеет значение true, то могут использоваться плагины, помеченные как экспериментальные. По умолчанию экспериментальные плагины не учитываются.

Если не удалось загрузить плагин, соответствующий providerName, то error() и errorString() предоставят подробности о причинах.

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

[virtual] QGeoServiceProvider::~QGeoServiceProvider()

Уничтожает объект поставщика сервиса.

[static] QStringList QGeoServiceProvider::availableServiceProviders()

Возвращает список имён доступных поставщиков сервисов, для использования с конструкторами QGeoServiceProvider.

QGeoServiceProvider::Error QGeoServiceProvider::error() const

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

QString QGeoServiceProvider::errorString() const

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

QGeoServiceProvider::Error QGeoServiceProvider::geocodingError() const

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

Эта функция была добавлена в Qt 5.13.

QString QGeoServiceProvider::geocodingErrorString() const

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

Эта функция была добавлена в Qt 5.13.

QGeoServiceProvider::GeocodingFeatures QGeoServiceProvider::geocodingFeatures() const

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

QGeoCodingManager *QGeoServiceProvider::geocodingManager() const

Возвращает QGeoCodingManager, предоставленный поставщиком сервиса.

Эта функция вернёт 0, если поставщик сервиса не предоставляет геокодирование.

Эта функция попытается создать экземпляр QGeoCodingManager при первом вызове. Если попытка окажется успешной, QGeoCodingManager будет кэширован; в противном случае каждый вызов этой функции будет пытаться создать экземпляр QGeoCodingManager, пока попытка не увенчается успехом.

QGeoCodingManager принадлежит этому QGeoServiceProvider и не должен удаляться отдельно. Пользователи должны понимать, что удаление QGeoServiceProvider делает указатель, возвращаемый этим методом, недействительным.

После вызова этой функции error() и errorString() будут сообщать об любых ошибках, возникших во время создания QGeoCodingManager.

QGeoServiceProvider::Error QGeoServiceProvider::mappingError() const

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

Эта функция была добавлена в Qt 5.13.

QString QGeoServiceProvider::mappingErrorString() const

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

Эта функция была добавлена в Qt 5.13.

QGeoServiceProvider::MappingFeatures QGeoServiceProvider::mappingFeatures() const

Возвращает функции отображения, поддерживаемые поставщиком геосервиса.

QGeoServiceProvider::Error QGeoServiceProvider::navigationError() const

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

Эта функция была добавлена в Qt 5.13.

QString QGeoServiceProvider::navigationErrorString() const

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

Эта функция была добавлена в Qt 5.13.

QGeoServiceProvider::NavigationFeatures QGeoServiceProvider::navigationFeatures() const

Возвращает функции навигации, поддерживаемые поставщиком геосервиса.

Эта функция была добавлена в QtLocation 5.11.

QNavigationManager *QGeoServiceProvider::navigationManager() const

Возвращает новый QNavigationManager, предоставленный поставщиком сервиса.

После вызова этой функции error() и errorString() будут сообщать об ошибках, возникших при создании QNavigationManagerEngine.

QPlaceManager *QGeoServiceProvider::placeManager() const

Возвращает QPlaceManager, предоставленный поставщиком сервиса.

Эта функция попытается создать экземпляр QPlaceManager при первом вызове. Если попытка окажется успешной, QPlaceManager будет кэширован; в противном случае каждый вызов этой функции будет пытаться создать экземпляр QPlace до тех пор, пока попытка не увенчается успехом.

QGeoPlaceManager принадлежит этому QGeoServiceProvider и не должен удаляться отдельно. Пользователи должны понимать, что удаление QGeoServiceProvider делает указатель, возвращаемый этим методом, недействительным.

После вызова этой функции error() и errorString() будут сообщать об любых ошибках, возникших во время создания QPlaceManager.

QGeoServiceProvider::Error QGeoServiceProvider::placesError() const

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

Эта функция была добавлена в Qt 5.13.

QString QGeoServiceProvider::placesErrorString() const

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

Эта функция была добавлена в Qt 5.13.

QGeoServiceProvider::PlacesFeatures QGeoServiceProvider::placesFeatures() const

Возвращает функции мест, поддерживаемые поставщиком геосервиса.

QGeoServiceProvider::Error QGeoServiceProvider::routingError() const

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

Эта функция была добавлена в Qt 5.13.

QString QGeoServiceProvider::routingErrorString() const

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

Эта функция была добавлена в Qt 5.13.

QGeoServiceProvider::RoutingFeatures QGeoServiceProvider::routingFeatures() const

Возвращает функции маршрутизации, поддерживаемые поставщиком геосервиса.

QGeoRoutingManager *QGeoServiceProvider::routingManager() const

Возвращает QGeoRoutingManager, предоставленный поставщиком сервиса.

Эта функция вернёт 0, если поставщик сервиса не предоставляет геосервисы маршрутизации.

Эта функция попытается создать экземпляр QGeoRoutingManager при первом вызове. Если попытка окажется успешной, QGeoRoutingManager будет кэширован; в противном случае каждый вызов этой функции будет пытаться создать экземпляр QGeoRoutingManager до тех пор, пока попытка не увенчается успехом.

QGeoRoutingManager принадлежит этому QGeoServiceProvider и не должен удаляться отдельно. Пользователи должны понимать, что удаление QGeoServiceProvider делает указатель, возвращаемый этим методом, недействительным.

После вызова этой функции error() и errorString() будут сообщать об любых ошибках, возникших во время создания QGeoRoutingManager.

void QGeoServiceProvider::setAllowExperimental(bool allow)

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

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

void QGeoServiceProvider::setLocale(const QLocale &locale)

Устанавливает используемый этим поставщиком услуг язык locale. Если соответствующие функции (см. LocalizedMappingFeature и т. д.), это изменит языки, единицы измерения и другие локально-зависимые атрибуты данных поставщика.

void QGeoServiceProvider::setParameters(const QVariantMap &parameters)

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

Перед передачей списка parameters загружаемому поставщику услуг список фильтруется, чтобы избежать обмена параметрами, специфичными для поставщика, с несвязанными поставщиками услуг. Параметры, специфичные для поставщика, должны иметь префикс с именем поставщика (например, here.app_id).

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