| /** | |
| * @classDescription The Mapifies variable is the main class object for jMaps | |
| */ | |
| var Mapifies; | |
| if (!Mapifies) Mapifies = {}; | |
| /** | |
| * The main object that holds the maps | |
| */ | |
| Mapifies.MapObjects = {}; | |
| /** | |
| * Creates a new map on the passed element with the defined options. Creates a global object that contains the map. | |
| * @method | |
| * @namespace Mapifies.MapObjects | |
| * @id Mapifies.MapObjects.Set | |
| * @alias Mapifies.MapObjects.Set | |
| * @param {jQuery} element The element that contains the map. | |
| * @param {Object} options An object that contains the options. | |
| * @return {Object} The object that contains the map. | |
| */ | |
| Mapifies.MapObjects.Set = function ( element, options ) { | |
| var mapName = jQuery(element).attr('id'); | |
| var thisMap = new GMap2(element); | |
| Mapifies.MapObjects[mapName] = thisMap; | |
| Mapifies.MapObjects[mapName].Options = options; | |
| return Mapifies.MapObjects[mapName]; | |
| }; | |
| /** | |
| * Adds additional objects and functions to an existing MapObject | |
| * @method | |
| * @namespace Mapifies.MapObjects | |
| * @id Mapifies.MapObjects.Append | |
| * @alias Mapifies.MapObjects.Append | |
| * @param {jQuery} element The element that contains the map | |
| * @param {Object} description The name of the object to create | |
| * @param {Object} appending The object or function to append | |
| */ | |
| Mapifies.MapObjects.Append = function ( element, description, appending ) { | |
| var mapName = jQuery(element).attr('id'); | |
| Mapifies.MapObjects[mapName][description] = appending; | |
| }; | |
| /** | |
| * Returns the current map object for the passed element | |
| * @method | |
| * @namespace Mapifies.MapObjects | |
| * @id Mapifies.MapObjects.Get | |
| * @alias Mapifies.MapObjects.Get | |
| * @param {jQuery} element The element that contains the map. | |
| * @return {Object} Mapifies The Mapifies object that contains the map. | |
| */ | |
| Mapifies.MapObjects.Get = function ( element ) { | |
| return Mapifies.MapObjects[jQuery(element).attr('id')]; | |
| }; | |
| /** | |
| * The main function to initialise the map | |
| * @method | |
| * @namespace Mapifies | |
| * @id Mapifies.Initialise | |
| * @alias Mapifies.Initialise | |
| * @param {jQuery} element The element to initialise the map on. | |
| * @param {Object} options The object that contains the options. | |
| * @param {Object} callback The callback function to pass out after initialising the map. | |
| * @return {Function} callback The callback option with the map object and options. | |
| */ | |
| Mapifies.Initialise = function ( element, options, callback ) { | |
| /** | |
| * Default options for Initialise | |
| * @method | |
| * @namespace Mapifies.Initialise | |
| * @id Mapifies.Initialise.defaults | |
| * @alias Mapifies.Initialise.defaults | |
| * @param {String} language The locale language for the map | |
| * @param {String} mapType The type of map to create. Options are 'map' (default), 'sat' and 'hybrid'. | |
| * @param {Object} mapCenter An array that contains the Lat/Lng coordinates of the map center. | |
| * @param {Number} mapZoom The initial zoom level of the map. | |
| * @param {String} mapControl The option for the map control. The options are 'small' (default), 'large' or 'none' | |
| * @param {Boolean} mapEnableType Defines if the buttons for map type are shown. Default false. | |
| * @param {Boolean} mapEnableOverview Defines if the map overview is shown. Default false. | |
| * @param {Boolean} mapEnableDragging Defines if the map is draggable or not. Default true. | |
| * @param {Boolean} mapEnableInfoWindows Defines if info windows are shown on the map or not. Default true. | |
| * @param {Boolean} mapEnableDoubleClickZoom Defines if double clicking zooms the map. Default false. | |
| * @param {Boolean} mapEnableSmoothZoom Defines if smooth scrolling is enabled. Default false. | |
| * @param {Boolean} mapEnableGoogleBar Defines if the google map search tool is enabled. Default false. | |
| * @param {Boolean} mapEnableScaleControl Defines if the scale bar is shown. Default false. | |
| * @param {Boolean} mapShowjMapsIcon Defines if the jMaps icon is shown. Default true. | |
| * @param {Boolean} debugMode Defines if the map object created is returned to the Firebug console. Default false. | |
| * @return {Object} The options for SearchAddress | |
| */ | |
| function defaults() { | |
| return { | |
| // Initial type of map to display | |
| 'language': 'en', | |
| // Options: "map", "sat", "hybrid" | |
| 'mapType': 'map', | |
| // Initial map center | |
| 'mapCenter': [55.958858,-3.162302], | |
| // Initial zoom level | |
| 'mapZoom': 12, | |
| // Initial map control size | |
| // Options: "large", "small", "none" | |
| 'mapControl': 'small', | |
| // Initialise type of map control | |
| 'mapEnableType': false, | |
| // Initialise small map overview | |
| 'mapEnableOverview': false, | |
| // Enable map dragging when left button held down | |
| 'mapEnableDragging': true, | |
| // Enable map info windows | |
| 'mapEnableInfoWindows': true, | |
| // Enable double click zooming | |
| 'mapEnableDoubleClickZoom': false, | |
| // Enable zooming with scroll wheel | |
| 'mapEnableScrollZoom': false, | |
| // Enable smooth zoom | |
| 'mapEnableSmoothZoom': false, | |
| // Enable Google Bar | |
| 'mapEnableGoogleBar': false, | |
| // Enables scale bar | |
| 'mapEnableScaleControl': false, | |
| // Enable the Mapifies icon | |
| 'mapShowjMapsIcon': true, | |
| //Debug Mode | |
| 'debugMode': false | |
| }; | |
| }; | |
| options = jQuery.extend(defaults(), options); | |
| if (GBrowserIsCompatible()) { | |
| var thisMap = Mapifies.MapObjects.Set(element, options); | |
| var mapType = Mapifies.GetMapType(options.mapType); | |
| thisMap.setCenter(new GLatLng(options.mapCenter[0], options.mapCenter[1]), options.mapZoom, mapType); | |
| if (options.mapShowjMapsIcon) { | |
| Mapifies.AddScreenOverlay(element, | |
| { | |
| 'imageUrl':'http://hg.digitalspaghetti.me.uk/jmaps/raw-file/3228fade0b3c/docs/images/jmaps-mapicon.png', | |
| 'screenXY':[70,10], | |
| 'overlayXY':[0,0], | |
| 'size':[42,25] | |
| } | |
| ); | |
| } | |
| // Attach a controller to the map view | |
| // Will attach a large or small. If any other value passed (i.e. "none") it is ignored | |
| switch (options.mapControl) { | |
| case "small": | |
| thisMap.addControl(new GSmallMapControl()); | |
| break; | |
| case "large": | |
| thisMap.addControl(new GLargeMapControl()); | |
| break; | |
| }; | |
| // Type of map Control (Map,Sat,Hyb) | |
| if (options.mapEnableType) | |
| thisMap.addControl(new GMapTypeControl()); // Off by default | |
| // Show the small overview map | |
| if (options.mapEnableOverview) | |
| thisMap.addControl(new GOverviewMapControl());// Off by default | |
| // GMap2 Functions (in order of the docs for clarity) | |
| // Enable a mouse-dragable map | |
| if (!options.mapEnableDragging) | |
| thisMap.disableDragging(); // On by default | |
| // Enable Info Windows | |
| if (!options.mapEnableInfoWindows) | |
| thisMap.disableInfoWindow(); // On by default | |
| // Enable double click zoom on the map | |
| if (options.mapEnableDoubleClickZoom) | |
| thisMap.enableDoubleClickZoom(); // On by default | |
| // Enable scrollwheel on the map | |
| if (options.mapEnableScrollZoom) | |
| thisMap.enableScrollWheelZoom(); //Off by default | |
| // Enable smooth zooming | |
| if (options.mapEnableSmoothZoom) | |
| thisMap.enableContinuousZoom(); // Off by default | |
| // Enable Google Bar | |
| if (options.mapEnableGoogleBar) | |
| thisMap.enableGoogleBar(); //Off by default | |
| // Enables Scale bar | |
| if (options.mapEnableScaleControl) | |
| thisMap.addControl(new GScaleControl()); | |
| if (options.debugMode) | |
| console.log(Mapifies); | |
| if (typeof callback == 'function') | |
| return callback(thisMap, element, options); | |
| } else { | |
| jQuery(element).text('Your browser does not support Google Maps.'); | |
| return false; | |
| } | |
| return; | |
| }; | |
| /** | |
| * A function to move a map to a passed position | |
| * @method | |
| * @namespace Mapifies | |
| * @id Mapifies.MoveTo | |
| * @alias Mapifies.MoveTo | |
| * @param {jQuery} element The element to initialise the map on. | |
| * @param {Object} options The object that contains the options. | |
| * @param {Object} callback The callback function to pass out after initialising the map. | |
| * @return {Function} callback The callback option with the map object and options or true. | |
| */ | |
| Mapifies.MoveTo = function ( element, options, callback ) { | |
| /** | |
| * Default options for MoveTo | |
| * @method | |
| * @namespace Mapifies | |
| * @id Mapifies.MoveTo | |
| * @alias Mapifies.MoveTo | |
| * @param {String} centerMethod The element to initialise the map on. | |
| * @param {String} mapType The type of map to create. Options are 'map' (default), 'sat' and 'hybrid'. | |
| * @param {Object} mapCenter An array that contains the Lat/Lng coordinates of the map center. | |
| * @param {Number} mapZoom The initial zoom level of the map. | |
| * @return {Function} callback The callback option with the point object and options or true. | |
| */ | |
| function defaults() { | |
| return { | |
| 'centerMethod': 'normal', | |
| 'mapType': null, | |
| 'mapCenter': [], | |
| 'mapZoom': null | |
| }; | |
| }; | |
| var thisMap = Mapifies.MapObjects.Get(element); | |
| options = jQuery.extend(defaults(), options); | |
| if (options.mapType) | |
| var mapType = Mapifies.GetMapType(options.mapType); | |
| var point = new GLatLng(options.mapCenter[0], options.mapCenter[1]); | |
| switch (options.centerMethod) { | |
| case 'normal': | |
| thisMap.setCenter(point, options.mapZoom, mapType); | |
| break; | |
| case 'pan': | |
| thisMap.panTo(point); | |
| break; | |
| } | |
| if (typeof callback == 'function') return callback(point, options); | |
| }; | |
| /** | |
| * Save your current position on the map | |
| * @method | |
| * @namespace Mapifies | |
| * @id Mapifies.SavePosition | |
| * @alias Mapifies.SavePosition | |
| * @param {jQuery} element The element to initialise the map on. | |
| * @param {Object} options The object that contains the options. | |
| * @param {Object} callback The callback function to pass out after initialising the map. | |
| * @return {Function} callback The callback option with the map object and options or true. | |
| */ | |
| Mapifies.SavePosition = function( element, options, callback ) { | |
| var thisMap = Mapifies.MapObjects.Get(element); | |
| thisMap.savePosition(); | |
| if (typeof callback == 'function') return callback(thisMap); | |
| }; | |
| /** | |
| * Goto a previously saved position | |
| * @method | |
| * @namespace Mapifies | |
| * @id Mapifies.GotoSavedPosition | |
| * @alias Mapifies.GotoSavedPosition | |
| * @param {jQuery} element The element to initialise the map on. | |
| * @param {Object} options The object that contains the options. | |
| * @param {Function} callback The callback function to pass out after initialising the map. | |
| * @return {Function} callback The callback option with the map object and options or true. | |
| */ | |
| Mapifies.GotoSavedPosition = function ( element, options, callback) { | |
| var thisMap = Mapifies.MapObjects.Get(element); | |
| thisMap.returnToSavedPosition(); | |
| if (typeof callback == 'function') return callback(thisMap); | |
| }; | |
| /** | |
| * Create a keyboard handler to handle keyboard navigation | |
| * @method | |
| * @namespace Mapifies | |
| * @id Mapifies.CreateKeyboardHandler | |
| * @alias Mapifies.CreateKeyboardHandler | |
| * @param {jQuery} element The element to initialise the map on. | |
| * @param {Object} options The object that contains the options. | |
| * @param {Object} callback The callback function to pass out after initialising the map. | |
| * @return {Function} callback The callback option with the keyboard handler. | |
| */ | |
| Mapifies.CreateKeyboardHandler = function( element, options, callback ) { | |
| var thisMap = Mapifies.MapObjects.Get(element); | |
| var keyboardHandler = new GKeyboardHandler(thisMap); | |
| if (typeof callback == 'function') return callback(keyboardHandler); | |
| }; | |
| /** | |
| * Check if a map container element has been resized or toggled from show/hide (Added r68) | |
| * @method | |
| * @namespace Mapifies | |
| * @id Mapifies.CheckResize | |
| * @alias Mapifies.CheckResize | |
| * @param {jQuery} element The element to initialise the map on. | |
| * @param {Object} options The object that contains the options. | |
| * @param {Object} callback The callback function to pass out after initialising the map. | |
| * @return {Function} callback The callback option with the map object handler. | |
| */ | |
| Mapifies.CheckResize = function( element, options, callback ) { | |
| var thisMap = Mapifies.MapObjects.Get(element); | |
| thisMap.checkResize(); | |
| if (typeof callback == 'function') return callback(element); | |
| }; | |
| /** | |
| * The SearchAddress function takes a map, options and callback function. The options can contain either an address string, to which a point is returned - or reverse geocoding a GLatLng, where an address is returned | |
| * @method | |
| * @namespace Mapifies | |
| * @id Mapifies.SearchAddress | |
| * @param {jQuery} element The jQuery object containing the map element. | |
| * @param {Object} options An object of options | |
| * @param {Function} callback The callback function that returns the result | |
| * @return {Function} Returns a passed callback function or true if no callback specified | |
| */ | |
| Mapifies.SearchAddress = function( element, options, callback) { | |
| /** | |
| * Default options for SearchAddress | |
| * @method | |
| * @namespace Mapifies.SearchAddress | |
| * @id Mapifies.SearchAddress.defaults | |
| * @alias Mapifies.SearchAddress.defaults | |
| * @param {String} query The Address or GLatLng to query in the geocoder | |
| * @param {String} returnType The type of value you want to return from Google. This is mapped to the function names available, the options are 'getLatLng' which returns coordinates, and 'getLocations' which returns points. | |
| * @param {GGeoCache} cache The GGeoCache to store the results in if required | |
| * @param {String} countryCode The country code to localise results | |
| * @return {Object} The options for SearchAddress | |
| */ | |
| function defaults() { | |
| return { | |
| // Address to search for | |
| 'query': null, | |
| // Return Type | |
| 'returnType': 'getLatLng', | |
| // Optional Cache to store Geocode Data (not implemented yet) | |
| 'cache': undefined, | |
| // Country code for localisation (not implemented yet) | |
| 'countryCode': 'uk' | |
| }; | |
| }; | |
| var thisMap = Mapifies.MapObjects.Get(element); | |
| options = jQuery.extend(defaults(), options); | |
| // Check to see if the Geocoder already exists in the object | |
| // or create a temporary locally scoped one. | |
| if (typeof thisMap.Geocoder === 'undefined') { | |
| < |