gmaps4rails 0.9.1 → 0.10.0.pre1

data/README.rdoc

@@ -10,6 +10,20 @@ It's based on Ruby on Rails 3 Engines and uses Google Maps API V3.
 
 See screencasts here: http://www.youtube.com/user/TheApneadiving
 
+== When Gmaps4rails finally means Global Maps for Rails
+
+I now want to extend the gem, so it would support other map providers. I intend to add:
+
+* openlayers
+
+* mapquest
+
+* bing
+
+See: https://github.com/apneadiving/Google-Maps-for-Rails/wiki/Map-Apis
+
+Any help would be appreciated.
+
 
 == Requirements
 - gem 'gmaps4rails'     (in your gemfile, then bundle)
@@ -20,18 +34,18 @@ See screencasts here: http://www.youtube.com/user/TheApneadiving
 == Basic configuration
 In your model, add:
 
-	acts_as_gmappable
-	
-		def gmaps4rails_address
-		  #describe how to retrieve the address from your model, if you use directly a db column, you can dry your code, see wiki
-		  "#{self.street}, #{self.city}, #{self.country}" 
-		end
+  acts_as_gmappable
+
+  def gmaps4rails_address
+    #describe how to retrieve the address from your model, if you use directly a db column, you can dry your code, see wiki
+    "#{self.street}, #{self.city}, #{self.country}" 
+  end
 
 Create a migration and add the following fields to your table (here users):
 
-	add_column :users, :latitude, :float #you can change the name, see wiki
-	add_column :users, :longitude, :float #you can change the name, see wiki
-	add_column :users, :gmaps, :boolean #not mandatory, see wiki
+  add_column :users, :latitude, :float #you can change the name, see wiki
+  add_column :users, :longitude, :float #you can change the name, see wiki
+  add_column :users, :gmaps, :boolean #not mandatory, see wiki
 
 == How to?
 === QuickStart!
@@ -67,8 +81,6 @@ Done!
 
 * Integrate Markers with Label: http://google-maps-utility-library-v3.googlecode.com/svn/tags/markerwithlabel/1.1.2/
 
-* Other options from here: http://code.google.com/p/google-maps-utility-library-v3/wiki/Libraries
-
 Feel free ton contact us, you have your say.
 
 == Copyright

data/app/views/gmaps4rails/_gmaps4rails.html.erb

@@ -7,21 +7,48 @@ if enable_css == true %>
 
 <% content_for :scripts do %>
 <% if enable_js == true %>
-  <script type="text/javascript" src='http://maps.google.com/maps/api/js?sensor=false&libraries=geometry'></script>
-	<script type="text/javascript" src='http://google-maps-utility-library-v3.googlecode.com/svn/tags/infobox/1.1.5/src/infobox.js'></script>
-	<%=javascript_include_tag 'gmaps4rails' %>
-	<script type="text/javascript" src='http://google-maps-utility-library-v3.googlecode.com/svn/tags/markerclusterer/1.0/src/markerclusterer_compiled.js'></script>
+  <%= javascript_include_tag 'gmaps4rails' %>
+
+  <% case options['map_options'].try(:[], 'provider')  %>
+  <% when "openlayers"%>
+    <script src="http://www.openlayers.org/api/OpenLayers.js"></script>
+		<%= javascript_include_tag 'gmaps4rails.openlayers.js' %>
+  <% when "mapquest" %>
+    <script src="http://mapquestapi.com/sdk/js/v6.0.0/mqa.toolkit.js?key=<%= options['map_options'].try(:[], 'provider_key') %>"></script>
+    <%= javascript_include_tag 'gmaps4rails.mapquest.js' %>
+  <% when "bing" %>
+    <script type="text/javascript" src="http://ecn.dev.virtualearth.net/mapcontrol/mapcontrol.ashx?v=7.0"></script>
+    <%= javascript_include_tag 'gmaps4rails.bing.js' %>
+  <% else %>
+    <%= javascript_include_tag 'gmaps4rails.googlemaps.js' %>
+    <script type="text/javascript" src='http://maps.google.com/maps/api/js?sensor=false&libraries=geometry'></script>
+    <script type="text/javascript" src='http://google-maps-utility-library-v3.googlecode.com/svn/tags/infobox/1.1.5/src/infobox.js'></script>
+    <script type="text/javascript" src='http://google-maps-utility-library-v3.googlecode.com/svn/tags/markerclusterer/1.0/src/markerclusterer_compiled.js'></script>
+	<% end %>
 <% end  %>
 <script type="text/javascript" charset="utf-8">
 function gmaps4rails_init() {
-	<% #true is passed here to trigger map initialization %>
-	<%=raw options.to_gmaps4rails(true) %>
-}
+  <% #true is passed here to trigger map initialization %>
+  <%=raw options.to_gmaps4rails(true) %>
+};
 
 window.onload = gmaps4rails_init;
 
 </script>
 <% end %>
