INALocatorAgent.QueryLocationByPoint Method

Find a network location from a point.

[Visual Basic .NET]
Public Sub QueryLocationByPoint ( _
    ByVal Point As IPoint, _
    ByVal tolerance As Double, _
    ByRef Location As INALocation, _
    ByRef outPoint As IPoint, _
    ByRef distanceFromPoint As Double _
)

[C#]
public void QueryLocationByPoint (
    IPoint Point,
    double tolerance,
    ref INALocation Location,
    ref IPoint outPoint,
    ref double distanceFromPoint
);

[C++]
HRESULT QueryLocationByPoint(
  IPoint* Point,
  double tolerance,
  INALocation** Location,
  IPoint** outPoint,
  double* distanceFromPoint
);

[C++]

Parameters
Point [in]

  Point is a parameter of type IPoint
tolerance [in]
  tolerance is a parameter of type double
Location [in, out]

  Location is a parameter of type INALocation
outPoint [in, out]

  outPoint is a parameter of type IPoint
distanceFromPoint [in, out]
  distanceFromPoint is a parameter of type double

Product Availability

Remarks

QueryLocationByPoint searches for network locations based upon an input point. The corresponding NALocation, the point where the location was found, and the distance from the input point to the source feature found are all returned.

When the NALocatorFeatureAgent is used, the distance returned is from the point to the feature, not from the point to the actual network location on the feature.  It is important to know the distance to the feature as a whole because this is the feature on which you want to locate the endpoint/midpoint.  If you need to determine the distance from the input point to the actual network location point, use IProximityOperator::ReturnDistance between the input point and the output point.

The NALocatorLocationFieldsAgent should not be used with this method.

See Also