DrillDownGeoCoder Class

public class DrillDownGeoCoder : IDisposable, 
	IRegionSearcher

Public Class DrillDownGeoCoder
	Implements IDisposable, IRegionSearcher

// 
// First, we'll check that we can create a DrillDownGeoCoder in the USA.
// If we can create one, we'll do so. If not, the code will silently exit.
// 
if (!DrillDownGeoCoder.HasDrillDownGeoCoder(Country.USA)) return 0;
DrillDownGeoCoder ddgc = new DrillDownGeoCoder(Country.USA);
Console.WriteLine("DDGC Created");

// 
// Next, we'll find out how many region levels (state, country etc) we need to set
// 
int numRegionLevels = ddgc.NumRegionLevels;

// 
// Get the all possible regions in the first (zeroth) region level...
// Often, you'll want to start a loop here:
// for (each region level) {
//      while (not yet made a selection) {
//          display list of options;
//          ask user to make a selection;
//      }
//      set this region level;
//      move on to the next region level;
// }
RegionSearchResult rsr = ddgc.GetRegions(0);
RegionData[] regionData = rsr.Results;

// 
// You could output them for the user to make a selection
// - this could also be done using a combo/list box
// 
for (int i = 0; i < regionData.Length; i++)
    Console.WriteLine(regionData[i].ToString());

// 
// If you know the start of the region name, you can get a list of
// possible regions with a filter applied:
// 
rsr = ddgc.GetRegions(levelNumber, startOfName);
regionData = rsr.Results;

// 
// Suppose that the second region (element 1) in the regions[] array is the desired
// region for this level, you should set this region in the DrillDownGeoCoder:
// 
ddgc.SetRegion(regionData[1]);

// 
// Repeat the process for the remaining region levels.
// Then, a similar procedure should be made using the ddgc.GetStreets() method.
// This will give a list of appropriate streets. If implemented well,
// a DrillDownGeoCoder provides a fast and effective way of locating a street.
// 
// if (all region levels set) {
//      get the first letter of the street name;
//      display list of matching streets to user;
//      let the user make a selection;
//      display streetData information (location/name of street etc);
// }

// Once you've found a street you can use the StreetData.GetAddressLocation
// method to find the exact location of an address (specified by street number)