Home

Awesome

geojson2image

Gem Version

Ruby library for generating images from GeoJSON using the ChunkyPNG library.

Installation

Add this line to your application's Gemfile:

gem 'geojson2image'

And then execute:

$ bundle

Or install it yourself as:

$ gem install geojson2image

Usage

Initialize new Geojson2image::Convert object and call to_image

gjson = '{"type":"Feature","geometry":{"type":"MultiPolygon","coordinates":[......'
g2i = Geojson2image::Convert.new(
  json: gjson,
  width: 500,
  height: 500,
  padding: 50,
  background: "#ffffff",
  fill: "#008000",
  stroke: "#006400",
  output: "output.png"
)
g2i.to_image

Example Output

Example Output

Stroke and Fill Color Options

Accepts hex color format

Stroke and fill color options can be globally set when initializing a new Geojson2image::Convert object, or you can override them by adding properties to your GeoJSON that include the desired stroke and fill options per feature. Example:

"properties": {
  "fill": "#008000",
  "stroke": "#006400"
},

Example Output

Example Output

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/beaorn/geojson2image.

License

The gem is available as open source under the terms of the MIT License.