## Find Existing Locations

##

This tool selects existing features in your study area that meet a series of criteria you specify. These criteria can be based on attribute queries (for example, parcels that are vacant) and spatial queries (for example, within one mile of a river).

If Use current map extent is checked, only the features in the input layer that are visible within the current map extent will be analyzed. If unchecked, all features will be analyzed, even if they are outside the current map extent.

## Choose layer containing features you want to find using attribute and spatial queries

The point, line, or area layer for which you want to find features based on a combination of attribute and spatial queries specified below.

In addition to choosing a layer from your map, you can select Choose Living Atlas Analysis Layer or Choose Analysis Layer found at the bottom of the drop-down list. This opens a gallery containing a collection of layers useful for many analyses.

## Build a query to find features

Click the Add Expression button to define an expression. You can add multiple expressions. After entering the expressions and clicking the Run Analysis button, features in your input layer are filtered through each expression. Those features that satisfy all expressions are written to the result layer.

There are two basic types of expressions you can create; attribute and spatial. Attribute expressions are queries on field values, such as `where name is 'San Francisco'`. There are four types of spatial expressions:

- within a distance of: the feature must be within a distance of a feature in another layer. For example, find parcels within 500 meters of the Los Angeles river.
- completely contains: the feature must contain all of a feature in another layer. For example, find watersheds that completely contain parcels zoned for industrial use. No part of the parcel can be outside of the watershed.
- completely within: the feature must be entirely surrounded by a feature in another layer. For example, find school districts that are completely within the boundary of a city. No part of the school district can be outside of the city boundary.
- intersects: the feature contains a part of a feature in another layer. For example, find parcels that intersect rivers. Any part of the river that passes through the parcel, or touches the boundary of the parcel, intersects the parcel.

Each spatial expression has a corresponding negation; not within a distance of, does not completely contain, not completely within, and does not intersect.

## Result layer name

This is the name of the layer that will be created in My Content and added to the map. The default name is based on the tool name and the input layer name. If the layer already exists, you will be asked to provide another name.

Using the Save result in drop-down box, you can specify the name of a folder in My Content where the result will be saved.