CHANGELOG.md

1.5.0

NOTE: geobase version 1.5.0 currently under development (1.5.0-dev.1).

🧩 Features:

• Port conversions between (historical) ellipsoidal datums to Dart #256
• Port UTM / WGS-84 conversion functions to Dart #257
• Port MGRS / UTM conversion functions to Dart #258
• Add Geocentric class on geodesy / ellipsoidal to represent ECEF (earth-centric earth-fixed) positions / calculations #260
• Handle optional m and elev coordinates when transforming between geographic and cartesian geocentric coordinates #259
• Conversions between geographic, UTM and geocentric coordinates in projections sub package #261

1.4.0+1

Small documentation link fixes.

1.4.0

✨ New (2024-11-10): The stable version 1.4.0 with ellipsoidal geodesy functions letting you calculate distances, bearings, destination positions and intermediate points along the Earth surface accurately.

geobase release 1.4.0

🧩 Features:

• Add a class for an earth ellipsoid with common default values #242
• Coordinate transformation between geocentric cartesian coordinates and geographic coordinates #243
• Vincenty calculations (distances and bearings) between geographic points #244
• Add GeographicBearing class to represent a bearing with a geographic position #245
• Add GeodeticArcSegment class to represent a geodesic arc between two points on an ellipsoid or a sphere #246

🛠 Refactoring:

• Remove dependency on equatable package #248
• Refactor polylabel function to use TinyQueue ported from JavaScript #253

🛠 Maintenance:

• Update very_good_analysis version to 6.0.0 #249

📚 Documentation updates

• New chapter about ellipsoidal geodesy calculations on the documentation site #251

1.3.0

✨ New (2024-07-26): The stable version 1.3.0 with centroid, polylabel, point-in-polygon and other cartesian 2D calculations enhanced - read more!

geobase release 1.3.0

🧩 Features:

• Add visual center point calculations for polygons #237
• Centroid2D as available from sub package geometric #240
• Add point-in-polygon function #236
• Add distance-to-from-point function #238

🛠 Maintenance:

• Add dependency on the collections package (for PriorityQueue).
• New sub package for cartesian calculations #239

1.2.0

geobase release 1.2.0

✨ New (2024-05-26): The new documentation website (geospatial.navibyte.dev) for the geobase package documentation published along with the stable version 1.2.0.

🛠 Refactoring:

• Shorten and streamline package readme docs #234

No functional changes on classes and functions, but major changes on documentation with the publication of the new docs website.

1.1.0

geobase release 1.1.0

✨ New (2024-04-22): Support for Newline-delimited GeoJSON, EWKT and EWKB added. Check out the blog post.

🧩 Features:

• Enhanced coordinate value output for positions and text data formats #98
• Add decodeHex and toBytesHex to geometry objects and builders #227
• Add EWKB encoding and decoding support on geobase #165
• Add EWKT support
• Support for GeoJSON Text Sequences
• Centroid for all geometry objects #223
• Factories to create multi geometries from geometry lists #229
• Item accessor operator and length in geometry and feature collections #230
• True dimensionality for geometry #231

1.0.2

🧩 Features:

