This document is archived and information here might be outdated.  Recommended version.


INALocatorAgent.QueryLocationByPoint Method (ArcObjects .NET 10.4 SDK)
ArcObjects Library Reference (NetworkAnalyst)  

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

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Network Analyst Extension.

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

INALocatorAgent Interface