map_view 0.0.1a

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 68615351a014bd78c102aecfcfceab2c5b8f95fc40c5d002f7562753696eb047
+  data.tar.gz: 5041b59a1f06e55cf775ad52d42f9f86a205516ef6fe22515421af669efed106
+SHA512:
+  metadata.gz: 8e2790b312928191a465fb42403126e69d567178946231659e68594e0d60b9cfad4ab61b246d9faa951699a2f47a09179d70d12df4908217bf48fde1109f39cd
+  data.tar.gz: b09a79564328702cb532d8cdea8e109a11f18d675c2e1e645d725a1147292d8d044cdad7c1586f05684040f265f61ec77f477298557e3be571a21059c8d7779b

data/README.md

@@ -0,0 +1,188 @@
+# LibGD-GIS
+
+<p align="center">
+  <a href="https://rubystacknews.com/2026/01/07/ruby-can-now-draw-maps-and-i-started-with-ice-cream/">
+    <img src="https://img.shields.io/badge/RubyStackNews-CC342D?style=for-the-badge&logo=ruby&logoColor=white" />
+  </a>
+  <a href="https://x.com/ruby_stack_news">
+    <img src="https://img.shields.io/badge/Twitter%20@RubyStackNews-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white" />
+  </a>
+  <a href="https://www.linkedin.com/in/germ%C3%A1n-silva-56a12622/">
+    <img src="https://img.shields.io/badge/Germán%20Silva-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white" />
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://rubygems.org/gems/libgd-gis">
+    <img src="https://img.shields.io/badge/RubyGems-libgd--gis-CC342D?style=for-the-badge&logo=rubygems&logoColor=white" />
+  </a>
+  <a href="https://github.com/ggerman/libgd-gis">
+    <img src="https://img.shields.io/badge/GitHub-libgd--gis-181717?style=for-the-badge&logo=github&logoColor=white" />
+  </a>
+  <a href="https://github.com/ggerman/ruby-libgd">
+    <img src="https://img.shields.io/badge/Engine-ruby--libgd-CC342D?style=for-the-badge&logo=ruby&logoColor=white" />
+  </a>
+</p>
+
+<p align="right">
+  <img src="docs/images/logo-gis.png" width="160" />
+</p>
+
+![CI](https://github.com/ggerman/libgd-gis/actions/workflows/ci.yml/badge.svg)
+[![Codacy Badge](https://api.codacy.com/project/badge/Grade/6bc3e7d6118d47e6959b16690b815909)](https://www.codacy.com/app/libgd-gis/libgd-gis?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=libgd-gis/libgd-gis&amp;utm_campaign=Badge_Grade)
+[![Test Coverage](https://coveralls.io/repos/githublibgd-gis/libgd-gis/badge.svg?branch=master)](https://coveralls.io/github/libgd-gis/libgd-gis?branch=master)
+[![Gem Version](https://img.shields.io/gem/v/libgd-gis.svg)](https://rubygems.org/gems/libgd-gis)
+
+
+| Examples | Examples | Examples |
+| :----: | :----: | :--: |
+| <img src="docs/examples/parana.png" height="250"> | <img src="docs/examples/nyc.png" height="250"> | <img src="docs/examples/paris.png" height="250"> |
+| <img src="examples/nyc/nyc.png" height="250"> | <img src="docs/examples/tokyo_solarized.png" height="250"> | <img src="examples/parana/parana.png" height="250"> |
+| <img src="docs/examples/america.png" height="250"> | <img src="docs/examples/argentina_museum.png" height="250"> | <img src="docs/examples/museos_parana.png" height="250"> |
+| <img src="docs/examples/asia.png" height="250"> | <img src="docs/examples/europe.png" height="250"> | <img src="docs/examples/icecream_parana.png" height="250"> |
+| <img src="docs/examples/argentina_cities.png" height="250"> | <img src="docs/examples/tanzania_hydro.png" height="250"> | <img src="docs/examples/parana_polygon.png" height="250"> |
+| <img src="docs/examples/parana_carto_dark.png" height="250"> | <img src="docs/examples/ramirez_avenue.png" height="250"> | <img src="examples/paris/paris.png" height="250"> |
+
+---
+
+> **libgd-gis is evolving very fast**, so some examples may temporarily stop working.  
+> Please report issues or ask for help — feedback is very welcome.  
+> https://github.com/ggerman/libgd-gis/issues or ggerman@gmail.com
+
+--
+
+## A geospatial raster engine for Ruby.
+
+libgd-gis allows Ruby to render real maps, GeoJSON layers, vector features, and geospatial tiles using a native raster backend powered by **libgd**.
+
+It restores something Ruby lost over time:
+ the ability to generate **maps, tiles, and GIS-grade visualizations natively**, without relying on external tools like QGIS, Mapnik, ImageMagick, or Mapbox.
+
+Built on top of **ruby-libgd**, this project turns Ruby into a **map rendering engine**, capable of producing spatial graphics, tiled maps, and geospatial outputs directly inside Ruby processes.
+
+- No external renderers.
+-  No shelling out.
+-  Just Ruby, raster, and GIS.
+
+---
+
+## What is this?
+
+`libgd-gis` is a **geospatial rendering engine** for Ruby built on top of [`ruby-libgd`](https://github.com/ggerman/ruby-libgd).
+
+It allows you to:
+
+- Load GeoJSON, CSV, or any dataset with coordinates  
+- Fetch real basemap tiles  
+- Reproject WGS84 (lat/lon) into Web Mercator  
+- Render points, icons, and layers onto a raster map  
+- Generate PNG maps or map tiles  
+
+This is the same type of pipeline used by professional GIS systems — implemented in Ruby.
+
+---
+
+## Installation
+
+### System dependency
+
+`libgd-gis` depends on **libgd**, via `ruby-libgd`.
+
+Install libgd first:
+
+**Ubuntu / Debian**
+```
+sudo apt install libgd-dev
+```
+
+**macOS**
+```
+brew install gd
+```
+
+---
+
+### Ruby gems
+
+```
+gem install ruby-libgd
+gem install libgd-gis
+```
+
+---
+
+## Quick Example
+
+Render hydroelectric plants from a GeoJSON file:
+
+```ruby
+require "json"
+require "gd/gis"
+
+# ---------------------------
+# Bounding box mundial
+# ---------------------------
+AMERICA = [-170, -60, -30, 75]
+
+# ---------------------------
+# Crear mapa
+# ---------------------------
+map = GD::GIS::Map.new(
+  bbox: AMERICA,
+  zoom: 4,
+  basemap: :carto_light
+)
+
+# Cargar datos
+# ---------------------------
+peaks = JSON.parse(File.read("picks.json"))
+
+# ---------------------------
+# Agregar capa de puntos
+# ---------------------------
+map.add_points(
+  peaks,
+  lon: ->(p) { p["longitude"] },
+  lat: ->(p) { p["latitude"] },
+  icon: "peak.png",
+  label: ->(p) { p["name"] },
+  font: "./fonts/DejaVuSans.ttf",
+  size: 10,
+  color: [0,0,0]
+)
+
+# ---------------------------
+# Renderizar y guardar
+# ---------------------------
+map.render
+map.save("output/america.png")
+
+puts "Saved output/america.png"
+
+```
+
+---
+
+## Features
+
+- Real basemap tiles  
+- WGS84 → Web Mercator projection  
+- GeoJSON point rendering  
+- CSV / JSON support  
+- Icon-based symbol layers  
+- Automatic bounding box fitting  
+- Raster output (PNG)  
+
+---
+
+## License
+
+MIT
+
+---
+
+## Author
+
+Germán Silva
+https://github.com/ggerman
+https://rubystacknews.com

data/lib/gd/gis/basemap.rb

@@ -0,0 +1,178 @@
+require "net/http"
+require "fileutils"
+
+module GD
+  module GIS
+    class Basemap
+      TILE_SIZE = 256
+      attr_reader :origin_x, :origin_y
+
+      def initialize(zoom, bbox, provider=:carto_light)
+        @zoom = zoom
+        @bbox = bbox
+        @provider = provider
+      end
+
+      def url(z, x, y, style = :osm)
+        case style
+
+        # ==============================
+        # OpenStreetMap
+        # ==============================
+        when :osm
+          "https://tile.openstreetmap.org/#{z}/#{x}/#{y}.png"
+
+        when :osm_hot
+          "https://tile.openstreetmap.fr/hot/#{z}/#{x}/#{y}.png"
+
+        when :osm_fr
+          "https://a.tile.openstreetmap.fr/osmfr/#{z}/#{x}/#{y}.png"
+
+        # ==============================
+        # CARTO
+        # ==============================
+        when :carto_light
+          "https://a.basemaps.cartocdn.com/light_all/#{z}/#{x}/#{y}.png"
+
+        when :carto_light_nolabels
+          "https://a.basemaps.cartocdn.com/light_nolabels/#{z}/#{x}/#{y}.png"
+
+        when :carto_dark
+          "https://a.basemaps.cartocdn.com/dark_all/#{z}/#{x}/#{y}.png"
+
+        when :carto_dark_nolabels
+          "https://a.basemaps.cartocdn.com/dark_nolabels/#{z}/#{x}/#{y}.png"
+
+        # ==============================
+        # ESRI / ArcGIS (Satellite, terrain, hybrid)
+        # ==============================
+        when :esri_satellite
+          "https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer/tile/#{z}/#{y}/#{x}"
+
+        when :esri_streets
+          "https://services.arcgisonline.com/ArcGIS/rest/services/World_Street_Map/MapServer/tile/#{z}/#{y}/#{x}"
+
+        when :esri_terrain
+          "https://services.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer/tile/#{z}/#{y}/#{x}"
+
+        when :esri_hybrid
+          "https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer/tile/#{z}/#{y}/#{x}"
+
+        # ==============================
+        # STAMEN 503
+        # ==============================
+        when :stamen_toner
+          "https://stamen-tiles.a.ssl.fastly.net/toner/#{z}/#{x}/#{y}.png"
+
+        when :stamen_toner_lite
+          "https://stamen-tiles.a.ssl.fastly.net/toner-lite/#{z}/#{x}/#{y}.png"
+
+        when :stamen_terrain
+          "https://stamen-tiles.a.ssl.fastly.net/terrain/#{z}/#{x}/#{y}.png"
+
+        when :stamen_watercolor
+          "https://stamen-tiles.a.ssl.fastly.net/watercolor/#{z}/#{x}/#{y}.jpg"
+
+        # ==============================
+        # OpenTopoMap
+        # ==============================
+        when :topo
+          "https://a.tile.opentopomap.org/#{z}/#{x}/#{y}.png"
+
+        # ==============================
+        # Wikimedia 403
+        # ==============================
+        when :wikimedia
+          "https://maps.wikimedia.org/osm-intl/#{z}/#{x}/#{y}.png"
+
+        # ==============================
+        # OpenRailwayMap
+        # ==============================
+        when :railway
+          "https://tiles.openrailwaymap.org/standard/#{z}/#{x}/#{y}.png"
+
+        # ==============================
+        # CyclOSM
+        # ==============================
+        when :cyclosm
+          "https://a.tile-cyclosm.openstreetmap.fr/cyclosm/#{z}/#{x}/#{y}.png"
+
+        else
+          raise "Unknown basemap style: #{style}"
+        end
+      end
+
+      def lon2tile(lon)
+        ((lon + 180.0) / 360.0 * (2 ** @zoom)).floor
+      end
+
+      def lat2tile(lat)
+        rad = lat * Math::PI / 180
+        ((1 - Math.log(Math.tan(rad) + 1 / Math.cos(rad)) / Math::PI) / 2 * (2 ** @zoom)).floor
+      end
+
+      def fetch_tiles
+        west, south, east, north = @bbox
+
+        x_min = lon2tile(west)
+        x_max = lon2tile(east)
+        y_min = lat2tile(north)
+        y_max = lat2tile(south)
+
+        @x_min = x_min
+        @y_min = y_min
+
+        @origin_x = x_min * TILE_SIZE
+        @origin_y = y_min * TILE_SIZE
+
+        FileUtils.mkdir_p("tmp/tiles")
+
+        tiles = []
+
+        (x_min..x_max).each do |x|
+          (y_min..y_max).each do |y|
+            path = nil
+
+            unless File.exist?("tmp/tiles/#{@provider}_#{@zoom}_#{x}_#{y}.png") ||
+                  File.exist?("tmp/tiles/#{@provider}_#{@zoom}_#{x}_#{y}.jpg")
+
+              uri = URI(url(@zoom, x, y, @provider))
+
+              Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+                req = Net::HTTP::Get.new(uri)
+                req["User-Agent"] = "libgd-gis/0.1 (Ruby)"
+
+                res = http.request(req)
+                raise "Tile fetch failed #{res.code}" unless res.code == "200"
+
+                content_type = res["content-type"]
+
+                ext =
+                  if content_type&.include?("png")
+                    "png"
+                  elsif content_type&.include?("jpeg") || content_type&.include?("jpg")
+                    "jpg"
+                  else
+                    raise "Unsupported tile type: #{content_type}"
+                  end
+
+                path = "tmp/tiles/#{@provider}_#{@zoom}_#{x}_#{y}.#{ext}"
+                File.binwrite(path, res.body)
+              end
+            else
+              if File.exist?("tmp/tiles/#{@provider}_#{@zoom}_#{x}_#{y}.png")
+                path = "tmp/tiles/#{@provider}_#{@zoom}_#{x}_#{y}.png"
+              else
+                path = "tmp/tiles/#{@provider}_#{@zoom}_#{x}_#{y}.jpg"
+              end
+            end
+
+            tiles << [x,y,path]
+          end
+        end
+
+        [tiles, x_min, y_min]
+      end
+    end
+  end
+end

data/lib/gd/gis/classifier.rb

@@ -0,0 +1,57 @@
+module GD
+  module GIS
+    class Classifier
+      def self.road(feature)
+        tags = feature.properties || {}
+
+        case tags["highway"]
+        when "motorway", "trunk"
+          :motorway
+        when "primary", "primary_link"
+          :primary
+        when "secondary", "secondary_link"
+          :secondary
+        when "tertiary"
+          :street
+        when "residential", "living_street"
+          :street
+        when "service", "track"
+          :minor
+        else
+          nil
+        end
+      end
+
+      def self.water?(feature)
+        p = feature.properties
+
+        p["waterway"] ||
+        p["natural"] == "water" ||
+        p["fclass"] == "river" ||
+        p["fclass"] == "stream"
+      end
+
+      def self.rail?(feature)
+        tags = feature.properties || {}
+        tags["railway"]
+      end
+
+      def self.park?(feature)
+        tags = feature.properties || {}
+        %w[park recreation_ground garden].include?(tags["leisure"]) ||
+          %w[park grass forest].include?(tags["landuse"])
+      end
+
+      def self.water_kind(feature)
+        p = feature.properties
+
+        case p["waterway"] || p["fclass"]
+        when "river"  then :river
+        when "stream" then :stream
+        else :minor
+        end
+      end
+
+    end
+  end
+end

data/lib/gd/gis/color_helpers.rb

@@ -0,0 +1,65 @@
+module GD
+  module GIS
+    module ColorHelpers
+      # --------------------------------------------------
+      # Random RGB color
+      # --------------------------------------------------
+      def self.random_rgb(min: 0, max: 255)
+        GD::Color.rgb(
+          rand(min..max),
+          rand(min..max),
+          rand(min..max)
+        )
+      end
+
+      # --------------------------------------------------
+      # Random RGBA color
+      # --------------------------------------------------
+      def self.random_rgba(min: 0, max: 255, alpha: nil)
+        GD::Color.rgba(
+          rand(min..max),
+          rand(min..max),
+          rand(min..max),
+          alpha || rand(50..255)
+        )
+      end
+
+      # --------------------------------------------------
+      # Random vivid color (avoid gray/mud)
+      # --------------------------------------------------
+      def self.random_vivid
+        h = rand
+        s = rand(0.6..1.0)
+        v = rand(0.7..1.0)
+
+        r, g, b = hsv_to_rgb(h, s, v)
+        GD::Color.rgb(r, g, b)
+      end
+
+      # --------------------------------------------------
+      # HSV → RGB
+      # --------------------------------------------------
+      def self.hsv_to_rgb(h, s, v)
+        i = (h * 6).floor
+        f = h * 6 - i
+        p = v * (1 - s)
+        q = v * (1 - f * s)
+        t = v * (1 - (1 - f) * s)
+
+        r, g, b =
+          case i % 6
+          when 0 then [v, t, p]
+          when 1 then [q, v, p]
+          when 2 then [p, v, t]
+          when 3 then [p, q, v]
+          when 4 then [t, p, v]
+          when 5 then [v, p, q]
+          end
+
+        [(r * 255).to_i, (g * 255).to_i, (b * 255).to_i]
+      end
+
+    end
+  end
+end
+

data/lib/gd/gis/crs_normalizer.rb

@@ -0,0 +1,57 @@
+module GD
+  module GIS
+    module CRS
+      CRS84    = "urn:ogc:def:crs:OGC:1.3:CRS84"
+      EPSG4326 = "EPSG:4326"
+      EPSG3857 = "EPSG:3857"
+
+      class Normalizer
+        def initialize(crs)
+          @crs = normalize_name(crs)
+        end
+
+        # Accepts:
+        #   normalize(lon,lat)
+        #   normalize(lon,lat,z)
+        #   normalize([lon,lat])
+        #   normalize([lon,lat,z])
+        def normalize(*args)
+          lon, lat = args.flatten
+          return nil if lon.nil? || lat.nil?
+
+          lon = lon.to_f
+          lat = lat.to_f
+
+          case @crs
+          when CRS84, nil
+            [lon, lat]
+
+          when EPSG4326
+            # axis order lat,lon → lon,lat
+            [lat, lon]
+
+          when EPSG3857
+            mercator_to_wgs84(lon, lat)
+
+          else
+            [lon, lat]
+          end
+        end
+
+        private
+
+        def normalize_name(name)
+          return nil if name.nil?
+          name.to_s.strip
+        end
+
+        def mercator_to_wgs84(x, y)
+          r = 6378137.0
+          lon = (x / r) * 180.0 / Math::PI
+          lat = (2 * Math.atan(Math.exp(y / r)) - Math::PI / 2) * 180.0 / Math::PI
+          [lon, lat]
+        end
+      end
+    end
+  end
+end