identify
Initiate an Identify operation on the specified layer.
The tolerance parameter determines the extent of the region used during the identify operation. This overload will return the single visible topmost GeoElement only. A tolerance of 0 tests just the physical pixel at screenCoordinate. Tolerance values above 0 are in DIPs and specify a circular region centered on screenCoordinate, with radius equal to tolerance. The maximum allowed tolerance value is 100 DIPs, resulting in an identify circle of diameter 200 DIPs. The returnPopupsOnly parameter controls what properties are populated in the IdentifyLayerResult instance that is returned by the identify operation:
true: only the IdentifyLayerResult.popups property will be populated with results. If the layer does not have popups an error will be returned.
false: the IdentifyLayerResult.geoElements property will be populated. The IdentifyLayerResult.popups property will be populated if the layer has popups.
Return
A Result containing an IdentifyLayerResult, or failure
Since
200.0.0
Parameters
layer on which to run the identify
location at which to run identify in screen coordinates
extent of the region used during the identify operation
whether the IdentifyLayerResult.geoElements property of the result is populated
Initiate an Identify operation on the specified layer.
The tolerance parameter determines the extent of the region used during the identify operation. Any GeoElements that intersect this test region when rendered are returned, up to the maximumResults limit. A tolerance of 0 tests just the physical pixel at screenCoordinate. Tolerance values above 0 are in DIPs and specify a circular region centered on screenCoordinate, with radius equal to tolerance. The maximum allowed tolerance value is 100 DIPs, resulting in an identify circle of diameter 200 DIPs. The returnPopupsOnly parameter controls what properties are populated in the IdentifyLayerResult instance that is returned by the identify operation:
true: only the IdentifyLayerResult.popups property will be populated with results. If the layer does not have popups an error will be returned.
false: the IdentifyLayerResult.geoElements property will be populated. The IdentifyLayerResult.popups property will be populated if the layer has popups.
Return
A Result containing an IdentifyLayerResult, or failure
Since
200.0.0
Parameters
layer on which to run the identify
location at which to run identify in screen coordinates
extent of the region used during the identify operation
whether the IdentifyLayerResult.geoElements property of the result is populated
maximum size of the result set of GeoElements (element type dependent on target layer) to return per layer or sublayer. -1 indicates unlimited results