+
+
+<% case options['map_options'].try(:[], 'provider')  %>
+<% when "mapquest" %>
+<div id="mapQuest" style="width:750px; height:475px;">
+  <!-- Todo: change this style dynamically -->  
+</div>
+<% when "bing" %>
+<div id="<%= options['map_options'].try(:[],'container_id').nil? ? "map_container" : options['map_options']['container_id'] %>" > 
+  <div id="<%= options['map_options'].try(:[],'id').nil? ? "gmaps4rails_map" : options['map_options']['id'] %>" class="bing_map"></div>
+</div>
+<% else %>
 <div id="<%= options['map_options'].try(:[],'container_id').nil? ? "map_container" : options['map_options']['container_id'] %>"> 
   <div id="<%= options['map_options'].try(:[],'id').nil? ? "gmaps4rails_map" : options['map_options']['id'] %>"></div>
-</div>
+</div>
+<% end %>

data/lib/gmaps4rails.rb

@@ -1,11 +1,11 @@
 if defined?(Rails) && Rails::VERSION::MAJOR == 3
   module Gmaps4rails
     require 'rails'
+    require 'gmaps4rails/base'
+    require 'gmaps4rails/acts_as_gmappable'
     require 'gmaps4rails/extensions/array'
     require 'gmaps4rails/extensions/hash'
-    require 'gmaps4rails/acts_as_gmappable'
     require 'gmaps4rails/helper/gmaps4rails_helper'
-    require 'gmaps4rails/base'
   
     class Engine < Rails::Engine
        initializer "static assets" do |app|

data/lib/gmaps4rails/acts_as_gmappable.rb

@@ -32,9 +32,9 @@ module Gmaps4rails
         end
       end
 
-      def to_gmaps4rails
+      def to_gmaps4rails(&block)
         json = "["
-        json += Gmaps4rails.create_json(self).to_s.chop.chop #removes the extra comma
+        json += Gmaps4rails.create_json(self, &block).to_s.chop.chop #removes the extra comma
         json += "]"
       end
 

data/lib/gmaps4rails/base.rb

@@ -14,14 +14,18 @@ module Gmaps4rails
   # Creates the json related to one Object (only tried ActiveRecord objects)
   # This json will contian the marker's attributes of the object 
   
-  def Gmaps4rails.create_json(object)
+  def Gmaps4rails.create_json(object, &block)
     unless object.send(object.gmaps4rails_options[:lat_column]).blank? && object.send(object.gmaps4rails_options[:lng_column]).blank?
-"{#{Gmaps4rails.description(object)}#{Gmaps4rails.title(object)}#{Gmaps4rails.sidebar(object)}\"longitude\": \"#{object.send(object.gmaps4rails_options[:lng_column])}\", \"latitude\": \"#{object.send(object.gmaps4rails_options[:lat_column])}\"#{Gmaps4rails.picture(object)}},\n"
+"{#{Gmaps4rails.description(object)}#{Gmaps4rails.title(object)}#{Gmaps4rails.sidebar(object)}\"lng\": \"#{object.send(object.gmaps4rails_options[:lng_column])}\", \"lat\": \"#{object.send(object.gmaps4rails_options[:lat_column])}\"#{Gmaps4rails.picture(object)}#{Gmaps4rails.block_handling(object, &block)}},\n"
     end
   end  
 
