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.

© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.