geodetic 0.0.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aff287312f66448c5c97edde02c099b6bb6fbfa3e465afe604b744e6c50676dc
-  data.tar.gz: 5800e7ac55fe3d6bd74a1383b21d9b7aae777d2999b42050e12a0b18633aca07
+  metadata.gz: 782ba82d99727dfa9a075fcdfb9dea89f631ebc78e0e105293745c64f77f9dae
+  data.tar.gz: 59e9c844470d77026a9929c8b9ffd01a5d065fd491d8efb67106b0903267c681
 SHA512:
-  metadata.gz: a9f38b3a2587b77592d51549649042f25267929f09c515a5526fb53f5ca3a87a2ec8d665672ed0f90da2642f9ae00f1aa9b31db9bc076374b19ac6ec1f722fcf
-  data.tar.gz: d3ed9287c2fe9d942e387df0d53754f0acdbc497235ac7a72c415be367bd766bb5b814efaefa6568809e68b3f90b3e4f3d059456f203b0bd03b341c94df16a65
+  metadata.gz: 38543deb9e8d62aa20b4a90c9602b0e97806d7d2f55dd9d308a138b9aea2b033e6f51656a9d247ce750d5abcd5298f170825a3f0e4f013a63198bc467e1f3d8c
+  data.tar.gz: fcb62fac876d350bd784d08bb17d45b7c14218a31ff6cfcce4be7e384e3f9a6a2c711ae3731b4a4241e5b34c062a8ddcdc2fb8ce6786ac114ff35d872ad8a7f3

data/CHANGELOG.md