-  # Returns description if gmaps4rails_infowindow is defined in the model
+  # execute block if provided so that it's included in the json string
+  def Gmaps4rails.block_handling(object, &block)
+     ", " + yield(object) if block_given?
+  end
   
+  # Returns description if gmaps4rails_infowindow is defined in the model
   def Gmaps4rails.description(object)
     return "\"description\": \"#{object.gmaps4rails_infowindow}\", " if object.respond_to?("gmaps4rails_infowindow")
   end
@@ -37,7 +41,7 @@ module Gmaps4rails
   def Gmaps4rails.sidebar(object)
     return "\"sidebar\": \"#{object.gmaps4rails_sidebar}\"," if object.respond_to?("gmaps4rails_sidebar")
   end
-  
+
   # Returns picture options if gmaps4rails_marker_picture is defined in the model
   def Gmaps4rails.picture(object)
     if object.respond_to?("gmaps4rails_marker_picture")

data/lib/gmaps4rails/extensions/array.rb

@@ -2,10 +2,10 @@ class Array
   #Scopes on models generate Arrays
   #this method enables short call to the json creation for all elements in the array
   
-  def to_gmaps4rails
+  def to_gmaps4rails(&block)
     json = "["
     each do |object|
-      json += Gmaps4rails.create_json(object).to_s
+      json += Gmaps4rails.create_json(object, &block).to_s
     end
     json.chop!.chop! unless json == "["
     json += "]"

data/lib/gmaps4rails/extensions/hash.rb

@@ -29,7 +29,7 @@ class Hash
           if option_k == "bounds" #particular case
             result << "Gmaps4Rails.map_options.#{option_k} = #{option_v};"
           else
-          result << "Gmaps4Rails.map_options.#{option_k} = #{Gmaps4rails.filter option_v};"
+            result << "Gmaps4Rails.map_options.#{option_k} = #{Gmaps4rails.filter option_v};"
           end
         end
       end
@@ -39,32 +39,32 @@ class Hash
     each do |category, content| #loop through options hash
       case category
       when "map_options"
-    	#already taken into account above => nothing to do here
-    	when "direction"
-    	  result <<  "Gmaps4Rails.direction_conf.origin = '#{content["data"]["from"]}';"
-    	  result << "Gmaps4Rails.direction_conf.destination = '#{content["data"]["to"]}';"
+        #already taken into account above => nothing to do here
+      when "direction"
+        result <<  "Gmaps4Rails.direction_conf.origin = '#{content["data"]["from"]}';"
+        result << "Gmaps4Rails.direction_conf.destination = '#{content["data"]["to"]}';"
 
         content["options"] ||= Array.new 
     	  content["options"].each do |option_k, option_v| 
           if option_k == "waypoints"
             waypoints = Array.new
-    				option_v.each do |waypoint|
-    				  waypoints << { "location" => waypoint, "stopover" => true }.to_json
-    				end
-    	      result << "Gmaps4Rails.direction_conf.waypoints = [#{waypoints * (",")}];"
+            option_v.each do |waypoint|
+              waypoints << { "location" => waypoint, "stopover" => true }.to_json
+            end
+            result << "Gmaps4Rails.direction_conf.waypoints = [#{waypoints * (",")}];"
           else #option_k != "waypoint"
-    	      result << "Gmaps4Rails.direction_conf.#{option_k} = #{Gmaps4rails.filter option_v};"	
+            result << "Gmaps4Rails.direction_conf.#{option_k} = #{Gmaps4rails.filter option_v};"	
           end
         end #end .each
