{"id":8244,"date":"2022-12-02T15:53:36","date_gmt":"2022-12-02T15:53:36","guid":{"rendered":"https:\/\/test.serviceobjects.com\/docs\/?page_id=8244"},"modified":"2024-03-29T08:48:17","modified_gmt":"2024-03-29T15:48:17","slug":"dots-address-geocode-us","status":"publish","type":"page","link":"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/","title":{"rendered":"DOTS Address Geocode &#8211; US"},"content":{"rendered":"\n<ul class=\"is-style-bullets-list wp-block-list\">\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-Introduction\">Introduction<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-Integration\">Integration<\/a>\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-CodeSnippets\">Code Snippets<\/a><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-ListofOperations\">List of Operations<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-OperationDefinitions\">Operation Definitions<\/a>\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-GetBestMatch_V4\">GetBestMatch_V4<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-GetBestMatch_V3\">GetBestMatch_V3<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-GetGeoLocationByZipPlusFour\">GetGeoLocationByZipPlusFour<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-GetGeoLocationByZipPlusTwo\">GetGeoLocationByZipPlusTwo<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-GetZipInfo\">GetZipInfo<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-GetGeoLocationByCityState\">GetGeoLocationByCityState<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-GetDistance\">GetDistance<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-GetDistanceToWater\">GetDistanceToWater<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-GetDistanceToWaterByaddress\">GetDistanceToWaterByaddress<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-GetGeoLocationWorldwide\">GetGeoLocationWorldwide<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-GetReverseLocation\">GetReverseLocation<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-GetGeoLocation\">GetGeoLocation<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-GetBestMatch\">GetBestMatch&nbsp;<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-GetBestMatch_V2\">GetBestMatch_V2<\/a><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-ErrorCodes\">Error Codes<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-FrequentlyAskedQuestions\">Frequently Asked Questions<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#DOTSAddressGeocode-US-Conclusion\">Conclusion<\/a><\/li>\n<\/ul>\n\n\n\n<h1 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-Introduction\"><strong>Introduction<\/strong><br><\/h1>\n\n\n\n<p>DOTS Address Geocode \u2013 US is a publicly available XML web service that provides latitude\/longitude and metadata information about a physical US address. The service provides geocoding information, such as the latitude and longitude location of a US address, along with demographic information, such as the census tract, block and other metadata.<\/p>\n\n\n\n<p>DOTS Address Geocode \u2013 US can help provide instant address locations to websites or enhancement to contact lists.<a rel=\"noreferrer noopener\" href=\"https:\/\/www.serviceobjects.com\/get-key\/?wsid=34\" target=\"_blank\"><\/a><\/p>\n\n\n\n<h1 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-Integration\"><strong>Integration<\/strong><\/h1>\n\n\n\n<p>Integrating DOTS Address Geocode \u2013 US into your application should be easy and straightforward. If you are using a common platform, Service Objects may already have sample code built that you can use:<br><a href=\"https:\/\/www.serviceobjects.com\/sample-code\/?service=34\" data-type=\"URL\" data-id=\"https:\/\/www.serviceobjects.com\/developers\/sample-code\/?service=34\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/www.serviceobjects.com\/sample-code\/?service=34<\/a><\/p>\n\n\n\n<p>However, if you are using a common platform that does not already have sample code, you can ask Service Objects to build you an example. Email&nbsp;<a href=\"mailto:support@serviceobjects.com\" rel=\"noreferrer noopener\" target=\"_blank\">support@serviceobjects.com<\/a>&nbsp;for more details.<\/p>\n\n\n\n<p><strong>Web Service Structure:<\/strong><\/p>\n\n\n\n<p>Web services are methods that integrate with other applications via the web, and encapsulate complex business logic. Web services are too large a topic to cover in this document, but Service Objects has developed its web services to be as easy to integrate and as accessible as possible.<br>DOTS Address Geocode \u2013 US is a public XML web service that supports SOAP, POST and GET operations.<\/p>\n\n\n\n<p><strong>The host path, or physical location of the web service is here:<\/strong><\/p>\n\n\n\n<p><a href=\"https:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx<\/a><\/p>\n\n\n\n<p><strong>The location of the WSDL, or Web Service Definition Language document, is here<\/strong>&nbsp;(This is also accessible via the &#8220;Service Definition&#8221; link.):<\/p>\n\n\n\n<p><a href=\"https:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx?WSDL\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx?WSDL<\/a><\/p>\n\n\n\n<div class=\"wp-block-group is-style-card-note is-layout-constrained wp-block-group-is-layout-constrained\">\n<p><strong>Important Note!<\/strong><br>SOAP is done via POST, only with special XML markup in the post-body.<\/p>\n<\/div>\n\n\n\n<p>This XML is the definition of the web service, meaning its inputs, outputs, operations, and the like. Most likely, you will have another tool read this WSDL and make the operations available to you in your application. Whenever your utilities or IDE asks for a WSDL path to DOTS Address Geocode \u2013 US, you can provide this one.<\/p>\n\n\n\n<p>Every web service has&nbsp;<em>operations<\/em>&nbsp;that it offers to subscribers \u2013 methods that do different work and return different output. Examining the link above, you will notice several of these operations available, which are described in detail later on.<\/p>\n\n\n\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-CodeSnippets\">Code Snippets<\/h2>\n\n\n\n<div class=\"wp-block-create-block-tabs\"><ul class=\"tab-labels\" role=\"tablist\" aria-label=\"tabbed content\"><li class=\"tab-label active\" role=\"tab\" aria-selected=\"true\" aria-controls=\"Code Snippets\" tabindex=\"0\">Code Snippets<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"Full Sample Code Demonstrating Failover\" tabindex=\"0\">Full Sample Code Demonstrating Failover<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"URL Formats\/Request and Response\" tabindex=\"0\">URL Formats\/Request and Response<\/li><\/ul><div class=\"tab-content\">\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<div class=\"wp-block-create-block-tabs\"><ul class=\"tab-labels\" role=\"tablist\" aria-label=\"tabbed content\"><li class=\"tab-label active\" role=\"tab\" aria-selected=\"true\" aria-controls=\"SOAP\" tabindex=\"0\">SOAP<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"Rest\" tabindex=\"0\">Rest<\/li><\/ul><div class=\"tab-content\">\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<div class=\"wp-block-create-block-tabs side-tab-layout\"><ul class=\"tab-labels\" role=\"tablist\" aria-label=\"tabbed content\"><li class=\"tab-label active\" role=\"tab\" aria-selected=\"true\" aria-controls=\"C#\" tabindex=\"0\">C#<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"Java\" tabindex=\"0\">Java<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"PHP\" tabindex=\"0\">PHP<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"ROR\" tabindex=\"0\">ROR<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"Python\" tabindex=\"0\">Python<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"ColdFusion\" tabindex=\"0\">ColdFusion<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"VB\" tabindex=\"0\">VB<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"Apex\" tabindex=\"0\">Apex<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"TSQL\" tabindex=\"0\">TSQL<\/li><\/ul><div class=\"tab-content\">\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>GeoCoder C# Code Snippet<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"csharp\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\/\/Add a service to your application https:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx?WSDL\nGCRClient_Primary = new GCRLibraryClient(\"DOTSGCR\");\nresponse = GCRClient_Primary.GetBestMatch_V3(Address, City, State, PostalCode, licenseKey);\n         \nif (response.Error != null)\n{\n    \/\/Process Error\n}\nelse\n{\n    \/\/Process Response     \n}\n<\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>GeoCoder Java Code Snippet<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"java\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">BestMatch_V3Response resp = null;\nBestMatchInfo result = null;\nError error = null;\n\/\/ Create soap request\nGCRLibraryLocator locator = new GCRLibraryLocator();\n\/\/ use ssl\nlocator.setDOTSGeoCoderEndpointAddress(\"https:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\");\nIGCRLibrary gcr = locator.getDOTSGeoCoder();\nDOTSGeoCoderStub soap = (DOTSGeoCoderStub)gcr;\nsoap.setTimeout(5000);\/\/ set timeout\nresp = soap.getBestMatch_V3(address, city, state, postalcode, key);\nresult = resp.getGetBestMatch_V3Result();\nerror = resp.getError();\nif(resp == null || (error != null &amp;&amp; error.getTypeCode() == \"3\"))\n{\n    throw new Exception();\n}\n  \n\/\/Process Results\nif(error == null){\n    \/\/DOTS GeoCode Results \n}\n\/\/Process Errors\nelse{\n    \/\/DOTS GeoCode Error Results   \n}<\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>GeoCoder PHP Code Snippets<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"php\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">&lt;?php\n\/\/ Set these values per web service &lt;as needed>\n$wsdlUrl = \"https:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx?WSDL\";\n \n$params['Address'] = $address;\n$params['City'] = $city;\n$params['State'] = $state;\n$params['PostalCode'] = $postalCode;\n$params['LicenseKey'] = $LicenseKey;\n \n$soapClient = new SoapClient($wsdlUrl, array( \"trace\" => 1 ));\n$result = $soapClient->GetBestMatch_V3($params);\nif (!isset($result->GetBestMatch_V3Result ->Error)) {\n    foreach($result->GetBestMatch_V3Result ->BestMatchInfo as $k=>$v) {\n        echo $k . \", \" . $v;\n    }\n} else {\n    foreach($result->GetBestMatch_V3Result ->Error as $k=>$v) {\n        echo $k . \", \" . $v;\n    }\n}\n?><\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>GeoCoder RoR Code Snippets<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"ruby\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">class RequestsController &lt; ApplicationController\n     \n    def show\n        @request = Request.find(params[:id])\n        #Formats inputs into a hash to pass to Soap Client\n        #Hash Keys must be named as they are shown here.\n        message =   {\n                    \"Address\" => @request.address,\n                    \"City\" => @request.city,\n                    \"State\" => @request.state,\n                    \"PostalCode\" => @request.postalcode,\n                    \"LicenseKey\" => @request.licensekey,\n                    }\n         \n        #Implemented to make the code more readable when accessing the hash        \n        @agusresponse = :get_best_match_v3_response\n        @agusresult = :get_best_match_v3_result\n        @aguserror = :error\n        #Set Primary and Backup URLs here as needed\n        dotsAGUSPrimary = \"https:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx?WSDL\"\n        dotsAGUSBackup = \"https:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx?WSDL\"\n \n        begin\n            #initializes the soap client. The convert request keys global is necessary to receive a response from the service.\n            client = Savon.client(  wsdl: dotsAGUSPrimary,\n                                    element_form_default: :qualified,\n                                    convert_request_keys_to: :camelcase\n                                 )\n            #Calls the with given inptus and converts response to a hash.\n            response = client.call(:get_best_match_v3, message: message).to_hash\n            #Checks to see what results came back from the service\n            processresults(response)           \n             \n        #If an error occurs during the call, this will use the Backup url and attempt to retrieve data.\n        rescue Savon::Error => e\n            begin\n            backupclient = Savon.client(    wsdl: dotsAGUSBackup,\n                                            element_form_default: :qualified,\n                                            convert_request_keys_to: :camelcase\n                                       )\n            #Sets the response to the backclient call to the operation and converts response to a hash.\n            response = backupclient.call(:get_best_match_v3, message: message).to_hash\n            processresults(response)\n            #If the backup url failed, this will display the error received from the server\n            rescue Savon::Error =>error\n                @status = error\n                @displaydata = {\"error\" => \"A Big Error Occured\"}\n            end\n        end\n    end\n    private\n    def processresults(response)   \n            #Processes Error Response from soap Client \n     \n            #Processes Valid response from soap client \n         \n    end\nend<\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>Address Geocode US Python Code Snippet<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"python\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">mAddress =  Address.get()\n if mAddress is None or  mAddress == \"\":\n     mAddress = \" \"\n mCity = City.get()\n if mCity is None or mCity == \"\":\n     mCity = \" \"\n mState = State.get()\n if mState is None or mState == \"\":\n     mState = \" \"\n mPostalCode = PostalCode.get()\n if mPostalCode is None or mPostalCode == \"\":\n     mPostalCode = \" \"\n mLicenseKey = LicenseKey.get()\n if mLicenseKey is None or mLicenseKey == \"\":\n     mLicenseKey = \" \"\n \n #Set the primary and backup URLs as needed\n primaryURL = 'https:\/\/sws.serviceobjects.com\/gcr\/GeoCoder.asmx?WSDL'\n backupURL = 'https:\/\/sws.serviceobjects.com\/gcr\/GeoCoder.asmx?WSDL'\n \n #This block of code calls the web service and prints the resulting values to the screen\n try:\n     client = Client(primaryURL)\n     result = client.service.GetBestMatch_V3(Address=mAddress, City=mCity, State=mState, PostalCode=mPostalCode, LicenseKey=mLicenseKey)\n     #Loops through either the error result or proper result and displays values to the screen.\n     #Handel response and check for errors\n \n #Tries the backup URL if the primary URL failed\n except:\n     try:\n         client = Client(backupURL)\n         result = client.service.GetBestMatch_V3(Address=mAddress, City=mCity, State=mState, PostalCode=mPostalCode, LicenseKey=mLicenseKey)\n     #Handel response and check for errors\n \n     #If the backup call failed then this will display an error to the screen\n     except:\n         Label(swin.window, text='Error').pack()\n         print (result)<\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>Address GeoCoder ColdFusion Code Snippet<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">&lt;!--Makes Request to web service --->\n&lt;cfscript>\n        try\n        {\n            if (isDefined(\"form.Action\") AND Action neq \"\")\n            {\n                wsresponse = CreateObject(\"webservice\", \"https:\/\/sws.serviceobjects.com\/gcr\/GeoCoder.asmx?WSDL\");                          \n                outputs = wsresponse.getBestMatch_V3(\"#Address#\", \"#City#\", \"#State#\", \"#PostalCode#\" ,\"#LicenseKey#\");\n            }\n        }\n    catch(any Exception){\n        try\n            {\n                if (isDefined(\"form.Action\") AND Action neq \"\")\n                {\n                    wsresponse = CreateObject(\"webservice\", \"https:\/\/sws.serviceobjects.com\/gcr\/GeoCoder.asmx?WSDL\");                          \n                    outputs = wsresponse.getBestMatch_V3(\"#Address#\", \"#City#\", \"#State#\", \"#PostalCode#\" ,\"#LicenseKey#\");\n                }\n            }\n            catch(any Exception)   \n                {\n                 writeoutput(\"An Error Has Occured. Please Reload and try again #Exception.message#\");              \n                }\n        }\n&lt;\/cfscript><\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>Address GeoCoder VB Code Snippet<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"visualbasic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">Try\n    Dim ws As New AGUS.DOTSGeoCoderSoapClient\n    Dim response As AGUS.Location_V3\n    response = ws.GetBestMatch_V3(Address.Text, City.Text, State.Text, PostalCode.Text, LicenseKey.Text)\n    If (response.Error Is Nothing) Then\n        ProcessValidResponse(response)\n    Else\n        ProcessErrorResponse(response.Error)\n    End If\n \nCatch\n    ''Set the Primary and Backup Service References as necessary\n    Try\n        Dim wsbackup As New AGUS.DOTSGeoCoderSoapClient\n        Dim response As AGUS.Location_V3\n        response = wsbackup.GetBestMatch_V3(Address.Text, City.Text, State.Text, PostalCode.Text, LicenseKey.Text)\n        If (response.Error Is Nothing) Then\n            ProcessValidResponse(response)\n        Else\n            ProcessErrorResponse(response.Error)\n        End If\n    Catch ex As Exception\n        resultsLabel.Visible = True\n        resultsLabel.Text = ex.Message\n         \n    End Try\nEnd Try<\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>Address GeoCoder Apex Code Snippet<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"java\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">wwwServiceobjectsCom.Location_V3 result;\ntry{\nwwwServiceobjectsCom.DOTSGeoCoderSoap client = new wwwServiceobjectsCom.DOTSGeoCoderSoap();\nresult = client.GetBestMatch_V3([Address], [City], [State], [PostalCode], [LicenseKey]);\n}\ncatch(Exception ex){\n \/\/If the first request failed try the failover endpoint\nwwwServiceobjectsCom.DOTSGeoCoderSoap backupClient = new wwwServiceobjectsCom.DOTSGeoCoderSoap();\n\/\/The backup environment will be provided to you upon purchasing a production license key\nbackupClient.endpoint_x = 'https:\/\/trial.serviceobjects.com\/AGUS\/api.svc\/soap';\nresult = backupClient.GetBestMatch_V3([Address], [City], [State], [PostalCode], [LicenseKey]);\n}<\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>Address GeoCoder TSQL Code Snippet<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"sql\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">SET @requestBody ='&lt;s:Envelope xmlns:s=\"http:\/\/schemas.xmlsoap.org\/soap\/envelope\/\">'+\n                   '&lt;s:Body xmlns:xsi=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\" xmlns:xsd=\"http:\/\/www.w3.org\/2001\/XMLSchema\">'+\n                   '&lt;GetBestMatch_V3 xmlns=\"https:\/\/www.serviceobjects.com\/\">'+\n                   '&lt;Address>' + @address + '&lt;\/Address>'+\n                   '&lt;City>' + @City + '&lt;\/City>'+\n                   '&lt;State>' + @State + '&lt;\/State>'+\n                   '&lt;PostalCode>' + @postalcode + '&lt;\/PostalCode>'+\n                   '&lt;LicenseKey>' + @key + '&lt;\/LicenseKey>'+\n                   '&lt;\/GetBestMatch_V3>'+\n                   '&lt;\/s:Body>'+\n                   '&lt;\/s:Envelope>'\nSET @requestLength = LEN(@requestBody)\n    --If a production key is purchased, this will execute the failover\nIF @isLiveKey = 1\nBEGIN\n    EXEC sp_OACreate 'MSXML2.ServerXMLHttp', @obj OUT\n    EXEC sp_OAMethod @obj, 'Open', NULL, 'POST', 'https:\/\/sws.serviceobjects.com\/gcr\/GeoCoder.asmx', false\n    EXEC sp_OAMethod @obj, 'setRequestHeader', NULL, 'HOST', 'sws.serviceobjects.com'\n    EXEC sp_OAMethod @obj, 'setRequestHeader', NULL, 'Content-Type', 'text\/xml; charset=UTF-8'\n    EXEC sp_OAMethod @obj, 'setRequestHeader', NULL, 'SOAPAction', '\"https:\/\/www.serviceobjects.com\/GetBestMatch_V3\"'\n    EXEC sp_OAMethod @obj, 'setRequestHeader', NULL, 'Content-Length', @requestLength\n    EXEC sp_OAMethod @obj, 'send', NULL, @requestBody\n    EXEC sp_OAGetProperty @obj, 'Status', @responseCode OUTPUT\n    EXEC sp_OAGetProperty @obj, 'StatusText', @statusText OUTPUT\n    EXEC sp_OAGetProperty @obj, 'responseText', @response OUTPUT\n             \n    --Checks the Response for a fatal error or if null.\n    IF @response IS NULL\n    BEGIN\n        EXEC sp_OACreate 'MSXML2.ServerXMLHttp', @obj OUT\n        EXEC sp_OAMethod @obj, 'Open', NULL, 'POST', 'https:\/\/swsbackup.serviceobjects.com\/gcr\/GeoCoder.asmx', false\n        EXEC sp_OAMethod @obj, 'setRequestHeader', NULL, 'HOST', 'swsbackup.serviceobjects.com'\n        EXEC sp_OAMethod @obj, 'setRequestHeader', NULL, 'Content-Type', 'text\/xml; charset=UTF-8'\n        EXEC sp_OAMethod @obj, 'setRequestHeader', NULL, 'SOAPAction', '\"https:\/\/www.serviceobjects.com\/GetBestMatch_V3\"'\n        EXEC sp_OAMethod @obj, 'setRequestHeader', NULL, 'Content-Length', @requestLength\n        EXEC sp_OAMethod @obj, 'send', NULL, @requestBody\n        EXEC sp_OAGetProperty @obj, 'Status', @responseCode OUTPUT\n        EXEC sp_OAGetProperty @obj, 'StatusText', @statusText OUTPUT\n        EXEC sp_OAGetProperty @obj, 'responseText', @response OUTPUT\n    END\nEND<\/pre>\n<\/div>\n<\/div><\/div>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<div class=\"wp-block-create-block-tabs side-tab-layout\"><ul class=\"tab-labels\" role=\"tablist\" aria-label=\"tabbed content\"><li class=\"tab-label active\" role=\"tab\" aria-selected=\"true\" aria-controls=\"C# Rest\" tabindex=\"0\">C# Rest<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"Java Rest\" tabindex=\"0\">Java Rest<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"PHP Rest\" tabindex=\"0\">PHP Rest<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"RoR Rest\" tabindex=\"0\">RoR Rest<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"Python Rest\" tabindex=\"0\">Python Rest<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"ColdFusion Rest\" tabindex=\"0\">ColdFusion Rest<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"VB Rest\" tabindex=\"0\">VB Rest<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\" TSQL Rest\" tabindex=\"0\"> TSQL Rest<\/li><\/ul><div class=\"tab-content\">\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>GeoCoder C# Rest Code Snippet<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"csharp\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">string mainURL = WEB_SERVICE_PRIMARY_URL + address + \"\/\" + city + \"\/\" + state + \"\/\" + postalCode + \"\/\" + licenseKey + \"?format=json\";\n            string backupURL = WEB_SERVICE_BACKUP_URL + address + \"\/\" + city + \"\/\" + state + \"\/\" + postalCode + \"\/\" + licenseKey + \"?format=json\";\n            try\n            {\n                result = HttpGet(mainURL);\n                \/\/NULL ERROR || FATAL ERROR RETURNED -- TRY BACKUP\n                if (result == null || (result.Error != null &amp;&amp; result.Error.Number == \"3\"))\n                {\n                    return HttpGet(backupURL);\n                }\n                else\n                {\n                    return result;\n                }\n            }\n            catch (Exception e)\n            {   \/\/ERROR IN MAIN URL - USING BACKUP\n                return HttpGet(backupURL);\n            }<\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>GeoCoder Java Rest Code Snippet<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"java\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">JSONObject results = RestClient(mainURL);  \ntry {\n    if (ErrorMessages != null || (results.getJSONObject(\"Location_V3\").has(\"Error\") &amp;&amp; results.getJSONObject(\"Location_V3\").getJSONObject(\"Error\").get(\"Number\") == \"3\")) {\n        \/\/ BACKUP\n        results = RestClient(backupURL);\n    }\n} catch (JSONException e) {\n    \/\/ TODO Auto-generated catch block\n    e.printStackTrace();\n}\n \nreturn results;<\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>GeoCoder PHP Rest Code Snippets<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"php\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">$URL = \"https:\/\/trial.serviceobjects.com\/GCR\/api.svc\/GetBestMatch_V3?\".rawurlencode($Address).\"\/\".rawurlencode($City).\"\/\".rawurlencode($State).\"\/\".rawurlencode($PostalCode).\"\/\".rawurlencode($LicenseKey).\"?format=json\";\n    \/\/ The actual backup url will be provided to you once you purchase a license key\n    $backupURL = \"https:\/\/trial.serviceobjects.com\/rest\/GCR\/api.svc\/BestMatchInfo\/V3\/\".rawurlencode($Address).\"\/\".rawurlencode($City).\"\/\".rawurlencode($State).\"\/\".rawurlencode($PostalCode).\"\/\".rawurlencode($LicenseKey).\"?format=json\";\n    \/\/ Get cURL resource\n    $curl = curl_init();\n    curl_setopt_array($curl, array(CURLOPT_RETURNTRANSFER => 1, CURLOPT_URL => $URL, CURLOPT_USERAGENT => 'Service Objects Address Validation 3'));\n    \/\/Https peer certification validation turned off\n    curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);\n    curl_setopt($curl, CURLOPT_CONNECTTIMEOUT_MS, $TIMEOUT); \/\/timeout in milliseconds\n    \/\/ Send the request &amp; save response to $resp\n    $resp = curl_exec($curl);\n    $status = curl_getinfo($curl);\n    $decoded = json_decode($resp, TRUE);\n    if($resp == FALSE ||\n    (isset ($decoded['Error']) != NULL &amp;&amp;\n    $decoded['Error']['Number'] == 3) ||\n    (isset($status) &amp;&amp; $status['http_code'] != 200))\n    {\n        \/\/ the first service has failed over\n        \/\/ create a new request to the backURL\n        $curl2 = curl_init();\n        curl_setopt_array($curl2, array(CURLOPT_RETURNTRANSFER => 1, CURLOPT_URL => $backupURL, CURLOPT_USERAGENT => 'Service Objects Email Validation 3'));\n        \/\/Https peer certification validation turned off\n        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);\n        curl_setopt($curl2, CURLOPT_CONNECTTIMEOUT_MS, $TIMEOUT); \/\/timeout in milliseconds\n        \/\/ Send the request &amp; save response to $resp\n        $resp = curl_exec($curl2);\n        $decoded = json_decode($resp, TRUE);\n        if($resp == false)\n        {\n            echo \"&lt;b> Both rest calls failed &lt;\/b>\";\n            curl_close($curl2);\n            return;\n        }\n    }<\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>GeoCoder RoR Rest Code Snippets<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"ruby\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">@request = Request.find(params[:id])\n#This sets the default timeout for HTTParty get operation. This must be set in order to use the gem\ndefault_timeout = 10\naddress = @request.address\ncity = @request.city\nstate = @request.state\npostalcode = @request.postalcode\nlicensekey = @request.licensekey\n#Set Primary and Backup URLs as needed. This method encodes and standardizes the URI to pass to the REST service.\nprimaryURL = URI.encode(\"https:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\/GetBestMatch_V3?Address=\" + address + \"&amp;City=\" + city + \"&amp;State=\" + state + \"&amp;PostalCode=\" + postalcode + \"&amp;LicenseKey=\" + licensekey)\nbackupURL = URI.encode(\"https:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\/GetBestMatch_V3?Address=\" + address + \"&amp;City=\" + city + \"&amp;State=\" + state + \"&amp;PostalCode=\" + postalcode + \"&amp;LicenseKey=\" + licensekey)\n \n#These are set to access the hash that is returned\n@agresult =\"Location_V3\"\n@agerror = \"Error\"\n  #Begins the call the RESTful web service\nbegin\n  response = HTTParty.get(primaryURL, timeout: default_timeout)\n  #processes the response to display to the screen\n   \n  #Passes the response returned from HTTParty and processes them depending on the results\n  processresults(response)\n   \n rescue StandardError => e\n      begin\n      #uses the backupURl in the event that the service encountered an error\n      response = HTTParty.get(backupURL, timeout: default_timeout)\n     \n    #processes the response returned from using the backupURL\n      processresults(response)\n    #If the backup url railed this will raise an error and display the\n    #error message returned from the HTTParty gem.\n      rescue StandardError => error\n          @status = error.message\n          @displaydata = {\"Error\" => \"A Big Error Occured\"}\n      end\nend<\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>Address Geocode US Python Code Snippet<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"python\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\"> primaryURL = 'https:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\/GetBestMatch_V3?'\n backupURL = 'https:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\/GetBestMatch_V3?'\n #The Requests package allows the user to format the path parameters like so instead of having to manually insert them into the URL\n inputs = {'Address': mAddress, 'City': mCity, 'State': mState, 'PostalCode': mPostalCode, 'LicenseKey': mLicenseKey}\n try:\n     result = requests.get(primaryURL, params=inputs)\n     #Parses the XML response from the service into a python dictionary type\n     outputs = xmltodict.parse(result.content)\n     #checks the output for Errors and displays the info accordingly\n     if 'Error' in outputs['Location_V3']:\n         #loops through the response from the service and prints the values to the screen.\n         for key, value in outputs['Location_V3']['Error'].iteritems():\n             Label(swin.window, text=str(key) + \" : \" + str(value)).pack()\n     else:\n         #Removes unnecessary entries that were parsed into the python dictionary from XML response of service\n         outputs['Location_V3'].pop(\"@xmlns:xsi\", None)\n         outputs['Location_V3'].pop(\"@xmlns:xsd\", None)\n         outputs['Location_V3'].pop(\"@xmlns\", None)\n         for key, value in outputs['Location_V3'].iteritems():\n             Label(swin.window, text=str(key) + \" : \" + str(value)).pack()\n #Attempts to use the backupURL if the call to the primary URL failed\n except:\n     try:\n         result = requests.get(backupURL, params=inputs)\n         #Parses the XML response from the service into a python dictionary type\n         outputs = xmltodict.parse(result.content)\n         #checks the output for Errors and displays the info accordingly\n         if 'Error' in outputs['Location_V3']:\n             #loops through the response from the service and prints the values to the screen.\n             for key, value in outputs['Location_V3']['Error'].iteritems():\n                 Label(swin.window, text=str(key) + \" : \" + str(value)).pack()\n         else:\n             #Removes unnecessary entries that were parsed into the python dictionary from XML response of service\n             outputs['Location_V3'].pop(\"@xmlns:xsi\", None)\n             outputs['Location_V3'].pop(\"@xmlns:xsd\", None)\n             outputs['Location_V3'].pop(\"@xmlns\", None)\n             for key, value in outputs['Location_V3'].iteritems():\n                 Label(swin.window, text=str(key) + \" : \" + str(value)).pack()<\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>Address GeoCoder ColdFusion Code Snippet<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">&lt;!--Makes Request to web service --->\n&lt;cfIf isDefined(\"form.Action\") AND Action neq \"\" >\n    &lt;cftry>\n        &lt;cfset primaryURL = \"https:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\/GetBestMatch_V3?Address=#Address#&amp;City=#City#&amp;State=#State#&amp;PostalCode=#PostalCode#&amp;LicenseKey=#LicenseKey#\">\n        &lt;cfhttp url=\"#primaryURL#\"\n        method=\"get\"\n        result=\"response\">\n        &lt;cfset outputs = XmlParse(response.FileContent)>\n        &lt;cfcatch>\n            &lt;cftry>\n                &lt;cfset backupURL = \"https:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\/GetBestMatch_V3?Address=#Address#&amp;City=#City#&amp;State=#State#&amp;PostalCode=#PostalCode#&amp;LicenseKey=#LicenseKey#\">\n                &lt;cfhttp url=\"#backupURL#\"\n                method=\"get\"\n                result=\"response\">\n                &lt;cfset outputs = XmlParse(response.FileContent)>             \n                &lt;cfcatch >\n                    &lt;cfoutput >\n                        The Following Error Occured: #response.StatusCode#\n                    &lt;\/cfoutput>\n                &lt;\/cfcatch>\n            &lt;\/cftry>\n        &lt;\/cfcatch>\n    &lt;\/cftry>\n&lt;\/cfif><\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>Address GeoCoder VB Rest Code Snippet<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"visualbasic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">Try\n    'encodes the URLs for the get Call. Set the primary and back urls as necessary\n    Dim primaryurl As String = \"https:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\/GetBestMatch_V3?Address=\" + address + \"&amp;City=\" + city + \"&amp;State=\" + state + \"&amp;PostalCode=\" + postalcode + \"&amp;LicenseKey=\" + licensekey\n    Dim backupurl As String = \"https:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\/GetBestMatch_V3?Address=\" + address + \"&amp;City=\" + city + \"&amp;State=\" + state + \"&amp;PostalCode=\" + postalcode + \"&amp;LicenseKey=\" + licensekey\n    Dim wsresponse As AGUSResponse.Location_V3 = httpGet(primaryurl)\n \n    'checks if a response was returned from the service, uses the backup url if response is null or a fatal error occured.\n    If wsresponse Is Nothing OrElse (wsresponse.[Error] IsNot Nothing AndAlso wsresponse.[Error].Number = \"3\") Then\n        wsresponse = httpGet(backupurl)\n    End If\n    If wsresponse.[Error] IsNot Nothing Then\n        ProcessErrorResponse(wsresponse.[Error])\n    Else\n        ProcessSuccessfulResponse(wsresponse)\n \n    End If\nCatch ex As Exception\n    'Displays the relevant error mesasge if both backup and primary urls failed.\n    StatusLabel.Text = ex.Message\n    StatusLabel.Visible = True\nEnd Try<\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>Address GeoCoder TSQL Rest Code Snippet<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"sql\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">SET @requestBody ='&lt;s:Envelope xmlns:s=\"http:\/\/schemas.xmlsoap.org\/soap\/envelope\/\">'+\n                   '&lt;s:Body xmlns:xsi=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\" xmlns:xsd=\"http:\/\/www.w3.org\/2001\/XMLSchema\">'+\n                   '&lt;GetBestMatch_V3 xmlns=\"https:\/\/www.serviceobjects.com\/\">'+\n                   '&lt;Address>' + @address + '&lt;\/Address>'+\n                   '&lt;City>' + @City + '&lt;\/City>'+\n                   '&lt;State>' + @State + '&lt;\/State>'+\n                   '&lt;PostalCode>' + @postalcode + '&lt;\/PostalCode>'+\n                   '&lt;LicenseKey>' + @key + '&lt;\/LicenseKey>'+\n                   '&lt;\/GetBestMatch_V3>'+\n                   '&lt;\/s:Body>'+\n                   '&lt;\/s:Envelope>'\nSET @requestLength = LEN(@requestBody)\n    --If a production key is purchased, this will execute the failover\nIF @isLiveKey = 1\nBEGIN\n    EXEC sp_OACreate 'MSXML2.ServerXMLHttp', @obj OUT\n    EXEC sp_OAMethod @obj, 'Open', NULL, 'POST', 'https:\/\/sws.serviceobjects.com\/gcr\/GeoCoder.asmx', false\n    EXEC sp_OAMethod @obj, 'setRequestHeader', NULL, 'HOST', 'sws.serviceobjects.com'\n    EXEC sp_OAMethod @obj, 'setRequestHeader', NULL, 'Content-Type', 'text\/xml; charset=UTF-8'\n    EXEC sp_OAMethod @obj, 'setRequestHeader', NULL, 'SOAPAction', '\"https:\/\/www.serviceobjects.com\/GetBestMatch_V3\"'\n    EXEC sp_OAMethod @obj, 'setRequestHeader', NULL, 'Content-Length', @requestLength\n    EXEC sp_OAMethod @obj, 'send', NULL, @requestBody\n    EXEC sp_OAGetProperty @obj, 'Status', @responseCode OUTPUT\n    EXEC sp_OAGetProperty @obj, 'StatusText', @statusText OUTPUT\n    EXEC sp_OAGetProperty @obj, 'responseText', @response OUTPUT\n             \n    --Checks the Response for a fatal error or if null.\n    IF @response IS NULL\n    BEGIN\n        EXEC sp_OACreate 'MSXML2.ServerXMLHttp', @obj OUT\n        EXEC sp_OAMethod @obj, 'Open', NULL, 'POST', 'https:\/\/swsbackup.serviceobjects.com\/gcr\/GeoCoder.asmx', false\n        EXEC sp_OAMethod @obj, 'setRequestHeader', NULL, 'HOST', 'swsbackup.serviceobjects.com'\n        EXEC sp_OAMethod @obj, 'setRequestHeader', NULL, 'Content-Type', 'text\/xml; charset=UTF-8'\n        EXEC sp_OAMethod @obj, 'setRequestHeader', NULL, 'SOAPAction', '\"https:\/\/www.serviceobjects.com\/GetBestMatch_V3\"'\n        EXEC sp_OAMethod @obj, 'setRequestHeader', NULL, 'Content-Length', @requestLength\n        EXEC sp_OAMethod @obj, 'send', NULL, @requestBody\n        EXEC sp_OAGetProperty @obj, 'Status', @responseCode OUTPUT\n        EXEC sp_OAGetProperty @obj, 'StatusText', @statusText OUTPUT\n        EXEC sp_OAGetProperty @obj, 'responseText', @response OUTPUT\n    END\nEND\n<\/pre>\n<\/div>\n<\/div><\/div>\n<\/div>\n<\/div><\/div>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p>You can find and download full sample code to our services in various languages (PHP, JAVA and C#) by clicking&nbsp;<strong><a href=\"https:\/\/www.serviceobjects.com\/developers\/sample-code\/\" rel=\"noreferrer noopener\" target=\"_blank\">here<\/a><\/strong>. Below is a C# version.<\/p>\n\n\n\n<p>If you are looking for a particular integration not listed in our documentation please contact us at&nbsp;<a href=\"mailto:support@serviceobjects.com.\" rel=\"noreferrer noopener\" target=\"_blank\">support@serviceobjects.com<\/a>.<\/p>\n\n\n\n<p><strong>C#<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"csharp\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">using System;\nusing System.Collections.Generic;\nusing System.Linq;\nusing System.Web;\nusing System.Web.UI;\nusing System.Web.UI.WebControls;\nusing System.Configuration;\nusing DOTSAddressGeocodeUS.ServiceReference1;\nusing System.Net;\nusing System.Runtime.Serialization.Json;\nusing System.Data;\nnamespace DOTSAddressGeocodeUS\n{\n    public partial class GCR_rest : System.Web.UI.Page\n    {\n        #region STATICS\n        static string WEB_SERVICE_PRIMARY_URL; \/\/Included in email from Service Objects\n        static string WEB_SERVICE_BACKUP_URL; \/\/Included in email from Service Objects (LIVE customers only)\n        static int WEB_SERVICE_REQUEST_TIMEOUT; \/\/In milliseconds\n        #endregion\n        protected void Page_Load(object sender, EventArgs e)\n        {\n            try\n            {\n                ErrorLabel.Visible = false;\n                ErrorGrid.Visible = false;\n                ResultGrid.Visible = false;\n                WEB_SERVICE_REQUEST_TIMEOUT = Convert.ToInt32(ConfigurationManager.AppSettings[\"WebServiceRequestTimeout\"]);\n                WEB_SERVICE_PRIMARY_URL = ConfigurationManager.AppSettings[\"GCR_PRIMARY.GCR\"];\n                if (string.IsNullOrWhiteSpace(WEB_SERVICE_PRIMARY_URL))\n                    throw new System.Exception(\"Primary URL not set. Check your Web.config file.\");\n                WEB_SERVICE_BACKUP_URL = ConfigurationManager.AppSettings[\"GCR_BACKUP.GCR\"];\n                if (string.IsNullOrWhiteSpace(WEB_SERVICE_BACKUP_URL))\n                    throw new System.Exception(\"Backup URL not set. Check your Web.config file.\");\n            }\n            catch (Exception ex)\n            {\n                ErrorLabel.Visible = true;\n                ErrorLabel.Text = \"Page load Error: \" + ex.Message;\n            }\n        }\n        protected void btn_GO_Click(object sender, EventArgs e)\n        {\n            string address, city, state, postalCode, licenseKey;\n            address    = inputAddress.Text;\n            city       = inputCity.Text;\n            state      = inputState.Text;\n            postalCode = inputPostalCode.Text;\n            licenseKey = inputLicenseKey.Text;\n            try\n            {\n                \/\/NOTE: A missing parameter is not allowed\n                if (String.IsNullOrWhiteSpace(address))\n                    address = \" \";\n                if (String.IsNullOrWhiteSpace(city))\n                    city = \" \";\n                if (String.IsNullOrWhiteSpace(state))\n                    state = \" \";\n                if (String.IsNullOrWhiteSpace(postalCode))\n                    postalCode = \" \";\n                if (String.IsNullOrWhiteSpace(licenseKey))\n                    licenseKey = \"yourDevKey\";\n                BestMatch_V3Response response = MakeRequest(address, city, state, postalCode, licenseKey);\n                ProcessResponse(response);\n            }\n            catch (Exception ex)\n            {\n                ErrorLabel.Text = ex.Message;\n                ErrorLabel.Visible = true;\n            }\n        }\n        \/\/Creates URL and requests response from service\n        private static BestMatch_V3Response MakeRequest(string address, string city, string state, string postalCode, string licenseKey)\n        {\n            \/*\n            * Due to RFC compliance, the use of URL Paths has character limitations. \n            * Certain characters are invalid and cause HTTP Errors; these characters \n            * include #, \/, ?, as well as some high bit characters. \n            *\n            * If you suspect that this may be an issue for you then it is recommended to change your\n            * request from the URL path parameter format to the query string parameter format. \n            * Example: \n            *     FROM {data}\/{data2}\/{key}?format=json \n            *     TO parameter1={data1}&amp;parameter2={data2}&amp;licensekey={key}\n            * Another alternative is to use HTTP Post instead of HTTP Get.\n            *\/\n            BestMatch_V3Response result = null;\n            string mainURL = WEB_SERVICE_PRIMARY_URL + address + \"\/\" + city + \"\/\" + state + \"\/\" + postalCode + \"\/\" + licenseKey + \"?format=json\";\n            string backupURL = WEB_SERVICE_BACKUP_URL + address + \"\/\" + city + \"\/\" + state + \"\/\" + postalCode + \"\/\" + licenseKey + \"?format=json\";\n            try\n            {\n                result = HttpGet(mainURL);\n                \/\/NULL ERROR || FATAL ERROR RETURNED -- TRY BACKUP\n                if (result == null || (result.Error != null &amp;&amp; result.Error.Number == \"3\"))\n                {\n                    return HttpGet(backupURL);\n                }\n                else\n                {\n                    return result;\n                }\n            }\n            catch (Exception e)\n            {   \/\/ERROR IN MAIN URL - USING BACKUP\n                return HttpGet(backupURL);\n            }\n        }\n        \/\/HTTP Get Method and parse into user-defined object\n        private static BestMatch_V3Response HttpGet(string requestUrl)\n        {\n            try\n            {\n                \/\/NOTE: URL encoding occurs automatically when creating the web request\n                HttpWebRequest request = WebRequest.Create(requestUrl) as HttpWebRequest;\n                request.Timeout = WEB_SERVICE_REQUEST_TIMEOUT;\/\/timeout for get operation\n                using (HttpWebResponse response = request.GetResponse() as HttpWebResponse)\n                {\n                    if (response.StatusCode != HttpStatusCode.OK)\n                        throw new Exception(String.Format(\n                        \"Server error (HTTP {0}: {1}).\",\n                        response.StatusCode,\n                        response.StatusDescription));\n                    \/\/parse response\n                    DataContractJsonSerializer jsonSerializer = new DataContractJsonSerializer(typeof(BestMatch_V3Response));\n                    object objResponse = jsonSerializer.ReadObject(response.GetResponseStream());\n                    BestMatch_V3Response jsonResponse = objResponse as BestMatch_V3Response;\n                    return jsonResponse;\n                }\n            }\n            catch (Exception e)\n            {\n                throw e;\n            }\n        }\n        \/\/Process the returned user-defined object\n        private void ProcessResponse(BestMatch_V3Response response)\n        {\n            try\n            {\n                \/\/processing result\n                if (response.Error == null)\n                {\n                    ProcessResult(response);\n                }\n                \/\/processing error\n                else\n                {\n                    ProcessError(response.Error);\n                }\n            }\n            catch (Exception e)\n            {\n                throw e;\n            }\n        }\n        \/\/Process and display the result values\n        private void ProcessResult(BestMatch_V3Response result)\n        {\n            try\n            {\n                DataTable dtProvider = new DataTable();\n                dtProvider.Columns.Add(new DataColumn(\"Output\", typeof(string)));\n                dtProvider.Columns.Add(new DataColumn(\"Values\", typeof(string)));\n                dtProvider.Rows.Add(\"Latitude\", result.BestMatchInfo.Latitude);\n                dtProvider.Rows.Add(\"Longitude\", result.BestMatchInfo.Longitude);\n                dtProvider.Rows.Add(\"Zip\", result.BestMatchInfo.Zip);\n                dtProvider.Rows.Add(\"Tract\", result.BestMatchInfo.Tract);\n                dtProvider.Rows.Add(\"Block\", result.BestMatchInfo.Block);\n                dtProvider.Rows.Add(\"Level\", result.BestMatchInfo.Level);\n                dtProvider.Rows.Add(\"LevelDescription\", result.BestMatchInfo.LevelDescription);\n                dtProvider.Rows.Add(\"StateFIPS\", result.BestMatchInfo.StateFIPS);\n                dtProvider.Rows.Add(\"CountyFIPS\", result.BestMatchInfo.CountyFIPS);\n                dtProvider.Rows.Add(\"Debug\", result.BestMatchInfo.Debug);\n                ResultGrid.Visible = true;\n                ErrorGrid.Visible = false;\n                ResultGrid.DataSource = new DataView(dtProvider);\n                ResultGrid.DataBind();\n            }\n            catch (Exception e)\n            {\n                throw e;\n            }\n        }\n        \/\/Process and display the error values\n        private void ProcessError(Error error)\n        {\n            try\n            {\n                DataTable dtError = new DataTable();\n                \/\/A case statement is used here because it is often useful to do different\n                \/\/things depeneding on which general type of error occurs.\n                \/\/Handle the errors according to your production needs.\n                switch (System.Convert.ToInt32(error.Number))\n                {\n                    case 1:\n                        \/\/Authorization Error\n                        break;\n                    case 2:\n                        \/\/User Input Error\n                        break;\n                    case 4:\n                        \/\/Domain Specific Error\n                        break;\n                    default:\n                        \/\/default (error code 3) Service Objects Fatal Error Error\n                        break;\n                }\n                dtError.Columns.Add(new DataColumn(\"Output\", typeof(string)));\n                dtError.Columns.Add(new DataColumn(\"Values\", typeof(string)));\n                dtError.Rows.Add(\"Desc\", error.Desc);\n                dtError.Rows.Add(\"Number\", error.Number);\n                dtError.Rows.Add(\"Location\", error.Location);\n                ResultGrid.Visible = false;\n                ErrorGrid.Visible = true;\n                ErrorGrid.DataSource = new DataView(dtError);\n                ErrorGrid.DataBind();\n            }\n            catch (Exception e)\n            {\n                throw e;\n            }\n        }\n    }\n}<\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<div class=\"wp-block-create-block-tabs side-tab-layout\"><ul class=\"tab-labels\" role=\"tablist\" aria-label=\"tabbed content\"><li class=\"tab-label active\" role=\"tab\" aria-selected=\"true\" aria-controls=\"GetZipInfo\" tabindex=\"0\">GetZipInfo<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"GetGeoLocation\" tabindex=\"0\">GetGeoLocation<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"GetDistanceToWaterByAddress\" tabindex=\"0\">GetDistanceToWaterByAddress<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"GetLocationByCityState\" tabindex=\"0\">GetLocationByCityState<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"GetDistance\" tabindex=\"0\">GetDistance<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"GetBestMatch_V3\" tabindex=\"0\">GetBestMatch_V3<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"GetGeoLocationByZipPlusTwo\" tabindex=\"0\">GetGeoLocationByZipPlusTwo<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"GetReverseLocation\" tabindex=\"0\">GetReverseLocation<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"GetGeoLocationByZipPlusFour\" tabindex=\"0\">GetGeoLocationByZipPlusFour<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"GetDistanceToWater\" tabindex=\"0\">GetDistanceToWater<\/li><li class=\"tab-label\" role=\"tab\" aria-selected=\"false\" aria-controls=\"GetGeoLocationWorldwide\" tabindex=\"0\">GetGeoLocationWorldwide<\/li><\/ul><div class=\"tab-content\">\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>GetZipInfo Example Request and Response<\/strong><\/p>\n\n\n\n<div style=\"height:21px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">URL Request: \nhttps:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\/GetZipInfo?PostalCode=93117&amp;LicenseKey=yourDevKey<\/pre>\n\n\n\n<p><strong>XML Response<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">&lt;ZipInfoResponse xmlns=\"https:\/\/serviceobjects.com\" xmlns:i=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\">\n &lt;ZipInfo>\n    &lt;City>GOLETA&lt;\/City>\n    &lt;State>CA&lt;\/State>\n    &lt;County>SANTA BARBARA&lt;\/County>\n    &lt;AreaCode>805&lt;\/AreaCode>\n    &lt;CityAbbreviation>GAVIOTA&lt;\/CityAbbreviation>\n    &lt;CityType>N&lt;\/CityType>\n    &lt;CountyFIPS>083&lt;\/CountyFIPS>\n    &lt;StateFIPS>06&lt;\/StateFIPS>\n    &lt;TimeZone>8&lt;\/TimeZone>\n    &lt;DayLightSavings>Y&lt;\/DayLightSavings>\n    &lt;MSA>7480&lt;\/MSA>\n    &lt;Md\/>\n    &lt;CBSA>42200&lt;\/CBSA>\n    &lt;PMSA\/>\n    &lt;DMA>Santa Barbara - Santa Maria - San Luis Obispo&lt;\/DMA>\n    &lt;Latitude>34.511736&lt;\/Latitude>\n    &lt;Longitude>-120.062476&lt;\/Longitude>\n    &lt;Zip>93117&lt;\/Zip>\n    &lt;CityAlternativeName xmlns:a=\"http:\/\/schemas.microsoft.com\/2003\/10\/Serialization\/Arrays\">\n      &lt;a:string>SANTA BARBARA&lt;\/a:string>\n      &lt;a:string>ISLA VISTA&lt;\/a:string>\n      &lt;a:string>GAVIOTA&lt;\/a:string>\n      &lt;a:string>GOLETA&lt;\/a:string>\n \n    &lt;\/CityAlternativeName>\n &lt;\/ZipInfo>\n&lt;\/ZipInfoResponse><\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>GetGeoLocation Example Request and Response<\/strong><\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">&lt;GeoLocationResponse xmlns=\"https:\/\/serviceobjects.com\" xmlns:i=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\">\n &lt;GeoLocationInfo>\n    &lt;Latitude>34.418014&lt;\/Latitude>\n    &lt;Longitude>-119.696477&lt;\/Longitude>\n    &lt;Zip>93101-7603&lt;\/Zip>\n    &lt;Tract>0009.00&lt;\/Tract>\n    &lt;Block>2039&lt;\/Block>\n    &lt;Level>S&lt;\/Level>\n &lt;\/GeoLocationInfo>\n&lt;\/GeoLocationResponse>\n<\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>GetDistanceToWaterByAddress Example Request and Response<\/strong><\/p>\n\n\n\n<div style=\"height:23px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">URL Request:\nhttps:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\/GetDistanceToWaterByAddress?Address=27+E+Cota&amp;City=Santa+Barbara&amp;State=CA&amp;PostalCode=93101&amp;LicenseKey=yourDevKey<\/pre>\n\n\n\n<p><strong>XML Response<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">&lt;WaterLocationResponse xmlns=\"https:\/\/serviceobjects.com\" xmlns:i=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\">\n &lt;WaterLocationInfo>\n    &lt;MilesToWater>0.605&lt;\/MilesToWater>\n    &lt;Latitude>34.418014&lt;\/Latitude>\n    &lt;Longitude>-119.696477&lt;\/Longitude>\n    &lt;ClosestWaterLatitude>34.413116&lt;\/ClosestWaterLatitude>\n    &lt;ClosestWaterLongitude>-119.687683&lt;\/ClosestWaterLongitude>\n &lt;\/WaterLocationInfo>\n&lt;\/WaterLocationResponse><\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>GetLocationByCityState Example Request and Response<\/strong><\/p>\n\n\n\n<div style=\"height:23px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">URL Request:\nhttps:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\/GetGeoLocationByCityState?City=Santa+Barbara&amp;State=CA&amp;LicenseKey=yourDevKey<\/pre>\n\n\n\n<p><strong>XML Response<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">&lt;GeoLocationResponse xmlns=\"https:\/\/serviceobjects.com\" xmlns:i=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\">\n &lt;GeoLocationInfo>\n    &lt;Latitude>34.4488&lt;\/Latitude>\n    &lt;Longitude>-119.733&lt;\/Longitude>\n &lt;\/GeoLocationInfo>\n&lt;\/GeoLocationResponse>\n<\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>GetDistance Example Request and Response<\/strong><\/p>\n\n\n\n<div style=\"height:23px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">URL Request:\nhttps:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\/GetDistance?FromLatitude=37.668044&amp;FromLongitude=-121.769621&amp;ToLatitude=34.414106&amp;ToLongitude=-119.860635&amp;LicenseKey=yourDevKey<\/pre>\n\n\n\n<p><strong>XML Response<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">&lt;DistanceResponse xmlns=\"https:\/\/serviceobjects.com\" xmlns:i=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\">\n &lt;DistanceInfo>\n    &lt;MilesBetween>249.096&lt;\/MilesBetween>\n    &lt;KilometersBetween>400.881&lt;\/KilometersBetween>\n    &lt;FeetBetween>1315227&lt;\/FeetBetween>\n &lt;\/DistanceInfo>\n&lt;\/DistanceResponse><\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>GetBestMatch_V3 Example Request and Response<\/strong><\/p>\n\n\n\n<div style=\"height:21px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">URL Request:\nhttps:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\/GetBestMatch_V3?Address=27+E+Cota&amp;City=Santa+Barbara&amp;State=CA&amp;PostalCode=93101&amp;LicenseKey=yourDevKey<\/pre>\n\n\n\n<p><strong>XML Response<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">&lt;BestMatch_V3Response xmlns=\"https:\/\/serviceobjects.com\" xmlns:i=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\">\n &lt;BestMatchInfo>\n    &lt;Latitude>34.418014&lt;\/Latitude>\n    &lt;Longitude>-119.696477&lt;\/Longitude>\n    &lt;Zip>93101-7603&lt;\/Zip>\n    &lt;Tract>0009.00&lt;\/Tract>\n    &lt;Block>2039&lt;\/Block>\n    &lt;Level>S&lt;\/Level>\n    &lt;LevelDescription>\n        The address matched exactly at the property location.\n    &lt;\/LevelDescription>\n    &lt;StateFIPS>06&lt;\/StateFIPS>\n    &lt;CountyFIPS>083&lt;\/CountyFIPS>\n    &lt;Debug\/>\n &lt;\/BestMatchInfo>\n&lt;\/BestMatch_V3Response><\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>GetGeoLocationByZipPlusTwo Example Request and Response<\/strong><\/p>\n\n\n\n<div style=\"height:25px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">URL Request:\nhttps:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\/GetGeoLocationByZipPlusTwo?PostalCode=9311723&amp;LicenseKey=yourDevKey<\/pre>\n\n\n\n<p><strong>XML Response<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">&lt;GeoLocationResponse xmlns=\"https:\/\/serviceobjects.com\" xmlns:i=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\">\n &lt;GeoLocationInfo>\n    &lt;Latitude>34.442159&lt;\/Latitude>\n    &lt;Longitude>-119.823612&lt;\/Longitude>\n &lt;\/GeoLocationInfo>\n&lt;\/GeoLocationResponse>\n<\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>GetReverseLocation Example Request and Response<\/strong><\/p>\n\n\n\n<div style=\"height:22px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">URL Request:\nhttps:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\/GetReverseLocation?Latitude=34.421556&amp;Longitude=-119.697222&amp;LicenseKey=yourDevKey<\/pre>\n\n\n\n<p><strong>XML Response<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">&lt;ReverseLocationResponse xmlns=\"https:\/\/serviceobjects.com\" xmlns:i=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\">\n &lt;ReverseLocationInfo>\n    &lt;Address>118 E DE LA GUERRA ST&lt;\/Address>\n    &lt;City>SANTA BARBARA&lt;\/City>\n    &lt;State>CA&lt;\/State>\n    &lt;Zip>93101&lt;\/Zip>\n    &lt;County>SANTA BARBARA&lt;\/County>\n &lt;\/ReverseLocationInfo>\n&lt;\/ReverseLocationResponse>\n<\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>GetGeoLocationByZipPlusFour Example Request and Response<\/strong><\/p>\n\n\n\n<div style=\"height:22px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">URL Request:\nhttps:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\/GetGeoLocationByZipPlusFour?PostalCode=931172323&amp;LicenseKey=yourDevKey<\/pre>\n\n\n\n<p><strong>XML Response<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">&lt;GeoLocationResponse xmlns=\"https:\/\/serviceobjects.com\" xmlns:i=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\">\n &lt;GeoLocationInfo>\n    &lt;Latitude>34.442415&lt;\/Latitude>\n    &lt;Longitude>-119.821683&lt;\/Longitude>\n &lt;\/GeoLocationInfo>\n&lt;\/GeoLocationResponse>\n<\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>GetDistanceToWater Example Request and Response<\/strong><\/p>\n\n\n\n<div style=\"height:22px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">URL Request:\nhttps:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\/GetDistanceToWater?Latitude=34.421556&amp;Longitude=-119.697222&amp;LicenseKey=yourDevKey<\/pre>\n\n\n\n<p><strong>XML Response<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">&lt;WaterLocationResponse xmlns=\"https:\/\/serviceobjects.com\" xmlns:i=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\">\n &lt;WaterLocationInfo>\n    &lt;MilesToWater>0.787&lt;\/MilesToWater>\n    &lt;Latitude>34.421556&lt;\/Latitude>\n    &lt;Longitude>-119.697222&lt;\/Longitude>\n    &lt;ClosestWaterLatitude>34.413002&lt;\/ClosestWaterLatitude>\n    &lt;ClosestWaterLongitude>-119.688103&lt;\/ClosestWaterLongitude>\n &lt;\/WaterLocationInfo>\n&lt;\/WaterLocationResponse>\n<\/pre>\n<\/div>\n\n\n\n<div class=\"wp-block-create-block-tab tab-panel\" role=\"tabpanel\" tabindex=\"0\">\n<p><strong>GetGeoLocationWorldwide Example Request and Response<\/strong><\/p>\n\n\n\n<div style=\"height:23px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">URL Request:\nhttps:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\/GetGeoLocationWorldwide?City=Santa+Barbara&amp;Region=&amp;Country=USA&amp;LicenseKey=yourDevKey<\/pre>\n\n\n\n<p><strong>XML Response<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">&lt;ArrayOfGeoLocationWorldwideResponse xmlns=\"https:\/\/serviceobjects.com\" xmlns:i=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\">\n &lt;GeoLocationWorldwideResponse>\n    &lt;GeoLocationWorldwideInfo>\n     &lt;City>Santa Barbara&lt;\/City>\n     &lt;Region>California&lt;\/Region>\n     &lt;Country>United States&lt;\/Country>\n     &lt;Latitude>34.4119&lt;\/Latitude>\n     &lt;Longitude>-119.7280&lt;\/Longitude>\n    &lt;\/GeoLocationWorldwideInfo>\n &lt;\/GeoLocationWorldwideResponse>\n&lt;\/ArrayOfGeoLocationWorldwideResponse>\n<\/pre>\n<\/div>\n<\/div><\/div>\n<\/div>\n<\/div><\/div>\n\n\n\n<div style=\"height:44px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h1 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-ListofOperations\"><strong>List of Operations<\/strong><\/h1>\n\n\n\n<p><strong><mark style=\"color:#3366ff\" class=\"has-inline-color\">GetBestMatch_V3&nbsp;\u2013<\/mark>&nbsp;<\/strong>Returns latitude, longitude, tract, block, state FIPS, county FIPS, and ZIP+4 if available. Will attempt to geocode at the property level, zip+4 level, zip+3, zip+2, zip+1, zip, and city\/state. (<strong><mark style=\"color:#3366ff\" class=\"has-inline-color\">Recommended operation<\/mark><\/strong>)<br><strong>GetbestMatch_V4&nbsp;\u2013<\/strong>&nbsp;Returns the latitude and longitude for a given US Address, along with additional location information.&nbsp;<strong>NOTICE:<\/strong>&nbsp;This operation is currently restricted to trial (beta) use only.<br><strong>GetGeoLocationByZipPlusFour \u2013&nbsp;<\/strong>Returns latitude\/longitude location information for a given zip plus four (99999-9999)<br><strong>GetGeoLocationByZipPlusTwo \u2013&nbsp;<\/strong>Returns latitude\/longitude location information for a given zip plus two (99999-99)<br><strong>GetGeoLocationByCityState \u2013&nbsp;<\/strong>Returns latitude\/longitude location information for a given city and state. Returns data as close to the city centroid as possible.<br><strong>GetZipInfo \u2013&nbsp;<\/strong>Returns extensive and various information about a given zip code, including census information and centroid latitude\/longitude coordinates.&nbsp;<br><strong>GetDistance \u2013&nbsp;<\/strong>Returns an estimated distance between two given locations.<br><strong>GetDistanceToWater<\/strong>&nbsp;\u2013&nbsp;Returns an estimated distance from a given latitude and longitude to the nearest saltwater.<br><strong>GetDistanceToWaterByaddress \u2013&nbsp;<\/strong>Returns an estimated distance from a given address to the nearest saltwater.<br><strong>GetGeolocationWorldwide \u2013&nbsp;<\/strong>Returns Lat Lon information for a given worldwide city. Multiple matches can be filtered by country or region(state, province etc.)<br><strong>GetReverseLocation \u2013&nbsp;<\/strong>Returns an estimated address for a given latitude and longitude.&nbsp;<br><mark style=\"color:#ff0000\" class=\"has-inline-color\"><strong>GetGeoLocation \u2013&nbsp;<\/strong>(<strong>Deprecated: use GetBestMatch_V3<\/strong>)<br><strong>GetBestMatch \u2013&nbsp;<\/strong>(<strong>Deprecated: use GetBestMatch_V3<\/strong>)<br><strong>GetBestMatch_V2 \u2013&nbsp;<\/strong>(<strong>Deprecated: use GetBestMatch_V3)<\/strong><\/mark><\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-OperationDefinitions\"><strong>Operation Definitions<\/strong><\/h2>\n\n\n\n<p>This document defines the input, output and behavior of the web service operations in DOTS Address Geocode \u2013 US. Each operation has its own unique behavior and output, though some of the operations are very similar.<\/p>\n\n\n\n<div class=\"wp-block-group is-style-card-note is-layout-constrained wp-block-group-is-layout-constrained\">\n<p><strong>Important Note!<\/strong><br>Every geocoding system is different, and some even use different standards for gathering and calculating coordinates. Because of this, using coordinates from one system may not look to be at the exact location on a different system. For example, Google Maps is a great tool for plotting geocoding coordinates on a viewable map. However, the data used for generating these maps is different than the data that Service Objects uses for generating geocoding coordinates. Thus, some points plotted on Google Maps may not look to be in the precise location; they may look exactly right or look to be several hundred feet away.<\/p>\n<\/div>\n\n\n\n<p>You should examine your own business needs first before exploring what DOTS Address Geocode \u2013 US can provide. Different operations may be necessary based on the information you have, and the granularity of data you need.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-GetBestMatch_V3\"><mark style=\"background-color:rgba(0, 0, 0, 0);color:#337eff\" class=\"has-inline-color\">GetBestMatch_V3<\/mark><\/h2>\n\n\n\n<p>This operation is identical to GetBestMatch_V2, but additionally returns state and county FIPS codes.<\/p>\n\n\n\n<div style=\"height:18px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-GetBestMatch_V3triestofindamatchatthemostgranularlevelthatitcan:\">GetBestMatch_V3 tries to find a match at the most granular level that it can:<\/h4>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Property Match on the street level<\/li>\n\n\n\n<li>Zip + 4 Match<\/li>\n\n\n\n<li>Zip + 3 Match<\/li>\n\n\n\n<li>Zip + 2 Match<\/li>\n\n\n\n<li>Zip + 1 Match<\/li>\n\n\n\n<li>Zip Match<\/li>\n\n\n\n<li>City\/State Match (least accurate)<\/li>\n<\/ol>\n\n\n\n<div style=\"height:19px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\">This operation will also return a code indicating the level at which it matched. The codes are:<\/h4>\n\n\n\n<p>S \u2013 Street Level Property Match<br>P \u2013 Zip plus four match<br>R \u2013 Zip plus three match<br>T \u2013 Zip plus two match<br>N \u2013 Zip plus one match<br>Z \u2013 Zip level match (zip plus zero)<br>C \u2013 City\/state match<\/p>\n\n\n\n<div style=\"height:24px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetBestMatch_V3 Inputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table is-style-regular\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Address<\/td><td>String<\/td><td>Address line of the address to geocode.<br>For example, &#8220;123 Main Street&#8221;.<\/td><\/tr><tr><td>City<\/td><td>String<\/td><td>The city of the address to geocode.<br>For example, &#8220;New York&#8221;. The city isn&#8217;t<br>required, but if one is not provided, the Zip<br>code is required.<\/td><\/tr><tr><td>State<\/td><td>String<\/td><td>The state of the address to geocode. For<br>example, &#8220;NY&#8221;. This does not need to be<br>contracted, full state names will work as<br>well.The state isn&#8217;t required, but if one is<br>not provided, the Zip code is required.<\/td><\/tr><tr><td>PostalCode<\/td><td>String<\/td><td>The zip code of the address to geocode. A<br>zip code isn&#8217;t required, but if one is not<br>provided, the City and State are required.<\/td><\/tr><tr><td>LicenseKey<\/td><td>String<\/td><td>Your license key to use the service.<br>Sign up for a free trial key at<br><a data-type=\"URL\" data-id=\"https:\/\/www.serviceobjects.com\/developers\/sample-code\/?service=34\" href=\"https:\/\/www.serviceobjects.com\/developers\/sample-code\/?service=34\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/www.serviceobjects.com<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div style=\"height:21px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetBestMatch_V3 Outputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table is-style-regular\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Values<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Latitude<\/td><td>String<\/td><td>Number<\/td><td>The latitude of the given<br>address.<\/td><\/tr><tr><td>Longitude<\/td><td>String<\/td><td>Number<\/td><td>The longitude of the given<br>address.<\/td><\/tr><tr><td>Tract<\/td><td>String<\/td><td>Number<\/td><td>The census tract of the given address.<br>A census tract is a statistical subdivision of a county.<\/td><\/tr><tr><td>Block<\/td><td>String<\/td><td>Number<\/td><td>The census block of the given address.<br>A block is the smallest geographic unit used by the US Census.<\/td><\/tr><tr><td>Zip<\/td><td>String<\/td><td>Varies<\/td><td>The corrected zip plus four of<br>the given address.<\/td><\/tr><tr><td>Level<\/td><td>String<\/td><td>Varies, see<br>above<\/td><td>The level code at which the<br>address matched. See above for a listing of possible outputs.<\/td><\/tr><tr><td>LevelDescription<\/td><td>String<\/td><td>Varies<\/td><td>An explicit description of the<br>level code, described above.<\/td><\/tr><tr><td>StateFIPS<\/td><td>String<\/td><td>Two digits<\/td><td>State FIPS(Federal Information Processing Standard) code; used to<br>uniquely identity states&nbsp;.<\/td><\/tr><tr><td>CountyFIPS<\/td><td>String<\/td><td>Three digits<\/td><td>County FIPS(Federal Information Processing Standard)&nbsp;code; used to<br>uniquely&nbsp;identify counties across the US.<\/td><\/tr><tr><td>Error \u2013 Desc<\/td><td>String<\/td><td>Varies<\/td><td>If there was an internal web<br>service error, the description will<br>be displayed here.<\/td><\/tr><tr><td>Error \u2013 Number<\/td><td>String<\/td><td>&#8220;1&#8221;, &#8220;2&#8221;, &#8220;4&#8221;<\/td><td>See &#8220;Error Codes&#8221; below.<\/td><\/tr><tr><td>Error \u2013 Location<\/td><td>String<\/td><td>Always null<\/td><td>Deprecated, no longer used.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-GetBestMatch_V4\">GetBestMatch_V4<\/h2>\n\n\n\n<p>Returns the latitude and longitude for a given US address. This operation will use cascading logic when an exact address match is not found and it will return the next closest level match available. The operation output is designed to allow the service to return new pieces of data as they become available without having to re-integrate.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td><img decoding=\"async\" width=\"32\" height=\"32\" class=\"wp-image-9165\" style=\"width: 21px\" src=\"https:\/\/test.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/12\/warning.png\" alt=\"\"><\/td><td><strong><mark style=\"color:#ff0000\" class=\"has-inline-color\">This operation is currently restricted to Trial (beta) use only.<\/mark><\/strong><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">HTTP GET Request URL Formats<\/h4>\n\n\n\n<p><strong>XML:\u00a0\u00a0 \u00a0<\/strong><a href=\"https:\/\/trial.serviceobjects.com\/GCR\/api.svc\/xml\/GetBestMatch_V4?Address={ADDRESS}&amp;City={CITY}&amp;State={STATE}&amp;PostalCode={POSTALCODE}&amp;LicenseKey={LICENSEKEY}\">https:\/\/trial.serviceobjects.com\/GCR\/api.svc\/xml\/GetBestMatch_V4?Address={ADDRESS}&amp;City={CITY}&amp;State={STATE}&amp;PostalCode={POSTALCODE}&amp;LicenseKey={LICENSEKEY}<\/a><\/p>\n\n\n\n<p><strong>JSON:\u00a0<\/strong>\u00a0<a href=\"https:\/\/trial.serviceobjects.com\/GCR\/api.svc\/json\/GetBestMatch_V4?Address={ADDRESS}&amp;City={CITY}&amp;State={STATE}&amp;PostalCode={POSTALCODE}&amp;LicenseKey={LICENSEKEY}\">https:\/\/trial.serviceobjects.com\/GCR\/api.svc\/json\/GetBestMatch_V4?Address={ADDRESS}&amp;City={CITY}&amp;State={STATE}&amp;PostalCode={POSTALCODE}&amp;LicenseKey={LICENSEKEY}<\/a><\/p>\n\n\n\n<div style=\"height:17px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-HTTPPOSTRequestHelpPage\">HTTP POST Request Help Page<\/h4>\n\n\n\n<p><strong>XML:\u00a0<\/strong>\u00a0 \u00a0<a href=\"https:\/\/trial.serviceobjects.com\/gcr\/api.svc\/xml\/help\/operations\/GetBestMatch_V4_POST\">https:\/\/trial.serviceobjects.com\/gcr\/api.svc\/xml\/help\/operations\/GetBestMatch_V4_POST<\/a><\/p>\n\n\n\n<p><strong>JSON:<\/strong>\u00a0\u00a0<a href=\"https:\/\/trial.serviceobjects.com\/gcr\/api.svc\/json\/help\/operations\/GetBestMatch_V4_POST\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/trial.serviceobjects.com\/gcr\/api.svc\/json\/help\/operations\/GetBestMatch_V4_POST<\/a><\/p>\n\n\n\n<div style=\"height:17px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-SOAPURL\">SOAP URL<\/h4>\n\n\n\n<p><strong>WSDL:<\/strong>\u00a0\u00a0<a href=\"https:\/\/trial.serviceobjects.com\/gcr\/soap.svc?wsdl\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/trial.serviceobjects.com\/gcr\/soap.svc?wsdl<\/a><\/p>\n\n\n\n<div style=\"height:17px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-ServiceXMLRequestHelpPage\">Service XML Request Help Page<\/h4>\n\n\n\n<p><a href=\"https:\/\/trial.serviceobjects.com\/gcr\/api.svc\/xml\/help\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/trial.serviceobjects.com\/gcr\/api.svc\/xml\/help<\/a><\/p>\n\n\n\n<div style=\"height:17px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-ServiceJSONRequestHelpPage\">Service JSON Request Help Page<\/h4>\n\n\n\n<p><a href=\"https:\/\/trial.serviceobjects.com\/gcr\/api.svc\/json\/help\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/trial.serviceobjects.com\/gcr\/api.svc\/json\/help<\/a><\/p>\n\n\n\n<div style=\"height:22px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-GetBestMatch_V4triestofindamatchatthemostgranularlevelthatitcan:\">GetBestMatch_V4 tries to find a match at the most granular level that it can:<\/h4>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Property Match on the street level<\/li>\n\n\n\n<li>Zip + 4 Match<\/li>\n\n\n\n<li>Zip + 3 Match<\/li>\n\n\n\n<li>Zip + 2 Match<\/li>\n\n\n\n<li>Zip + 1 Match<\/li>\n\n\n\n<li>Zip Match<\/li>\n\n\n\n<li>City\/State Match (least accurate)<\/li>\n<\/ol>\n\n\n\n<div style=\"height:26px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\">This operation will also return a code indicating the level at which it matched. The codes are:<\/h4>\n\n\n\n<p>S \u2013 Street Level Property Match<br>P \u2013 Zip plus four match<br>R \u2013 Zip plus three match<br>T \u2013 Zip plus two match<br>N \u2013 Zip plus one match<br>Z \u2013 Zip level match (zip plus zero)<br>C \u2013 City\/state match<\/p>\n\n\n\n<div style=\"height:26px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetBestMatch_V4 Inputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table is-style-regular\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Address<\/td><td>String<\/td><td>Address line of the address to geocode.<br>For example, &#8220;123 Main Street&#8221;.<\/td><\/tr><tr><td>City<\/td><td>String<\/td><td>The city of the address to geocode.<br>For example, &#8220;New York&#8221;. The city isn&#8217;t<br>required, but if one is not provided, the Zip<br>code is required.<\/td><\/tr><tr><td>State<\/td><td>String<\/td><td>The state of the address to geocode. For<br>example, &#8220;NY&#8221;. This does not need to be<br>contracted, full state names will work as<br>well.The state isn&#8217;t required, but if one is<br>not provided, the Zip code is required.<\/td><\/tr><tr><td>PostalCode<\/td><td>String<\/td><td>The zip code of the address to geocode. A<br>zip code isn&#8217;t required, but if one is not<br>provided, the City and State are required.<\/td><\/tr><tr><td>LicenseKey<\/td><td>String<\/td><td>Your license key to use the service.<br>Sign up for a free trial key at<br><a href=\"https:\/\/www.serviceobjects.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/www.serviceobjects.com\/<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetBestMatch_V4 Outputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Values<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Level<\/td><td>String<\/td><td>Varies<\/td><td>The level code at which the<br>address matched. See above for a listing of possible outputs.<\/td><\/tr><tr><td>LevelDescription<\/td><td>String<\/td><td>Varies<\/td><td>An explicit description of the&nbsp;level code, described above.<\/td><\/tr><tr><td>Latitude<\/td><td>String<\/td><td>Decimal Number<\/td><td>The latitude of the given address.<br>A decimal number up to 10 digits with a max precision of up to 7 places after the decimal point.<\/td><\/tr><tr><td>Longitude<\/td><td>String<\/td><td>Decimal Number<\/td><td>The longitude of the given address.<br>A decimal number up to 10 digits with a max precision of up to 7 places after the decimal point.&nbsp;<\/td><\/tr><tr><td>Zip<\/td><td>String<\/td><td>Varies<\/td><td>The corrected zip plus four of the given address.<\/td><\/tr><tr><td>InformationComponents<\/td><td>InformationComponent array or NULL<\/td><td>Varies<\/td><td>A name-value pair collection containing additional information about the location. See the InformationComponent table and the list of Components for more details.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">InformationComponent<\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Values<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Name<\/td><td>String<\/td><td>Varies<\/td><td>The component name of the Name-Value pair. Possible examples are &#8220;CountyFIPS&#8221;, &#8220;CensusTract&#8221; &#8220;CensusGeoID&#8221;<\/td><\/tr><tr><td>Value<\/td><td>String<\/td><td>Varies<\/td><td>The component value of the Name-Value pair.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>Current List of Components<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Values<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>StateFIPS<\/td><td>String<\/td><td>2 Digit Number<\/td><td>State FIPS(Federal Information Processing Standard) code; used to<br>uniquely identity states&nbsp;.<\/td><\/tr><tr><td>CountyFIPS<\/td><td>String<\/td><td>3 Digit Number<\/td><td>County FIPS(Federal Information Processing Standard)&nbsp;code; used to<br>uniquely&nbsp;identify counties across the US.<\/td><\/tr><tr><td>CensusTract<\/td><td>String<\/td><td>6 Digit<br>Decimal Number<\/td><td>The census tract of the given address.<br>A census tract is a statistical subdivision of a county.<\/td><\/tr><tr><td>CensusBlock<\/td><td>String<\/td><td>4 Digit Number<\/td><td>The census block of the given address.<br>A block is the smallest geographic unit used by the US Census.<\/td><\/tr><tr><td>CensusGeoID<\/td><td>String<\/td><td>15 Digit Number<\/td><td>A Census based geographic identification code that uniquely identifies a geographic statistical area.<\/td><\/tr><tr><td>ClassFP<\/td><td>String<\/td><td>Alpha-Numeric<\/td><td>A code that defines the current class of the geographic location.<\/td><\/tr><tr><td>SLDUST<\/td><td>String<\/td><td>Varies<\/td><td>Current state legislative district upper (senate) chamber code.<\/td><\/tr><tr><td>SLDLST<\/td><td>String<\/td><td>Varies<\/td><td>Current state legislative district lower (house) chamber code<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">Current List of ClassFP Codes<\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>ClassFP Code<\/th><th>Class Code Description<\/th><th>Associated Geographic Entity<\/th><\/tr><\/thead><tbody><tr><td>C1<\/td><td>An active incorporated place that does not serve as a county subdivision equivalent<\/td><td>Economic Census Place, Incorporated Place<\/td><\/tr><tr><td>C2<\/td><td>An active incorporated place that is legally coextensive with a county subdivision but treated as independent of any county subdivision<\/td><td>County Subdivision, Economic Census Place, Incorporated Place<\/td><\/tr><tr><td>C3<\/td><td>Consolidated City<\/td><td>Consolidated City<\/td><\/tr><tr><td>C4<\/td><td>Alternate official common name for an incorporated place<\/td><td>Locality Point<\/td><\/tr><tr><td>C5<\/td><td>An active incorporated place that is independent of any county subdivision and serves as a county subdivision equivalent<\/td><td>County Subdivision, Economic Census Place, Incorporated Place<\/td><\/tr><tr><td>C6<\/td><td>An active incorporated place that partially is independent of any county subdivision and serves as a county subdivision equivalent or partially coextensive with a county subdivision but treated as independent of any county subdivision<\/td><td>Incorporated Place<\/td><\/tr><tr><td>C7<\/td><td>An incorporated place that is independent of any county<\/td><td>County or Equivalent Feature, County Subdivision, Economic Census Place, Incorporated Place<\/td><\/tr><tr><td>C8<\/td><td>The balance of a consolidated city excluding the separately incorporated place(s) within that consolidated government<\/td><td>Economic Census Place, Incorporated Place<\/td><\/tr><tr><td>C9<\/td><td>An inactive or nonfunctioning incorporated place<\/td><td>Economic Census Place, Incorporated Place<\/td><\/tr><tr><td>M1<\/td><td>A military or other defense installation that is not entirely within a census designated place<\/td><td>Locality Point, Military Installation<\/td><\/tr><tr><td>M2<\/td><td>A military or other defense installation entirely within a place<\/td><td>Census Designated Place, Economic Census Place, Military Installation<\/td><\/tr><tr><td>U1<\/td><td>A census designated place with an official federally recognized name<\/td><td>Census Designated Place, Economic Census Place<\/td><\/tr><tr><td>U2<\/td><td>A census designated place without an official federally recognized name<\/td><td>Census Designated Place, Economic Census Place<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-GetGeoLocationByZipPlusFour\">GetGeoLocationByZipPlusFour<\/h3>\n\n\n\n<p>This operation is almost exactly like GetGeoLocation, but rather than geocoding given a specific address, DOTS Address Geocode \u2013 US will geocode given a zip plus four. The coordinates given are an average centroid of a given zip plus four region and oftentimes match precisely to the street location.<\/p>\n\n\n\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetGeoLocationByZipPlusFour Inputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Zip<\/td><td>String<\/td><td>The zip plus four to geocode.<\/td><\/tr><tr><td>LicenseKey<\/td><td>String<\/td><td>Your license key to use the service.<br>Sign up for a free trial key at<br><a data-type=\"URL\" data-id=\"https:\/\/www.serviceobjects.com\/\" href=\"https:\/\/www.serviceobjects.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/www.serviceobjects.com\/<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div style=\"height:35px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetGeoLocationByZipPlusFour Outputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Values<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Latitude<\/td><td>String<\/td><td>Number<\/td><td>The latitude of the given zip plus<br>four.<\/td><\/tr><tr><td>Longitude<\/td><td>String<\/td><td>Number<\/td><td>The longitude of the given zip<br>plus four.<\/td><\/tr><tr><td>Error \u2013 Desc<\/td><td>String<\/td><td>Varies<\/td><td>If there was an internal web<br>service error, the description will<br>be displayed here.<\/td><\/tr><tr><td>Error \u2013 Number<\/td><td>String<\/td><td>&#8220;1&#8221;, &#8220;2&#8221;, &#8220;4&#8221;<\/td><td>See &#8220;Error Codes&#8221; below.<\/td><\/tr><tr><td>Error \u2013 Location<\/td><td>String<\/td><td>Always null<\/td><td>Deprecated, no longer used.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-GetGeoLocationByZipPlusTwo\">GetGeoLocationByZipPlusTwo<br><\/h2>\n\n\n\n<p>This operation is almost exactly like GetGeoLocationByZipPlusFour, but instead uses only a Zip plus two. If a zip plus four is provided, this operation will geocode only using the subset zip plus two.<\/p>\n\n\n\n<div style=\"height:31px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetGeoLocationByZipPlusTwo Inputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Zip<\/td><td>String<\/td><td>The zip plus four to geocode.<\/td><\/tr><tr><td>LicenseKey<\/td><td>String<\/td><td>Your license key to use the service.<br>Sign up for a free trial key at<br><a href=\"https:\/\/www.serviceobjects.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/www.serviceobjects.com<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div style=\"height:31px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetGeoLocationByZipPlusTwo Outputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Values<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Latitude<\/td><td>String<\/td><td>Number<\/td><td>The latitude of the given zip plus<br>four.<\/td><\/tr><tr><td>Longitude<\/td><td>String<\/td><td>Number<\/td><td>The longitude of the given zip<br>plus four.<\/td><\/tr><tr><td>Error \u2013 Desc<\/td><td>String<\/td><td>Varies<\/td><td>If there was an internal web<br>service error, the description will<br>be displayed here.<\/td><\/tr><tr><td>Error \u2013 Number<\/td><td>String<\/td><td>&#8220;1&#8221;, &#8220;2&#8221;, &#8220;4&#8221;<\/td><td>See &#8220;Error Codes&#8221; below.<\/td><\/tr><tr><td>Error \u2013 Location<\/td><td>String<\/td><td>Always null<\/td><td>Deprecated, no longer used.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-GetZipInfo\">GetZipInfo<\/h2>\n\n\n\n<p>This operation provides valuable information about a specific zip code. Included are many demographics codes that many users find valuable for tracking customers and statistical analysis.<\/p>\n\n\n\n<div style=\"height:28px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetZipInfo Inputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Zip<\/td><td>String<\/td><td>The zip plus four to geocode.<\/td><\/tr><tr><td>LicenseKey<\/td><td>String<\/td><td>Your license key to use the service.<br>Sign up for a free trial key at<br><a data-type=\"URL\" data-id=\"https:\/\/www.serviceobjects.com\/\" href=\"https:\/\/www.serviceobjects.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/www.serviceobjects.com\/<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetZipInfo Outputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Values<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>City<\/td><td>String<\/td><td>Varies<\/td><td>The city of the given zip<br>code. Alternate city names are<br>given below.<\/td><\/tr><tr><td>State<\/td><td>String<\/td><td>Varies<\/td><td>The state of the given zip code.<\/td><\/tr><tr><td>County<\/td><td>String<\/td><td>Varies<\/td><td>The county of the given zip code.<\/td><\/tr><tr><td>AreaCode<\/td><td>String<\/td><td>Varies<\/td><td>The area code of the given zip code.<\/td><\/tr><tr><td>CityAbbreviation<\/td><td>String<\/td><td>Varies<\/td><td>A common abbreviation of<br>the city name of the given zip code.<\/td><\/tr><tr><td>CityType<\/td><td>String<\/td><td>N, P, U, B,<br>A, C, S, K<\/td><td>The city type of the given zip code.&nbsp;The city<br>type of the given zip code. The code refers<br>to the type of postal station in a given zip<br>code. See table below for descriptions<br>for each of the codes.<\/td><\/tr><tr><td>CountyFIPS<\/td><td>String<\/td><td>Number<\/td><td>County FIPS(Federal<br>Information Processing Standard)<br>code; used to&nbsp;uniquely&nbsp;identify<br>counties across the US.<\/td><\/tr><tr><td>StateFIPS<\/td><td>String<\/td><td>Number<\/td><td>State FIPS(Federal Information<br>Processing Standard) code;<br>used to&nbsp;uniquely identity states&nbsp;.<\/td><\/tr><tr><td>TimeZone<\/td><td>String<\/td><td>Number<\/td><td>The number of hours offset from<br>GMT. 5 = Eastern time zone.<\/td><\/tr><tr><td>DayLightSavings<\/td><td>String<\/td><td>Y or N<\/td><td>Whether the given zip code<br>observes Day Light Savings time.<\/td><\/tr><tr><td>MSA<\/td><td>String<\/td><td>Varies<\/td><td>The Metropolitan Statistical Area Code.<br>Used to uniquely identify a geographic area<br>with a relatively high population density at<br>its core.<\/td><\/tr><tr><td>MD<\/td><td>String<\/td><td>Varies<\/td><td>The Metropolitan District Code.<\/td><\/tr><tr><td>CBSA<\/td><td>String<\/td><td>Varies<\/td><td>The Core Based Statistical Area Code.<br>A code used to identify an urban center<br>of at least 10,000 people and adjacent<br>areas that are socioeconomically tied to<br>the urban center.&nbsp;<\/td><\/tr><tr><td>PMSA<\/td><td>String<\/td><td>Varies<\/td><td>The Primary Metropolitan Statistical Area<br>code. Used to uniquely identify areas<br>that are part of a larger urban center.&nbsp;<\/td><\/tr><tr><td>DMA<\/td><td>String<\/td><td>Varies<\/td><td>The Designated Market Area code. Used<br>to uniquely identify a geographic region<br>that receive the same(or similar) TV and<br>radio show programs.&nbsp;<\/td><\/tr><tr><td>Latitude<\/td><td>String<\/td><td>Number<\/td><td>The latitude centroid of the given<br>zip code.<\/td><\/tr><tr><td>Longitude<\/td><td>String<\/td><td>Number<\/td><td>The longitude centroid of<br>the given zip code.<\/td><\/tr><tr><td>Zip<\/td><td>String<\/td><td>Varies<\/td><td>The zip code input.<\/td><\/tr><tr><td>CityAlternativeName<\/td><td>ArrayOfString<\/td><td>Varies<\/td><td>A list of strings that contain<br>alternate names for the city<br>of the given zip code.<\/td><\/tr><tr><td>Error \u2013 Desc<\/td><td>String<\/td><td>Varies<\/td><td>If there was an internal<br>web service error, the<br>description will be<br>displayed here.<\/td><\/tr><tr><td>Error \u2013 Number<\/td><td>String<\/td><td>&#8220;1&#8221;, &#8220;2&#8221;, &#8220;4&#8221;<\/td><td>See &#8220;Error Codes&#8221; below.<\/td><\/tr><tr><td>Error \u2013 Location<\/td><td>String<\/td><td>Always null<\/td><td>Deprecated, no longer<br>used.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">CityType Code Definitions<\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Code<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>N<\/td><td>Non Postal Community Name: Former Postal Facility&nbsp;<\/td><\/tr><tr><td>P<\/td><td>Post Office: An official post office branch.<\/td><\/tr><tr><td>U<\/td><td>Urbanization: A postal designation specific to Puerto Rico.<\/td><\/tr><tr><td>B<\/td><td>Branch: A postal facility that is not the main post office and is outside the corporate limits of a city.<\/td><\/tr><tr><td>A<\/td><td>Airport Mail Facility: Facilities through which US mail is flown in and out of a city.<\/td><\/tr><tr><td>C<\/td><td>Community Post Office: a contract postal unit providing mail services to small communities.<\/td><\/tr><tr><td>S<\/td><td>Station: A post office that is not the main office for a city but is in corporate city limits.<\/td><\/tr><tr><td>K<\/td><td>Bulk Mail Center: Centers that handle bulk mail. Typically commercial, business and advertising mail.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-GetGeoLocationByCityState\">GetGeoLocationByCityState<br><\/h2>\n\n\n\n<p>This operation is almost exactly like GetGeoLocationByZipPlusFour, but rather than geocoding given a zip plus four, DOTS Address Geocode \u2013 US will geocode given a city and state. The coordinates given are an average centroid of the entire city.<\/p>\n\n\n\n<div style=\"height:23px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetGeoLocationByCityState Inputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>City<\/td><td>String<\/td><td>The city to geocode.<\/td><\/tr><tr><td>State<\/td><td>String<\/td><td>The State to geocode.<\/td><\/tr><tr><td>LicenseKey<\/td><td>String<\/td><td>Your license key to use the service.<br>Sign up for a free trial key at<br><a data-type=\"URL\" data-id=\"https:\/\/www.serviceobjects.com\/\" href=\"https:\/\/www.serviceobjects.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/www.serviceobjects.com<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetGeoLocationByCityState Outputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Values<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Latitude<\/td><td>String<\/td><td>Number<\/td><td>The latitude of the given zip plus<br>four.<\/td><\/tr><tr><td>Longitude<\/td><td>String<\/td><td>Number<\/td><td>The longitude of the given zip<br>plus four.<\/td><\/tr><tr><td>Error \u2013 Desc<\/td><td>String<\/td><td>Varies<\/td><td>If there was an internal web<br>service error, the description will<br>be displayed here.<\/td><\/tr><tr><td>Error \u2013 Number<\/td><td>String<\/td><td>&#8220;1&#8221;, &#8220;2&#8221;, &#8220;4&#8221;<\/td><td>See &#8220;Error Codes&#8221; below.<\/td><\/tr><tr><td>Error \u2013 Location<\/td><td>String<\/td><td>Always null<\/td><td>Deprecated, no longer used.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-GetDistance\">GetDistance<\/h2>\n\n\n\n<p>This operation returns an estimate on the number of miles, kilometers and feet between two sets of coordinates.<\/p>\n\n\n\n<div style=\"height:28px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetDistance Inputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>FromLatitude<\/td><td>String<\/td><td>The latitude for location A.<\/td><\/tr><tr><td>FromLongitude<\/td><td>String<\/td><td>The longitude for location A.<\/td><\/tr><tr><td>ToLatitude<\/td><td>String<\/td><td>The latitude for location B.<\/td><\/tr><tr><td>ToLongitude<\/td><td>String<\/td><td>The longitude for location B.<\/td><\/tr><tr><td>LicenseKey<\/td><td>String<\/td><td>Your license key to use the service.<br>Sign up for a free trial key at<br><a data-type=\"URL\" data-id=\"https:\/\/www.serviceobjects.com\/\" href=\"https:\/\/www.serviceobjects.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/www.serviceobjects.com\/<\/a><br>Accepts 9 digit long decimal degree coordinates with a precision of up to 6 decimal places.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetDistance Outputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Values<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>MilesBetween<\/td><td>String<\/td><td>Decimal Number<\/td><td>An estimate on the number of miles between the two coordinate locations.<\/td><\/tr><tr><td>KilometersBetween<\/td><td>String<\/td><td>Decimal Number<\/td><td>An estimate on the number of kilometers between the two coordinate locations.<\/td><\/tr><tr><td>FeetBetween<\/td><td>String<\/td><td>Number<\/td><td>An estimate on the number of feet between the two coordinate locations.<\/td><\/tr><tr><td>Error \u2013 Desc<\/td><td>String<\/td><td>Varies<\/td><td>If there was an internal web service error, the description will be displayed here.<\/td><\/tr><tr><td>Error \u2013 Number<\/td><td>String<\/td><td>&#8220;1&#8221;, &#8220;2&#8221;, &#8220;4&#8221;<\/td><td>See &#8220;Error Codes&#8221; below.<\/td><\/tr><tr><td>Error \u2013 Location<\/td><td>String<\/td><td>Always null<\/td><td>Deprecated, no longer used.<\/td><\/tr><\/tbody><\/table><figcaption class=\"wp-element-caption\">Miles and kilometers are rounded to the third decimal position.<\/figcaption><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-GetDistanceToWater\">GetDistanceToWater<\/h2>\n\n\n\n<p>Returns an estimated distance from a given latitude and longitude to the nearest saltwater.<\/p>\n\n\n\n<div style=\"height:25px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetDistanceToWater Inputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Latitude<\/td><td>String<\/td><td>The latitude of the location.<\/td><\/tr><tr><td>Longitude<\/td><td>String<\/td><td>The longitude of the location.<\/td><\/tr><tr><td>LicenseKey<\/td><td>String<\/td><td>Your license key to use the service.<br>Sign up for a free trial key at<br><a data-type=\"URL\" data-id=\"https:\/\/www.serviceobjects.com\/\" href=\"https:\/\/www.serviceobjects.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/www.serviceobjects.com\/<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetDistanceToWater Outputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Values<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>MilesToWater<\/td><td>String<\/td><td>Decimal Number<\/td><td>An estimate on the number of miles between the given location and the nearest saltwater.<\/td><\/tr><tr><td>Latitude<\/td><td>String<\/td><td>Decimal Number<\/td><td>The latitude of the location.<\/td><\/tr><tr><td>Longitude<\/td><td>String<\/td><td>Decimal Number<\/td><td>The longitude of the location.<\/td><\/tr><tr><td>ClosestWaterLatitude<\/td><td>String<\/td><td>Decimal Number<\/td><td>The longitude of the closest saltwater location.<\/td><\/tr><tr><td>ClosestWaterLongitude<\/td><td>String<\/td><td>Decimal Number<\/td><td>The longitude of the closest saltwater location.<\/td><\/tr><tr><td>Error \u2013 Desc<\/td><td>String<\/td><td>Varies<\/td><td>If there was an internal web service error, the description will be displayed here.<\/td><\/tr><tr><td>Error \u2013 Number<\/td><td>String<\/td><td>&#8220;1&#8221;, &#8220;2&#8221;, &#8220;4&#8221;<\/td><td>See &#8220;Error Codes&#8221; below.<\/td><\/tr><tr><td>Error \u2013 Location<\/td><td>String<\/td><td>Always null<\/td><td>Deprecated, no longer used.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-GetDistanceToWaterByaddress\">GetDistanceToWaterByaddress<\/h2>\n\n\n\n<p>Returns an estimated distance from a given address to the nearest saltwater.<\/p>\n\n\n\n<div style=\"height:28px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\">GetDistanceToWaterByaddress Input<\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Address<\/td><td>String<\/td><td>The address of the location.<\/td><\/tr><tr><td>City<\/td><td>String<\/td><td>The city of the the location.<\/td><\/tr><tr><td>State<\/td><td>String<\/td><td>The state of the location.<\/td><\/tr><tr><td>PostalCode<\/td><td>String<\/td><td>The postal code of the location.<\/td><\/tr><tr><td>LicenseKey<\/td><td>String<\/td><td>Your license key to use the service.<br>Sign up for a free trial key at<br><a data-type=\"URL\" data-id=\"https:\/\/www.serviceobjects.com\/\" href=\"https:\/\/www.serviceobjects.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/www.serviceobjects.com\/<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">GetDistanceToWaterByaddress Output<\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Values<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>MilesToWater<\/td><td>String<\/td><td>Decimal Number<\/td><td>An estimate on the number of miles between the given location and the nearest saltwater.<\/td><\/tr><tr><td>Latitude<\/td><td>String<\/td><td>Decimal Number<\/td><td>The latitude of the location.<\/td><\/tr><tr><td>Longitude<\/td><td>String<\/td><td>Decimal Number<\/td><td>The longitude of the location.<\/td><\/tr><tr><td>ClosestWaterLatitude<\/td><td>String<\/td><td>Decimal Number<\/td><td>The Latitude of the closest saltwater location.<\/td><\/tr><tr><td>ClosestWaterLongitude<\/td><td>String<\/td><td>Decimal Number<\/td><td>The longitude of the closest saltwater location.<\/td><\/tr><tr><td>Error \u2013 Desc<\/td><td>String<\/td><td>Varies<\/td><td>If there was an internal web service error, the description will be displayed here.<\/td><\/tr><tr><td>Error \u2013 Number<\/td><td>String<\/td><td>&#8220;1&#8221;, &#8220;2&#8221;, &#8220;4&#8221;<\/td><td>See &#8220;Error Codes&#8221; below.<\/td><\/tr><tr><td>Error \u2013 Location<\/td><td>String<\/td><td>Always null<\/td><td>Deprecated, no longer used.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-GetGeoLocationWorldwide\">GetGeoLocationWorldwide<\/h2>\n\n\n\n<p>Returns Lat Lon information for a given worldwide city. Multiple matches can be filtered by country or region(state, province etc.)<\/p>\n\n\n\n<div style=\"height:24px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetGeoLocationWorldwide Inputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>City<\/td><td>String<\/td><td>The city to geocode. This is a required input parameter.<\/td><\/tr><tr><td>Region<\/td><td>String<\/td><td>The region (state, province etc.) of the city to geocode.<\/td><\/tr><tr><td>Country<\/td><td>String<\/td><td>The Country of the city to geocode.<\/td><\/tr><tr><td>LicenseKey<\/td><td>String<\/td><td>Your license key to use the service.<br>Sign up for a free trial key at<br><a href=\"https:\/\/www.serviceobjects.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/www.serviceobjects.com\/<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetGeoLocationWorldwide Outputs<\/strong><\/h4>\n\n\n\n<p>This operation is capable of returning multiple matches. All matches are contained in a GetGeoLocationWorldwideResult object. The GetGeoLocationWorldwideResult object returns a list of GeocodeCityWorldwideInfo objects.<\/p>\n\n\n\n<p><strong>GeocodeCityWorldwideInfo<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-table is-style-regular\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Value<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>City<\/td><td>String<\/td><td>Varies<\/td><td>The name of the city.<\/td><\/tr><tr><td>Region<\/td><td>String<\/td><td>Varies<\/td><td>The region associated with the city.<\/td><\/tr><tr><td>Country<\/td><td>String<\/td><td>Varies<\/td><td>The country associated with the city.<\/td><\/tr><tr><td>Latitude<\/td><td>String<\/td><td>Decimal Number<\/td><td>The latitude centroid of the city.<\/td><\/tr><tr><td>Longitude<\/td><td>String<\/td><td>Decimal Number<\/td><td>The longitude centroid of the city.<\/td><\/tr><tr><td>Error \u2013 Desc<\/td><td>String<\/td><td>Varies<\/td><td>If there was an internal web service error, the description will be displayed here.<\/td><\/tr><tr><td>Error \u2013 Number<\/td><td>String<\/td><td>&#8220;1&#8221;, &#8220;2&#8221;, &#8220;4&#8221;<\/td><td>See &#8220;Error Codes&#8221; below.<\/td><\/tr><tr><td>Error \u2013 Location<\/td><td>String<\/td><td>Always null<\/td><td>Deprecated, no longer used.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-GetReverseLocation\">GetReverseLocation<\/h2>\n\n\n\n<p>Returns an estimated address for a given latitude and longitude.<\/p>\n\n\n\n<div style=\"height:25px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetReverseLocation Inputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Latitude<\/td><td>String<\/td><td>The latitude of the location.<\/td><\/tr><tr><td>Longitude<\/td><td>String<\/td><td>The longitude of the location.<\/td><\/tr><tr><td>LicenseKey<\/td><td>String<\/td><td>Your license key to use the service.<br>Sign up for a free trial key at<br><a href=\"https:\/\/www.serviceobjects.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/www.serviceobjects.com<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetReverseLocation Outputs<\/strong><br><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Values<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Address<\/td><td>String<\/td><td>Varies<\/td><td>The estimated address of the given coordinates.<\/td><\/tr><tr><td>City<\/td><td>String<\/td><td>Varies<\/td><td>The city of the given coordinates.<\/td><\/tr><tr><td>State<\/td><td>String<\/td><td>Varies<\/td><td>The state of the given coordinates.<\/td><\/tr><tr><td>Zip<\/td><td>String<\/td><td>Varies<\/td><td>The zip of the given coordinates.<\/td><\/tr><tr><td>County<\/td><td>String<\/td><td>Varies<\/td><td>The county of the given coordinates.<\/td><\/tr><tr><td>Error \u2013 Desc<\/td><td>String<\/td><td>Varies<\/td><td>If there was an internal web service error, the description will be displayed here.<\/td><\/tr><tr><td>Error \u2013 Number<\/td><td>String<\/td><td>&#8220;1&#8221;, &#8220;2&#8221;, &#8220;4&#8221;<\/td><td>See &#8220;Error Codes&#8221; below.<\/td><\/tr><tr><td>Error \u2013 Location<\/td><td>String<\/td><td>Always null<\/td><td>Deprecated, no longer used.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-GetGeoLocation\"><mark style=\"background-color:rgba(0, 0, 0, 0);color:#ff0000\" class=\"has-inline-color\">GetGeoLocation<\/mark><\/h2>\n\n\n\n<p>This is the basic operation for finding the latitude\/longitude coordinates of an address. This operation takes a standard US address (Address, City, State, Zip) and will try to find the exact street location&#8217;s coordinates. It cannot always find the location, especially when it comes to empty lots or new construction areas.<\/p>\n\n\n\n<p>This operation will also return census tract and block, if available, for the given address. This data is valuable for tracking demographics and statistical analysis. If a valid zip code is found for the given address, it will be returned as well.First, DOTS Address Geocode \u2013 US will attempt to correct and normalize the address to make it more likely to geocode properly. You don&#8217;t need to worry about fixing the address before sending it to DOTS Address Geocode \u2013 US, unless you want to filter out invalid or non-existent addresses beforehand. This operation requires the Address value, and either City and State, or the Zip code. Providing all inputs is recommended.<\/p>\n\n\n\n<p><strong>GetGeoLocation Inputs<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Address<\/td><td>String<\/td><td>Address line of the address to geocode.<br>For example, &#8220;123 Main Street&#8221;.<\/td><\/tr><tr><td>City<\/td><td>String<\/td><td>The city of the address to geocode.<br>For example, &#8220;New York&#8221;. The city isn&#8217;t<br>required, but if one is not provided, the Zip<br>code is required.<\/td><\/tr><tr><td>State<\/td><td>String<\/td><td>The state of the address to geocode. For<br>example, &#8220;NY&#8221;. This does not need to be<br>contracted, full state names will work as<br>well.The state isn&#8217;t required, but if one is<br>not provided, the Zip code is required.<\/td><\/tr><tr><td>Zip<\/td><td>String<\/td><td>The zip code of the address to geocode. A<br>zip code isn&#8217;t required, but if one is not<br>provided, the City and State are required.<\/td><\/tr><tr><td>LicenseKey<\/td><td>String<\/td><td>Your license key to use the service.<br>Sign up for a free trial key at<br><a href=\"https:\/\/www.serviceobjects.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/www.serviceobjects.com<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">GetGeoLocation Outputs<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Values<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Latitude<\/td><td>String<\/td><td>Number<\/td><td>The latitude of the given<br>address.<\/td><\/tr><tr><td>Longitude<\/td><td>String<\/td><td>Number<\/td><td>The longitude of the given<br>address.<\/td><\/tr><tr><td>Tract<\/td><td>String<\/td><td>Number<\/td><td>The census tract of the given address.<br>A census tract is a statistical subdivision<br>of a county.<\/td><\/tr><tr><td>Block<\/td><td>String<\/td><td>Number<\/td><td>&nbsp;The census block of the given address.<br>A block is the smallest geographic unit<br>used by the US Census.<\/td><\/tr><tr><td>Zip<\/td><td>String<\/td><td>Varies<\/td><td>The corrected zip plus four of<br>the given address.<\/td><\/tr><tr><td>Error \u2013 Desc<\/td><td>String<\/td><td>Varies<\/td><td>If there was an internal web<br>service error, the description will<br>be displayed here.<\/td><\/tr><tr><td>Error \u2013 Number<\/td><td>String<\/td><td>&#8220;1&#8221;, &#8220;2&#8221;, &#8220;4&#8221;<\/td><td>See &#8220;Error Codes&#8221; below.<\/td><\/tr><tr><td>Error \u2013 Location<\/td><td>String<\/td><td>Always null<\/td><td>Deprecated, no longer used.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-GetBestMatch\"><mark style=\"background-color:rgba(0, 0, 0, 0);color:#ff0000\" class=\"has-inline-color\">GetBestMatch\u00a0<\/mark><\/h2>\n\n\n\n<p>Often, users want to geocode as best we can \u2013 if we can&#8217;t match an address exactly at the street level, they&#8217;d like it at the zip plus four level, and if not at zip plus four, then at zip plus two, and so on.<\/p>\n\n\n\n<div style=\"height:15px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p><strong>The GetBestMatch operation does exactly that; it tries to find a match at the most granular level that it can:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Street Level Match (most accurate; property-level match)<\/li>\n\n\n\n<li>Zip + 4 Match<\/li>\n\n\n\n<li>Zip + 2 Match<\/li>\n\n\n\n<li>Zip Match<\/li>\n\n\n\n<li>City\/State Match(least accurate)<\/li>\n<\/ol>\n\n\n\n<div style=\"height:15px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p><strong>This operation will also return the level at which it matched. The codes are:<\/strong><\/p>\n\n\n\n<p>S \u2013 Street\/exact match (property-level match)<br>P \u2013 Zip plus four match<br>T \u2013 Zip plus two match<br>Z \u2013 Zip level match (zip plus zero)<br>C \u2013 City\/state match<\/p>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetBestMatch Inputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Address<\/td><td>String<\/td><td>Address line of the address to geocode.<br>For example, &#8220;123 Main Street&#8221;.<\/td><\/tr><tr><td>City<\/td><td>String<\/td><td>The city of the address to geocode.<br>For example, &#8220;New York&#8221;. The city isn&#8217;t<br>required, but if one is not provided, the Zip<br>code is required.<\/td><\/tr><tr><td>State<\/td><td>String<\/td><td>The state of the address to geocode. For<br>example, &#8220;NY&#8221;. This does not need to be<br>contracted, full state names will work as<br>well.The state isn&#8217;t required, but if one is<br>not provided, the Zip code is required.<\/td><\/tr><tr><td>Zip<\/td><td>String<\/td><td>The zip code of the address to geocode. A<br>zip code isn&#8217;t required, but if one is not<br>provided, the City and State are required.<\/td><\/tr><tr><td>LicenseKey<\/td><td>String<\/td><td>Your license key to use the service.<br>Sign up for a free trial key at<br><a href=\"https:\/\/www.serviceobjects.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/www.serviceobjects.com<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetBestMatch Outputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Values<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Latitude<\/td><td>String<\/td><td>Number<\/td><td>The latitude of the given<br>address.<\/td><\/tr><tr><td>Longitude<\/td><td>String<\/td><td>Number<\/td><td>The longitude of the given<br>address.<\/td><\/tr><tr><td>Tract<\/td><td>String<\/td><td>Number<\/td><td>The census tract of the given<br>address.<\/td><\/tr><tr><td>Block<\/td><td>String<\/td><td>Number<\/td><td>The census block of the given<br>address.<\/td><\/tr><tr><td>Zip<\/td><td>String<\/td><td>Varies<\/td><td>The corrected zip plus four of<br>the given address.<\/td><\/tr><tr><td>Level<\/td><td>String<\/td><td>Varies, see<br>above<\/td><td>The level code at which the<br>address matched. See above for a listing of possible outputs.<\/td><\/tr><tr><td>LevelDescription<\/td><td>String<\/td><td>Varies<\/td><td>An explicit description of the<br>level code, described above.<\/td><\/tr><tr><td>Error \u2013 Desc<\/td><td>String<\/td><td>Varies<\/td><td>If there was an internal web<br>service error, the description will<br>be displayed here.<\/td><\/tr><tr><td>Error \u2013 Number<\/td><td>String<\/td><td>&#8220;1&#8221;, &#8220;2&#8221;, &#8220;4&#8221;<\/td><td>See &#8220;Error Codes&#8221; below.<\/td><\/tr><tr><td>Error \u2013 Location<\/td><td>String<\/td><td>Always null<\/td><td>Deprecated, no longer used.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-GetBestMatch_V2\"><mark style=\"background-color:rgba(0, 0, 0, 0);color:#ff0000\" class=\"has-inline-color\">GetBestMatch_V2<\/mark><\/h2>\n\n\n\n<p>This operation is identical to GetBestMatch, but additionally will attempt to match at the Zip + 3 and Zip + 1 levels.<\/p>\n\n\n\n<div style=\"height:18px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p><strong>GetBestMatch_V2 tries to find a match at the most granular level that it can:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Street Level Match (most accurate; property-level match)<\/li>\n\n\n\n<li>Zip + 4 Match<\/li>\n\n\n\n<li>Zip + 3 Match<\/li>\n\n\n\n<li>Zip + 2 Match<\/li>\n\n\n\n<li>Zip + 1 Match<\/li>\n\n\n\n<li>Zip Match<\/li>\n\n\n\n<li>City\/State Match (least accurate)<\/li>\n<\/ol>\n\n\n\n<div style=\"height:18px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p><strong>This operation will also return the level at which it matched. The codes are:<\/strong><\/p>\n\n\n\n<p>S \u2013 Street\/exact match (property-level match)<br>P \u2013 Zip plus four match<br>R \u2013 Zip plus three match<br>T \u2013 Zip plus two match<br>N \u2013 Zip plus one match<br>Z \u2013 Zip level match (zip plus zero)<br>C \u2013 City\/state match<\/p>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetBestMatch_V2 Inputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Address<\/td><td>String<\/td><td>Address line of the address to geocode.<br>For example, &#8220;123 Main Street&#8221;.<\/td><\/tr><tr><td>City<\/td><td>String<\/td><td>The city of the address to geocode.<br>For example, &#8220;New York&#8221;. The city isn&#8217;t<br>required, but if one is not provided, the Zip<br>code is required.<\/td><\/tr><tr><td>State<\/td><td>String<\/td><td>The state of the address to geocode. For<br>example, &#8220;NY&#8221;. This does not need to be<br>contracted, full state names will work as<br>well.The state isn&#8217;t required, but if one is<br>not provided, the Zip code is required.<\/td><\/tr><tr><td>Zip<\/td><td>String<\/td><td>The zip code of the address to geocode. A<br>zip code isn&#8217;t required, but if one is not<br>provided, the City and State are required.<\/td><\/tr><tr><td>LicenseKey<\/td><td>String<\/td><td>Your license key to use the service.<br>Sign up for a free trial key at<br><a href=\"https:\/\/www.serviceobjects.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/www.serviceobjects.com<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>GetBestMatch_V2 Outputs<\/strong><\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Values<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Latitude<\/td><td>String<\/td><td>Number<\/td><td>The latitude of the given<br>address.<\/td><\/tr><tr><td>Longitude<\/td><td>String<\/td><td>Number<\/td><td>The longitude of the given<br>address.<\/td><\/tr><tr><td>Tract<\/td><td>String<\/td><td>Number<\/td><td>The census tract of the given<br>address.<\/td><\/tr><tr><td>Block<\/td><td>String<\/td><td>Number<\/td><td>The census block of the given<br>address.<\/td><\/tr><tr><td>Zip<\/td><td>String<\/td><td>Varies<\/td><td>The corrected zip plus four of<br>the given address.<\/td><\/tr><tr><td>Level<\/td><td>String<\/td><td>Varies, see<br>above<\/td><td>The level code at which the<br>address matched. See above<\/td><\/tr><tr><td><\/td><td><\/td><td><\/td><td>for a listing of possible outputs.<\/td><\/tr><tr><td>LevelDescription<\/td><td>String<\/td><td>Varies<\/td><td>An explicit description of the<br>level code, described above.<\/td><\/tr><tr><td>Error \u2013 Desc<\/td><td>String<\/td><td>Varies<\/td><td>If there was an internal web<br>service error, the description will<br>be displayed here.<\/td><\/tr><tr><td>Error \u2013 Number<\/td><td>String<\/td><td>&#8220;1&#8221;, &#8220;2&#8221;, &#8220;4&#8221;<\/td><td>See &#8220;Error Codes&#8221; below.<\/td><\/tr><tr><td>Error \u2013 Location<\/td><td>String<\/td><td>Always null<\/td><td>Deprecated, no longer used.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-ErrorCodes\"><strong>Error Codes<\/strong><\/h2>\n\n\n\n<p>Error codes in DOTS Address Geocode \u2013 US are the same for all operations. They are as follows:<\/p>\n\n\n\n<p><strong>Error Code 1 \u2013 &#8220;Input cannot be less than zero length&#8221;<\/strong><\/p>\n\n\n\n<p>This error means the web service did not get any input. The connection to the service was made, and data was transferred, but no parameters were passed that the service could understand. This error often happens when input is passed to the service with namespaces that the service does not understand. Applying a namespace to any of the parameters (Email or LicenseKey, in this service) will cause this error. Additionally, requests made in the &#8220;rpc\/encoded&#8221; format will cause this error. The only namespace that should appear in any element is the\u00a0<a href=\"https:\/\/www.serviceobjects.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/www.serviceobjects.com<\/a>\u00a0namespace on the root ValidateEmail element as so:<\/p>\n\n\n\n<figure class=\"wp-block-table is-style-regular\"><table class=\"has-fixed-layout\"><tbody><tr><td>&lt;GetGeoLocation xmlns=&#8221;https: \/\/www. serviceobjects .com\/&#8221;><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div style=\"height:1px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<div class=\"wp-block-group is-style-card-note is-layout-constrained wp-block-group-is-layout-constrained\">\n<p><strong>Important Note!<\/strong><br>The namespace is not applied to the GetGeoLocation element, it is only present.<\/p>\n<\/div>\n\n\n\n<p><strong>Error Code 2 \u2013 &#8220;Various Descriptions&#8221;<\/strong><\/p>\n\n\n\n<p>This error code appears when various errors occur, but are of the expected nature. Oftentimes, maligned or incomplete input will cause an error 2.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>Desc. Code<\/td><td>Description<\/td><\/tr><tr><td>2<\/td><td>Address field was too long, must be 300 characters or less.<\/td><\/tr><tr><td>2<\/td><td>Both a latitude and longitude are required.&nbsp; Please check your input and try again.<\/td><\/tr><tr><td>2<\/td><td>Invalid Postal Code<\/td><\/tr><tr><td>2<\/td><td>Latitude and longitude must be numeric.&nbsp; Please check your input and try again.<\/td><\/tr><tr><td>2<\/td><td>Latitude and longitude values must be numeric.<\/td><\/tr><tr><td>2<\/td><td>Latitude and longitude values are required for both locations.<\/td><\/tr><tr><td>2<\/td><td>Latitude and Longitude were not found for this address.&nbsp; Please check your input and try again.<\/td><\/tr><tr><td>2<\/td><td>Latitude values must be between -90 and 90 degrees.<\/td><\/tr><tr><td>2<\/td><td>Lat\/Long value is not near water.<\/td><\/tr><tr><td>2<\/td><td>Location not found.<\/td><\/tr><tr><td>2<\/td><td>No address found.<\/td><\/tr><tr><td>2<\/td><td>Address was not found.<\/td><\/tr><tr><td>2<\/td><td>Longitude values must be between -180 and 180 degrees.<\/td><\/tr><tr><td>2<\/td><td>Please enter at least the first 2 letters of the city name.<\/td><\/tr><tr><td>2<\/td><td>Please input a city and state.<\/td><\/tr><tr><td>2<\/td><td>Please input a street address.<\/td><\/tr><tr><td>2<\/td><td>Please input a valid US Zip Code.<\/td><\/tr><tr><td>2<\/td><td>Please input either zip code or both city and state.<\/td><\/tr><tr><td>2<\/td><td>Please input zip code plus four.<\/td><\/tr><tr><td>2<\/td><td>Please input zip code plus four.<\/td><\/tr><tr><td>2<\/td><td>Please input zip code plus two.<\/td><\/tr><tr><td>2<\/td><td>Please input zip code plus two.<\/td><\/tr><tr><td>2<\/td><td>Please provide a valid license key for this web service.<\/td><\/tr><tr><td>2<\/td><td>Zip code does not exist.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>Error Code 4 \u2013 &#8220;Various Descriptions&#8221;<\/strong><\/h4>\n\n\n\n<p>An error code 4 is a fatal error and it means something has seriously gone wrong. You will never see an error code 4 in a live production environment.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>Desc. Code<\/td><td>Description<\/td><\/tr><tr><td>4<\/td><td>Address could not be found, search timed out.<\/td><\/tr><tr><td>4<\/td><td>Error initializing service.<\/td><\/tr><tr><td>4<\/td><td>Internal Error.&nbsp; Please contact customer service.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-FrequentlyAskedQuestions\"><strong>Frequently Asked Questions<\/strong><\/h2>\n\n\n\n<div style=\"height:27px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-WhichOperationShouldYouUse?GetGeoLocationorGetBestMatch_V3?\">Which Operation Should You Use? GetGeoLocation or GetBestMatch_V3?<\/h4>\n\n\n\n<p>Picking which operation you want to use should be decided carefully. Depending on your environment and needs, you will need to use different operations for their corresponding strengths.If you always need precise location coordinates, then stick with GetGeoLocation. The other operations won&#8217;t give you the detail you&#8217;re looking for. If your application does not require precise coordinate location, but will work with general-area mapping, GetBestMatch_V3 will give you a much higher match count than GetGeoLocation alone. The best suggestion is to try out each of the operations to find the data you need.<\/p>\n\n\n\n<div style=\"height:17px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-TheSampleCodeisGivingStrangeErrorsorisCrashing!\">The Sample Code is Giving Strange Errors or is Crashing!<\/h4>\n\n\n\n<p>Most likely, the sample code cannot connect to Service Objects. Many environments will not allow you to connect out on port 80, or will clip out XML data from these requests\/responses.<\/p>\n\n\n\n<p>The easiest way to check for this is to open a browser on the machine running the sample code. In your browser, navigate to:<br><a href=\"https:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/trial.serviceobjects.com\/gcr\/GeoCoder.asmx<\/a><\/p>\n\n\n\n<p>Then try to run one of the operations with your trial key. If you get a browser error, or get no data back, then the sample code isn&#8217;t able to connect either.<br>Contact your systems administrator to resolve why you are not able to connect to Service Objects.<\/p>\n\n\n\n<div style=\"height:19px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-DOTSAddressGeocode\u2013USsaysitcan'tfindmyaddress!\">DOTS Address Geocode \u2013 US says it can&#8217;t find my address!<\/h4>\n\n\n\n<p>DOTS Address Geocode \u2013 US doesn&#8217;t know about every address, especially empty lots or new streets. Often, it won&#8217;t be able to find coordinates to these locations. We do our best to try to improve the data as often as possible. However, it will often be able to match a zip plus four or zip plus two. If it cannot match the exact street location, try the GetBestMatch operation to find how close it can find your data.We are constantly striving to improve our data! DOTS Address Geocode \u2013 US may not be able to find your location now, but may in the future as we improve our databases.<\/p>\n\n\n\n<div style=\"height:23px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-DOTSAddressGeocode\u2013USisgivingcoordinatesthataren'tanywherenearmyaddress!\">DOTS Address Geocode \u2013 US is giving coordinates that aren&#8217;t anywhere near my address!<\/h4>\n\n\n\n<p>If you are using the GetBestMatch operation, most likely the service is matching at Zip+4, Zip+2, or Zip level, which return an averaged centroid. The service isn&#8217;t saying your address is at that location, it is saying the centroid of the zip\/+4\/+2 is at that location.If DOTS Address Geocode \u2013 US is giving what it says is a street-level match that doesn&#8217;t look like it&#8217;s at the right location plotted on a map, the issue is most often a stylistic difference between your mapping solution and our data. Because geocoding information is gathered in very different ways, your mapping solution is probably using a very different method than Service Objects does. If the location given is a street-level match, and it&#8217;s very far away from the target location, please let us know at&nbsp;<a href=\"mailto:support@serviceobjects.com\" rel=\"noreferrer noopener\" target=\"_blank\">support@serviceobjects.com<\/a><\/p>\n\n\n\n<div style=\"height:24px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-NoCensustractorblockdatawasreturnedforastreetlevelmatch.\">No Census tract or block data was returned for a street level match.<\/h4>\n\n\n\n<p>The geocoding service makes use of multiple data sources and the census data is disparate from the coordinate datasets. There is not always a one to one match for the two, so the census tract and block code will not always be available. Cases for this should be very rare overall, but it may be more noticeable for some rural areas or new developments. If you encounter this issue then please contact&nbsp;<a href=\"mailto:support@serviceobjects.com\" rel=\"noreferrer noopener\" target=\"_blank\">support@serviceobjects.com<\/a>&nbsp;with one or more example addresses so that we can investigate.<\/p>\n\n\n\n<div style=\"height:24px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-I'mNotaProgrammer.HowDoIUseDOTSAddressGeocode\u2013US?\">I&#8217;m Not a Programmer. How Do I Use DOTS Address Geocode \u2013 US?<\/h4>\n\n\n\n<p>Service Objects runs batches for you! A free batch trial is available at&nbsp;<a href=\"https:\/\/www.serviceobjects.com\/upload-center\/\" rel=\"noreferrer noopener\" target=\"_blank\">https:\/\/www.serviceobjects.com\/upload-center\/<\/a>.<\/p>\n\n\n\n<div style=\"height:22px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-DoyoualsoprovideaRESTfulinterface?\">Do you also provide a RESTful interface?<\/h4>\n\n\n\n<p>Yes we do! For more information on how to use our RESTful interface go here&nbsp;<a href=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/\">DOTS Address Geocode &#8211; US &#8211; REST<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"DOTSAddressGeocode-US-Conclusion\">Conclusion<\/h2>\n\n\n\n<p>Service Objects is proud to offer you a free trial of DOTS Address Geocode \u2013 US.<\/p>\n\n\n\n<p>Sign up today for a free trial at:<br><a href=\"https:\/\/www.serviceobjects.com\/address-geocode\/\" rel=\"noreferrer noopener\" target=\"_blank\">https:\/\/www.serviceobjects.com\/address-geocode\/<\/a><\/p>\n\n\n\n<p>Other technical questions or concerns can be directed to&nbsp;<a href=\"mailto:support@serviceobjects.com\" rel=\"noreferrer noopener\" target=\"_blank\">support@serviceobjects.com<\/a><\/p>\n\n\n\n<p>If you are interested in purchasing DOTS Address Geocode \u2013 US, please contact&nbsp;<a href=\"mailto:sales@serviceobjects.com\" rel=\"noreferrer noopener\" target=\"_blank\">sales@serviceobjects.com<\/a>.<\/p>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>DOTS Address Geocode US: Legacy Documentation by Service Objects<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":8241,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-8244","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v24.7 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>DOTS Address Geocode - US (Legacy) - Service Objects | Contact, Phone, Email Verification | Data Quality Services<\/title>\n<meta name=\"description\" content=\"DOTS Address Geocode - US (Legacy) - Service Objects | Contact, Phone, Email Verification | Data Quality Services\" \/>\n<meta name=\"robots\" content=\"noindex, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"DOTS Address Geocode - US (Legacy) - Service Objects | Contact, Phone, Email Verification | Data Quality Services\" \/>\n<meta property=\"og:description\" content=\"DOTS Address Geocode - US (Legacy) - Service Objects | Contact, Phone, Email Verification | Data Quality Services\" \/>\n<meta property=\"og:url\" content=\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/\" \/>\n<meta property=\"og:site_name\" content=\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\" \/>\n<meta property=\"article:modified_time\" content=\"2024-03-29T15:48:17+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/test.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/12\/warning.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"29 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/\",\"url\":\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/\",\"name\":\"DOTS Address Geocode - US (Legacy) - Service Objects | Contact, Phone, Email Verification | Data Quality Services\",\"isPartOf\":{\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/test.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/12\/warning.png\",\"datePublished\":\"2022-12-02T15:53:36+00:00\",\"dateModified\":\"2024-03-29T15:48:17+00:00\",\"description\":\"DOTS Address Geocode - US (Legacy) - Service Objects | Contact, Phone, Email Verification | Data Quality Services\",\"breadcrumb\":{\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#primaryimage\",\"url\":\"https:\/\/test.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/12\/warning.png\",\"contentUrl\":\"https:\/\/test.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/12\/warning.png\",\"width\":32,\"height\":32},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/test.serviceobjects.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Legacy\",\"item\":\"https:\/\/test.serviceobjects.com\/docs\/legacy\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"DOTS Address Geocode &#8211; US\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/#website\",\"url\":\"https:\/\/test.serviceobjects.com\/docs\/\",\"name\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/test.serviceobjects.com\/docs\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/#organization\",\"name\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\",\"url\":\"https:\/\/test.serviceobjects.com\/docs\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/test.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png\",\"contentUrl\":\"https:\/\/test.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png\",\"width\":2560,\"height\":1440,\"caption\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\"},\"image\":{\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"DOTS Address Geocode - US (Legacy) - Service Objects | Contact, Phone, Email Verification | Data Quality Services","description":"DOTS Address Geocode - US (Legacy) - Service Objects | Contact, Phone, Email Verification | Data Quality Services","robots":{"index":"noindex","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"og_locale":"en_US","og_type":"article","og_title":"DOTS Address Geocode - US (Legacy) - Service Objects | Contact, Phone, Email Verification | Data Quality Services","og_description":"DOTS Address Geocode - US (Legacy) - Service Objects | Contact, Phone, Email Verification | Data Quality Services","og_url":"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/","og_site_name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","article_modified_time":"2024-03-29T15:48:17+00:00","og_image":[{"url":"https:\/\/test.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/12\/warning.png","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"29 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/","url":"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/","name":"DOTS Address Geocode - US (Legacy) - Service Objects | Contact, Phone, Email Verification | Data Quality Services","isPartOf":{"@id":"https:\/\/test.serviceobjects.com\/docs\/#website"},"primaryImageOfPage":{"@id":"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#primaryimage"},"image":{"@id":"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#primaryimage"},"thumbnailUrl":"https:\/\/test.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/12\/warning.png","datePublished":"2022-12-02T15:53:36+00:00","dateModified":"2024-03-29T15:48:17+00:00","description":"DOTS Address Geocode - US (Legacy) - Service Objects | Contact, Phone, Email Verification | Data Quality Services","breadcrumb":{"@id":"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#primaryimage","url":"https:\/\/test.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/12\/warning.png","contentUrl":"https:\/\/test.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/12\/warning.png","width":32,"height":32},{"@type":"BreadcrumbList","@id":"https:\/\/test.serviceobjects.com\/docs\/legacy\/dots-address-geocode-us\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/test.serviceobjects.com\/docs\/"},{"@type":"ListItem","position":2,"name":"Legacy","item":"https:\/\/test.serviceobjects.com\/docs\/legacy\/"},{"@type":"ListItem","position":3,"name":"DOTS Address Geocode &#8211; US"}]},{"@type":"WebSite","@id":"https:\/\/test.serviceobjects.com\/docs\/#website","url":"https:\/\/test.serviceobjects.com\/docs\/","name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","description":"","publisher":{"@id":"https:\/\/test.serviceobjects.com\/docs\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/test.serviceobjects.com\/docs\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/test.serviceobjects.com\/docs\/#organization","name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","url":"https:\/\/test.serviceobjects.com\/docs\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/test.serviceobjects.com\/docs\/#\/schema\/logo\/image\/","url":"https:\/\/test.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png","contentUrl":"https:\/\/test.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png","width":2560,"height":1440,"caption":"Service Objects | Contact, Phone, Email Verification | Data Quality Services"},"image":{"@id":"https:\/\/test.serviceobjects.com\/docs\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/8244","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/comments?post=8244"}],"version-history":[{"count":193,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/8244\/revisions"}],"predecessor-version":[{"id":10017,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/8244\/revisions\/10017"}],"up":[{"embeddable":true,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/8241"}],"wp:attachment":[{"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/media?parent=8244"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}