gmaps4rails 1.0.2 → 1.1.0

data/app/assets/javascripts/gmaps4rails/gmaps4rails.bing.js.coffee

@@ -0,0 +1,163 @@
+######################################################################################################
+##############################################  Bing Maps  ##########################################
+######################################################################################################
+
+#// http://wiki.openstreetmap.org/wiki/OpenLayers
+#// http://openlayers.org/dev/examples
+#//http://docs.openlayers.org/contents.html
+
+class @Gmaps4RailsBing extends Gmaps4Rails
+
+  constructor: ->
+    super
+    @map_options =
+      type:  "road"   # aerial, auto, birdseye, collinsBart, mercator, ordnanceSurvey, road
+    @markers_conf =
+      infobox:  "description" #description or htmlContent
+
+    @mergeWithDefault("map_options")
+    @mergeWithDefault("markers_conf")
+
+  #////////////////////////////////////////////////////
+  #/////////////// Basic Objects         //////////////
+  #////////////////////////////////////////////////////
+
+  getMapType: -> 
+    switch @map_options.type
+      when "road"           then return Microsoft.Maps.MapTypeId.road
+      when "aerial"         then return Microsoft.Maps.MapTypeId.aerial
+      when "auto"           then return Microsoft.Maps.MapTypeId.auto
+      when "birdseye"       then return Microsoft.Maps.MapTypeId.birdseye
+      when "collinsBart"    then return Microsoft.Maps.MapTypeId.collinsBart
+      when "mercator"       then return Microsoft.Maps.MapTypeId.mercator
+      when "ordnanceSurvey" then return Microsoft.Maps.MapTypeId.ordnanceSurvey
+      else return Microsoft.Maps.MapTypeId.auto
+
+  createPoint: (lat, lng) ->
+    return new Microsoft.Maps.Point(lat, lng)
+
+  createLatLng:(lat, lng) ->
+    return new Microsoft.Maps.Location(lat, lng)
+  
+  createLatLngBounds: ->
+
+  createMap: ->
+    return new Microsoft.Maps.Map(document.getElementById(@map_options.id), { 
+      credentials:  @map_options.provider_key,
+      mapTypeId:    @getMapType(),
+      center:       @createLatLng(@map_options.center_latitude, @map_options.center_longitude),
+      zoom:         @map_options.zoom
+    })
+
+  createSize: (width, height) ->
+    return new google.maps.Size(width, height)
+
+  #////////////////////////////////////////////////////
+  #////////////////////// Markers /////////////////////
+  #////////////////////////////////////////////////////
+
+  createMarker: (args) ->
+    markerLatLng = @createLatLng(args.Lat, args.Lng) 
+    marker
+    #// Marker sizes are expressed as a Size of X,Y
+    if args.marker_picture == ""  
+      marker = new Microsoft.Maps.Pushpin(@createLatLng(args.Lat, args.Lng), {
+        draggable: args.marker_draggable,
+        anchor:    @createImageAnchorPosition(args.Lat, args.Lng),
+        text:      args.marker_title
+        }
+      );
+    else 
+      marker = new Microsoft.Maps.Pushpin(@createLatLng(args.Lat, args.Lng), {
+        draggable: args.marker_draggable,
+        anchor:    @createImageAnchorPosition(args.Lat, args.Lng),
+        icon:      args.marker_picture,
+        height:    args.marker_height,
+        text:      args.marker_title,
+        width:     args.marker_width
+        }
+      );
+    @addToMap(marker)
+    return marker
+
+  #// clear markers
+  clearMarkers: ->  
+    for marker in @markers
+      @clearMarker marker
+
+  clearMarker: (marker) ->
+    @removeFromMap(marker.serviceObject)
+
+  #//show and hide markers
+  showMarkers: ->
+    for marker in @markers
+      @showMarker marker
+
+  showMarker: (marker) ->
+    marker.serviceObject.setOptions({ visible: true })
+
+  hideMarkers: ->
+    for marker in @markers
+      @hideMarker marker
+
+  hideMarker: (marker) ->
+    marker.serviceObject.setOptions({ visible: false })
+
+  extendBoundsWithMarkers: ->
+    locationsArray = []
+    for marker in @markers
+      locationsArray.push(marker.serviceObject.getLocation())
+    @boundsObject = Microsoft.Maps.LocationRect.fromLocations(locationsArray)
+
+  #////////////////////////////////////////////////////
+  #/////////////////// Clusterer //////////////////////
+  #////////////////////////////////////////////////////
+
+  createClusterer: (markers_array) ->
+
+  clearClusterer: ->
+
+  #//creates clusters
+  clusterize: ->
+    
+  #////////////////////////////////////////////////////
+  #/////////////////// INFO WINDOW ////////////////////
+  #////////////////////////////////////////////////////
+
+  #// creates infowindows
+  createInfoWindow: (marker_container) ->
+    if marker_container.description?
+      #//create the infowindow
+      if @markers_conf.infobox == "description"
+        marker_container.info_window = new Microsoft.Maps.Infobox(marker_container.serviceObject.getLocation(), { description: marker_container.description, visible: false, showCloseButton: true})
+      else
+        marker_container.info_window = new Microsoft.Maps.Infobox(marker_container.serviceObject.getLocation(), { htmlContent: marker_container.description, visible: false})
+
+      #//add the listener associated
+      currentMap = this
+      Microsoft.Maps.Events.addHandler(marker_container.serviceObject, 'click', @openInfoWindow(currentMap, marker_container.info_window))
+      @addToMap(marker_container.info_window)
+
+  openInfoWindow: (currentMap, infoWindow) ->
+    return ->
+      # Close the latest selected marker before opening the current one.
+      if currentMap.visibleInfoWindow
+        currentMap.visibleInfoWindow.setOptions({ visible: false })
+      infoWindow.setOptions({ visible:true })
+      currentMap.visibleInfoWindow = infoWindow
+
+  #////////////////////////////////////////////////////
+  #/////////////////// Other methods //////////////////
+  #////////////////////////////////////////////////////
+
+  fitBounds: ->
+    @map.setView({bounds: @boundsObject})
+
+  addToMap: (object)->
+    @map.entities.push(object)
+
+  removeFromMap: (object)->
+    @map.entities.remove(object)
+
+  centerMapOnUser: ->
+    @map.setView({ center: @userLocation})

