https://github.com/brycejohnston/geojson2image
Ruby library for generating images from GeoJSON
https://github.com/brycejohnston/geojson2image
chunky-png geojson png ruby
Last synced: 17 days ago
JSON representation
Ruby library for generating images from GeoJSON
- Host: GitHub
- URL: https://github.com/brycejohnston/geojson2image
- Owner: brycejohnston
- License: mit
- Created: 2017-01-18T17:56:40.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2018-09-25T19:37:28.000Z (over 6 years ago)
- Last Synced: 2025-03-04T08:40:53.944Z (about 2 months ago)
- Topics: chunky-png, geojson, png, ruby
- Language: Ruby
- Homepage: https://rubygems.org/gems/geojson2image
- Size: 233 KB
- Stars: 13
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# geojson2image
[][gem]
[gem]: https://rubygems.org/gems/geojson2image
Ruby library for generating images from GeoJSON using the [ChunkyPNG library](https://github.com/wvanbergen/chunky_png).
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'geojson2image'
```
And then execute:
$ bundle
Or install it yourself as:
$ gem install geojson2image
## Usage
Initialize new Geojson2image::Convert object and call to_image
```ruby
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**
### 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:
```json
"properties": {
"fill": "#008000",
"stroke": "#006400"
},
```
**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](https://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](http://opensource.org/licenses/MIT).