itowns 2.44.3-next.25 → 2.44.3-next.26

package/lib/Core/Geographic/Crs.js

@@ -1,6 +1,12 @@
 import proj4 from 'proj4';
 proj4.defs('EPSG:4978', '+proj=geocent +datum=WGS84 +units=m +no_defs');
 
+// Redefining proj4 global projections to match epsg.org database axis order.
+// See https://github.com/iTowns/itowns/pull/2465#issuecomment-2517024859
+proj4.defs('EPSG:4326').axis = 'neu';
+proj4.defs('EPSG:4269').axis = 'neu';
+proj4.defs('WGS84').axis = 'neu';
+
 /**
  * A projection as a CRS identifier string. This identifier references a
  * projection definition previously defined with
@@ -133,6 +139,19 @@ export function reasonableEpsilon(crs) {
   }
 }
 
+/**
+ * Returns the axis parameter defined in proj4 for the provided crs.
+ * Might be undefined depending on crs definition.
+ *
+ * @param crs - The CRS to get axis from.
+ * @returns the matching proj4 axis string, 'enu' for instance (east, north, up)
+ */
+export function axisOrder(crs) {
+  mustBeString(crs);
+  const projection = proj4.defs(crs);
+  return !projection ? undefined : projection.axis;
+}
+
 /**
  * Defines a proj4 projection as a named alias.
  * This function is a specialized wrapper over the

package/lib/Source/WMSSource.js

@@ -1,8 +1,37 @@
 import Source from "./Source.js";
 import URLBuilder from "../Provider/URLBuilder.js";
 import Extent from "../Core/Geographic/Extent.js";
+import * as CRS from "../Core/Geographic/Crs.js";
 const _extent = new Extent('EPSG:4326', [0, 0, 0, 0]);
 
+/**
+ * Proj provides an optional param to define axis order and orientation for a
+ * given projection. 'enu' for instance stands for east, north, up.
+ * Elevation is not needed here. The two first characters are sufficient to map
+ * proj axis to iTowns bbox order formalism.
+ * 'enu' corresponds to 'wsen' because bbox starts by lower value coordinates
+ * and preserves axis ordering, here long/lat.
+ */
+const projAxisToBboxMappings = {
+  en: 'wsen',
+  es: 'wnes',
+  wn: 'eswn',
+  ws: 'enws',
+  ne: 'swne',
+  se: 'nwse',
+  nw: 'senw',
+  sw: 'nesw'
+};
+
+/**
+ * Provides the bbox axis order matching provided proj4 axis
+ * @param {string} projAxis the CRS axis order as defined in proj4
+ * @returns {string} the corresponding bbox axis order to use for WMS 1.3.0
+ */
+function projAxisToWmsBbox(projAxis) {
+  return projAxis && projAxisToBboxMappings[projAxis.slice(0, 2)] || 'wsen';
+}
+
 /**
  * An object defining the source of images to get from a
  * [WMS](http://www.opengeospatial.org/standards/wms) server. It inherits
@@ -97,16 +126,15 @@ class WMSSource extends Source {
     this.version = source.version || '1.3.0';
     this.transparent = source.transparent || false;
     this.bboxDigits = source.bboxDigits;
-    if (!source.axisOrder) {
-      // 4326 (lat/long) axis order depends on the WMS version used
-      if (this.crs == 'EPSG:4326') {
-        // EPSG 4326 x = lat, long = y
-        // version 1.X.X long/lat while version 1.3.0 mandates xy (so lat,long)
-        this.axisOrder = this.version === '1.3.0' ? 'swne' : 'wsen';
-      } else {
-        // xy,xy order
-        this.axisOrder = 'wsen';
-      }
+    if (source.axisOrder) {
+      this.axisOrder = source.axisOrder;
+    } else if (this.version === '1.3.0') {
+      // If not set, axis order depends on WMS version
+      // Version 1.3.0 depends on CRS axis order as defined in epsg.org database
+      this.axisOrder = projAxisToWmsBbox(CRS.axisOrder(this.crs));
+    } else {
+      // Versions 1.X.X mandate long/lat order, east-north orientation
+      this.axisOrder = 'wsen';
     }
     const crsPropName = this.version === '1.3.0' ? 'CRS' : 'SRS';
     const urlObj = new URL(this.url);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "itowns",
-  "version": "2.44.3-next.25",
+  "version": "2.44.3-next.26",
   "description": "A JS/WebGL framework for 3D geospatial data visualization",
   "type": "module",
   "main": "lib/Main.js",