com.esri.arcgis.location
Class IAdvancedGeocoding2Proxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      com.esri.arcgis.location.IAddressGeocodingProxy
          com.esri.arcgis.location.IAdvancedGeocodingProxy
              com.esri.arcgis.location.IAdvancedGeocoding2Proxy

All Implemented Interfaces:

IAddressGeocoding, IAdvancedGeocoding, IAdvancedGeocoding2, Externalizable, Serializable

public class IAdvancedGeocoding2Proxy
extends IAdvancedGeocodingProxy
implements IAdvancedGeocoding2, Serializable

Provides access to members for advanced geocoding functions.

When To Use

Locators that use the second generation ESRI geocoding engine do not support IAdvancedGeocoding.

Use the IAdvancedGeocoding2 interface when using geocoding functionality specific to locators that use the ESRI geocoding engine, such as address standardization and rematching.

Product Availability

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

See Also:

Serialized Form

Field Summary

boolean

noncastable

Fields inherited from class com.esri.arcgis.interop.Dispatch

DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, objRef

Constructor Summary

	IAdvancedGeocoding2Proxy()
	IAdvancedGeocoding2Proxy(Object obj)
protected	IAdvancedGeocoding2Proxy(Object obj, String iid)

Method Summary

void	addListener(String iidStr, Object theListener, Object theSource)
void	matchRecordSet(ICursor addressCursor, String addressFieldNames, IRecordSetInit outputRecordSet, String outputFieldNames, IPropertySet fieldsToCopy, ITrackCancel cancelTracker) Geocodes a cursor of addresses to a RecordSet.
void	removeListener(String iidStr, Object theListener)

Methods inherited from class com.esri.arcgis.location.IAdvancedGeocodingProxy

findStandardizedAddressCandidates, getStandardizeFields, matchStandardizedAddress, rematchTable, standardizeAddress

Methods inherited from class com.esri.arcgis.location.IAddressGeocodingProxy

getMatchFields, matchAddress, matchTable, validate

Methods inherited from class com.esri.arcgis.interop.Dispatch

bindUsingMoniker, constructVtblPosTable, convertToNative, cookieForListener, createDispatch, createObjrefMonikerDisplayName, equals, getActiveObject, getActiveObject, getDefaultProperty, getDispatchIdOfName, getLastErrorCode, getMtsObjectContext, getObjRef, getPropertyByName, getPropertyByName, getVtblPos, hashCode, initDispatch, invoke, invokeMethodByName, invokeMethodByName, invokeMethodByName, invokePropertyGetByName, invokePropertyPutByName, invokePropertyPutByRefByName, isNativeMode, isObjRef, optimizedVtblInvoke, queryInterface, readExternal, release, setNativeMode, setPropertyByName, toString, vtblInvoke, writeExternal

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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

findStandardizedAddressCandidates, getStandardizeFields, matchStandardizedAddress, rematchTable, standardizeAddress

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

getMatchFields, matchAddress, matchTable, validate

Field Detail

noncastable

public boolean noncastable

Constructor Detail

IAdvancedGeocoding2Proxy

public IAdvancedGeocoding2Proxy()

IAdvancedGeocoding2Proxy

public IAdvancedGeocoding2Proxy(Object obj)
                         throws IOException

Throws:

IOException

IAdvancedGeocoding2Proxy

protected IAdvancedGeocoding2Proxy(Object obj,
                                   String iid)
                            throws IOException

Throws:

IOException

Method Detail

addListener

public void addListener(String iidStr,
                        Object theListener,
                        Object theSource)
                 throws IOException

Overrides:

addListener in class IAdvancedGeocodingProxy

Throws:

IOException

removeListener

public void removeListener(String iidStr,
                           Object theListener)
                    throws IOException

Overrides:

removeListener in class IAdvancedGeocodingProxy

Throws:

IOException

matchRecordSet

public void matchRecordSet(ICursor addressCursor,
                           String addressFieldNames,
                           IRecordSetInit outputRecordSet,
                           String outputFieldNames,
                           IPropertySet fieldsToCopy,
                           ITrackCancel cancelTracker)
                    throws IOException,
                           AutomationException

Geocodes a cursor of addresses to a RecordSet.

Description

The MatchRecordSet method is similar to the IAddressGeocoding::MatchTable method, in that the locator geocodes a set of input address records to a set of output features. Unlike the IAddressGeocoding::MatchTable method, the output features are not stored in a feature class. Using this method is useful when geocoding multiple addresses and the geocoding results do not need to be persisted in a feature class.

The addressCursor parameter is a Cursor that contains the set of addresses to geocode. As a minimum, the cursor must contain all of the address fields required by the locator, and should contain as many address fields that can be used by the locator as are available. The cursor can contain additional fields, and these fields can be copied to the resulting RecordSet.

The addressFieldNames parameter is a comma-delimited string containing the field names in the cursor that correspond to the address fields used by the locator. The names of the fields given in this parameter must be specified in the same order as the order of the address fields returned by the IAddressInputs::AddressFields property.

The outputRecordSet parameter is a reference to the RecordSet object to which the locator will add the geocoded features. The Recordset must be co-created before passing it as a parameter to the MatchRecordSet method, and as a minimum, should contain the match fields generated by the locator. Use the IAddressGeocoding::MatchFields property to get the set of match fields generated by the locator. The RecordSet can optionally contain any fields for attributes that you want to copy from the addressCursor, as specified by the fieldsToCopy parameter. Use the IRecordSetInit::CreateTable method to initialize the RecordSet with the desired set of fields.

The outputFieldNames parameter is a comma-delimited string containing the names of the fields in the outputRecordSet corresponding to the match fields generated by the locator. The names ofthe fields given in this parameter must be specified in the same order and the order of the match fields returned by the IAddressGeocoding::MatchFields property.

The fieldsToCopy parameter is a PropertySet containing the mapping of fields in the addressCursor that you wish to copy to the outputRecordSet. The names of the properties in the PropertySet are the names of the fields in the outputRecordSet that will contain the copied values, and the value of the properties are the names of the fields in the addressCursor that contain the values to copy. If you do not wish to copy attributes from the addressCursor to the ouputRecordSet, you must still co-create an empty PropertySet and pass it to the MatchRecordSet method using this parameter.

The cancelTracker parameter is an optional reference to a CancelTracker object that allows you to display the progress while the locator geocodes the addressCursor.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

matchRecordSet in interface IAdvancedGeocoding2

Parameters:

addressCursor - A reference to a com.esri.arcgis.geodatabase.ICursor (in)

addressFieldNames - The addressFieldNames (in)

outputRecordSet - A reference to a com.esri.arcgis.geodatabase.IRecordSetInit (in)

outputFieldNames - The outputFieldNames (in)

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

cancelTracker - A reference to a com.esri.arcgis.system.ITrackCancel (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.