global_map_tiles 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a56cacdab24343623ecc353a44b467f0ee1031c8f8be248ccf0345478dc94332
+  data.tar.gz: 8310d29ae51036ae6da881a0b6307ca84c545f9e5e469c69a8e8892355d2854a
+SHA512:
+  metadata.gz: 1ca773532591da76a8408fa9cabb4a70d0d061fa81618ee49e521ea15d644bd0bb03ed5b57fe797a5b2ac4659e7d31e1c197af4769e3b30b774d804654fc9b16
+  data.tar.gz: 1e7eae834a0f5c6f09fc0623e6a0e61b2af4955496c1ad20a83ef12526f7dc58d20d2c8ce042c8a771fcb67bb61f582829353679380c87d25c45a8e10be8952e

data/.github/issue_template.md

@@ -0,0 +1,17 @@
+## Expected behavior
+
+Describe here how you expected the gem to behave in this particular situation.
+
+## Actual behavior
+
+Describe here what actually happened.
+
+## Steps to reproduce the problem
+
+This is extremely important! Providing us with a reliable way to reproduce
+a problem will expedite its solution.
+
+## Specifications
+
+  - Version:
+  - Platform:

data/.github/pull_request_template.md

@@ -0,0 +1,7 @@
+Fixes #
+
+## Proposed Changes
+
+  -
+  -
+  -

data/.github/workflows/ci.yml

@@ -0,0 +1,18 @@
+name: CI
+on: [push]
+jobs:
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu, macos]
+        ruby: [2.5, 2.6, 2.7, head, jruby]
+    runs-on: ${{ matrix.os }}-latest
+    continue-on-error: ${{ endsWith(matrix.ruby, 'head') || matrix.ruby == 'debug' }}
+    steps:
+      - uses: actions/checkout@v2
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+      - run: bundle install
+      - run: bundle exec rake default

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/Gemfile

@@ -0,0 +1,8 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in global_map_tiles.gemspec
+gemspec
+
+gem "rake", "~> 13.0"
+gem "rspec", "~> 3.0"
+gem "standard"

data/Gemfile.lock