-    	  result << "Gmaps4Rails.create_direction();"
-    	else #default behaviour in case condition
-    	  result << "Gmaps4Rails.#{category} = #{content["data"]};"
-    		content["options"] ||= Array.new 
-    	  content["options"].each do |option_k, option_v|
-    	    result << "Gmaps4Rails.#{category}_conf.#{option_k} = #{Gmaps4rails.filter option_v};"		
-    		end
-    	    result << "Gmaps4Rails.create_#{category}();"
-    	end 
+        result << "Gmaps4Rails.create_direction();"
+      else #default behaviour in case condition
+        result << "Gmaps4Rails.#{category} = #{content["data"]};"
+        content["options"] ||= Array.new 
+        content["options"].each do |option_k, option_v|
+          result << "Gmaps4Rails.#{category}_conf.#{option_k} = #{Gmaps4rails.filter option_v};"		
+        end
+        result << "Gmaps4Rails.create_#{category}();"
+      end 
     end
     result << "Gmaps4Rails.callback();"
     result * ('

data/public/javascripts/gmaps4rails.bing.js

@@ -0,0 +1,195 @@
+Gmaps4Rails.map_options.type =  "road";             // aerial, auto, birdseye, collinsBart, mercator, ordnanceSurvey, road
+Gmaps4Rails.markers_conf.infobox =  "description";  // description or htmlContent
+
+////////////////////////////////////////////////////
+/////////////// Basic Objects         //////////////
+////////////////////////////////////////////////////
+
+Gmaps4Rails.getMapType = function(){
+  switch(Gmaps4Rails.map_options.type)
+  {
+  case "road":
+    return Microsoft.Maps.MapTypeId.road;
+  case "aerial":
+    return Microsoft.Maps.MapTypeId.aerial;
+  case "auto":
+    return Microsoft.Maps.MapTypeId.auto;
+  case "birdseye":
+    return Microsoft.Maps.MapTypeId.birdseye;
+  case "collinsBart":
+    return Microsoft.Maps.MapTypeId.collinsBart;
+  case "mercator":
+    return Microsoft.Maps.MapTypeId.mercator;
+  case "ordnanceSurvey":
+    return Microsoft.Maps.MapTypeId.ordnanceSurvey;
+  default:
+    return Microsoft.Maps.MapTypeId.auto;
+  }
+};
+
+Gmaps4Rails.createPoint = function(lat, lng){
+  return new Microsoft.Maps.Point(lat, lng);
+};
+
+Gmaps4Rails.createLatLng = function(lat, lng){
+  return new Microsoft.Maps.Location(lat, lng);
+};
+
+Gmaps4Rails.createLatLngBounds = function(){
+
+};
+
+Gmaps4Rails.createMap = function(){
+  return new Microsoft.Maps.Map(document.getElementById(Gmaps4Rails.map_options.id), { 
+    credentials:  Gmaps4Rails.map_options.provider_key,
+    mapTypeId:    Gmaps4Rails.getMapType(),
+    center:       Gmaps4Rails.createLatLng(Gmaps4Rails.map_options.center_latitude, Gmaps4Rails.map_options.center_longitude),
+    zoom:         Gmaps4Rails.map_options.zoom
+ });
+};
+
+Gmaps4Rails.createSize = function(width, height){
+  return new google.maps.Size(width, height);
+};
+
+////////////////////////////////////////////////////
+////////////////////// Markers /////////////////////
+////////////////////////////////////////////////////
+
+Gmaps4Rails.createMarker = function(args){
+  var markerLatLng = Gmaps4Rails.createLatLng(args.Lat, args.Lng); 
+  var marker;
+  // Marker sizes are expressed as a Size of X,Y
+  if (args.marker_picture === "" ) { 
+    marker = new Microsoft.Maps.Pushpin(Gmaps4Rails.createLatLng(args.Lat, args.Lng), {
+     draggable: args.marker_draggable,
+     anchor:    Gmaps4Rails.createImageAnchorPosition(args.Lat, args.Lng),
+     text:      args.marker_title
+     }
+    );
+  } else {
+    marker = new Microsoft.Maps.Pushpin(Gmaps4Rails.createLatLng(args.Lat, args.Lng), {
+     draggable: args.marker_draggable,
+     anchor:    Gmaps4Rails.createImageAnchorPosition(args.Lat, args.Lng),
+     icon:      args.marker_picture,
+     height:    args.marker_height,
+     text:      args.marker_title,
+     width:     args.marker_width
+     }
+    );
+   }
+  Gmaps4Rails.addToMap(marker);
+  return marker;
+};
+
+// clear markers
+Gmaps4Rails.clearMarkers = function() {  
+  for (var i = 0; i < this.markers.length; ++i) {
+    this.clearMarker(this.markers[i]);
+  }
+};
+
+Gmaps4Rails.clearMarker = function(marker) {
+  this.removeFromMap(marker.serviceObject);
+};
+
+//show and hide markers
+Gmaps4Rails.showMarkers = function() {
+  for (var i = 0; i < this.markers.length; ++i) {
+    this.showMarker(this.markers[i]);
+  }
+};
+
+Gmaps4Rails.showMarker = function(marker) {
+  marker.serviceObject.setOptions({ visible: true });
+};
+
+Gmaps4Rails.hideMarkers = function() {
+  for (var i = 0; i < this.markers.length; ++i) {
+    this.hideMarker(this.markers[i]);
+  }
+};
+
+Gmaps4Rails.hideMarker = function(marker) {
+  marker.serviceObject.setOptions({ visible: false });
+};
+
+Gmaps4Rails.extendBoundsWithMarkers = function(){
+  var locationsArray = [];
+  for (var i = 0; i <  this.markers.length; ++i) {
+    locationsArray.push(Gmaps4Rails.markers[i].serviceObject.getLocation());        
+  } 
+  Gmaps4Rails.boundsObject = Microsoft.Maps.LocationRect.fromLocations(locationsArray);
+};
+
+
+////////////////////////////////////////////////////
+/////////////////// Clusterer //////////////////////
+////////////////////////////////////////////////////
+
+Gmaps4Rails.createClusterer = function(markers_array){
+
+};
+
+Gmaps4Rails.clearClusterer = function() {
+};
+
+//creates clusters
+Gmaps4Rails.clusterize = function()
+{
+
+};
+
+////////////////////////////////////////////////////
+/////////////////// INFO WINDOW ////////////////////
+////////////////////////////////////////////////////
+
+// creates infowindows
+Gmaps4Rails.createInfoWindow = function(marker_container){
+  var info_window;
+  if (Gmaps4Rails.exists(marker_container.description)) {
+    //create the infowindow
+    if (Gmaps4Rails.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
+    Microsoft.Maps.Events.addHandler(marker_container.serviceObject, 'click', Gmaps4Rails.openInfoWindow(marker_container.info_window));
+    Gmaps4Rails.addToMap(marker_container.info_window);
+  }
+};
+
+Gmaps4Rails.openInfoWindow = function(infoWindow) {
+  return function() {
+      // Close the latest selected marker before opening the current one.
+      if (Gmaps4Rails.visibleInfoWindow) {
+        Gmaps4Rails.visibleInfoWindow.setOptions({ visible: false });
+      }
+      infoWindow.setOptions({ visible:true });
+      Gmaps4Rails.visibleInfoWindow = infoWindow;
+    };
+};
+
+////////////////////////////////////////////////////
+/////////////////// Other methods //////////////////
+////////////////////////////////////////////////////
+
+Gmaps4Rails.fitBounds = function(){
+  Gmaps4Rails.map.setView({bounds: Gmaps4Rails.boundsObject});
+};
+
+Gmaps4Rails.addToMap = function(object){
+  Gmaps4Rails.map.entities.push(object);
+};
+
+Gmaps4Rails.removeFromMap = function(object){
+  console.log(object);
+  Gmaps4Rails.map.entities.remove(object);
+};
+
+Gmaps4Rails.centerMapOnUser = function(){
+  Gmaps4Rails.map.setView({ center: Gmaps4Rails.userLocation});
+};