terraformer-ruby

KO | EN

gitlite — search

#javascript #python #react #ai #golang #android #rust #linux #macos #java #awesome #awesome-list #openai #open-source

terraformer-ruby

(★ 24)

Toolkit for working with GeoJSON in pure Ruby

terraformer-ruby Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

terraformer-ruby
================

[terraformer-ruby](https://github.com/kenichi/terraformer-ruby) is a toolkit for working with GeoJSON in pure Ruby. Inspired by [terraformer](https://github.com/Esri/Terraformer).

## Installation

In your application's Gemfile:

```ruby
gem 'terraformer'
```

Or install it manually:

```sh
$ gem install terraformer
```

## Usage

```ruby
require 'terraformer'
```

##### Create a Terraformer primitive from GeoJSON

```ruby
polygon = Terraformer.parse '{
  "type": "Polygon",
  "coordinates": [
    [
      [-122.66589403152467, 45.52290150862236],
      [-122.66926288604736, 45.52291654238294],
      [-122.67115116119385, 45.518406234030586],
      [-122.67325401306151, 45.514000817199715],
      [-122.6684260368347, 45.5127377671934],
      [-122.66765356063841, 45.51694782364431],
      [-122.66589403152467, 45.52290150862236 ]
    ]
  ]
}'

point = Terraformer.parse '{
  "type": "Point",
  "coordinates": [-122.66947746276854, 45.51775972687403]
}'

```

Now that you have a point and a polygon primitive you can use the primitive helper methods.

```ruby
# add a new vertex to our polygon
new_point = Terraformer::Point.new -122.6708507537842, 45.513188859735436
polygon.insert_vertex 2, new_point
```

You can also have Terraformer perform many geometric operations like convex hulls and bounding boxes.

```ruby
# returns convex hull
convex_hull = polygon.convex_hull

point.within? convex_hull
=> true

# returns the bounding box
bounding_box = polygon.bbox
```

## Contributing

After checking out the source, run the tests:

```
$ git clone git@github.com:kenichi/terraformer-ruby.git
$ cd terraformer-ruby
$ bundle install
$ bundle exec rake test
```

You can also generate RDoc:

```
$ bundle exec rdoc --main README.md
```

terraformer-ruby

terraformer-ruby Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

terraformer-ruby

terraformer-ruby Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README