v5.3.1

Changed

• Further enhancements to coordinate conversion from a CompoundPoint

v5.3.0

Added

• Support for converting coordinates from a CompoundPoint where the horizontal component is Projected to a 3D CRS

Changed

• Updates to data for ETRS89, Colombia, Slovenia, USA and UK

Fixed

• Don't use 2D CRS as intermediate in a chain when converting from/to a 3D CRS

v5.2.0

Changed

• Updates to data for IGS, Japan and UK

Fixed

• Improved handling of extent polygon buffering involving complex shapes (e.g. Netherlands)
• Fixed longitude wraparound issue with GTX grids

v5.1.0

Added

• Support for 3D projected coordinates
• Support for custom coordinate reference systems and custom conversions

Changed

• Updates to data for ITRF, WGS84, Australia, Belgium, Canada, France, Germany, Iceland, Indonesia, Ireland, Japan, Luxembourg, Norway, North Macedonia, UK and USA
• Some internal simplifications and optimisations

Fixed

• Improved handling of longitudes greater than 180 degrees
• Corrected conversion of geocentric coordinates to geographic coordinates when using a non-Greenwich prime meridian

v4.7.0

The v4.x series is receiving basic maintenance only. All feature development takes place in v5.x.
This is because one of PHP8.1's new deprecations required a significant non-backwards compatible change to address.

Fixed

• Improved handling of longitudes greater than 180 degrees
• Corrected conversion of geocentric coordinates to geographic coordinates when using a non-Greenwich prime meridian

Changed

• Updates to data for ITRF, WGS84, Australia, Belgium, Canada, France, Germany, Iceland, Ireland, Japan, Luxembourg, Norway, North Macedonia, UK and USA

v5.0.1

Fixed

• Guard against divide by zero issues when calculating distance between two points

v4.6.1

Fixed

• Guard against divide by zero issues when calculating distance between two points

v5.0.0

Added

• Support for IGN France geocentric translation by grid interpolation. This requires the Europe datapack
• Support for vertical grid files. These require a relevant datapack

Changed

• The signatures of all *Point::create*() methods have been changed to put the CRS first. Previously the distance/direction values came first. This is to ensure that all optional parameters are at the end of the signature, addressing a PHP8.1 deprecation.

  Example:

  // in v4
  GeographicPoint::create(
      Angle $latitude,
      Angle $longitude,
      ?Length $height = null,
      Geographic $crs, // was after distance/direction
      ?DateTimeInterface $epoch = null
  ): GeographicPoint
  
  // in v5
  GeographicPoint::create(
      Geographic $crs, // now goes first
      Angle $latitude,
      Angle $longitude,
      ?Length $height = null,
      ?DateTimeInterface $epoch = null
  ): GeographicPoint
  

• Updates to data for Canada, Norway, UK

• Some internal simplifications and optimisations

• Supported PHP versions changed to ^8.0

v4.6.0

Changed

• Updates to data for Papua New Guinea, Ukraine and WGS84
• Some internal simplifications and optimisations

Fixed

• Corrected the decoding of sexagesimal DMS degree fractional components

v4.5.0

Changed

• Updates to data for Canada, Costa Rica, France, French Southern Territories, Kyrgistan, Liechtenstein, Poland, Russia, Switzerland, Tonga, UK, USA, Wallis and Futuna
• Many internal simplifications and optimisations, leading to faster conversions and a corresponding update of the maximum chain depth from 5 to 7

Fixed

• Some PHP8.1 deprecations

Deprecated

• Compound::EPSG_RGF93_LAMBERT_93_PLUS_NGF_IGN69_HEIGHT, use Compound::EPSG_RGF93_V1_LAMBERT_93_PLUS_NGF_IGN69_HEIGHT instead
• Compound::EPSG_RGF93_LAMBERT_93_PLUS_NGF_IGN78_HEIGHT, use Compound::EPSG_RGF93_V1_LAMBERT_93_PLUS_NGF_IGN78_HEIGHT instead
• Compound::EPSG_RGF93_PLUS_NGF_IGN69_HEIGHT, use Compound::EPSG_RGF93_V2_PLUS_NGF_IGN69_HEIGHT instead
• Compound::EPSG_RGF93_PLUS_NGF_IGN78_HEIGHT, use Compound::EPSG_RGF93_V2_PLUS_NGF_IGN78_HEIGHT instead
• Geocentric::EPSG_CHTRF95, use Geocentric::EPSG_CHTRS95 instead
• Geocentric::EPSG_RGF93, use Geocentric::EPSG_RGF93_V1 instead
• Geographic2D::EPSG_CHTRF95, use Geographic2D::EPSG_CHTRS95 instead
• Geographic2D::EPSG_RGF93, use Geographic2D::EPSG_RGF93_V1 instead
• Geographic2D::EPSG_RGF93_LON_LAT, use Geographic2D::EPSG_RGF93_V1_LON_LAT instead
• Geographic3D::EPSG_CHTRF95, use Geographic3D::EPSG_CHTRS95 instead
• Geographic3D::EPSG_RGF93, use Geographic3D::EPSG_RGF93_V1 instead
• Geographic3D::EPSG_RGF93_LON_LAT, use Geographic3D::EPSG_RGF93_V1_LON_LAT instead
• Projected::EPSG_RGF93_CC42, use Projected::EPSG_RGF93_V1_CC42 instead
• Projected::EPSG_RGF93_CC43, use Projected::EPSG_RGF93_V1_CC43 instead
• Projected::EPSG_RGF93_CC44, use Projected::EPSG_RGF93_V1_CC44 instead
• Projected::EPSG_RGF93_CC45, use Projected::EPSG_RGF93_V1_CC45 instead
• Projected::EPSG_RGF93_CC46, use Projected::EPSG_RGF93_V1_CC46 instead
• Projected::EPSG_RGF93_CC47, use Projected::EPSG_RGF93_V1_CC47 instead
• Projected::EPSG_RGF93_CC48, use Projected::EPSG_RGF93_V1_CC48 instead
• Projected::EPSG_RGF93_CC49, use Projected::EPSG_RGF93_V1_CC49 instead
• Projected::EPSG_RGF93_CC50, use Projected::EPSG_RGF93_V1_CC50 instead
• Projected::EPSG_RGF93_LAMBERT_93, use Projected::EPSG_RGF93_V1_LAMBERT_93 instead
• Datum::EPSG_SWISS_TERRESTRIAL_REFERENCE_FRAME_1995, use Datum::EPSG_SWISS_TERRESTRIAL_REFERENCE_SYSTEM_1995 instead
• Datum::EPSG_RESEAU_GEODESIQUE_FRANCAIS_1993, use Datum::EPSG_RESEAU_GEODESIQUE_FRANCAIS_1993_V1 instead