This Example uses C#, .NET 2005, and the address geolocater web service provided by AGRC.

1. Open your Visual Studio Project you wish to add the web service to.
2. Right click on your solution in the solution explorer of .NET and click "Add Web Reference".
   
3. A dialog box appears and asks you to enter the path for the web service. This URL points to the web service you want to use and is located in the web service descriptions above. Remember you must login to view the URL's.
   
4. Add a web reference name, I chose geocoder, so you can reference this web service class from .NET later on. Click Add Reference (Refer to above screen capture).
5. Now you are all ready to use this new .NET web reference as a class. The image below is a screen capture of how to create an object of this class and invoke this new objects methods.
   
6. Reference your web service class by the name you chose above. Create an object of this class. Take a look at the methods available to you. The most important method is "GeocodeAddress", which takes your user name to authenticate you, a string address and zip code or city zone. This method returns a GeocodeResult object so be sure to create an object to store the results.

This Example uses HTML, JavaScript, and the Address Geolocater web service provided by AGRC.

1. You'll need to download Jason Levitt's javascript helper class here [jsr_class]. You'll need to include this in your html page later so you can reference its variables and functions.
1. <script type="text/javascript" src="jsr_class.js"></script>
2. Open or create your HTML page you wish to add a GIS web service component to. Create a div to dynamically populate the results.
1. <div id="jsonString"> </div>
3. Add a button to your page or some other object that allows for on onclick event; Name the function. Also add text boxes to get the users information.
1. <input type="submit" value="Fetch Coordinates from mapserve" onclick="callGeocode(); return false;" />
2. <input id="zone" type="text" value="84111" />
3. <input id="address" type="text" value="326 east south temple" />
4. Create the javascript function to handle the click event and fire the web service call. My code will get the values from the text box put them in the web service call string, make the web service request, dynamically create a script tag to catch the JSON return string and call the jsonp (JSON Padding) function to handle the results.

1. function callGeocode()
   {
   var address = document.getElementById("address").value;
   var zone = document.getElementById("zone").value;
   var uri = "Please Register or Login to use web services by clicking the appropriate link./GeocodeAddress?userName=YourUserName+"&streetAddress=" + escape(address) +"&zipCodeOrCity=" + escape(zone) +"&jsonp=doThis"

   var request = new JSONscriptRequest(uri);
   request.buildScriptTag();
   request.addScriptTag();
   }

5. Now that the web service has been fired and a script tag has been added to the DOM of the browser, the script text now has the results from the web service call. The JSONP is a variable that appends a javascript function call around the JSON string. This is done so a developer can call a predefined javascript method to handle the results from the web service call. Mine is called doThis(result). doThis will then grab the div, remove any previus results, grab the web service results in a var returnedItems, and dynamically create a lable and populate the label with the results of the web service call. Finally, the label is added to the div.

1. function doThis(result)
   {
   var div = document.getElementById("jsonString");
   while (div.firstChild)
   {
   div.removeChild(div.firstChild);
   }
   var returnedItems = result["result"];
   
   var label = document.createElement("label");
   label.innerHTML = returnedItems["matchAddress"] + "<br />" + returnedItems["geocoder"] + "<br />" + returnedItems["score"] + "<br />" + returnedItems["uTM_X"] + "<br />" + returnedItems["uTM_Y"] + "<br />" + returnedItems["lONG_X"] + "<br />" + returnedItems["lAT_Y"];
   div.appendChild(label);
   }

6. View the source of a working page Please Register or Login to use web services by clicking the appropriate link. .