QPlaceMatchRequest Class

The QPlaceMatchRequest class is used to find places from one manager that match those from another. It represents a set of request parameters. More...

Header: #include <QPlaceMatchRequest>
qmake: QT += location

Public Functions

QPlaceMatchRequest()
QPlaceMatchRequest(const QPlaceMatchRequest &other)
~QPlaceMatchRequest()
void clear()
QVariantMap parameters() const
QList<QPlace> places() const
void setParameters(const QVariantMap &parameters)
void setPlaces(const QList<QPlace> &places)
void setResults(const QList<QPlaceSearchResult> &results)
QPlaceMatchRequest &operator=(const QPlaceMatchRequest &other)

Static Public Members

const QString AlternativeId
bool operator!=(const QPlaceMatchRequest &lhs, const QPlaceMatchRequest &rhs)
bool operator==(const QPlaceMatchRequest &lhs, const QPlaceMatchRequest &rhs)

Detailed Description

Places from another manager that may have corresponding/matching places in the current manager are assigned using setPlaces() or setResults(). A set of further parameters are specified which determines the criteria for matching.

The typical key for matching is the QPlaceMatchRequest::AlternativeId, the value is an alternative identifier attribute type of the format x_id_<provider name> for example x_id_here. The provider name is name supplied to the QGeoServiceProvider instance.

See Matching places between managers for an example on how to use a match request.

See also QPlaceMatchReply and QPlaceManager.

Member Function Documentation

QPlaceMatchRequest::QPlaceMatchRequest()

Default constructor. Constructs a new request object.

[noexcept] QPlaceMatchRequest::QPlaceMatchRequest(const QPlaceMatchRequest &other)

Constructs a copy of other.

[noexcept] QPlaceMatchRequest::~QPlaceMatchRequest()

Destroys the request object.

void QPlaceMatchRequest::clear()

Clears the match request.

QVariantMap QPlaceMatchRequest::parameters() const

Returns the parameters for matching places.

See also setParameters().

QList<QPlace> QPlaceMatchRequest::places() const

Returns a list of places which are to be matched.

See also setPlaces().

void QPlaceMatchRequest::setParameters(const QVariantMap &parameters)

Sets the parameters for matching places.

See also parameters().

void QPlaceMatchRequest::setPlaces(const QList<QPlace> &places)

Sets a list of places which are to be matched.

See also places() and setResults().

void QPlaceMatchRequest::setResults(const QList<QPlaceSearchResult> &results)

Convenience function which uses a set of search results to set the places which should be matched.

See also setPlaces().

[noexcept] QPlaceMatchRequest &QPlaceMatchRequest::operator=(const QPlaceMatchRequest &other)

Assigns other to this search request and returns a reference to this match request.

Member Variable Documentation

const QString QPlaceMatchRequest::AlternativeId

The key to specify that matching is to be accomplished via an alternative place identifier.

Related Non-Members

[noexcept] bool operator!=(const QPlaceMatchRequest &lhs, const QPlaceMatchRequest &rhs)

Returns true if lhs is not equal to rhs, otherwise returns false.

[noexcept] bool operator==(const QPlaceMatchRequest &lhs, const QPlaceMatchRequest &rhs)

Returns true if lhs is equal to rhs, otherwise returns false.