geodetic 0.1.0 → 0.3.0

data/docs/coordinate-systems/web-mercator.md

@@ -1,4 +1,4 @@
-# Geodetic::Coordinates::WebMercator
+# Geodetic::Coordinate::WebMercator
 
 ## Web Mercator (EPSG:3857)
 
@@ -7,7 +7,7 @@ Web Mercator is the de facto standard projection used by major web mapping platf
 ## Constructor
 
 ```ruby
-point = Geodetic::Coordinates::WebMercator.new(x: 0.0, y: 0.0)
+point = Geodetic::Coordinate::WebMercator.new(x: 0.0, y: 0.0)
 ```
 
 Parameters `x` and `y` are specified in **meters** from the projection origin (the intersection of the Equator and the Prime Meridian).
@@ -27,7 +27,7 @@ Convert between Web Mercator coordinates and map tile indices at a given zoom le
 ```ruby
 tile_x, tile_y = point.to_tile_coordinates(zoom)
 
-point = Geodetic::Coordinates::WebMercator.from_tile_coordinates(x, y, zoom)
+point = Geodetic::Coordinate::WebMercator.from_tile_coordinates(x, y, zoom)
 ```
 
 ## Pixel Coordinate Methods
@@ -37,7 +37,7 @@ Convert between Web Mercator coordinates and pixel positions at a given zoom lev
 ```ruby
 pixel_x, pixel_y = point.to_pixel_coordinates(zoom, tile_size)
 
-point = Geodetic::Coordinates::WebMercator.from_pixel_coordinates(x, y, zoom, tile_size)
+point = Geodetic::Coordinate::WebMercator.from_pixel_coordinates(x, y, zoom, tile_size)
 ```
 
 ## Tile Bounds
