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


INALocatorAgent3.QueryLocationByPointEx Method (ArcObjects .NET 10.4 SDK)
ArcObjects Library Reference (NetworkAnalyst)  

INALocatorAgent3.QueryLocationByPointEx Method

Find a network location from a point and curb approach.

[Visual Basic .NET]
Public Sub QueryLocationByPointEx ( _
    ByVal Point As IPoint, _
    ByVal tolerance As Double, _
    ByVal curbApproach As esriNACurbApproachType, _
    ByRef Location As INALocation, _
    ByRef outPoint As IPoint, _
    ByRef distanceFromPoint As Double _
)
[C#]
public void QueryLocationByPointEx (
    IPoint Point,
    double tolerance,
    esriNACurbApproachType curbApproach,
    ref INALocation Location,
    ref IPoint outPoint,
    ref double distanceFromPoint
);
[C++]
HRESULT QueryLocationByPointEx(
  IPoint* Point,
  double tolerance,
  esriNACurbApproachType curbApproach,
  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 curbApproach [in]
curbApproach is a parameter of type esriNACurbApproachType 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

QueryLocationByPointEx extends QueryLocationByPoint by adding a CurbApproach parameter. 

If, in the INALocator calling this agent, ExcludeRestrictedElements is set to true and CacheRestrictedElements has been called, then there is the possibility that a network edge is only traversable in one direction.  In that case, the CurbApproach setting could render a location as unreachable.  For example, if the along direction on an edge is restricted, and the location being queried would place the returned NALocation on the left side of the edge, then it is not possible to reach the stop with a vehicle requiring a CurbApproach of left side.  QueryLocationByPointEx, in the above example, would switch the side of edge of the returned NALocation to right side, thereby allowing the NALocation to be reachable by vehicles with a CurbApproach requirement of left side.

See Also

INALocatorAgent3 Interface