Help us translate this website and improve this translation and earn free licenses!

Anonymous user | Log in | Create Account

		Initiation


		Controls and overlays


		InfoWindows


		Icons


		Other maps


		Events and Javascript


		Geo

Advanced GeoCoding


		GMaps Utility Library


		Others

GeoCoding Advanced

In order to collect details of the site that we are looking for, we will need advanced Geocoding.

It is very simple to use. Basically, it consists of passing a place as parameter and collecting all that the Google API provides to us. There are two ways to execute this action:

If we have a GMap instantiated in our page, all we have to do is: GMap1.getGeoCodeRequest(...) [geoCodeRequest is obsolete since version 3]
But we can also accede to a static method that does not require a GMap on the. The only thing to consider is that we will have to pass our Google API Key as a parameter: GMap.geoCodeRequest(...);

The static method returns two different data types. On one hand we have theGeocode type (structure the same way as the GoogleMaps XML is), and on the other hand we have an string from which we can select it's output type (xml, kml,json y csv).

Here are the parameters we could set to the methods:

Query: the location we are searching.
Coordinates: you can search a GLatLng instead of a location.
GoogleKey: only necessary if we use the static methods.
Premier: instead of the GoogleKey, if you have a Google Maps Api premier account. (only needed on static methods)
GeoCode.outputEnumoutput: the kind of output we want (xml, kml, json y csv). A Geocode element will be returned if the output is not set.
baseCountryCode: setting the country code we will see the results near it.
viewport: using GLatLngBounds sets the relevant area where we want to see the results.

We can access to the state message of the search in status.code (for example to know an error code). We could find the description of the state message code here: http://code.google.com/apis/maps/documentation/reference.html#GGeoStatusCode

The Geocode class is structured in an identical way to the XML that Google provides to us. Let us see an example of the XML from Google if we looked for "1600 amphitheatre mtn view ca". We can compare it with the code example that and we will see that the classes and their properties are analogous to the XML:

<kml>

<name>1600 amphitheatre mtn view ca</name>

<request>geocode</request>

</Status>

1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA

</address>

<SubAdministrativeAreaName>Santa Clara</SubAdministrativeAreaName>

<LocalityName>Mountain View</LocalityName>

<ThoroughfareName>1600 Amphitheatre Pkwy</ThoroughfareName>

</Thoroughfare>

</PostalCode>

</Locality>

</SubAdministrativeArea>

</AdministrativeArea>

</Country>

</AddressDetails>

<Point>

</Point>

</Placemark>

</Response>

</kml>

Find an address

Code.aspx
<asp:Literal ID="Literal1" runat="server">Buscar una dirección</asp:Literal>
<asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
<asp:Button ID="Button1" runat="server" Text="Buscar" OnClick="bt_Buscar_Click" />

<div>
<asp:Label ID="Label1" runat="server" Text=""></asp:Label>
</div>

Code.aspx.cs
protected void bt_Buscar_Click(object sender, EventArgs e)
{
if (!string.IsNullOrEmpty(tb_Buscar.Text))
{
string Key = System.Configuration.ConfigurationManager.AppSettings.Get("googlemaps.subgurim.net");

GeoCode geocode = GMap.geoCodeRequest(tb_Buscar.Text, Key);
//GeoCode geocode = GMap1.getGeoCodeRequest(tb_Buscar.Text);

System.Text.StringBuilder sb = new System.Text.StringBuilder();
if ((null != geocode) && geocode.valid)
{
sb.Append("<ul>");

sb.Append("<li>");
sb.Append("");
sb.Append("geocode.name");
sb.Append(": ");
sb.Append(geocode.name);
sb.Append("</li>");

sb.Append("<li>");
sb.Append("");
sb.Append("geocode.Status.code");
sb.Append(": ");
sb.Append(geocode.Status.code);
sb.Append("</li>");

sb.Append("<li>");
sb.Append("");
sb.Append("geocode.Status.request");
sb.Append(": ");
sb.Append(geocode.Status.request);
sb.Append("</li>");

sb.Append("<li>");
sb.Append("");
sb.Append("geocode.Placemark.address");
sb.Append(": ");
sb.Append(geocode.Placemark.address);
sb.Append("</li>");

sb.Append("<li>");
sb.Append("");
sb.Append("geocode.Placemark.AddressDetails.accuracy");
sb.Append(": ");
sb.Append(geocode.Placemark.AddressDetails.accuracy);
sb.Append("</li>");

sb.Append("<li>");
sb.Append("");
sb.Append("geocode.Placemark.AddressDetails.Country.CountryNameCode");
sb.Append(": ");
sb.Append(geocode.Placemark.AddressDetails.Country.CountryNameCode);
sb.Append("</li>");

sb.Append("<li>");
sb.Append("");
sb.Append("geocode.Placemark.AddressDetails.Country.AdministrativeArea.AdministrativeAreaName");
sb.Append(": ");
sb.Append(geocode.Placemark.AddressDetails.Country.AdministrativeArea.AdministrativeAreaName);
sb.Append("</li>");

sb.Append("<li>");
sb.Append("");
sb.Append("geocode.Placemark.AddressDetails.Country.AdministrativeArea.SubAdministrativeArea.SubAdministrativeAreaName");

sb.Append(": ");
sb.Append(geocode.Placemark.AddressDetails.Country.AdministrativeArea.SubAdministrativeArea.SubAdministrativeAreaName);
sb.Append("</li>");

sb.Append("<li>");
sb.Append("");
sb.Append("geocode.Placemark.AddressDetails.Country.AdministrativeArea.SubAdministrativeArea.Locality.LocalityName");
sb.Append(": ");
sb.Append(geocode.Placemark.AddressDetails.Country.AdministrativeArea.SubAdministrativeArea.Locality.LocalityName);
sb.Append("</li>");

sb.Append("<li>");
sb.Append("");
sb.Append("geocode.Placemark.AddressDetails.Country.AdministrativeArea.SubAdministrativeArea.Locality.PostalCode.PostalCodeNumber");
sb.Append(": ");
sb.Append(geocode.Placemark.AddressDetails.Country.AdministrativeArea.SubAdministrativeArea.Locality.PostalCode.PostalCodeNumber);
sb.Append("</li>");

sb.Append("<li>");
sb.Append("");
sb.Append("geocode.Placemark.AddressDetails.Country.AdministrativeArea.SubAdministrativeArea.Locality.Thoroughfare.ThoroughfareName");
sb.Append(": ");
sb.Append(geocode.Placemark.AddressDetails.Country.AdministrativeArea.SubAdministrativeArea.Locality.Thoroughfare.ThoroughfareName);
sb.Append("</li>");

sb.Append("<li>");
sb.Append("");
sb.Append("geocode.Placemark.coordinates");
sb.Append(": ");
sb.Append(geocode.Placemark.coordinates.ToString());
sb.Append("</li>");

sb.Append("</ul>");
} else sb.Append("Ubicación no encontrada"); lb_Buscar.Text = sb.ToString(); } }