https://github.com/mapnik/ruby-mapnik

Ruby Bindings for Mapnik
https://github.com/mapnik/ruby-mapnik

Last synced: 7 months ago
JSON representation

Ruby Bindings for Mapnik

• Host: GitHub
• URL: https://github.com/mapnik/ruby-mapnik
• Owner: mapnik
• License: mit
• Created: 2011-07-08T01:29:14.000Z (over 14 years ago)
• Default Branch: master
• Last Pushed: 2015-09-10T05:46:31.000Z (over 10 years ago)
• Last Synced: 2024-12-13T21:58:57.624Z (over 1 year ago)
• Language: C++
• Homepage:
• Size: 3.29 MB
• Stars: 66
• Watchers: 10
• Forks: 13
• Open Issues: 10
• Metadata Files:
  • Readme: README.rdoc
  • Changelog: History.txt
  • License: LICENSE

Awesome Lists containing this project

README

          
= Ruby Mapnik

https://github.com/mapnik/Ruby-Mapnik

{}[https://travis-ci.org/mapnik/Ruby-Mapnik]

== Requirements

* Rake (and extentiontask)

* Rice >= 1.4.2 (build depends on autoconf)

* rcairo (https://github.com/rcairo/rcairo) (Optional)

* Mapnik 2.3.x or 2.2.x (Currently available at https://github.com/mapnik/mapnik)

On OS X install ruby deps like:

    export ARCHFLAGS="-arch x86_64"

    gem install rake-compiler rake hoe rice chunky_png cairo

== Description

A set of bindings between Ruby and Mapnik. Supports many of the common uses for 

Mapnik, and one day, might support all of them. Rendering is available using

the standard AGG library, or additionally via Cairo, if the rcairo gem is 

installed and Mapnik has been compiled with Cairo support.

== Installation

If you have checked out this local repository code build like:

    rake

The above command will compile the bindings and run the tests.

File issues at https://github.com/mapnik/Ruby-Mapnik/issues if you hit any compile errors.

To create a gem from your local repository and install it run:

  rake gem

  gem install pkg/mapnik-0.x.y.gem

Alternatively, if you wish to install Ruby-Mapnik from the latest tagged release you can do:

  gem install mapnik

Note: on osx the default rake compile will try to build universal, and your

mapnik install is unlikely built universal. Check the architecture of libmapnik.dylib like:

    file /usr/local/lib/libmapnik.dylib

On a system where your compiler defaults to 64bit you'll see: 'Mach-O 64-bit dynamically linked shared library x86_64'

So to avoid a linking warning like:

    ld: warning: ignoring file /usr/local/lib/libmapnik.dylib, file was built for unsupported file format which is not the architecture being linked (i386)

You can pass this before rake compile:

    export ARCHFLAGS="-arch x86_64"

== Synopsis

  

  require 'mapnik'

  map = Mapnik::Map.new do |m|

    

    # A grey background

    m.background = Mapnik::Color.new('#777')

    

    # Use the Google mercator projection

    m.srs =  Mapnik::Tile::DEFAULT_OUTPUT_PROJECTION

    

    # Add a layer to the map

    m.layer 'countries' do |l|

      

      # Add a style to the layer

      l.style do |s|

        # Add a rule to the style (this one is a default rule)

        s.rule do |default|

          

          #fill the shapes with polygon symbolizers

          default.fill = Mapnik::Color.new('#880000')

        end

      end

      # set the srs of the layer

      l.srs = "+proj=latlong +datum=WGS84"

      #specify the datasource for the layer

      l.datasource = Mapnik::Datasource.create :type => 'shape', :file => "#{PATH}/../data/TM_WORLD_BORDERS_SIMPL_0.3_MOD"

    end

  end

  map.zoom_to_box(map.layers.first.envelope) 

  map.render_to_file('my_map.png')

== Examples

See demo/rundemo.rb for the classic mapnik rundemo. Also see demo/sinatra/demo.rb 

for a simple tile server (requires the sinatra gem).

== Thanks

Thanks to the Mapnik team and especially to Dane Springmeyer!