Класс QGeoServiceProvider

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

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

Типы

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

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

Статические открытые члены

• 9 статических открытых членов, унаследованных от QObject

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

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

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

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

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

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

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

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

На данный момент с Qt поставляются два плагина GeoServices. Они доступны с помощью своих имён поставщика:

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

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

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

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

перечисление QGeoServiceProvider::Error

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

enum QGeoServiceProvider::GeocodingFeatureflags QGeoServiceProvider::GeocodingFeatures

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

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

enum QGeoServiceProvider::MappingFeatureflags QGeoServiceProvider::MappingFeatures

Описывает поддерживаемые геосервис-провайдером возможности картографирования.

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

enum QGeoServiceProvider::NavigationFeatureflags QGeoServiceProvider::NavigationFeatures

Описывает поддерживаемые геосервис-провайдером возможности навигации.

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

enum QGeoServiceProvider::PlacesFeatureflags QGeoServiceProvider::PlacesFeatures

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

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

enum QGeoServiceProvider::RoutingFeatureflags QGeoServiceProvider::RoutingFeatures

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

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

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

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

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

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

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

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

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

[virtual] QGeoServiceProvider::~QGeoServiceProvider()

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

[static] QStringList QGeoServiceProvider::availableServiceProviders()

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

QGeoServiceProvider::Error QGeoServiceProvider::error() const

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

QString QGeoServiceProvider::errorString() const

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

QGeoServiceProvider::GeocodingFeatures QGeoServiceProvider::geocodingFeatures() const

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

QGeoCodingManager *QGeoServiceProvider::geocodingManager() const

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

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

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

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

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

QGeoServiceProvider::MappingFeatures QGeoServiceProvider::mappingFeatures() const

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

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::PlacesFeatures QGeoServiceProvider::placesFeatures() const

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

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

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

void QGeoServiceProvider::setQmlEngine(QQmlEngine *engine)