Java tutorial
package com.google.gwt.maps.client; /* * #%L * GWT Maps API V3 - Core API * %% * Copyright (C) 2011 - 2012 GWT Maps API V3 * %% * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * #L% */ import java.util.ArrayList; import java.util.Arrays; import java.util.Iterator; import com.google.gwt.ajaxloader.client.AjaxLoader; import com.google.gwt.ajaxloader.client.AjaxLoader.AjaxLoaderOptions; /** * Load Maps javascript v3 api * * TODO maybe move to the new loading system they have in google apis */ public class LoadApi { /** * Note: If you use 3, it will take the newest stable available. Don't want that. We didn't test with that yet! */ public final static String API_VERSION = "3.10"; /** * Libraries not loaded by default <br> * <br> * See <a href= "https://developers.google.com/maps/documentation/javascript/basics.html#Libraries" >Libraries API * Doc</a> */ public static enum LoadLibrary { /** * Allows your Maps API application to include context-sensitive text ads, allowing you to share in ad revenue for * ads shown to your users. Consult the AdSense Library documentation for more information. */ ADSENSE, /** * Provides a graphical interface for users to draw polygons, rectangles, polylines, circles, and markers on the * map. Consult the Drawing Library documentation for more information. */ DRAWING, /** * Geometry includes utility functions for calculating scalar geometric values (such as distance and area) on the * the surface of the earth. Consult the Geometry Library documentation for more information. */ GEOMETRY, /** * Panoramio contains functionality for adding Panoramio photo layers to your Maps API application. Consult the * Panoramio Layers documentation for more information. */ PANORAMIO, /** * Places enables your application to search for businesses, geographic locations, and points of interest near a * given location, or as a user types. Consult the Places Library documentation for more information. */ PLACES, /** * Weather contains functionality for adding meterological layers to your Maps API application. Consult the Weather * Layers documentation for more information. */ WEATHER, /** * Visualization contains functionality for adding advanced visualization layers to your Maps API application. * Consult the Visualization documentation for more information. */ VISUALIZATION; public String value() { return name().toLowerCase(); } public static LoadLibrary fromValue(String value) { return valueOf(value.toUpperCase()); } @Override public String toString() { return name().toLowerCase(); } } /** * @See <a href="https://developers.google.com/maps/documentation/javascript/basics#Localization">Localization docs</a> * @See <a href="https://spreadsheets.google.com/pub?key=p9pdwsai2hDMsLkXsoM05KQ&gid=1">List of languages</a> */ public static enum Language { GERMAN("de"), GREEK("el"), ENGLISH("en"), ENGLISH_AUSTRALIAN("en-AU"), ENGLISH_GREAT_BRITAIN( "en-GB"), SPANISH("es"), BASQUE("eu"), FARSI("fa"), FINNISH("fi"), FILIPINO("fil"), FRENCH( "fr"), GALICIAN("gl"), GUJARATI("gu"), HINDI("hi"), CROATIAN("hr"), HUNGARIAN( "hu"), INDONESIAN("id"), ITALIAN("it"), HEBREW("iw"), JAPANESE("ja"), KANNADA( "kn"), KOREAN("ko"), LITHUANIAN("lt"), LATVIAN("lv"), MALAYALAM( "ml"), MARATHI("mr"), DUTCH("nl"), NORWEGIAN_NYNORSK( "nn"), NORWEGIAN("no"), ORIYA("or"), POLISH( "pl"), PORTUGUESE("pt"), PORTUGUESE_BRAZIL( "pt-BR"), PORTUGUESE_PORTUGAL( "pt-PT"), ROMANSCH("rm"), ROMANIAN( "ro"), RUSSIAN( "ru"), SLOVAK( "sk"), SLOVENIAN( "sl"), SERBIAN( "sr"), SWEDISH( "sv"), TAGALOG( "tl"), TAMIL( "ta"), TELUGU( "te"), THAI( "th"), TURKISH( "tr"), UKRAINIAN( "uk"), VIETNAMESE( "vi"), CHINESE_SIMPLIFIED( "zh-CN"), CHINESE_TRADITIONAL( "zh-TW"), DANISH( "da"); private String value; Language(String value) { this.value = value; } public String getValue() { return value; } public static Language fromValue(String value) { return valueOf(value.toUpperCase()); } @Override public String toString() { return name().toLowerCase() + "(" + value + ")"; } } /** * Load Maps javascript v3 api with default libraries. these are not loaded {@link LoadLibrary} * * @param onLoad - callback on success * @param sensor - derive location [true|false] */ public static void go(Runnable onLoad, boolean sensor) { load(onLoad, sensor, null, null, null); } /** * loads maps api * * @param onLoad callback on success * @param loadLibraries load additional libraries like geometry * @param sensor derive location [true|false] */ public static void go(Runnable onLoad, ArrayList<LoadLibrary> loadLibraries, boolean sensor) { load(onLoad, sensor, loadLibraries, null, null); } /** * loads maps api * * @param onLoad callback on success * @param loadLibraries load additional libraries like geometry * @param sensor derive location [true|false] * @param language choose a language */ public static void go(Runnable onLoad, ArrayList<LoadLibrary> loadLibraries, boolean sensor, Language language) { load(onLoad, sensor, loadLibraries, language, null); } /** * loads maps api * * @param onLoad callback on success * @param loadLibraries load additional libraries like geometry * @param sensor derive location [true|false] */ public static void go(Runnable onLoad, LoadLibrary[] loadLibraries, boolean sensor) { ArrayList<LoadLibrary> loadLibrariesList = new ArrayList<LoadLibrary>(Arrays.asList(loadLibraries)); load(onLoad, sensor, loadLibrariesList, null, null); } /** * loads maps api * * @param onLoad callback on success * @param loadLibraries load additional libraries like geometry * @param sensor derive location [true|false] * @param language choose a language */ public static void go(Runnable onLoad, LoadLibrary[] loadLibraries, boolean sensor, Language language) { ArrayList<LoadLibrary> loadLibrariesList = new ArrayList<LoadLibrary>(Arrays.asList(loadLibraries)); load(onLoad, sensor, loadLibrariesList, language, null); } /** * loads maps api * * @param onLoad callback on success * @param sensor derive location [true|false] * @param otherParams add additional params. like "key=YOUR_API_KEY" */ public static void go(Runnable onLoad, boolean sensor, String otherParams) { load(onLoad, sensor, null, null, otherParams); } /** * loads maps api * * @param onLoad callback on success * @param loadLibraries load additional libraries like geometry * @param sensor sensor derive location [true|false] * @param otherParams add additional params. like "key=YOUR_API_KEY" */ public static void go(Runnable onLoad, ArrayList<LoadLibrary> loadLibraries, boolean sensor, String otherParams) { load(onLoad, sensor, loadLibraries, null, otherParams); } /** * loads maps api * * @param onLoad callback on success * @param loadLibraries load additional libraries like geometry * @param sensor sensor derive location [true|false] * @param language choose a language * @param otherParams add additional params. like "key=YOUR_API_KEY" */ public static void go(Runnable onLoad, ArrayList<LoadLibrary> loadLibraries, boolean sensor, Language language, String otherParams) { load(onLoad, sensor, loadLibraries, language, otherParams); } private static void load(Runnable onLoad, boolean sensor, ArrayList<LoadLibrary> loadLibraries, Language language, String otherParams) { String op = "sensor=" + sensor; if (otherParams != null) { op += "&" + otherParams; } if (loadLibraries != null) { op += "&" + getLibraries(loadLibraries); } if (language != null) { op += "&language=" + language.getValue(); } AjaxLoaderOptions settings = AjaxLoaderOptions.newInstance(); settings.setOtherParms(op); AjaxLoader.loadApi("maps", API_VERSION, onLoad, settings); } /** * get the url libraries parameter * * @param loadLibraries */ private static String getLibraries(ArrayList<LoadLibrary> loadLibraries) { if (loadLibraries == null) { return ""; } String s = "libraries="; Iterator<LoadLibrary> itr = loadLibraries.iterator(); int i = 0; while (itr.hasNext()) { LoadLibrary ll = itr.next(); if (ll != null) { if (i > 0) { s += ","; } s += ll.value(); i++; } } return s; } /** * private constructor */ private LoadApi() { } }