data/app/assets/javascripts/gmaps4rails/gmaps4rails.googlemaps.js.coffee

@@ -0,0 +1,253 @@
+#######################################################################################################
+##############################################  Google maps  ##########################################
+#######################################################################################################
+
+class @Gmaps4RailsGoogle extends Gmaps4Rails
+ 
+  constructor: ->
+    super
+    #Map settings
+    @map_options =
+      disableDefaultUI:       false
+      disableDoubleClickZoom: false
+      type:                   "ROADMAP" # HYBRID, ROADMAP, SATELLITE, TERRAIN
+
+    #markers + info styling
+    @markers_conf = 
+      clusterer_gridSize:      50
+      clusterer_maxZoom:       5
+      custom_cluster_pictures: null
+      custom_infowindow_class: null 
+    
+    @mergeWithDefault("map_options")
+    @mergeWithDefault("markers_conf")
+
+    @kml_options =
+      clickable: true
+      preserveViewport: false
+      suppressInfoWindows: false
+
+    #Polygon Styling
+    @polygons_conf =         # default style for polygons
+      strokeColor: "#FFAA00"
+      strokeOpacity: 0.8
+      strokeWeight: 2
+      fillColor: "#000000"
+      fillOpacity: 0.35
+
+    #Polyline Styling
+    @polylines_conf =         #default style for polylines
+      strokeColor: "#FF0000"
+      strokeOpacity: 1
+      strokeWeight: 2
+
+    #Circle Styling 
+    @circles_conf =           #default style for circles
+      fillColor: "#00AAFF"
+      fillOpacity: 0.35
+      strokeColor: "#FFAA00"
+      strokeOpacity: 0.8
+      strokeWeight: 2
+      clickable: false
+      zIndex: null
+
+    #Direction Settings
+    @direction_conf = 
+      panel_id:           null
+      display_panel:      false
+      origin:             null 
+      destination:        null
+      waypoints:          []       #[{location: "toulouse,fr", stopover: true}, {location: "Clermont-Ferrand, fr", stopover: true}]
+      optimizeWaypoints:  false
+      unitSystem:         "METRIC" #IMPERIAL
+      avoidHighways:      false
+      avoidTolls:         false
+      region:             null 
+      travelMode:         "DRIVING" #WALKING, BICYCLING
+
+  #////////////////////////////////////////////////////
+  #/////////////// Basic Objects         //////////////
+  #////////////////////////////////////////////////////
+
+  createPoint : (lat, lng) ->
+    return new google.maps.Point(lat, lng)
+
+  createLatLng : (lat, lng) ->
+    return new google.maps.LatLng(lat, lng)
+
+  createLatLngBounds : ->
+    return new google.maps.LatLngBounds()
+
+  createMap : ->
+    return new google.maps.Map document.getElementById(@map_options.id), {
+      maxZoom:                @map_options.maxZoom
+      minZoom:                @map_options.minZoom
+      zoom:                   @map_options.zoom
+      center:                 @createLatLng(@map_options.center_latitude, @map_options.center_longitude)
+      mapTypeId:              google.maps.MapTypeId[@map_options.type]
+      mapTypeControl:         @map_options.mapTypeControl
+      disableDefaultUI:       @map_options.disableDefaultUI
+      disableDoubleClickZoom: @map_options.disableDoubleClickZoom
+      draggable:              @map_options.draggable
+    }
+
+
+  createMarkerImage : (markerPicture, markerSize, origin, anchor, scaledSize) ->
+    return new google.maps.MarkerImage(markerPicture, markerSize, origin, anchor, scaledSize)
+
+  createSize : (width, height) ->
+    return new google.maps.Size(width, height)
+
+  #////////////////////////////////////////////////////
+  #////////////////////// Markers /////////////////////
+  #////////////////////////////////////////////////////
+
+  createMarker : (args) ->
+    markerLatLng = @createLatLng(args.Lat, args.Lng) 
+
+    #Marker sizes are expressed as a Size of X,Y
+    if args.marker_picture and args.rich_marker == null
+      return new google.maps.Marker({position: markerLatLng, map: @map, title: args.marker_title, draggable: args.marker_draggable})
+
+    else if (args.rich_marker != null)
+      return new RichMarker({
+        position: markerLatLng
+        map:       @this.map
+        draggable: args.marker_draggable
+        content:   args.rich_marker
+        flat:      if args.marker_anchor == null then false else args.marker_anchor[1]
+        anchor:    if args.marker_anchor == null then 0     else args.marker_anchor[0]
+      })
+
+    else 
+      #calculate MarkerImage anchor location
+      imageAnchorPosition  = @createImageAnchorPosition args.marker_anchor
+      shadowAnchorPosition = @createImageAnchorPosition args.shadow_anchor
+
+      #create or retrieve existing MarkerImages
+      markerImage = @createOrRetrieveImage(args.marker_picture, args.marker_width, args.marker_height, imageAnchorPosition)
+      shadowImage = @createOrRetrieveImage(args.shadow_picture, args.shadow_width, args.shadow_height, shadowAnchorPosition)
+      return new google.maps.Marker({position: markerLatLng, map: this.map, icon: markerImage, title: args.marker_title, draggable: args.marker_draggable, shadow: shadowImage})
+
+  #checks if obj is included in arr Array and returns the position or false
+  includeMarkerImage : (arr, obj) ->
+    for object, index in arr
+      return index if object.url == obj
+    return false
+
+  #checks if MarkerImage exists before creating a new one
+  #returns a MarkerImage or false if ever something wrong is passed as argument
+  createOrRetrieveImage : (currentMarkerPicture, markerWidth, markerHeight, imageAnchorPosition) ->
+    return null if (currentMarkerPicture == "" or currentMarkerPicture == null )
+
+    test_image_index = @includeMarkerImage(@markerImages, currentMarkerPicture)   
+    switch test_image_index
+      when false
+        markerImage = @createMarkerImage(currentMarkerPicture, @createSize(markerWidth, markerHeight), null, imageAnchorPosition, null )
+        @markerImages.push(markerImage)
+        return markerImage    
+        break 
+      else
+        return @markerImages[test_image_index] if typeof test_image_index == 'number'
+        return false
+
+  #clear markers
+  clearMarkers : ->
+    for marker in @markers
+      @clearMarker marker
+
+  #show and hide markers
+  showMarkers : ->
+    for marker in @markers
+      @showMarker marker
+
+  hideMarkers : ->
+    for marker in @markers
+      @hideMarker marker
+
+  clearMarker : (marker) ->
+    marker.serviceObject.setMap(null)
+
+  showMarker : (marker) ->
+    marker.serviceObject.setVisible(true)
+
+  hideMarker : (marker) ->
+    marker.serviceObject.setVisible(false)
+
+  extendBoundsWithMarkers : ->
+    for marker in @markers
+      @boundsObject.extend(marker.serviceObject.position)
+
+  #////////////////////////////////////////////////////
+  #/////////////////// Clusterer //////////////////////
+  #////////////////////////////////////////////////////
+
+  createClusterer : (markers_array) ->
+    return new MarkerClusterer( @map, markers_array, {  maxZoom: this.markers_conf.clusterer_maxZoom, gridSize: @markers_conf.clusterer_gridSize, styles: @customClusterer() })
+
+  clearClusterer : ->
+    @markerClusterer.clearMarkers()
+
+  #creates clusters
+  clusterize : ->
+    if @markers_conf.do_clustering == true
+      #first clear the existing clusterer if any
+      @clearClusterer() if @markerClusterer != null
+
+      markers_array = new Array
+      for marker in @markers
+        markers_array.push(marker.serviceObject)
+
+      @markerClusterer = @createClusterer(markers_array)
+
+  #////////////////////////////////////////////////////
+  #/////////////////// INFO WINDOW ////////////////////
+  #////////////////////////////////////////////////////
+
+  #// creates infowindows
+  createInfoWindow : (marker_container) ->
+    if @markers_conf.custom_infowindow_class == null && marker_container.description?
+      #create the infowindow
+      info_window = new google.maps.InfoWindow({content: marker_container.description })
+      #add the listener associated
+      currentMap = this
+      google.maps.event.addListener(marker_container.serviceObject, 'click', @openInfoWindow(currentMap, info_window, marker_container.serviceObject))
+    else #creating custom infowindow
+      if marker_container.description?
+        boxText = document.createElement("div")
+        boxText.setAttribute("class", @markers_conf.custom_infowindow_class) #to customize
+        boxText.innerHTML = marker_container.description 
+        info_window = new InfoBox(@infobox(boxText))
+        currentMap = this
+        google.maps.event.addListener(marker_container.serviceObject, 'click', @openInfoWindow(currentMap, info_window, marker_container.serviceObject))
+
+
+  openInfoWindow : (currentMap, infoWindow, marker) ->
+    return ->
+      # Close the latest selected marker before opening the current one.
+      currentMap.visibleInfoWindow.close() if currentMap.visibleInfoWindow != null 
+      infoWindow.open(currentMap.map, marker)
+      currentMap.visibleInfoWindow = infoWindow
+
+  #////////////////////////////////////////////////////
+  #/////////////////        KML      //////////////////
+  #////////////////////////////////////////////////////
+
+  createKmlLayer : (kml) ->
+    kml_options = kml.options || {}
+    kml_options = @mergeObjectWithDefault(kml_options, @kml_options)
+    kml =  new google.maps.KmlLayer( kml.url, kml_options)
+    kml.setMap(@map)
+    return kml
+
+
+  #////////////////////////////////////////////////////
+  #/////////////////// Other methods //////////////////
+  #////////////////////////////////////////////////////
+
+  fitBounds : ->
+    @map.fitBounds(@boundsObject)
+
+  centerMapOnUser : ->
+    @map.setCenter(@userLocation)
+    

