OSR_DEFAULT_AXIS_MAPPING_STRATEGY: Add doc and test

VladimirAlexiev · Jul 4, 2023 · d2a2b01 · d2a2b01
1 parent ae231d9
commit d2a2b01
Show file tree

Hide file tree

Showing 2 changed files with 23 additions and 0 deletions.
diff --git a/autotest/osr/osr_basic.py b/autotest/osr/osr_basic.py
@@ -2457,3 +2457,18 @@ def test_osr_basic_wkt_format_configuration_option():
 
     assert "BBOX" not in wkt1
     assert "BBOX" in wkt2
+
+
+def test_osr_basic_default_axis_mapping_strategy():
+
+    with gdal.config_option(
+        "OSR_DEFAULT_AXIS_MAPPING_STRATEGY", "TRADITIONAL_GIS_ORDER"
+    ):
+        crs1 = osr.SpatialReference()
+        crs1.ImportFromEPSG(4326)
+
+    crs2 = osr.SpatialReference()
+    crs2.ImportFromEPSG(4326)
+
+    assert crs1.GetAxisMappingStrategy() == osr.OAMS_TRADITIONAL_GIS_ORDER
+    assert crs2.GetAxisMappingStrategy() == osr.OAMS_AUTHORITY_COMPLIANT
diff --git a/doc/source/user/configoptions.rst b/doc/source/user/configoptions.rst
@@ -969,6 +969,14 @@ PROJ options
       Helmert transformation to WGS84 when there is exactly one such method
       available for the CRS.
 
+-  .. config:: OSR_DEFAULT_AXIS_MAPPING_STRATEGY
+      :choices: TRADITIONAL_GIS_ORDER, AUTHORITY_COMPLIANT
+      :default: AUTHORITY_COMPLIANT
+      :since: 3.5
+
+      Determines whether to honor the declared axis mapping of a CRS or override it
+      with the traditional GIS ordering (x = longitude, y = latitude).
+
 -  .. config:: OSR_STRIP_TOWGS84
       :choices: YES, NO
       :default: YES