Click here to Skip to main content
11,790,987 members (59,195 online)
Click here to Skip to main content

A .NET API for the Google Maps Geocoder

, 26 Jun 2008 CPOL 89.1K 2.7K 46
Rate this:
Please Sign up or sign in to vote.
A simple .NET library to wrap the Google Maps geocoding functionality


Google maps allows you to geocode addresses through their JavaScript API or by directly calling for results in XML. Both of these methods can take time to integrate into your .NET code. To make life a little simpler, I've wrapped the functionality of the HTTP geocode request into a .NET library.

Using the Code

You can make a call to only get all XML in a single string:

string xml = GMapGeocoder.Util.GetXml("123 fake street", "your google map key");

You can also get the code back in the original object structure:

string xml = GMapGeocoder.Util.GetXml("123 fake street", "your google map key");
GMapGeocoder.Generated.kml kml = GMapGeocoder.Util.DeserializeXml(xml);
string fullAddress = kml.Response.Placemark[0].address;
string countryCode = kml.Response.Placemark[0].AddressDetails.Country.CountryNameCode;
string stateCode = kml.Response.Placemark[0].AddressDetails.Country.

For US addresses, the following calls should make more sense than the kml object above:

GMapGeocoder.Containers.Results results = 
    GMapGeocoder.Util.Geocode("123 fake street", "your google map key");
GMapGeocoder.Containers.USAddress match1 = results.Addresses[0];
string city = match1.City;
string state = match1.StateCode;
double lat = match1.Coordinates.Latitude;

Points of Interest

I didn't find an exact XML definition, so I wrote the XSD file based on documentation on Google, along with results I found from making random queries. I included the XSD file just in case this definition is wrong and code needs to be regenerated. I've also noticed that HttpWebRequest.GetResponse() used by the GetXml call is slow on the initial call from an application, but subsequent calls are much quicker.


  • 27th May, 2008: Initial post
  • 24th June, 2008: Article updated


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Sharmil Y Desai
Software Developer (Senior) Cerner
United States United States
No Biography provided

You may also be interested in...

Comments and Discussions

QuestionThis is useful but Google API has been changed Pin
JoeSchmoe0074-Jun-14 4:25
memberJoeSchmoe0074-Jun-14 4:25 
QuestionImprovement to PlacemarkPointToPoint Pin
Gregg Lobdell6-Jul-11 12:45
memberGregg Lobdell6-Jul-11 12:45 
QuestionUpdate to Google Geocoding V3? Pin
Gregg Lobdell6-Jul-11 8:37
memberGregg Lobdell6-Jul-11 8:37 
AnswerRe: Update to Google Geocoding V3? Pin
Member 831154912-Oct-11 20:07
memberMember 831154912-Oct-11 20:07 
GeneralOnly using aspx.vb Pin
Paul M Gough26-Nov-09 22:06
memberPaul M Gough26-Nov-09 22:06 
GeneralKML Schema Pin
teggen26-Oct-09 17:13
memberteggen26-Oct-09 17:13 
GeneralI need complete seach results Pin
sandeepsc12-Sep-09 2:19
membersandeepsc12-Sep-09 2:19 
Generalstatus 602 Pin
oksanai25-Jun-09 4:33
memberoksanai25-Jun-09 4:33 
GeneralProblem with culture/ Utf8 Pin
rouliowiglesias24-Jun-09 16:07
memberrouliowiglesias24-Jun-09 16:07 
Generalweb project problem Pin
zerointeractive8-Jun-09 12:29
memberzerointeractive8-Jun-09 12:29 
GeneralVery nice :o) Pin
CipB28-May-09 4:53
memberCipB28-May-09 4:53 
GeneralRe: Very nice :o) Pin
jonranes28-May-09 7:56
memberjonranes28-May-09 7:56 
GeneralNice Article Pin
mbaocha6-May-09 11:31
membermbaocha6-May-09 11:31 
GeneralMultiple Addresses Pin
BlitzPackage27-Aug-08 9:01
memberBlitzPackage27-Aug-08 9:01 
GeneralRe: Multiple Addresses Pin
Sharmil Y Desai13-Sep-08 5:29
memberSharmil Y Desai13-Sep-08 5:29 
GeneralUK address support Pin
geedubb27-Aug-08 1:08
membergeedubb27-Aug-08 1:08 
GeneralConnection refused Pin
Lars Karlsson3-Jul-08 21:37
memberLars Karlsson3-Jul-08 21:37 
GeneralRe: Connection refused Pin
Sharmil Y Desai7-Jul-08 16:31
memberSharmil Y Desai7-Jul-08 16:31 
GeneralRe: Connection refused Pin
Sharmil Y Desai7-Jul-08 16:39
memberSharmil Y Desai7-Jul-08 16:39 
GeneralOne more Pin
wjcygan20-Jun-08 6:29
memberwjcygan20-Jun-08 6:29 
GeneralRe: One more Pin
Sharmil Y Desai24-Jun-08 7:41
memberSharmil Y Desai24-Jun-08 7:41 
GeneralSlight change Pin
wjcygan20-Jun-08 4:39
memberwjcygan20-Jun-08 4:39 
GeneralRe: Slight change Pin
Sharmil Y Desai24-Jun-08 7:38
memberSharmil Y Desai24-Jun-08 7:38 
GeneralError Pin
obinna_eke29-May-08 1:24
memberobinna_eke29-May-08 1:24 
GeneralRe: Error Pin
Sharmil Y Desai29-May-08 10:55
memberSharmil Y Desai29-May-08 10:55 
That's an odd error, seems more like a DNS issues where the box this is running on can't find . Can you get to,+Mountain+View,+CA&output=xml&key=ABQIAAAA_LYa_-GfNtQyBdJspQIboBRa7FnI_mqQJH5Raddl725svEZDkRSDjPurwcgJXErd6JKjFzLWFUbDGg directly from your browser on the box running the application?

Tried your exact call on my machine with the library and it seems to be working fine even though google can't resolve that address.

I get a 602 response back:

<?xml version="1.0" encoding="UTF-8"?><kml xmlns=""><Response><name>35 Greville Court Napoleon Road London E5 8TF</name><Status><code>602</code><request>geocode</request></Status></Response></kml>

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web03 | 2.8.1509028.1 | Last Updated 26 Jun 2008
Article Copyright 2008 by Sharmil Y Desai
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid