The Proximity Analysis tool lets you build powerful spatial queries to determine the relationship between selected points or features and neighboring points or features.

The proximity tool can be used to determine spatial relationships using one of several proximity types. These types vary with the data type of the layers you are comparing:

For spatial relationships:

where x is polygon, point or line and and y is polygon

  • FIND x THAT are within SELECTED y
  • FIND x THAT touch SELECTED y
  • FIND x THAT are closer than z from SELECTED y
  • FIND x THAT are further than z SELECTED y
  • FIND x THAT are outside SELECTED y

where x is polygon, point or line and and y is point

  • FIND x THAT are closer than z from SELECTED y
  • FIND x THAT are further than z SELECTED y

where x is polygon, point or line and and y is line

  • FIND x THAT touch SELECTED y
  • FIND x THAT are closer than z from SELECTED y
  • FIND x THAT are further than z SELECTED y
  • FIND x THAT are outside SELECTED y

The distance field ( x km/ x mi) appears only if the “closer than” and “further than” options are selected in the THAT field.

If the FIND field is a point layer, and the SELECTED field is a polygon layer, THAT will default to “within”, as the most commonly used spatial relationship query would be finding points within an area.

eg. Meteorite falls within a Country, filtered to only return strikes within the US

This query returns the target features in yellow highlight. In this example, all points in the Meteorite Falls layer that exist within the boundaries of the United States polygon from the Countries dataset, highlighted in red:

If both FIND and SELECTED fields are point layers, THAT will default to a distance input, as one point cannot be “contained within” another in the above example.

eg. * FIND Meteorite falls THAT are closer than 5 mi from SELECTED Populated Places, within a set radius:

The query returns all SELECTED Populated Places within the radius highlighted red, and all target Meteorite Falls that are closer than 5 mi from those populated places in yellow.

Configuration

To activate Proximity Analysis for your web map, open your toolbox and activate the tool.

Proximity tool settings

Set the tool settings here. A preview of how the tool will appear to end users will update on the right.

Tool Name Give your tool a custom name that is specific to the use case of your map.

Description Give a custom description that gives the end user an explanation of the tool or brief instructions.

Measurement Units Set the units in the search.

Highlight Color The color of the highlight that will be applied to selected features and features in the results.

Click next.

Layers

Choose which layers will be available to the tool by toggling them on or off.

For each layer you enable, you can set the limitations or scope of the search on that layer. Open the Layer Settings to configure each layer.

Layer Settings

Configure each layer’s settings, such as how it will appear in the tool.

Layer Name indicates how the layer will be named in the tool. It’s best to use brief, descriptive names so that it is clear to users what data they are querying.

Filter Options To ensure a targeted search, you can filter and enable only relevant fields and selection tools available to the search user for each layer.

To allow users to filter the layer by selected attribute values, enable Filter by value and select the attributes you want to be available in the filter. Attributes not selected will not be available in the filter, nor shown in the query output.

To allow users to draw boundaries to query within, or to select individual features by clicking and drawing on the map, enable the Filter by area or location toggle. If this is disabled, the tool will query all features in the layer.

Once you have configured each enabled layer, click Next to set the Results options.

Results Options

The results output of the search allows you to tailor the results to the user’s needs. You can allow users to view results as a table, view a pre-configured report using the report builder, or download results in any of the enabled spatial file formats.

You can also create custom reports by enabling the Report option.

Report Builder

The Report Builder allows you to configure meaningful summarized report widgets that provide instant insights for users.

You can add any number of report widgets as required.

Custom widget

Configure your own custom report using result, and custom equations with javascript syntax. For details on creating a custom report, please read this article.

Aggregate Table widget

Returns a table of values for the selected field.

See the Proximity Analysis tool in action

Need more help with this?
✉ Email the Mango support team

Was this helpful?

Yes No
You indicated this topic was not helpful to you ...
Could you please leave a comment telling us why? Thank you!
Thanks for your feedback.