@@ -0,0 +1,61 @@
+PATH
+  remote: .
+  specs:
+    global_map_tiles (1.0.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.1)
+    diff-lcs (1.3)
+    parallel (1.19.1)
+    parser (2.7.2.0)
+      ast (~> 2.4.1)
+    rainbow (3.0.0)
+    rake (13.0.1)
+    regexp_parser (1.8.2)
+    rexml (3.2.4)
+    rspec (3.9.0)
+      rspec-core (~> 3.9.0)
+      rspec-expectations (~> 3.9.0)
+      rspec-mocks (~> 3.9.0)
+    rspec-core (3.9.1)
+      rspec-support (~> 3.9.1)
+    rspec-expectations (3.9.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-mocks (3.9.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-support (3.9.2)
+    rubocop (1.2.0)
+      parallel (~> 1.10)
+      parser (>= 2.7.1.5)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8)
+      rexml
+      rubocop-ast (>= 1.0.1)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (1.1.1)
+      parser (>= 2.7.1.5)
+    rubocop-performance (1.8.1)
+      rubocop (>= 0.87.0)
+      rubocop-ast (>= 0.4.0)
+    ruby-progressbar (1.10.1)
+    standard (0.9.0)
+      rubocop (= 1.2.0)
+      rubocop-performance (= 1.8.1)
+    unicode-display_width (1.6.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  global_map_tiles!
+  rake (~> 13.0)
+  rspec (~> 3.0)
+  standard
+
+BUNDLED WITH
+   2.1.4

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2020 Xavier Delamotte
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,50 @@
+# GlobalMapTiles
+
+![CI](https://github.com/x4d3/global_map_tiles/workflows/CI/badge.svg)
+
+Ruby port of the script "Tiles à la Google Maps: Coordinates, Tile Bounds and Projection" from http://www.maptiler.org/google-maps-coordinates-tile-bounds-projection/
+
+Lon/Lat convention was chosen over Lat/Lon as it's the convention of [GeoJSON](https://geojson.org/).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem "global_map_tiles"
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install global_map_tiles
+
+## Usage
+
+```ruby
+
+require "global_map_tiles"
+
+mercator = GlobalMapTiles::GlobalMercator.new
+puts mercator.lon_lat_to_meters(13.24, 52.31)
+puts mercator.meters_to_lon_lat(1473870.058102942, 6856372.69101939)
+```
+
+See all the examples in [spec/global_mercator_spec.rb](spec/global_mercator_spec.rb)
+
+## 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/x4d3/global_map_tiles.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require "standard/rake"
+
+RSpec::Core::RakeTask.new(:spec)
+task default: [:spec, :standard]

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "global_map_tiles"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/global_map_tiles.gemspec

@@ -0,0 +1,24 @@
+require_relative "lib/global_map_tiles/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "global_map_tiles"
+  spec.version = GlobalMapTiles::VERSION
+  spec.authors = ["Xavier Delamotte"]
+  spec.email = ["git@xade.eu"]
+
+  spec.summary = "Ruby port of globalmaptiles.py"
+  spec.description = 'Ruby port of the script "Tiles à la Google Maps: Coordinates, Tile Bounds and Projection" from http://www.maptiler.org/google-maps-coordinates-tile-bounds-projection/'
+  spec.homepage = "https://github.com/x4d3/global_map_tiles"
+  spec.license = "MIT"
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/x4d3/global_map_tiles"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path("..", __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.require_paths = ["lib"]
+end

data/lib/global_map_tiles.rb

@@ -0,0 +1,3 @@
+require "global_map_tiles/version"
+require "global_map_tiles/global_mercator"
+require "global_map_tiles/global_geodetic"

data/lib/global_map_tiles/global_geodetic.rb

@@ -0,0 +1,39 @@
+module GlobalMapTiles
+  # Functions necessary for generation of global tiles in Plate Carre projection, EPSG:4326, "unprojected profile".
+  class GlobalGeodetic
+    def initialize(tile_size = 256)
+      @tile_size = tile_size
+    end
+
+    # Converts lon/lat to pixel coordinates in given zoom of the EPSG:4326 pyramid
+    def lon_lat_to_pixels(lon, lat, zoom)
+      res = 180 / 256.0 / 2**zoom
+      px = (180 + lat) / res
+      py = (90 + lon) / res
+      [px, py]
+    end
+
+    # Returns coordinates of the tile covering region in pixel coordinates
+    def pixels_to_tile(px, py)
+      tx = ((px / @tile_size.to_f).ceil - 1).to_i
+      ty = ((py / @tile_size.to_f).ceil - 1).to_i
+      [tx, ty]
+    end
+
+    # Resolution (arc/pixel) for given zoom level (measured at Equator)"
+    def resolution(zoom)
+      (180 / 256.0) / 2**zoom
+    end
+
+    # Returns bounds of the given tile
+    def tile_bounds(tx, ty, zoom)
+      res = 180 / 256.0 / 2**zoom
+      [
+        tx * 256 * res - 180,
+        ty * 256 * res - 90,
+        (tx + 1) * 256 * res - 180,
+        (ty + 1) * 256 * res - 90
+      ]
+    end
+  end
+end

data/lib/global_map_tiles/global_mercator.rb

@@ -0,0 +1,114 @@
+module GlobalMapTiles
+  # based on EPSG:900913 = EPSG:3785
+  class GlobalMercator
+    def initialize(tile_size = 256)
+      @tile_size = tile_size
+      @initial_resolution = 2 * Math::PI * 6378137 / @tile_size
+      @origin_shift = 2 * Math::PI * 6378137 / 2.0
+    end
+
+    # Converts given lon/lat in WGS84 Datum to XY in Spherical Mercator EPSG:900913
+    def lon_lat_to_meters(lon, lat)
+      mx = lon * @origin_shift / 180.0
+      my = Math.log(Math.tan((90 + lat) * Math::PI / 360.0)) / (Math::PI / 180.0)
+
+      my = my * @origin_shift / 180.0
+      [mx, my]
+    end
+
+    # Converts XY point from Spherical Mercator EPSG:900913 to lon/lat in WGS84 Datum"
+    def meters_to_lon_lat(mx, my)
+      lon = (mx / @origin_shift) * 180.0
+      lat = (my / @origin_shift) * 180.0
+
+      lat = 180 / Math::PI * (2 * Math.atan(Math.exp(lat * Math::PI / 180.0)) - Math::PI / 2.0)
+      [lon, lat]
+    end
+
+    # Converts pixel coordinates in given zoom level of pyramid to EPSG:900913
+    def pixels_to_meters(px, py, zoom)
+      res = resolution(zoom)
+      mx = px * res - @origin_shift
+      my = py * res - @origin_shift
+      [mx, my]
+    end
+
+    # Converts EPSG:900913 to pyramid pixel coordinates in given zoom level
+    def meters_to_pixels(mx, my, zoom)
+      res = resolution(zoom)
+      px = (mx + @origin_shift) / res
+      py = (my + @origin_shift) / res
+      [px, py]
+    end
+
+    # Returns a tile covering region in given pixel coordinates
+    def pixels_to_tile(px, py)
+      tx = (px / @tile_size.to_f).ceil.to_i - 1
+      ty = (py / @tile_size.to_f).ceil.to_i - 1
+      [tx, ty]
+    end
+
+    # Move the origin of pixel coordinates to top-left corner
+    def pixels_to_raster(px, py, zoom)
+      map_size = @tile_size << zoom
+      [px, map_size - py]
+    end
+
+    # returns tile for given mercator coordinates
+    def meters_to_tile(mx, my, zoom)
+      px, py = meters_to_pixels(mx, my, zoom)
+      pixels_to_tile(px, py)
+    end
+
+    # Returns bounds of the given tile in EPSG:900913 coordinates
+    def tile_bounds(tx, ty, zoom)
+      min_x, min_y = pixels_to_meters(tx * @tile_size, ty * @tile_size, zoom)
+      max_x, max_y = pixels_to_meters((tx + 1) * @tile_size, (ty + 1) * @tile_size, zoom)
+      [min_x, min_y, max_x, max_y]
+    end
+
+    # Returns bounds of the given tile in longitude/latitude using WGS84 datum
+    def tile_lon_lat_bounds(tx, ty, zoom)
+      bounds = tile_bounds(tx, ty, zoom)
+      min_lon, min_lat = meters_to_lon_lat(bounds[0], bounds[1])
+      max_lon, max_lat = meters_to_lon_lat(bounds[2], bounds[3])
+
+      [min_lon, min_lat, max_lon, max_lat]
+    end
+
+    # Resolution (meters/pixel) for given zoom level (measured at Equator)
+    def resolution(zoom)
+      @initial_resolution / (2**zoom)
+    end
+
+    # "Maximal scaledown zoom of the pyramid closest to the pixelSize.
+    def zoom_for_pixel_size(pixel_size)
+      (1..30).each do |i|
+        if pixel_size > resolution(i)
+          return i != 0 ? (i - 1) : 0
+        end
+      end
+    end
+
+    # Converts TMS tile coordinates to Google Tile coordinates
+    def google_tile(tx, ty, zoom)
+      [tx, (2**zoom - 1) - ty]
+    end
+
+    # Converts TMS tile coordinates to Microsoft QuadTree
+    def quad_tree_key(tx, ty, zoom)
+      quad_key = ""
+      ty = (2**zoom - 1) - ty
+      i = zoom
+      while i > 0
+        digit = 0
+        mask = 1 << (i - 1)
+        digit += 1 if (tx & mask) != 0
+        digit += 2 if (ty & mask) != 0
+        quad_key += digit.to_s
+        i -= 1
+      end
+      quad_key
+    end
+  end
+end

data/lib/global_map_tiles/version.rb

@@ -0,0 +1,3 @@
+module GlobalMapTiles
+  VERSION = "1.0.0"
+end

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification
+name: global_map_tiles
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Xavier Delamotte
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2020-11-08 00:00:00.000000000 Z
+dependencies: []
+description: 'Ruby port of the script "Tiles à la Google Maps: Coordinates, Tile Bounds
+  and Projection" from http://www.maptiler.org/google-maps-coordinates-tile-bounds-projection/'
+email:
+- git@xade.eu
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/issue_template.md"
+- ".github/pull_request_template.md"
+- ".github/workflows/ci.yml"
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- global_map_tiles.gemspec
+- lib/global_map_tiles.rb
+- lib/global_map_tiles/global_geodetic.rb
+- lib/global_map_tiles/global_mercator.rb
+- lib/global_map_tiles/version.rb
+homepage: https://github.com/x4d3/global_map_tiles
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/x4d3/global_map_tiles
+  source_code_uri: https://github.com/x4d3/global_map_tiles
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project:
+rubygems_version: 2.7.6
+signing_key:
+specification_version: 4
+summary: Ruby port of globalmaptiles.py
+test_files: []