libgd-gis 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c2942d8d8fd3401c3c6c5bd47b8ea648aa63bc415e9621fb4c2f40873a80c7c7
-  data.tar.gz: d4a50c693ad4ab58e72365f8062d2420a8f683ccf692b97f4a7103f3a8ebe959
+  metadata.gz: dac7c14a782d59e332c74f826519a41213c5a4fea689006ae57b01d2d6f531db
+  data.tar.gz: 88d652bbcc7e56955f9cba7330a101759086e3561135b18a93b83254045a0c78
 SHA512:
-  metadata.gz: 7fc569940f1fea02dbe396b32a05286c68a07712b0a3c81665c1a5d3ac512dc1be2b76c349986b1d0a042afde4e900907aa51efb66b1cd2e43782b440aef6fc4
-  data.tar.gz: 3a062854e5e353a6d77632a162e26425071f808d6b8d84d08a60dc7e7f713edffbcc9ecff98351058cc868c49557a86b66e4da6a098502378310e4d05d2561d7
+  metadata.gz: c05ccb3f3f703229d999c6e2a0ce0d3f851a80ea5891ca3b6cb02b8b22d68a5ec38de5f10a9b1684ab92f1a5d71c4d9fd00a48101e578bac50cb91725c58e07e
+  data.tar.gz: 55e24d58d3ccf204de44fbf642ab7dcd377cd0a4ae9ce50e68d66766a70c1298d0f27c13d7ce503158c7e263ebaa6628d7f2d74e89bce7e97e24ef39806268fa

data/README.md

@@ -1,24 +1,54 @@
-# libgd-gis
-
-**A geospatial raster engine for Ruby**
-
-Render real maps, GeoJSON layers, and geospatial data directly in Ruby using a native raster backend powered by **libgd**.
-
-This project brings back something Ruby lost over time:  
-the ability to generate **maps, tiles, and geospatial visualizations natively**, without external tools like QGIS, ImageMagick, or Mapbox.
+# 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>
+
+
+| Examples | Examples | Examples |
+| :----: | :----: | :--: |
+| <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"> |  |
 
 ---
 
-## 🌍 Example
+## A geospatial raster engine for Ruby.
 
-This map of Tanzania was generated entirely in Ruby from a GeoJSON dataset of hydroelectric power plants:
+libgd-gis allows Ruby to render real maps, GeoJSON layers, vector features, and geospatial tiles using a native raster backend powered by **libgd**.
 
-![Tanzania hydro plants](examples/output/tanzania_hydro.png)
+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.
 
-No JavaScript.  
-No QGIS.  
-No Mapbox.  
-Just Ruby.
+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.
 
 ---
 
@@ -75,29 +105,46 @@ Render hydroelectric plants from a GeoJSON file:
 require "json"
 require "gd/gis"
 
-geo = JSON.parse(File.read("hydro_plants.geojson"))
-plants = geo["features"]
-
-lons = plants.map { |f| f["geometry"]["coordinates"][0] }
-lats = plants.map { |f| f["geometry"]["coordinates"][1] }
-
-bbox = [lons.min, lats.min, lons.max, lats.max]
+# ---------------------------
+# Bounding box mundial
+# ---------------------------
+AMERICA = [-170, -60, -30, 75]
 
+# ---------------------------
+# Crear mapa
+# ---------------------------
 map = GD::GIS::Map.new(
-  bbox: bbox,
-  zoom: 7,
+  bbox: AMERICA,
+  zoom: 4,
   basemap: :carto_light
 )
 
