An analysis object that evaluates direct, vertical, and horizontal distances between two points defined by start and end point locations. More...
| Header: | #include <LocationDistanceMeasurement.h> |
| Since: | Esri::ArcGISRuntime 100.3 |
| Inherits: | Esri::ArcGISRuntime::Analysis |
Public Functions
| LocationDistanceMeasurement(const Esri::ArcGISRuntime::Point &startLocation, const Esri::ArcGISRuntime::Point &endLocation, QObject *parent = nullptr) | |
| virtual | ~LocationDistanceMeasurement() override |
| Esri::ArcGISRuntime::Distance | directDistance() const |
| Esri::ArcGISRuntime::Point | endLocation() const |
| Esri::ArcGISRuntime::Distance | horizontalDistance() const |
| void | setEndLocation(const Esri::ArcGISRuntime::Point &endLocation) |
| void | setStartLocation(const Esri::ArcGISRuntime::Point &startLocation) |
| void | setUnitSystem(Esri::ArcGISRuntime::UnitSystem unitSystem) |
| Esri::ArcGISRuntime::Point | startLocation() const |
| Esri::ArcGISRuntime::UnitSystem | unitSystem() const |
| Esri::ArcGISRuntime::Distance | verticalDistance() const |
Signals
| void | measurementChanged(const Esri::ArcGISRuntime::Distance &directDistance, const Esri::ArcGISRuntime::Distance &horizontalDistance, const Esri::ArcGISRuntime::Distance &verticalDistance) |
Detailed Description
The LocationDistanceMeasurement analysis measures the distance between a start and an end location (each using Point geometry).
Three distance components are calculated:
- direct distance - the direct distance between the start and end location
- horizontal distance - the horizontal component of the direct distance
- vertical distance - the vertical component of the direct distance
Relevant samples:
- Distance measurement analysis: Measure distances between two points in 3D.
Member Function Documentation
LocationDistanceMeasurement::LocationDistanceMeasurement (const Esri::ArcGISRuntime::Point &startLocation , const Esri::ArcGISRuntime::Point &endLocation , QObject *parent = nullptr)
Creates a LocationDistanceMeasurement analysis object that defines a start and an end location using Point objects.
The LocationDistanceMeasurement analysis result is a distance measurement between the start and end locations with direct, horizontal, and vertical components.
- startLocation - A point that defines the start location of the measurement.
- endLocation - A point that defines the end location of the measurement.
- parent - An optional parent.
[override virtual] LocationDistanceMeasurement::~LocationDistanceMeasurement ()
Destructor.
Esri::ArcGISRuntime::Distance LocationDistanceMeasurement::directDistance () const
Returns the direct distance component of the LocationDistanceMeasurement.
The distance's unit will be in the chosen UnitSystem and appropriate for the scale. The value will be empty until the analysis is added to the analysis overlay of a scene view.
See also measurementChanged.
Esri::ArcGISRuntime::Point LocationDistanceMeasurement::endLocation () const
Returns the end location of the LocationDistanceMeasurement.
The point coordinates (x,y,z) define the end location in 3D space.
See also setEndLocation().
Esri::ArcGISRuntime::Distance LocationDistanceMeasurement::horizontalDistance () const
Returns the horizontal distance component of the LocationDistanceMeasurement.
The distance's unit will be in the chosen UnitSystem and appropriate for the scale. The value will be empty until the analysis is added to the analysis overlay of a scene view.
See also measurementChanged.
[signal] void LocationDistanceMeasurement::measurementChanged (const Esri::ArcGISRuntime::Distance &directDistance , const Esri::ArcGISRuntime::Distance &horizontalDistance , const Esri::ArcGISRuntime::Distance &verticalDistance )
Signal emitted when any distance calculation component in a LocationDistanceMeasurement analysis has changed.
- directDistance - The new direct distance calculation.
- horizontalDistance - The new horizontal distance calculation.
- verticalDistance - The new vertical distance calculation.
See also Distance.
void LocationDistanceMeasurement::setEndLocation (const Esri::ArcGISRuntime::Point &endLocation )
Sets the end location of the LocationDistanceMeasurement to endLocation.
The point coordinates (x,y,z) define the end location in 3D space.
See also endLocation().
void LocationDistanceMeasurement::setStartLocation (const Esri::ArcGISRuntime::Point &startLocation )
Sets the start location of the LocationDistanceMeasurement to startLocation.
The point coordinates (x,y,z) define the start location in 3D space.
See also startLocation().
void LocationDistanceMeasurement::setUnitSystem (Esri::ArcGISRuntime::UnitSystem unitSystem )
Sets the UnitSystem of the LocationDistanceMeasurement under which distances are calculated to unitSystem.
See also unitSystem().
Esri::ArcGISRuntime::Point LocationDistanceMeasurement::startLocation () const
Returns the start location of the LocationDistanceMeasurement.
The point coordinates (x,y,z) define the start location in 3D space.
See also setStartLocation().
Esri::ArcGISRuntime::UnitSystem LocationDistanceMeasurement::unitSystem () const
Returns the UnitSystem of the LocationDistanceMeasurement under which distances are calculated.
See also setUnitSystem().
Esri::ArcGISRuntime::Distance LocationDistanceMeasurement::verticalDistance () const
Returns the vertical distance component of the LocationDistanceMeasurement.
The distance's unit will be in the chosen UnitSystem and appropriate for the scale. The value will be empty until the analysis is added to the analysis overlay of a scene view.
See also measurementChanged.