newtechfusion / ruby_mapscript

Ruby Mapscript API extensions

Ruby MapScript API extensions

This gem extends the SWIG MapScript API of UMN MapServer with Ruby-like iterators and other API methods.

Installation

ruby_mapscript requires the MapScript API library to be installed. On Debian/Ubuntu systems:

sudo apt-get install libmapscript-ruby

A Mapserver binary (CGI) is not required for executing ruby_mapscript code.

To use the gem, add it to your Gemfile or install it manually:

gem install ruby_mapscript

Usage

To use ruby_mapscript, require the gem and include Mapscript in your class/module or globally:

require "rubygems"
require "ruby_mapscript"
include Mapscript

ruby_mapscript provides a Ruby-like iterator interface to MapScript collections:

map = MapObj.new('test.map')
map.layers.each do |layer|
  puts layer.name
end
mapimage = map.draw
mapimage.save('test.png')

With the generic SWIG API iterating would look like:

0.upto(map.numlayers-1) do |i|
  layer = map.getLayer(i)
  puts layer.name
end

ruby_mapscript iterators include Enumerable which gives you the same methods as Ruby Arrays and Hashes:

wms_layers = map.layers.select { |layer| layer.connectiontype == MS_WMS }

To run a MapScript based WMS server as a Rack application create config.ru:

require "ruby_mapscript/mapserver"

run RubyMapscript::Mapserver.new('test.map')

and call:

rackup config.ru

To include a WMS server in a Rails application, require "ruby_mapscript/mapserver" and add a line to your routes.rb:

match "/wms" => RubyMapscript::Mapserver.new('test.map')

Copyright (c) 2012 Pirmin Kalberer, Sourcepole AG