com.esri.arcgis.location
Class IAdvancedGeocoding2Proxy

java.lang.Object
  extended by com.esri.arcgis.interop.Dispatch
      extended by com.esri.arcgis.location.IAddressGeocodingProxy
          extended by com.esri.arcgis.location.IAdvancedGeocodingProxy
              extended by 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.