Find Similar Features Using Embeddings (GeoAI Tools)

Summary

Performs large-scale similarity search on location and image data by comparing their embedding representations. It identifies features that are most similar to selected input/query features, enabling efficient pattern discovery and insight extraction across extensive spatial datasets.

Usage

The tool requires two inputs, an embeddings feature class that defines the search space and a query feature layer containing one or more polygons that represent the objects of interest.

Label	Explanation	Data type
Embedding Features	The feature class containing embeddings to find features most similar to the query features.	Feature Class
Query Features	The feature layer containing one or more features representing the objects of interest	Feature Layer
Output Embeddings Feature Class	The feature class that stores the results of similarity search.	Feature Class
Threshold	The minimum similarity score an embedding feature must have when compared with the query features to be included in the output.	Double

arcpy.geoai.FindSimilarFeaturesUsingEmbeddings(embedding_features, query_features, out_embeddings_feature_class, threshold)

Name	Explanation	Data type
embedding_features	The feature class containing embeddings to find features most similar to the query features.	Feature Class
query_features	The feature layer containing one or more features representing the objects of interest	Feature Layer
out_embeddings_feature_class	The feature class that stores the results of similarity search.	Feature Class
threshold	The minimum similarity score an embedding feature must have when compared with the query features to be included in the output.	Double

Code sample

FindSimilarFeaturesUsingEmbeddings example (stand-alone script)

The following example demonstrates how to use the FindSimilarFeaturesUsingEmbeddings function.

# Name: FindSimilarFeaturesUsingEmbeddings.py
# Description: Performs large-scale similarity search on location and image data by comparing their embedding representations.
#
# Requirements: ArcGIS Pro Advanced license

# Import system modules
import arcpy

# Set local variables
embedding_features = "C:/project/MyProject.gdb/generated_embeddings"
query_features = "C:/project/MyProject.gdb/query"
out_embeddings_feature_class = "C:/project/MyProject.gdb/output_features"
threshold = 0.5

# Run Find Similar Features Using Embeddings
arcpy.geoai.FindSimilarFeaturesUsingEmbeddings(embedding_features, query_features, out_embeddings_feature_class, threshold)

Environments

Output Coordinate System, Geographic Transformations, Extent

Licensing information