geodetic 0.2.0 → 0.3.1

data/lib/geodetic/feature.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Geodetic
+  class Feature
+    attr_accessor :label, :geometry, :metadata
+
+    def initialize(label:, geometry:, metadata: {})
+      @label    = label
+      @geometry = geometry
+      @metadata = metadata
+    end
+
+    def distance_to(other)
+      resolve_point.distance_to(resolve_point_from(other))
+    end
+
+    def bearing_to(other)
+      resolve_point.bearing_to(resolve_point_from(other))
+    end
+
+    def to_s
+      "#{@label} (#{@geometry})"
+    end
+
+    def inspect
+      "#<Geodetic::Feature name=#{@label.inspect} geometry=#{@geometry.inspect} metadata=#{@metadata.inspect}>"
+    end
+
+    private
+
+    def resolve_point
+      @geometry.respond_to?(:centroid) ? @geometry.centroid : @geometry
+    end
+
+    def resolve_point_from(other)
+      case other
+      when Feature
+        other.send(:resolve_point)
+      else
+        other.respond_to?(:centroid) ? other.centroid : other
+      end
+    end
+  end
+end

data/lib/geodetic/geoid_height.rb

@@ -107,14 +107,14 @@ module Geodetic
       raise ArgumentError, "Unknown vertical datum: #{to_datum}" unless to_info
 
       if from_info[:type] == 'orthometric'
-        geoid_model = GeoidHeight.new(geoid_model: from_info[:reference_geoid])
+        geoid_model = GeoidHeight.for(from_info[:reference_geoid])
         ellipsoidal_height = geoid_model.orthometric_to_ellipsoidal(lat, lng, height)
       else
         ellipsoidal_height = height
       end
 
       if to_info[:type] == 'orthometric'
-        geoid_model = GeoidHeight.new(geoid_model: to_info[:reference_geoid])
+        geoid_model = GeoidHeight.for(to_info[:reference_geoid])
         geoid_model.ellipsoidal_to_orthometric(lat, lng, ellipsoidal_height)
       else
         ellipsoidal_height
@@ -175,6 +175,11 @@ module Geodetic
       end
     end
 
+    def self.for(geoid_model = 'EGM2008')
+      @instances ||= {}
+      @instances[geoid_model] ||= new(geoid_model: geoid_model)
+    end
+
     def self.available_models
       GEOID_MODELS.keys
     end
@@ -271,7 +276,7 @@ module Geodetic
     def convert_height_datum(from_datum, to_datum, geoid_model = 'EGM2008')
       return self unless respond_to?(:lat) && respond_to?(:lng) && respond_to?(:alt)
 
-      geoid = GeoidHeight.new(geoid_model: geoid_model)
+      geoid = GeoidHeight.for(geoid_model)
       new_height = geoid.convert_vertical_datum(self.lat, self.lng, self.alt, from_datum, to_datum)
 
       self.class.new(lat: self.lat, lng: self.lng, alt: new_height)
@@ -280,19 +285,19 @@ module Geodetic
     def geoid_height(geoid_model = 'EGM2008')
       return nil unless respond_to?(:lat) && respond_to?(:lng)
 
-      geoid = GeoidHeight.new(geoid_model: geoid_model)
+      geoid = GeoidHeight.for(geoid_model)
       geoid.geoid_height_at(self.lat, self.lng)
     end
 
     def orthometric_height(geoid_model = 'EGM2008')
       return nil unless respond_to?(:alt) && respond_to?(:lat) && respond_to?(:lng)
 
-      geoid = GeoidHeight.new(geoid_model: geoid_model)
+      geoid = GeoidHeight.for(geoid_model)
       geoid.ellipsoidal_to_orthometric(self.lat, self.lng, self.alt)
     end
 
     def self.from_orthometric_height(lat, lng, orthometric_height, geoid_model = 'EGM2008')
-      geoid = GeoidHeight.new(geoid_model: geoid_model)
+      geoid = GeoidHeight.for(geoid_model)
       geoid.orthometric_to_ellipsoidal(lat, lng, orthometric_height)
     end
   end

