Creates a location object.
NaN
are supported.true
will render with the LocationDisplay::acquiringSymbol, typically a grayed out location symbol.[since Esri::ArcGISRuntime 100.8]
Location::Location(const QDateTime ×tamp, const Esri::ArcGISRuntime::Point &position, double horizontalAccuracy, double verticalAccuracy, double velocity, double course, bool lastKnown)
Creates a location object with timestamp.
NaN
are supported.NaN
are supported.true
will render with the LocationDisplay::acquiringSymbol, typically a grayed out location symbol.This function was introduced in Esri::ArcGISRuntime 100.8.
[since Esri::ArcGISRuntime 100.14]
Location::Location(const QDateTime ×tamp, const Esri::ArcGISRuntime::Point &position, double horizontalAccuracy, double verticalAccuracy, double velocity, double course, bool lastKnown, const QVariantMap &additionalSourceProperties)
Creates a location object with timestamp and additional source properties.
NaN
are supported.NaN
are supported.true
will render with the LocationDisplay::acquiringSymbol, typically a grayed out location symbol.A Location can be created from a variety of sources and using different technologies. By supplying additionalSourceProperties you can allow users of this Location to find out how the data was captured.
Information should be provided as a set of key-value pairs, where the QString key describes the type of data held in the QVariant value. Values must be basic data types such as string, floating point, integer, boolean or date. You can use any string for the key - but this API recognizes a number of well known keys which should be used if available. See LocationSourcePropertiesKeys:
Keys are case-sensitive.
This function was introduced in Esri::ArcGISRuntime 100.14.
See also additionalSourceProperties.
Location::Location(const Esri::ArcGISRuntime::Location &other)Copy constructor from other Location.
[noexcept]
Location::Location(Esri::ArcGISRuntime::Location &&other)
Move constructor from other Location.
[virtual noexcept]
Location::~Location()
Destructor.
[since Esri::ArcGISRuntime 100.14]
QVariantMap Location::additionalSourceProperties() const
Returns a set of key-value pairs providing additional meta-data and properties about the source of this Location. A Location object can be created manually or by a variety of AbstractLocationDataSource types, for example from the default platform data source or external GPS.
Mobile devices may provide different details about their in-built location services. For example, Android systems can provide data on the number of satellites used to find a position, whereas on iOS this information is not available. When a given property is not available to the data source the entry should be omitted from the additionalSourceProperties.
The additionalSourceProperties provide a means for the creator of a Location object to record flexible information such as:
Information is provided as a set of key-value pairs, where the QString key describes the type of data held in the QVariant value. Values must be basic data types such as string, numeric, boolean or date. The creator of the Location can use any string for the key - but this API recognizes a number of well known keys which should be used if available. See LocationSourcePropertiesKeys:
Keys are case-sensitive.
This function was introduced in Esri::ArcGISRuntime 100.14.
double Location::course() constGets the direction in which the device is traveling.
The direction is measured in degrees starting at due north and continuing clockwise around the compass. Thus, north is 0 degrees, east is 90 degrees, south is 180 degrees, and so on. Course values may not be available on all devices. A negative value indicates that the direction is invalid.
This property will return NaN
when the object is empty.
Gets the radius of uncertainty for the location, measured in meters.
The position identifies the center of the circle, and this value indicates the radius of that circle. A negative value indicates that the position is invalid.
This property will return NaN
when the object is empty.
Returns true
if this Location is empty.
Gets whether the location information is current or based on a last known update.
Returns true
if it is based on last known update. It is considered to be of last known update once the LocationDisplay::acquiringTimeout has passed without an update.
In the case of an empty Location, this will return false.
[since Esri::ArcGISRuntime 100.10]
Esri::ArcGISRuntime::LocationType Location::locationType() const
Returns the type of the location.
This property will return Unknown
when the object is empty.
This function was introduced in Esri::ArcGISRuntime 100.10.
See also LocationType.
Esri::ArcGISRuntime::Point Location::position() constGets the coordinates of the position as a Point.
This property will return a default constructed Point when the object is empty.
[since Esri::ArcGISRuntime 100.8]
QDateTime Location::timestamp() const
The time this location was observed.
This property will return a default constructed QDateTime when the object is empty.
This function was introduced in Esri::ArcGISRuntime 100.8.
double Location::velocity() constGets the instantaneous speed of the device in meters per second.
This property will return NaN
when the object is empty.
[since Esri::ArcGISRuntime 100.8]
double Location::verticalAccuracy() const
The vertical accuracy of the location in meters.
This property will return NaN
when the object is empty.
This function was introduced in Esri::ArcGISRuntime 100.8.
[noexcept]
Esri::ArcGISRuntime::Location &Location::operator=(Esri::ArcGISRuntime::Location &&other)
Move operator from other Location.
Esri::ArcGISRuntime::Location &Location::operator=(const Esri::ArcGISRuntime::Location &other)Assignment operator from other Location.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4