This document is archived and information here might be outdated.  Recommended version.

IAddressCandidates Interface (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Location > ESRI.ArcGIS.Location > Interfaces > IA > IAddressCandidates Interface
ArcGIS Developer Help

IAddressCandidates Interface

Provides access to members for generating candidates for an address. Note: the IAddressCandidates interface has been superseded by IAddressCandidates2. Please consider using the more recent version.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

When To Use

Use the IAddressCandidates interface to find and inspect candidates for a single address.


Name Description
Read-only property CandidateFields Fields contained in a list of candidates.
Method FindAddressCandidates Generates candidates for an address.

Classes that implement IAddressCandidates

Classes Description
AGSAddressLocator A locator adaptor for the GeocodeServer proxies.
ESRIFDOAddressLocator An address locator that uses the Esri geocoding engine developed prior to ArcGIS version 10.0.
ESRIGen2AddressLocator An address locator that uses the Esri geocoding engine introduced in ArcGIS version 10.0.
RSLocator An address locator that uses the Esri RouteServer geocoding engine.
StreetMapAddressLocator A locator that uses the Esri geocoding engine and StreetMap reference data sources.


Address candidates are defined by a number of candidate fields. Each candidate field describes some part of the address information for the match candidate. An address locator uses these candidate fields to determine how well a candidate matches an address. The candidate fields that are generated by the address locator styles provided with ArcGIS are described below:

See Also

IAddressCandidates Interface