Find by Attributes and Location is equivalent to Find Existing Locations and Derive New Locations in Map Viewer Classic.
The Find by Attributes and Location tool creates a new layer of the features or parts of features that meet specified spatial or attribute criteria.
The output is a hosted feature layer.
Example uses of this tool include the following:
- A real estate development company is looking for suitable areas to build a mixed-use development. The development will be in an area with plenty of young adults in their 20s and 30s with easy access to the city's light-rail system. Use the Find by Attributes and Location tool to create features within the city limits that are zoned for mixed-use development and fit the selection criteria.
- State park officials are concerned about interactions between cougars and humans and decide to map potential cougar habitat within the park. The habitat will be based on criteria such as vegetation, slope, and proximity to roads. Use the Find by Attributes and Location tool to create habitat areas that meet the suitability criteria.
The Find by Attributes and Location tool includes configurations for criteria and the result layer.
The Criteria group includes the following parameters:
- Spatial and attribute queries defines the criteria used to find features. Those features, or portions of features, that satisfy all criteria will be written to the result layer. To define a query, click Build new query. You can only build queries using the layers on the map.
- Include only the parts of features that meet the criteria specifies how a feature is returned when only a portion of it meets the criteria.
- Checked—Only the portions of the feature that meet all criteria will be returned.
- Unchecked—The entire feature will be returned provided at least a portion of the feature meets all criteria. This is the default.
- A polygon layer colored in blue, red and green.
- A polygon layer that is transparent with a pink outline.
This example finds the polygons where the colour is blue and they intersect with the transparent polygons with the pink outline. The following two outputs show the difference in results when Include only the parts of features that meet the criteria is checked (first image) and unchecked (second image):
The Result layer group includes the following parameters:
- Output name determines the name of the layer that is created and added to the map. The name must be unique. If a layer with the same name already exists in your organization, the tool will fail and you will be prompted to use a different name.
- Save in folder specifies the name of a folder in My Content where the result will be saved.
Analysis environment settings are additional parameters that affect a tool's results. You can access the tool's analysis environment settings from the Environment settings parameter group.
This tool honors the following analysis environments:
This tool consumes credits.
Use Estimate credits to calculate the number of credits that will be required to run the tool. For more information, see Understand credits for spatial analysis.
The Find by Attributes and Location tool creates an output hosted feature layer with the same geometry types as the layer that was used to find results.
The output includes attributes from the input feature where features were found. There may be additional fields from features that were used in spatial operations. Some fields may be renamed if field names are duplicated.
This tool requires the following licensing and configurations:
- Creator or GIS Professional user type
- Publisher, Facilitator, or Administrator role, or an equivalent custom role
Use the following resources to learn more: