How to rematch a geocoded feature class (ArcObjects .NET 10.5 SDK)

In this topic

Rematching a geocoded feature class
Using the geoprocessing tool
Using ArcObjects

Rematching a geocoded feature class

After geocoding a table of addresses, you can review the results. If you are not satisfied with the results, modify the address locator's settings, and geocode the table of addresses or records that were not matched again. This process is known as rematching.

The following are some of the ways to specify addresses in a geocode feature class that you want to rematch:

Only addresses that are unmatched
All addresses with a match score less than a certain value
All addresses with two or more candidates with the best match score
All addresses
Addresses based on a specified query

Using the geoprocessing tool

Run the RematchAddresses geoprocessing tool if the address table or locator has been updated, and the geocoded feature class needs to be updated to reflect the changes. See the following code example:

[VB.NET]

Public Sub RematchAddressesTool_Test()
    Dim GP As ESRI.ArcGIS.Geoprocessor.Geoprocessor=New ESRI.ArcGIS.Geoprocessor.Geoprocessor
    Dim rematchAddresses As RematchAddresses=New RematchAddresses()
    rematchAddresses.in_geocoded_feature_class="C:\UnitedStates.gdb\US_Locations"
    rematchAddresses.out_geocoded_feature_class="C:\UnitedStates.gdb\US_Locations"
    Try
    Dim result As IGeoProcessorResult=GP.Execute(rematchAddresses, Nothing)
    If (Not result Is Nothing) Then
        If (Not result.Status=esriJobStatus.esriJobSucceeded) Then
            Console.WriteLine("Failed to rematch the addresses: ")
        Else
            Console.WriteLine("Rematch addresses completed successfully. ")
        End If
    Else
        If (Not GP.MessageCount=0) Then
            For i As Integer=0 To GP.MessageCount - 1
                Console.WriteLine("GP Message " & i & " " + GP.GetMessage(i))
            Next
        Else
            Console.WriteLine("Execution failed with no status. ")
        End If
    End If
    Catch ex As Exception
    Console.WriteLine("An Exception occured while executing the RematchAddresses Tool:  " & ex.ToString())
    End Try
End Sub

[C#]

public void RematchAddressesTool()
{
    Geoprocessor GP=new Geoprocessor();
    RematchAddresses rematchAddresses=new RematchAddresses();
    rematchAddresses.in_geocoded_feature_class=
        "C:\\UnitedStates.gdb\\US_Locations";
    rematchAddresses.out_geocoded_feature_class=
        "C:\\UnitedStates.gdb\\US_Locations";
    try
    {
        IGeoProcessorResult result=GP.Execute(rematchAddresses, null)as
            IGeoProcessorResult;
        if (result != null)
        {
            if (result.Status != esriJobStatus.esriJobSucceeded)
                Console.WriteLine("Failed to rematch the addresses: ");
            else
                Console.WriteLine("Rematch addresses completed successfully. ");
        }
        else
        {
            if (GP.MessageCount != 0)
            {
                for (int i=0; i < GP.MessageCount; i++)
                {
                    Console.WriteLine("GP Message " + i + " " + GP.GetMessage(i));
                }
            }
            else
                Console.WriteLine("Execution failed with no status. ");
        }
    }
    catch (Exception e)
    {
        Console.WriteLine(
            "An Exception occured while executing the RematchAddresses Tool:  " + e);
    }
}

Using ArcObjects

The IBatchGeocoding interface has methods to match a record set or rematch a table. Usually, you use the IBatchGeocoding interface to rematch a geocoded feature class using the RematchTable method.

The RematchTable method takes a number of parameters. Most of these parameters can be retrieved from the AttachedLocator object associated with the geocoded feature class.

Do the following steps to rematch a feature class:

Open an ArcSDE workspace.
Open the feature class to rematch.
Get the locator that is attached to the feature class.
Modify the geocoding properties on the locator and rematch the feature class.

See the following code example: