QPlaceResult Class | Qt Location 5.4

- Qt 5.4
- Qt Location
- C++ Classes
- QPlaceResult
- Qt 5.4.2 Reference Documentation

# QPlaceResult Class

The QPlaceResult class represents a search result containing a place. More...

Header: | #include <QPlaceResult>
qmake: | QT += location
Since: | Qt Location 5.0
Inherits: | QPlaceSearchResult.

- List of all members, including inherited members

## Public Functions

| QPlaceResult()
| QPlaceResult(const QPlaceSearchResult & other)
virtual | ~QPlaceResult()
qreal | distance() const
bool | isSponsored() const
QPlace | place() const
void | setDistance(qreal distance)
void | setPlace(const QPlace & place)
void | setSponsored(bool sponsored)

- 8 public functions inherited from QPlaceSearchResult

## Detailed Description

The QPlaceResult class represents a search result containing a place.

The PlaceResult holds the distance to the place from the center of the search request, an instance of the place and an indication of whether the result is sponsored or organic.

The intended usage is that a QPlaceSearchResult can be converted into a QPlaceResult like so:

    if (result.type() == QPlaceSearchResult::PlaceResult) {
        QPlaceResult placeResult = result;
        qDebug() << placeResult.place().name();
        qDebug() << placeResult.place().location().coordinate();
        qDebug() << placeResult.distance();
    }

The implementation is handled in such a way that object slicing is not an issue.

See also QPlaceSearchResult.

## Member Function Documentation

### QPlaceResult::QPlaceResult()

Constructs a new place result object.

### QPlaceResult::QPlaceResult(const QPlaceSearchResult & other)

Constructs a copy of other if possible, otherwise constructs a default place result.

### `[virtual]` QPlaceResult::~QPlaceResult()

Destructor.

### qreal QPlaceResult::distance() const

Returns the distance of the place to the search center. This field is only relevant provided the search request contained a search area with a search center. Otherwise, the distance is NaN indicating an undefined distance. The default value for distance is NaN.

See also setDistance().

### bool QPlaceResult::isSponsored() const

Returns true if the result is a sponsored result.

See also setSponsored().

### QPlace QPlaceResult::place() const

Returns the place of the search result.

See also setPlace().

### void QPlaceResult::setDistance(qreal distance)

Set the distance of the search result's place from a search center.

See also distance().

### void QPlaceResult::setPlace(const QPlace & place)

Sets the place that this result refers to.

See also place().

### void QPlaceResult::setSponsored(bool sponsored)

Sets whether the result is a sponsored result or not.

See also isSponsored().