The API is really simple to use. It took me only a few hours to put together a quick little utility called Address on the Spot, which allows you to double click anywhere on a map to find an address for a location.

So here’s a quick how to for using the Reverse Geocoding API.

First, create a GLatLng object with a set of geocoordinates:

point = new GLatLng(45.523875, -122.670399);

Next, create a GClientGeocoder object and pass the point object to it, along with a callback function. The callback function display_address() will be executed when the geocoder returns a response.

geocoder = new GClientGeocoder();
geocoder.getLocations(point, display_address);

Here’s what display_address() might look like:

function display_address(response) {
    var address;
    if (!response || response.Status.code != 200) {
        address = "No location data found."
    } else {
        address = response.Placemark[0].address;
    }
    alert(address);
}

Couldn’t be easier. It’s definitely a handy addition to the Google Maps API, and this utility was pretty fun and easy to build.