com.esri.arcgis.location
Interface IAdvancedIntersectionGeocoding

All Superinterfaces:

IIntersectionGeocoding, Serializable

All Known Implementing Classes:

AGSAddressLocator, CompositeLocator, ESRIFDOAddressLocator, IAdvancedIntersectionGeocodingProxy, StreetMapAddressLocator

public interface IAdvancedIntersectionGeocoding
extends IIntersectionGeocoding, Serializable

Provides access to members for advanced intersection geocoding functions.

Remarks

Locators that use the ESRI geocoding engine and that support intersection geocoding support the IAdvancedIntersectionGeocoding interface. You can use this interface to inspect the standardization of intersection addresses and to find candidates for and then match standardized intersection addresses.

When To Use

IAdvancedIntersectionGeocoding is only supported by locators created in ArcGIS 9.3.1 and prior versions.

Use the IAdvancedIntersectionGeocoding interface to inspect the standardization of intersection addresses, and to find candidates for, and match standardized intersection addresses.

Product Availability

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

Method Summary

IArray	findStandardizedIntersectionCandidates(IPropertySet standardizedIntersection) Generates candidates for a standardized intersection.
IFields	getStandardizeIntersectionFields() Fields contained in a standardized intersection.
IPropertySet	matchStandardizedIntersection(IPropertySet standardizedIntersection) Geocodes a single standardized intersection.

Methods inherited from interface com.esri.arcgis.location.IIntersectionGeocoding

getIntersectionCandidateFields, isIntersection

Method Detail

getStandardizeIntersectionFields

IFields getStandardizeIntersectionFields()
                                         throws IOException,
                                                AutomationException

Fields contained in a standardized intersection.

Remarks

The StandardizeIntersectionFields property returns a Fields object that you can use to inspect a standardized intersection address. To determine if an address is an intersection, use the IIntersectionGeocoding::IsIntersection method. You can then standardize the address using the IAdvancedGeocoding::StandardizeAddress method. The name of each Field in the Fields object corresponds to a property name in the PropertySet for the standardized address.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

A reference to a com.esri.arcgis.geodatabase.IFields

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

matchStandardizedIntersection

IPropertySet matchStandardizedIntersection(IPropertySet standardizedIntersection)
                                           throws IOException,
                                                  AutomationException

Geocodes a single standardized intersection.

Remarks

Use the MatchStandardizedIntersection method to match a standardized intersection address.

The standardizedIntersection parameter is a PropertySet containing the components of the standardized intersection address. You can obtain a standardized address using the IAdvancedGeocoding::StandardizeAddress method.

This method returns a PropertySet containing the match for the address. The names of its properties are determined by the names of the fields returned by the IAddressGeocoding::MatchFields property.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

standardizedIntersection - A reference to a com.esri.arcgis.system.IPropertySet (in)

Returns:

A reference to a com.esri.arcgis.system.IPropertySet

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

findStandardizedIntersectionCandidates

IArray findStandardizedIntersectionCandidates(IPropertySet standardizedIntersection)
                                              throws IOException,
                                                     AutomationException

Generates candidates for a standardized intersection.

Remarks

The FindStandardizedIntersectionCandidates method returns a set of candidates for a standardized intersection address.

The standardizedIntersection parameter is a PropertySet that contains a standardized address. You can create a standardized address using the IAdvancedGeocoding::StandardizeAddress method.

This method returns an Array of PropertySets containing candidates for the standardized intersection address. The names of the properties are defined by the names of the fields returned by the IIntersectionGeocoding::IntersectionCandidateFields property.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

standardizedIntersection - A reference to a com.esri.arcgis.system.IPropertySet (in)

Returns:

A reference to a com.esri.arcgis.system.IArray

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.