QtMobility Reference Documentation

Contents

QGeoServiceProviderFactory Class Reference

The QGeoServiceProviderFactory class is a factory class used as the plugin interface for services related to geographical information. More...

 #include <QGeoServiceProviderFactory>

This class was introduced in Qt Mobility 1.1.

Public Functions

virtual ~QGeoServiceProviderFactory ()
virtual QGeoMappingManagerEngine * createMappingManagerEngine ( const QMap<QString, QVariant> & parameters, QGeoServiceProvider::Error * error, QString * errorString ) const
virtual QGeoRoutingManagerEngine * createRoutingManagerEngine ( const QMap<QString, QVariant> & parameters, QGeoServiceProvider::Error * error, QString * errorString ) const
virtual QGeoSearchManagerEngine * createSearchManagerEngine ( const QMap<QString, QVariant> & parameters, QGeoServiceProvider::Error * error, QString * errorString ) const
virtual QString providerName () const = 0
virtual int providerVersion () const = 0

Detailed Description

The QGeoServiceProviderFactory class is a factory class used as the plugin interface for services related to geographical information.

Implementers must provide a unique combination of providerName() and providerVersion() per plugin.

The other functions should be overridden if the plugin supports the associated set of functionality.

Member Function Documentation

QGeoServiceProviderFactory::~QGeoServiceProviderFactory () [virtual]

Destroys this QGeoServiceProviderFactory instance.

QGeoMappingManagerEngine * QGeoServiceProviderFactory::createMappingManagerEngine ( const QMap<QString, QVariant> & parameters, QGeoServiceProvider::Error * error, QString * errorString ) const [virtual]

Returns a new QGeoMappingManagerEngine instance, initialized with parameters, which implements as much of the places searching functionality as the service provider supports.

If error is not 0 it should be set to QGeoServiceProvider::NoError on success or an appropriate QGeoServiceProvider::Error on failure.

If errorString is not 0 it should be set to a string describing any error which occurred.

The default implementation returns 0, which causes a QGeoServiceProvider::NotSupportedError in QGeoServiceProvider.

QGeoRoutingManagerEngine * QGeoServiceProviderFactory::createRoutingManagerEngine ( const QMap<QString, QVariant> & parameters, QGeoServiceProvider::Error * error, QString * errorString ) const [virtual]

Returns a new QGeoRoutingManagerEngine instance, initialized with parameters, which implements as much of the places searching functionality as the service provider supports.

If error is not 0 it should be set to QGeoServiceProvider::NoError on success or an appropriate QGeoServiceProvider::Error on failure.

If errorString is not 0 it should be set to a string describing any error which occurred.

The default implementation returns 0, which causes a QGeoServiceProvider::NotSupportedError in QGeoServiceProvider.

QGeoSearchManagerEngine * QGeoServiceProviderFactory::createSearchManagerEngine ( const QMap<QString, QVariant> & parameters, QGeoServiceProvider::Error * error, QString * errorString ) const [virtual]

Returns a new QGeoSearchManagerEngine instance, initialized with parameters, which implements as much of the places searching functionality as the service provider supports.

If error is not 0 it should be set to QGeoServiceProvider::NoError on success or an appropriate QGeoServiceProvider::Error on failure.

If errorString is not 0 it should be set to a string describing any error which occurred.

The default implementation returns 0, which causes a QGeoServiceProvider::NotSupportedError in QGeoServiceProvider.

QString QGeoServiceProviderFactory::providerName () const [pure virtual]

Returns the string used to identify the service provider behind this implementation.

The combination of providerName() and providerVersion() should be unique amongst the plugins.

int QGeoServiceProviderFactory::providerVersion () const [pure virtual]

Returns the version of the plugin.

The combination of providerName() and providerVersion() should be unique amongst the plugins.