@@ -10,6 +10,60 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+
+## [0.2.0] - 2026-03-08
+
+### Added
+
+- **2 new coordinate systems** bringing the total from 15 to 17:
+  - `Geodetic::Coordinate::GEOREF` — World Geographic Reference System (aviation/military geocode with variable precision from 15-degree tiles to 0.001-minute resolution)
+  - `Geodetic::Coordinate::GARS` — Global Area Reference System (NGA standard with 30-minute cells, 15-minute quadrants, and 5-minute keypads)
+- Full cross-system conversions for GEOREF and GARS — all 17 coordinate systems convert to/from every other system (289 conversion paths)
+- Spatial hash features for GEOREF and GARS: `neighbors`, `to_area`, `precision_in_meters`, `to_slug`, configurable precision
+- Documentation pages: `docs/coordinate-systems/georef.md` and `docs/coordinate-systems/gars.md`
+
+### Changed
+
+- **Namespace renamed**: `Geodetic::Coordinates` is now `Geodetic::Coordinate` (singular)
+- **SpatialHash base class** (`lib/geodetic/coordinate/spatial_hash.rb`) — GH36, GH, HAM, OLC, GEOREF, and GARS now inherit from a shared base class that provides common behavior (neighbors, to_area, precision_in_meters, serialization, encoding/decoding contract)
+- **Auto-generated hash conversions** — `SpatialHash.generate_hash_conversions_for` replaces 232 lines of hand-written boilerplate `to_gh`/`from_gh`/`to_ham`/`from_ham`/etc. methods across 7 coordinate classes
+- **Self-registration** — each coordinate class calls `Coordinate.register_class(self)` at load time; `ALL_COORD_CLASSES` is populated from the registry instead of a manual list
+
+## [0.1.0] - 2026-03-08
+
+### Added
+
+- **4 new coordinate systems** bringing the total from 11 to 15:
+  - `Geodetic::Coordinate::GH36` — Geohash-36 (radix-36 spatial hash, URL-friendly)
+  - `Geodetic::Coordinate::GH` — Geohash base-32 (standard geohash, supported by Elasticsearch, Redis, PostGIS)
+  - `Geodetic::Coordinate::HAM` — Maidenhead Locator System (amateur radio grid squares)
+  - `Geodetic::Coordinate::OLC` — Open Location Code / Plus Codes (Google's location encoding)
+- **Full cross-system conversions** — all 15 coordinate systems convert to/from every other system (225 conversion paths)
+- **Spatial hash features** for GH36, GH, HAM, and OLC:
+  - `neighbors` — returns all 8 adjacent grid cells
+  - `to_area` — returns the cell as a `Geodetic::Areas::Rectangle`
+  - `precision_in_meters` — cell size in meters as `{ lat:, lng: }`
+  - `to_slug` — URL-friendly string representation
+  - Configurable precision on construction
+- **Geographic areas** — `Geodetic::Areas::Circle`, `Geodetic::Areas::Polygon`, and `Geodetic::Areas::Rectangle` for point-in-area testing
+- **Bearing calculations** — universal `bearing_to` and `elevation_to` methods on all coordinate classes via `BearingMethods` mixin
+- **`Geodetic::Bearing` class** — immutable value type with compass directions, reciprocal, radians, arithmetic, and `Comparable`
+- **Validated setters** with type coercion and range validation on all mutable coordinate classes
+- **`to_s(precision)`** on all coordinate classes, `Distance`, and `Bearing` with class-specific defaults
+- **ENU and NED local methods** — `local_bearing_to` and `local_elevation_angle_to` for tangent-plane operations; NED adds `horizontal_distance_to`
+- **GitHub Pages documentation** site with MkDocs
+
+### Changed
+
+- Coordinate classes use `attr_reader` with validated setter methods instead of `attr_accessor`
+- ENU/NED bearing methods renamed: `bearing_to` → `local_bearing_to`, `elevation_angle_to` → `local_elevation_angle_to` (universal `bearing_to`/`elevation_to` now come from the mixin)
+
+### Fixed
+
+- ENU/NED argument mismatch in 8 coordinate classes — `to_enu`/`to_ned` passed extra `datum` arg that `LLA#to_enu`/`LLA#to_ned` does not accept
+- StatePlane `lambert_conformal_conic_to_lla` double `DEG_PER_RAD` conversion producing incorrect results
+- OLC floating-point encoding error — pre-computed `PAIR_RESOLUTIONS` with epsilon correction prevents truncation (e.g., Google HQ encoding "849VCWC8+R9")
+
 ## [0.0.1] - 2026-03-07
 
 Initial update from an old archived project.

data/README.md

@@ -1,23 +1,33 @@
 # Geodetic
 
-A Ruby gem for converting between geodetic coordinate systems. Supports 12 coordinate systems with full bidirectional conversions, plus geoid height calculations and geographic area operations.
-
-## Coordinate Systems
-
-| Class | Description |
-|-------|-------------|
-| `Coordinates::LLA` | Latitude, Longitude, Altitude (degrees/meters) |
-| `Coordinates::ECEF` | Earth-Centered, Earth-Fixed (meters) |
-| `Coordinates::UTM` | Universal Transverse Mercator |
-| `Coordinates::ENU` | East, North, Up (local tangent plane) |
-| `Coordinates::NED` | North, East, Down (local tangent plane) |
-| `Coordinates::MGRS` | Military Grid Reference System |
-| `Coordinates::USNG` | US National Grid |
-| `Coordinates::WebMercator` | Web Mercator / EPSG:3857 |
-| `Coordinates::UPS` | Universal Polar Stereographic |
-| `Coordinates::StatePlane` | US State Plane Coordinate System |
-| `Coordinates::BNG` | British National Grid |
-| `Coordinates::GH36` | Geohash-36 (spatial hash, URL-friendly) |
+> [!INFO]
+> See the [CHANGELOG](CHANGELOG.md) for the latest changes. The [examples directory has runnable demo apps](examples/) that show-off the various capabilities of the Geodetic library.
+
+<br>
+<table>
+<tr>
+<td width="50%" align="center" valign="top">
+<img src="docs/assets/images/geodetic.jpg" alt="Geodetic"><br>
+<em>"Convert coordinates. Map the world."</em>
+</td>
+<td width="50%" valign="top">
+<strong>Key Features</strong><br>
+
+- <strong>17 Coordinate Systems</strong> - LLA, ECEF, UTM, ENU, NED, MGRS, USNG, Web Mercator, UPS, State Plane, BNG, GH36, GH, HAM, OLC, GEOREF, GARS<br>
+- <strong>Full Bidirectional Conversions</strong> - Every system converts to and from every other system<br>
+- <strong>Distance Calculations</strong> - Vincenty great-circle and straight-line with unit tracking<br>
+- <strong>Bearing Calculations</strong> - Forward azimuth, back azimuth, compass directions, elevation angles<br>
+- <strong>Geoid Height Support</strong> - EGM96, EGM2008, GEOID18, GEOID12B models<br>
+- <strong>Geographic Areas</strong> - Circle, Polygon, and Rectangle with point-in-area tests<br>
+- <strong>Validated Setters</strong> - Type coercion and range validation on all coordinate attributes<br>
+- <strong>Serialization</strong> - to_s(precision), to_a, from_string, from_array, DMS format<br>
+- <strong>Multiple Datums</strong> - WGS84, Clarke 1866, GRS 1980, Airy 1830, and more<br>
+- <strong>Immutable Value Types</strong> - Distance and Bearing with arithmetic and comparison
+</td>
+</tr>
+</table>
+
+<p>Geodetic enables precise conversion between geodetic coordinate systems in Ruby. All 17 coordinate systems support complete bidirectional conversions with high precision. Review the <a href="https://madbomber.github.io/geodetic/">full documentation website</a> and explore the <a href="examples/">runnable examples</a>.</p>
 
 ## Installation
 
@@ -53,12 +63,12 @@ ned = Coordinates::NED.new(n: 200.0, e: 100.0, d: -50.0)
 
 ### GCS Shorthand
 
-`GCS` is a top-level alias for `Geodetic::Coordinates`, providing a concise way to create and work with coordinates:
+`GCS` is a top-level alias for `Geodetic::Coordinate`, providing a concise way to create and work with coordinates:
 
 ```ruby
 require "geodetic"
 
-# Use GCS as a shorthand for Geodetic::Coordinates
+# Use GCS as a shorthand for Geodetic::Coordinate
 seattle = GCS::LLA.new(lat: 47.6205, lng: -122.3493, alt: 184.0)
 ecef = GCS::ECEF.new(x: -2304643.57, y: -3638650.07, z: 4688674.43)
 ```
@@ -129,7 +139,7 @@ bng = Coordinates::BNG.new(easting: 530000, northing: 180000)
 bng.easting = 430000               # grid_ref automatically recalculated
 ```
 
-ECEF, ENU, NED, and WebMercator setters coerce to float with no range constraints. MGRS, USNG, GH36, Distance, and Bearing are immutable.
+ECEF, ENU, NED, and WebMercator setters coerce to float with no range constraints. MGRS, USNG, GH36, GH, HAM, OLC, Distance, and Bearing are immutable.
 
 ### DMS (Degrees, Minutes, Seconds)
 
@@ -396,6 +406,90 @@ gh36.precision              # => 10
 gh36.precision_in_meters    # => { lat: 0.31, lng: 0.62 }
 ```
 
+### Geohash (GH)
+
+The standard Geohash (base-32) algorithm by Gustavo Niemeyer, widely supported by Elasticsearch, Redis, PostGIS, and geocoding services:
+
+```ruby
+# From a geohash string
+gh = Coordinates::GH.new("dr5ru7")
+
+# From any coordinate
+gh = Coordinates::GH.new(lla)
+gh = lla.to_gh(precision: 8)
+
+# Decode back to LLA
+lla = gh.to_lla
+
+# URL slug (the hash itself is URL-safe)
+gh.to_slug    # => "dr5ru7"
+
+# Neighbor cells
+gh.neighbors  # => { N: GH, S: GH, E: GH, W: GH, NE: ..., NW: ..., SE: ..., SW: ... }
+
+# Bounding rectangle of the geohash cell
+area = gh.to_area    # => Areas::Rectangle
+area.includes?(gh.to_lla)  # => true
+
+# Precision info
+gh.precision              # => 6
+gh.precision_in_meters    # => { lat: 610.98, lng: 1221.97 }
+```
+
+### Maidenhead Locator (HAM)
+
+The Maidenhead Locator System used worldwide in amateur radio for grid square identification:
+
+```ruby
+# From a Maidenhead locator string
+ham = Coordinates::HAM.new("FN31pr")
+
+# From any coordinate
+ham = Coordinates::HAM.new(lla)
+ham = lla.to_ham(precision: 8)
+
+# Decode back to LLA
+lla = ham.to_lla
+
+# Neighbor cells
+ham.neighbors  # => { N: HAM, S: HAM, E: HAM, W: HAM, NE: ..., NW: ..., SE: ..., SW: ... }
+
+# Bounding rectangle of the grid square
+area = ham.to_area    # => Areas::Rectangle
+area.includes?(ham.to_lla)  # => true
+
+# Precision info
+ham.precision              # => 6
+ham.precision_in_meters    # => { lat: 4631.0, lng: 9260.0 }
+```
+
+### Open Location Code / Plus Codes (OLC)
+
+Google's open system for encoding locations into short, URL-friendly codes:
+
+```ruby
+# From a plus code string
+olc = Coordinates::OLC.new("849VCWC8+R9")
+
+# From any coordinate
+olc = Coordinates::OLC.new(lla)
+olc = lla.to_olc(precision: 11)
+
+# Decode back to LLA
+lla = olc.to_lla
+
+# Neighbor cells
+olc.neighbors  # => { N: OLC, S: OLC, E: OLC, W: OLC, NE: ..., NW: ..., SE: ..., SW: ... }
+
+# Bounding rectangle of the plus code cell
+area = olc.to_area    # => Areas::Rectangle
+area.includes?(olc.to_lla)  # => true
+
+# Precision info
+olc.precision              # => 10
+olc.precision_in_meters    # => { lat: 13.9, lng: 13.9 }
+```
+
 ### Geographic Areas
 
 ```ruby
@@ -448,7 +542,7 @@ The [`examples/`](examples/) directory contains runnable demo scripts showing pr
 | Script | Description |
 |--------|-------------|
 | [`01_basic_conversions.rb`](examples/01_basic_conversions.rb) | LLA, ECEF, UTM, ENU, NED conversions and roundtrips |
-| [`02_all_coordinate_systems.rb`](examples/02_all_coordinate_systems.rb) | All 12 coordinate systems, cross-system chains, and areas |
+| [`02_all_coordinate_systems.rb`](examples/02_all_coordinate_systems.rb) | All 17 coordinate systems, cross-system chains, and areas |
 | [`03_distance_calculations.rb`](examples/03_distance_calculations.rb) | Distance class features, unit conversions, and arithmetic |
 | [`04_bearing_calculations.rb`](examples/04_bearing_calculations.rb) | Bearing class, compass directions, elevation angles, and chain bearings |
 
@@ -460,6 +554,8 @@ ruby -Ilib examples/01_basic_conversions.rb
 
 ## Development
 
+For comprehensive guides and API documentation, visit **[https://madbomber.github.io/geodetic](https://madbomber.github.io/geodetic)**
+
 ```bash
 bin/setup          # Install dependencies
 rake test          # Run tests

data/docs/coordinate-systems/bng.md

@@ -1,4 +1,4 @@
-# Geodetic::Coordinates::BNG
+# Geodetic::Coordinate::BNG
 
 ## British National Grid
 
@@ -9,13 +9,13 @@ The British National Grid (BNG) is the official coordinate system for Great Brit
 Create a BNG coordinate from numeric easting/northing values:
 
 ```ruby
-point = Geodetic::Coordinates::BNG.new(easting: 530000.0, northing: 180000.0)
+point = Geodetic::Coordinate::BNG.new(easting: 530000.0, northing: 180000.0)
 ```
 
 Alternatively, create from an alphanumeric grid reference string:
 
 ```ruby
-point = Geodetic::Coordinates::BNG.new(grid_ref: "TQ 300000 800000")
+point = Geodetic::Coordinate::BNG.new(grid_ref: "TQ 300000 800000")
 ```
 
 ## Grid References
@@ -52,8 +52,8 @@ point.valid?  # => true if within Great Britain bounds
 The universal `distance_to` method computes the Vincenty great-circle distance to any other coordinate type, returning a `Distance` object. The `straight_line_distance_to` method computes the Euclidean distance in ECEF space. The universal `bearing_to` method computes the great-circle forward azimuth, returning a `Bearing` object. All accept single or multiple targets.
 
 ```ruby
-bng_a = Geodetic::Coordinates::BNG.new(easting: 530000.0, northing: 180000.0)
-bng_b = Geodetic::Coordinates::BNG.new(easting: 540000.0, northing: 190000.0)
+bng_a = Geodetic::Coordinate::BNG.new(easting: 530000.0, northing: 180000.0)
+bng_b = Geodetic::Coordinate::BNG.new(easting: 540000.0, northing: 190000.0)
 bng_a.distance_to(bng_b)                # => Distance (great-circle)
 bng_a.straight_line_distance_to(bng_b)  # => Distance (Euclidean)
 bng_a.bearing_to(bng_b)                 # => Bearing (great-circle forward azimuth)

data/docs/coordinate-systems/ecef.md

@@ -1,4 +1,4 @@
-# Geodetic::Coordinates::ECEF
+# Geodetic::Coordinate::ECEF
 
 Earth-Centered, Earth-Fixed -- a Cartesian coordinate system with its origin at the center of mass of the Earth. The X axis points toward the intersection of the Prime Meridian and the Equator, the Y axis points toward 90 degrees East longitude on the Equator, and the Z axis points toward the North Pole. All values are in meters.
 
@@ -7,7 +7,7 @@ ECEF is useful for satellite positioning, radar tracking, and any application re
 ## Constructor
 
 ```ruby
-Geodetic::Coordinates::ECEF.new(x: 0.0, y: 0.0, z: 0.0)
+Geodetic::Coordinate::ECEF.new(x: 0.0, y: 0.0, z: 0.0)
 ```
 
 | Parameter | Type  | Default | Description                     |
@@ -35,9 +35,9 @@ All conversion methods accept an optional `datum` parameter (defaults to `Geodet
 Converts to geodetic Latitude, Longitude, Altitude coordinates using an iterative algorithm. The iteration converges when both latitude and altitude changes are below `1e-12`, with a maximum of 100 iterations.
 
 ```ruby
-ecef = Geodetic::Coordinates::ECEF.new(x: 1130730.0, y: -4828583.0, z: 3991570.0)
+ecef = Geodetic::Coordinate::ECEF.new(x: 1130730.0, y: -4828583.0, z: 3991570.0)
 lla = ecef.to_lla
-# => Geodetic::Coordinates::LLA
+# => Geodetic::Coordinate::LLA
 ```
 
 ### ECEF.from_lla(lla, datum = WGS84)
@@ -45,7 +45,7 @@ lla = ecef.to_lla
 Creates an ECEF from an LLA instance. Raises `ArgumentError` if the argument is not an `LLA`.
 
 ```ruby
-ecef = Geodetic::Coordinates::ECEF.from_lla(lla)
+ecef = Geodetic::Coordinate::ECEF.from_lla(lla)
 ```
 
 ### to_utm(datum = WGS84)
@@ -54,7 +54,7 @@ Converts to Universal Transverse Mercator coordinates. Internally converts to LL
 
 ```ruby
 utm = ecef.to_utm
-# => Geodetic::Coordinates::UTM
+# => Geodetic::Coordinate::UTM
 ```
 
 ### ECEF.from_utm(utm, datum = WGS84)
@@ -66,10 +66,10 @@ Creates an ECEF from a UTM instance. Raises `ArgumentError` if the argument is n
 Converts to East-North-Up local tangent plane coordinates relative to a reference ECEF position. If `reference_lla` is not provided, it is computed from `reference_ecef` via `to_lla`.
 
 ```ruby
-ref_ecef = Geodetic::Coordinates::ECEF.new(x: 1130730.0, y: -4828583.0, z: 3991570.0)
-point_ecef = Geodetic::Coordinates::ECEF.new(x: 1130740.0, y: -4828573.0, z: 3991580.0)
+ref_ecef = Geodetic::Coordinate::ECEF.new(x: 1130730.0, y: -4828583.0, z: 3991570.0)
+point_ecef = Geodetic::Coordinate::ECEF.new(x: 1130740.0, y: -4828573.0, z: 3991580.0)
 enu = point_ecef.to_enu(ref_ecef)
-# => Geodetic::Coordinates::ENU
+# => Geodetic::Coordinate::ENU
 ```
 
 Raises `ArgumentError` if `reference_ecef` is not an `ECEF`.
@@ -84,7 +84,7 @@ Converts to North-East-Down local tangent plane coordinates. Internally converts
 
 ```ruby
 ned = point_ecef.to_ned(ref_ecef)
-# => Geodetic::Coordinates::NED
+# => Geodetic::Coordinate::NED
 ```
 
 ### ECEF.from_ned(ned, reference_ecef, reference_lla = nil)
@@ -98,7 +98,7 @@ Creates an ECEF from a NED instance and a reference ECEF origin. Raises `Argumen
 Returns a comma-separated string of `x, y, z`.
 
 ```ruby
-ecef = Geodetic::Coordinates::ECEF.new(x: 1130730.0, y: -4828583.0, z: 3991570.0)
+ecef = Geodetic::Coordinate::ECEF.new(x: 1130730.0, y: -4828583.0, z: 3991570.0)
 ecef.to_s
 # => "1130730.0, -4828583.0, 3991570.0"
 ```
@@ -117,7 +117,7 @@ ecef.to_a
 Parses a comma-separated string into an ECEF.
 
 ```ruby
-ecef = Geodetic::Coordinates::ECEF.from_string("1130730.0, -4828583.0, 3991570.0")
+ecef = Geodetic::Coordinate::ECEF.from_string("1130730.0, -4828583.0, 3991570.0")
 ```
 
 ### ECEF.from_array(array)
@@ -125,7 +125,7 @@ ecef = Geodetic::Coordinates::ECEF.from_string("1130730.0, -4828583.0, 3991570.0
 Creates an ECEF from a three-element array `[x, y, z]`.
 
 ```ruby
-ecef = Geodetic::Coordinates::ECEF.from_array([1130730.0, -4828583.0, 3991570.0])
+ecef = Geodetic::Coordinate::ECEF.from_array([1130730.0, -4828583.0, 3991570.0])
 ```
 
 ## Additional Methods
@@ -135,8 +135,8 @@ ecef = Geodetic::Coordinates::ECEF.from_array([1130730.0, -4828583.0, 3991570.0]
 Compares two ECEF instances for approximate equality. Returns `true` if the absolute difference for each of `x`, `y`, and `z` is `<= 1e-6` meters. Returns `false` if `other` is not an `ECEF`.
 
 ```ruby
-a = Geodetic::Coordinates::ECEF.new(x: 1130730.0, y: -4828583.0, z: 3991570.0)
-b = Geodetic::Coordinates::ECEF.new(x: 1130730.0, y: -4828583.0, z: 3991570.0)
+a = Geodetic::Coordinate::ECEF.new(x: 1130730.0, y: -4828583.0, z: 3991570.0)
+b = Geodetic::Coordinate::ECEF.new(x: 1130730.0, y: -4828583.0, z: 3991570.0)
 a == b
 # => true
 ```
@@ -146,8 +146,8 @@ a == b
 Computes the Vincenty great-circle distance to one or more other coordinates. Accepts any coordinate type (coordinates are converted to LLA internally). Returns a `Distance` for a single target or an Array of `Distance` objects for multiple targets (radial distances from the receiver).
 
 ```ruby
-a = Geodetic::Coordinates::ECEF.new(x: 1130730.0, y: -4828583.0, z: 3991570.0)
-b = Geodetic::Coordinates::ECEF.new(x: 1130740.0, y: -4828573.0, z: 3991580.0)
+a = Geodetic::Coordinate::ECEF.new(x: 1130730.0, y: -4828583.0, z: 3991570.0)
+b = Geodetic::Coordinate::ECEF.new(x: 1130740.0, y: -4828573.0, z: 3991580.0)
 a.distance_to(b)
 # => Distance (meters, great-circle distance)
 ```
@@ -169,7 +169,7 @@ a.straight_line_distance_to(b)
 require 'geodetic'
 
 # Create an ECEF coordinate
-ecef = Geodetic::Coordinates::ECEF.new(x: 1130730.0, y: -4828583.0, z: 3991570.0)
+ecef = Geodetic::Coordinate::ECEF.new(x: 1130730.0, y: -4828583.0, z: 3991570.0)
 
 # Convert to LLA and back
 lla = ecef.to_lla
@@ -181,8 +181,8 @@ ecef == ecef_roundtrip
 ### Distance between two points
 
 ```ruby
-station_a = Geodetic::Coordinates::ECEF.new(x: 1130730.0, y: -4828583.0, z: 3991570.0)
-station_b = Geodetic::Coordinates::ECEF.new(x: 1131000.0, y: -4828300.0, z: 3991800.0)
+station_a = Geodetic::Coordinate::ECEF.new(x: 1130730.0, y: -4828583.0, z: 3991570.0)
+station_b = Geodetic::Coordinate::ECEF.new(x: 1131000.0, y: -4828300.0, z: 3991800.0)
 
 # Great-circle distance (Vincenty)
 distance = station_a.distance_to(station_b)
@@ -196,8 +196,8 @@ puts "Straight-line distance: #{straight.meters} meters"
 ### Local tangent plane from ECEF
 
 ```ruby
-origin = Geodetic::Coordinates::ECEF.new(x: 1130730.0, y: -4828583.0, z: 3991570.0)
-target = Geodetic::Coordinates::ECEF.new(x: 1130740.0, y: -4828573.0, z: 3991580.0)
+origin = Geodetic::Coordinate::ECEF.new(x: 1130730.0, y: -4828583.0, z: 3991570.0)
+target = Geodetic::Coordinate::ECEF.new(x: 1130740.0, y: -4828573.0, z: 3991580.0)
 
 # Provide reference LLA to avoid recomputing it
 ref_lla = origin.to_lla
@@ -210,6 +210,6 @@ ned = target.to_ned(origin, ref_lla)
 
 ```ruby
 clarke66 = Geodetic::Datum.new(name: 'CLARKE_1866')
-ecef = Geodetic::Coordinates::ECEF.new(x: 1130730.0, y: -4828583.0, z: 3991570.0)
+ecef = Geodetic::Coordinate::ECEF.new(x: 1130730.0, y: -4828583.0, z: 3991570.0)
 lla = ecef.to_lla(clarke66)
 ```

data/docs/coordinate-systems/enu.md

@@ -1,4 +1,4 @@
-# Geodetic::Coordinates::ENU - East, North, Up
+# Geodetic::Coordinate::ENU - East, North, Up
 
 ## Overview
 
@@ -52,7 +52,7 @@ The one exception is the conversion between ENU and NED, which does not require
 ENU is a relative coordinate system. The universal `distance_to`, `straight_line_distance_to`, `bearing_to`, and `elevation_to` methods raise `ArgumentError` because ENU cannot be converted to an absolute system without a reference point. Convert to an absolute system first:
 
 ```ruby
-ref = Geodetic::Coordinates::LLA.new(lat: 47.62, lng: -122.35, alt: 0.0)
+ref = Geodetic::Coordinate::LLA.new(lat: 47.62, lng: -122.35, alt: 0.0)
 lla = enu.to_lla(ref)
 lla.distance_to(other_lla)   # Vincenty great-circle distance
 lla.bearing_to(other_lla)    # Great-circle forward azimuth (Bearing object)
@@ -65,7 +65,7 @@ Bearing is measured in **degrees from north**, clockwise, in the range **0-360**
 ## Example
 
 ```ruby
-point = Geodetic::Coordinates::ENU.new(e: 100.0, n: 200.0, u: 50.0)
+point = Geodetic::Coordinate::ENU.new(e: 100.0, n: 200.0, u: 50.0)
 
 point.east   # => 100.0
 point.north  # => 200.0