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,
  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

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