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


INALocator3.QueryLocationByPointEx Method (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > NetworkAnalyst > ESRI.ArcGIS.NetworkAnalyst > Interfaces > IN > INALocator3 Interface > INALocator3.QueryLocationByPointEx Method
ArcGIS Developer Help

INALocator3.QueryLocationByPointEx Method

Use the locator agents to find a network location from a point and curb approach.

[Visual Basic .NET]
Public Sub QueryLocationByPointEx ( _
    ByVal Point As IPoint, _
    ByVal curbApproach As esriNACurbApproachType, _
    ByRef Location As INALocation, _
    ByRef outPoint As IPoint, _
    ByRef distanceFromPoint As Double _
)
[C#]
public void QueryLocationByPointEx (
    IPoint Point,
    esriNACurbApproachType curbApproach,
    ref INALocation Location,
    ref IPoint outPoint,
    ref double distanceFromPoint
);
[C++]
HRESULT QueryLocationByPointEx(
  IPoint* Point,
  esriNACurbApproachType curbApproach,
  INALocation** Location,
  IPoint** outPoint,
  System.Double* distanceFromPoint
);
[C++]
Parameters
Point [in]

Point is a parameter of type IPoint* 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. 

Using the input Point object, this method calls QueryLocationByPointEx on each of its associated NALocatorAgent classes.   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.

If 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

INALocator3 Interface