map_view 0.0.1a → 0.1.0.pre.alpha

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 68615351a014bd78c102aecfcfceab2c5b8f95fc40c5d002f7562753696eb047
-  data.tar.gz: 5041b59a1f06e55cf775ad52d42f9f86a205516ef6fe22515421af669efed106
+  metadata.gz: 71caf1dd97b22c96824dcf9bdd59cfab0a7665d2640f615618964b5dd95d2068
+  data.tar.gz: 6d8cbc42a9b9d0c0057af57e1d6f375310f568b30e78c0be84c3742930a9950d
 SHA512:
-  metadata.gz: 8e2790b312928191a465fb42403126e69d567178946231659e68594e0d60b9cfad4ab61b246d9faa951699a2f47a09179d70d12df4908217bf48fde1109f39cd
-  data.tar.gz: b09a79564328702cb532d8cdea8e109a11f18d675c2e1e645d725a1147292d8d044cdad7c1586f05684040f265f61ec77f477298557e3be571a21059c8d7779b
+  metadata.gz: c6d29c2d7670bb8e0d66b189887fe4c0243d48bc17a9b7ef4f3be62fed8afc3844be892a9bfc856199f96ecfa0e0d42de1c5372cd09f8b8abac3ed3069ea00a3
+  data.tar.gz: 9122c3ba6cb9039fe147a2f157dd2e38eb5e023049efd9ae89108d07288d1f493a9394eec2395075967ccb64614e97ff43b4f9793c9376e3fbdfa23b554b7185

data/README.md

@@ -1,188 +0,0 @@
-# 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/Rakefile

@@ -0,0 +1,7 @@
+# Rakefile
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/app/controllers/map_view/maps_controller.rb

@@ -0,0 +1,20 @@
+# app/controllers/map_view/maps_controller.rb
+module MapView
+  class MapsController < ApplicationController
+    def show
+      file_path = Rails.root.join("public", "map_cache", params[:path])
+      
+      Rails.logger.info "=== MAP_VIEW DEBUG ==="
+      Rails.logger.info "Params: #{params.inspect}"
+      Rails.logger.info "Looking for: #{file_path}"
+      Rails.logger.info "File exists? #{File.exist?(file_path)}"
+      
+      if File.exist?(file_path)
+        send_file file_path, type: "image/png", disposition: "inline"
+      else
+        Rails.logger.info "File NOT FOUND!"
+        head :not_found
+      end
+    end
+  end
+end

data/config/initializers/map_view.rb

@@ -0,0 +1,4 @@
+require "gd/gis"
+
+MapView.configure do |config|
+end

data/config/routes.rb

@@ -0,0 +1,4 @@
+# config/routes.rb
+MapView::Engine.routes.draw do
+  get "/map_cache/*path" => "maps#show", as: :map_cache
+end

data/lib/generators/map_view/install_generator.rb

@@ -0,0 +1,65 @@
+# lib/generators/map_view/install_generator.rb
+require "rails/generators/base"
+
+module MapView
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Installs MapView configuration files"
+
+      def copy_initializer
+        template "initializer.rb", "config/initializers/map_view.rb"
+      end
+
+      def create_styles_directory
+        empty_directory "config/map_view/styles"
+      end
+
+      def copy_default_style
+        template "default_styles.yml", "config/map_view/styles/default.yml"
+      end
+
+      def create_cache_directory
+        empty_directory "public/map_cache"
+      end
+
+      def add_route
+        route <<~RUBY
+          # Serve cached map images
+          get "/map_cache/*path" => "map_view/maps#show", :as => :map_cache
+        RUBY
+      end
+
+      def add_routes
+        route <<~RUBY
+          # MapView routes for serving cached map images
+          get "/map_cache/*path" => "map_view/maps#show", :as => :map_cache
+        RUBY
+      end
+
+      def create_controller
+        template "maps_controller.rb", "app/controllers/map_view/maps_controller.rb"
+      end
+
+      def display_post_install_message
+        puts <<~MSG
+
+          ═══════════════════════════════════════════════════════════════════════════
+            MapView installed successfully!
+
+            Next steps:
+            1. Ensure libgd-gis is installed and working
+            2. Restart your Rails server
+            3. Use in your views:
+               <%= map_view("path/to/data.geojson", bbox: :argentina) %>
+
+            Configuration file: config/initializers/map_view.rb
+            Styles directory:   config/map_view/styles/
+          ═══════════════════════════════════════════════════════════════════════════
+
+        MSG
+      end
+    end
+  end
+end

data/lib/generators/map_view/templates/default_styles.yml