+# Cargar datos
+# ---------------------------
+peaks = JSON.parse(File.read("picks.json"))
+
+# ---------------------------
+# Agregar capa de puntos
+# ---------------------------
 map.add_points(
-  plants,
-  lon: ->(f) { f["geometry"]["coordinates"][0] },
-  lat: ->(f) { f["geometry"]["coordinates"][1] },
-  icon: "hydro.png"
+  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("tanzania_hydro.png")
+map.save("output/america.png")
+
+puts "Saved output/america.png"
+
 ```
 
 ---
@@ -122,6 +169,6 @@ MIT
 
 ## Author
 
-Germán Silva  
-https://github.com/ggerman  
+Germán Silva
+https://github.com/ggerman
 https://rubystacknews.com

data/examples/{a-world_peaks.rb → america-peaks.rb}

@@ -4,13 +4,13 @@ require "gd/gis"
 # ---------------------------
 # Bounding box mundial
 # ---------------------------
-WORLD = [-170, -60, -30, 75]
+AMERICA = [-170, -60, -30, 75]
 
 # ---------------------------
 # Crear mapa
 # ---------------------------
 map = GD::GIS::Map.new(
-  bbox: WORLD,
+  bbox: AMERICA,
   zoom: 4,
   basemap: :carto_light
 )
@@ -37,6 +37,6 @@ map.add_points(
 # Renderizar y guardar
 # ---------------------------
 map.render
-map.save("output/world_peaks-s.png")
+map.save("output/america.png")
 
-puts "Saved output/world_peaks.png"
+puts "Saved output/america.png"

data/examples/asia-peaks.rb

@@ -0,0 +1,42 @@
+require "json"
+require "gd/gis"
+
+# ---------------------------
+# Bounding box mundial
+# ---------------------------
+ASIA = [25.0, -10.0, 150.0, 60.0]
+
+# ---------------------------
+# Crear mapa
+# ---------------------------
+map = GD::GIS::Map.new(
+  bbox: ASIA,
+  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/asia.png")
+
+puts "Saved output/asia.png"

data/examples/av_ramirez.rb

@@ -0,0 +1,34 @@
+require "json"
+require "gd/gis"
+
+BBOX = [-60.556640625, -31.8402326679, -60.46875, -31.6907818061]
+
+map = GD::GIS::Map.new(
+  bbox: BBOX,
+  zoom: 14,
+  basemap: :carto_light
+)
+
+geo = JSON.parse(File.read("ramirez_full.geojson"))
+features = geo["features"]
+
+# Dibujar Av. Ramírez como polilínea
+map.add_lines(
+  features,
+  stroke: [255, 0, 0, 140],   # rojo semitransparente
+  width: 4
+)
+
+# Etiqueta
+map.add_points(
+  [{lon: -60.5205, lat: -31.76, name: "Av. Ramírez"}],
+  lon: ->(p){p[:lon]},
+  lat: ->(p){p[:lat]},
+  label: ->(p){p[:name]},
+  font: "./fonts/DejaVuSans.ttf",
+  size: 18,
+  color: [0,0,0,160]
+)
+
+map.render
+map.save("ramirez_polyline.png")

data/examples/europe-peaks.rb

@@ -0,0 +1,42 @@
+require "json"
+require "gd/gis"
+
+# ---------------------------
+# Bounding box mundial
+# ---------------------------
+EUROPE = [-15.0, 34.0, 40.0, 72.0]
+
+# ---------------------------
+# Crear mapa
+# ---------------------------
+map = GD::GIS::Map.new(
+  bbox: EUROPE,
+  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/europe.png")
+
+puts "Saved output/europe.png"

data/examples/heladerias.json

@@ -0,0 +1,47 @@
+[
+  {
+    "name": "Heladería Gallet",
+    "lat": -31.7332,
+    "lon": -60.5221
+  },
+  {
+    "name": "Freddo",
+    "lat": -31.7401,
+    "lon": -60.5289
+  },
+  {
+    "name": "La Italiana Helados Artesanales",
+    "lat": -31.7365,
+    "lon": -60.5247
+  },
+  {
+    "name": "Heladería San Remo",
+    "lat": -31.7389,
+    "lon": -60.5263
+  },
+  {
+    "name": "Heladería del Puerto",
+    "lat": -31.7450,
+    "lon": -60.5310
+  },
+  {
+    "name": "Mamma Mia Helados",
+    "lat": -31.7310,
+    "lon": -60.5190
+  },
+  {
+    "name": "Grido Helado",
+    "lat": -31.7375,
+    "lon": -60.5235
+  },
+  {
+    "name": "Cremolati",
+    "lat": -31.7410,
+    "lon": -60.5270
+  },
+  {
+    "name": "Bahilo Helados Artesanales",
+    "lat": -31.7345,
+    "lon": -60.5230
+  }
+]

data/examples/heladerias.rb

@@ -0,0 +1,40 @@
+require "json"
+require "gd/gis"
+
+# --------------------------------
+# Paraná, Entre Ríos
+# --------------------------------
+CITY = [-60.56, -31.76, -60.50, -31.71]
+
+map = GD::GIS::Map.new(
+  bbox: CITY,
+  zoom: 15,
+  basemap: :carto_light
+)
+
+# --------------------------------
+# Cargar datos
+# --------------------------------
+shops = JSON.parse(File.read("heladerias.json"))
+
+# --------------------------------
+# Capa de heladerías
+# --------------------------------
+map.add_points(
+  shops,
+  lon: ->(s) { s["lon"] },
+  lat: ->(s) { s["lat"] },
+  icon: "ice-cream.png",
+  label: ->(s) { s["name"] },
+  font: "./fonts/DejaVuSans.ttf",
+  size: 11,
+  color: [40,40,40]
+)
+
+# --------------------------------
+# Render
+# --------------------------------
+map.render
+map.save("output/heladerias_parana.png")
+
+puts "Saved output/heladerias_parana.png"

data/examples/parana_museos.rb

@@ -0,0 +1,49 @@
+require "csv"
+require "gd/gis"
+
+# --------------------------------
+# Paraná, Entre Ríos
+# --------------------------------
+CITY = [-60.56, -31.76, -60.50, -31.71]
+
+map = GD::GIS::Map.new(
+  bbox: CITY,
+  zoom: 15,
+  basemap: :carto_light
+)
+
+# --------------------------------
+# Cargar CSV oficial
+# --------------------------------
+rows = CSV.read("museos_datosabiertos.csv", headers: true)
+
+# Filtrar solo museos de Paraná
+museos = rows.select do |r|
+  r["localidad"]&.downcase == "paraná" &&
+  r["Latitud"] &&
+  r["Longitud"]
+end
+
+puts "Museos cargados: #{museos.size}"
+
+# --------------------------------
+# Capa de museos
+# --------------------------------
+map.add_points(
+  museos,
+  lon: ->(m) { m["Longitud"].to_f },
+  lat: ->(m) { m["Latitud"].to_f },
+  icon: "museos.png",            # tu icono
+  label: ->(m) { m["nombre"] },
+  font: "./fonts/DejaVuSans.ttf",
+  size: 11,
+  color: [40, 40, 40]
+)
+
+# --------------------------------
+# Render
+# --------------------------------
+map.render
+map.save("output/museos_parana.png")
+
+puts "Saved output/museos_parana.png"