data/app/assets/javascripts/gmaps4rails/gmaps4rails.mapquest.js.coffee

@@ -0,0 +1,134 @@
+#######################################################################################################
+##############################################  Map Quest #############################################
+#######################################################################################################
+# http://www.mapquestapi.com/sdk/js/v6.0.0/poi.html
+
+class @Gmaps4RailsMapquest extends Gmaps4Rails
+
+  constructor: ->
+    super
+    #Map settings
+    @map_options  = {type:  "map"}  #map type (map, sat, hyb)
+    @markers_conf = {}
+    @mergeWithDefault "markers_conf"
+    @mergeWithDefault "map_options"
+
+  #////////////////////////////////////////////////////
+  #/////////////// Basic Objects         //////////////
+  #////////////////////////////////////////////////////
+
+  createPoint: (lat, lng) ->
+    return new MQA.Poi({lat: lat, lng: lng})
+
+  createLatLng: (lat, lng) ->
+    return {lat: lat, lng: lng}
+
+  createLatLngBounds: ->
+
+  createMap: ->
+    map = new MQA.TileMap(                        #// Constructs an instance of MQA.TileMap
+      document.getElementById(@map_options.id),   #//the id of the element on the page you want the map to be added into 
+      @map_options.zoom,                          #//intial zoom level of the map
+      {lat: @map_options.center_latitude, lng: @map_options.center_longitude}, 
+      @map_options.type)                          #//map type (map, sat, hyb)
+    
+    MQA.withModule('zoomcontrol3', (->
+      map.addControl(
+        new MQA.LargeZoomControl3(), 
+        new MQA.MapCornerPlacement(MQA.MapCorner.TOP_LEFT)
+      )
+    ))
+    return map
+
+  createMarkerImage: (markerPicture, markerSize, origin, anchor, scaledSize) ->
+
+  #////////////////////////////////////////////////////
+  #////////////////////// Markers /////////////////////
+  #////////////////////////////////////////////////////
+
+  createMarker: (args)->
+    marker = new MQA.Poi( {lat: args.Lat, lng: args.Lng} )
+
+    if args.marker_picture != ""  
+      icon = new MQA.Icon(args.marker_picture, args.marker_height, args.marker_width)
+      marker.setIcon(icon)
+      if args.marker_anchor != null
+        marker.setBias({x: args.marker_anchor[0], y: args.marker_anchor[1]})
+
+    if args.shadow_picture != "" 
+      icon = new MQA.Icon(args.shadow_picture, args.shadow_height, args.shadow_width)
+      marker.setShadow(icon)
+
+      if args.shadow_anchor != null
+        marker.setShadowOffset({x: args.shadow_anchor[0], y: args.shadow_anchor[1]})
+
+    @addToMap marker
+    return marker
+
+
+  #// clear markers
+  clearMarkers: ->
+    for marker in markers
+      @clearMarker marker
+
+  #//show and hide markers
+  showMarkers: ->
+    for marker in markers
+      @showMarker marker
+
+  hideMarkers: ->
+    for marker in markers
+      @hideMarker marker
+
+  clearMarker: (marker) ->
+    @removeFromMap(marker.serviceObject)
+
+  showMarker: (marker) ->
+    #// marker.serviceObject
+
+  hideMarker: (marker) ->
+    #// marker.serviceObject
+
+  extendBoundsWithMarkers: ->
+    if @markers.length >=2
+      @boundsObject = new MQA.RectLL(@markers[0].serviceObject.latLng, @markers[1].serviceObject.latLng)
+      for marker in @markers
+        @boundsObject.extend marker.serviceObject.latLng
+
+  #////////////////////////////////////////////////////
+  #/////////////////// Clusterer //////////////////////
+  #////////////////////////////////////////////////////
+
+  createClusterer: (markers_array) ->
+
+  clearClusterer: ->
+
+  #//creates clusters
+  clusterize: ->
+
+  #////////////////////////////////////////////////////
+  #/////////////////// INFO WINDOW ////////////////////
+  #////////////////////////////////////////////////////
+
+  #// creates infowindows
+  createInfoWindow: (marker_container) ->
+    marker_container.serviceObject.setInfoTitleHTML(marker_container.description)
+    #//TODO: how to disable the mouseover display when using setInfoContentHTML?
+    #//marker_container.serviceObject.setInfoContentHTML(marker_container.description);
+
+  #////////////////////////////////////////////////////
+  #/////////////////// Other methods //////////////////
+  #////////////////////////////////////////////////////
+
+  fitBounds: ->
+    @map.zoomToRect @boundsObject if @markers.length >=2
+    @map.setCenter @markers[0].serviceObject.latLng if @markers.length == 1 
+
+  centerMapOnUser: -> 
+    @map.setCenter @userLocation
+    
+  addToMap: (object) ->
+    @map.addShape object
+
+  removeFromMap: (object)->
+    @map.removeShape object