Subversion Repositories eFlore/Applications.cel

Google Maps V3 Bindings for GWT

This software is distributed under the Apache 2.0 license.

See the file COPYING for more details.

For more information on this project, see:

  http://code.google.com/p/gwt-google-apis

Contents:

  gwt-maps-<version>.jar  Add this library to your GWT project

  javadoc/                Javadoc generated from the API

  samples/                Short examples that show how to use the API.

For support, try the gwt-google-apis Google group.

If you think you have found a bug, see the online Issue tracker

==================================================================

Instructions for using Eclipse

These instructions require

  GWT 2.4 or higher          http://code.google.com/webtoolkit

  Google Plugin for Eclipse  http://code.google.com/eclipse

  Java JDK 1.5 or higher     http://java.sun.com/

---------- General Instructions  ---------------------------------

To work with the API in Eclipse, First create a 'Web Application' project

using the Google Plugin for Eclipse with Google Web Toolkit enabled.

This should create a new directory in your workspace for the project and

a war/WEB-INF/lib directory.  The gwt-maps.jar file need to be copied there

then refresh your project in Eclipse.

In Eclipse, add the gwt-maps.jar file to the build path, for example:

Project

  -> Properties

    -> Java Build Path

      -> Libraries

        -> Select gwt-maps.jar

Next, open to your entry point's .gwt.xml file and add the line:

  <inherits name="com.google.maps.gwt.GoogleMaps" />

Finally, you need to do one of two things to load the API on

application startup:

  1) Update your host file to include the following script tag:

  <script type="text/javascript" src="http://maps.googleapis.com/maps/api/js?sensor=SENSOR_TRUE_OR_FALSE"></script>

  Where the sensor value is either "true" or "false" depending on if you

  are hooked up to a location sensing device.  See the Maps API documentation

  at http://developers.google.com/maps/documentation/javascript/tutorial

  2) Load the API through the AjaxLoader library.  See the sample

  "MapsSimpleAjaxLoader.java" for an example.  The AjaxLoader library is

  bundled with the gwt-maps.jar distribution.  You will need to add

  the following line to your gwt module definition:

  <inherits name="com.google.gwt.ajaxloader.AjaxLoader" />

---------- Running a Sample ----------------------------------------

These instructions describe how to take one of the distributed samples

and run them in Eclipse using GWT's DevMode.  This assumes you are already

configured Eclipse with the Google Plugin for Eclipse and have run

through the GWT tutorials before.

Start by create a new Web Application Project. Uncheck the checkbox box to

install template code so that you start with an empty project.

Recursively copy in the sample code into the 'src' directory of your new

project.  Your src tree should now have the directories

com/google/maps/gwt/samples/...

Add the gwt-maps.jar to war/WEB-INF/lib and add it to the Java build path

of your project as mentioned in "General Instructions" above.

Choose the sample you'd like to run.  We'll use MapGeolocation.java as an

example.

Find MapGeolocoation.java in the tree, then find the corresponding .html file

for it in one of the 'public' directories.  In this case its

'map_geolocation.html'.

Copy the .html file down into the 'war' directory.

Open up the .html file and look at the module name.  To be compatible

with the Google Plugin for Eclipse, you'll need to edit the src attribute

'map_geolocation.nocache.js' and prepend the module name:

      <script type="text/javascript" language="javascript"

       src="map_geolocation/map_geolocation.nocache.js"></script>

Next, you'll need to create a GWT module

  1) Create a new GWT module using:

   File

     --> New

       --> Other...

         --> Google Web Toolkit

           --> Module

  2) Choose the module name to match the name in the .html file. In our

     example, that would be map_geolocation.  The package should be one

     level up from the location of the .java file:

     Package: com.google.maps.gwt.samples.basics

     Module name: map_geolocation

     Inherited Modules: com.google.gwt.user.User

                        com.google.maps.gwt.GoogleMaps

  3) Open the new module and add make the following modifications:

     Add a 'rename-to' attribute to the module start tag

     <module rename-to="map_geolocation" />

     Add in the .java sample as an entry point

     <entry-point

      class="com.google.maps.gwt.samples.basics.client.MapGeolocation" />

Finally, you are ready to launch the sample!  Right click on the

new map_geolocation.gwt.xml module and run the sample:

  Run As

   --> Web Application

Choose the web page you copied down (map_gelocation.html)  if prompted.