data/lib/geodetic/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Geodetic
-  VERSION = "0.2.0"
+  VERSION = "0.3.1"
 end

data/lib/geodetic.rb

@@ -7,6 +7,7 @@ require_relative "geodetic/bearing"
 require_relative "geodetic/geoid_height"
 require_relative "geodetic/coordinate"
 require_relative "geodetic/areas"
+require_relative "geodetic/feature"
 
 module Geodetic
   class Error < StandardError; end

data/mkdocs.yml

@@ -136,5 +136,7 @@ nav:
       - Datums: reference/datums.md
       - Geoid Height: reference/geoid-height.md
       - Areas: reference/areas.md
+      - Feature: reference/feature.md
       - Serialization: reference/serialization.md
       - Conversions: reference/conversions.md
+      - Map Rendering: reference/map-rendering.md

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: geodetic
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Dewayne VanHoozer
@@ -9,11 +9,11 @@ bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description: A Ruby gem for converting between 17 geodetic coordinate systems (LLA,
+description: A Ruby gem for converting between 18 geodetic coordinate systems (LLA,
   ECEF, UTM, ENU, NED, MGRS, USNG, Web Mercator, UPS, State Plane, BNG, GH36, GH,
-  HAM, OLC, GEOREF, GARS) with Vincenty great-circle and ECEF Euclidean distance calculations,
-  unit-aware Distance and Bearing classes, geoid height support, and geographic area
-  operations.
+  HAM, OLC, GEOREF, GARS, H3) with Vincenty great-circle and ECEF Euclidean distance
+  calculations, unit-aware Distance and Bearing classes, geoid height support, and
+  geographic area operations.
 email:
 - dewayne@vanhoozer.me
 executables: []
@@ -35,6 +35,7 @@ files:
 - docs/coordinate-systems/georef.md
 - docs/coordinate-systems/gh.md
 - docs/coordinate-systems/gh36.md
+- docs/coordinate-systems/h3.md
 - docs/coordinate-systems/ham.md
 - docs/coordinate-systems/index.md
 - docs/coordinate-systems/lla.md
@@ -52,12 +53,24 @@ files:
 - docs/reference/areas.md
 - docs/reference/conversions.md
 - docs/reference/datums.md
+- docs/reference/feature.md
 - docs/reference/geoid-height.md
+- docs/reference/map-rendering.md
 - docs/reference/serialization.md
 - examples/01_basic_conversions.rb
 - examples/02_all_coordinate_systems.rb
 - examples/03_distance_calculations.rb
 - examples/04_bearing_calculations.rb
+- examples/05_map_rendering/.gitignore
+- examples/05_map_rendering/demo.rb
+- examples/05_map_rendering/icons/bridge.png
+- examples/05_map_rendering/icons/building.png
+- examples/05_map_rendering/icons/landmark.png
+- examples/05_map_rendering/icons/monument.png
+- examples/05_map_rendering/icons/park.png
+- examples/05_map_rendering/nyc_landmarks.png
+- examples/README.md
+- fiddle_pointer_buffer_pool.md
 - lib/geodetic.rb
 - lib/geodetic/areas.rb
 - lib/geodetic/areas/circle.rb
@@ -72,6 +85,7 @@ files:
 - lib/geodetic/coordinate/georef.rb
 - lib/geodetic/coordinate/gh.rb
 - lib/geodetic/coordinate/gh36.rb
+- lib/geodetic/coordinate/h3.rb
 - lib/geodetic/coordinate/ham.rb
 - lib/geodetic/coordinate/lla.rb
 - lib/geodetic/coordinate/mgrs.rb
@@ -85,6 +99,7 @@ files:
 - lib/geodetic/coordinate/web_mercator.rb
 - lib/geodetic/datum.rb
 - lib/geodetic/distance.rb
+- lib/geodetic/feature.rb
 - lib/geodetic/geoid_height.rb
 - lib/geodetic/version.rb
 - mkdocs.yml