ArcObjects Library Reference (Location)  

IAdvancedGeocoding.FindStandardizedAddressCandidates Method

Generates candidates for a standardized address.

[Visual Basic .NET]
Public Function FindStandardizedAddressCandidates ( _
    ByVal standardizedAddress As IPropertySet _
) As IArray
[C#]
public IArray FindStandardizedAddressCandidates (
    IPropertySet standardizedAddress
);
[C++]
HRESULT FindStandardizedAddressCandidates(
  IPropertySet* standardizedAddress,
  IArray** results
);
[C++]

Parameters

standardizedAddress [in]

  standardizedAddress is a parameter of type IPropertySet

results [out, retval]

  results is a parameter of type IArray

Product Availability

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

Remarks

All of the locators provided with ArcGIS prior to 10.0 standardize addresses before matching them to the reference data. Version 10.0 locators do not use standardization for matching and therefore do not support IAdvancedGeocoding.

Sometimes, locators are not able to standardize addresses properly and thus cannot match them. If you find addresses that a locator cannot match, examining how they are standardized may help you determine why they cannot be matched. You may even be able to modify the standardization so that the addresses are standardized properly and thus improve the likelihood that the locator can match them.

The standardizedAddress parameter is a PropertySet containing a standardized address. Use the StandardizeAddress method to obtain a PropertySet containing a standardized address. Alternatively, you can construct a standardized address by creating a PropertySet whose values are defined by the names of the fields returned by the StandardizeFields property.

The Array returned by this method contains PropertySets, each of which contains a candidate for the standardized address. The properties in these PropertySets names are defined by the names of the fields returned by the IAddressGeocoding::MatchFields property.

See Also

IAdvancedGeocoding Interface