@@ -0,0 +1,45 @@
+# config/map_view/styles/default.yml
+# Default map style for MapView
+
+global:
+  background: [15, 23, 42]
+
+roads:
+  motorway:
+    stroke: [239, 68, 68]
+    stroke_width: 3
+  primary:
+    stroke: [245, 158, 11]
+    stroke_width: 2.5
+  secondary:
+    stroke: [251, 191, 36]
+    stroke_width: 2
+  street:
+    stroke: [229, 231, 235]
+    stroke_width: 1.5
+  minor:
+    stroke: [156, 163, 175]
+    stroke_width: 1
+
+rails:
+  stroke: [156, 163, 175]
+  stroke_width: 2
+
+water:
+  stroke: [59, 130, 246]
+  stroke_width: 1.5
+
+parks:
+  fill: [34, 197, 94]
+  fill_opacity: 0.5
+
+points:
+  color: [239, 68, 68]
+  radius: 4
+
+order:
+  - water
+  - parks
+  - rails
+  - roads
+  - points

data/lib/generators/map_view/templates/initializer.rb

@@ -0,0 +1,14 @@
+# config/initializers/map_view.rb
+MapView.configure do |config|
+  # Map defaults
+  config.default_zoom = 10
+  config.default_basemap = :carto_light
+  config.default_width = 800
+  config.default_height = 600
+  config.default_style = "default"
+  config.default_bbox_name = :argentina
+
+  # Cache settings
+  config.cache_enabled = true
+  config.cache_dir = "public/map_cache"
+end

data/lib/generators/map_view/templates/maps_controller.rb

@@ -0,0 +1,15 @@
+# app/controllers/map_view/maps_controller.rb
+module MapView
+  class MapsController < ActionController::Base
+    # Serve cached map images
+    def show
+      cache_path = Rails.root.join("public", "map_cache", params[:path])
+      
+      if File.exist?(cache_path)
+        send_file cache_path, type: "image/png", disposition: "inline"
+      else
+        head :not_found
+      end
+    end
+  end
+end

data/lib/map_view/config.rb

@@ -0,0 +1,67 @@
+# lib/map_view/config.rb
+module MapView
+  class Configuration
+    # Map defaults
+    attr_accessor :default_zoom,
+                  :default_basemap,
+                  :default_width,
+                  :default_height,
+                  :default_style,
+                  :default_bbox_name
+
+    # Cache settings
+    attr_accessor :cache_enabled,
+                  :cache_dir,
+                  :cache_duration,
+                  :enable_caching,
+                  :png_compression
+
+    def initialize
+      # Map defaults
+      @default_zoom = 10
+      @default_basemap = :carto_light
+      @default_width = 800
+      @default_height = 600
+      @default_style = "default"
+      @default_bbox_name = :argentina
+
+      # Cache settings
+      @cache_enabled = true
+      @enable_caching = true
+      @cache_dir = "public/map_cache"
+      @cache_duration = 3600
+      @png_compression = 6
+    end
+
+    # Alias methods for compatibility
+    def enable_caching
+      @cache_enabled
+    end
+
+    def enable_caching=(value)
+      @cache_enabled = value
+      @enable_caching = value
+    end
+
+    def cache_duration=(value)
+      @cache_duration = value.respond_to?(:to_i) ? value.to_i : value
+    end
+
+    def cache_duration
+      @cache_duration
+    end
+  end
+
+  class << self
+    attr_accessor :configuration
+  end
+
+  def self.configure
+    self.configuration ||= Configuration.new
+    yield(configuration) if block_given?
+  end
+
+  def self.configuration
+    @configuration ||= Configuration.new
+  end
+end

data/lib/map_view/engine.rb

@@ -0,0 +1,39 @@
+# lib/map_view/engine.rb
+module MapView
+  class Engine < ::Rails::Engine
+    isolate_namespace MapView
+
+    initializer "map_view.static_files" do |app|
+      # Servir archivos de map_cache automáticamente
+      cache_dir = Rails.root.join(MapView.configuration.cache_dir)
+      
+      app.config.middleware.insert_after(
+        Rack::Runtime,
+        Rack::Static,
+        urls: ["/map_cache"],
+        root: cache_dir.to_s
+      )
+    end
+
+    initializer "map_view.helpers" do
+      ActiveSupport.on_load(:action_view) do
+        include MapView::ViewHelper
+      end
+    end
+
+    initializer "map_view.routes" do
+      # Routes are already added by the generator
+      # This ensures the engine routes are loaded
+    end
+  end
+end
+
+
+# lib/map_view/engine.rb
+module MapView
+  class Engine < ::Rails::Engine
+    isolate_namespace MapView
+    
+
+  end
+end

data/lib/map_view/version.rb

@@ -0,0 +1,4 @@
+# lib/map_view/version.rb
+module MapView
+  VERSION = "0.1.0-alpha"
+end

data/lib/map_view/view_helper.rb

