- Qt 6.9
- Qt Location
- C++ Classes
- QPlaceMatchRequest
- Qt 6.9.2 Reference Documentation

# 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`

- List of all members, including inherited members

## 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

## Related Non-Members

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.