Crs.PointAlongRay3D Method
The result of going a given 3D distance from a start point in a given direction and pitch.
PointAlongRay3D(Point start, System.Double azimuth, System.Double pitch, System.Double distance, LineType rayType)
The result of going a given 3D distance from a start point in a given direction and pitch.Syntax
public Point PointAlongRay3D (
Point start,
System.Double azimuth,
System.Double pitch,
System.Double distance,
LineType rayType
)Parameters
The starting point, expressed in the Crs coordinates, and with z representing meters above sea level.
The starting azimuth, degrees clockwise from true north.
The starting pitch, degrees up from horizontal.
The 3D distance to go, in meters.
Return Value
The point where you end up.
Remarks
If you begin at the start point with the given azimuth and pitch, and you go the specified 3D distance in meters, you will end up at the returned point.
The line type GreatCircleApprox is not supported.
For a great-circle arc or a rhumb-line segment, the pitch angle is defined so that its tangent equals the altitude difference divided by the horizontal surface distance (at sea level). For a straight 3D line, the pitch angle is defined to be the angle between the line and the horizontal plane through the start point. Note that these two definitions agree perfectly only if the start point is at sea level, because when a horizontal distance between two points at 6371 meters above sea level, for example, is reduced to a footprint distance at sea level, the distance will decrease by about 0.1 percent due to the curvature of the earth.
The accuracy depends mainly on the horizontal part of the problem (see PointAlongRay2d), but may be worse if the start point or the end point has an very high altitude, say higher than 50 000 m.
Platforms
Windows, Linux, Android