• Add Extended WKB or EWKB support #224
  • Support decoding also EWKB data (no support for accessing an optional srid).
  • These changes on WKB decoder internal logic without any library API changes.
  • Quite extensive tests.
  • Encoding EWKB data not yet implemented (see #165, coming in future version).

1.0.1

🐛 Bugs fixed:

• Bug: special case POINT EMPTY encoding x and y as double.nan in WKB encoder / byte writer #225

🛠 Maintenance:

• Adding trailing commas to avoid "Missing a required trailing comma" message.
• Small documentation fixes.

1.0.0

geobase version 1.0.0 #175

✨ New (2023-10): The stable version 1.0.0 is now ready. See also the article Geospatial tools for Dart - version 1.0 published at Medium.

⚠️ Breaking changes:

• Remove previous deprecations for geobase 1.0.0 #207
• Restructure abstract base classes Positionable and Bounded #213
• Change signature of TransformPosition typedef #216

🧩 Features:

• Handle the special case of bbox or geometries spanning the anti-meridian (longitude 180 degrees) #185
• Merge and split on Box #211
• PositionScheme for generic, geographic and projected position data #214
• Add basic geometry calculation functions #191
• Operators in Position, Box and PositionSeries #215
• Transform and filter positions and position series #218
• Position element manipulation in PositionSeries #219
• Enum for dimensionality or topological dimension #220

🛠 Refactoring:

• Normalize longitude with inclusive limit on east 180 degrees #210
• Move Bounded to coordinates and implement it by PositionSeries #212
• Restructure codes and constants sub packages #221

🚥 Tests:

• Handle the special case of bbox or geometries containing or touching north (latitude 90 deg) or south (latitude -90 deg) poles #209

0.6.0

geobase version 0.6.0 #193

✨ New (2023-09): Optimizing data structures (Position, PositionSeries, Box) used by simple geometries. Fixes, tests and documentation.

🧩 Features:

• Add copyWith (and map) methods to coordinate, meta, feature and geometry classes #189
• Populating and unpopulating bounds in geometries and feature objects #197
• Testing feature and geometry equality #188
• Factories on Position and Box to create from double arrays #199
• Redesigned PositionData supporting positions from coordinate value array and position objects #200
• Coordinates using data structures from typed data #203
• Position from subview of coordinate value array as doubles #204
• PositionSeries and geometries with reversed positions #205
• Get a subseries of positions in PositionSeries #206

⚠️ Breaking changes:

• Allow a position stored as "Position" in Point, and a bounding box as "Box" in Geometry classes #192
• Simplify Feature and FeatureCollection types #195
• Remove deprecated types in geobase version 0.6.0 #194
• Consistent crs and trs references in meta classes #196
• Deprecate PositionArray, PositionCoords and BoxCoords #201
• Refactor SimpleGeometryContent #202

🛠 Refactoring:

• isEmptyByGeometry on Bounded (and feature objects too, not only geometries)

🛠 Maintenance:

• PositionArray, PositionCoords and BoxCoords moved from vector_data to vector (and later deprecated by #201).
• Enhanced class documentation and tests.

0.5.1

Small document fixes (readme links to assets), no code changes.

0.5.0

geobase version 0.5.0 #161

✨ New (2023-07): spherical geodesy functions (distance, bearing, destination point, etc.) for great circle and rhumb line paths.

⚠️ Breaking changes:

• The WkbConf class removed, added buildEmptyGeometries for WKB decoder.
• Position and Box: tolerance type from num? to double (see #146).
• Remove inheritance of Scalable2i from Projected #183
• Measurable abstract class removed, isMeasured defined in Positionable.
• Coordinate values as doubles instead of num #186

🧩 Features:

• Add common geospatial and geodesy functions #106
• Add parse and format functions for dms representations of degrees #173
• Axis order information of coordinate reference systems #178
• GeoJSON output for non-default coordinate reference systems #179
• WKT decoder on geobase #159
• Consistent equals, equals2D, equals3D (and equalsBy) for coordinates, geometries and features #146
• Geometry objects instantiated from instances or iterables of Position objects #171
• Alternative logics to resolve axis order #182
• Handle explicit and implicit bounds in geometries and features on geobase #141
• Add project method for Position class #184
• Project bounding box #96

🛠 Refactoring:

• Enforce "geometry" under "Feature" when encoding GeoJSON text output #91
• Deprecate XY, XYZ, XYM, XYZM, LonLat, LonLatElev, LonLatM, LonLatElevM special classes extending PositionCoords - to be removed for version 1.0 of the package.

🐛 Bugs fixed:

• Clipping when projection WGS 84 to Web Mercator metric coordinates #123

🛠 Maintenance:

• Removed extra internal export files and made internal imports more excplicit.

✍️ In-progress:

• Geographic string representations (DMS) enhancements #176
  • DMS lat/lon representatio default separator changed.

0.4.2

📚 Documentation updates:

• Readme enhanced with multiple class diagrams.

0.4.1

📚 Documentation updates

• An introduction chapter for the readme.

🛠 Maintenance:

• The SDK constraint updated from '>=2.17.0 <3.0.0' to '>=2.17.0 <4.0.0'.

0.4.0

geobase version 0.4.0 #161

🧩 Features:

• Add methods to calculate a pixel or a position from tile coordinates in tile matrix sets #158
• Add toText and writeValues on Position and Box #153
• Calculate zoom from pixel resolution or scale denominator #160
• GeoBox.center2D #157 implemented as "aligned2D"

0.3.2

📚 Documentation updates.

🛠 Refactoring:

• Expect XY data in geometry build methods by default #154

0.3.1

📚 Small documentation updates. Also a link to the Geospatial demos for Dart repository.

0.3.0

✨ New: Data structures for simple geometries, features and feature collections. ✨ New: Support for Well-known binary (WKB). Text and binary data formats, encodings and content interfaces also redesigned.

⚠️ Breaking changes:

• Content interfaces, content encoders and text formats redesigned
• Rename writers and content interfaces to generalize #127
• Geometry content written with more specific methods #128
• Allow coordinate value arrays along with position arrays on content interfaces #129
• Simplify Coords enum #130
• Type changes on projections and adapters #151
• Move "basic transforms" from geobase to geocore #152

🧩 Features:

• Combine writers and parsers for formats (GeoJSON, WKT) consistently #125
• Add WKB encoding/decoding support #115
• Text and Binary outputs on writers #126
• Text and Binary outputs on decoders #132
• Coordinate order on box and position consistently #134
• Positions as iterable of coordinate values on geobase #136
• PositionData access (on lists or buffers) #137
• new mini library "transforms" and "projections"
• Simple geometry data structures on geobase #133
• Feature data structures on geobase #138
• GeoJSON text decoder building new geometry and feature data structures on geobase #139(#139)
• Equals, hashCode and toString for geometries and features on geobase #143
• Encode / write methods directly from geometry and feature classes on geobase #144
• Decode GeoJSON and build data structures using new data structures by geobase #140
• Handle explicit and implicit bounds in geometries and features on geobase
• Handle projections and transforms of geometries and features on geobase #142

🛠 Refactoring:

• Optimize reading from iterable of coordinate values #131
• Feature properties and data maps as Map<String, dynamic> instead of Map<String, Object?> #147
• Refactor fromJson / toJson methods on model classes #150

🛠 Maintenance:

• Lint rules without old strong mode, but with new "stricter type checks" #148
• Mark internal classes with @internal #149

📚 Documentation

• Documentation about content builders, geometries and features on geobase #145

0.2.1

🐛 Bugs fixed:

• Ambiguous reexports on geobase 0.2.0 with constants #122

0.2.0

✨ New: Tiling schemes and tile matrix sets (web mercator, global geodetic). Also other improvements on coordinates, and refactorings on the code structure.

🧩 Features:

• Mini-libraries for geobase #109
• Conversion between WGS84 (lon-lat) and Web Mercator Quad tile matrix set #57
• MapPoint2i renamed to ScalableXY, and implementing Projected and Scalable #116
• Use OGC specified screen pixel size / ppi when calculating scale denominator #119
• Add World CRS84 TileMatrixSet #114
• Add zoomIn, zoomOut and zoomOut to Scalable2i #121

🛠 Maintenance:

• Upgrade to Dart 2.17 #105
• Apply very_good_analysis 3.0.0+ lint rules #104
• Restructure code folders on geobase package #107

0.1.1

🧩 Features:

• Create position instances from num iterables or text #101
• Distance (haversine) between geographic positions #102
• Create box instances from num iterables or text #103

0.1.0

Initial version with some code originating from geocore package:

• 🔢 enums for geospatial coordinate and geometry types
• 🌐 geographic positions and bounding boxes (longitude-latitude-elevation)
• 🗺️ projected positions and bounding boxes (cartesian XYZ)
• 🏗️ coordinate transformations and projections (initial support)
• 📅 temporal data structures (instant, interval)
• 📃 geospatial data writers for features, geometries, coordinates, properties:
  • 🌎 supported formats: GeoJSON
• 📃 geospatial data writers for geometries and coordinates:
  • 🪧 supported formats: WKT

🧩 Features:

• Separate some common features of geocore to separate common package #86
• Base interface for bounding boxes compatible with RFC7946 #87
• Separate basic point properties as position interface #84
• Formatting to text on Point (and other geometries) more flexible #81
• Coordinate types enhanced #92
• Coordinate value accessors on position classes #94
• Equality and hashcode for (Geo)Position and (Geo)Box classes #89
• Generalize and move project and transform from geocore to geobase #95
• Intersects bounds generalized on geobase #97
• Renewed GeoExtent with spatial and temporal parts #99

🛠 Maintenance:

• Upgrade to Dart 2.15 #90