@@ -0,0 +1,116 @@
+# lib/map_view/view_helper.rb
+module MapView
+  module ViewHelper
+    # Render a map from GeoJSON file
+    #
+    # @param geojson_path [String] path to GeoJSON file (absolute or relative to Rails.root)
+    # @param options [Hash] map options
+    # @option options [Symbol, Array] :bbox bounding box (:argentina, :world, or [min_lng, min_lat, max_lng, max_lat])
+    # @option options [Integer] :zoom zoom level (default: 10)
+    # @option options [Symbol] :basemap basemap provider (default: :carto_light)
+    # @option options [Integer] :width image width in pixels (default: 800)
+    # @option options [Integer] :height image height in pixels (default: 600)
+    # @option options [String] :style style name (default: "default")
+    # @option options [String] :alt alt text for img tag
+    # @option options [Boolean] :force_render force re-render ignoring cache
+    #
+    # @return [String] HTML img tag
+    #
+    # @example Basic usage
+    #   <%= map_view("data/cities.geojson") %>
+    #
+    # @example With options
+    #   <%= map_view("data/cities.geojson", bbox: :argentina, zoom: 6, width: 600, height: 400) %>
+    #
+    # @example With style
+    #   <%= map_view("data/cities.geojson", style: "dark") %>
+    def map_view(geojson_path, options = {})
+      # Normalize path
+      full_path = geojson_path.start_with?("/") ? geojson_path : Rails.root.join(geojson_path).to_s
+      
+      # Generate cache key
+      cache_key = generate_cache_key(full_path, options)
+      cache_path = Rails.root.join(MapView.configuration.cache_dir, "#{cache_key}.png")
+      
+      # Return cached image if exists and not forcing re-render
+      if File.exist?(cache_path) && !options[:force_render]
+        return tag.img(src: "/map_cache/#{cache_key}.png", alt: options[:alt] || "Map", class: "map-view")
+      end
+      
+      # Build map using libgd-gis
+      bbox = MapView.resolve_bbox(options[:bbox] || MapView.configuration.default_bbox_name)
+      zoom = 4 # options[:zoom] || MapView.configuration.default_zoom
+      basemap = options[:basemap] || MapView.configuration.default_basemap
+      pp zoom
+      map = GD::GIS::Map.new(bbox: bbox, zoom: zoom, basemap: basemap)
+      
+      # Add GeoJSON data
+      map.add_geojson(full_path)
+      
+      # Apply style
+      style_name = options[:style] || MapView.configuration.default_style
+      map.style = load_style(style_name)
+      
+      # Render and save
+      map.render
+      FileUtils.mkdir_p(File.dirname(cache_path))
+      map.save(cache_path.to_s)
+      
+      # Return img tag
+      tag.img(src: "/map_cache/#{cache_key}.png", alt: options[:alt] || "Map", class: "map-view")
+    end
+    
+    # Render a map with a single point
+    #
+    # @param lon [Float] longitude
+    # @param lat [Float] latitude
+    # @param options [Hash] map options (same as map_view)
+    # @option options [String] :label point label
+    #
+    # @example
+    #   <%= map_view_point(-58.3816, -34.6037, label: "Buenos Aires", zoom: 12) %>
+    def map_view_point(lon, lat, options = {})
+      # Create temporary GeoJSON
+      geojson = {
+        type: "FeatureCollection",
+        features: [{
+          type: "Feature",
+          geometry: {
+            type: "Point",
+            coordinates: [lon, lat]
+          },
+          properties: {
+            name: options[:label]
+          }
+        }]
+      }
+      
+      temp_file = write_temp_geojson(geojson)
+      map_view(temp_file.path, options.except(:label))
+    end
+    
+    private
+    
+    def generate_cache_key(path, options)
+      key = { path: path, options: options.except(:force_render, :alt, :class) }
+      Digest::MD5.hexdigest(key.to_s)
+    end
+    
+    def load_style(style_name)
+      style_path = Rails.root.join("config", "map_view", "styles", "#{style_name}.yml")
+      
+      if File.exist?(style_path)
+        GD::GIS::Style.load(style_name, from: Rails.root.join("config", "map_view", "styles"))
+      else
+        GD::GIS::Style.default
+      end
+    end
+    
+    def write_temp_geojson(geojson)
+      temp = Tempfile.new(["map_view", ".geojson"])
+      temp.write(JSON.generate(geojson))
+      temp.rewind
+      temp
+    end
+  end
+end

data/lib/map_view.rb

@@ -0,0 +1,24 @@
+# lib/map_view.rb
+require "map_view/version"
+require "map_view/engine"
+require "map_view/config"
+require "map_view/view_helper"
+
+module MapView
+  class << self
+    # Delegate bbox resolution to libgd-gis
+    def resolve_bbox(bbox_or_name)
+      GD::GIS::BBoxResolver.resolve(bbox_or_name)
+    end
+
+    # Access to all available extent names from libgd-gis
+    def available_extents
+      GD::GIS::Extents.all
+    end
+
+    # Root directory of the gem
+    def root
+      File.expand_path("..", __dir__)
+    end
+  end
+end