@@ -45,7 +45,7 @@ point = Geodetic::Coordinates::WebMercator.from_pixel_coordinates(x, y, zoom, ti
 Retrieve the bounding box of a specific tile.
 
 ```ruby
-bounds = Geodetic::Coordinates::WebMercator.tile_bounds(tile_x, tile_y, zoom)
+bounds = Geodetic::Coordinate::WebMercator.tile_bounds(tile_x, tile_y, zoom)
 ```
 
 ## Validation and Utility Methods
@@ -60,8 +60,8 @@ bounds = Geodetic::Coordinates::WebMercator.tile_bounds(tile_x, tile_y, zoom)
 The universal `distance_to` method computes the Vincenty great-circle distance (in meters) to any other coordinate type. The `straight_line_distance_to` method computes the Euclidean distance in ECEF space. Both accept single or multiple targets.
 
 ```ruby
-wm_a = Geodetic::Coordinates::WebMercator.new(x: -13627665.0, y: 6044499.0)
-wm_b = Geodetic::Coordinates::WebMercator.new(x: -13631157.0, y: 5694043.0)
+wm_a = Geodetic::Coordinate::WebMercator.new(x: -13627665.0, y: 6044499.0)
+wm_b = Geodetic::Coordinate::WebMercator.new(x: -13631157.0, y: 5694043.0)
 wm_a.distance_to(wm_b)                # => Distance (meters, great-circle)
 wm_a.straight_line_distance_to(wm_b)  # => Distance (meters, Euclidean)
 ```

data/docs/getting-started/installation.md

@@ -38,21 +38,21 @@ If you want to use a coordinate class directly without going through a conversio
 
 ```ruby
 require "geodetic"
-require "geodetic/coordinates/lla"
-require "geodetic/coordinates/ecef"
-require "geodetic/coordinates/utm"
-require "geodetic/coordinates/enu"
-require "geodetic/coordinates/ned"
-require "geodetic/coordinates/mgrs"
-require "geodetic/coordinates/usng"
-require "geodetic/coordinates/web_mercator"
-require "geodetic/coordinates/ups"
-require "geodetic/coordinates/state_plane"
-require "geodetic/coordinates/bng"
-require "geodetic/coordinates/gh36"
-require "geodetic/coordinates/gh"
-require "geodetic/coordinates/ham"
-require "geodetic/coordinates/olc"
+require "geodetic/coordinate/lla"
+require "geodetic/coordinate/ecef"
+require "geodetic/coordinate/utm"
+require "geodetic/coordinate/enu"
+require "geodetic/coordinate/ned"
+require "geodetic/coordinate/mgrs"
+require "geodetic/coordinate/usng"
+require "geodetic/coordinate/web_mercator"
+require "geodetic/coordinate/ups"
+require "geodetic/coordinate/state_plane"
+require "geodetic/coordinate/bng"
+require "geodetic/coordinate/gh36"
+require "geodetic/coordinate/gh"
+require "geodetic/coordinate/ham"
+require "geodetic/coordinate/olc"
 ```
 
 You only need to require the types you plan to construct directly. Conversion methods handle their own requires internally.
@@ -61,9 +61,9 @@ You only need to require the types you plan to construct directly. Conversion me
 
 ```ruby
 require "geodetic"
-require "geodetic/coordinates/lla"
+require "geodetic/coordinate/lla"
 
-lla = Geodetic::Coordinates::LLA.new(lat: 47.6205, lng: -122.3493, alt: 184.0)
+lla = Geodetic::Coordinate::LLA.new(lat: 47.6205, lng: -122.3493, alt: 184.0)
 puts lla.to_s
 #=> "47.6205, -122.3493, 184.0"
 ```

data/docs/getting-started/quick-start.md

@@ -8,9 +8,9 @@ LLA (Latitude, Longitude, Altitude) is the most common starting point. All const
 
 ```ruby
 require "geodetic"
-require "geodetic/coordinates/lla"
+require "geodetic/coordinate/lla"
 
-space_needle = Geodetic::Coordinates::LLA.new(
+space_needle = Geodetic::Coordinate::LLA.new(
   lat: 47.6205,
   lng: -122.3493,
   alt: 184.0
@@ -60,7 +60,7 @@ Local tangent plane coordinate systems require a reference point. ENU (East, Nor
 
 ```ruby
 # Define a reference point (e.g., a nearby base station)
-reference = Geodetic::Coordinates::LLA.new(
+reference = Geodetic::Coordinate::LLA.new(
   lat: 47.6062,
   lng: -122.3321,
   alt: 0.0
@@ -98,7 +98,7 @@ dms = space_needle.to_dms
 puts dms  #=> "47° 37' 13.80\" N, 122° 20' 57.48\" W, 184.00 m"
 
 # Parse a DMS string back to LLA
-lla = Geodetic::Coordinates::LLA.from_dms("47° 37' 13.80\" N, 122° 20' 57.48\" W, 184.00 m")
+lla = Geodetic::Coordinate::LLA.from_dms("47° 37' 13.80\" N, 122° 20' 57.48\" W, 184.00 m")
 puts lla.lat  #=> 47.6205
 ```
 
@@ -112,15 +112,15 @@ str = space_needle.to_s    #=> "47.6205, -122.3493, 184.0"
 arr = space_needle.to_a    #=> [47.6205, -122.3493, 184.0]
 
 # Deserialize
-lla_from_str = Geodetic::Coordinates::LLA.from_string(str)
-lla_from_arr = Geodetic::Coordinates::LLA.from_array(arr)
+lla_from_str = Geodetic::Coordinate::LLA.from_string(str)
+lla_from_arr = Geodetic::Coordinate::LLA.from_array(arr)
 
 # Works the same for all coordinate types
 ecef = space_needle.to_ecef
 ecef_str = ecef.to_s
 ecef_arr = ecef.to_a
-ecef_restored = Geodetic::Coordinates::ECEF.from_string(ecef_str)
-ecef_restored = Geodetic::Coordinates::ECEF.from_array(ecef_arr)
+ecef_restored = Geodetic::Coordinate::ECEF.from_string(ecef_str)
+ecef_restored = Geodetic::Coordinate::ECEF.from_array(ecef_arr)
 ```
 
 ## 7. Work with Datums

data/docs/index.md

@@ -9,7 +9,7 @@
 <td width="50%" valign="top">
 <h2>Key Features</h2>
 <lu>
-<li><strong>15 Coordinate Systems</strong> - LLA, ECEF, UTM, ENU, NED, MGRS, USNG, Web Mercator, UPS, State Plane, BNG, GH36, GH, HAM, OLC<br>
+<li><strong>18 Coordinate Systems</strong> - LLA, ECEF, UTM, ENU, NED, MGRS, USNG, Web Mercator, UPS, State Plane, BNG, GH36, GH, HAM, OLC<br>
 <li><strong>Full Bidirectional Conversions</strong> - Every system converts to and from every other system<br>
 <li><strong>Distance Calculations</strong> - Vincenty great-circle and straight-line with unit tracking<br>
 <li><strong>Bearing Calculations</strong> - Forward azimuth, back azimuth, compass directions, elevation angles<br>
@@ -24,29 +24,32 @@
 </tr>
 </table>
 
-Geodetic is a Ruby gem for converting between geodetic coordinate systems. It provides a clean, consistent API for working with 15 coordinate systems, 16 geodetic datums, geoid height calculations, and geographic area computations.
+Geodetic is a Ruby gem for converting between geodetic coordinate systems. It provides a clean, consistent API for working with 18 coordinate systems, 16 geodetic datums, geoid height calculations, and geographic area computations.
 
 ## Coordinate Systems
 
-Geodetic supports full bidirectional conversion between all 15 coordinate systems:
+Geodetic supports full bidirectional conversion between all 18 coordinate systems:
 
 | System | Class | Description |
 |--------|-------|-------------|
-| **LLA** | `Geodetic::Coordinates::LLA` | Latitude, Longitude, Altitude |
-| **ECEF** | `Geodetic::Coordinates::ECEF` | Earth-Centered, Earth-Fixed (X, Y, Z) |
-| **UTM** | `Geodetic::Coordinates::UTM` | Universal Transverse Mercator |
-| **ENU** | `Geodetic::Coordinates::ENU` | East, North, Up (local tangent plane) |
-| **NED** | `Geodetic::Coordinates::NED` | North, East, Down (local tangent plane) |
-| **MGRS** | `Geodetic::Coordinates::MGRS` | Military Grid Reference System |
-| **USNG** | `Geodetic::Coordinates::USNG` | United States National Grid |
-| **WebMercator** | `Geodetic::Coordinates::WebMercator` | Web Mercator projection (EPSG:3857) |
-| **UPS** | `Geodetic::Coordinates::UPS` | Universal Polar Stereographic |
-| **StatePlane** | `Geodetic::Coordinates::StatePlane` | State Plane Coordinate System |
-| **BNG** | `Geodetic::Coordinates::BNG` | British National Grid |
-| **GH36** | `Geodetic::Coordinates::GH36` | Geohash-36 (spatial hash, URL-friendly) |
-| **GH** | `Geodetic::Coordinates::GH` | Geohash base-32 (standard geohash, widely supported) |
-| **HAM** | `Geodetic::Coordinates::HAM` | Maidenhead Locator System (amateur radio grid squares) |
-| **OLC** | `Geodetic::Coordinates::OLC` | Open Location Code / Plus Codes (Google's location encoding) |
+| **LLA** | `Geodetic::Coordinate::LLA` | Latitude, Longitude, Altitude |
+| **ECEF** | `Geodetic::Coordinate::ECEF` | Earth-Centered, Earth-Fixed (X, Y, Z) |
+| **UTM** | `Geodetic::Coordinate::UTM` | Universal Transverse Mercator |
+| **ENU** | `Geodetic::Coordinate::ENU` | East, North, Up (local tangent plane) |
+| **NED** | `Geodetic::Coordinate::NED` | North, East, Down (local tangent plane) |
+| **MGRS** | `Geodetic::Coordinate::MGRS` | Military Grid Reference System |
+| **USNG** | `Geodetic::Coordinate::USNG` | United States National Grid |
+| **WebMercator** | `Geodetic::Coordinate::WebMercator` | Web Mercator projection (EPSG:3857) |
+| **UPS** | `Geodetic::Coordinate::UPS` | Universal Polar Stereographic |
+| **StatePlane** | `Geodetic::Coordinate::StatePlane` | State Plane Coordinate System |
+| **BNG** | `Geodetic::Coordinate::BNG` | British National Grid |
+| **GH36** | `Geodetic::Coordinate::GH36` | Geohash-36 (spatial hash, URL-friendly) |
+| **GH** | `Geodetic::Coordinate::GH` | Geohash base-32 (standard geohash, widely supported) |
+| **HAM** | `Geodetic::Coordinate::HAM` | Maidenhead Locator System (amateur radio grid squares) |
+| **OLC** | `Geodetic::Coordinate::OLC` | Open Location Code / Plus Codes (Google's location encoding) |
+| **GEOREF** | `Geodetic::Coordinate::GEOREF` | World Geographic Reference System (aviation/military) |
+| **GARS** | `Geodetic::Coordinate::GARS` | Global Area Reference System (NGA standard) |
+| **H3** | `Geodetic::Coordinate::H3` | Uber's hexagonal hierarchical index (requires `libh3`) |
 
 ## Additional Features
 
@@ -66,7 +69,7 @@ Geodetic supports full bidirectional conversion between all 15 coordinate system
 require "geodetic"
 
 # Create an LLA coordinate (Seattle Space Needle)
-lla = Geodetic::Coordinates::LLA.new(lat: 47.6205, lng: -122.3493, alt: 184.0)
+lla = Geodetic::Coordinate::LLA.new(lat: 47.6205, lng: -122.3493, alt: 184.0)
 
 # Convert to ECEF
 ecef = lla.to_ecef

data/docs/reference/areas.md

@@ -1,6 +1,6 @@
 # Areas Reference
 
-The `Geodetic::Areas` module provides three geometric area classes for point-in-area testing: `Circle`, `Polygon`, and `Rectangle`. All operate on `Geodetic::Coordinates::LLA` points.
+The `Geodetic::Areas` module provides three geometric area classes for point-in-area testing: `Circle`, `Polygon`, and `Rectangle`. All operate on `Geodetic::Coordinate::LLA` points.
 
 ---
 
@@ -11,7 +11,7 @@ Defines a circular area on the Earth's surface.
 ### Constructor
 
 ```ruby
-center = Geodetic::Coordinates::LLA.new(lat: 38.8977, lng: -77.0365, alt: 0.0)
+center = Geodetic::Coordinate::LLA.new(lat: 38.8977, lng: -77.0365, alt: 0.0)
 
 circle = Geodetic::Areas::Circle.new(
   centroid: center,   # LLA point at the center
@@ -33,7 +33,7 @@ circle = Geodetic::Areas::Circle.new(
 Returns `true` if the given LLA point falls within (or on the boundary of) the circle. The distance from centroid to the point is compared against the radius.
 
 ```ruby
-point = Geodetic::Coordinates::LLA.new(lat: 38.898, lng: -77.036, alt: 0.0)
+point = Geodetic::Coordinate::LLA.new(lat: 38.898, lng: -77.036, alt: 0.0)
 circle.includes?(point)  # => true or false
 ```
 
@@ -62,10 +62,10 @@ Defines an arbitrary polygon area on the Earth's surface.
 
 ```ruby
 boundary = [
-  Geodetic::Coordinates::LLA.new(lat: 38.90, lng: -77.04, alt: 0.0),
-  Geodetic::Coordinates::LLA.new(lat: 38.90, lng: -77.03, alt: 0.0),
-  Geodetic::Coordinates::LLA.new(lat: 38.89, lng: -77.03, alt: 0.0),
-  Geodetic::Coordinates::LLA.new(lat: 38.89, lng: -77.04, alt: 0.0)
+  Geodetic::Coordinate::LLA.new(lat: 38.90, lng: -77.04, alt: 0.0),
+  Geodetic::Coordinate::LLA.new(lat: 38.90, lng: -77.03, alt: 0.0),
+  Geodetic::Coordinate::LLA.new(lat: 38.89, lng: -77.03, alt: 0.0),
+  Geodetic::Coordinate::LLA.new(lat: 38.89, lng: -77.04, alt: 0.0)
 ]
 
 polygon = Geodetic::Areas::Polygon.new(boundary: boundary)
@@ -95,7 +95,7 @@ Returns `true` if the given LLA point falls within the polygon. Uses the winding
 Also returns `true` if the point is exactly equal to any boundary vertex.
 
 ```ruby
-point = Geodetic::Coordinates::LLA.new(lat: 38.895, lng: -77.035, alt: 0.0)
+point = Geodetic::Coordinate::LLA.new(lat: 38.895, lng: -77.035, alt: 0.0)
 polygon.includes?(point)  # => true or false
 ```
 
@@ -123,8 +123,8 @@ Defines an axis-aligned rectangle by its northwest and southeast corners.
 ### Constructor
 
 ```ruby
-nw = Geodetic::Coordinates::LLA.new(lat: 41.0, lng: -75.0)
-se = Geodetic::Coordinates::LLA.new(lat: 40.0, lng: -74.0)
+nw = Geodetic::Coordinate::LLA.new(lat: 41.0, lng: -75.0)
+se = Geodetic::Coordinate::LLA.new(lat: 40.0, lng: -74.0)
 
 rectangle = Geodetic::Areas::Rectangle.new(nw: nw, se: se)
 ```
@@ -132,8 +132,8 @@ rectangle = Geodetic::Areas::Rectangle.new(nw: nw, se: se)
 The constructor accepts any coordinate type that responds to `to_lla` -- coordinates are automatically converted to LLA.
 
 ```ruby
-nw_wm = Geodetic::Coordinates::WebMercator.from_lla(nw)
-se_wm = Geodetic::Coordinates::WebMercator.from_lla(se)
+nw_wm = Geodetic::Coordinate::WebMercator.from_lla(nw)
+se_wm = Geodetic::Coordinate::WebMercator.from_lla(se)
 rectangle = Geodetic::Areas::Rectangle.new(nw: nw_wm, se: se_wm)
 ```
 
@@ -163,7 +163,7 @@ rectangle.sw    # => LLA (se.lat, nw.lng)
 Returns `true` if the given point falls within (or on the boundary of) the rectangle. Accepts any coordinate type that responds to `to_lla`.
 
 ```ruby
-point = Geodetic::Coordinates::LLA.new(lat: 40.5, lng: -74.5)
+point = Geodetic::Coordinate::LLA.new(lat: 40.5, lng: -74.5)
 rectangle.includes?(point)  # => true
 ```
 
@@ -184,10 +184,10 @@ rectangle.excludes?(point)  # => true or false
 
 ### Integration with GH36
 
-`Geodetic::Coordinates::GH36#to_area` returns a `Rectangle` representing the geohash cell's bounding box:
+`Geodetic::Coordinate::GH36#to_area` returns a `Rectangle` representing the geohash cell's bounding box:
 
 ```ruby
-gh36 = Geodetic::Coordinates::GH36.new("bdrdC26BqH")
+gh36 = Geodetic::Coordinate::GH36.new("bdrdC26BqH")
 area = gh36.to_area
 # => Geodetic::Areas::Rectangle
 

data/docs/reference/conversions.md

@@ -34,11 +34,11 @@ TargetClass.from_<source>(source_object, datum = WGS84)
 Examples:
 
 ```ruby
-Geodetic::Coordinates::ECEF.from_lla(lla)
-Geodetic::Coordinates::LLA.from_ecef(ecef)
-Geodetic::Coordinates::UTM.from_lla(lla)
-Geodetic::Coordinates::LLA.from_utm(utm)
-Geodetic::Coordinates::WebMercator.from_ecef(ecef)
+Geodetic::Coordinate::ECEF.from_lla(lla)
+Geodetic::Coordinate::LLA.from_ecef(ecef)
+Geodetic::Coordinate::UTM.from_lla(lla)
+Geodetic::Coordinate::LLA.from_utm(utm)
+Geodetic::Coordinate::WebMercator.from_ecef(ecef)
 ```
 
 ---
@@ -50,7 +50,7 @@ ENU and NED are local tangent plane systems that require a **reference LLA** poi
 ### Instance Methods
 
 ```ruby
-ref = Geodetic::Coordinates::LLA.new(lat: 38.8977, lng: -77.0365, alt: 0.0)
+ref = Geodetic::Coordinate::LLA.new(lat: 38.8977, lng: -77.0365, alt: 0.0)
 
 # LLA to local
 lla.to_enu(ref)
@@ -80,24 +80,24 @@ ned.to_ecef(reference_ecef, reference_lla)
 ### Class Methods
 
 ```ruby
-ref = Geodetic::Coordinates::LLA.new(lat: 38.8977, lng: -77.0365, alt: 0.0)
+ref = Geodetic::Coordinate::LLA.new(lat: 38.8977, lng: -77.0365, alt: 0.0)
 
-Geodetic::Coordinates::ENU.from_lla(lla, ref)
-Geodetic::Coordinates::NED.from_lla(lla, ref)
-Geodetic::Coordinates::LLA.from_enu(enu, ref)
-Geodetic::Coordinates::LLA.from_ned(ned, ref)
+Geodetic::Coordinate::ENU.from_lla(lla, ref)
+Geodetic::Coordinate::NED.from_lla(lla, ref)
+Geodetic::Coordinate::LLA.from_enu(enu, ref)
+Geodetic::Coordinate::LLA.from_ned(ned, ref)
 
 # From other systems via reference
-Geodetic::Coordinates::ENU.from_utm(utm, ref)
-Geodetic::Coordinates::NED.from_utm(utm, ref)
-Geodetic::Coordinates::UTM.from_enu(enu, ref)
-Geodetic::Coordinates::UTM.from_ned(ned, ref)
+Geodetic::Coordinate::ENU.from_utm(utm, ref)
+Geodetic::Coordinate::NED.from_utm(utm, ref)
+Geodetic::Coordinate::UTM.from_enu(enu, ref)
+Geodetic::Coordinate::UTM.from_ned(ned, ref)
 
 # ECEF-based
-Geodetic::Coordinates::ENU.from_ecef(ecef, ref_ecef, ref_lla)
-Geodetic::Coordinates::NED.from_ecef(ecef, ref_ecef, ref_lla)
-Geodetic::Coordinates::ECEF.from_enu(enu, ref_ecef, ref_lla)
-Geodetic::Coordinates::ECEF.from_ned(ned, ref_ecef, ref_lla)
+Geodetic::Coordinate::ENU.from_ecef(ecef, ref_ecef, ref_lla)
+Geodetic::Coordinate::NED.from_ecef(ecef, ref_ecef, ref_lla)
+Geodetic::Coordinate::ECEF.from_enu(enu, ref_ecef, ref_lla)
+Geodetic::Coordinate::ECEF.from_ned(ned, ref_ecef, ref_lla)
 ```
 
 When `reference_lla` is omitted in ECEF-based conversions, it is computed automatically from `reference_ecef` via `reference_ecef.to_lla`.
@@ -118,17 +118,17 @@ MGRS and USNG accept an optional `precision` parameter (1-5, default 5) controll
 
 ```ruby
 # LLA to MGRS with precision
-Geodetic::Coordinates::MGRS.from_lla(lla, datum, precision)
+Geodetic::Coordinate::MGRS.from_lla(lla, datum, precision)
 lla_point.to_mgrs(datum, precision)      # available on UPS, WebMercator, BNG, StatePlane
 
 # LLA to USNG with precision
-Geodetic::Coordinates::USNG.from_lla(lla, datum, precision)
+Geodetic::Coordinate::USNG.from_lla(lla, datum, precision)
 
 # MGRS <-> USNG (direct conversion)
 mgrs.to_usng   # implicit via component transfer
-Geodetic::Coordinates::USNG.from_mgrs(mgrs)
+Geodetic::Coordinate::USNG.from_mgrs(mgrs)
 usng.to_mgrs
-Geodetic::Coordinates::MGRS.from_usng(usng)  # implicit via string
+Geodetic::Coordinate::MGRS.from_usng(usng)  # implicit via string
 ```
 
 ---
@@ -139,11 +139,11 @@ StatePlane requires a **zone code** when converting into the system:
 
 ```ruby
 # To StatePlane (zone_code required)
-Geodetic::Coordinates::StatePlane.from_lla(lla, 'CA_I')
-Geodetic::Coordinates::StatePlane.from_ecef(ecef, 'CA_I')
-Geodetic::Coordinates::StatePlane.from_utm(utm, 'CA_I')
-Geodetic::Coordinates::StatePlane.from_enu(enu, ref_lla, 'CA_I')
-Geodetic::Coordinates::StatePlane.from_ned(ned, ref_lla, 'CA_I')
+Geodetic::Coordinate::StatePlane.from_lla(lla, 'CA_I')
+Geodetic::Coordinate::StatePlane.from_ecef(ecef, 'CA_I')
+Geodetic::Coordinate::StatePlane.from_utm(utm, 'CA_I')
+Geodetic::Coordinate::StatePlane.from_enu(enu, ref_lla, 'CA_I')
+Geodetic::Coordinate::StatePlane.from_ned(ned, ref_lla, 'CA_I')
 
 # From StatePlane (zone is stored in the object)
 state_plane.to_lla
@@ -178,7 +178,7 @@ utm.to_lla(clarke)
 StatePlane stores its datum internally and uses it when no datum argument is provided:
 
 ```ruby
-sp = Geodetic::Coordinates::StatePlane.new(
+sp = Geodetic::Coordinate::StatePlane.new(
   easting: 2000000.0, northing: 500000.0,
   zone_code: 'CA_I', datum: clarke
 )
@@ -240,7 +240,7 @@ Universal distance methods are available on all coordinate types and work across
 ### Great-Circle Distance (Vincenty)
 
 - **`distance_to(other, *others)`** — Instance method. Computes the Vincenty great-circle distance from the receiver to one or more target coordinates. Returns a `Distance` for a single target, or an Array of `Distance` objects for multiple targets (radial distances from the receiver).
-- **`GCS.distance_between(*coords)`** — Class method on `Geodetic::Coordinates` (aliased as `GCS`). Computes consecutive chain distances between an ordered sequence of coordinates. Returns a `Distance` for two coordinates, or an Array of `Distance` objects for three or more.
+- **`GCS.distance_between(*coords)`** — Class method on `Geodetic::Coordinate` (aliased as `GCS`). Computes consecutive chain distances between an ordered sequence of coordinates. Returns a `Distance` for two coordinates, or an Array of `Distance` objects for three or more.
 
 > **`Distance` objects** wrap a distance value and provide unit-aware access. Call `.meters` to get the raw Float value in meters, or `.to_f` to get the value in the current display unit.
 
@@ -299,7 +299,7 @@ Universal bearing methods are available on all coordinate types and work across
 
 - **`bearing_to(other)`** — Instance method. Computes the great-circle forward azimuth from the receiver to the target coordinate. Returns a `Bearing` object.
 - **`elevation_to(other)`** — Instance method. Computes the vertical look angle (elevation) from the receiver to the target. Returns a Float in degrees (-90 to +90).
-- **`GCS.bearing_between(*coords)`** — Class method on `Geodetic::Coordinates` (aliased as `GCS`). Computes consecutive chain bearings between an ordered sequence of coordinates. Returns a `Bearing` for two coordinates, or an Array of `Bearing` objects for three or more.
+- **`GCS.bearing_between(*coords)`** — Class method on `Geodetic::Coordinate` (aliased as `GCS`). Computes consecutive chain bearings between an ordered sequence of coordinates. Returns a `Bearing` for two coordinates, or an Array of `Bearing` objects for three or more.
 
 ```ruby
 seattle = GCS::LLA.new(lat: 47.6205, lng: -122.3493, alt: 0.0)

data/docs/reference/geoid-height.md

@@ -141,7 +141,7 @@ Geodetic::GeoidHeight.available_vertical_datums
 
 ## Geodetic::GeoidHeightSupport (Mixin)
 
-The `GeoidHeightSupport` module is included in `Geodetic::Coordinates::LLA`, adding geoid-related methods directly to LLA instances.
+The `GeoidHeightSupport` module is included in `Geodetic::Coordinate::LLA`, adding geoid-related methods directly to LLA instances.
 
 ### Mixin Methods
 
@@ -150,7 +150,7 @@ The `GeoidHeightSupport` module is included in `Geodetic::Coordinates::LLA`, add
 Returns the geoid undulation at the LLA position.
 
 ```ruby
-point = Geodetic::Coordinates::LLA.new(lat: 38.8977, lng: -77.0365, alt: 100.0)
+point = Geodetic::Coordinate::LLA.new(lat: 38.8977, lng: -77.0365, alt: 100.0)
 point.geoid_height              # Uses EGM2008
 point.geoid_height('GEOID18')   # Uses GEOID18
 ```
@@ -168,7 +168,7 @@ point.orthometric_height  # alt minus geoid undulation
 Returns a new LLA with the altitude converted between vertical datums. The original object is not modified.
 
 ```ruby
-wgs84_point = Geodetic::Coordinates::LLA.new(lat: 40.0, lng: -100.0, alt: 300.0)
+wgs84_point = Geodetic::Coordinate::LLA.new(lat: 40.0, lng: -100.0, alt: 300.0)
 navd88_point = wgs84_point.convert_height_datum('HAE', 'NAVD88')
 ```
 
@@ -177,6 +177,6 @@ navd88_point = wgs84_point.convert_height_datum('HAE', 'NAVD88')
 The mixin also extends the including class with a `with_geoid_height` class method and a `geoid_model` reader, though these are primarily for internal use:
 
 ```ruby
-Geodetic::Coordinates::LLA.with_geoid_height('GEOID18')
-Geodetic::Coordinates::LLA.geoid_model  # => 'GEOID18'
+Geodetic::Coordinate::LLA.with_geoid_height('GEOID18')
+Geodetic::Coordinate::LLA.geoid_model  # => 'GEOID18'
 ```