USExtractExample.cs

namespace Examples
{
	using System;
    using System.IO;
    using System.Net;
    using SmartyStreets;
	using SmartyStreets.USExtractApi;

	internal static class USExtractExample
	{
		public static void Run()
		{
            // specifies the TLS protocoll to use - this is TLS 1.2
            const SecurityProtocolType tlsProtocol1_2 = (SecurityProtocolType)3072;

            // We recommend storing your secret keys in environment variables.
            var authId = Environment.GetEnvironmentVariable("SMARTY_AUTH_ID");
			var authToken = Environment.GetEnvironmentVariable("SMARTY_AUTH_TOKEN");
			ServicePointManager.SecurityProtocol = tlsProtocol1_2;

			var client = new ClientBuilder(authId, authToken).BuildUsExtractApiClient();
			var text = "Here is some text.\r\nMy address is 3785 Las Vegs Av." +
			           "\r\nLos Vegas, Nevada." +
			           "\r\nMeet me at 1 Rosedale Baltimore Maryland, not at 123 Phony Street, Boise Idaho.";
			
			// Documentation for input fields can be found at:
			// https://smartystreets.com/docs/cloud/us-extract-api#http-request-input-fields
			
			var lookup = new Lookup(text)
			{
				IsAggressive = true,
				AddressesHaveLineBreaks = false,
				AddressesPerLine = 1
			};

			//uncomment the line below to add a custom parameter
			//lookup.AddCustomParameter("addr_line_breaks", "false");
			
            try
            {
                client.Send(lookup);
            }
            catch (SmartyException ex)
            {
                Console.WriteLine(ex.Message);
                Console.WriteLine(ex.StackTrace);
				return;
            }
            catch (IOException ex)
            {
                Console.WriteLine(ex.StackTrace);
				return;
            }

			var result = lookup.Result;

            if (result.Metadata == null)
            {
                Console.WriteLine("No candidates. This means the address is not valid.");
                return;
            }

            var metadata = result.Metadata;
			Console.WriteLine("Found " + metadata.AddressCount + " addresses.");
			Console.WriteLine(metadata.VerifiedCount + " of them were valid.");
			Console.WriteLine();

			var addresses = result.Addresses;

			Console.WriteLine("Addresses: \r\n**********************\r\n");
			foreach (var address in addresses)
			{
				Console.WriteLine("\"" + address.Text + "\"\n");
				Console.WriteLine("Verified? " + address.Verified);
				if (address.Candidates.Length > 0)
				{
					Console.WriteLine("\nMatches:");

					foreach (var candidate in address.Candidates)
					{
						Console.WriteLine(candidate.DeliveryLine1);
						Console.WriteLine(candidate.LastLine);
						Console.WriteLine();
					}
				}
				else
				{
					Console.WriteLine();
				}

				Console.WriteLine("**********************\n");
			}
		}
	}
}