Класс QGeoServiceProvider

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

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

Публичные типы

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

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

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

• 10 статических публичных членов унаследованных от QObject

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

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

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

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

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>. Он хранит логическое ИЛИ сочетание значений 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() предоставят подробности о причинах.

Примечание: Перед передачей списка параметров загружаемому плагину, список фильтруется, чтобы избежать совместного использования параметров плагина с не связанными плагинами поставщиков. Ключи параметров, специфичные для плагина, должны быть префиксрованы именем поставщика (например, 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.

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

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