0000: 44 20 32 30 31 39 2d 30 35 2d 31 34 54 31 37 3a D 2019-05-14T17:
0010: 35 32 3a 30 38 2e 32 36 30 0a 4c 20 50 52 4f 4a 52:08.260.L PROJ
0020: 2e 36 0a 50 20 33 30 63 31 33 62 35 34 30 37 36 .6.P 30c13b54076
0030: 33 62 35 36 63 37 64 38 66 64 36 35 35 63 64 63 3b56c7d8fd655cdc
0040: 65 30 31 61 38 30 38 32 30 35 65 30 62 0a 55 20 e01a808205e0b.U
0050: 73 61 6e 64 72 6f 0a 57 20 34 36 39 32 30 0a 3c sandro.W 46920.<
0060: 61 20 68 72 65 66 3d 22 68 74 74 70 73 3a 2f 2f a href="https://
0070: 77 77 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 2f www.gaia-gis.it/
0080: 66 6f 73 73 69 6c 2f 6c 69 62 73 70 61 74 69 61 fossil/libspatia
0090: 6c 69 74 65 2f 77 69 6b 69 3f 6e 61 6d 65 3d 34 lite/wiki?name=4
00a0: 2e 33 2e 30 2d 64 6f 63 22 3e 62 61 63 6b 3c 2f .3.0-doc">back</
00b0: 61 3e 3c 68 72 3e 3c 62 72 3e 0d 0a 3c 68 31 3e a><hr><br>..<h1>
00c0: 49 6e 74 72 6f 64 75 63 74 69 6f 6e 3c 2f 68 31 Introduction</h1
00d0: 3e 0d 0a 3c 62 3e 50 52 4f 4a 3c 2f 62 3e 20 69 >..<b>PROJ</b> i
00e0: 73 20 61 20 77 65 6c 6c 2d 6b 6e 6f 77 6e 20 6c s a well-known l
00f0: 69 62 72 61 72 79 20 66 6f 72 20 70 65 72 66 6f ibrary for perfo
0100: 72 6d 69 6e 67 20 63 6f 6e 76 65 72 73 69 6f 6e rming conversion
0110: 73 20 62 65 74 77 65 65 6e 20 63 61 72 74 6f 67 s between cartog
0120: 72 61 70 68 69 63 20 70 72 6f 6a 65 63 74 69 6f raphic projectio
0130: 6e 73 2e 3c 62 72 3e 0d 0a 49 74 27 73 20 75 6e ns.<br>..It's un
0140: 69 76 65 72 73 61 6c 6c 79 20 73 75 70 70 6f 72 iversally suppor
0150: 74 65 64 20 62 79 20 61 6c 6d 6f 73 74 20 61 6c ted by almost al
0160: 6c 20 6f 70 65 6e 20 73 6f 75 72 63 65 20 47 49 l open source GI
0170: 53 2d 6f 72 69 65 6e 74 65 64 20 61 70 70 6c 69 S-oriented appli
0180: 63 61 74 69 6f 6e 73 20 61 6e 64 20 70 61 63 6b cations and pack
0190: 61 67 65 73 2c 20 73 6f 20 74 68 65 72 65 20 69 ages, so there i
01a0: 73 20 6e 6f 20 6e 65 65 64 20 74 6f 20 77 61 73 s no need to was
01b0: 74 65 20 74 69 6d 65 20 69 6e 20 66 75 72 74 68 te time in furth
01c0: 65 72 20 70 72 65 73 65 6e 74 61 74 69 6f 6e 73 er presentations
01d0: 2e 3c 62 72 3e 0d 0a 57 65 20 6a 75 73 74 20 6e .<br>..We just n
01e0: 65 65 64 20 61 20 62 69 74 20 6f 66 20 68 69 73 eed a bit of his
01f0: 74 6f 72 79 20 74 6f 20 66 75 6c 6c 79 20 75 6e tory to fully un
0200: 64 65 72 73 74 61 6e 64 20 74 68 65 20 63 75 72 derstand the cur
0210: 72 65 6e 74 20 73 74 61 74 65 20 6f 66 20 74 68 rent state of th
0220: 65 20 61 72 74 20 6f 66 20 74 68 69 73 20 6c 69 e art of this li
0230: 62 72 61 72 79 3a 3c 62 72 3e 0d 0a 3c 68 33 3e brary:<br>..<h3>
0240: 50 61 73 74 20 48 69 73 74 6f 72 79 3c 2f 68 33 Past History</h3
0250: 3e 0d 0a 3c 62 3e 3c 75 3e 54 69 6d 65 6c 69 6e >..<b><u>Timelin
0260: 65 3c 2f 75 3e 3c 2f 62 3e 3c 62 72 3e 0d 0a 56 e</u></b><br>..V
0270: 65 72 79 20 66 65 77 20 75 73 65 72 73 20 61 6e ery few users an
0280: 64 20 64 65 76 65 6c 6f 70 65 72 73 20 64 6f 20 d developers do
0290: 72 65 61 6c 6c 79 20 72 65 61 6c 69 7a 65 20 68 really realize h
02a0: 6f 77 20 61 6e 63 69 65 6e 74 20 69 73 20 50 52 ow ancient is PR
02b0: 4f 4a 2c 20 61 6e 64 20 68 6f 77 20 66 61 72 20 OJ, and how far
02c0: 69 6e 20 74 69 6d 65 20 69 74 20 73 74 61 72 74 in time it start
02d0: 65 64 20 6d 6f 76 69 6e 67 20 69 74 73 20 66 69 ed moving its fi
02e0: 72 73 74 20 73 74 65 70 73 3a 0d 0a 3c 75 6c 3e rst steps:..<ul>
02f0: 0d 0a 3c 6c 69 3e 69 6e 20 3c 62 3e 31 39 38 30 ..<li>in <b>1980
0300: 3c 2f 62 3e 20 28 61 62 6f 75 74 20 34 30 20 79 </b> (about 40 y
0310: 65 61 72 73 20 61 67 6f 29 20 47 65 72 61 6c 64 ears ago) Gerald
0320: 20 45 76 65 6e 64 65 6e 20 73 74 61 72 74 65 64 Evenden started
0330: 20 77 6f 72 6b 69 6e 67 20 6f 6e 20 74 68 65 20 working on the
0340: 76 65 72 79 20 66 69 72 73 74 20 50 52 4f 4a 20 very first PROJ
0350: 76 65 72 73 69 6f 6e 2c 20 61 6e 64 20 61 74 20 version, and at
0360: 74 68 65 20 74 69 6d 65 20 69 74 20 77 61 73 20 the time it was
0370: 61 20 52 61 74 66 6f 72 20 70 72 6f 67 72 61 6d a Ratfor program
0380: 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 69 6e 20 3c .</li>..<li>in <
0390: 62 3e 31 39 38 35 3c 2f 62 3e 20 74 68 65 20 63 b>1985</b> the c
03a0: 6f 64 65 20 77 61 73 20 63 6f 6d 70 6c 65 74 65 ode was complete
03b0: 6c 79 20 72 65 77 72 69 74 74 65 6e 20 69 6e 20 ly rewritten in
03c0: 43 20 74 6f 20 72 75 6e 20 6f 6e 20 55 4e 49 58 C to run on UNIX
03d0: 20 73 79 73 74 65 6d 73 2c 20 61 6e 64 20 69 74 systems, and it
03e0: 20 77 61 73 20 6e 61 6d 65 64 20 3c 62 3e 50 52 was named <b>PR
03f0: 4f 4a 2e 32 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a OJ.2</b>.</li>..
0400: 3c 6c 69 3e 69 6e 20 3c 62 3e 31 39 39 30 3c 2f <li>in <b>1990</
0410: 62 3e 20 77 61 73 20 72 65 6c 65 61 73 65 64 20 b> was released
0420: 61 6e 20 75 70 64 61 74 65 64 20 76 65 72 73 69 an updated versi
0430: 6f 6e 20 6e 61 6d 65 64 20 3c 62 3e 50 52 4f 4a on named <b>PROJ
0440: 2e 33 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 69 6e 20 .3</li>..<li>in
0450: 3c 62 3e 31 39 39 34 3c 2f 62 3e 20 61 20 6d 6f <b>1994</b> a mo
0460: 72 65 20 61 64 76 61 6e 63 65 64 20 76 65 72 73 re advanced vers
0470: 69 6f 6e 20 77 61 73 20 72 65 6c 65 61 73 65 64 ion was released
0480: 2c 20 61 6e 64 20 69 74 20 77 61 73 20 6f 62 76 , and it was obv
0490: 69 6f 75 73 6c 79 20 6e 61 6d 65 64 20 3c 62 3e iously named <b>
04a0: 50 52 4f 4a 2e 34 3c 2f 62 3e 3c 2f 6c 69 3e 0d PROJ.4</b></li>.
04b0: 0a 3c 6c 69 3e 69 6e 20 3c 62 3e 31 39 39 35 3c .<li>in <b>1995<
04c0: 2f 62 3e 20 45 76 65 6e 64 65 6e 20 73 74 6f 70 /b> Evenden stop
04d0: 70 65 64 20 61 6e 79 20 66 75 72 74 68 65 72 20 ped any further
04e0: 64 65 76 65 6c 6f 70 6d 65 6e 74 20 61 63 74 69 development acti
04f0: 76 69 74 79 20 61 6e 64 20 74 68 65 20 70 72 6f vity and the pro
0500: 6a 65 63 74 20 62 65 63 6f 6d 65 20 69 6e 61 63 ject become inac
0510: 74 69 76 65 20 66 6f 72 20 73 65 76 65 72 61 6c tive for several
0520: 20 79 65 61 72 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c years.</li>..<l
0530: 69 3e 69 6e 20 3c 62 3e 32 30 30 30 3c 2f 62 3e i>in <b>2000</b>
0540: 20 46 72 61 6e 6b 20 57 61 72 6d 65 72 64 61 6d Frank Warmerdam
0550: 20 62 65 63 61 6d 65 20 74 68 65 20 6e 65 77 20 became the new
0560: 6d 61 69 6e 74 61 69 6e 65 72 20 61 6e 64 20 72 maintainer and r
0570: 65 6c 65 61 73 65 64 20 76 65 72 73 69 6f 6e 20 eleased version
0580: 3c 62 3e 34 2e 34 3c 2f 62 3e 3c 2f 6c 69 3e 0d <b>4.4</b></li>.
0590: 0a 3c 6c 69 3e 41 66 74 65 72 20 74 68 69 73 20 .<li>After this
05a0: 72 65 62 6f 72 6e 20 74 68 65 20 72 65 76 69 74 reborn the revit
05b0: 61 6c 69 7a 65 64 20 70 72 6f 6a 65 63 74 20 63 alized project c
05c0: 6f 6e 74 69 6e 75 65 64 20 74 6f 20 62 65 20 72 ontinued to be r
05d0: 65 67 75 6c 61 72 6c 79 20 6d 61 69 6e 74 61 69 egularly maintai
05e0: 6e 65 64 2c 20 62 75 74 20 6e 6f 20 66 75 72 74 ned, but no furt
05f0: 68 65 72 20 72 65 6c 65 76 61 6e 74 20 69 6d 70 her relevant imp
0600: 72 6f 76 65 6d 65 6e 74 73 20 77 65 72 65 20 69 rovements were i
0610: 6e 74 72 6f 64 75 63 65 64 2e 3c 62 72 3e 0d 0a ntroduced.<br>..
0620: 50 52 4f 4a 2e 34 20 6a 75 73 74 20 63 6f 6e 74 PROJ.4 just cont
0630: 69 6e 75 65 64 20 69 74 73 20 76 65 72 79 20 70 inued its very p
0640: 6c 61 63 69 64 20 65 76 6f 6c 75 74 69 6f 6e 20 lacid evolution
0650: 69 6e 20 61 20 73 75 62 73 74 61 6e 74 69 61 6c in a substantial
0660: 6c 79 20 63 6f 6e 73 65 72 76 61 74 69 76 65 20 ly conservative
0670: 77 61 79 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e way.</li>..</ul>
0680: 3c 62 72 3e 0d 0a 3c 62 3e 3c 75 3e 53 68 6f 72 <br>..<b><u>Shor
0690: 74 20 63 6f 6e 63 6c 75 73 69 6f 6e 3c 2f 75 3e t conclusion</u>
06a0: 3c 2f 62 3e 3a 20 74 68 65 20 66 6f 75 72 74 68 </b>: the fourth
06b0: 20 76 65 72 73 69 6f 6e 20 6f 66 20 50 52 4f 4a version of PROJ
06c0: 20 28 61 6b 61 20 3c 62 3e 50 52 4f 4a 2e 34 3c (aka <b>PROJ.4<
06d0: 2f 62 3e 29 20 6c 61 73 74 65 64 20 66 6f 72 20 /b>) lasted for
06e0: 61 62 6f 75 74 20 74 77 6f 20 64 65 63 61 64 65 about two decade
06f0: 73 2c 20 61 20 76 65 72 79 20 75 6e 63 6f 6d 6d s, a very uncomm
0700: 6f 6e 20 73 69 74 75 61 74 69 6f 6e 2e 3c 62 72 on situation.<br
0710: 3e 0d 0a 41 6e 64 20 63 6f 6e 73 65 71 75 65 6e >..And consequen
0720: 74 6c 79 20 61 20 66 75 6c 6c 20 67 65 6e 65 72 tly a full gener
0730: 61 74 69 6f 6e 20 6f 66 20 64 65 76 65 6c 6f 70 ation of develop
0740: 65 72 73 20 61 6e 64 20 75 73 65 72 73 20 62 65 ers and users be
0750: 63 61 6d 65 20 73 69 6e 63 65 72 65 6c 79 20 63 came sincerely c
0760: 6f 6e 76 69 6e 63 65 64 20 74 68 61 74 20 50 52 onvinced that PR
0770: 4f 4a 2e 34 20 77 61 73 20 74 68 65 20 72 65 61 OJ.4 was the rea
0780: 6c 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 6c 69 l name of the li
0790: 62 72 61 72 79 2e 0d 0a 3c 68 33 3e 54 68 65 20 brary...<h3>The
07a0: 72 65 76 6f 6c 75 74 69 6f 6e 20 63 6f 6d 65 73 revolution comes
07b0: 3c 2f 68 33 3e 0d 0a 3c 62 3e 3c 75 3e 54 69 6d </h3>..<b><u>Tim
07c0: 65 6c 69 6e 65 3c 2f 75 3e 3c 2f 62 3e 3a 0d 0a eline</u></b>:..
07d0: 3c 75 6c 3e 0d 0a 3c 6c 69 3e 69 6e 20 3c 62 3e <ul>..<li>in <b>
07e0: 32 30 31 38 3c 2f 62 3e 20 45 76 65 6e 20 52 6f 2018</b> Even Ro
07f0: 75 61 75 6c 74 2c 20 4b 72 69 73 74 69 61 6e 20 uault, Kristian
0800: 45 76 65 72 73 20 61 6e 64 20 6f 74 68 65 72 73 Evers and others
0810: 20 73 74 61 72 74 20 64 65 76 65 6c 6f 70 69 6e start developin
0820: 67 20 61 20 72 65 76 6f 6c 75 74 69 6f 6e 69 7a g a revolutioniz
0830: 65 64 20 50 52 4f 4a 20 73 75 70 70 6f 72 74 69 ed PROJ supporti
0840: 6e 67 20 6d 61 6e 79 20 72 65 6c 65 76 61 6e 74 ng many relevant
0850: 20 69 6e 6e 6f 76 61 74 69 6f 6e 73 2e 3c 62 72 innovations.<br
0860: 3e 0d 0a 3c 62 3e 50 52 4f 4a 2e 35 3c 2f 62 3e >..<b>PROJ.5</b>
0870: 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 is intended to
0880: 62 65 20 74 68 65 20 66 69 72 73 74 20 70 72 65 be the first pre
0890: 6c 69 6d 69 6e 61 72 79 20 73 74 65 70 20 6f 66 liminary step of
08a0: 20 61 20 6d 6f 72 65 20 63 6f 6d 70 6c 65 78 20 a more complex
08b0: 65 76 6f 6c 75 74 69 6f 6e 20 73 63 68 65 6d 61 evolution schema
08c0: 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 6f 6e 20 3c .</li>..<li>on <
08d0: 62 3e 4d 61 72 63 68 20 32 30 31 39 3c 2f 62 3e b>March 2019</b>
08e0: 20 61 20 6d 6f 72 65 20 6d 61 74 75 72 65 20 76 a more mature v
08f0: 65 72 73 69 6f 6e 20 69 73 20 72 65 6c 65 61 73 ersion is releas
0900: 65 64 2c 20 61 6e 64 20 69 74 27 73 20 3c 62 3e ed, and it's <b>
0910: 50 52 4f 4a 2e 36 3c 2f 62 3e 3c 2f 6c 69 3e 0d PROJ.6</b></li>.
0920: 0a 3c 6c 69 3e 4e 65 78 74 20 79 65 61 72 20 28 .<li>Next year (
0930: 32 30 32 30 29 20 3c 62 3e 50 52 4f 4a 2e 37 3c 2020) <b>PROJ.7<
0940: 2f 62 3e 20 69 73 20 65 78 70 65 63 74 65 64 20 /b> is expected
0950: 74 6f 20 62 65 20 72 65 6c 65 61 73 65 64 2c 20 to be released,
0960: 61 6e 64 20 69 74 20 77 69 6c 6c 20 66 75 6c 6c and it will full
0970: 79 20 63 6f 6d 70 6c 65 74 65 20 74 68 65 20 74 y complete the t
0980: 72 61 6e 73 69 74 69 6f 6e 20 62 65 74 77 65 65 ransition betwee
0990: 6e 20 74 68 65 20 6f 6c 64 20 61 6e 64 20 6e 65 n the old and ne
09a0: 77 20 61 72 63 68 69 74 65 63 74 75 72 65 73 2e w architectures.
09b0: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 62 </li>..</ul>..<b
09c0: 72 3e 0d 0a 3c 62 3e 3c 75 3e 4e 6f 74 65 3c 2f r>..<b><u>Note</
09d0: 75 3e 3c 2f 62 3e 3a 20 74 68 65 20 77 68 6f 6c u></b>: the whol
09e0: 65 20 74 72 61 6e 73 69 74 69 6f 6e 20 69 6d 70 e transition imp
09f0: 6c 69 65 73 20 6d 61 6e 79 20 72 65 6c 65 76 61 lies many releva
0a00: 6e 74 20 63 68 61 6e 67 65 73 2c 20 73 6f 20 74 nt changes, so t
0a10: 68 61 74 20 61 20 64 65 65 70 6c 79 20 72 65 76 hat a deeply rev
0a20: 69 73 65 64 20 41 50 49 20 77 69 6c 6c 20 62 65 ised API will be
0a30: 20 72 65 71 75 69 72 65 64 2e 0d 0a 49 6e 20 6f required...In o
0a40: 74 68 65 72 20 77 6f 72 64 73 2c 20 74 68 65 20 ther words, the
0a50: 6f 6c 64 20 3c 62 3e 50 52 4f 4a 2e 34 3c 2f 62 old <b>PROJ.4</b
0a60: 3e 20 61 6e 64 20 74 68 65 20 6e 65 77 20 3c 62 > and the new <b
0a70: 3e 50 52 4f 4a 2e 37 3c 2f 62 3e 20 77 69 6c 6c >PROJ.7</b> will
0a80: 20 73 75 70 70 6f 72 74 20 74 77 6f 20 64 69 66 support two dif
0a90: 66 65 72 65 6e 74 20 41 50 49 73 2c 20 74 68 75 ferent APIs, thu
0aa0: 73 20 61 62 72 75 70 74 6c 79 20 62 72 65 61 6b s abruptly break
0ab0: 69 6e 67 20 63 72 6f 73 73 2d 76 65 72 73 69 6f ing cross-versio
0ac0: 6e 20 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 2e n compatibility.
0ad0: 3c 62 72 3e 0d 0a 54 68 69 73 20 69 73 20 61 6e <br>..This is an
0ae0: 20 75 6e 70 6c 65 61 73 61 6e 74 20 6e 65 77 2c unpleasant new,
0af0: 20 62 65 63 61 75 73 65 20 69 74 20 70 72 61 63 because it prac
0b00: 74 69 63 61 6c 6c 79 20 6d 65 61 6e 73 20 74 68 tically means th
0b10: 61 74 20 61 6c 6c 20 73 6f 66 74 77 61 72 65 20 at all software
0b20: 6d 6f 64 75 6c 65 73 20 64 65 70 65 6e 64 69 6e modules dependin
0b30: 67 20 6f 6e 20 50 52 4f 4a 20 28 74 68 69 73 20 g on PROJ (this
0b40: 69 6e 63 6c 75 64 69 6e 67 20 53 70 61 74 69 61 including Spatia
0b50: 4c 69 74 65 29 20 77 69 6c 6c 20 72 65 71 75 69 Lite) will requi
0b60: 72 65 20 61 20 6e 6f 74 20 61 74 20 61 6c 6c 20 re a not at all
0b70: 74 72 69 76 69 61 6c 20 72 65 77 72 69 74 65 20 trivial rewrite
0b80: 69 6e 20 6f 72 64 65 72 20 74 6f 20 66 75 6c 66 in order to fulf
0b90: 69 6c 6c 20 74 68 65 20 6e 65 77 20 41 50 49 20 ill the new API
0ba0: 72 65 71 75 69 72 65 6d 65 6e 74 73 2e 3c 62 72 requirements.<br
0bb0: 3e 0d 0a 42 75 74 20 77 68 65 6e 20 79 6f 75 20 >..But when you
0bc0: 63 6f 6e 73 69 64 65 72 20 74 68 61 74 27 73 20 consider that's
0bd0: 74 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 69 the first time i
0be0: 6e 20 69 74 73 20 76 65 72 79 20 6c 6f 6e 67 20 n its very long
0bf0: 6c 69 66 65 20 74 68 61 74 20 50 52 4f 4a 20 72 life that PROJ r
0c00: 65 71 75 69 72 65 73 20 61 6e 20 65 78 74 72 61 equires an extra
0c10: 20 65 66 66 6f 72 74 20 69 6e 20 6f 72 64 65 72 effort in order
0c20: 20 74 6f 20 69 6e 74 72 6f 64 75 63 65 20 73 6f to introduce so
0c30: 20 6d 61 6e 79 20 75 73 65 66 75 6c 20 69 6e 6e many useful inn
0c40: 6f 76 61 74 69 6f 6e 73 2c 20 74 68 69 73 20 75 ovations, this u
0c50: 6e 65 78 70 65 63 74 65 64 20 41 50 49 20 62 72 nexpected API br
0c60: 65 61 6b 61 67 65 20 6c 6f 6f 6b 73 20 66 75 6c eakage looks ful
0c70: 6c 79 20 6a 75 73 74 69 66 69 65 64 20 61 6e 64 ly justified and
0c80: 20 61 62 73 6f 6c 75 74 65 6c 79 20 72 65 61 73 absolutely reas
0c90: 6f 6e 61 62 6c 65 2e 3c 62 72 3e 3c 62 72 3e 0d onable.<br><br>.
0ca0: 0a 3c 62 3e 3c 75 3e 4d 6f 72 65 20 64 65 74 61 .<b><u>More deta
0cb0: 69 6c 73 20 61 62 6f 75 74 20 74 68 65 20 41 50 ils about the AP
0cc0: 49 20 62 72 65 61 6b 61 67 65 3c 2f 75 3e 3c 2f I breakage</u></
0cd0: 62 3e 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c b>:..<ul>..<li><
0ce0: 62 3e 50 52 4f 4a 2e 35 3c 2f 62 3e 20 73 74 61 b>PROJ.5</b> sta
0cf0: 72 74 65 64 20 69 6e 74 72 6f 64 75 63 69 6e 67 rted introducing
0d00: 20 74 68 65 20 6e 65 77 20 41 50 49 2c 20 62 75 the new API, bu
0d10: 74 20 77 61 73 20 73 74 69 6c 6c 20 61 62 6c 65 t was still able
0d20: 20 74 6f 20 73 75 70 70 6f 72 74 20 74 68 65 20 to support the
0d30: 6f 6c 64 20 74 72 61 64 69 74 69 6f 6e 61 6c 20 old traditional
0d40: 41 50 49 20 77 69 74 68 6f 75 74 20 61 6e 79 20 API without any
0d50: 63 6f 6d 70 6c 61 69 6e 74 2e 3c 2f 6c 69 3e 0d complaint.</li>.
0d60: 0a 3c 6c 69 3e 3c 62 3e 50 52 4f 4a 2e 36 3c 2f .<li><b>PROJ.6</
0d70: 62 3e 20 68 61 76 65 20 64 65 70 72 65 63 61 74 b> have deprecat
0d80: 65 64 20 74 68 65 20 6f 6c 64 20 74 72 61 64 69 ed the old tradi
0d90: 74 69 6f 6e 61 6c 20 41 50 49 2e 3c 62 72 3e 0d tional API.<br>.
0da0: 0a 49 74 20 73 74 69 6c 6c 20 63 6f 6e 74 69 6e .It still contin
0db0: 75 65 73 20 74 6f 20 62 65 20 72 65 6c 75 63 74 ues to be reluct
0dc0: 61 6e 74 6c 79 20 73 75 70 70 6f 72 74 65 64 2c antly supported,
0dd0: 20 62 75 74 20 74 68 65 20 6c 69 62 72 61 72 79 but the library
0de0: 20 72 65 71 75 69 72 65 73 20 74 6f 20 62 65 20 requires to be
0df0: 63 6f 6d 70 69 6c 65 64 20 62 79 20 65 78 70 6c compiled by expl
0e00: 69 63 69 74 6c 79 20 64 65 66 69 6e 69 6e 67 20 icitly defining
0e10: 61 20 3c 62 3e 2d 44 41 43 43 45 50 54 5f 55 53 a <b>-DACCEPT_US
0e20: 45 5f 4f 46 5f 44 45 50 52 45 43 41 54 45 44 5f E_OF_DEPRECATED_
0e30: 50 52 4f 4a 5f 41 50 49 5f 48 3d 31 3c 2f 62 3e PROJ_API_H=1</b>
0e40: 20 64 69 72 65 63 74 69 76 65 20 69 6e 20 6f 72 directive in or
0e50: 64 65 72 20 74 6f 20 65 66 66 65 63 74 69 76 65 der to effective
0e60: 6c 79 20 65 6e 61 62 6c 65 20 74 68 69 73 20 6f ly enable this o
0e70: 70 74 69 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 ption.</li>..<li
0e80: 3e 61 6e 64 20 66 69 6e 61 6c 6c 79 20 74 68 65 >and finally the
0e90: 20 6e 65 78 74 2d 74 6f 2d 63 6f 6d 65 20 3c 62 next-to-come <b
0ea0: 3e 50 52 4f 4a 2e 37 3c 2f 62 3e 20 77 69 6c 6c >PROJ.7</b> will
0eb0: 20 63 6f 6d 70 6c 65 74 65 6c 79 20 67 65 74 20 completely get
0ec0: 72 69 64 20 6f 66 20 74 68 65 20 6f 6c 64 20 41 rid of the old A
0ed0: 50 49 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d PI.</li>..</ul>.
0ee0: 0a 3c 62 72 3e 0d 0a 3c 68 72 3e 0d 0a 3c 68 31 .<br>..<hr>..<h1
0ef0: 3e 57 68 61 74 27 73 20 6e 65 77 20 69 6e 20 50 >What's new in P
0f00: 52 4f 4a 2e 36 3c 2f 68 31 3e 0d 0a 3c 68 33 3e ROJ.6</h1>..<h3>
0f10: 46 75 6c 6c 79 20 73 75 70 70 6f 72 74 69 6e 67 Fully supporting
0f20: 20 49 53 4f 20 31 39 31 36 32 3a 32 30 31 38 20 ISO 19162:2018
0f30: 57 4b 54 3c 2f 68 33 3e 0d 0a 4f 6c 64 20 76 65 WKT</h3>..Old ve
0f40: 72 73 69 6f 6e 73 20 6f 66 20 50 52 4f 4a 20 28 rsions of PROJ (
0f50: 69 6e 63 6c 75 64 69 6e 67 20 3c 62 3e 50 52 4f including <b>PRO
0f60: 4a 2e 34 3c 2f 62 3e 29 20 72 65 71 75 69 72 65 J.4</b>) require
0f70: 64 20 74 6f 20 64 65 66 69 6e 65 20 65 61 63 68 d to define each
0f80: 20 3c 62 3e 43 52 53 3c 2f 62 3e 20 28 3c 69 3e <b>CRS</b> (<i>
0f90: 43 6f 6f 72 64 69 6e 61 74 65 20 52 65 66 65 72 Coordinate Refer
0fa0: 65 6e 63 65 20 53 79 73 74 65 6d 3c 2f 69 3e 29 ence System</i>)
0fb0: 20 62 79 20 61 20 63 6f 72 72 65 73 70 6f 6e 64 by a correspond
0fc0: 69 6e 67 20 3c 62 3e 70 72 6f 6a 2d 73 74 72 69 ing <b>proj-stri
0fd0: 6e 67 3c 2f 62 3e 2e 0d 0a 54 68 65 20 66 6f 6c ng</b>...The fol
0fe0: 6c 6f 77 69 6e 67 20 74 61 62 6c 65 20 65 78 65 lowing table exe
0ff0: 6d 70 6c 69 66 69 65 73 20 74 68 65 20 63 61 73 mplifies the cas
1000: 65 20 6f 66 20 66 65 77 20 43 52 53 65 73 3a 3c e of few CRSes:<
1010: 62 72 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 br><br>..<table
1020: 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 cellspacing="8"
1030: 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 38 22 20 cellpadding="8"
1040: 62 67 63 6f 6c 6f 72 3d 22 23 65 38 66 66 65 38 bgcolor="#e8ffe8
1050: 22 20 62 6f 72 64 65 72 3d 22 31 22 3e 0d 0a 3c " border="1">..<
1060: 74 72 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 tr><th bgcolor="
1070: 23 66 66 62 30 33 65 22 3e 53 52 49 44 3c 2f 74 #ffb03e">SRID</t
1080: 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 h><th bgcolor="#
1090: 66 66 62 30 33 65 22 3e 43 52 53 20 4e 61 6d 65 ffb03e">CRS Name
10a0: 3c 2f 74 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 </th><th bgcolor
10b0: 3d 22 23 66 66 62 30 33 65 22 3e 70 72 6f 6a 2d ="#ffb03e">proj-
10c0: 73 74 72 69 6e 67 20 28 50 52 4f 4a 2e 34 20 73 string (PROJ.4 s
10d0: 74 79 6c 65 29 3c 2f 74 68 3e 3c 74 68 20 62 67 tyle)</th><th bg
10e0: 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 3e color="#ffb03e">
10f0: 70 72 6f 6a 2d 73 74 72 69 6e 67 20 28 50 52 4f proj-string (PRO
1100: 4a 2e 36 20 73 74 79 6c 65 29 3c 2f 74 68 3e 3c J.6 style)</th><
1110: 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 20 61 6c /tr>..<tr><td al
1120: 69 67 6e 3d 22 72 69 67 68 74 22 3e 33 30 30 33 ign="right">3003
1130: 3c 2f 74 64 3e 3c 74 64 3e 4d 6f 6e 74 65 20 4d </td><td>Monte M
1140: 61 72 69 6f 20 2f 20 49 74 61 6c 79 20 7a 6f 6e ario / Italy zon
1150: 65 20 31 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 2b 70 e 1</td>..<td>+p
1160: 72 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 5f 30 roj=tmerc +lat_0
1170: 3d 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 =0 +lon_0=9 +k=0
1180: 2e 39 39 39 36 20 2b 78 5f 30 3d 31 35 30 30 30 .9996 +x_0=15000
1190: 30 30 20 2b 79 5f 30 3d 30 20 5c 3c 62 72 3e 0d 00 +y_0=0 \<br>.
11a0: 0a 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20 2b 74 6f .+ellps=intl +to
11b0: 77 67 73 38 34 3d 2d 31 30 34 2e 31 2c 2d 34 39 wgs84=-104.1,-49
11c0: 2e 31 2c 2d 39 2e 39 2c 30 2e 39 37 31 2c 2d 32 .1,-9.9,0.971,-2
11d0: 2e 39 31 37 2c 30 2e 37 31 34 2c 2d 31 31 2e 36 .917,0.714,-11.6
11e0: 38 20 2b 75 6e 69 74 73 3d 6d 20 2b 6e 6f 5f 64 8 +units=m +no_d
11f0: 65 66 73 3c 2f 74 64 3e 3c 74 64 3e 2b 70 72 6f efs</td><td>+pro
1200: 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 5f 30 3d 30 j=tmerc +lat_0=0
1210: 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 2e 39 +lon_0=9 +k=0.9
1220: 39 39 36 20 2b 78 5f 30 3d 31 35 30 30 30 30 30 996 +x_0=1500000
1230: 20 2b 79 5f 30 3d 30 20 5c 3c 62 72 3e 0d 0a 2b +y_0=0 \<br>..+
1240: 65 6c 6c 70 73 3d 69 6e 74 6c 20 2b 75 6e 69 74 ellps=intl +unit
1250: 73 3d 6d 20 2b 6e 6f 5f 64 65 66 73 20 2b 74 79 s=m +no_defs +ty
1260: 70 65 3d 63 72 73 3c 2f 74 64 3e 3c 2f 74 72 3e pe=crs</td></tr>
1270: 0d 0a 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e 3d ..<tr><td align=
1280: 22 72 69 67 68 74 22 3e 34 33 32 36 3c 2f 74 64 "right">4326</td
1290: 3e 3c 74 64 3e 57 47 53 20 38 34 3c 2f 74 64 3e ><td>WGS 84</td>
12a0: 0d 0a 3c 74 64 3e 2b 70 72 6f 6a 3d 6c 6f 6e 67 ..<td>+proj=long
12b0: 6c 61 74 20 2b 64 61 74 75 6d 3d 57 47 53 38 34 lat +datum=WGS84
12c0: 20 2b 6e 6f 5f 64 65 66 73 3c 2f 74 64 3e 3c 74 +no_defs</td><t
12d0: 64 3e 2b 70 72 6f 6a 3d 6c 6f 6e 67 6c 61 74 20 d>+proj=longlat
12e0: 2b 64 61 74 75 6d 3d 57 47 53 38 34 20 2b 6e 6f +datum=WGS84 +no
12f0: 5f 64 65 66 73 20 2b 74 79 70 65 3d 63 72 73 3c _defs +type=crs<
1300: 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c /td></tr>..<tr><
1310: 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 td align="right"
1320: 3e 33 32 36 33 32 3c 2f 74 64 3e 3c 74 64 3e 57 >32632</td><td>W
1330: 47 53 20 38 34 20 2f 20 55 54 4d 20 7a 6f 6e 65 GS 84 / UTM zone
1340: 20 33 32 4e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 2b 32N</td>..<td>+
1350: 70 72 6f 6a 3d 75 74 6d 20 2b 7a 6f 6e 65 3d 33 proj=utm +zone=3
1360: 32 20 2b 64 61 74 75 6d 3d 57 47 53 38 34 20 2b 2 +datum=WGS84 +
1370: 75 6e 69 74 73 3d 6d 20 2b 6e 6f 5f 64 65 66 73 units=m +no_defs
1380: 3c 2f 74 64 3e 3c 74 64 3e 2b 70 72 6f 6a 3d 75 </td><td>+proj=u
1390: 74 6d 20 2b 7a 6f 6e 65 3d 33 32 20 2b 64 61 74 tm +zone=32 +dat
13a0: 75 6d 3d 57 47 53 38 34 20 2b 75 6e 69 74 73 3d um=WGS84 +units=
13b0: 6d 20 2b 6e 6f 5f 64 65 66 73 20 2b 74 79 70 65 m +no_defs +type
13c0: 3d 63 72 73 3c 2f 74 64 3e 0d 0a 3c 2f 74 61 62 =crs</td>..</tab
13d0: 6c 65 3e 0d 0a 3c 62 72 3e 0d 0a 50 52 4f 4a 2e le>..<br>..PROJ.
13e0: 36 20 73 74 69 6c 6c 20 63 6f 6e 74 69 6e 75 65 6 still continue
13f0: 73 20 74 6f 20 73 75 70 70 6f 72 74 20 74 68 65 s to support the
1400: 20 6f 6c 64 20 70 72 6f 6a 2d 73 74 72 69 6e 67 old proj-string
1410: 73 2c 20 62 75 74 20 69 74 20 6e 6f 77 20 61 64 s, but it now ad
1420: 6f 70 74 73 20 61 20 73 6c 69 67 68 74 6c 79 20 opts a slightly
1430: 63 68 61 6e 67 65 64 20 6e 6f 74 61 74 69 6f 6e changed notation
1440: 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 74 68 65 :..<ul>..<li>the
1450: 72 65 20 69 73 20 61 20 6e 65 77 20 3c 62 3e 2b re is a new <b>+
1460: 74 79 70 65 3d 63 72 73 3c 2f 62 3e 20 6d 65 6d type=crs</b> mem
1470: 62 65 72 20 65 78 70 6c 69 63 69 74 6c 79 20 73 ber explicitly s
1480: 74 61 74 69 6e 67 20 74 68 61 74 20 74 68 65 20 tating that the
1490: 73 74 72 69 6e 67 20 69 73 20 69 6e 74 65 6e 64 string is intend
14a0: 65 64 20 74 6f 20 62 65 20 43 52 53 20 64 65 66 ed to be CRS def
14b0: 69 6e 69 74 69 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c inition.</li>..<
14c0: 6c 69 3e 61 73 20 61 20 67 65 6e 65 72 61 6c 20 li>as a general
14d0: 72 75 6c 65 20 74 68 65 20 3c 62 3e 2b 74 6f 77 rule the <b>+tow
14e0: 67 73 38 34 3d 3c 2f 62 3e 20 6d 65 6d 62 65 72 gs84=</b> member
14f0: 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 73 75 is no longer su
1500: 70 70 6f 72 74 65 64 2e 3c 62 72 3e 0d 0a 3c 62 pported.<br>..<b
1510: 3e 4e 6f 74 65 3c 2f 62 3e 3a 20 74 68 69 73 20 >Note</b>: this
1520: 69 73 20 61 20 76 65 72 79 20 63 72 69 74 69 63 is a very critic
1530: 61 6c 20 63 68 61 6e 67 65 2c 20 74 68 61 74 20 al change, that
1540: 63 61 6e 20 65 61 73 69 6c 79 20 6c 65 61 64 20 can easily lead
1550: 74 6f 20 75 6e 65 78 70 65 63 74 65 64 20 72 65 to unexpected re
1560: 73 75 6c 74 2e 3c 62 72 3e 0d 0a 4a 75 73 74 20 sult.<br>..Just
1570: 61 73 20 61 6e 20 65 78 61 6d 70 6c 65 2c 20 69 as an example, i
1580: 6e 20 74 68 65 20 63 61 73 65 20 6f 66 20 3c 62 n the case of <b
1590: 3e 45 50 53 47 3a 33 30 30 33 20 3c 69 3e 28 49 >EPSG:3003 <i>(I
15a0: 74 61 6c 79 20 6d 61 69 6e 6c 61 6e 64 29 3c 2f taly mainland)</
15b0: 69 3e 3c 2f 62 3e 20 73 75 70 70 72 65 73 73 69 i></b> suppressi
15c0: 6e 67 20 74 68 65 20 3c 62 3e 2b 74 6f 77 67 73 ng the <b>+towgs
15d0: 38 34 3c 2f 62 3e 20 6d 65 6d 62 65 72 20 63 61 84</b> member ca
15e0: 75 73 65 73 20 61 20 73 68 69 66 74 20 6f 66 20 uses a shift of
15f0: 61 62 6f 75 74 20 3c 62 3e 31 30 30 6d 3c 2f 62 about <b>100m</b
1600: 3e 20 69 6e 20 63 6f 6f 72 64 69 6e 61 74 65 20 > in coordinate
1610: 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 73 2e transformations.
1620: 20 42 65 20 77 61 72 6e 65 64 2e 3c 2f 6c 69 3e Be warned.</li>
1630: 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 62 72 3e 0d 0a 41 ..</ul>..<br>..A
1640: 6c 74 68 6f 75 67 68 20 6e 65 77 20 76 65 72 73 lthough new vers
1650: 69 6f 6e 73 20 6f 66 20 50 52 4f 4a 20 28 73 74 ions of PROJ (st
1660: 61 72 74 69 6e 67 20 73 69 6e 63 65 20 3c 62 3e arting since <b>
1670: 50 52 4f 4a 2e 36 3c 2f 62 3e 29 20 73 74 69 6c PROJ.6</b>) stil
1680: 6c 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20 73 75 l continue to su
1690: 70 70 6f 72 74 20 74 68 65 20 6f 6c 64 20 3c 62 pport the old <b
16a0: 3e 70 72 6f 6a 2d 73 74 72 69 6e 67 73 3c 2f 62 >proj-strings</b
16b0: 3e 2c 20 74 68 69 73 20 69 73 20 6e 6f 20 6c 6f >, this is no lo
16c0: 6e 67 65 72 20 74 68 65 20 70 72 65 66 65 72 72 nger the preferr
16d0: 65 64 20 6e 6f 74 61 74 69 6f 6e 20 66 6f 72 20 ed notation for
16e0: 64 65 66 69 6e 69 6e 67 20 61 20 43 52 53 2e 3c defining a CRS.<
16f0: 62 72 3e 0d 0a 4e 6f 77 20 74 68 65 20 70 72 65 br>..Now the pre
1700: 66 65 72 72 65 64 20 6e 6f 74 61 74 69 6f 6e 20 ferred notation
1710: 69 73 20 66 75 6c 6c 79 20 63 6f 6e 66 6f 72 6d is fully conform
1720: 61 6e 74 20 74 6f 20 74 68 65 20 3c 62 3e 49 53 ant to the <b>IS
1730: 4f 20 31 39 31 36 32 3a 32 30 31 38 3c 2f 62 3e O 19162:2018</b>
1740: 20 69 6e 74 65 72 6e 61 74 69 6f 6e 61 6c 20 73 international s
1750: 74 61 6e 64 61 72 64 0d 0a 28 3c 69 3e 4f 47 43 tandard..(<i>OGC
1760: 20 41 62 73 74 72 61 63 74 20 53 70 65 63 69 66 Abstract Specif
1770: 69 63 61 74 69 6f 6e 20 54 6f 70 69 63 20 32 3a ication Topic 2:
1780: 20 e2 80 9c 52 65 66 65 72 65 6e 63 69 6e 67 20 ...Referencing
1790: 42 79 20 43 6f 6f 72 64 69 6e 61 74 65 73 e2 80 By Coordinates..
17a0: 9d 3c 2f 69 3e 29 2e 3c 62 72 3e 0d 0a 54 68 65 .</i>).<br>..The
17b0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 61 62 6c 65 following table
17c0: 20 65 78 65 6d 70 6c 69 66 69 65 73 20 74 68 65 exemplifies the
17d0: 20 73 61 6d 65 20 43 52 53 65 73 20 61 73 20 61 same CRSes as a
17e0: 62 6f 76 65 20 69 6e 20 74 68 65 20 6d 6f 72 65 bove in the more
17f0: 20 72 65 63 65 6e 74 20 49 53 4f 20 57 4b 54 20 recent ISO WKT
1800: 6e 6f 74 61 74 69 6f 6e 3a 0d 0a 3c 62 72 3e 3c notation:..<br><
1810: 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c br>..<table cell
1820: 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c spacing="8" cell
1830: 70 61 64 64 69 6e 67 3d 22 38 22 20 62 67 63 6f padding="8" bgco
1840: 6c 6f 72 3d 22 23 65 38 66 66 65 38 22 20 62 6f lor="#e8ffe8" bo
1850: 72 64 65 72 3d 22 31 22 3e 0d 0a 3c 74 72 3e 3c rder="1">..<tr><
1860: 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 th bgcolor="#ffb
1870: 30 33 65 22 3e 53 52 49 44 3c 2f 74 68 3e 3c 74 03e">SRID</th><t
1880: 64 3e 33 30 30 33 3c 2f 74 64 3e 3c 74 64 3e 34 d>3003</td><td>4
1890: 33 32 36 3c 2f 74 64 3e 3c 74 64 3e 33 32 36 33 326</td><td>3263
18a0: 32 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 2</td></tr>..<tr
18b0: 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 ><th bgcolor="#f
18c0: 66 62 30 33 65 22 3e 43 52 53 20 4e 61 6d 65 3c fb03e">CRS Name<
18d0: 2f 74 68 3e 3c 74 64 3e 4d 6f 6e 74 65 20 4d 61 /th><td>Monte Ma
18e0: 72 69 6f 20 2f 20 49 74 61 6c 79 20 7a 6f 6e 65 rio / Italy zone
18f0: 20 31 3c 2f 74 64 3e 3c 2f 74 64 3e 3c 74 64 3e 1</td></td><td>
1900: 57 47 53 20 38 34 3c 2f 74 64 3e 3c 74 64 3e 57 WGS 84</td><td>W
1910: 47 53 20 38 34 20 2f 20 55 54 4d 20 7a 6f 6e 65 GS 84 / UTM zone
1920: 20 33 32 4e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 32N</td></tr>..
1930: 3c 74 72 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d <tr><th bgcolor=
1940: 22 23 66 66 62 30 33 65 22 3e 49 53 4f 2d 32 30 "#ffb03e">ISO-20
1950: 31 38 20 57 4b 54 3c 2f 74 68 3e 0d 0a 3c 74 64 18 WKT</th>..<td
1960: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 3c 76 valign="top"><v
1970: 65 72 62 61 74 69 6d 3e 0d 0a 50 52 4f 4a 43 52 erbatim>..PROJCR
1980: 53 5b 22 4d 6f 6e 74 65 20 4d 61 72 69 6f 20 2f S["Monte Mario /
1990: 20 49 74 61 6c 79 20 7a 6f 6e 65 20 31 22 2c 0d Italy zone 1",.
19a0: 0a 20 20 20 20 42 41 53 45 47 45 4f 44 43 52 53 . BASEGEODCRS
19b0: 5b 22 4d 6f 6e 74 65 20 4d 61 72 69 6f 22 2c 0d ["Monte Mario",.
19c0: 0a 20 20 20 20 20 20 20 20 44 41 54 55 4d 5b 22 . DATUM["
19d0: 4d 6f 6e 74 65 20 4d 61 72 69 6f 22 2c 3c 62 72 Monte Mario",<br
19e0: 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 45 >.. E
19f0: 4c 4c 49 50 53 4f 49 44 5b 22 49 6e 74 65 72 6e LLIPSOID["Intern
1a00: 61 74 69 6f 6e 61 6c 20 31 39 32 34 22 2c 36 33 ational 1924",63
1a10: 37 38 33 38 38 2c 32 39 37 2c 0d 0a 20 20 20 20 78388,297,..
1a20: 20 20 20 20 20 20 20 20 20 20 20 20 4c 45 4e 47 LENG
1a30: 54 48 55 4e 49 54 5b 22 6d 65 74 72 65 22 2c 31 THUNIT["metre",1
1a40: 5d 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 52 ]]],.. PR
1a50: 49 4d 45 4d 5b 22 47 72 65 65 6e 77 69 63 68 22 IMEM["Greenwich"
1a60: 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ,0,..
1a70: 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 ANGLEUNIT["degr
1a80: 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 ee",0.0174532925
1a90: 31 39 39 34 33 33 5d 5d 5d 2c 0d 0a 20 20 20 20 199433]]],..
1aa0: 43 4f 4e 56 45 52 53 49 4f 4e 5b 22 49 74 61 6c CONVERSION["Ital
1ab0: 79 20 7a 6f 6e 65 20 31 22 2c 0d 0a 20 20 20 20 y zone 1",..
1ac0: 20 20 20 20 4d 45 54 48 4f 44 5b 22 54 72 61 6e METHOD["Tran
1ad0: 73 76 65 72 73 65 20 4d 65 72 63 61 74 6f 72 22 sverse Mercator"
1ae0: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 ,.. I
1af0: 44 5b 22 45 50 53 47 22 2c 39 38 30 37 5d 5d 2c D["EPSG",9807]],
1b00: 0d 0a 20 20 20 20 20 20 20 20 50 41 52 41 4d 45 .. PARAME
1b10: 54 45 52 5b 22 4c 61 74 69 74 75 64 65 20 6f 66 TER["Latitude of
1b20: 20 6e 61 74 75 72 61 6c 20 6f 72 69 67 69 6e 22 natural origin"
1b30: 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ,0,..
1b40: 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 ANGLEUNIT["degr
1b50: 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 ee",0.0174532925
1b60: 31 39 39 34 33 33 5d 2c 0d 0a 20 20 20 20 20 20 199433],..
1b70: 20 20 20 20 20 20 49 44 5b 22 45 50 53 47 22 2c ID["EPSG",
1b80: 38 38 30 31 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 8801]],..
1b90: 20 50 41 52 41 4d 45 54 45 52 5b 22 4c 6f 6e 67 PARAMETER["Long
1ba0: 69 74 75 64 65 20 6f 66 20 6e 61 74 75 72 61 6c itude of natural
1bb0: 20 6f 72 69 67 69 6e 22 2c 39 2c 0d 0a 20 20 20 origin",9,..
1bc0: 20 20 20 20 20 20 20 20 20 41 4e 47 4c 45 55 4e ANGLEUN
1bd0: 49 54 5b 22 64 65 67 72 65 65 22 2c 30 2e 30 31 IT["degree",0.01
1be0: 37 34 35 33 32 39 32 35 31 39 39 34 33 33 5d 2c 74532925199433],
1bf0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 44 .. ID
1c00: 5b 22 45 50 53 47 22 2c 38 38 30 32 5d 5d 2c 0d ["EPSG",8802]],.
1c10: 0a 20 20 20 20 20 20 20 20 50 41 52 41 4d 45 54 . PARAMET
1c20: 45 52 5b 22 53 63 61 6c 65 20 66 61 63 74 6f 72 ER["Scale factor
1c30: 20 61 74 20 6e 61 74 75 72 61 6c 20 6f 72 69 67 at natural orig
1c40: 69 6e 22 2c 30 2e 39 39 39 36 2c 0d 0a 20 20 20 in",0.9996,..
1c50: 20 20 20 20 20 20 20 20 20 53 43 41 4c 45 55 4e SCALEUN
1c60: 49 54 5b 22 75 6e 69 74 79 22 2c 31 5d 2c 0d 0a IT["unity",1],..
1c70: 20 20 20 20 20 20 20 20 20 20 20 20 49 44 5b 22 ID["
1c80: 45 50 53 47 22 2c 38 38 30 35 5d 5d 2c 0d 0a 20 EPSG",8805]],..
1c90: 20 20 20 20 20 20 20 50 41 52 41 4d 45 54 45 52 PARAMETER
1ca0: 5b 22 46 61 6c 73 65 20 65 61 73 74 69 6e 67 22 ["False easting"
1cb0: 2c 31 35 30 30 30 30 30 2c 0d 0a 20 20 20 20 20 ,1500000,..
1cc0: 20 20 20 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 LENGTHUNI
1cd0: 54 5b 22 6d 65 74 72 65 22 2c 31 5d 2c 0d 0a 20 T["metre",1],..
1ce0: 20 20 20 20 20 20 20 20 20 20 20 49 44 5b 22 45 ID["E
1cf0: 50 53 47 22 2c 38 38 30 36 5d 5d 2c 0d 0a 20 20 PSG",8806]],..
1d00: 20 20 20 20 20 20 50 41 52 41 4d 45 54 45 52 5b PARAMETER[
1d10: 22 46 61 6c 73 65 20 6e 6f 72 74 68 69 6e 67 22 "False northing"
1d20: 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ,0,..
1d30: 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 74 LENGTHUNIT["met
1d40: 72 65 22 2c 31 5d 2c 0d 0a 20 20 20 20 20 20 20 re",1],..
1d50: 20 20 20 20 20 49 44 5b 22 45 50 53 47 22 2c 38 ID["EPSG",8
1d60: 38 30 37 5d 5d 5d 2c 0d 0a 20 20 20 20 43 53 5b 807]]],.. CS[
1d70: 43 61 72 74 65 73 69 61 6e 2c 32 5d 2c 0d 0a 20 Cartesian,2],..
1d80: 20 20 20 20 20 20 20 41 58 49 53 5b 22 65 61 73 AXIS["eas
1d90: 74 69 6e 67 20 28 58 29 22 2c 65 61 73 74 2c 0d ting (X)",east,.
1da0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 4f 52 44 . ORD
1db0: 45 52 5b 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 ER[1],..
1dc0: 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 LENGTHUNIT["
1dd0: 6d 65 74 72 65 22 2c 31 5d 5d 2c 0d 0a 20 20 20 metre",1]],..
1de0: 20 20 20 20 20 41 58 49 53 5b 22 6e 6f 72 74 68 AXIS["north
1df0: 69 6e 67 20 28 59 29 22 2c 6e 6f 72 74 68 2c 0d ing (Y)",north,.
1e00: 0a 20 20 20 20 20 20 20 20 20 20 20 20 4f 52 44 . ORD
1e10: 45 52 5b 32 5d 2c 3c 62 72 3e 0d 0a 20 20 20 20 ER[2],<br>..
1e20: 20 20 20 20 20 20 20 20 4c 45 4e 47 54 48 55 4e LENGTHUN
1e30: 49 54 5b 22 6d 65 74 72 65 22 2c 31 5d 5d 2c 0d IT["metre",1]],.
1e40: 0a 20 20 20 20 41 52 45 41 5b 22 49 74 61 6c 79 . AREA["Italy
1e50: 20 2d 20 77 65 73 74 20 6f 66 20 31 32 c2 b0 45 - west of 12..E
1e60: 22 5d 2c 0d 0a 20 20 20 20 42 42 4f 58 5b 33 36 "],.. BBOX[36
1e70: 2e 35 33 2c 35 2e 39 34 2c 34 37 2e 30 34 2c 31 .53,5.94,47.04,1
1e80: 32 5d 2c 0d 0a 20 20 20 20 49 44 5b 22 45 50 53 2],.. ID["EPS
1e90: 47 22 2c 33 30 30 33 5d 5d 0d 0a 3c 2f 76 65 72 G",3003]]..</ver
1ea0: 62 61 74 69 6d 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 batim></td>..<td
1eb0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 3c 76 valign="top"><v
1ec0: 65 72 62 61 74 69 6d 3e 0d 0a 47 45 4f 44 43 52 erbatim>..GEODCR
1ed0: 53 5b 22 57 47 53 20 38 34 22 2c 0d 0a 20 20 20 S["WGS 84",..
1ee0: 20 44 41 54 55 4d 5b 22 57 6f 72 6c 64 20 47 65 DATUM["World Ge
1ef0: 6f 64 65 74 69 63 20 53 79 73 74 65 6d 20 31 39 odetic System 19
1f00: 38 34 22 2c 0d 0a 20 20 20 20 20 20 20 20 45 4c 84",.. EL
1f10: 4c 49 50 53 4f 49 44 5b 22 57 47 53 20 38 34 22 LIPSOID["WGS 84"
1f20: 2c 36 33 37 38 31 33 37 2c 32 39 38 2e 32 35 37 ,6378137,298.257
1f30: 32 32 33 35 36 33 2c 0d 0a 20 20 20 20 20 20 20 223563,..
1f40: 20 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b LENGTHUNIT[
1f50: 22 6d 65 74 72 65 22 2c 31 5d 5d 5d 2c 0d 0a 20 "metre",1]]],..
1f60: 20 20 20 50 52 49 4d 45 4d 5b 22 47 72 65 65 6e PRIMEM["Green
1f70: 77 69 63 68 22 2c 30 2c 0d 0a 20 20 20 20 20 20 wich",0,..
1f80: 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 ANGLEUNIT["deg
1f90: 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 ree",0.017453292
1fa0: 35 31 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20 5199433]],..
1fb0: 43 53 5b 65 6c 6c 69 70 73 6f 69 64 61 6c 2c 32 CS[ellipsoidal,2
1fc0: 5d 2c 0d 0a 20 20 20 20 20 20 20 20 41 58 49 53 ],.. AXIS
1fd0: 5b 22 67 65 6f 64 65 74 69 63 20 6c 61 74 69 74 ["geodetic latit
1fe0: 75 64 65 20 28 4c 61 74 29 22 2c 6e 6f 72 74 68 ude (Lat)",north
1ff0: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4f ,.. O
2000: 52 44 45 52 5b 31 5d 2c 0d 0a 20 20 20 20 20 20 RDER[1],..
2010: 20 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b ANGLEUNIT[
2020: 22 64 65 67 72 65 65 22 2c 30 2e 30 31 37 34 35 "degree",0.01745
2030: 33 32 39 32 35 31 39 39 34 33 33 5d 5d 2c 0d 0a 32925199433]],..
2040: 20 20 20 20 20 20 20 20 41 58 49 53 5b 22 67 65 AXIS["ge
2050: 6f 64 65 74 69 63 20 6c 6f 6e 67 69 74 75 64 65 odetic longitude
2060: 20 28 4c 6f 6e 29 22 2c 65 61 73 74 2c 0d 0a 20 (Lon)",east,..
2070: 20 20 20 20 20 20 20 20 20 20 20 4f 52 44 45 52 ORDER
2080: 5b 32 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 [2],..
2090: 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 ANGLEUNIT["deg
20a0: 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 ree",0.017453292
20b0: 35 31 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20 5199433]],..
20c0: 41 52 45 41 5b 22 57 6f 72 6c 64 22 5d 2c 0d 0a AREA["World"],..
20d0: 20 20 20 20 42 42 4f 58 5b 2d 39 30 2c 2d 31 38 BBOX[-90,-18
20e0: 30 2c 39 30 2c 31 38 30 5d 2c 0d 0a 20 20 20 20 0,90,180],..
20f0: 49 44 5b 22 45 50 53 47 22 2c 34 33 32 36 5d 5d ID["EPSG",4326]]
2100: 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 3c 2f 74 ..</verbatim></t
2110: 64 3e 0d 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 d>..<td valign="
2120: 74 6f 70 22 3e 3c 76 65 72 62 61 74 69 6d 3e 0d top"><verbatim>.
2130: 0a 50 52 4f 4a 43 52 53 5b 22 57 47 53 20 38 34 .PROJCRS["WGS 84
2140: 20 2f 20 55 54 4d 20 7a 6f 6e 65 20 33 32 4e 22 / UTM zone 32N"
2150: 2c 0d 0a 20 20 20 20 42 41 53 45 47 45 4f 44 43 ,.. BASEGEODC
2160: 52 53 5b 22 57 47 53 20 38 34 22 2c 0d 0a 20 20 RS["WGS 84",..
2170: 20 20 20 20 20 20 44 41 54 55 4d 5b 22 57 6f 72 DATUM["Wor
2180: 6c 64 20 47 65 6f 64 65 74 69 63 20 53 79 73 74 ld Geodetic Syst
2190: 65 6d 20 31 39 38 34 22 2c 0d 0a 20 20 20 20 20 em 1984",..
21a0: 20 20 20 20 20 20 20 45 4c 4c 49 50 53 4f 49 44 ELLIPSOID
21b0: 5b 22 57 47 53 20 38 34 22 2c 36 33 37 38 31 33 ["WGS 84",637813
21c0: 37 2c 32 39 38 2e 32 35 37 32 32 33 35 36 33 2c 7,298.257223563,
21d0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
21e0: 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 LENGTHUNIT["me
21f0: 74 72 65 22 2c 31 5d 5d 5d 2c 0d 0a 20 20 20 20 tre",1]]],..
2200: 20 20 20 20 50 52 49 4d 45 4d 5b 22 47 72 65 65 PRIMEM["Gree
2210: 6e 77 69 63 68 22 2c 30 2c 0d 0a 20 20 20 20 20 nwich",0,..
2220: 20 20 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 ANGLEUNIT
2230: 5b 22 64 65 67 72 65 65 22 2c 30 2e 30 31 37 34 ["degree",0.0174
2240: 35 33 32 39 32 35 31 39 39 34 33 33 5d 5d 5d 2c 532925199433]]],
2250: 0d 0a 20 20 20 20 43 4f 4e 56 45 52 53 49 4f 4e .. CONVERSION
2260: 5b 22 55 54 4d 20 7a 6f 6e 65 20 33 32 4e 22 2c ["UTM zone 32N",
2270: 0d 0a 20 20 20 20 20 20 20 20 4d 45 54 48 4f 44 .. METHOD
2280: 5b 22 54 72 61 6e 73 76 65 72 73 65 20 4d 65 72 ["Transverse Mer
2290: 63 61 74 6f 72 22 2c 0d 0a 20 20 20 20 20 20 20 cator",..
22a0: 20 20 20 20 20 49 44 5b 22 45 50 53 47 22 2c 39 ID["EPSG",9
22b0: 38 30 37 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 807]],..
22c0: 50 41 52 41 4d 45 54 45 52 5b 22 4c 61 74 69 74 PARAMETER["Latit
22d0: 75 64 65 20 6f 66 20 6e 61 74 75 72 61 6c 20 6f ude of natural o
22e0: 72 69 67 69 6e 22 2c 30 2c 0d 0a 20 20 20 20 20 rigin",0,..
22f0: 20 20 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 ANGLEUNIT
2300: 5b 22 64 65 67 72 65 65 22 2c 30 2e 30 31 37 34 ["degree",0.0174
2310: 35 33 32 39 32 35 31 39 39 34 33 33 5d 2c 0d 0a 532925199433],..
2320: 20 20 20 20 20 20 20 20 20 20 20 20 49 44 5b 22 ID["
2330: 45 50 53 47 22 2c 38 38 30 31 5d 5d 2c 0d 0a 20 EPSG",8801]],..
2340: 20 20 20 20 20 20 20 50 41 52 41 4d 45 54 45 52 PARAMETER
2350: 5b 22 4c 6f 6e 67 69 74 75 64 65 20 6f 66 20 6e ["Longitude of n
2360: 61 74 75 72 61 6c 20 6f 72 69 67 69 6e 22 2c 39 atural origin",9
2370: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 41 ,.. A
2380: 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 65 NGLEUNIT["degree
2390: 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 39 ",0.017453292519
23a0: 39 34 33 33 5d 2c 0d 0a 20 20 20 20 20 20 20 20 9433],..
23b0: 20 20 20 20 49 44 5b 22 45 50 53 47 22 2c 38 38 ID["EPSG",88
23c0: 30 32 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 02]],.. P
23d0: 41 52 41 4d 45 54 45 52 5b 22 53 63 61 6c 65 20 ARAMETER["Scale
23e0: 66 61 63 74 6f 72 20 61 74 20 6e 61 74 75 72 61 factor at natura
23f0: 6c 20 6f 72 69 67 69 6e 22 2c 30 2e 39 39 39 36 l origin",0.9996
2400: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 53 ,.. S
2410: 43 41 4c 45 55 4e 49 54 5b 22 75 6e 69 74 79 22 CALEUNIT["unity"
2420: 2c 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 ,1],..
2430: 20 20 49 44 5b 22 45 50 53 47 22 2c 38 38 30 35 ID["EPSG",8805
2440: 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 41 52 ]],.. PAR
2450: 41 4d 45 54 45 52 5b 22 46 61 6c 73 65 20 65 61 AMETER["False ea
2460: 73 74 69 6e 67 22 2c 35 30 30 30 30 30 2c 0d 0a sting",500000,..
2470: 20 20 20 20 20 20 20 20 20 20 20 20 4c 45 4e 47 LENG
2480: 54 48 55 4e 49 54 5b 22 6d 65 74 72 65 22 2c 31 THUNIT["metre",1
2490: 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ],..
24a0: 49 44 5b 22 45 50 53 47 22 2c 38 38 30 36 5d 5d ID["EPSG",8806]]
24b0: 2c 0d 0a 20 20 20 20 20 20 20 20 50 41 52 41 4d ,.. PARAM
24c0: 45 54 45 52 5b 22 46 61 6c 73 65 20 6e 6f 72 74 ETER["False nort
24d0: 68 69 6e 67 22 2c 30 2c 0d 0a 20 20 20 20 20 20 hing",0,..
24e0: 20 20 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 LENGTHUNIT
24f0: 5b 22 6d 65 74 72 65 22 2c 31 5d 2c 0d 0a 20 20 ["metre",1],..
2500: 20 20 20 20 20 20 20 20 20 20 49 44 5b 22 45 50 ID["EP
2510: 53 47 22 2c 38 38 30 37 5d 5d 5d 2c 0d 0a 20 20 SG",8807]]],..
2520: 20 20 43 53 5b 43 61 72 74 65 73 69 61 6e 2c 32 CS[Cartesian,2
2530: 5d 2c 0d 0a 20 20 20 20 20 20 20 20 41 58 49 53 ],.. AXIS
2540: 5b 22 28 45 29 22 2c 65 61 73 74 2c 0d 0a 20 20 ["(E)",east,..
2550: 20 20 20 20 20 20 20 20 20 20 4f 52 44 45 52 5b ORDER[
2560: 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 1],..
2570: 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 74 LENGTHUNIT["met
2580: 72 65 22 2c 31 5d 5d 2c 0d 0a 20 20 20 20 20 20 re",1]],..
2590: 20 20 41 58 49 53 5b 22 28 4e 29 22 2c 6e 6f 72 AXIS["(N)",nor
25a0: 74 68 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 th,..
25b0: 20 4f 52 44 45 52 5b 32 5d 2c 0d 0a 20 20 20 20 ORDER[2],..
25c0: 20 20 20 20 20 20 20 20 4c 45 4e 47 54 48 55 4e LENGTHUN
25d0: 49 54 5b 22 6d 65 74 72 65 22 2c 31 5d 5d 2c 0d IT["metre",1]],.
25e0: 0a 20 20 20 20 41 52 45 41 5b 22 57 6f 72 6c 64 . AREA["World
25f0: 20 2d 20 4e 20 68 65 6d 69 73 70 68 65 72 65 20 - N hemisphere
2600: 2d 20 36 c2 b0 45 20 74 6f 20 31 32 c2 b0 45 20 - 6..E to 12..E
2610: 2d 20 62 79 20 63 6f 75 6e 74 72 79 22 5d 2c 0d - by country"],.
2620: 0a 20 20 20 20 42 42 4f 58 5b 30 2c 36 2c 38 34 . BBOX[0,6,84
2630: 2c 31 32 5d 2c 0d 0a 20 20 20 20 49 44 5b 22 45 ,12],.. ID["E
2640: 50 53 47 22 2c 33 32 36 33 32 5d 5d 0d 0a 3c 2f PSG",32632]]..</
2650: 76 65 72 62 61 74 69 6d 3e 3c 2f 74 64 3e 0d 0a verbatim></td>..
2660: 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 0d </tr>..</table>.
2670: 0a 3c 62 72 3e 0d 0a 41 73 20 79 6f 75 20 63 61 .<br>..As you ca
2680: 6e 20 65 61 73 69 6c 79 20 6e 6f 74 69 63 65 2c n easily notice,
2690: 20 74 68 65 20 74 77 6f 20 6e 6f 74 61 74 69 6f the two notatio
26a0: 6e 73 20 61 72 65 20 70 72 6f 66 6f 75 6e 64 6c ns are profoundl
26b0: 79 20 64 69 66 66 65 72 65 6e 74 2e 0d 0a 54 68 y different...Th
26c0: 65 20 6f 6c 64 20 3c 62 3e 70 72 6f 6a 2d 73 74 e old <b>proj-st
26d0: 72 69 6e 67 3c 2f 62 3e 20 6e 6f 74 61 74 69 6f ring</b> notatio
26e0: 6e 20 69 73 20 65 78 74 72 65 6d 65 6c 79 20 63 n is extremely c
26f0: 6f 6e 63 69 73 65 20 61 6e 64 20 72 6f 75 67 68 oncise and rough
2700: 2c 20 77 68 69 6c 73 74 20 74 68 65 20 6e 65 77 , whilst the new
2710: 20 3c 62 3e 49 53 4f 2d 57 4b 54 3c 2f 62 3e 20 <b>ISO-WKT</b>
2720: 69 73 20 76 65 72 62 6f 73 65 20 62 75 74 20 65 is verbose but e
2730: 78 68 61 75 73 74 69 76 65 2c 20 64 65 74 61 69 xhaustive, detai
2740: 6c 65 64 20 61 6e 64 20 70 72 65 63 69 73 65 2e led and precise.
2750: 3c 62 72 3e 0d 0a 54 68 65 72 65 20 69 73 20 6e <br>..There is n
2760: 6f 20 70 6f 73 73 69 62 6c 65 20 6d 61 74 63 68 o possible match
2770: 3a 20 49 53 4f 2d 57 4b 54 20 69 73 20 63 6c 65 : ISO-WKT is cle
2780: 61 72 6c 79 20 73 75 70 65 72 69 6f 72 20 61 6e arly superior an
2790: 64 20 6d 6f 72 65 20 73 6f 70 68 69 73 74 69 63 d more sophistic
27a0: 61 74 65 64 20 75 6e 64 65 72 20 61 6e 79 20 70 ated under any p
27b0: 6f 73 73 69 62 6c 65 20 61 73 70 65 63 74 2e 3c ossible aspect.<
27c0: 62 72 3e 0d 0a 4e 6f 74 20 61 74 20 61 6c 6c 20 br>..Not at all
27d0: 73 75 72 70 72 69 73 69 6e 67 6c 79 2c 20 63 6f surprisingly, co
27e0: 6f 72 64 69 6e 61 74 65 20 74 72 61 6e 73 66 6f ordinate transfo
27f0: 72 6d 61 74 69 6f 6e 73 20 62 61 73 65 64 20 6f rmations based o
2800: 6e 20 49 53 4f 2d 57 4b 54 20 64 65 66 69 6e 69 n ISO-WKT defini
2810: 74 69 6f 6e 73 20 28 69 6e 73 74 65 61 64 20 6f tions (instead o
2820: 66 20 70 72 6f 6a 2d 73 74 72 69 6e 67 73 29 20 f proj-strings)
2830: 61 72 65 20 75 73 75 61 6c 6c 79 20 65 78 70 65 are usually expe
2840: 63 74 65 64 20 74 6f 20 62 65 20 6d 6f 72 65 20 cted to be more
2850: 61 63 63 75 72 61 74 65 2e 3c 62 72 3e 3c 62 72 accurate.<br><br
2860: 3e 0d 0a 41 6e 64 20 74 68 61 74 27 73 20 6e 6f >..And that's no
2870: 74 20 61 6c 6c 3b 20 74 68 65 20 6f 6c 64 20 3c t all; the old <
2880: 62 3e 70 72 6f 6a 2d 73 74 72 69 6e 67 73 3c 2f b>proj-strings</
2890: 62 3e 20 77 65 72 65 6e 27 74 20 66 6f 72 6d 61 b> weren't forma
28a0: 6c 6c 79 20 64 65 66 69 6e 65 64 20 62 79 20 61 lly defined by a
28b0: 6e 79 20 73 74 61 6e 64 61 72 64 2c 20 61 6e 64 ny standard, and
28c0: 20 6f 6e 6c 79 20 50 52 4f 4a 2c 20 47 44 41 4c only PROJ, GDAL
28d0: 20 61 6e 64 20 66 65 77 20 6f 74 68 65 72 20 46 and few other F
28e0: 4c 4f 53 53 20 2f 20 47 46 4f 53 53 20 69 6d 70 LOSS / GFOSS imp
28f0: 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20 63 6f 75 lementations cou
2900: 6c 64 20 62 65 20 65 78 70 65 63 74 65 64 20 74 ld be expected t
2910: 6f 20 75 6e 64 65 72 73 74 61 6e 64 20 74 68 65 o understand the
2920: 6d 2e 3c 62 72 3e 0d 0a 41 74 20 74 68 65 20 6f m.<br>..At the o
2930: 70 70 6f 73 69 74 65 2c 20 74 68 65 20 6e 65 77 pposite, the new
2940: 20 3c 62 3e 49 53 4f 2d 57 4b 54 3c 2f 62 3e 20 <b>ISO-WKT</b>
2950: 69 73 20 66 6f 72 6d 61 6c 6c 79 20 64 65 66 69 is formally defi
2960: 6e 65 64 20 62 79 20 61 6e 20 69 6e 74 65 72 6e ned by an intern
2970: 61 74 69 6f 6e 61 6c 20 73 74 61 6e 64 61 72 64 ational standard
2980: 2c 20 61 6e 64 20 61 6c 6d 6f 73 74 20 61 6c 6c , and almost all
2990: 20 66 72 65 65 20 61 6e 64 20 70 72 6f 70 72 69 free and propri
29a0: 65 74 61 72 79 20 69 6d 70 6c 65 6d 65 6e 74 61 etary implementa
29b0: 74 69 6f 6e 73 20 61 72 65 20 65 78 70 65 63 74 tions are expect
29c0: 65 64 20 74 6f 20 73 75 70 70 6f 72 74 20 69 74 ed to support it
29d0: 2e 3c 62 72 3e 0d 0a 54 68 69 73 20 69 73 20 61 .<br>..This is a
29e0: 20 76 65 72 79 20 72 65 6c 65 76 61 6e 74 20 63 very relevant c
29f0: 68 61 6e 67 65 20 74 68 61 74 20 65 6e 73 75 72 hange that ensur
2a00: 65 73 20 61 20 72 6f 62 75 73 74 20 63 6f 6d 70 es a robust comp
2a10: 61 74 69 62 69 6c 69 74 79 20 62 65 74 77 65 65 atibility betwee
2a20: 6e 20 64 69 66 66 65 72 65 6e 74 20 61 70 70 6c n different appl
2a30: 69 63 61 74 69 6f 6e 73 2e 3c 62 72 3e 3c 62 72 ications.<br><br
2a40: 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 >..<table cellsp
2a50: 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 acing="8" cellpa
2a60: 64 64 69 6e 67 3d 22 31 36 22 20 62 67 63 6f 6c dding="16" bgcol
2a70: 6f 72 3d 22 23 66 66 66 66 65 39 22 3e 0d 0a 3c or="#ffffe9">..<
2a80: 74 72 3e 3c 74 64 3e 0d 0a 3c 62 3e 3c 75 3e 49 tr><td>..<b><u>I
2a90: 6d 70 6f 72 74 61 6e 74 20 6e 6f 74 69 63 65 3c mportant notice<
2aa0: 2f 75 3e 3c 2f 62 3e 3a 20 74 68 65 72 65 20 61 /u></b>: there a
2ab0: 72 65 20 73 65 76 65 72 61 6c 20 64 69 61 6c 65 re several diale
2ac0: 63 74 73 20 69 6e 20 74 68 65 20 57 4b 54 20 6e cts in the WKT n
2ad0: 6f 74 61 74 69 6f 6e 20 64 65 73 63 72 69 62 69 otation describi
2ae0: 6e 67 20 43 52 53 65 73 2e 3c 62 72 3e 0d 0a 41 ng CRSes.<br>..A
2af0: 6c 6c 20 74 68 65 6d 20 73 68 61 72 65 20 74 68 ll them share th
2b00: 65 20 73 61 6d 65 20 63 6f 6d 6d 6f 6e 20 63 6f e same common co
2b10: 72 65 20 61 6e 64 20 6d 61 69 6e 6c 79 20 64 69 re and mainly di
2b20: 66 66 65 72 20 69 6e 20 66 65 77 20 6d 69 6e 6f ffer in few mino
2b30: 72 20 64 65 74 61 69 6c 73 2e 3c 62 72 3e 0d 0a r details.<br>..
2b40: 50 52 4f 4a 2e 36 20 63 61 6e 20 75 6e 64 65 72 PROJ.6 can under
2b50: 73 74 61 6e 64 20 74 68 65 20 66 6f 6c 6c 6f 77 stand the follow
2b60: 69 6e 67 20 64 69 61 6c 65 63 74 73 3a 0d 0a 3c ing dialects:..<
2b70: 6f 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 45 53 52 49 ol>..<li><b>ESRI
2b80: 20 57 4b 54 3c 2f 62 3e 3a 20 61 20 64 69 61 6c WKT</b>: a dial
2b90: 65 63 74 20 77 69 64 65 6c 79 20 61 64 6f 70 74 ect widely adopt
2ba0: 65 64 20 62 79 20 45 53 52 49 20 70 72 6f 70 72 ed by ESRI propr
2bb0: 69 65 74 61 72 79 20 73 6f 66 74 77 61 72 65 2e ietary software.
2bc0: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 47 44 </li>..<li><b>GD
2bd0: 41 4c 20 57 4b 54 31 3c 2f 62 3e 3a 20 61 20 64 AL WKT1</b>: a d
2be0: 69 61 6c 65 63 74 20 68 69 73 74 6f 72 69 63 61 ialect historica
2bf0: 6c 6c 79 20 73 75 70 70 6f 72 74 65 64 20 62 79 lly supported by
2c00: 20 74 68 65 20 6f 70 65 6e 20 73 6f 75 72 63 65 the open source
2c10: 20 47 44 41 4c 20 6c 69 62 72 61 72 79 2e 3c 2f GDAL library.</
2c20: 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 57 4b 54 32 li>..<li><b>WKT2
2c30: 3a 32 30 31 35 3c 2f 62 3e 3a 20 61 73 20 64 65 :2015</b>: as de
2c40: 66 69 6e 65 64 20 62 79 20 3c 62 3e 49 53 4f 20 fined by <b>ISO
2c50: 31 39 31 36 32 3a 32 30 31 35 3c 2f 62 3e 20 73 19162:2015</b> s
2c60: 74 61 6e 64 61 72 64 20 73 70 65 63 69 66 69 63 tandard specific
2c70: 61 74 69 6f 6e 20 28 6e 6f 77 20 73 75 70 65 72 ation (now super
2c80: 73 65 64 65 64 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c seded).</li>..<l
2c90: 69 3e 3c 62 3e 57 4b 54 32 3a 32 30 31 38 3c 2f i><b>WKT2:2018</
2ca0: 62 3e 3a 20 61 73 20 64 65 66 69 6e 65 64 20 62 b>: as defined b
2cb0: 79 20 74 68 65 20 6d 6f 72 65 20 72 65 63 65 6e y the more recen
2cc0: 74 20 3c 62 3e 49 53 4f 20 31 39 31 36 32 3a 32 t <b>ISO 19162:2
2cd0: 30 31 38 3c 2f 62 3e 20 73 74 61 6e 64 61 72 64 018</b> standard
2ce0: 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 20 2e specification .
2cf0: 3c 2f 6c 69 3e 0d 0a 3c 2f 6f 6c 3e 0d 0a 3c 2f </li>..</ol>..</
2d00: 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c td></tr>..</tabl
2d10: 65 3e 3c 62 72 3e 0d 0a 3c 68 33 3e 54 68 65 20 e><br>..<h3>The
2d20: 70 72 69 76 61 74 65 20 53 51 4c 69 74 65 20 64 private SQLite d
2d30: 61 74 61 62 61 73 65 20 73 75 70 70 6f 72 74 69 atabase supporti
2d40: 6e 67 20 50 52 4f 4a 2e 36 3c 2f 68 33 3e 0d 0a ng PROJ.6</h3>..
2d50: 53 74 61 72 74 69 6e 67 20 73 69 6e 63 65 20 3c Starting since <
2d60: 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 20 74 68 65 b>PROJ.6</b> the
2d70: 20 50 52 4f 4a 20 6c 69 62 72 61 72 79 20 69 73 PROJ library is
2d80: 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 61 20 supported by a
2d90: 70 72 69 76 61 74 65 20 53 51 4c 69 74 65 20 64 private SQLite d
2da0: 61 74 61 62 61 73 65 20 63 6f 6e 74 61 69 6e 69 atabase containi
2db0: 6e 67 20 61 6c 6c 20 64 65 66 69 6e 69 74 69 6f ng all definitio
2dc0: 6e 73 20 61 62 6f 75 74 20 73 75 70 70 6f 72 74 ns about support
2dd0: 65 64 20 43 52 53 65 73 2c 20 45 6c 6c 69 70 73 ed CRSes, Ellips
2de0: 6f 69 64 73 2c 20 50 72 69 6d 65 20 4d 65 72 69 oids, Prime Meri
2df0: 64 69 61 6e 73 2c 20 55 6e 69 74 73 20 6f 66 20 dians, Units of
2e00: 4d 65 61 73 75 72 65 2c 20 43 6f 6e 76 65 72 73 Measure, Convers
2e10: 69 6f 6e 73 2c 20 54 72 61 6e 73 66 6f 72 6d 61 ions, Transforma
2e20: 74 69 6f 6e 73 20 61 6e 64 20 61 6c 69 6b 65 2e tions and alike.
2e30: 3c 62 72 3e 0d 0a 3c 62 3e 3c 75 3e 4e 6f 74 65 <br>..<b><u>Note
2e40: 3c 2f 75 3e 3c 2f 62 3e 3a 20 6d 61 6e 79 20 6f </u></b>: many o
2e50: 66 20 74 68 65 20 6e 65 77 20 61 64 76 61 6e 63 f the new advanc
2e60: 65 64 20 50 52 4f 4a 2e 36 20 66 65 61 74 75 72 ed PROJ.6 featur
2e70: 65 73 20 77 69 6c 6c 20 66 61 69 6c 20 69 66 20 es will fail if
2e80: 73 75 63 68 20 64 61 74 61 62 61 73 65 20 69 73 such database is
2e90: 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 61 not available a
2ea0: 74 20 72 75 6e 20 74 69 6d 65 2e 0d 0a 3c 68 33 t run time...<h3
2eb0: 3e 44 69 72 65 63 74 20 74 72 61 6e 73 66 6f 72 >Direct transfor
2ec0: 6d 61 74 69 6f 6e 73 20 66 72 6f 6d 20 43 52 53 mations from CRS
2ed0: 20 74 6f 20 43 52 53 3c 2f 68 33 3e 0d 0a 44 69 to CRS</h3>..Di
2ee0: 66 66 65 72 65 6e 74 6c 79 20 66 72 6f 6d 20 61 fferently from a
2ef0: 6c 6c 20 70 72 65 76 69 6f 75 73 20 76 65 72 73 ll previous vers
2f00: 69 6f 6e 73 2c 20 50 52 4f 4a 2e 36 20 63 61 6e ions, PROJ.6 can
2f10: 20 6e 6f 77 20 61 70 70 6c 79 20 61 6e 79 20 74 now apply any t
2f20: 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 66 72 ransformation fr
2f30: 6f 6d 20 61 20 43 52 53 20 74 6f 20 61 6e 6f 74 om a CRS to anot
2f40: 68 65 72 20 77 69 74 68 6f 75 74 20 72 65 71 75 her without requ
2f50: 69 72 69 6e 67 20 74 6f 20 73 70 65 63 69 66 79 iring to specify
2f60: 20 61 6e 79 20 3c 62 3e 3c 69 3e 70 72 6f 6a 2d any <b><i>proj-
2f70: 73 74 72 69 6e 67 3c 2f 69 3e 3c 2f 62 3e 20 6f string</i></b> o
2f80: 72 20 3c 62 3e 3c 69 3e 57 4b 54 20 65 78 70 72 r <b><i>WKT expr
2f90: 65 73 73 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 71 ession</i></b> q
2fa0: 75 61 6c 69 66 79 69 6e 67 20 65 61 63 68 20 43 ualifying each C
2fb0: 52 53 2e 3c 62 72 3e 0d 0a 54 68 69 73 20 69 73 RS.<br>..This is
2fc0: 20 62 65 63 61 75 73 65 20 50 52 4f 4a 2e 36 20 because PROJ.6
2fd0: 69 73 20 6e 6f 77 20 63 61 70 61 62 6c 65 20 74 is now capable t
2fe0: 6f 20 72 65 74 72 69 65 76 65 20 61 6e 79 20 43 o retrieve any C
2ff0: 52 53 20 64 65 66 69 6e 69 74 69 6f 6e 20 64 69 RS definition di
3000: 72 65 63 74 6c 79 0d 0a 66 72 6f 6d 20 69 74 73 rectly..from its
3010: 20 6f 77 6e 20 70 72 69 76 61 74 65 20 53 51 4c own private SQL
3020: 69 74 65 20 64 61 74 61 62 61 73 65 2c 20 61 6e ite database, an
3030: 64 20 63 6f 6e 73 65 71 75 65 6e 74 6c 79 20 65 d consequently e
3040: 61 63 68 20 43 52 53 20 63 61 6e 20 62 65 20 66 ach CRS can be f
3050: 75 6c 6c 79 20 69 64 65 6e 74 69 66 69 65 64 20 ully identified
3060: 62 79 20 73 69 6d 70 6c 79 20 73 70 65 63 69 66 by simply specif
3070: 79 69 6e 67 20 69 74 73 20 73 79 6d 62 6f 6c 69 ying its symboli
3080: 63 20 6e 61 6d 65 2c 20 61 73 20 69 6e 3a 0d 0a c name, as in:..
3090: 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 45 50 53 <ul>..<li><b>EPS
30a0: 47 3a 34 33 32 36 3c 2f 62 3e 3c 2f 6c 69 3e 0d G:4326</b></li>.
30b0: 0a 3c 6c 69 3e 6f 72 20 61 6c 74 65 72 6e 61 74 .<li>or alternat
30c0: 69 76 65 6c 79 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e ively</li>..<li>
30d0: 3c 62 3e 75 72 6e 3a 6f 67 63 3a 64 65 66 3a 63 <b>urn:ogc:def:c
30e0: 72 73 3a 45 50 53 47 3a 3a 34 33 32 36 3c 2f 62 rs:EPSG::4326</b
30f0: 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c ></li>..</ul>..<
3100: 68 33 3e 53 75 70 70 6f 72 74 69 6e 67 20 73 70 h3>Supporting sp
3110: 65 63 69 66 69 63 20 61 72 65 61 73 20 6f 66 20 ecific areas of
3120: 75 73 65 3c 2f 68 33 3e 0d 0a 3c 74 61 62 6c 65 use</h3>..<table
3130: 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 cellspacing="8"
3140: 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 38 22 cellpadding="8"
3150: 20 62 67 63 6f 6c 6f 72 3d 22 23 65 38 66 66 65 bgcolor="#e8ffe
3160: 38 22 20 62 6f 72 64 65 72 3d 22 31 22 3e 0d 0a 8" border="1">..
3170: 3c 74 72 3e 3c 74 64 3e 0d 0a 50 52 4f 4a 2e 36 <tr><td>..PROJ.6
3180: 20 69 73 20 6e 6f 77 20 61 62 6c 65 20 74 6f 20 is now able to
3190: 6d 61 6b 65 20 61 20 64 69 73 74 69 6e 63 74 69 make a distincti
31a0: 6f 6e 20 62 65 74 77 65 65 6e 20 64 69 66 66 65 on between diffe
31b0: 72 65 6e 74 20 3c 62 3e 61 72 65 61 73 20 6f 66 rent <b>areas of
31c0: 20 75 73 65 3c 2f 62 3e 20 77 69 74 68 69 6e 20 use</b> within
31d0: 61 20 43 52 53 2c 20 61 6e 64 20 63 61 6e 20 65 a CRS, and can e
31e0: 76 65 6e 74 75 61 6c 6c 79 20 61 70 70 6c 79 20 ventually apply
31f0: 74 68 65 20 6d 6f 73 74 20 61 70 70 72 6f 70 72 the most appropr
3200: 69 61 74 65 20 74 72 61 6e 73 66 6f 72 6d 61 74 iate transformat
3210: 69 6f 6e 20 77 68 65 6e 20 74 68 65 20 69 6e 74 ion when the int
3220: 65 6e 64 65 64 20 61 72 65 61 2d 6f 66 2d 75 73 ended area-of-us
3230: 65 20 69 73 20 65 78 70 6c 69 63 69 74 6c 79 20 e is explicitly
3240: 73 70 65 63 69 66 69 65 64 2c 20 74 68 75 73 20 specified, thus
3250: 6c 65 61 64 69 6e 67 20 74 6f 20 6d 6f 72 65 20 leading to more
3260: 70 72 65 63 69 73 65 20 72 65 73 75 6c 74 73 2e precise results.
3270: 3c 62 72 3e 3c 62 72 3e 0d 0a 54 68 65 20 73 69 <br><br>..The si
3280: 64 65 20 66 69 67 75 72 65 20 73 68 6f 77 73 20 de figure shows
3290: 74 68 65 20 73 69 74 75 61 74 69 6f 6e 20 66 6f the situation fo
32a0: 72 20 74 68 65 20 49 74 61 6c 69 61 6e 20 70 65 r the Italian pe
32b0: 6e 69 6e 73 75 6c 61 2e 3c 62 72 3e 0d 0a 41 73 ninsula.<br>..As
32c0: 20 79 6f 75 20 63 61 6e 20 6e 6f 74 69 63 65 20 you can notice
32d0: 74 68 65 72 65 20 61 72 65 20 74 77 6f 20 6d 61 there are two ma
32e0: 69 6e 20 61 72 65 61 73 20 28 3c 62 3e 3c 69 3e in areas (<b><i>
32f0: 45 61 73 74 3c 2f 69 3e 3c 2f 62 3e 20 61 6e 64 East</i></b> and
3300: 20 3c 62 3e 3c 69 3e 57 65 73 74 3c 2f 69 3e 3c <b><i>West</i><
3310: 2f 62 3e 20 6f 66 20 6c 6f 6e 67 69 74 75 64 65 /b> of longitude
3320: 20 3c 62 3e 31 32 45 3c 2f 62 3e 29 2c 20 62 75 <b>12E</b>), bu
3330: 74 20 74 68 65 72 65 20 61 72 65 20 73 65 76 65 t there are seve
3340: 72 61 6c 20 73 6d 61 6c 6c 65 72 20 61 72 65 61 ral smaller area
3350: 73 20 63 6f 76 65 72 69 6e 67 20 73 70 65 63 69 s covering speci
3360: 66 69 63 20 72 65 67 69 6f 6e 73 2e 0d 0a 3c 75 fic regions...<u
3370: 6c 3e 0d 0a 3c 6c 69 3e 54 68 65 20 74 77 6f 20 l>..<li>The two
3380: 6d 61 69 6e 20 61 72 65 61 73 20 63 6f 72 72 65 main areas corre
3390: 73 70 6f 6e 64 20 74 6f 20 3c 62 3e 45 50 53 47 spond to <b>EPSG
33a0: 3a 33 30 30 33 20 3c 69 3e 4d 6f 6e 74 65 20 4d :3003 <i>Monte M
33b0: 61 72 69 6f 20 2f 20 49 74 61 6c 79 20 7a 6f 6e ario / Italy zon
33c0: 65 20 31 3c 2f 69 3e 3c 2f 62 3e 20 61 6e 64 20 e 1</i></b> and
33d0: 3c 62 3e 45 50 53 47 3a 33 30 30 34 20 3c 69 3e <b>EPSG:3004 <i>
33e0: 4d 6f 6e 74 65 20 4d 61 72 69 6f 20 2f 20 49 74 Monte Mario / It
33f0: 61 6c 79 20 7a 6f 6e 65 20 32 3c 2f 69 3e 3c 2f aly zone 2</i></
3400: 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 54 68 b>.</li>..<li>Th
3410: 65 20 73 6d 61 6c 6c 65 73 74 20 61 72 65 61 73 e smallest areas
3420: 20 63 6f 72 72 65 73 70 6f 6e 64 20 74 6f 20 74 correspond to t
3430: 68 65 20 6d 6f 72 65 20 73 70 65 63 69 66 69 63 he more specific
3440: 20 3c 62 3e 3c 69 3e 61 72 65 61 73 20 6f 66 20 <b><i>areas of
3450: 75 73 65 3c 2f 69 3e 3c 2f 62 3e 20 6e 6f 77 20 use</i></b> now
3460: 73 75 70 70 6f 72 74 65 64 20 62 79 20 50 52 4f supported by PRO
3470: 4a 2e 36 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c J.6</li>..</ul><
3480: 62 72 3e 0d 0a 49 66 20 79 6f 75 72 20 73 70 65 br>..If your spe
3490: 63 69 66 69 63 20 61 72 65 61 20 6f 66 20 69 6e cific area of in
34a0: 74 65 72 65 73 74 20 69 73 20 63 6f 6e 74 61 69 terest is contai
34b0: 6e 65 64 20 77 69 74 68 69 6e 20 6f 6e 65 20 6f ned within one o
34c0: 66 20 73 75 63 68 20 73 75 62 2d 72 65 67 69 6f f such sub-regio
34d0: 6e 73 20 79 6f 75 20 63 61 6e 20 75 73 65 66 75 ns you can usefu
34e0: 6c 6c 79 20 69 6e 66 6f 72 6d 20 50 52 4f 4a 2e lly inform PROJ.
34f0: 36 20 61 62 6f 75 74 20 74 68 65 20 69 6e 74 65 6 about the inte
3500: 6e 64 65 64 20 42 42 4f 58 2c 20 61 6e 64 20 74 nded BBOX, and t
3510: 68 65 6e 20 50 52 4f 4a 2e 36 20 77 69 6c 6c 20 hen PROJ.6 will
3520: 61 74 74 65 6d 70 74 20 74 6f 20 75 73 65 20 74 attempt to use t
3530: 68 65 20 6d 6f 73 74 20 73 70 65 63 69 66 69 63 he most specific
3540: 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 transformation
3550: 70 61 72 61 6d 65 74 65 72 73 20 61 76 61 69 6c parameters avail
3560: 61 62 6c 65 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 57 able.<br><br>..W
3570: 65 27 6c 6c 20 65 78 61 6d 69 6e 65 20 69 6e 20 e'll examine in
3580: 6d 6f 72 65 20 64 65 70 74 68 20 74 68 69 73 20 more depth this
3590: 74 6f 70 69 63 20 6f 6e 20 66 6f 6c 6c 6f 77 69 topic on followi
35a0: 6e 67 20 73 65 63 74 69 6f 6e 73 2e 20 0d 0a 3c ng sections. ..<
35b0: 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a 3c 69 6d 67 /td>..<td>..<img
35c0: 20 73 72 63 3d 22 68 74 74 70 73 3a 2f 2f 77 77 src="https://ww
35d0: 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 2f 67 61 w.gaia-gis.it/ga
35e0: 69 61 2d 73 69 6e 73 2f 70 72 6f 6a 36 70 69 63 ia-sins/proj6pic
35f0: 73 2f 69 74 61 6c 79 2d 61 72 65 61 73 2d 6f 66 s/italy-areas-of
3600: 2d 75 73 65 2e 70 6e 67 22 20 61 6c 74 3d 22 69 -use.png" alt="i
3610: 74 61 6c 79 20 61 72 65 61 73 20 6f 66 20 75 73 taly areas of us
3620: 65 22 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d e">..</td></tr>.
3630: 0a 3c 2f 74 61 62 6c 65 3e 0d 0a 3c 62 72 3e 3c .</table>..<br><
3640: 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c br>..<table cell
3650: 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c spacing="8" cell
3660: 70 61 64 64 69 6e 67 3d 22 31 36 22 20 62 67 63 padding="16" bgc
3670: 6f 6c 6f 72 3d 22 23 66 66 66 66 65 39 22 3e 0d olor="#ffffe9">.
3680: 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 68 33 3e 43 .<tr><td>..<h3>C
3690: 6f 6e 63 65 70 74 73 20 74 6f 20 6b 65 65 70 20 oncepts to keep
36a0: 77 65 6c 6c 20 69 6e 20 6d 69 6e 64 3c 2f 68 33 well in mind</h3
36b0: 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 66 6f 72 >..<ul>..<li>for
36c0: 67 65 74 20 74 68 65 20 6f 6c 64 20 70 72 6f 6a get the old proj
36d0: 2d 73 74 72 69 6e 67 73 3b 20 74 68 65 79 20 61 -strings; they a
36e0: 72 65 20 6e 6f 20 6c 6f 6e 67 65 72 20 74 68 65 re no longer the
36f0: 20 62 65 73 74 20 77 61 79 20 66 6f 72 20 74 61 best way for ta
3700: 6b 69 6e 67 20 66 75 6c 6c 20 70 72 6f 66 69 74 king full profit
3710: 20 66 72 6f 6d 20 50 52 4f 4a 2e 36 3c 2f 6c 69 from PROJ.6</li
3720: 3e 0d 0a 3c 6c 69 3e 74 68 65 20 62 65 73 74 20 >..<li>the best
3730: 77 61 79 20 74 6f 20 6d 61 6b 65 20 74 68 65 20 way to make the
3740: 6d 6f 73 74 20 6f 66 20 50 52 4f 4a 2e 36 20 63 most of PROJ.6 c
3750: 61 70 61 62 69 6c 69 74 69 65 73 20 69 73 20 62 apabilities is b
3760: 79 20 6c 65 61 76 69 6e 67 20 74 68 65 20 6c 69 y leaving the li
3770: 62 72 61 72 79 20 66 75 6c 6c 79 20 66 72 65 65 brary fully free
3780: 20 74 6f 20 63 68 6f 6f 73 65 20 74 68 65 20 62 to choose the b
3790: 65 73 74 20 70 6f 73 73 69 62 6c 65 20 74 72 61 est possible tra
37a0: 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d nsformation from
37b0: 20 74 68 65 20 6f 72 69 67 69 6e 20 61 6e 64 20 the origin and
37c0: 74 68 65 20 64 65 73 74 69 6e 61 74 69 6f 6e 20 the destination
37d0: 43 52 53 65 73 2e 3c 62 72 3e 0d 0a 62 75 74 20 CRSes.<br>..but
37e0: 74 68 69 73 20 73 74 72 69 63 74 6c 79 20 72 65 this strictly re
37f0: 71 75 69 72 65 73 20 74 68 61 74 20 74 68 65 20 quires that the
3800: 6c 69 62 72 61 72 79 20 77 69 6c 6c 20 62 65 20 library will be
3810: 62 61 63 6b 65 64 20 75 70 20 62 79 20 69 74 73 backed up by its
3820: 20 6f 77 6e 20 70 72 69 76 61 74 65 20 64 61 74 own private dat
3830: 61 62 61 73 65 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 abase.</li>..</u
3840: 6c 3e 0d 0a 3c 68 33 3e 41 64 64 69 74 69 6f 6e l>..<h3>Addition
3850: 61 6c 20 63 6f 6e 63 65 70 74 3c 2f 68 33 3e 0d al concept</h3>.
3860: 0a 54 68 65 20 74 72 61 64 69 74 69 6f 6e 61 6c .The traditional
3870: 20 3c 62 3e 73 70 61 74 69 61 6c 5f 72 65 66 5f <b>spatial_ref_
3880: 73 79 73 3c 2f 62 3e 20 74 61 62 6c 65 20 63 6f sys</b> table co
3890: 6e 74 61 69 6e 65 64 20 77 69 74 68 69 6e 20 61 ntained within a
38a0: 6e 79 20 53 70 61 74 69 61 4c 69 74 65 20 44 42 ny SpatiaLite DB
38b0: 20 6e 6f 74 69 63 65 61 62 6c 79 20 63 68 61 6e noticeably chan
38c0: 67 65 73 20 69 74 73 20 69 6e 74 65 6e 64 65 64 ges its intended
38d0: 20 73 63 6f 70 65 20 69 6e 20 50 52 4f 4a 2e 36 scope in PROJ.6
38e0: 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e :..<ul>..<li><b>
38f0: 73 72 69 64 3c 2f 62 3e 2c 20 3c 62 3e 61 75 74 srid</b>, <b>aut
3900: 68 5f 6e 61 6d 65 3c 2f 62 3e 2c 20 3c 62 3e 61 h_name</b>, <b>a
3910: 75 74 68 5f 73 72 69 64 3c 2f 62 3e 20 61 6e 64 uth_srid</b> and
3920: 20 3c 62 3e 72 65 66 5f 73 79 73 5f 6e 61 6d 65 <b>ref_sys_name
3930: 3c 2f 62 3e 20 63 6f 6c 75 6d 6e 73 20 61 72 65 </b> columns are
3940: 20 73 74 69 6c 6c 20 72 65 71 75 69 72 65 64 20 still required
3950: 69 6e 20 6f 72 64 65 72 20 74 6f 20 64 65 66 69 in order to defi
3960: 6e 65 20 61 6c 6c 20 73 75 70 70 6f 72 74 65 64 ne all supported
3970: 20 43 52 53 65 73 20 61 6e 64 20 74 6f 20 73 75 CRSes and to su
3980: 70 70 6f 72 74 20 0d 0a 72 65 6c 61 74 69 6f 6e pport ..relation
3990: 73 20 62 61 73 65 64 20 6f 6e 20 50 72 69 6d 61 s based on Prima
39a0: 72 79 20 61 6e 64 20 46 6f 72 65 69 67 6e 20 4b ry and Foreign K
39b0: 65 79 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 62 eys.</li>..<li>b
39c0: 75 74 20 63 6f 6c 75 6d 6e 73 20 3c 62 3e 70 72 ut columns <b>pr
39d0: 6f 6a 34 74 65 78 74 3c 2f 62 3e 20 61 6e 64 20 oj4text</b> and
39e0: 3c 62 3e 73 72 74 65 78 74 3c 2f 62 3e 20 61 72 <b>srtext</b> ar
39f0: 65 20 6e 6f 77 20 70 72 61 63 74 69 63 61 6c 6c e now practicall
3a00: 79 20 75 73 65 6c 65 73 73 2c 20 62 65 63 61 75 y useless, becau
3a10: 73 65 20 50 52 4f 4a 2e 36 20 69 73 20 6e 6f 77 se PROJ.6 is now
3a20: 20 63 61 70 61 62 6c 65 20 74 6f 20 66 75 6c 6c capable to full
3a30: 79 20 64 65 66 69 6e 65 20 61 6e 79 20 43 52 53 y define any CRS
3a40: 20 62 79 20 64 69 72 65 63 74 6c 79 20 71 75 65 by directly que
3a50: 72 79 69 6e 67 20 69 74 73 20 6f 77 6e 20 70 72 rying its own pr
3a60: 69 76 61 74 65 20 64 61 74 61 62 61 73 65 2e 3c ivate database.<
3a70: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 69 3e 3c 75 3e /li>..<li><i><u>
3a80: 46 75 74 75 72 65 20 46 6f 72 65 63 61 73 74 73 Future Forecasts
3a90: 3c 2f 75 3e 3c 2f 69 3e 3a 20 62 6f 74 68 20 3c </u></i>: both <
3aa0: 62 3e 70 72 6f 6a 34 74 65 78 74 3c 2f 62 3e 20 b>proj4text</b>
3ab0: 61 6e 64 20 3c 62 3e 73 72 74 65 78 74 3c 2f 62 and <b>srtext</b
3ac0: 3e 20 77 69 6c 6c 20 62 65 20 70 72 6f 62 61 62 > will be probab
3ad0: 6c 79 20 72 65 6d 6f 76 65 64 20 69 6e 20 73 6f ly removed in so
3ae0: 6d 65 20 66 75 74 75 72 65 20 76 65 72 73 69 6f me future versio
3af0: 6e 20 6f 66 20 53 70 61 74 69 61 4c 69 74 65 2e n of SpatiaLite.
3b00: 3c 62 72 3e 0d 0a 46 6f 72 20 6e 6f 77 20 74 68 <br>..For now th
3b10: 65 79 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20 62 ey continue to b
3b20: 65 20 73 75 70 70 6f 72 74 65 64 20 6d 61 69 6e e supported main
3b30: 6c 79 20 74 6f 20 74 68 65 20 62 65 6e 65 66 69 ly to the benefi
3b40: 74 20 6f 66 20 70 72 65 76 69 6f 75 73 20 76 65 t of previous ve
3b50: 72 73 69 6f 6e 73 20 6f 66 20 53 70 61 74 69 61 rsions of Spatia
3b60: 4c 69 74 65 20 62 65 69 6e 67 20 62 61 73 65 64 Lite being based
3b70: 20 6f 6e 20 74 68 65 20 6e 6f 77 20 73 75 70 65 on the now supe
3b80: 72 73 65 64 65 64 20 50 52 4f 4a 2e 34 3c 2f 6c rseded PROJ.4</l
3b90: 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 2f 74 64 3e i>..</ul>..</td>
3ba0: 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 0d </tr>..</table>.
3bb0: 0a 3c 68 33 3e 54 72 61 6e 73 66 6f 72 6d 61 74 .<h3>Transformat
3bc0: 69 6f 6e 20 70 69 70 65 6c 69 6e 65 73 3c 2f 68 ion pipelines</h
3bd0: 33 3e 0d 0a 54 68 65 72 65 20 69 73 20 61 20 6c 3>..There is a l
3be0: 61 73 74 20 61 73 74 6f 6e 69 73 68 69 6e 67 20 ast astonishing
3bf0: 69 6d 70 72 6f 76 65 6d 65 6e 74 20 73 75 70 70 improvement supp
3c00: 6f 72 74 65 64 20 62 79 20 50 52 4f 4a 2e 36 2c orted by PROJ.6,
3c10: 20 74 68 61 74 20 61 72 65 20 3c 62 3e 3c 69 3e that are <b><i>
3c20: 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 transformation p
3c30: 69 70 65 6c 69 6e 65 73 3c 2f 69 3e 3c 2f 62 3e ipelines</i></b>
3c40: 2e 3c 62 72 3e 0d 0a 57 68 65 6e 20 75 73 69 6e .<br>..When usin
3c50: 67 20 61 20 3c 62 3e 3c 69 3e 70 69 70 65 6c 69 g a <b><i>pipeli
3c60: 6e 65 3c 2f 69 3e 3c 2f 62 3e 20 79 6f 75 20 63 ne</i></b> you c
3c70: 61 6e 20 66 72 65 65 6c 79 20 64 65 66 69 6e 65 an freely define
3c80: 20 61 6e 79 20 63 6f 6d 70 6c 65 78 20 67 65 6f any complex geo
3c90: 64 65 74 69 63 20 74 72 61 6e 73 66 6f 72 6d 61 detic transforma
3ca0: 74 69 6f 6e 20 62 79 20 63 68 61 69 6e 69 6e 67 tion by chaining
3cb0: 20 74 6f 67 65 74 68 65 72 20 6d 61 6e 79 20 65 together many e
3cc0: 6c 65 6d 65 6e 74 61 72 79 20 73 74 65 70 73 20 lementary steps
3cd0: 73 75 63 68 20 61 73 20 63 6f 6e 76 65 72 73 69 such as conversi
3ce0: 6f 6e 2c 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 on, transformati
3cf0: 6f 6e 2c 20 70 72 6f 6a 65 63 74 69 6f 6e 2c 20 on, projection,
3d00: 61 78 69 73 20 73 77 61 70 20 61 6e 64 20 73 6f axis swap and so
3d10: 20 6f 6e 2e 3c 62 72 3e 0d 0a 41 20 70 69 70 65 on.<br>..A pipe
3d20: 6c 69 6e 65 20 69 73 20 63 6f 6e 63 65 70 74 75 line is conceptu
3d30: 61 6c 6c 79 20 73 69 6d 69 6c 61 72 20 74 6f 20 ally similar to
3d40: 61 20 55 4e 49 58 20 73 68 65 6c 6c 20 73 63 72 a UNIX shell scr
3d50: 69 70 74 2c 20 77 69 74 68 20 61 20 64 61 74 61 ipt, with a data
3d60: 66 6c 6f 77 20 72 65 67 75 6c 61 72 6c 79 20 70 flow regularly p
3d70: 72 6f 63 65 65 64 69 6e 67 20 66 6f 72 77 61 72 roceeding forwar
3d80: 64 20 66 72 6f 6d 20 73 74 65 70 20 74 6f 20 73 d from step to s
3d90: 74 65 70 20 75 6e 74 69 6c 20 70 72 6f 64 75 63 tep until produc
3da0: 69 6e 67 20 74 68 65 20 66 69 6e 61 6c 20 72 65 ing the final re
3db0: 73 75 6c 74 2e 3c 62 72 3e 0d 0a 54 68 65 20 66 sult.<br>..The f
3dc0: 6f 6c 6c 6f 77 69 6e 67 20 69 73 20 61 20 70 72 ollowing is a pr
3dd0: 61 63 74 69 63 61 6c 20 65 78 61 6d 70 6c 65 20 actical example
3de0: 6f 66 20 61 20 70 69 70 65 6c 69 6e 65 20 63 6f of a pipeline co
3df0: 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 61 rresponding to a
3e00: 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 transformation
3e10: 66 72 6f 6d 20 3c 62 3e 45 50 53 47 3a 34 33 32 from <b>EPSG:432
3e20: 36 3c 2f 62 3e 20 3c 69 3e 57 47 53 20 38 34 3c 6</b> <i>WGS 84<
3e30: 2f 69 3e 20 74 6f 20 3c 62 3e 45 50 53 47 3a 33 /i> to <b>EPSG:3
3e40: 32 36 33 32 3c 2f 62 3e 20 3c 69 3e 57 47 53 20 2632</b> <i>WGS
3e50: 38 34 20 2f 20 55 54 4d 20 7a 6f 6e 65 20 33 32 84 / UTM zone 32
3e60: 4e 3c 2f 69 3e 3a 0d 0a 3c 76 65 72 62 61 74 69 N</i>:..<verbati
3e70: 6d 3e 0d 0a 2b 70 72 6f 6a 3d 70 69 70 65 6c 69 m>..+proj=pipeli
3e80: 6e 65 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a ne ..+step +proj
3e90: 3d 61 78 69 73 73 77 61 70 20 2b 6f 72 64 65 72 =axisswap +order
3ea0: 3d 32 2c 31 20 0d 0a 2b 73 74 65 70 20 2b 70 72 =2,1 ..+step +pr
3eb0: 6f 6a 3d 75 6e 69 74 63 6f 6e 76 65 72 74 20 2b oj=unitconvert +
3ec0: 78 79 5f 69 6e 3d 64 65 67 20 2b 78 79 5f 6f 75 xy_in=deg +xy_ou
3ed0: 74 3d 72 61 64 20 0d 0a 2b 73 74 65 70 20 2b 70 t=rad ..+step +p
3ee0: 72 6f 6a 3d 75 74 6d 20 2b 7a 6f 6e 65 3d 33 32 roj=utm +zone=32
3ef0: 20 2b 65 6c 6c 70 73 3d 57 47 53 38 34 0d 0a 3c +ellps=WGS84..<
3f00: 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 3c 74 61 62 /verbatim>..<tab
3f10: 6c 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 le cellspacing="
3f20: 38 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 8" cellpadding="
3f30: 31 36 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 16" bgcolor="#ff
3f40: 66 66 64 30 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e ffd0">..<tr><td>
3f50: 0d 0a 3c 62 3e 3c 75 3e 55 73 65 66 75 6c 20 68 ..<b><u>Useful h
3f60: 69 6e 74 3c 2f 75 3e 3c 2f 62 3e 3a 20 50 52 4f int</u></b>: PRO
3f70: 4a 2e 36 20 73 75 70 70 6f 72 74 73 20 61 20 6e J.6 supports a n
3f80: 65 77 20 43 4c 49 20 74 6f 6f 6c 20 28 3c 62 3e ew CLI tool (<b>
3f90: 70 72 6f 6a 69 6e 66 6f 3c 2f 62 3e 29 20 66 6f projinfo</b>) fo
3fa0: 72 20 69 6e 73 70 65 63 74 69 6e 67 20 69 6e 20 r inspecting in
3fb0: 66 75 6c 6c 20 64 65 74 61 69 6c 20 74 68 65 20 full detail the
3fc0: 69 6e 74 65 72 6e 61 6c 20 64 65 66 69 6e 69 74 internal definit
3fd0: 69 6f 6e 73 20 6f 66 20 43 52 53 65 73 2c 20 54 ions of CRSes, T
3fe0: 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 73 20 65 ransformations e
3ff0: 74 63 2e 3c 62 72 3e 0d 0a 54 68 65 20 61 62 6f tc.<br>..The abo
4000: 76 65 20 70 69 70 65 6c 69 6e 65 20 69 73 20 73 ve pipeline is s
4010: 69 6d 70 6c 79 20 74 68 65 20 6f 75 74 70 75 74 imply the output
4020: 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
4030: 67 20 63 6f 6d 6d 61 6e 64 3a 0d 0a 3c 76 65 72 g command:..<ver
4040: 62 61 74 69 6d 3e 0d 0a 70 72 6f 6a 69 6e 66 6f batim>..projinfo
4050: 20 2d 73 20 45 50 53 47 3a 34 33 32 36 20 2d 74 -s EPSG:4326 -t
4060: 20 45 50 53 47 3a 33 32 36 33 32 20 2d 6f 20 70 EPSG:32632 -o p
4070: 72 6f 6a 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e roj..</verbatim>
4080: 0d 0a 3c 62 3e 70 72 6f 6a 69 6e 66 6f 3c 2f 62 ..<b>projinfo</b
4090: 3e 20 69 73 20 61 20 76 65 72 79 20 70 72 65 63 > is a very prec
40a0: 69 6f 75 73 20 72 65 73 6f 75 72 63 65 3b 20 64 ious resource; d
40b0: 6f 6e 27 74 20 68 65 73 69 74 61 74 65 20 74 6f on't hesitate to
40c0: 20 66 72 65 71 75 65 6e 74 6c 79 20 75 73 65 20 frequently use
40d0: 69 74 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 64 it in order to d
40e0: 69 73 63 6f 76 65 72 20 77 68 61 74 27 73 20 72 iscover what's r
40f0: 65 61 6c 6c 79 20 68 61 70 70 65 6e 69 6e 67 20 eally happening
4100: 62 65 68 69 6e 64 20 74 68 65 20 73 63 65 6e 65 behind the scene
4110: 73 2e 3c 62 72 3e 0d 0a 49 74 27 73 20 74 68 65 s.<br>..It's the
4120: 20 62 65 73 74 20 61 6e 64 20 65 61 73 69 65 73 best and easies
4130: 74 20 77 61 79 20 66 6f 72 20 66 75 6c 6c 79 20 t way for fully
4140: 75 6e 64 65 72 73 74 61 6e 64 69 6e 67 20 68 6f understanding ho
4150: 77 20 50 52 4f 4a 2e 36 20 64 6f 20 72 65 61 6c w PROJ.6 do real
4160: 6c 79 20 77 6f 72 6b 73 2e 0d 0a 3c 2f 74 64 3e ly works...</td>
4170: 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c </tr>..</table><
4180: 62 72 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 br><br>..<table
4190: 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 cellspacing="8"
41a0: 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 38 22 20 cellpadding="8"
41b0: 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 39 bgcolor="#ffffe9
41c0: 22 3e 0d 0a 3c 74 72 3e 3c 74 68 3e 0d 0a 49 6e ">..<tr><th>..In
41d0: 20 6f 72 64 65 72 20 74 6f 20 6c 65 61 72 6e 20 order to learn
41e0: 6d 6f 72 65 20 61 62 6f 75 74 20 74 68 65 20 6d more about the m
41f0: 61 6e 79 20 69 6e 74 65 72 65 73 74 69 6e 67 20 any interesting
4200: 63 6f 6f 6c 20 6e 65 77 20 66 65 61 74 75 72 65 cool new feature
4210: 73 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 50 s supported by P
4220: 52 4f 4a 2e 36 20 70 6c 65 61 73 65 20 63 6f 6e ROJ.6 please con
4230: 73 75 6c 74 20 74 68 65 20 3c 61 20 68 72 65 66 sult the <a href
4240: 3d 22 68 74 74 70 73 3a 2f 2f 70 72 6f 6a 34 2e ="https://proj4.
4250: 6f 72 67 2f 22 3e 6f 72 69 67 69 6e 61 6c 20 64 org/">original d
4260: 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 3c 2f 61 3e ocumentation</a>
4270: 0d 0a 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 2f ..</th></tr>..</
4280: 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 68 72 3e table><br>..<hr>
4290: 0d 0a 3c 68 31 3e 50 52 4f 4a 2e 36 20 73 75 70 ..<h1>PROJ.6 sup
42a0: 70 6f 72 74 20 6f 6e 20 53 70 61 74 69 61 4c 69 port on SpatiaLi
42b0: 74 65 2d 35 2e 30 2e 30 3c 2f 68 31 3e 0d 0a 3c te-5.0.0</h1>..<
42c0: 68 33 3e 43 72 65 61 74 69 6e 67 20 61 6e 64 20 h3>Creating and
42d0: 70 6f 70 75 6c 61 74 69 6e 67 20 74 68 65 20 73 populating the s
42e0: 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 20 6d patial_ref_sys m
42f0: 65 74 61 74 61 62 6c 65 3c 2f 68 33 3e 0d 0a 54 etatable</h3>..T
4300: 68 65 72 65 20 69 73 20 6e 6f 20 72 65 6c 65 76 here is no relev
4310: 61 6e 74 20 63 68 61 6e 67 65 2e 20 41 73 20 69 ant change. As i
4320: 6e 20 61 6c 6c 20 70 72 65 76 69 6f 75 73 20 76 n all previous v
4330: 65 72 73 69 6f 6e 73 20 3c 62 3e 73 70 61 74 69 ersions <b>spati
4340: 61 6c 5f 72 65 66 5f 73 79 73 3c 2f 62 3e 20 77 al_ref_sys</b> w
4350: 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74 69 63 ill be automatic
4360: 61 6c 6c 79 20 63 72 65 61 74 65 64 20 61 6e 64 ally created and
4370: 20 70 72 6f 70 65 72 6c 79 20 70 6f 70 75 6c 61 properly popula
4380: 74 65 20 62 79 20 63 61 6c 6c 69 6e 67 20 74 68 te by calling th
4390: 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 53 51 e appropriate SQ
43a0: 4c 20 66 75 6e 63 74 69 6f 6e 2e 0d 0a 3c 76 65 L function...<ve
43b0: 72 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 54 20 rbatim>..SELECT
43c0: 49 6e 69 74 53 70 61 74 69 61 6c 4d 65 74 61 44 InitSpatialMetaD
43d0: 61 74 61 28 31 29 3b 0d 0a 20 20 20 20 20 20 6f ata(1);.. o
43e0: 72 0d 0a 53 45 4c 45 43 54 20 49 6e 69 74 53 70 r..SELECT InitSp
43f0: 61 74 69 61 6c 4d 65 74 61 44 61 74 61 46 75 6c atialMetaDataFul
4400: 6c 28 31 29 3b 0d 0a 3c 2f 76 65 72 62 61 74 69 l(1);..</verbati
4410: 6d 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 m>..<table cells
4420: 70 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 pacing="8" cellp
4430: 61 64 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c adding="8" bgcol
4440: 6f 72 3d 22 23 66 66 66 66 65 39 22 3e 0d 0a 3c or="#ffffe9">..<
4450: 74 72 3e 3c 74 64 3e 0d 0a 50 6c 65 61 73 65 20 tr><td>..Please
4460: 72 65 6d 65 6d 62 65 72 20 74 68 61 74 20 6e 6f remember that no
4470: 77 20 69 6e 20 53 70 61 74 69 61 4c 69 74 65 2d w in SpatiaLite-
4480: 35 2e 30 2e 30 20 3c 62 3e 49 6e 69 74 53 70 61 5.0.0 <b>InitSpa
4490: 74 69 61 6c 4d 65 74 61 44 61 74 61 46 75 6c 6c tialMetaDataFull
44a0: 3c 2f 62 3e 20 72 65 70 72 65 73 65 6e 74 73 20 </b> represents
44b0: 74 68 65 20 70 72 65 66 65 72 72 65 64 20 6d 65 the preferred me
44c0: 74 68 6f 64 20 66 6f 72 20 63 72 65 61 74 69 6e thod for creatin
44d0: 67 20 61 6c 6c 20 6d 65 74 61 64 61 74 61 20 74 g all metadata t
44e0: 61 62 6c 65 73 20 72 65 71 75 69 72 65 64 20 62 ables required b
44f0: 79 20 74 68 69 73 20 76 65 72 73 69 6f 6e 2e 3c y this version.<
4500: 62 72 3e 0d 0a 3c 62 3e 49 6e 69 74 53 70 61 74 br>..<b>InitSpat
4510: 69 61 6c 4d 65 74 61 44 61 74 61 3c 2f 62 3e 20 ialMetaData</b>
4520: 69 73 20 73 74 69 6c 6c 20 6d 61 69 6e 74 61 69 is still maintai
4530: 6e 65 64 20 73 6f 20 74 6f 20 6e 6f 74 20 62 72 ned so to not br
4540: 65 61 6b 20 68 69 73 74 6f 72 69 63 61 6c 20 63 eak historical c
4550: 6f 6d 70 61 74 69 62 69 6c 69 74 79 2c 20 62 75 ompatibility, bu
4560: 74 20 73 68 6f 75 6c 64 6e 27 74 20 62 65 20 75 t shouldn't be u
4570: 73 65 64 20 61 6e 79 20 6c 6f 6e 67 65 72 2e 0d sed any longer..
4580: 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 .</td></tr>..</t
4590: 61 62 6c 65 3e 3c 62 72 3e 0d 0a 54 68 65 20 6d able><br>..The m
45a0: 6f 73 74 20 72 65 6c 65 76 61 6e 74 20 63 68 61 ost relevant cha
45b0: 6e 67 65 20 69 73 20 74 68 61 74 20 64 69 66 66 nge is that diff
45c0: 65 72 65 6e 74 20 76 65 72 73 69 6f 6e 73 20 6f erent versions o
45d0: 66 20 53 70 61 74 69 61 4c 69 74 65 2f 50 52 4f f SpatiaLite/PRO
45e0: 4a 20 77 69 6c 6c 20 6e 6f 77 20 62 65 68 61 76 J will now behav
45f0: 65 20 69 6e 20 72 61 64 69 63 61 6c 6c 79 20 64 e in radically d
4600: 69 66 66 65 72 65 6e 74 20 77 61 79 73 2c 20 61 ifferent ways, a
4610: 73 20 73 75 6d 6d 61 72 69 7a 65 64 20 69 6e 20 s summarized in
4620: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 72 the following cr
4630: 6f 73 73 2d 76 65 72 73 69 6f 6e 20 63 6f 6d 70 oss-version comp
4640: 61 74 69 62 69 6c 69 74 79 20 74 61 62 6c 65 2e atibility table.
4650: 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 <br><br>..<table
4660: 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 cellspacing="8"
4670: 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 31 36 cellpadding="16
4680: 22 20 62 67 63 6f 6c 6f 72 3d 22 23 65 38 66 66 " bgcolor="#e8ff
4690: 65 38 22 20 62 6f 72 64 65 72 3d 22 31 22 3e 0d e8" border="1">.
46a0: 0a 3c 74 72 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 .<tr><th bgcolor
46b0: 3d 22 23 66 66 62 30 33 65 22 3e 53 70 61 74 69 ="#ffb03e">Spati
46c0: 61 4c 69 74 65 20 2f 20 50 52 4f 4a 20 76 65 72 aLite / PROJ ver
46d0: 73 69 6f 6e 3c 2f 74 68 3e 3c 74 68 20 62 67 63 sion</th><th bgc
46e0: 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 3e 43 olor="#ffb03e">C
46f0: 6f 6e 6e 65 63 74 65 64 20 44 42 3c 2f 74 68 3e onnected DB</th>
4700: 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 <th bgcolor="#ff
4710: 62 30 33 65 22 3e 41 63 74 69 6f 6e 3c 2f 74 68 b03e">Action</th
4720: 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 ></tr>..<tr>..<t
4730: 64 20 72 6f 77 73 70 61 6e 3d 22 32 22 3e 53 70 d rowspan="2">Sp
4740: 61 74 69 61 4c 69 74 65 2d 35 20 62 75 69 6c 74 atiaLite-5 built
4750: 20 6f 6e 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 on <b>PROJ.6</b
4760: 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 44 42 20 63 ></td>..<td>DB c
4770: 72 65 61 74 65 64 20 62 79 20 53 70 61 74 69 61 reated by Spatia
4780: 4c 69 74 65 2d 35 20 2f 20 50 52 4f 4a 2e 36 3c Lite-5 / PROJ.6<
4790: 2f 74 64 3e 0d 0a 3c 74 64 20 72 6f 77 73 70 61 /td>..<td rowspa
47a0: 6e 3d 22 32 22 3e 0d 0a 3c 62 3e 6c 69 62 73 70 n="2">..<b>libsp
47b0: 61 74 69 61 6c 69 74 65 2d 35 3c 2f 62 3e 20 77 atialite-5</b> w
47c0: 68 65 6e 20 62 75 69 6c 74 20 6f 6e 20 3c 62 3e hen built on <b>
47d0: 50 52 4f 4a 2e 36 3c 2f 62 3e 20 77 69 6c 6c 20 PROJ.6</b> will
47e0: 61 6c 77 61 79 73 20 69 67 6e 6f 72 65 20 62 6f always ignore bo
47f0: 74 68 20 74 68 65 20 70 72 6f 6a 2d 73 74 72 69 th the proj-stri
4800: 6e 67 73 20 73 74 6f 72 65 64 20 69 6e 20 63 6f ngs stored in co
4810: 6c 75 6d 6e 20 3c 62 3e 70 72 6f 6a 34 74 65 78 lumn <b>proj4tex
4820: 74 3c 2f 62 3e 20 61 6e 64 20 74 68 65 20 57 4b t</b> and the WK
4830: 54 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 73 74 T definitions st
4840: 6f 72 65 64 20 69 6e 20 63 6f 6c 75 6d 6e 20 3c ored in column <
4850: 62 3e 73 72 74 65 78 74 3c 2f 62 3e 2e 3c 62 72 b>srtext</b>.<br
4860: 3e 0d 0a 49 74 20 77 69 6c 6c 20 69 6e 73 74 65 >..It will inste
4870: 61 64 20 6c 65 61 76 65 20 50 52 4f 4a 2e 36 20 ad leave PROJ.6
4880: 66 75 6c 6c 79 20 66 72 65 65 20 74 6f 20 75 73 fully free to us
4890: 65 20 74 68 65 20 43 52 53 20 64 65 66 69 6e 69 e the CRS defini
48a0: 74 69 6f 6e 73 20 63 6f 6e 74 61 69 6e 65 64 20 tions contained
48b0: 69 6e 20 69 74 73 20 6f 77 6e 20 70 72 69 76 61 in its own priva
48c0: 74 65 20 64 61 74 61 62 61 73 65 2e 3c 62 72 3e te database.<br>
48d0: 3c 62 72 3e 0d 0a 4e 6f 74 65 20 74 68 61 74 20 <br>..Note that
48e0: 74 68 69 73 20 61 70 70 6c 69 65 73 20 69 6e 64 this applies ind
48f0: 69 66 66 65 72 65 6e 74 6c 79 20 74 6f 20 62 6f ifferently to bo
4900: 74 68 20 3c 62 3e 3c 69 3e 6c 65 67 61 63 79 20 th <b><i>legacy
4910: 64 61 74 61 62 61 73 65 73 3c 2f 69 3e 3c 2f 62 databases</i></b
4920: 3e 20 63 72 65 61 74 65 64 20 62 79 20 61 6e 79 > created by any
4930: 20 70 72 65 76 69 6f 75 73 20 76 65 72 73 69 6f previous versio
4940: 6e 20 61 6e 64 20 3c 62 3e 3c 69 3e 6d 6f 73 74 n and <b><i>most
4950: 20 6d 6f 64 65 72 6e 20 64 61 74 61 62 61 73 65 modern database
4960: 73 3c 2f 69 3e 3c 2f 62 3e 20 63 72 65 61 74 65 s</i></b> create
4970: 64 20 62 79 20 74 68 65 20 6c 61 74 65 73 74 20 d by the latest
4980: 76 65 72 73 69 6f 6e 2e 0d 0a 3c 2f 74 64 3e 3c version...</td><
4990: 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e /tr>..<tr>..<td>
49a0: 44 42 20 63 72 65 61 74 65 64 20 62 79 20 53 70 DB created by Sp
49b0: 61 74 69 61 4c 69 74 65 2d 35 20 2f 20 50 52 4f atiaLite-5 / PRO
49c0: 4a 2e 34 3c 62 72 3e 0d 0a 6f 72 3c 62 72 3e 0d J.4<br>..or<br>.
49d0: 0a 62 79 20 61 6e 79 20 70 72 65 76 69 6f 75 73 .by any previous
49e0: 20 76 65 72 73 69 6f 6e 20 6f 66 20 53 70 61 74 version of Spat
49f0: 69 61 4c 69 74 65 20 28 3c 20 35 2e 30 2e 30 29 iaLite (< 5.0.0)
4a00: 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 </td>..</tr>..<t
4a10: 72 3e 0d 0a 3c 74 64 20 72 6f 77 73 70 61 6e 3d r>..<td rowspan=
4a20: 22 32 22 3e 53 70 61 74 69 61 4c 69 74 65 2d 35 "2">SpatiaLite-5
4a30: 20 62 75 69 6c 74 20 6f 6e 20 3c 62 3e 50 52 4f built on <b>PRO
4a40: 4a 2e 34 3c 2f 62 3e 3c 62 72 3e 0d 0a 6f 72 3c J.4</b><br>..or<
4a50: 62 72 3e 0d 0a 61 6e 79 20 70 72 65 76 69 6f 75 br>..any previou
4a60: 73 20 76 65 72 73 69 6f 6e 20 6f 66 20 53 70 61 s version of Spa
4a70: 74 69 61 4c 69 74 65 20 28 3c 20 35 2e 30 2e 30 tiaLite (< 5.0.0
4a80: 29 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 44 42 20 63 )</td>..<td>DB c
4a90: 72 65 61 74 65 64 20 62 79 20 53 70 61 74 69 61 reated by Spatia
4aa0: 4c 69 74 65 2d 35 20 2f 20 50 52 4f 4a 2e 36 3c Lite-5 / PROJ.6<
4ab0: 2f 74 64 3e 0d 0a 3c 74 64 20 72 6f 77 73 70 61 /td>..<td rowspa
4ac0: 6e 3d 22 32 22 3e 0d 0a 57 68 65 6e 20 3c 62 3e n="2">..When <b>
4ad0: 6c 69 62 73 70 61 74 69 61 6c 69 74 65 3c 2f 62 libspatialite</b
4ae0: 3e 20 28 61 6e 79 20 76 65 72 73 69 6f 6e 2c 20 > (any version,
4af0: 69 6e 63 6c 75 64 69 6e 67 20 35 2e 30 2e 30 29 including 5.0.0)
4b00: 20 69 73 20 6e 6f 74 20 73 75 70 70 6f 72 74 65 is not supporte
4b10: 64 20 62 79 20 50 52 4f 4a 2e 36 20 74 68 65 6e d by PROJ.6 then
4b20: 20 74 68 65 20 74 72 61 64 69 74 69 6f 6e 61 6c the traditional
4b30: 20 61 70 70 72 6f 61 63 68 20 77 69 6c 6c 20 62 approach will b
4b40: 65 20 61 6c 77 61 79 73 20 61 70 70 6c 69 65 64 e always applied
4b50: 2c 20 61 6e 64 20 65 61 63 68 20 43 52 53 20 77 , and each CRS w
4b60: 69 6c 6c 20 62 65 20 63 6f 6e 73 65 71 75 65 6e ill be consequen
4b70: 74 6c 79 20 69 64 65 6e 74 69 66 69 65 64 20 62 tly identified b
4b80: 79 20 69 74 73 20 63 6f 72 72 65 73 70 6f 6e 64 y its correspond
4b90: 69 6e 67 20 70 72 6f 6a 2d 73 74 72 69 6e 67 20 ing proj-string
4ba0: 73 74 6f 72 65 64 20 69 6e 20 63 6f 6c 75 6d 6e stored in column
4bb0: 20 3c 62 3e 70 72 6f 6a 34 74 65 78 74 3c 2f 62 <b>proj4text</b
4bc0: 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 4e 6f 74 65 20 ><br><br>..Note
4bd0: 74 68 61 74 20 65 76 65 6e 20 77 68 65 6e 20 50 that even when P
4be0: 52 4f 4a 2e 36 20 69 73 20 6e 6f 74 20 73 75 70 ROJ.6 is not sup
4bf0: 70 6f 72 74 65 64 20 61 6e 79 20 76 65 72 73 69 ported any versi
4c00: 6f 6e 20 6f 66 20 53 70 61 74 69 61 4c 69 74 65 on of SpatiaLite
4c10: 20 28 74 68 69 73 20 69 6e 63 6c 75 64 69 6e 67 (this including
4c20: 20 35 2e 30 2e 30 29 20 63 61 6e 20 73 61 66 65 5.0.0) can safe
4c30: 6c 79 20 63 6f 6e 6e 65 63 74 20 74 6f 20 61 6e ly connect to an
4c40: 79 20 44 42 2d 66 69 6c 65 20 63 72 65 61 74 65 y DB-file create
4c50: 64 20 62 79 20 74 68 65 20 6d 6f 73 74 20 72 65 d by the most re
4c60: 63 65 6e 74 20 76 65 72 73 69 6f 6e 20 77 69 74 cent version wit
4c70: 68 20 66 75 6c 6c 20 50 52 4f 4a 2e 36 20 73 75 h full PROJ.6 su
4c80: 70 70 6f 72 74 2e 0d 0a 3c 2f 74 64 3e 0d 0a 3c pport...</td>..<
4c90: 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e /tr>..<tr>..<td>
4ca0: 44 42 20 63 72 65 61 74 65 64 20 62 79 20 53 70 DB created by Sp
4cb0: 61 74 69 61 4c 69 74 65 2d 35 20 2f 20 50 52 4f atiaLite-5 / PRO
4cc0: 4a 2e 34 3c 62 72 3e 0d 0a 6f 72 3c 62 72 3e 0d J.4<br>..or<br>.
4cd0: 0a 62 79 20 61 6e 79 20 70 72 65 76 69 6f 75 73 .by any previous
4ce0: 20 76 65 72 73 69 6f 6e 20 6f 66 20 53 70 61 74 version of Spat
4cf0: 69 61 4c 69 74 65 20 28 3c 20 35 2e 30 2e 30 29 iaLite (< 5.0.0)
4d00: 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 2f </td>..</tr>..</
4d10: 74 61 62 6c 65 3e 3c 62 72 3e 3c 62 72 3e 0d 0a table><br><br>..
4d20: 3c 68 33 3e 45 78 69 73 74 69 6e 67 20 53 51 4c <h3>Existing SQL
4d30: 20 66 75 6e 63 74 69 6f 6e 73 20 61 66 66 65 63 functions affec
4d40: 74 65 64 20 62 79 20 50 52 4f 4a 2e 36 3c 2f 68 ted by PROJ.6</h
4d50: 33 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 3>..<table cells
4d60: 70 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 pacing="8" cellp
4d70: 61 64 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c adding="8" bgcol
4d80: 6f 72 3d 22 23 65 38 66 66 65 38 22 20 62 6f 72 or="#e8ffe8" bor
4d90: 64 65 72 3d 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 der="1">..<tr><t
4da0: 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 h bgcolor="#ffb0
4db0: 33 65 22 3e 53 51 4c 20 46 75 6e 63 74 69 6f 6e 3e">SQL Function
4dc0: 3c 2f 74 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 </th><th bgcolor
4dd0: 3d 22 23 66 66 62 30 33 65 22 3e 45 78 74 65 6e ="#ffb03e">Exten
4de0: 64 65 64 20 73 69 67 6e 61 74 75 72 65 3c 2f 74 ded signature</t
4df0: 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 h><th bgcolor="#
4e00: 66 66 62 30 33 65 22 3e 42 65 68 61 76 69 6f 72 ffb03e">Behavior
4e10: 20 75 6e 64 65 72 20 50 52 4f 4a 2e 36 3c 2f 74 under PROJ.6</t
4e20: 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 h></tr>..<tr><td
4e30: 3e 3c 62 3e 53 54 5f 54 72 61 6e 73 66 6f 72 6d ><b>ST_Transform
4e40: 28 29 3c 2f 62 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 ()</b></td>..<td
4e50: 3e 0d 0a 3c 62 3e 53 54 5f 54 72 61 6e 73 66 6f >..<b>ST_Transfo
4e60: 72 6d 3c 2f 62 3e 20 28 20 67 65 6f 6d 20 3c 69 rm</b> ( geom <i
4e70: 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 >Geometry</i> ,
4e80: 6e 65 77 53 72 69 64 20 3c 69 3e 49 6e 74 65 67 newSrid <i>Integ
4e90: 65 72 3c 2f 69 3e 20 2c 20 61 72 65 61 20 3c 69 er</i> , area <i
4ea0: 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 29 20 >Geometry</i> )
4eb0: 3a 20 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 : <i>Geometry</i
4ec0: 3e 3c 68 72 3e 0d 0a 3c 62 3e 53 54 5f 54 72 61 ><hr>..<b>ST_Tra
4ed0: 6e 73 66 6f 72 6d 3c 2f 62 3e 20 28 20 67 65 6f nsform</b> ( geo
4ee0: 6d 20 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 m <i>Geometry</i
4ef0: 3e 20 2c 20 6e 65 77 53 72 69 64 20 3c 69 3e 49 > , newSrid <i>I
4f00: 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 61 72 65 nteger</i> , are
4f10: 61 20 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 a <i>Geometry</i
4f20: 3e 20 2c 20 70 72 6f 6a 5f 73 74 72 69 6e 67 5f > , proj_string_
4f30: 66 72 6f 6d 20 3c 69 3e 54 65 78 74 3c 2f 69 3e from <i>Text</i>
4f40: 20 29 20 3a 20 3c 69 3e 47 65 6f 6d 65 74 72 79 ) : <i>Geometry
4f50: 3c 2f 69 3e 3c 68 72 3e 0d 0a 3c 62 3e 53 54 5f </i><hr>..<b>ST_
4f60: 54 72 61 6e 73 66 6f 72 6d 3c 2f 62 3e 20 28 20 Transform</b> (
4f70: 67 65 6f 6d 20 3c 69 3e 47 65 6f 6d 65 74 72 79 geom <i>Geometry
4f80: 3c 2f 69 3e 20 2c 20 6e 65 77 53 72 69 64 20 3c </i> , newSrid <
4f90: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 i>Integer</i> ,
4fa0: 61 72 65 61 20 3c 69 3e 47 65 6f 6d 65 74 72 79 area <i>Geometry
4fb0: 3c 2f 69 3e 20 2c 20 70 72 6f 6a 5f 73 74 72 69 </i> , proj_stri
4fc0: 6e 67 5f 66 72 6f 6d 20 3c 69 3e 54 65 78 74 3c ng_from <i>Text<
4fd0: 2f 69 3e 20 2c 20 70 72 6f 6a 5f 73 74 72 69 6e /i> , proj_strin
4fe0: 67 5f 74 6f 20 3c 69 3e 54 65 78 74 3c 2f 69 3e g_to <i>Text</i>
4ff0: 20 29 20 3a 20 3c 69 3e 47 65 6f 6d 65 74 72 79 ) : <i>Geometry
5000: 3c 2f 69 3e 0d 0a 3c 2f 74 64 3e 0d 0a 3c 74 64 </i>..</td>..<td
5010: 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 >..<table cellsp
5020: 61 63 69 6e 67 3d 22 34 22 20 63 65 6c 6c 70 61 acing="4" cellpa
5030: 64 64 69 6e 67 3d 22 34 22 20 62 67 63 6f 6c 6f dding="4" bgcolo
5040: 72 3d 22 23 66 66 66 66 64 30 22 3e 0d 0a 3c 74 r="#ffffd0">..<t
5050: 72 3e 3c 74 64 3e 0d 0a 3c 62 3e 3c 75 3e 3c 69 r><td>..<b><u><i
5060: 3e 4e 6f 74 65 3c 2f 69 3e 3c 2f 75 3e 3c 2f 62 >Note</i></u></b
5070: 3e 3a 20 61 6c 6c 20 74 68 65 73 65 20 3c 62 3e >: all these <b>
5080: 3c 69 3e 65 78 74 65 6e 64 65 64 20 73 69 67 6e <i>extended sign
5090: 61 74 75 72 65 73 3c 2f 69 3e 3c 2f 62 3e 20 61 atures</i></b> a
50a0: 72 65 20 73 75 70 70 6f 72 74 65 64 20 6f 6e 6c re supported onl
50b0: 79 20 77 68 65 6e 20 3c 62 3e 6c 69 62 73 70 61 y when <b>libspa
50c0: 74 69 61 6c 69 74 65 2d 35 2e 30 3c 2f 62 3e 20 tialite-5.0</b>
50d0: 68 61 73 20 62 65 65 6e 20 62 75 69 6c 74 20 6f has been built o
50e0: 6e 20 74 68 65 20 74 6f 70 20 6f 66 20 3c 62 3e n the top of <b>
50f0: 50 52 4f 4a 2e 36 3c 2f 62 3e 3c 62 72 3e 0d 0a PROJ.6</b><br>..
5100: 49 66 20 74 68 65 20 6c 69 62 72 61 72 79 20 68 If the library h
5110: 61 73 20 62 65 65 6e 20 62 75 69 6c 74 20 69 6e as been built in
5120: 73 74 65 61 64 20 6f 6e 20 65 61 72 6c 69 65 72 stead on earlier
5130: 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 50 52 4f versions of PRO
5140: 4a 20 61 6e 79 20 61 74 74 65 6d 70 74 20 74 6f J any attempt to
5150: 20 63 61 6c 6c 20 74 68 65 73 65 20 65 78 74 65 call these exte
5160: 6e 64 65 64 20 73 69 67 6e 61 74 75 72 65 73 20 nded signatures
5170: 77 69 6c 6c 20 6a 75 73 74 20 72 65 74 75 72 6e will just return
5180: 20 61 20 3c 62 3e 3c 69 3e 77 72 6f 6e 67 20 6e a <b><i>wrong n
5190: 75 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e umber of argumen
51a0: 74 73 20 74 6f 20 66 75 6e 63 74 69 6f 6e 20 53 ts to function S
51b0: 54 5f 54 72 61 6e 73 66 6f 72 6d 28 29 3c 2f 69 T_Transform()</i
51c0: 3e 3c 2f 62 3e 20 65 72 72 6f 72 2e 0d 0a 3c 2f ></b> error...</
51d0: 74 64 3e 3c 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 td><tr>..</table
51e0: 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 ><br>..<table ce
51f0: 6c 6c 73 70 61 63 69 6e 67 3d 22 34 22 20 63 65 llspacing="4" ce
5200: 6c 6c 70 61 64 64 69 6e 67 3d 22 34 22 20 62 67 llpadding="4" bg
5210: 63 6f 6c 6f 72 3d 22 23 66 66 64 66 64 30 22 3e color="#ffdfd0">
5220: 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 41 6e 79 20 ..<tr><td>..Any
5230: 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 invalid argument
5240: 20 70 61 73 73 65 64 20 74 6f 20 3c 62 3e 53 54 passed to <b>ST
5250: 5f 54 72 61 6e 73 66 6f 72 6d 28 29 3c 2f 62 3e _Transform()</b>
5260: 20 28 3c 62 3e 3c 69 3e 65 78 74 65 6e 64 65 64 (<b><i>extended
5270: 20 73 69 67 6e 61 74 75 72 65 73 3c 2f 69 3e 3c signatures</i><
5280: 2f 62 3e 29 20 77 69 6c 6c 20 72 61 69 73 65 20 /b>) will raise
5290: 61 6e 20 3c 62 3e 53 51 4c 20 45 78 63 65 70 74 an <b>SQL Except
52a0: 69 6f 6e 3c 2f 62 3e 2e 0d 0a 3c 2f 74 64 3e 3c ion</b>...</td><
52b0: 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 tr>..</table><br
52c0: 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 74 68 65 >..<ul>..<li>the
52d0: 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 optional argume
52e0: 6e 74 20 3c 62 3e 61 72 65 61 3c 2f 62 3e 20 6d nt <b>area</b> m
52f0: 61 79 20 62 65 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 ay be <b>NULL</b
5300: 3e 20 28 3c 69 3e 64 65 66 61 75 6c 74 20 73 65 > (<i>default se
5310: 74 74 69 6e 67 3c 2f 69 3e 29 2e 3c 62 72 3e 0d tting</i>).<br>.
5320: 0a 4f 74 68 65 72 77 69 73 65 20 69 74 27 73 20 .Otherwise it's
5330: 65 78 70 65 63 74 65 64 20 74 6f 20 63 6f 6e 74 expected to cont
5340: 61 69 6e 20 61 20 76 61 6c 69 64 20 47 65 6f 6d ain a valid Geom
5350: 65 74 72 79 20 69 6e 20 3c 62 3e 53 52 49 44 3d etry in <b>SRID=
5360: 34 33 32 36 20 28 6c 6f 6e 67 2f 6c 61 74 29 3c 4326 (long/lat)<
5370: 2f 62 3e 2e 0d 0a 57 68 65 6e 20 61 6e 20 3c 62 /b>...When an <b
5380: 3e 3c 69 3e 61 72 65 61 20 6f 66 20 75 73 65 3c ><i>area of use<
5390: 2f 69 3e 3c 2f 62 3e 20 69 73 20 65 78 70 6c 69 /i></b> is expli
53a0: 63 69 74 6c 79 20 73 75 70 70 6c 69 65 64 2c 20 citly supplied,
53b0: 74 68 65 6e 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f then <b>PROJ.6</
53c0: 62 3e 20 6d 61 79 20 65 76 65 6e 74 75 61 6c 6c b> may eventuall
53d0: 79 20 75 73 65 20 74 68 65 20 63 6f 72 72 65 73 y use the corres
53e0: 70 6f 6e 64 69 6e 67 20 3c 62 3e 42 42 4f 58 3c ponding <b>BBOX<
53f0: 2f 62 3e 20 66 6f 72 20 66 69 6e 65 6c 79 20 74 /b> for finely t
5400: 75 6e 69 6e 67 20 74 68 65 20 6d 6f 72 65 20 61 uning the more a
5410: 63 63 75 72 61 74 65 20 74 72 61 6e 73 66 6f 72 ccurate transfor
5420: 6d 61 74 69 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c mation.</li>..<l
5430: 69 3e 62 6f 74 68 20 74 68 65 20 6f 70 74 69 6f i>both the optio
5440: 6e 61 6c 20 61 72 67 75 6d 65 6e 74 73 20 3c 62 nal arguments <b
5450: 3e 70 72 6f 6a 5f 73 74 72 69 6e 67 5f 66 72 6f >proj_string_fro
5460: 6d 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 70 72 6f m</b> and <b>pro
5470: 6a 5f 73 74 72 69 6e 67 5f 74 6f 3c 2f 62 3e 20 j_string_to</b>
5480: 6d 61 79 20 62 65 20 3c 62 3e 4e 55 4c 4c 3c 2f may be <b>NULL</
5490: 62 3e 20 28 3c 69 3e 64 65 66 61 75 6c 74 20 73 b> (<i>default s
54a0: 65 74 74 69 6e 67 3c 2f 69 3e 29 2e 3c 62 72 3e etting</i>).<br>
54b0: 0d 0a 4f 74 68 65 72 77 69 73 65 20 74 68 65 79 ..Otherwise they
54c0: 20 61 72 65 20 65 78 70 65 63 74 65 64 20 74 6f are expected to
54d0: 20 63 6f 6e 74 61 69 6e 20 61 20 76 61 6c 69 64 contain a valid
54e0: 20 73 74 72 69 6e 67 20 74 6f 20 62 65 20 75 73 string to be us
54f0: 65 64 20 66 6f 72 20 69 64 65 6e 74 69 66 79 69 ed for identifyi
5500: 6e 67 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e ng the correspon
5510: 64 69 6e 67 20 43 52 53 2e 3c 62 72 3e 0d 0a 50 ding CRS.<br>..P
5520: 52 4f 4a 2e 36 20 61 63 63 65 70 74 73 20 74 68 ROJ.6 accepts th
5530: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 43 52 53 20 e following CRS
5540: 73 74 72 69 6e 67 73 3a 0d 0a 3c 75 6c 3e 0d 0a strings:..<ul>..
5550: 3c 6c 69 3e 74 72 61 64 69 74 69 6f 6e 61 6c 20 <li>traditional
5560: 3c 62 3e 3c 69 3e 70 72 6f 6a 2d 73 74 72 69 6e <b><i>proj-strin
5570: 67 73 3c 2f 69 3e 3c 2f 62 3e 20 75 73 65 64 20 gs</i></b> used
5580: 62 79 20 61 6c 6c 20 70 72 65 76 69 6f 75 73 20 by all previous
5590: 76 65 72 73 69 6f 6e 73 20 6f 66 20 50 52 4f 4a versions of PROJ
55a0: 2c 20 61 73 20 65 2e 67 2e 0d 0a 3c 75 6c 3e 0d , as e.g...<ul>.
55b0: 0a 3c 6c 69 3e 3c 62 3e 2b 70 72 6f 6a 3d 6d 65 .<li><b>+proj=me
55c0: 72 63 20 2b 61 3d 36 33 37 38 31 33 37 20 2b 62 rc +a=6378137 +b
55d0: 3d 36 33 37 38 31 33 37 20 2b 6c 61 74 5f 74 73 =6378137 +lat_ts
55e0: 3d 30 20 2b 6c 6f 6e 5f 30 3d 30 20 2b 78 5f 30 =0 +lon_0=0 +x_0
55f0: 3d 30 20 2b 79 5f 30 3d 30 20 2b 6b 3d 31 20 2b =0 +y_0=0 +k=1 +
5600: 75 6e 69 74 73 3d 6d 20 2b 6e 61 64 67 72 69 64 units=m +nadgrid
5610: 73 3d 40 6e 75 6c 6c 20 2b 77 6b 74 65 78 74 20 s=@null +wktext
5620: 2b 6e 6f 5f 64 65 66 73 3c 2f 62 3e 3c 2f 6c 69 +no_defs</b></li
5630: 3e 0d 0a 3c 6c 69 3e 3c 62 3e 2b 70 72 6f 6a 3d >..<li><b>+proj=
5640: 75 74 6d 20 2b 7a 6f 6e 65 3d 33 32 20 2b 73 6f utm +zone=32 +so
5650: 75 74 68 20 2b 65 6c 6c 70 73 3d 57 47 53 37 32 uth +ellps=WGS72
5660: 20 2b 74 6f 77 67 73 38 34 3d 30 2c 30 2c 34 2e +towgs84=0,0,4.
5670: 35 2c 30 2c 30 2c 30 2e 35 35 34 2c 30 2e 32 32 5,0,0,0.554,0.22
5680: 36 33 20 2b 75 6e 69 74 73 3d 6d 20 2b 6e 6f 5f 63 +units=m +no_
5690: 64 65 66 73 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c defs</b></li>..<
56a0: 6c 69 3e 3c 62 3e 2b 70 72 6f 6a 3d 75 74 6d 20 li><b>+proj=utm
56b0: 2b 7a 6f 6e 65 3d 33 32 20 2b 65 6c 6c 70 73 3d +zone=32 +ellps=
56c0: 69 6e 74 6c 20 2b 74 6f 77 67 73 38 34 3d 2d 38 intl +towgs84=-8
56d0: 37 2c 2d 39 38 2c 2d 31 32 31 2c 30 2c 30 2c 30 7,-98,-121,0,0,0
56e0: 2c 30 20 2b 75 6e 69 74 73 3d 6d 20 2b 6e 6f 5f ,0 +units=m +no_
56f0: 64 65 66 73 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c defs</b></li>..<
5700: 2f 75 6c 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c 69 3e /ul>..</ul></li>
5710: 0d 0a 3c 6c 69 3e 61 6e 79 20 3c 62 3e 3c 69 3e ..<li>any <b><i>
5720: 57 4b 54 20 65 78 70 72 65 73 73 69 6f 6e 3c 2f WKT expression</
5730: 69 3e 3c 2f 62 3e 20 64 65 66 69 6e 69 6e 67 20 i></b> defining
5740: 61 20 43 52 53 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 a CRS.</li>..<li
5750: 3e 61 20 3c 62 3e 3c 69 3e 43 52 53 20 6e 61 6d >a <b><i>CRS nam
5760: 65 3c 2f 69 3e 3c 2f 62 3e 20 61 73 20 65 2e 67 e</i></b> as e.g
5770: 2e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e ...<ul>..<li><b>
5780: 57 47 53 20 38 34 3c 2f 62 3e 3c 2f 6c 69 3e 0d WGS 84</b></li>.
5790: 0a 3c 6c 69 3e 3c 62 3e 57 47 53 20 38 34 20 2f .<li><b>WGS 84 /
57a0: 20 55 54 4d 20 7a 6f 6e 65 20 33 32 4e 3c 2f 62 UTM zone 32N</b
57b0: 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 49 ></li>..<li><b>I
57c0: 47 4d 39 35 20 2f 20 55 54 4d 20 7a 6f 6e 65 20 GM95 / UTM zone
57d0: 33 33 4e 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 33N</b></li>..</
57e0: 75 6c 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 61 6e ul></li>..<li>an
57f0: 79 20 3c 62 3e 3c 69 3e 63 61 6e 6f 6e 69 63 61 y <b><i>canonica
5800: 6c 20 43 52 53 20 72 65 66 65 72 65 6e 63 65 3c l CRS reference<
5810: 2f 69 3e 3c 2f 62 3e 20 61 73 20 65 2e 67 2e 0d /i></b> as e.g..
5820: 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 45 50 .<ul>..<li><b>EP
5830: 53 47 3a 34 33 32 36 3c 2f 62 3e 3c 2f 6c 69 3e SG:4326</b></li>
5840: 0d 0a 3c 6c 69 3e 3c 62 3e 75 72 6e 3a 6f 67 63 ..<li><b>urn:ogc
5850: 3a 64 65 66 3a 63 72 73 3a 45 50 53 47 3a 3a 33 :def:crs:EPSG::3
5860: 30 30 33 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 003</b></li>..</
5870: 75 6c 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d ul></li>..</ul>.
5880: 0a 3c 62 72 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 .<br>..<ul>..<li
5890: 3e 3c 62 3e 3c 75 3e 3c 69 3e 53 70 65 63 69 61 ><b><u><i>Specia
58a0: 6c 20 63 61 73 65 3c 2f 69 3e 3c 2f 75 3e 3c 2f l case</i></u></
58b0: 62 3e 3a 20 69 66 20 3c 62 3e 70 72 6f 6a 5f 73 b>: if <b>proj_s
58c0: 74 72 69 6e 67 5f 74 6f 3c 2f 62 3e 20 69 73 20 tring_to</b> is
58d0: 4e 55 4c 4c 20 77 68 69 6c 73 74 20 3c 62 3e 70 NULL whilst <b>p
58e0: 72 6f 6a 5f 73 74 72 69 6e 67 5f 66 72 6f 6d 3c roj_string_from<
58f0: 2f 62 3e 20 69 73 20 65 78 70 6c 69 63 69 74 6c /b> is explicitl
5900: 79 20 73 65 74 2c 20 74 68 65 6e 20 69 74 20 77 y set, then it w
5910: 69 6c 6c 20 69 6e 74 65 72 70 72 65 74 65 64 20 ill interpreted
5920: 61 73 20 61 6e 20 75 73 65 72 20 64 65 66 69 6e as an user defin
5930: 65 64 20 3c 62 3e 74 72 61 6e 73 66 6f 72 6d 61 ed <b>transforma
5940: 74 69 6f 6e 20 73 74 72 69 6e 67 3c 2f 62 3e 20 tion string</b>
5950: 28 70 6f 73 73 69 62 6c 79 2c 20 61 73 20 61 20 (possibly, as a
5960: 3c 62 3e 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f <b>transformatio
5970: 6e 20 70 69 70 65 6c 69 6e 65 3c 2f 62 3e 29 20 n pipeline</b>)
5980: 61 73 20 65 2e 67 2e 0d 0a 3c 75 6c 3e 0d 0a 3c as e.g...<ul>..<
5990: 6c 69 3e 3c 62 3e 2b 70 72 6f 6a 3d 70 69 70 65 li><b>+proj=pipe
59a0: 6c 69 6e 65 3c 62 72 3e 0d 0a 2b 73 74 65 70 20 line<br>..+step
59b0: 2b 70 72 6f 6a 3d 61 78 69 73 73 77 61 70 20 2b +proj=axisswap +
59c0: 6f 72 64 65 72 3d 32 2c 31 3c 62 72 3e 20 0d 0a order=2,1<br> ..
59d0: 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 75 6e 69 74 +step +proj=unit
59e0: 63 6f 6e 76 65 72 74 20 2b 78 79 5f 69 6e 3d 64 convert +xy_in=d
59f0: 65 67 20 2b 78 79 5f 6f 75 74 3d 72 61 64 3c 62 eg +xy_out=rad<b
5a00: 72 3e 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d r>..+step +proj=
5a10: 70 75 73 68 20 2b 76 5f 33 3c 62 72 3e 0d 0a 2b push +v_3<br>..+
5a20: 73 74 65 70 20 2b 70 72 6f 6a 3d 63 61 72 74 20 step +proj=cart
5a30: 2b 65 6c 6c 70 73 3d 57 47 53 38 34 3c 62 72 3e +ellps=WGS84<br>
5a40: 20 0d 0a 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 ..+step +inv +p
5a50: 72 6f 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 3d 2d roj=helmert +x=-
5a60: 31 30 34 2e 31 20 2b 79 3d 2d 34 39 2e 31 20 2b 104.1 +y=-49.1 +
5a70: 7a 3d 2d 39 2e 39 20 2b 72 78 3d 30 2e 39 37 31 z=-9.9 +rx=0.971
5a80: 20 2b 72 79 3d 2d 32 2e 39 31 37 20 2b 72 7a 3d +ry=-2.917 +rz=
5a90: 30 2e 37 31 34 20 2b 73 3d 2d 31 31 2e 36 38 20 0.714 +s=-11.68
5aa0: 2b 63 6f 6e 76 65 6e 74 69 6f 6e 3d 70 6f 73 69 +convention=posi
5ab0: 74 69 6f 6e 5f 76 65 63 74 6f 72 3c 62 72 3e 0d tion_vector<br>.
5ac0: 0a 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f .+step +inv +pro
5ad0: 6a 3d 63 61 72 74 20 2b 65 6c 6c 70 73 3d 69 6e j=cart +ellps=in
5ae0: 74 6c 3c 62 72 3e 0d 0a 2b 73 74 65 70 20 2b 70 tl<br>..+step +p
5af0: 72 6f 6a 3d 70 6f 70 20 2b 76 5f 33 3c 62 72 3e roj=pop +v_3<br>
5b00: 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 74 ..+step +proj=t
5b10: 6d 65 72 63 20 2b 6c 61 74 5f 30 3d 30 20 2b 6c merc +lat_0=0 +l
5b20: 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 2e 39 39 39 36 on_0=9 +k=0.9996
5b30: 20 2b 78 5f 30 3d 31 35 30 30 30 30 30 20 2b 79 +x_0=1500000 +y
5b40: 5f 30 3d 30 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c _0=0 +ellps=intl
5b50: 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e </b></li>..</ul>
5b60: 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 2f 74 64 3e 3c 2f ..</ul>..</td></
5b70: 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 20 63 6f 6c tr>..<tr><td col
5b80: 73 70 61 6e 3d 22 33 22 3e 0d 0a 3c 68 33 3e 4e span="3">..<h3>N
5b90: 6f 74 65 73 3c 2f 68 33 3e 0d 0a 3c 75 6c 3e 0d otes</h3>..<ul>.
5ba0: 0a 3c 6c 69 3e 53 70 61 74 69 61 4c 69 74 65 20 .<li>SpatiaLite
5bb0: 64 6f 65 73 20 6e 6f 74 20 63 6f 6e 73 74 72 61 does not constra
5bc0: 69 6e 74 73 20 79 6f 75 20 69 6e 20 61 6e 79 20 ints you in any
5bd0: 77 61 79 20 61 6e 64 20 66 75 6c 6c 79 20 72 65 way and fully re
5be0: 73 70 65 63 74 73 20 75 73 65 72 73 20 66 72 65 spects users fre
5bf0: 65 64 6f 6d 20 63 61 72 65 66 75 6c 6c 79 20 61 edom carefully a
5c00: 76 6f 69 64 69 6e 67 20 3c 69 3e 61 75 74 6f 2d voiding <i>auto-
5c10: 6d 61 67 69 63 61 6c 3c 2f 69 3e 20 61 73 73 75 magical</i> assu
5c20: 6d 70 74 69 6f 6e 73 2e 0d 0a 3c 75 6c 3e 0d 0a mptions...<ul>..
5c30: 3c 6c 69 3e 54 68 65 20 6e 65 77 20 3c 62 3e 3c <li>The new <b><
5c40: 69 3e 65 78 74 65 6e 64 65 64 20 73 69 67 6e 61 i>extended signa
5c50: 74 75 72 65 73 3c 2f 69 3e 3c 2f 62 3e 20 73 75 tures</i></b> su
5c60: 70 70 6f 72 74 65 64 20 62 79 20 3c 62 3e 53 54 pported by <b>ST
5c70: 5f 54 72 61 6e 73 66 6f 72 6d 3c 2f 62 3e 20 63 _Transform</b> c
5c80: 6c 6f 73 65 6c 79 20 6d 69 6d 69 63 20 74 68 65 losely mimic the
5c90: 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 50 52 4f most recent PRO
5ca0: 4a 2e 36 20 41 50 49 2c 20 73 6f 20 79 6f 75 20 J.6 API, so you
5cb0: 61 72 65 20 66 72 65 65 20 74 6f 20 64 65 66 69 are free to defi
5cc0: 6e 65 20 79 6f 75 72 20 63 6f 6f 72 64 69 6e 61 ne your coordina
5cd0: 74 65 73 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 tes transformati
5ce0: 6f 6e 73 20 69 6e 20 73 65 76 65 72 61 6c 20 64 ons in several d
5cf0: 69 66 66 65 72 65 6e 74 20 77 61 79 73 2e 3c 2f ifferent ways.</
5d00: 6c 69 3e 20 0d 0a 3c 6c 69 3e 54 68 65 20 64 65 li> ..<li>The de
5d10: 66 61 75 6c 74 20 62 65 68 61 76 69 6f 72 20 6f fault behavior o
5d20: 66 20 53 70 61 74 69 61 4c 69 74 65 20 77 68 65 f SpatiaLite whe
5d30: 6e 20 75 73 69 6e 67 20 50 52 4f 4a 2e 36 20 69 n using PROJ.6 i
5d40: 73 20 74 6f 20 63 6f 6d 70 6c 65 74 65 6c 79 20 s to completely
5d50: 69 67 6e 6f 72 65 20 74 68 65 20 43 52 53 20 64 ignore the CRS d
5d60: 65 66 69 6e 69 74 69 6f 6e 73 20 73 74 6f 72 65 efinitions store
5d70: 64 20 77 69 74 68 69 6e 20 74 68 65 20 69 6e 74 d within the int
5d80: 65 72 6e 61 6c 20 74 61 62 6c 65 20 3c 62 3e 73 ernal table <b>s
5d90: 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 3c 2f patial_ref_sys</
5da0: 62 3e 3c 62 72 3e 0d 0a 41 6e 79 20 72 65 71 75 b><br>..Any requ
5db0: 69 72 65 64 20 43 52 53 20 64 65 66 69 6e 69 74 ired CRS definit
5dc0: 69 6f 6e 20 77 69 6c 6c 20 62 65 20 61 6c 77 61 ion will be alwa
5dd0: 79 73 20 72 65 74 72 69 65 76 65 64 20 66 72 6f ys retrieved fro
5de0: 6d 20 50 52 4f 4a 2e 36 20 69 74 73 65 6c 66 20 m PROJ.6 itself
5df0: 74 68 61 74 20 77 69 6c 6c 20 73 69 6d 70 6c 79 that will simply
5e00: 20 72 65 63 65 69 76 65 20 61 20 72 65 71 75 65 receive a reque
5e10: 73 74 20 69 6e 20 74 68 65 20 66 6f 72 6d 20 3c st in the form <
5e20: 62 3e 3c 69 3e 66 72 6f 6d 20 45 50 53 47 3a 33 b><i>from EPSG:3
5e30: 32 36 33 32 20 74 6f 20 45 50 53 47 3a 33 30 30 2632 to EPSG:300
5e40: 33 3c 2f 69 3e 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 3</i></b>.</li>.
5e50: 0a 3c 6c 69 3e 49 66 20 79 6f 75 20 68 61 76 65 .<li>If you have
5e60: 20 61 6e 79 20 67 6f 6f 64 20 72 65 61 73 6f 6e any good reason
5e70: 20 73 75 67 67 65 73 74 69 6e 67 20 74 6f 20 64 suggesting to d
5e80: 6f 20 73 75 63 68 20 61 20 74 68 69 6e 67 2c 20 o such a thing,
5e90: 79 6f 75 20 61 72 65 20 61 6e 79 77 61 79 20 66 you are anyway f
5ea0: 72 65 65 20 74 6f 20 75 73 65 20 61 6e 79 20 6b ree to use any k
5eb0: 69 6e 64 20 6f 66 20 70 72 6f 6a 2d 73 74 72 69 ind of proj-stri
5ec0: 6e 67 73 2c 20 57 4b 54 20 64 65 66 69 6e 69 74 ngs, WKT definit
5ed0: 69 6f 6e 73 20 6f 72 20 43 52 53 20 6e 61 6d 65 ions or CRS name
5ee0: 73 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 50 s supported by P
5ef0: 52 4f 4a 2e 36 3c 2f 62 3e 2e 3c 62 72 3e 0d 0a ROJ.6</b>.<br>..
5f00: 42 75 74 20 74 68 69 73 20 69 73 20 75 6e 64 65 But this is unde
5f10: 72 20 79 6f 75 72 20 66 75 6c 6c 20 72 65 73 70 r your full resp
5f20: 6f 6e 73 69 62 69 6c 69 74 79 2c 20 61 6e 64 20 onsibility, and
5f30: 79 6f 75 20 6d 75 73 74 20 62 65 20 77 65 6c 6c you must be well
5f40: 20 73 65 6c 66 2d 63 6f 6e 73 63 69 6f 75 73 20 self-conscious
5f50: 6f 66 20 77 68 61 74 20 61 72 65 20 79 6f 75 20 of what are you
5f60: 64 6f 69 6e 67 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 doing.</li>..</u
5f70: 6c 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 53 70 61 l></li>..<li>Spa
5f80: 74 69 61 4c 69 74 65 20 65 6e 63 6f 75 72 61 67 tiaLite encourag
5f90: 65 73 20 61 6e 64 20 70 72 6f 6d 6f 74 65 73 20 es and promotes
5fa0: 74 68 65 20 6d 6f 73 74 20 63 72 65 61 74 69 76 the most creativ
5fb0: 65 20 75 73 65 73 20 6f 66 20 50 52 4f 4a 2e 36 e uses of PROJ.6
5fc0: 2c 20 74 68 69 73 20 69 6e 63 6c 75 64 69 6e 67 , this including
5fd0: 20 75 73 69 6e 67 20 79 6f 75 72 20 6f 77 6e 20 using your own
5fe0: 63 75 73 74 6f 6d 69 7a 65 64 20 3c 62 3e 74 72 customized <b>tr
5ff0: 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 ansformation pip
6000: 65 6c 69 6e 65 73 3c 2f 62 3e 2e 3c 62 72 3e 0d elines</b>.<br>.
6010: 0a 43 6f 72 72 65 63 74 6c 79 20 75 73 69 6e 67 .Correctly using
6020: 20 63 75 73 74 6f 6d 20 74 72 61 6e 73 66 6f 72 custom transfor
6030: 6d 61 74 69 6f 6e 73 20 69 73 6e 27 74 20 6e 65 mations isn't ne
6040: 63 65 73 73 61 72 69 6c 79 20 73 69 6d 70 6c 65 cessarily simple
6050: 20 61 6e 64 20 65 61 73 79 2c 20 62 75 74 20 69 and easy, but i
6060: 74 27 73 20 61 20 62 69 67 20 6f 70 70 6f 72 74 t's a big opport
6070: 75 6e 69 74 79 20 66 6f 72 20 61 6c 6c 20 73 6b unity for all sk
6080: 69 6c 6c 65 64 20 61 6e 64 20 74 61 6c 65 6e 74 illed and talent
6090: 65 64 20 70 6f 77 65 72 20 75 73 65 72 73 2e 3c ed power users.<
60a0: 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 3c /li>..</ul><br><
60b0: 62 72 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d br>..</td></tr>.
60c0: 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 46 .</table><br>..F
60d0: 65 77 20 70 72 61 63 74 69 63 61 6c 20 53 51 4c ew practical SQL
60e0: 20 65 78 61 6d 70 6c 65 73 3a 0d 0a 3c 76 65 72 examples:..<ver
60f0: 62 61 74 69 6d 3e 0d 0a 2d 2d 20 66 72 6f 6d 20 batim>..-- from
6100: 45 50 53 47 3a 34 33 32 36 20 74 6f 20 45 50 53 EPSG:4326 to EPS
6110: 47 3a 33 30 30 33 20 2d 20 64 65 66 61 75 6c 74 G:3003 - default
6120: 20 73 65 74 74 69 6e 67 73 3b 20 69 67 6e 6f 72 settings; ignor
6130: 69 6e 67 20 73 70 61 74 69 61 6c 69 74 65 5f 72 ing spatialite_r
6140: 65 66 5f 73 79 73 20 61 6e 64 20 72 65 6c 79 69 ef_sys and relyi
6150: 6e 67 20 6f 6e 20 50 52 4f 4a 2e 36 20 6f 77 6e ng on PROJ.6 own
6160: 20 70 72 69 76 61 74 65 20 64 61 74 61 62 61 73 private databas
6170: 65 0d 0a 53 45 4c 45 43 54 20 41 73 45 57 4b 54 e..SELECT AsEWKT
6180: 20 28 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 ( ST_Transform(
6190: 20 4d 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e 38 MakePoint( 11.8
61a0: 37 38 30 35 36 20 2c 20 34 33 2e 34 36 33 30 35 78056 , 43.46305
61b0: 36 20 2c 20 34 33 32 36 20 29 20 2c 20 33 30 30 6 , 4326 ) , 300
61c0: 33 20 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 3 ));..---------
61d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
61e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52 ------------..SR
61f0: 49 44 3d 33 30 30 33 3b 50 4f 49 4e 54 28 31 37 ID=3003;POINT(17
6200: 33 32 38 35 32 2e 39 34 32 37 31 36 37 36 39 20 32852.942716769
6210: 34 38 31 36 32 37 37 2e 36 31 37 36 39 30 36 37 4816277.61769067
6220: 34 29 0d 0a 0d 0a 0d 0a 2d 2d 20 66 72 6f 6d 20 4)......-- from
6230: 45 50 53 47 3a 34 33 32 36 20 74 6f 20 45 50 53 EPSG:4326 to EPS
6240: 47 3a 33 30 30 33 20 2d 20 65 78 61 63 74 6c 79 G:3003 - exactly
6250: 20 74 68 65 20 73 61 6d 65 20 61 73 20 61 62 6f the same as abo
6260: 76 65 2c 20 62 75 74 20 74 68 69 73 20 74 69 6d ve, but this tim
6270: 65 20 69 6e 20 61 6e 20 65 78 70 6c 69 63 69 74 e in an explicit
6280: 20 66 6f 72 6d 0d 0a 53 45 4c 45 43 54 20 41 73 form..SELECT As
6290: 45 57 4b 54 20 28 20 53 54 5f 54 72 61 6e 73 66 EWKT ( ST_Transf
62a0: 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 6e 74 28 20 orm( MakePoint(
62b0: 31 31 2e 38 37 38 30 35 36 20 2c 20 34 33 2e 34 11.878056 , 43.4
62c0: 36 33 30 35 36 2c 20 34 33 32 36 20 29 20 2c 20 63056, 4326 ) ,
62d0: 33 30 30 33 2c 20 4e 55 4c 4c 2c 20 27 45 50 53 3003, NULL, 'EPS
62e0: 47 3a 34 33 32 36 27 2c 20 27 45 50 53 47 3a 33 G:4326', 'EPSG:3
62f0: 30 30 33 27 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 003'));..-------
6300: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6310: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a --------------..
6320: 53 52 49 44 3d 33 30 30 33 3b 50 4f 49 4e 54 28 SRID=3003;POINT(
6330: 31 37 33 32 38 35 32 2e 39 34 32 37 31 36 37 36 1732852.94271676
6340: 39 20 34 38 31 36 32 37 37 2e 36 31 37 36 39 30 9 4816277.617690
6350: 36 37 34 29 0d 0a 0d 0a 0d 0a 2d 2d 20 66 72 6f 674)......-- fro
6360: 6d 20 45 50 53 47 3a 34 33 32 36 20 74 6f 20 45 m EPSG:4326 to E
6370: 50 53 47 3a 33 30 30 33 20 2d 20 73 61 6d 65 20 PSG:3003 - same
6380: 61 73 20 61 62 6f 76 65 2c 20 75 73 69 6e 67 20 as above, using
6390: 74 68 65 20 61 6c 74 65 72 6e 61 74 69 76 65 20 the alternative
63a0: 6e 6f 74 61 74 69 6f 6e 0d 0a 53 45 4c 45 43 54 notation..SELECT
63b0: 20 41 73 45 57 4b 54 20 28 20 53 54 5f 54 72 61 AsEWKT ( ST_Tra
63c0: 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 6e nsform( MakePoin
63d0: 74 28 20 31 31 2e 38 37 38 30 35 36 20 2c 20 34 t( 11.878056 , 4
63e0: 33 2e 34 36 33 30 35 36 2c 20 34 33 32 36 20 29 3.463056, 4326 )
63f0: 20 2c 20 33 30 30 33 2c 20 4e 55 4c 4c 2c 20 27 , 3003, NULL, '
6400: 75 72 6e 3a 6f 67 63 3a 64 65 66 3a 63 72 73 3a urn:ogc:def:crs:
6410: 45 50 53 47 3a 3a 34 33 32 36 27 2c 20 27 75 72 EPSG::4326', 'ur
6420: 6e 3a 6f 67 63 3a 64 65 66 3a 63 72 73 3a 45 50 n:ogc:def:crs:EP
6430: 53 47 3a 3a 33 30 30 33 27 29 29 3b 0d 0a 2d 2d SG::3003'));..--
6440: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6450: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6460: 2d 2d 2d 0d 0a 53 52 49 44 3d 33 30 30 33 3b 50 ---..SRID=3003;P
6470: 4f 49 4e 54 28 31 37 33 32 38 35 32 2e 39 34 32 OINT(1732852.942
6480: 37 31 36 37 36 39 20 34 38 31 36 32 37 37 2e 36 716769 4816277.6
6490: 31 37 36 39 30 36 37 34 29 0d 0a 0d 0a 0d 0a 2d 17690674)......-
64a0: 2d 20 66 72 6f 6d 20 45 50 53 47 3a 34 33 32 36 - from EPSG:4326
64b0: 20 74 6f 20 45 50 53 47 3a 33 30 30 33 20 2d 20 to EPSG:3003 -
64c0: 65 78 70 6c 69 63 69 74 6c 79 20 70 61 73 73 69 explicitly passi
64d0: 6e 67 20 43 52 53 20 6e 61 6d 65 73 0d 0a 53 45 ng CRS names..SE
64e0: 4c 45 43 54 20 41 73 45 57 4b 54 20 28 20 53 54 LECT AsEWKT ( ST
64f0: 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 _Transform( Make
6500: 50 6f 69 6e 74 28 20 31 31 2e 38 37 38 30 35 36 Point( 11.878056
6510: 20 2c 20 34 33 2e 34 36 33 30 35 36 2c 20 34 33 , 43.463056, 43
6520: 32 36 20 29 20 2c 20 33 30 30 33 2c 20 4e 55 4c 26 ) , 3003, NUL
6530: 4c 2c 20 27 57 47 53 20 38 34 27 2c 20 27 4d 6f L, 'WGS 84', 'Mo
6540: 6e 74 65 20 4d 61 72 69 6f 20 2f 20 49 74 61 6c nte Mario / Ital
6550: 79 20 7a 6f 6e 65 20 31 27 29 29 3b 0d 0a 2d 2d y zone 1'));..--
6560: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6570: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6580: 2d 2d 2d 0d 0a 53 52 49 44 3d 33 30 30 33 3b 50 ---..SRID=3003;P
6590: 4f 49 4e 54 28 31 37 33 32 38 35 32 2e 39 34 32 OINT(1732852.942
65a0: 37 31 36 37 36 39 20 34 38 31 36 32 37 37 2e 36 716769 4816277.6
65b0: 31 37 36 39 30 36 37 34 29 0d 0a 0d 0a 0d 0a 2d 17690674)......-
65c0: 2d 20 66 72 6f 6d 20 45 50 53 47 3a 34 33 32 36 - from EPSG:4326
65d0: 20 74 6f 20 45 50 53 47 3a 33 30 30 33 20 2d 20 to EPSG:3003 -
65e0: 73 69 6d 75 6c 61 74 69 6e 67 20 74 68 65 20 63 simulating the c
65f0: 6c 61 73 73 69 63 20 50 52 4f 4a 2e 34 20 61 70 lassic PROJ.4 ap
6600: 70 72 6f 61 63 68 20 62 61 73 65 64 20 6f 6e 20 proach based on
6610: 70 72 6f 6a 2d 73 74 72 69 6e 67 73 20 73 74 6f proj-strings sto
6620: 72 65 64 20 69 6e 74 6f 20 73 70 61 74 69 61 6c red into spatial
6630: 5f 72 65 66 5f 73 79 73 0d 0a 53 45 4c 45 43 54 _ref_sys..SELECT
6640: 20 41 73 45 57 4b 54 20 28 20 53 54 5f 54 72 61 AsEWKT ( ST_Tra
6650: 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 6e nsform( MakePoin
6660: 74 28 20 31 31 2e 38 37 38 30 35 36 20 2c 20 34 t( 11.878056 , 4
6670: 33 2e 34 36 33 30 35 36 2c 20 34 33 32 36 20 29 3.463056, 4326 )
6680: 20 2c 20 33 30 30 33 20 2c 20 4e 55 4c 4c 20 2c , 3003 , NULL ,
6690: 20 0d 0a 20 20 28 53 45 4c 45 43 54 20 70 72 6f .. (SELECT pro
66a0: 6a 34 74 65 78 74 20 46 52 4f 4d 20 73 70 61 74 j4text FROM spat
66b0: 69 61 6c 5f 72 65 66 5f 73 79 73 20 57 48 45 52 ial_ref_sys WHER
66c0: 45 20 73 72 69 64 20 3d 20 34 33 32 36 29 2c 0d E srid = 4326),.
66d0: 0a 20 20 28 53 45 4c 45 43 54 20 70 72 6f 6a 34 . (SELECT proj4
66e0: 74 65 78 74 20 46 52 4f 4d 20 73 70 61 74 69 61 text FROM spatia
66f0: 6c 5f 72 65 66 5f 73 79 73 20 57 48 45 52 45 20 l_ref_sys WHERE
6700: 73 72 69 64 20 3d 20 33 30 30 33 29 29 29 3b 0d srid = 3003)));.
6710: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
6720: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6730: 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d 33 30 30 ------..SRID=300
6740: 33 3b 50 4f 49 4e 54 28 31 37 33 32 38 35 32 2e 3;POINT(1732852.
6750: 39 34 32 37 31 36 37 36 39 20 34 38 31 36 32 37 942716769 481627
6760: 37 2e 36 31 37 36 39 30 36 37 34 29 0d 0a 0d 0a 7.617690674)....
6770: 0d 0a 2d 2d 20 66 72 6f 6d 20 45 50 53 47 3a 34 ..-- from EPSG:4
6780: 33 32 36 20 74 6f 20 45 50 53 47 3a 33 30 30 33 326 to EPSG:3003
6790: 20 2d 20 66 61 6e 63 79 20 6d 6f 64 65 20 62 61 - fancy mode ba
67a0: 73 65 64 20 6f 6e 20 57 4b 54 20 65 78 70 72 65 sed on WKT expre
67b0: 73 73 69 6f 6e 73 20 73 74 6f 72 65 64 20 69 6e ssions stored in
67c0: 74 6f 20 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 to spatial_ref_s
67d0: 79 73 0d 0a 53 45 4c 45 43 54 20 41 73 45 57 4b ys..SELECT AsEWK
67e0: 54 20 28 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d T ( ST_Transform
67f0: 28 20 4d 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e ( MakePoint( 11.
6800: 38 37 38 30 35 36 20 2c 20 34 33 2e 34 36 33 30 878056 , 43.4630
6810: 35 36 2c 20 34 33 32 36 20 29 20 2c 20 33 30 30 56, 4326 ) , 300
6820: 33 2c 20 4e 55 4c 4c 2c 20 0d 0a 20 20 28 53 45 3, NULL, .. (SE
6830: 4c 45 43 54 20 73 72 74 65 78 74 20 46 52 4f 4d LECT srtext FROM
6840: 20 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 spatial_ref_sys
6850: 20 57 48 45 52 45 20 73 72 69 64 20 3d 20 34 33 WHERE srid = 43
6860: 32 36 29 2c 0d 0a 20 20 28 53 45 4c 45 43 54 20 26),.. (SELECT
6870: 73 72 74 65 78 74 20 46 52 4f 4d 20 73 70 61 74 srtext FROM spat
6880: 69 61 6c 5f 72 65 66 5f 73 79 73 20 57 48 45 52 ial_ref_sys WHER
6890: 45 20 73 72 69 64 20 3d 20 33 30 30 33 29 29 29 E srid = 3003)))
68a0: 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ;..-------------
68b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
68c0: 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d 33 --------..SRID=3
68d0: 30 30 33 3b 50 4f 49 4e 54 28 31 37 33 32 38 35 003;POINT(173285
68e0: 32 2e 39 34 32 37 31 36 37 36 39 20 34 38 31 36 2.942716769 4816
68f0: 32 37 37 2e 36 31 37 36 39 30 36 37 34 29 0d 0a 277.617690674)..
6900: 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 54 68 69 </verbatim>..Thi
6910: 73 20 66 69 72 73 74 20 74 65 73 74 20 69 73 20 s first test is
6920: 62 61 73 65 64 20 6f 6e 20 61 20 6e 65 77 20 53 based on a new S
6930: 70 61 74 69 61 4c 69 74 65 20 64 61 74 61 62 61 patiaLite databa
6940: 73 65 20 63 72 65 61 74 65 64 20 77 69 74 68 20 se created with
6950: 66 75 6c 6c 20 50 52 4f 4a 2e 36 20 73 75 70 70 full PROJ.6 supp
6960: 6f 72 74 2e 20 54 68 65 72 65 20 69 73 6e 27 74 ort. There isn't
6970: 20 61 6e 79 74 68 69 6e 67 20 77 6f 72 74 68 20 anything worth
6980: 74 6f 20 62 65 20 6e 6f 74 65 64 2c 20 65 78 63 to be noted, exc
6990: 65 70 74 20 74 68 61 74 20 61 6c 6c 20 6d 65 74 ept that all met
69a0: 68 6f 64 73 20 72 65 74 75 72 6e 20 74 68 65 20 hods return the
69b0: 73 61 6d 65 20 72 65 73 75 6c 74 73 2e 3c 62 72 same results.<br
69c0: 3e 3c 62 72 3e 0d 0a 3c 76 65 72 62 61 74 69 6d ><br>..<verbatim
69d0: 3e 0d 0a 2d 2d 20 66 72 6f 6d 20 45 50 53 47 3a >..-- from EPSG:
69e0: 34 33 32 36 20 74 6f 20 45 50 53 47 3a 33 30 30 4326 to EPSG:300
69f0: 33 20 2d 20 75 73 69 6e 67 20 61 20 74 72 61 6e 3 - using a tran
6a00: 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 6c sformation pipel
6a10: 69 6e 65 0d 0a 53 45 4c 45 43 54 20 41 73 45 57 ine..SELECT AsEW
6a20: 4b 54 20 28 20 53 54 5f 54 72 61 6e 73 66 6f 72 KT ( ST_Transfor
6a30: 6d 28 20 53 77 61 70 43 6f 6f 72 64 73 20 28 20 m( SwapCoords (
6a40: 4d 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 MakePoint( 11.87
6a50: 38 30 35 36 20 2c 20 34 33 2e 34 36 33 30 35 36 8056 , 43.463056
6a60: 2c 20 34 33 32 36 20 29 20 29 20 2c 20 33 30 30 , 4326 ) ) , 300
6a70: 33 20 2c 20 4e 55 4c 4c 20 2c 0d 0a 27 2b 70 72 3 , NULL ,..'+pr
6a80: 6f 6a 3d 70 69 70 65 6c 69 6e 65 20 0d 0a 2b 73 oj=pipeline ..+s
6a90: 74 65 70 20 2b 70 72 6f 6a 3d 61 78 69 73 73 77 tep +proj=axissw
6aa0: 61 70 20 2b 6f 72 64 65 72 3d 32 2c 31 20 0d 0a ap +order=2,1 ..
6ab0: 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 75 6e 69 74 +step +proj=unit
6ac0: 63 6f 6e 76 65 72 74 20 2b 78 79 5f 69 6e 3d 64 convert +xy_in=d
6ad0: 65 67 20 2b 78 79 5f 6f 75 74 3d 72 61 64 20 0d eg +xy_out=rad .
6ae0: 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 75 73 .+step +proj=pus
6af0: 68 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b h +v_3 ..+step +
6b00: 70 72 6f 6a 3d 63 61 72 74 20 2b 65 6c 6c 70 73 proj=cart +ellps
6b10: 3d 57 47 53 38 34 20 0d 0a 2b 73 74 65 70 20 2b =WGS84 ..+step +
6b20: 69 6e 76 20 2b 70 72 6f 6a 3d 68 65 6c 6d 65 72 inv +proj=helmer
6b30: 74 20 2b 78 3d 2d 31 30 34 2e 31 20 2b 79 3d 2d t +x=-104.1 +y=-
6b40: 34 39 2e 31 20 2b 7a 3d 2d 39 2e 39 20 2b 72 78 49.1 +z=-9.9 +rx
6b50: 3d 30 2e 39 37 31 20 2b 72 79 3d 2d 32 2e 39 31 =0.971 +ry=-2.91
6b60: 37 20 2b 72 7a 3d 30 2e 37 31 34 20 2b 73 3d 2d 7 +rz=0.714 +s=-
6b70: 31 31 2e 36 38 20 2b 63 6f 6e 76 65 6e 74 69 6f 11.68 +conventio
6b80: 6e 3d 70 6f 73 69 74 69 6f 6e 5f 76 65 63 74 6f n=position_vecto
6b90: 72 20 0d 0a 2b 73 74 65 70 20 2b 69 6e 76 20 2b r ..+step +inv +
6ba0: 70 72 6f 6a 3d 63 61 72 74 20 2b 65 6c 6c 70 73 proj=cart +ellps
6bb0: 3d 69 6e 74 6c 20 0d 0a 2b 73 74 65 70 20 2b 70 =intl ..+step +p
6bc0: 72 6f 6a 3d 70 6f 70 20 2b 76 5f 33 20 0d 0a 2b roj=pop +v_3 ..+
6bd0: 73 74 65 70 20 2b 70 72 6f 6a 3d 74 6d 65 72 63 step +proj=tmerc
6be0: 20 2b 6c 61 74 5f 30 3d 30 20 2b 6c 6f 6e 5f 30 +lat_0=0 +lon_0
6bf0: 3d 39 20 2b 6b 3d 30 2e 39 39 39 36 20 2b 78 5f =9 +k=0.9996 +x_
6c00: 30 3d 31 35 30 30 30 30 30 20 2b 79 5f 30 3d 30 0=1500000 +y_0=0
6c10: 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c 27 20 29 29 +ellps=intl' ))
6c20: 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ;..-------------
6c30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6c40: 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d 33 --------..SRID=3
6c50: 30 30 33 3b 50 4f 49 4e 54 28 31 37 33 32 38 35 003;POINT(173285
6c60: 32 2e 39 34 32 37 31 36 37 36 39 20 34 38 31 36 2.942716769 4816
6c70: 32 37 37 2e 36 31 37 36 39 30 36 37 34 29 0d 0a 277.617690674)..
6c80: 0d 0a 0d 0a 2d 2d 20 66 72 6f 6d 20 45 50 53 47 ....-- from EPSG
6c90: 3a 34 33 32 36 20 74 6f 20 45 50 53 47 3a 33 30 :4326 to EPSG:30
6ca0: 30 33 20 2d 20 75 73 69 6e 67 20 61 20 63 75 73 03 - using a cus
6cb0: 74 6f 6d 69 7a 65 64 20 74 72 61 6e 73 66 6f 72 tomized transfor
6cc0: 6d 61 74 69 6f 6e 20 70 69 70 65 6c 69 6e 65 0d mation pipeline.
6cd0: 0a 53 45 4c 45 43 54 20 41 73 45 57 4b 54 20 28 .SELECT AsEWKT (
6ce0: 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d ST_Transform( M
6cf0: 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 38 akePoint( 11.878
6d00: 30 35 36 20 2c 20 34 33 2e 34 36 33 30 35 36 2c 056 , 43.463056,
6d10: 20 34 33 32 36 20 29 20 2c 20 33 30 30 33 20 2c 4326 ) , 3003 ,
6d20: 20 4e 55 4c 4c 20 2c 0d 0a 27 2b 70 72 6f 6a 3d NULL ,..'+proj=
6d30: 70 69 70 65 6c 69 6e 65 20 20 0d 0a 2b 73 74 65 pipeline ..+ste
6d40: 70 20 2b 70 72 6f 6a 3d 75 6e 69 74 63 6f 6e 76 p +proj=unitconv
6d50: 65 72 74 20 2b 78 79 5f 69 6e 3d 64 65 67 20 2b ert +xy_in=deg +
6d60: 78 79 5f 6f 75 74 3d 72 61 64 20 0d 0a 2b 73 74 xy_out=rad ..+st
6d70: 65 70 20 2b 70 72 6f 6a 3d 70 75 73 68 20 2b 76 ep +proj=push +v
6d80: 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a _3 ..+step +proj
6d90: 3d 63 61 72 74 20 2b 65 6c 6c 70 73 3d 57 47 53 =cart +ellps=WGS
6da0: 38 34 20 0d 0a 2b 73 74 65 70 20 2b 69 6e 76 20 84 ..+step +inv
6db0: 2b 70 72 6f 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 +proj=helmert +x
6dc0: 3d 2d 31 30 34 2e 31 20 2b 79 3d 2d 34 39 2e 31 =-104.1 +y=-49.1
6dd0: 20 2b 7a 3d 2d 39 2e 39 20 2b 72 78 3d 30 2e 39 +z=-9.9 +rx=0.9
6de0: 37 31 20 2b 72 79 3d 2d 32 2e 39 31 37 20 2b 72 71 +ry=-2.917 +r
6df0: 7a 3d 30 2e 37 31 34 20 2b 73 3d 2d 31 31 2e 36 z=0.714 +s=-11.6
6e00: 38 20 2b 63 6f 6e 76 65 6e 74 69 6f 6e 3d 70 6f 8 +convention=po
6e10: 73 69 74 69 6f 6e 5f 76 65 63 74 6f 72 20 0d 0a sition_vector ..
6e20: 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a +step +inv +proj
6e30: 3d 63 61 72 74 20 2b 65 6c 6c 70 73 3d 69 6e 74 =cart +ellps=int
6e40: 6c 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d l ..+step +proj=
6e50: 70 6f 70 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 pop +v_3 ..+step
6e60: 20 2b 70 72 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61 +proj=tmerc +la
6e70: 74 5f 30 3d 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b t_0=0 +lon_0=9 +
6e80: 6b 3d 30 2e 39 39 39 36 20 2b 78 5f 30 3d 31 35 k=0.9996 +x_0=15
6e90: 30 30 30 30 30 20 2b 79 5f 30 3d 30 20 2b 65 6c 00000 +y_0=0 +el
6ea0: 6c 70 73 3d 69 6e 74 6c 27 20 29 29 3b 0d 0a 2d lps=intl' ));..-
6eb0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6ec0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6ed0: 2d 2d 2d 2d 0d 0a 53 52 49 44 3d 33 30 30 33 3b ----..SRID=3003;
6ee0: 50 4f 49 4e 54 28 31 37 33 32 38 35 32 2e 39 34 POINT(1732852.94
6ef0: 32 37 31 36 37 36 39 20 34 38 31 36 32 37 37 2e 2716769 4816277.
6f00: 36 31 37 36 39 30 36 37 34 29 0d 0a 3c 2f 76 65 617690674)..</ve
6f10: 72 62 61 74 69 6d 3e 0d 0a 54 68 69 73 20 73 65 rbatim>..This se
6f20: 63 6f 6e 64 20 74 65 73 74 20 69 73 20 62 61 73 cond test is bas
6f30: 65 64 20 6f 6e 20 75 73 69 6e 67 20 3c 62 3e 3c ed on using <b><
6f40: 69 3e 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e i>transformation
6f50: 20 70 69 70 65 6c 69 6e 65 73 3c 2f 69 3e 3c 2f pipelines</i></
6f60: 62 3e 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 74 b>:..<ul>..<li>t
6f70: 68 65 20 66 69 72 73 74 20 71 75 65 72 79 20 64 he first query d
6f80: 69 72 65 63 74 6c 79 20 75 73 65 73 20 61 20 63 irectly uses a c
6f90: 61 6e 6f 6e 69 63 61 6c 20 73 74 72 69 6e 67 20 anonical string
6fa0: 72 65 70 72 65 73 65 6e 74 69 6e 67 20 74 68 65 representing the
6fb0: 20 70 69 70 65 6c 69 6e 65 20 61 73 20 72 65 74 pipeline as ret
6fc0: 75 72 6e 69 6e 67 20 62 79 20 74 68 69 73 20 63 urning by this c
6fd0: 6f 6d 6d 61 6e 64 20 65 78 65 63 75 74 65 64 20 ommand executed
6fe0: 66 72 6f 6d 20 74 68 65 20 73 68 65 6c 6c 3a 0d from the shell:.
6ff0: 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 70 72 6f .<verbatim>..pro
7000: 6a 69 6e 66 6f 20 20 2d 73 20 45 50 53 47 3a 34 jinfo -s EPSG:4
7010: 33 32 36 20 2d 74 20 45 50 53 47 3a 33 30 30 33 326 -t EPSG:3003
7020: 20 2d 2d 61 72 65 61 20 20 22 49 74 61 6c 79 20 --area "Italy
7030: 2d 20 6d 61 69 6e 6c 61 6e 64 22 20 2d 6f 20 70 - mainland" -o p
7040: 72 6f 6a 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e roj..</verbatim>
7050: 0d 0a 28 77 65 27 6c 6c 20 73 65 65 20 74 68 69 ..(we'll see thi
7060: 73 20 74 6f 70 69 63 20 69 6e 20 6d 6f 72 65 20 s topic in more
7070: 64 65 70 74 68 20 6f 6e 20 74 68 65 20 6e 65 78 depth on the nex
7080: 74 20 73 65 63 74 69 6f 6e 29 2e 3c 2f 6c 69 3e t section).</li>
7090: 0d 0a 3c 6c 69 3e 74 68 65 20 73 65 63 6f 6e 64 ..<li>the second
70a0: 20 71 75 65 72 79 20 69 73 20 6a 75 73 74 20 61 query is just a
70b0: 20 73 6d 61 6c 6c 20 61 64 61 70 74 61 74 69 6f small adaptatio
70c0: 6e 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 6f n of the first o
70d0: 6e 65 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 41 ne:..<ul>..<li>A
70e0: 73 20 79 6f 75 20 63 61 6e 20 6e 6f 74 69 63 65 s you can notice
70f0: 20 74 68 65 20 66 69 72 73 74 20 71 75 65 72 79 the first query
7100: 20 72 65 71 75 69 72 65 73 20 63 61 6c 6c 69 6e requires callin
7110: 67 20 3c 62 3e 53 77 61 70 43 6f 6f 64 69 6e 61 g <b>SwapCoodina
7120: 74 65 73 28 29 3c 2f 62 3e 20 62 65 63 61 75 73 tes()</b> becaus
7130: 65 20 74 68 65 20 66 69 72 73 74 20 73 74 65 70 e the first step
7140: 20 6f 66 20 74 68 65 20 70 69 70 65 6c 69 6e 65 of the pipeline
7150: 20 68 61 73 20 61 6e 20 3c 62 3e 61 78 69 73 73 has an <b>axiss
7160: 77 61 70 3c 2f 62 3e 20 64 69 72 65 63 74 69 76 wap</b> directiv
7170: 65 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 54 68 65 e.</li>..<li>The
7180: 20 73 65 63 6f 6e 64 20 71 75 65 72 79 20 6a 75 second query ju
7190: 73 74 20 61 76 6f 69 64 73 20 74 6f 20 63 61 6c st avoids to cal
71a0: 6c 20 3c 62 3e 53 77 61 70 43 6f 6f 72 64 73 28 l <b>SwapCoords(
71b0: 29 3c 2f 62 3e 20 61 6e 64 20 63 6f 6e 73 65 71 )</b> and conseq
71c0: 75 65 6e 74 6c 79 20 74 68 69 73 20 66 69 72 73 uently this firs
71d0: 74 20 73 74 65 70 20 68 61 73 20 62 65 65 6e 20 t step has been
71e0: 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 removed from the
71f0: 20 70 69 70 65 6c 69 6e 65 20 73 6f 20 74 6f 20 pipeline so to
7200: 67 65 74 20 74 68 65 20 73 61 6d 65 20 69 64 65 get the same ide
7210: 6e 74 69 63 61 6c 20 6f 76 65 72 61 6c 6c 20 65 ntical overall e
7220: 66 66 65 63 74 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 ffect.</li>..</u
7230: 6c 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e l></li>..<li><b>
7240: 3c 75 3e 4e 6f 74 65 3c 2f 75 3e 3c 2f 62 3e 3a <u>Note</u></b>:
7250: 20 53 70 61 74 69 61 4c 69 74 65 20 61 6e 64 20 SpatiaLite and
7260: 50 52 4f 4a 2e 36 20 77 69 6c 6c 20 61 6c 77 61 PROJ.6 will alwa
7270: 79 73 20 64 6f 20 61 20 62 65 73 74 20 65 66 66 ys do a best eff
7280: 6f 72 74 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 ort in order to
7290: 67 75 65 73 73 20 69 66 20 73 77 61 70 70 69 6e guess if swappin
72a0: 67 20 74 68 65 20 63 6f 6f 72 64 69 6e 61 74 65 g the coordinate
72b0: 73 20 69 73 20 72 65 71 75 69 72 65 64 20 6f 72 s is required or
72c0: 20 6e 6f 74 2e 3c 62 72 3e 0d 0a 42 75 74 20 69 not.<br>..But i
72d0: 6e 20 74 68 65 20 73 70 65 63 69 66 69 63 20 63 n the specific c
72e0: 61 73 65 20 6f 66 20 74 72 61 6e 73 66 6f 72 6d ase of transform
72f0: 61 74 69 6f 6e 20 70 69 70 65 6c 69 6e 65 73 20 ation pipelines
7300: 74 68 65 20 75 73 65 72 20 69 73 20 65 78 70 65 the user is expe
7310: 63 74 65 64 20 74 6f 20 65 78 70 6c 69 63 69 74 cted to explicit
7320: 6c 79 20 63 61 6c 6c 20 3c 62 3e 53 77 61 70 43 ly call <b>SwapC
7330: 6f 6f 72 64 73 28 29 3c 2f 62 3e 20 77 68 65 6e oords()</b> when
7340: 65 76 65 72 20 72 65 71 75 69 72 65 64 2e 3c 2f ever required.</
7350: 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 0d 0a li>..</ul><br>..
7360: 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 <table cellspaci
7370: 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 69 ng="8" cellpaddi
7380: 6e 67 3d 22 31 36 22 20 62 67 63 6f 6c 6f 72 3d ng="16" bgcolor=
7390: 22 23 63 39 66 66 66 30 22 3e 0d 0a 3c 74 72 3e "#c9fff0">..<tr>
73a0: 3c 74 64 3e 0d 0a 3c 68 32 3e 54 65 63 68 20 4e <td>..<h2>Tech N
73b0: 6f 74 65 3a 20 75 73 69 6e 67 20 70 72 6f 6a 69 ote: using proji
73c0: 6e 66 6f 20 66 6f 72 20 64 69 73 63 6f 76 65 72 nfo for discover
73d0: 69 6e 67 20 70 69 70 65 6c 69 6e 65 73 20 61 6e ing pipelines an
73e0: 64 20 61 72 65 61 73 20 6f 66 20 75 73 65 3c 2f d areas of use</
73f0: 68 32 3e 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d h2>..<verbatim>.
7400: 0a 70 72 6f 6a 69 6e 66 6f 20 2d 73 20 45 50 53 .projinfo -s EPS
7410: 47 3a 34 33 32 36 20 2d 74 20 45 50 53 47 3a 33 G:4326 -t EPSG:3
7420: 30 30 33 20 2d 6f 20 70 72 6f 6a 20 2d 2d 73 70 003 -o proj --sp
7430: 61 74 69 61 6c 2d 74 65 73 74 20 69 6e 74 65 72 atial-test inter
7440: 73 65 63 74 0d 0a 43 61 6e 64 69 64 61 74 65 20 sect..Candidate
7450: 6f 70 65 72 61 74 69 6f 6e 73 20 66 6f 75 6e 64 operations found
7460: 3a 20 33 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d : 3..-----------
7470: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
7480: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 4f 70 65 72 ----------..Oper
7490: 61 74 69 6f 6e 20 6e c2 b0 31 3a 0d 0a 0d 0a 75 ation n..1:....u
74a0: 6e 6b 6e 6f 77 6e 20 69 64 2c 20 49 6e 76 65 72 nknown id, Inver
74b0: 73 65 20 6f 66 20 4d 6f 6e 74 65 20 4d 61 72 69 se of Monte Mari
74c0: 6f 20 74 6f 20 57 47 53 20 38 34 20 28 34 29 20 o to WGS 84 (4)
74d0: 2b 20 49 74 61 6c 79 20 7a 6f 6e 65 20 31 2c 20 + Italy zone 1,
74e0: 34 20 6d 2c 20 49 74 61 6c 79 20 2d 20 6d 61 69 4 m, Italy - mai
74f0: 6e 6c 61 6e 64 0d 0a 0d 0a 50 52 4f 4a 20 73 74 nland....PROJ st
7500: 72 69 6e 67 3a 0d 0a 2b 70 72 6f 6a 3d 70 69 70 ring:..+proj=pip
7510: 65 6c 69 6e 65 20 0d 0a 2b 73 74 65 70 20 2b 70 eline ..+step +p
7520: 72 6f 6a 3d 61 78 69 73 73 77 61 70 20 2b 6f 72 roj=axisswap +or
7530: 64 65 72 3d 32 2c 31 20 0d 0a 2b 73 74 65 70 20 der=2,1 ..+step
7540: 2b 70 72 6f 6a 3d 75 6e 69 74 63 6f 6e 76 65 72 +proj=unitconver
7550: 74 20 2b 78 79 5f 69 6e 3d 64 65 67 20 2b 78 79 t +xy_in=deg +xy
7560: 5f 6f 75 74 3d 72 61 64 20 0d 0a 2b 73 74 65 70 _out=rad ..+step
7570: 20 2b 70 72 6f 6a 3d 70 75 73 68 20 2b 76 5f 33 +proj=push +v_3
7580: 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 63 ..+step +proj=c
7590: 61 72 74 20 2b 65 6c 6c 70 73 3d 57 47 53 38 34 art +ellps=WGS84
75a0: 20 0d 0a 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 ..+step +inv +p
75b0: 72 6f 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 3d 2d roj=helmert +x=-
75c0: 31 30 34 2e 31 20 2b 79 3d 2d 34 39 2e 31 20 2b 104.1 +y=-49.1 +
75d0: 7a 3d 2d 39 2e 39 20 2b 72 78 3d 30 2e 39 37 31 z=-9.9 +rx=0.971
75e0: 20 2b 72 79 3d 2d 32 2e 39 31 37 20 2b 72 7a 3d +ry=-2.917 +rz=
75f0: 30 2e 37 31 34 20 2b 73 3d 2d 31 31 2e 36 38 20 0.714 +s=-11.68
7600: 2b 63 6f 6e 76 65 6e 74 69 6f 6e 3d 70 6f 73 69 +convention=posi
7610: 74 69 6f 6e 5f 76 65 63 74 6f 72 20 0d 0a 2b 73 tion_vector ..+s
7620: 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d 63 tep +inv +proj=c
7630: 61 72 74 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20 art +ellps=intl
7640: 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 6f ..+step +proj=po
7650: 70 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b p +v_3 ..+step +
7660: 70 72 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 5f proj=tmerc +lat_
7670: 30 3d 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 0=0 +lon_0=9 +k=
7680: 30 2e 39 39 39 36 20 2b 78 5f 30 3d 31 35 30 30 0.9996 +x_0=1500
7690: 30 30 30 20 2b 79 5f 30 3d 30 20 2b 65 6c 6c 70 000 +y_0=0 +ellp
76a0: 73 3d 69 6e 74 6c 0d 0a 0d 0a 2d 2d 2d 2d 2d 2d s=intl....------
76b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
76c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d ---------------.
76d0: 0a 4f 70 65 72 61 74 69 6f 6e 20 6e c2 b0 32 3a .Operation n..2:
76e0: 0d 0a 0d 0a 75 6e 6b 6e 6f 77 6e 20 69 64 2c 20 ....unknown id,
76f0: 49 6e 76 65 72 73 65 20 6f 66 20 4d 6f 6e 74 65 Inverse of Monte
7700: 20 4d 61 72 69 6f 20 74 6f 20 57 47 53 20 38 34 Mario to WGS 84
7710: 20 28 32 29 20 2b 20 49 74 61 6c 79 20 7a 6f 6e (2) + Italy zon
7720: 65 20 31 2c 20 34 20 6d 2c 20 49 74 61 6c 79 20 e 1, 4 m, Italy
7730: 2d 20 53 61 72 64 69 6e 69 61 20 6f 6e 73 68 6f - Sardinia onsho
7740: 72 65 0d 0a 0d 0a 50 52 4f 4a 20 73 74 72 69 6e re....PROJ strin
7750: 67 3a 0d 0a 2b 70 72 6f 6a 3d 70 69 70 65 6c 69 g:..+proj=pipeli
7760: 6e 65 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a ne ..+step +proj
7770: 3d 61 78 69 73 73 77 61 70 20 2b 6f 72 64 65 72 =axisswap +order
7780: 3d 32 2c 31 20 0d 0a 2b 73 74 65 70 20 2b 70 72 =2,1 ..+step +pr
7790: 6f 6a 3d 75 6e 69 74 63 6f 6e 76 65 72 74 20 2b oj=unitconvert +
77a0: 78 79 5f 69 6e 3d 64 65 67 20 2b 78 79 5f 6f 75 xy_in=deg +xy_ou
77b0: 74 3d 72 61 64 20 0d 0a 2b 73 74 65 70 20 2b 70 t=rad ..+step +p
77c0: 72 6f 6a 3d 70 75 73 68 20 2b 76 5f 33 20 0d 0a roj=push +v_3 ..
77d0: 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 63 61 72 74 +step +proj=cart
77e0: 20 2b 65 6c 6c 70 73 3d 57 47 53 38 34 20 0d 0a +ellps=WGS84 ..
77f0: 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a +step +inv +proj
7800: 3d 68 65 6c 6d 65 72 74 20 2b 78 3d 2d 31 36 38 =helmert +x=-168
7810: 2e 36 20 2b 79 3d 2d 33 34 20 2b 7a 3d 33 38 2e .6 +y=-34 +z=38.
7820: 36 20 2b 72 78 3d 2d 30 2e 33 37 34 20 2b 72 79 6 +rx=-0.374 +ry
7830: 3d 2d 30 2e 36 37 39 20 2b 72 7a 3d 2d 31 2e 33 =-0.679 +rz=-1.3
7840: 37 39 20 2b 73 3d 2d 39 2e 34 38 20 2b 63 6f 6e 79 +s=-9.48 +con
7850: 76 65 6e 74 69 6f 6e 3d 70 6f 73 69 74 69 6f 6e vention=position
7860: 5f 76 65 63 74 6f 72 20 0d 0a 2b 73 74 65 70 20 _vector ..+step
7870: 2b 69 6e 76 20 2b 70 72 6f 6a 3d 63 61 72 74 20 +inv +proj=cart
7880: 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20 0d 0a 2b 73 +ellps=intl ..+s
7890: 74 65 70 20 2b 70 72 6f 6a 3d 70 6f 70 20 2b 76 tep +proj=pop +v
78a0: 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a _3 ..+step +proj
78b0: 3d 74 6d 65 72 63 20 2b 6c 61 74 5f 30 3d 30 20 =tmerc +lat_0=0
78c0: 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 2e 39 39 +lon_0=9 +k=0.99
78d0: 39 36 20 2b 78 5f 30 3d 31 35 30 30 30 30 30 20 96 +x_0=1500000
78e0: 2b 79 5f 30 3d 30 20 2b 65 6c 6c 70 73 3d 69 6e +y_0=0 +ellps=in
78f0: 74 6c 0d 0a 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d tl....----------
7900: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
7910: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 4f 70 65 -----------..Ope
7920: 72 61 74 69 6f 6e 20 6e c2 b0 33 3a 0d 0a 0d 0a ration n..3:....
7930: 75 6e 6b 6e 6f 77 6e 20 69 64 2c 20 49 6e 76 65 unknown id, Inve
7940: 72 73 65 20 6f 66 20 4d 6f 6e 74 65 20 4d 61 72 rse of Monte Mar
7950: 69 6f 20 74 6f 20 57 47 53 20 38 34 20 28 31 31 io to WGS 84 (11
7960: 29 20 2b 20 49 74 61 6c 79 20 7a 6f 6e 65 20 31 ) + Italy zone 1
7970: 2c 20 31 30 20 6d 2c 20 49 74 61 6c 79 20 2d 20 , 10 m, Italy -
7980: 53 69 63 69 6c 79 20 53 74 72 61 69 74 20 77 65 Sicily Strait we
7990: 73 74 20 6f 66 20 31 33 c2 b0 45 0d 0a 0d 0a 50 st of 13..E....P
79a0: 52 4f 4a 20 73 74 72 69 6e 67 3a 0d 0a 2b 70 72 ROJ string:..+pr
79b0: 6f 6a 3d 70 69 70 65 6c 69 6e 65 20 0d 0a 2b 73 oj=pipeline ..+s
79c0: 74 65 70 20 2b 70 72 6f 6a 3d 61 78 69 73 73 77 tep +proj=axissw
79d0: 61 70 20 2b 6f 72 64 65 72 3d 32 2c 31 20 0d 0a ap +order=2,1 ..
79e0: 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 75 6e 69 74 +step +proj=unit
79f0: 63 6f 6e 76 65 72 74 20 2b 78 79 5f 69 6e 3d 64 convert +xy_in=d
7a00: 65 67 20 2b 78 79 5f 6f 75 74 3d 72 61 64 20 0d eg +xy_out=rad .
7a10: 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 75 73 .+step +proj=pus
7a20: 68 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b h +v_3 ..+step +
7a30: 70 72 6f 6a 3d 63 61 72 74 20 2b 65 6c 6c 70 73 proj=cart +ellps
7a40: 3d 57 47 53 38 34 20 0d 0a 2b 73 74 65 70 20 2b =WGS84 ..+step +
7a50: 70 72 6f 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 3d proj=helmert +x=
7a60: 32 33 30 2e 34 37 20 2b 79 3d 35 36 2e 30 38 20 230.47 +y=56.08
7a70: 2b 7a 3d 2d 32 32 2e 34 33 20 0d 0a 2b 73 74 65 +z=-22.43 ..+ste
7a80: 70 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d 63 61 72 p +inv +proj=car
7a90: 74 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20 0d 0a t +ellps=intl ..
7aa0: 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 6f 70 20 +step +proj=pop
7ab0: 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 +v_3 ..+step +pr
7ac0: 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 5f 30 3d oj=tmerc +lat_0=
7ad0: 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 2e 0 +lon_0=9 +k=0.
7ae0: 39 39 39 36 20 2b 78 5f 30 3d 31 35 30 30 30 30 9996 +x_0=150000
7af0: 30 20 2b 79 5f 30 3d 30 20 2b 65 6c 6c 70 73 3d 0 +y_0=0 +ellps=
7b00: 69 6e 74 6c 0d 0a 3c 2f 76 65 72 62 61 74 69 6d intl..</verbatim
7b10: 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c >..</td></tr>..<
7b20: 2f 74 61 62 6c 65 3e 3c 62 72 3e 3c 62 72 3e 0d /table><br><br>.
7b30: 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 2d 2d 20 .<verbatim>..--
7b40: 66 72 6f 6d 20 45 50 53 47 3a 34 32 36 20 74 6f from EPSG:426 to
7b50: 20 45 50 53 47 3a 33 30 30 33 20 2d 20 64 65 66 EPSG:3003 - def
7b60: 61 75 6c 74 20 73 65 74 74 69 6e 67 73 2c 20 4e ault settings, N
7b70: 55 4c 4c 20 61 72 65 61 20 6f 66 20 75 73 65 0d ULL area of use.
7b80: 0a 53 45 4c 45 43 54 20 41 73 45 57 4b 54 20 28 .SELECT AsEWKT (
7b90: 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d ST_Transform( M
7ba0: 61 6b 65 50 6f 69 6e 74 28 20 39 2e 31 36 39 34 akePoint( 9.1694
7bb0: 36 34 2c 20 33 39 2e 34 37 38 32 37 35 2c 20 34 64, 39.478275, 4
7bc0: 33 32 36 20 29 2c 20 33 30 30 33 20 29 29 3b 0d 326 ), 3003 ));.
7bd0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
7be0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
7bf0: 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d 33 30 30 ------..SRID=300
7c00: 33 3b 50 4f 49 4e 54 28 31 35 31 34 36 30 30 2e 3;POINT(1514600.
7c10: 31 33 34 33 32 31 38 36 32 20 34 33 36 39 38 37 134321862 436987
7c20: 34 2e 34 38 39 32 36 39 39 35 37 29 0d 0a 0d 0a 4.489269957)....
7c30: 0d 0a 2d 2d 20 66 72 6f 6d 20 45 50 53 47 3a 34 ..-- from EPSG:4
7c40: 32 36 20 74 6f 20 45 50 53 47 3a 33 30 30 33 20 26 to EPSG:3003
7c50: 2d 20 64 65 66 61 75 6c 74 20 73 65 74 74 69 6e - default settin
7c60: 67 73 2c 20 62 75 74 20 74 68 69 73 20 74 69 6d gs, but this tim
7c70: 65 20 65 78 70 6c 69 63 69 74 6c 79 20 64 65 66 e explicitly def
7c80: 69 6e 69 6e 67 20 74 68 65 20 4d 42 52 20 61 6b ining the MBR ak
7c90: 61 20 42 42 4f 58 20 6f 66 20 61 20 73 70 65 63 a BBOX of a spec
7ca0: 69 66 69 63 20 61 72 65 61 20 6f 66 20 75 73 65 ific area of use
7cb0: 0d 0a 53 45 4c 45 43 54 20 41 73 45 57 4b 54 20 ..SELECT AsEWKT
7cc0: 28 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 ( ST_Transform(
7cd0: 4d 61 6b 65 50 6f 69 6e 74 28 20 39 2e 31 36 39 MakePoint( 9.169
7ce0: 34 36 34 2c 20 33 39 2e 34 37 38 32 37 35 2c 20 464, 39.478275,
7cf0: 34 33 32 36 20 29 2c 20 33 30 30 33 20 2c 20 42 4326 ), 3003 , B
7d00: 75 69 6c 64 4d 42 52 28 39 2e 31 20 2c 20 33 39 uildMBR(9.1 , 39
7d10: 2e 34 20 2c 20 39 2e 32 20 2c 20 33 39 2e 35 20 .4 , 9.2 , 39.5
7d20: 2c 20 34 33 32 36 20 29 29 29 3b 0d 0a 2d 2d 2d , 4326 )));..---
7d30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
7d40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
7d50: 2d 2d 0d 0a 53 52 49 44 3d 33 30 30 33 3b 50 4f --..SRID=3003;PO
7d60: 49 4e 54 28 31 35 31 34 36 30 35 2e 39 38 32 37 INT(1514605.9827
7d70: 36 32 32 34 38 20 34 33 36 39 38 37 33 2e 30 30 62248 4369873.00
7d80: 34 32 32 36 39 34 33 29 0d 0a 3c 2f 76 65 72 62 4226943)..</verb
7d90: 61 74 69 6d 3e 0d 0a 54 68 69 72 64 20 61 6e 64 atim>..Third and
7da0: 20 66 69 6e 61 6c 20 65 78 61 6d 70 6c 65 2e 20 final example.
7db0: 49 6e 20 73 6f 6d 65 20 63 61 73 65 73 20 65 78 In some cases ex
7dc0: 70 6c 69 63 69 74 6c 79 20 64 65 66 69 6e 69 6e plicitly definin
7dd0: 67 20 61 20 73 70 65 63 69 66 69 63 20 3c 62 3e g a specific <b>
7de0: 3c 69 3e 61 72 65 61 20 6f 66 20 75 73 65 3c 2f <i>area of use</
7df0: 69 3e 3c 2f 62 3e 20 6d 61 79 20 65 6e 61 62 6c i></b> may enabl
7e00: 65 20 50 52 4f 4a 2e 36 20 74 6f 20 73 65 6c 65 e PROJ.6 to sele
7e10: 63 74 20 61 6e 20 6f 70 74 69 6d 69 7a 65 64 20 ct an optimized
7e20: 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 6c transformation l
7e30: 65 61 64 69 6e 67 20 74 6f 20 6d 6f 72 65 20 70 eading to more p
7e40: 72 65 63 69 73 65 20 72 65 73 75 6c 74 73 2e 3c recise results.<
7e50: 62 72 3e 0d 0a 49 6e 20 74 68 69 73 20 65 78 61 br>..In this exa
7e60: 6d 70 6c 65 20 77 65 27 76 65 20 75 73 65 64 20 mple we've used
7e70: 61 20 50 6f 69 6e 74 20 6c 6f 63 61 74 65 64 20 a Point located
7e80: 69 6e 20 53 61 72 64 69 6e 69 61 2c 20 61 6e 64 in Sardinia, and
7e90: 20 50 52 4f 4a 2e 36 20 73 75 70 70 6f 72 74 73 PROJ.6 supports
7ea0: 20 73 65 76 65 72 61 6c 20 66 6c 61 76 6f 72 73 several flavors
7eb0: 20 6f 66 20 3c 62 3e 45 50 53 47 3a 33 30 30 33 of <b>EPSG:3003
7ec0: 3c 2f 62 3e 20 64 65 70 65 6e 64 69 6e 67 20 6f </b> depending o
7ed0: 6e 20 74 68 65 20 73 70 65 63 69 66 69 63 20 61 n the specific a
7ee0: 72 65 61 20 6f 66 20 75 73 65 20 61 6e 64 0d 0a rea of use and..
7ef0: 3c 62 3e 49 74 61 6c 79 20 2d 20 53 61 72 64 69 <b>Italy - Sardi
7f00: 6e 69 61 20 6f 6e 73 68 6f 72 65 3c 2f 62 3e 20 nia onshore</b>
7f10: 69 73 20 6f 6e 65 20 62 65 74 77 65 65 6e 20 74 is one between t
7f20: 68 65 6d 2e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e hem...<ul>..<li>
7f30: 74 68 65 20 66 69 72 73 74 20 71 75 65 72 79 20 the first query
7f40: 64 6f 65 73 20 6e 6f 74 20 64 65 66 69 6e 65 20 does not define
7f50: 61 6e 79 20 73 70 65 63 69 66 69 63 20 61 72 65 any specific are
7f60: 61 20 6f 66 20 75 73 65 2c 20 61 6e 64 20 63 6f a of use, and co
7f70: 6e 73 65 71 75 65 6e 74 6c 79 20 50 52 4f 4a 2e nsequently PROJ.
7f80: 36 20 63 61 6c 63 75 6c 61 74 65 64 20 74 68 65 6 calculated the
7f90: 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 transformation
7fa0: 62 79 20 61 70 70 6c 79 69 6e 67 20 74 68 65 20 by applying the
7fb0: 67 65 6e 65 72 69 63 20 70 61 72 61 6d 65 74 65 generic paramete
7fc0: 72 73 20 73 75 70 70 6f 72 74 69 6e 67 20 3c 62 rs supporting <b
7fd0: 3e 49 74 61 6c 79 20 2d 20 4d 61 69 6e 6c 61 6e >Italy - Mainlan
7fe0: 64 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 d</b>.</li>..<li
7ff0: 3e 74 68 65 20 73 65 63 6f 6e 64 20 71 75 65 72 >the second quer
8000: 79 20 69 6e 73 74 65 61 64 20 64 65 66 69 6e 65 y instead define
8010: 73 20 61 20 73 70 65 63 69 66 69 63 20 61 72 65 s a specific are
8020: 20 6f 66 20 75 73 65 2c 20 61 6e 64 20 74 68 69 of use, and thi
8030: 73 20 74 69 6d 65 20 50 52 4f 4a 2e 36 20 63 61 s time PROJ.6 ca
8040: 6c 63 75 6c 61 74 65 64 20 74 68 65 20 74 72 61 lculated the tra
8050: 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 62 79 20 61 nsformation by a
8060: 70 70 6c 79 69 6e 67 20 74 68 65 20 6d 6f 73 74 pplying the most
8070: 20 70 72 65 63 69 73 65 20 70 61 72 61 6d 65 74 precise paramet
8080: 65 72 73 20 73 75 70 70 6f 72 74 69 6e 67 20 3c ers supporting <
8090: 62 3e 49 74 61 6c 79 20 2d 20 53 61 72 64 69 6e b>Italy - Sardin
80a0: 69 61 20 6f 6e 73 68 6f 72 65 3c 2f 62 3e 2e 3c ia onshore</b>.<
80b0: 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 3c /li>..</ul><br><
80c0: 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c br>..<table cell
80d0: 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c spacing="8" cell
80e0: 70 61 64 64 69 6e 67 3d 22 31 36 22 20 62 67 63 padding="16" bgc
80f0: 6f 6c 6f 72 3d 22 23 66 66 66 66 64 30 22 3e 0d olor="#ffffd0">.
8100: 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 62 3e 3c 75 .<tr><td>..<b><u
8110: 3e 4c 65 73 73 6f 6e 20 6c 65 61 72 6e 65 64 3c >Lesson learned<
8120: 2f 75 3e 3c 2f 62 3e 3a 0d 0a 3c 75 6c 3e 0d 0a /u></b>:..<ul>..
8130: 3c 6c 69 3e 54 68 65 20 62 65 73 74 20 6d 6f 64 <li>The best mod
8140: 65 20 66 6f 72 20 74 61 6b 69 6e 67 20 66 75 6c e for taking ful
8150: 6c 20 70 72 6f 66 69 74 20 66 72 6f 6d 20 50 52 l profit from PR
8160: 4f 4a 2e 36 20 69 73 20 62 79 20 69 67 6e 6f 72 OJ.6 is by ignor
8170: 69 6e 67 20 61 6c 6c 20 43 52 53 20 64 65 66 69 ing all CRS defi
8180: 6e 69 74 69 6f 6e 73 20 63 6f 6e 74 61 69 6e 65 nitions containe
8190: 64 20 69 6e 74 6f 20 3c 62 3e 73 70 61 74 69 61 d into <b>spatia
81a0: 6c 5f 72 65 66 5f 73 79 73 3c 2f 62 3e 2c 20 74 l_ref_sys</b>, t
81b0: 68 75 73 20 6c 65 61 76 69 6e 67 20 50 52 4f 4a hus leaving PROJ
81c0: 20 66 72 65 65 20 74 6f 20 63 68 6f 6f 73 65 20 free to choose
81d0: 74 68 65 20 62 65 73 74 20 70 6f 73 73 69 62 6c the best possibl
81e0: 65 20 61 70 70 72 6f 61 63 68 2e 20 28 61 6e 64 e approach. (and
81f0: 20 74 68 69 73 20 69 73 20 74 68 65 20 3c 62 3e this is the <b>
8200: 3c 69 3e 64 65 66 61 75 6c 74 20 73 65 74 74 69 <i>default setti
8210: 6e 67 3c 2f 69 3e 3c 2f 62 3e 29 2e 3c 62 72 3e ng</i></b>).<br>
8220: 0d 0a 54 68 69 73 20 77 61 79 20 79 6f 75 27 6c ..This way you'l
8230: 6c 20 62 65 20 61 62 73 6f 6c 75 74 65 6c 79 20 l be absolutely
8240: 73 75 72 65 20 74 68 61 74 20 74 68 65 20 6d 6f sure that the mo
8250: 73 74 20 72 65 63 65 6e 74 20 61 6e 64 20 66 75 st recent and fu
8260: 6c 6c 79 20 64 65 74 61 69 6c 65 64 20 64 65 66 lly detailed def
8270: 69 6e 69 74 69 6f 6e 73 20 77 69 6c 6c 20 62 65 initions will be
8280: 20 61 6c 77 61 79 73 20 72 65 74 72 69 65 76 65 always retrieve
8290: 64 20 66 72 6f 6d 20 74 68 65 20 50 52 4f 4a 2e d from the PROJ.
82a0: 36 20 6f 77 6e 20 70 72 69 76 61 74 65 20 64 61 6 own private da
82b0: 74 61 62 61 73 65 2e 3c 62 72 3e 0d 0a 54 68 69 tabase.<br>..Thi
82c0: 73 20 77 69 6c 6c 20 62 65 20 65 6e 73 75 72 65 s will be ensure
82d0: 64 20 65 76 65 6e 20 77 68 65 6e 20 70 72 6f 63 d even when proc
82e0: 65 73 73 69 6e 67 20 73 6f 6d 65 20 3c 62 3e 3c essing some <b><
82f0: 69 3e 6c 65 67 61 63 79 20 44 42 3c 2f 69 3e 3c i>legacy DB</i><
8300: 2f 62 3e 20 62 65 69 6e 67 20 63 72 65 61 74 65 /b> being create
8310: 64 20 62 79 20 65 61 72 6c 69 65 72 20 76 65 72 d by earlier ver
8320: 73 69 6f 6e 73 20 61 6e 64 20 74 68 75 73 20 70 sions and thus p
8330: 6f 74 65 6e 74 69 61 6c 6c 79 20 63 6f 6e 74 61 otentially conta
8340: 69 6e 69 6e 67 20 61 6e 20 6f 75 74 64 61 74 65 ining an outdate
8350: 64 20 3c 62 3e 3c 69 3e 73 70 61 74 69 61 6c 5f d <b><i>spatial_
8360: 72 65 66 5f 73 79 73 3c 2f 69 3e 3c 2f 62 3e 20 ref_sys</i></b>
8370: 74 61 62 6c 65 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 table.</li>..<li
8380: 3e 53 70 61 74 69 61 4c 69 74 65 20 66 75 6c 6c >SpatiaLite full
8390: 79 20 72 65 73 70 65 63 74 73 20 75 73 65 72 73 y respects users
83a0: 20 66 72 65 65 64 6f 6d 20 61 76 6f 69 64 69 6e freedom avoidin
83b0: 67 20 61 6e 79 20 69 6d 70 6f 73 65 64 20 63 6f g any imposed co
83c0: 6e 73 74 72 61 69 6e 74 2e 3c 62 72 3e 0d 0a 49 nstraint.<br>..I
83d0: 66 20 79 6f 75 20 74 68 69 6e 6b 20 74 68 61 74 f you think that
83e0: 20 75 73 69 6e 67 20 6f 74 68 65 72 20 64 69 66 using other dif
83f0: 66 65 72 65 6e 74 20 43 52 53 20 64 65 66 69 6e ferent CRS defin
8400: 69 74 69 6f 6e 73 20 69 73 20 61 20 67 6f 6f 64 itions is a good
8410: 20 69 64 65 61 2c 20 79 6f 75 20 61 72 65 20 66 idea, you are f
8420: 72 65 65 20 74 6f 20 75 73 65 20 74 72 61 64 69 ree to use tradi
8430: 74 69 6f 6e 61 6c 20 70 72 6f 6a 2d 73 74 72 69 tional proj-stri
8440: 6e 67 73 2c 20 57 4b 54 20 64 65 66 69 6e 69 74 ngs, WKT definit
8450: 69 6f 6e 73 2c 20 43 52 53 20 6e 61 6d 65 73 20 ions, CRS names
8460: 61 6e 64 20 77 68 61 74 65 76 65 72 20 65 6c 73 and whatever els
8470: 65 20 74 68 61 74 20 6d 61 79 20 62 65 20 64 65 e that may be de
8480: 65 6d 65 64 20 61 70 70 72 6f 70 72 69 61 74 65 emed appropriate
8490: 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 53 70 61 74 .</li>..<li>Spat
84a0: 69 61 4c 69 74 65 20 65 6e 63 6f 75 72 61 67 65 iaLite encourage
84b0: 73 20 61 6e 64 20 70 72 6f 6d 6f 74 65 73 20 74 s and promotes t
84c0: 68 65 20 6d 6f 73 74 20 63 72 65 61 74 69 76 65 he most creative
84d0: 20 75 73 65 73 20 6f 66 20 50 52 4f 4a 2e 36 3a uses of PROJ.6:
84e0: 20 75 73 69 6e 67 20 79 6f 75 72 20 6f 77 6e 20 using your own
84f0: 63 75 73 74 6f 6d 20 3c 62 3e 3c 69 3e 74 72 61 custom <b><i>tra
8500: 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 nsformation pipe
8510: 6c 69 6e 65 73 3c 2f 69 3e 3c 2f 62 3e 20 69 73 lines</i></b> is
8520: 6e 27 74 20 6e 65 63 65 73 73 61 72 69 6c 79 20 n't necessarily
8530: 73 69 6d 70 6c 65 20 61 6e 64 20 65 61 73 79 2c simple and easy,
8540: 20 62 75 74 20 69 73 20 61 20 62 69 67 20 6f 70 but is a big op
8550: 70 6f 72 74 75 6e 69 74 79 20 66 6f 72 20 61 6c portunity for al
8560: 6c 20 73 6b 69 6c 6c 65 64 20 61 6e 64 20 74 61 l skilled and ta
8570: 6c 65 6e 74 65 64 20 70 6f 77 65 72 20 75 73 65 lented power use
8580: 72 73 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d rs.</li>..</ul>.
8590: 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 .</td></tr>..</t
85a0: 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 68 33 3e 4e able><br>..<h3>N
85b0: 65 77 20 61 75 78 69 6c 69 61 72 79 20 53 51 4c ew auxiliary SQL
85c0: 20 66 75 6e 63 74 69 6f 6e 73 20 73 70 65 63 69 functions speci
85d0: 66 69 63 61 6c 6c 79 20 73 75 70 70 6f 72 74 69 fically supporti
85e0: 6e 67 20 50 52 4f 4a 2e 36 3c 2f 68 33 3e 0d 0a ng PROJ.6</h3>..
85f0: 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 <table cellspaci
8600: 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 69 ng="8" cellpaddi
8610: 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 3d 22 ng="8" bgcolor="
8620: 23 65 38 66 66 65 38 22 20 62 6f 72 64 65 72 3d #e8ffe8" border=
8630: 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 67 "1">..<tr><th bg
8640: 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 3e color="#ffb03e">
8650: 53 51 4c 20 46 75 6e 63 74 69 6f 6e 3c 2f 74 68 SQL Function</th
8660: 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 ><th bgcolor="#f
8670: 66 62 30 33 65 22 3e 53 75 70 70 6f 72 74 65 64 fb03e">Supported
8680: 20 61 72 67 75 6d 65 6e 74 73 3c 2f 74 68 3e 3c arguments</th><
8690: 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 th bgcolor="#ffb
86a0: 30 33 65 22 3e 44 65 73 63 72 69 70 74 69 6f 6e 03e">Description
86b0: 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e </th></tr>..<tr>
86c0: 3c 74 64 3e 3c 62 3e 48 61 73 50 72 6f 6a 36 3c <td><b>HasProj6<
86d0: 2f 62 3e 28 20 3c 69 3e 76 6f 69 64 3c 2f 69 3e /b>( <i>void</i>
86e0: 20 29 20 3a 20 3c 69 3e 42 6f 6f 6c 65 61 6e 3c ) : <i>Boolean<
86f0: 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4e 6f /i></td>..<td>No
8700: 6e 65 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c ne</td>..<td>Wil
8710: 6c 20 72 65 74 75 72 6e 20 3c 62 3e 31 3c 2f 62 l return <b>1</b
8720: 3e 20 28 3c 62 3e 54 52 55 45 3c 2f 62 3e 29 20 > (<b>TRUE</b>)
8730: 69 66 20 74 68 65 20 6c 69 62 72 61 72 79 20 68 if the library h
8740: 61 73 20 62 65 65 6e 20 62 75 69 6c 74 20 6f 6e as been built on
8750: 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 20 28 <b>PROJ.6</b> (
8760: 6f 72 20 61 6e 79 20 6c 61 74 65 72 20 76 65 72 or any later ver
8770: 73 69 6f 6e 29 2c 20 6f 74 68 65 72 77 69 73 65 sion), otherwise
8780: 20 3c 62 3e 30 3c 2f 62 3e 20 28 3c 62 3e 46 41 <b>0</b> (<b>FA
8790: 4c 53 45 3c 2f 62 3e 29 2e 3c 2f 74 64 3e 3c 2f LSE</b>).</td></
87a0: 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e tr>..<tr><td><b>
87b0: 50 52 4f 4a 5f 47 65 74 4c 61 73 74 45 72 72 6f PROJ_GetLastErro
87c0: 72 4d 73 67 3c 2f 62 3e 28 20 3c 69 3e 76 6f 69 rMsg</b>( <i>voi
87d0: 64 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 53 74 72 d</i> ) : <i>Str
87e0: 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 ing</i></td>..<t
87f0: 64 3e 4e 6f 6e 65 3c 2f 74 64 3e 0d 0a 3c 74 64 d>None</td>..<td
8800: 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 65 >Will return the
8810: 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 65 72 72 most recent err
8820: 6f 72 20 6d 65 73 73 61 67 65 20 72 65 74 75 72 or message retur
8830: 6e 65 64 20 62 79 20 50 52 4f 4a 20 28 69 66 20 ned by PROJ (if
8840: 61 6e 79 29 2e 3c 62 72 3e 0d 0a 3c 62 3e 4e 55 any).<br>..<b>NU
8850: 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72 LL</b> will be r
8860: 65 74 75 72 6e 65 64 20 69 66 20 74 68 65 72 65 eturned if there
8870: 20 69 73 20 6e 6f 20 63 75 72 72 65 6e 74 6c 79 is no currently
8880: 20 70 65 6e 64 69 6e 67 20 50 52 4f 4a 20 65 72 pending PROJ er
8890: 72 6f 72 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a ror.</td></tr>..
88a0: 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f <tr><td><b>PROJ_
88b0: 47 65 74 44 61 74 61 62 61 73 65 50 61 74 68 3c GetDatabasePath<
88c0: 2f 62 3e 28 20 3c 69 3e 76 6f 69 64 3c 2f 69 3e /b>( <i>void</i>
88d0: 20 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e : <i>String</i>
88e0: 29 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4e 6f 6e 65 )</td>..<td>None
88f0: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 </td>..<td>Will
8900: 72 65 74 75 72 6e 20 74 68 65 20 63 75 72 72 65 return the curre
8910: 6e 74 6c 79 20 73 65 74 20 70 61 74 68 6e 61 6d ntly set pathnam
8920: 65 20 6c 65 61 64 69 6e 67 20 74 6f 20 74 68 65 e leading to the
8930: 20 70 72 69 76 61 74 65 20 50 52 4f 4a 27 73 20 private PROJ's
8940: 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 2e SQLite database.
8950: 3c 62 72 3e 0d 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 <br>..<b>NULL</b
8960: 3e 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e > will be return
8970: 65 64 20 69 66 20 74 68 65 72 65 20 69 73 20 6e ed if there is n
8980: 6f 20 70 72 69 76 61 74 65 20 50 52 4f 4a 27 73 o private PROJ's
8990: 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 SQLite database
89a0: 20 63 75 72 72 65 6e 74 6c 79 20 63 6f 6e 6e 65 currently conne
89b0: 63 74 65 64 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d cted.</td></tr>.
89c0: 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a .<tr><td><b>PROJ
89d0: 5f 53 65 74 44 61 74 61 62 61 73 65 50 61 74 68 _SetDatabasePath
89e0: 3c 2f 62 3e 20 28 20 6e 65 77 5f 70 61 74 68 20 </b> ( new_path
89f0: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 <i>String</i> )
8a00: 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c : <i>String</i><
8a10: 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a 3c 75 6c 3e /td>..<td>..<ul>
8a20: 0d 0a 3c 6c 69 3e 3c 62 3e 6e 65 77 5f 70 61 74 ..<li><b>new_pat
8a30: 68 3c 2f 62 3e 3a 20 61 20 72 65 6c 61 74 69 76 h</b>: a relativ
8a40: 65 20 6f 72 20 61 62 73 6f 6c 75 74 65 20 70 61 e or absolute pa
8a50: 74 68 6e 61 6d 65 20 6c 65 61 64 69 6e 67 20 74 thname leading t
8a60: 6f 20 61 20 76 61 6c 69 64 20 50 52 4f 4a 27 73 o a valid PROJ's
8a70: 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 SQLite database
8a80: 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 74 .</li>..</ul></t
8a90: 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 63 68 61 d>..<td>Will cha
8aa0: 6e 67 65 20 74 68 65 20 63 75 72 72 65 6e 74 6c nge the currentl
8ab0: 79 20 73 65 74 20 70 61 74 68 6e 61 6d 65 20 6c y set pathname l
8ac0: 65 61 64 69 6e 67 20 74 6f 20 74 68 65 20 70 72 eading to the pr
8ad0: 69 76 61 74 65 20 50 52 4f 4a 27 73 20 53 51 4c ivate PROJ's SQL
8ae0: 69 74 65 20 64 61 74 61 62 61 73 65 2e 3c 62 72 ite database.<br
8af0: 3e 0d 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 >..<b>NULL</b> w
8b00: 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 ill be returned
8b10: 69 66 20 74 68 65 20 70 61 73 73 65 64 20 70 61 if the passed pa
8b20: 74 68 20 69 73 20 69 6e 76 61 6c 69 64 2c 20 6f th is invalid, o
8b30: 74 68 65 72 77 69 73 65 20 74 68 65 20 70 61 74 therwise the pat
8b40: 68 20 6f 66 20 74 68 65 20 63 75 72 72 65 6e 74 h of the current
8b50: 6c 79 20 73 65 74 20 70 72 69 76 61 74 65 20 50 ly set private P
8b60: 52 4f 4a 27 73 20 53 51 4c 69 74 65 20 64 61 74 ROJ's SQLite dat
8b70: 61 62 61 73 65 20 77 69 6c 6c 20 62 65 20 72 65 abase will be re
8b80: 74 75 72 6e 65 64 2e 3c 2f 74 64 3e 3c 2f 74 72 turned.</td></tr
8b90: 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 >..<tr><td><b>PR
8ba0: 4f 4a 5f 41 73 50 72 6f 6a 53 74 72 69 6e 67 3c OJ_AsProjString<
8bb0: 2f 62 3e 20 28 20 61 75 74 68 5f 6e 61 6d 65 20 /b> ( auth_name
8bc0: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 <i>String</i> ,
8bd0: 61 75 74 68 5f 73 72 69 64 20 3c 69 3e 49 6e 74 auth_srid <i>Int
8be0: 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e eger</i> ) : <i>
8bf0: 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d String</i></td>.
8c00: 0a 3c 74 64 3e 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c .<td><ul>..<li><
8c10: 62 3e 61 75 74 68 5f 6e 61 6d 65 3c 2f 62 3e 20 b>auth_name</b>
8c20: 61 6e 64 20 3c 62 3e 61 75 74 68 5f 73 72 69 64 and <b>auth_srid
8c30: 3c 2f 62 3e 20 69 64 65 6e 74 69 66 79 20 74 68 </b> identify th
8c40: 65 20 69 6e 74 65 6e 64 65 64 20 43 52 53 2e 3c e intended CRS.<
8c50: 62 72 3e 0d 0a 3c 62 3e 61 75 74 68 5f 6e 61 6d br>..<b>auth_nam
8c60: 65 3c 2f 62 3e 20 63 61 6e 20 62 65 20 3c 62 3e e</b> can be <b>
8c70: 4e 55 4c 4c 3c 2f 62 3e 2c 20 61 6e 64 20 69 6e NULL</b>, and in
8c80: 20 74 68 69 73 20 63 61 73 65 20 3c 62 3e 45 50 this case <b>EP
8c90: 53 47 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 61 SG</b> will be a
8ca0: 73 73 75 6d 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 2f ssumed.</li>..</
8cb0: 75 6c 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 ul></td>..<td>Wi
8cc0: 6c 6c 20 72 65 74 75 72 6e 20 74 68 65 20 57 4b ll return the WK
8cd0: 54 20 65 78 70 72 65 73 73 69 6f 6e 20 63 6f 72 T expression cor
8ce0: 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 61 20 responding to a
8cf0: 67 69 76 65 6e 20 43 52 53 3b 20 74 68 65 20 64 given CRS; the d
8d00: 65 66 69 6e 69 74 69 6f 6e 73 20 77 69 6c 6c 20 efinitions will
8d10: 62 65 20 74 61 6b 65 6e 20 64 69 72 65 63 74 6c be taken directl
8d20: 79 20 66 72 6f 6d 20 74 68 65 20 70 72 69 76 61 y from the priva
8d30: 74 65 20 50 52 4f 4a 27 73 20 6f 77 6e 20 64 61 te PROJ's own da
8d40: 74 61 62 61 73 65 2e 3c 62 72 3e 0d 0a 3c 62 3e tabase.<br>..<b>
8d50: 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 NULL</b> will be
8d60: 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 66 61 69 returned on fai
8d70: 6c 75 72 65 20 6f 72 20 6f 6e 20 69 6e 76 61 6c lure or on inval
8d80: 69 64 20 61 72 67 75 6d 65 6e 74 73 2e 3c 2f 74 id arguments.</t
8d90: 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 d></tr>..<tr><td
8da0: 3e 3c 62 3e 50 52 4f 4a 5f 41 73 57 4b 54 3c 2f ><b>PROJ_AsWKT</
8db0: 62 3e 20 28 20 61 75 74 68 5f 6e 61 6d 65 20 3c b> ( auth_name <
8dc0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 61 i>String</i> , a
8dd0: 75 74 68 5f 73 72 69 64 20 3c 69 3e 49 6e 74 65 uth_srid <i>Inte
8de0: 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 53 ger</i> ) : <i>S
8df0: 74 72 69 6e 67 3c 2f 69 3e 3c 68 72 3e 0d 0a 3c tring</i><hr>..<
8e00: 62 3e 50 52 4f 4a 5f 41 73 57 4b 54 3c 2f 62 3e b>PROJ_AsWKT</b>
8e10: 20 28 20 61 75 74 68 5f 6e 61 6d 65 20 3c 69 3e ( auth_name <i>
8e20: 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 61 75 74 String</i> , aut
8e30: 68 5f 73 72 69 64 20 3c 69 3e 49 6e 74 65 67 65 h_srid <i>Intege
8e40: 72 3c 2f 69 3e 20 2c 20 77 6b 74 5f 73 74 79 6c r</i> , wkt_styl
8e50: 65 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 e <i>String</i>
8e60: 29 20 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 ) : <i>String</i
8e70: 3e 3c 68 72 3e 0d 0a 3c 62 3e 50 52 4f 4a 5f 41 ><hr>..<b>PROJ_A
8e80: 73 57 4b 54 3c 2f 62 3e 20 28 20 61 75 74 68 5f sWKT</b> ( auth_
8e90: 6e 61 6d 65 20 3c 69 3e 53 74 72 69 6e 67 3c 2f name <i>String</
8ea0: 69 3e 20 2c 20 61 75 74 68 5f 73 72 69 64 20 3c i> , auth_srid <
8eb0: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 i>Integer</i> ,
8ec0: 77 6b 74 5f 73 74 79 6c 65 20 3c 69 3e 53 74 72 wkt_style <i>Str
8ed0: 69 6e 67 3c 2f 69 3e 20 2c 20 69 6e 64 65 6e 74 ing</i> , indent
8ee0: 65 64 20 3c 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 ed <i>Boolean</i
8ef0: 3e 20 29 20 3a 20 3c 69 3e 53 74 72 69 6e 67 3c > ) : <i>String<
8f00: 2f 69 3e 3c 68 72 3e 0d 0a 3c 62 3e 50 52 4f 4a /i><hr>..<b>PROJ
8f10: 5f 41 73 57 4b 54 3c 2f 62 3e 20 28 20 61 75 74 _AsWKT</b> ( aut
8f20: 68 5f 6e 61 6d 65 20 3c 69 3e 53 74 72 69 6e 67 h_name <i>String
8f30: 3c 2f 69 3e 20 2c 20 61 75 74 68 5f 73 72 69 64 </i> , auth_srid
8f40: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 <i>Integer</i>
8f50: 2c 20 77 6b 74 5f 73 74 79 6c 65 20 3c 69 3e 53 , wkt_style <i>S
8f60: 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 69 6e 64 65 tring</i> , inde
8f70: 6e 74 65 64 20 3c 69 3e 42 6f 6f 6c 65 61 6e 3c nted <i>Boolean<
8f80: 2f 69 3e 20 2c 20 69 6e 64 65 6e 74 61 74 69 6f /i> , indentatio
8f90: 6e 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e n <i>Integer</i>
8fa0: 20 29 20 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f ) : <i>String</
8fb0: 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 3c 75 6c i></td>..<td><ul
8fc0: 3e 0d 0a 3c 6c 69 3e 3c 62 3e 61 75 74 68 5f 6e >..<li><b>auth_n
8fd0: 61 6d 65 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 61 ame</b> and <b>a
8fe0: 75 74 68 5f 73 72 69 64 3c 2f 62 3e 20 69 64 65 uth_srid</b> ide
8ff0: 6e 74 69 66 79 20 74 68 65 20 69 6e 74 65 6e 64 ntify the intend
9000: 65 64 20 43 52 53 2e 3c 62 72 3e 0d 0a 3c 62 3e ed CRS.<br>..<b>
9010: 61 75 74 68 5f 6e 61 6d 65 3c 2f 62 3e 20 63 61 auth_name</b> ca
9020: 6e 20 62 65 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e n be <b>NULL</b>
9030: 2c 20 61 6e 64 20 69 6e 20 74 68 69 73 20 63 61 , and in this ca
9040: 73 65 20 3c 62 3e 45 50 53 47 3c 2f 62 3e 20 77 se <b>EPSG</b> w
9050: 69 6c 6c 20 62 65 20 61 73 73 75 6d 65 64 2e 3c ill be assumed.<
9060: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 /li>..<li>the op
9070: 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 tional argument
9080: 3c 62 3e 73 74 79 6c 65 3c 2f 62 3e 20 64 65 74 <b>style</b> det
9090: 65 72 6d 69 6e 65 73 20 77 68 69 63 68 20 73 70 ermines which sp
90a0: 65 63 69 66 69 63 20 57 4b 54 20 66 6f 72 6d 61 ecific WKT forma
90b0: 74 20 73 68 6f 75 6c 64 20 62 65 20 61 64 6f 70 t should be adop
90c0: 74 65 64 2c 20 61 6e 64 20 6d 75 73 74 20 62 65 ted, and must be
90d0: 20 6f 6e 65 20 62 65 74 77 65 65 6e 20 3c 62 3e one between <b>
90e0: 47 44 41 4c 3c 2f 62 3e 2c 20 3c 62 3e 45 53 52 GDAL</b>, <b>ESR
90f0: 49 3c 2f 62 3e 2c 20 3c 62 3e 49 53 4f 2d 32 30 I</b>, <b>ISO-20
9100: 31 35 3c 2f 62 3e 20 6f 72 20 3c 62 3e 49 53 4f 15</b> or <b>ISO
9110: 2d 32 30 31 38 3c 2f 62 3e 20 28 74 68 69 73 20 -2018</b> (this
9120: 6c 61 74 74 65 72 20 62 65 69 6e 67 20 74 68 65 latter being the
9130: 20 64 65 66 61 75 6c 74 20 73 65 74 74 69 6e 67 default setting
9140: 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 ).</li>..<li>the
9150: 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 optional argume
9160: 6e 74 20 3c 62 3e 69 6e 64 65 6e 74 65 64 3c 2f nt <b>indented</
9170: 62 3e 20 69 66 20 73 65 74 20 74 6f 20 3c 62 3e b> if set to <b>
9180: 54 52 55 45 3c 2f 62 3e 20 77 69 6c 6c 20 6e 69 TRUE</b> will ni
9190: 63 65 6c 79 20 66 6f 72 6d 61 74 20 61 20 6d 75 cely format a mu
91a0: 6c 74 69 6c 69 6e 65 20 57 4b 54 20 65 78 70 72 ltiline WKT expr
91b0: 65 73 73 69 6f 6e 2c 20 6f 74 68 65 72 77 69 73 ession, otherwis
91c0: 65 20 61 20 73 69 6e 67 6c 65 20 6d 6f 6e 6f 6c e a single monol
91d0: 69 74 68 69 63 20 6c 69 6e 65 20 6c 61 63 6b 69 ithic line lacki
91e0: 6e 67 20 61 6e 79 20 77 68 69 74 65 2d 73 70 61 ng any white-spa
91f0: 63 65 20 6f 72 20 6e 65 77 2d 6c 69 6e 65 20 77 ce or new-line w
9200: 69 6c 6c 20 62 65 20 70 72 69 6e 74 65 64 20 28 ill be printed (
9210: 74 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 3c the default is <
9220: 62 3e 54 52 55 45 3c 2f 62 3e 29 2e 3c 2f 6c 69 b>TRUE</b>).</li
9230: 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f >..<li>the optio
9240: 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e nal argument <b>
9250: 69 6e 64 65 6e 74 61 74 69 6f 6e 3c 2f 62 3e 20 indentation</b>
9260: 64 65 74 65 72 6d 69 6e 65 73 20 68 6f 77 20 6d determines how m
9270: 61 6e 79 20 77 68 69 74 65 2d 73 70 61 63 65 73 any white-spaces
9280: 20 61 72 65 20 74 6f 20 62 65 20 75 73 65 64 20 are to be used
9290: 66 6f 72 20 69 6e 64 65 6e 74 69 6e 67 20 28 6f for indenting (o
92a0: 6e 6c 79 20 6d 65 61 6e 69 6e 67 66 75 6c 20 69 nly meaningful i
92b0: 66 20 3c 62 3e 3c 69 3e 69 6e 64 65 6e 74 65 64 f <b><i>indented
92c0: 3d 54 52 55 45 3c 2f 69 3e 3c 2f 62 3e 3b 20 74 =TRUE</i></b>; t
92d0: 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 he default value
92e0: 73 20 69 73 20 3c 62 3e 34 3c 2f 62 3e 29 2e 3c s is <b>4</b>).<
92f0: 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 74 64 3e /li>..</ul></td>
9300: 0d 0a 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75 72 ..<td>Will retur
9310: 6e 20 74 68 65 20 57 4b 54 20 65 78 70 72 65 73 n the WKT expres
9320: 73 69 6f 6e 20 63 6f 72 72 65 73 70 6f 6e 64 69 sion correspondi
9330: 6e 67 20 74 6f 20 61 20 67 69 76 65 6e 20 43 52 ng to a given CR
9340: 53 3b 20 74 68 65 20 64 65 66 69 6e 69 74 69 6f S; the definitio
9350: 6e 73 20 77 69 6c 6c 20 62 65 20 74 61 6b 65 6e ns will be taken
9360: 20 64 69 72 65 63 74 6c 79 20 66 72 6f 6d 20 74 directly from t
9370: 68 65 20 70 72 69 76 61 74 65 20 50 52 4f 4a 27 he private PROJ'
9380: 73 20 6f 77 6e 20 64 61 74 61 62 61 73 65 2e 3c s own database.<
9390: 62 72 3e 0d 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e br>..<b>NULL</b>
93a0: 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 will be returne
93b0: 64 20 6f 6e 20 66 61 69 6c 75 72 65 20 6f 72 20 d on failure or
93c0: 6f 6e 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d on invalid argum
93d0: 65 6e 74 73 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d ents.</td></tr>.
93e0: 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a .<tr><td><b>PROJ
93f0: 5f 47 75 65 73 73 53 72 69 64 46 72 6f 6d 57 4b _GuessSridFromWK
9400: 54 3c 2f 62 3e 20 28 20 77 6b 74 5f 65 78 70 72 T</b> ( wkt_expr
9410: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29 <i>String</i> )
9420: 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 : <i>Integer</i
9430: 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 3c 75 6c 3e ></td>..<td><ul>
9440: 0d 0a 3c 6c 69 3e 3c 62 3e 77 6b 74 5f 65 78 70 ..<li><b>wkt_exp
9450: 72 3c 2f 62 3e 3a 20 74 68 65 20 57 4b 54 20 65 r</b>: the WKT e
9460: 78 70 72 65 73 73 69 6f 6e 20 74 6f 20 62 65 20 xpression to be
9470: 65 76 61 6c 75 61 74 65 64 2e 3c 2f 6c 69 3e 0d evaluated.</li>.
9480: 0a 3c 2f 75 6c 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 .</ul></td>..<td
9490: 3e 0d 0a 57 69 6c 6c 20 70 6f 73 73 69 62 6c 79 >..Will possibly
94a0: 20 72 65 74 75 72 6e 20 74 68 65 20 3c 62 3e 53 return the <b>S
94b0: 52 49 44 20 76 61 6c 75 65 3c 2f 62 3e 20 63 6f RID value</b> co
94c0: 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 61 rresponding to a
94d0: 20 67 69 76 65 6e 20 57 4b 54 20 65 78 70 72 65 given WKT expre
94e0: 73 73 69 6f 6e 20 64 65 66 69 6e 69 6e 67 20 61 ssion defining a
94f0: 20 43 52 53 2e 3c 62 72 3e 0d 0a 3c 62 3e 2d 31 CRS.<br>..<b>-1
9500: 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72 65 74 </b> will be ret
9510: 75 72 6e 65 64 20 69 66 20 6e 6f 20 43 52 53 20 urned if no CRS
9520: 73 75 70 70 6f 72 74 65 64 20 62 79 20 50 52 4f supported by PRO
9530: 4a 2e 36 20 6d 61 74 63 68 65 73 20 74 68 65 20 J.6 matches the
9540: 57 4b 54 20 65 78 70 72 65 73 73 69 6f 6e 2e 3c WKT expression.<
9550: 62 72 3e 0d 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e br>..<b>NULL</b>
9560: 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 will be returne
9570: 64 20 6f 6e 20 69 6e 76 61 6c 69 64 20 61 72 67 d on invalid arg
9580: 75 6d 65 6e 74 2e 0d 0a 3c 2f 74 64 3e 3c 2f 74 ument...</td></t
9590: 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 r>..<tr><td><b>P
95a0: 52 4f 4a 5f 47 75 65 73 73 53 72 69 64 46 72 6f ROJ_GuessSridFro
95b0: 6d 53 48 50 3c 2f 62 3e 20 28 20 66 69 6c 65 6e mSHP</b> ( filen
95c0: 61 6d 65 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 ame <i>String</i
95d0: 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 > ) : <i>Integer
95e0: 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 3c </i></td>..<td><
95f0: 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 66 69 6c 65 ul>..<li><b>file
9600: 6e 61 6d 65 3c 2f 62 3e 3a 20 74 68 65 20 61 62 name</b>: the ab
9610: 73 6f 6c 75 74 65 20 6f 72 20 72 65 6c 61 74 69 solute or relati
9620: 76 65 20 70 61 74 68 20 6c 65 61 64 69 6e 67 20 ve path leading
9630: 74 6f 20 73 6f 6d 65 20 53 68 61 70 65 66 69 6c to some Shapefil
9640: 65 2e 3c 62 72 3e 0d 0a 4e 6f 74 65 3a 20 65 78 e.<br>..Note: ex
9650: 61 63 74 6c 79 20 61 73 20 72 65 71 75 69 72 65 actly as require
9660: 64 20 62 79 20 3c 62 3e 3c 69 3e 49 6d 70 6f 72 d by <b><i>Impor
9670: 74 53 48 50 3c 2f 69 3e 3c 2f 62 3e 28 29 20 3c tSHP</i></b>() <
9680: 62 3e 3c 69 3e 66 69 6c 65 6e 61 6d 65 3c 2f 69 b><i>filename</i
9690: 3e 3c 2f 62 3e 20 6d 75 73 74 20 6f 6d 69 74 20 ></b> must omit
96a0: 61 6e 79 20 3c 62 3e 2e 73 68 70 3c 2f 62 3e 2c any <b>.shp</b>,
96b0: 20 3c 62 3e 2e 73 68 78 3c 2f 62 3e 2c 20 3c 62 <b>.shx</b>, <b
96c0: 3e 2e 64 62 66 3c 2f 62 3e 20 6f 72 20 3c 62 3e >.dbf</b> or <b>
96d0: 2e 70 72 6a 3c 2f 62 3e 20 73 75 66 66 69 78 2e .prj</b> suffix.
96e0: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 74 64 </li>..</ul></td
96f0: 3e 0d 0a 3c 74 64 3e 0d 0a 57 69 6c 6c 20 70 6f >..<td>..Will po
9700: 73 73 69 62 6c 79 20 72 65 74 75 72 6e 20 74 68 ssibly return th
9710: 65 20 3c 62 3e 53 52 49 44 20 76 61 6c 75 65 3c e <b>SRID value<
9720: 2f 62 3e 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e /b> correspondin
9730: 67 20 74 6f 20 74 68 65 20 43 52 53 20 64 65 66 g to the CRS def
9740: 69 6e 65 64 20 62 79 20 74 68 65 20 2e 50 52 4a ined by the .PRJ
9750: 20 6d 65 6d 62 65 72 20 6f 66 20 74 68 65 20 53 member of the S
9760: 68 61 70 65 66 69 6c 65 2e 3c 62 72 3e 0d 0a 3c hapefile.<br>..<
9770: 62 3e 2d 31 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 b>-1</b> will be
9780: 20 72 65 74 75 72 6e 65 64 20 69 66 20 6e 6f 20 returned if no
9790: 43 52 53 20 73 75 70 70 6f 72 74 65 64 20 62 79 CRS supported by
97a0: 20 50 52 4f 4a 2e 36 20 6d 61 74 63 68 65 73 20 PROJ.6 matches
97b0: 50 52 4a 20 6d 65 6d 62 65 72 20 6f 66 20 74 68 PRJ member of th
97c0: 65 20 53 68 61 70 65 66 69 6c 65 2e 3c 62 72 3e e Shapefile.<br>
97d0: 0d 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 ..<b>NULL</b> wi
97e0: 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 6f ll be returned o
97f0: 6e 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 n invalid argume
9800: 6e 74 2e 3c 68 72 3e 0d 0a 3c 75 3e 50 6c 65 61 nt.<hr>..<u>Plea
9810: 73 65 20 6e 6f 74 65 20 77 65 6c 6c 3c 2f 75 3e se note well</u>
9820: 3a 20 74 68 69 73 20 53 51 4c 20 66 75 6e 63 74 : this SQL funct
9830: 69 6f 6e 20 6f 70 65 6e 73 20 74 68 65 20 64 6f ion opens the do
9840: 6f 72 20 74 6f 20 6d 61 6e 79 20 70 6f 74 65 6e or to many poten
9850: 74 69 61 6c 20 73 65 63 75 72 69 74 79 20 69 73 tial security is
9860: 73 75 65 73 2c 20 61 6e 64 20 74 68 75 73 20 69 sues, and thus i
9870: 73 20 61 6c 77 61 79 73 20 3c 69 3e 64 69 73 61 s always <i>disa
9880: 62 6c 65 64 20 62 79 20 64 65 66 61 75 6c 74 3c bled by default<
9890: 2f 69 3e 2e 3c 62 72 3e 0d 0a 45 78 70 6c 69 63 /i>.<br>..Explic
98a0: 69 74 6c 79 20 73 65 74 74 69 6e 67 20 74 68 65 itly setting the
98b0: 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 environment var
98c0: 69 61 62 6c 65 20 3c 62 3e 53 50 41 54 49 41 4c iable <b>SPATIAL
98d0: 49 54 45 5f 53 45 43 55 52 49 54 59 3d 72 65 6c ITE_SECURITY=rel
98e0: 61 78 65 64 3c 2f 62 3e 20 69 73 20 61 62 73 6f axed</b> is abso
98f0: 6c 75 74 65 6c 79 20 72 65 71 75 69 72 65 64 20 lutely required
9900: 69 6e 20 6f 72 64 65 72 20 74 6f 20 65 6e 61 62 in order to enab
9910: 6c 65 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e le this function
9920: 2e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c ...</td></tr>..<
9930: 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 74 61 /table><br>..<ta
9940: 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d ble cellspacing=
9950: 22 38 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d "8" cellpadding=
9960: 22 31 36 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 "16" bgcolor="#f
9970: 66 66 66 65 39 22 3e 0d 0a 3c 74 72 3e 3c 74 64 fffe9">..<tr><td
9980: 3e 0d 0a 3c 62 3e 3c 75 3e 4e 6f 74 65 3c 2f 75 >..<b><u>Note</u
9990: 3e 3c 2f 62 3e 3a 20 61 6c 6c 20 74 68 65 20 61 ></b>: all the a
99a0: 62 6f 76 65 20 53 51 4c 20 46 75 6e 63 74 69 6f bove SQL Functio
99b0: 6e 73 20 77 69 6c 6c 20 62 65 20 61 76 61 69 6c ns will be avail
99c0: 61 62 6c 65 20 6f 6e 6c 79 20 77 68 65 6e 20 53 able only when S
99d0: 70 61 74 69 61 6c 69 74 65 2d 35 2e 30 2e 30 20 patialite-5.0.0
99e0: 68 61 73 20 62 65 65 6e 20 62 75 69 6c 74 20 61 has been built a
99f0: 67 61 69 6e 73 74 20 3c 62 3e 50 52 4f 4a 2e 36 gainst <b>PROJ.6
9a00: 3c 2f 62 3e 20 28 6f 72 20 61 6e 79 20 73 75 62 </b> (or any sub
9a10: 73 65 71 75 65 6e 74 20 76 65 72 73 69 6f 6e 29 sequent version)
9a20: 2e 3c 62 72 3e 0d 0a 49 66 20 53 70 61 74 69 61 .<br>..If Spatia
9a30: 4c 69 74 65 2d 35 2e 30 2e 30 20 68 61 73 20 62 Lite-5.0.0 has b
9a40: 65 65 6e 20 62 75 69 6c 74 20 69 6e 73 74 65 61 een built instea
9a50: 64 20 61 67 61 69 6e 73 74 20 61 6e 79 20 70 72 d against any pr
9a60: 65 76 69 6f 75 73 20 76 65 72 73 69 6f 6e 20 28 evious version (
9a70: 61 73 20 65 2e 67 2e 20 3c 62 3e 50 52 4f 4a 2e as e.g. <b>PROJ.
9a80: 34 3c 2f 62 3e 29 20 61 6e 79 20 61 74 74 65 6d 4</b>) any attem
9a90: 70 74 20 74 6f 20 63 61 6c 6c 20 6f 6e 65 20 6f pt to call one o
9aa0: 66 20 74 68 65 73 65 20 53 51 4c 20 46 75 6e 63 f these SQL Func
9ab0: 74 69 6f 6e 73 20 77 69 6c 6c 20 73 69 6d 70 6c tions will simpl
9ac0: 79 20 72 65 74 75 72 6e 20 61 20 3c 62 3e 3c 69 y return a <b><i
9ad0: 3e 3c 75 3e 6e 6f 20 73 75 63 68 20 66 75 6e 63 ><u>no such func
9ae0: 74 69 6f 6e 3c 2f 75 3e 3c 2f 69 3e 3c 2f 62 3e tion</u></i></b>
9af0: 20 53 51 4c 20 65 72 72 6f 72 2e 0d 0a 3c 2f 74 SQL error...</t
9b00: 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 d></tr>..</table
9b10: 3e 3c 62 72 3e 0d 0a 3c 62 3e 50 72 61 63 74 69 ><br>..<b>Practi
9b20: 63 61 6c 20 65 78 61 6d 70 6c 65 73 3a 3c 2f 62 cal examples:</b
9b30: 3e 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 >..<verbatim>..S
9b40: 45 4c 45 43 54 20 50 52 4f 4a 5f 47 65 74 44 61 ELECT PROJ_GetDa
9b50: 74 61 62 61 73 65 50 61 74 68 28 29 3b 20 20 2d tabasePath(); -
9b60: 2d 20 72 65 74 72 69 65 76 69 6e 67 20 74 68 65 - retrieving the
9b70: 20 63 75 72 72 65 6e 74 6c 79 20 73 65 74 20 50 currently set P
9b80: 52 4f 4a 27 73 20 6f 77 6e 20 64 61 74 61 62 61 ROJ's own databa
9b90: 73 65 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d se..------------
9ba0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9bb0: 2d 2d 0d 0a 2f 75 73 72 2f 6c 6f 63 61 6c 2f 73 --../usr/local/s
9bc0: 68 61 72 65 2f 70 72 6f 6a 2f 70 72 6f 6a 2e 64 hare/proj/proj.d
9bd0: 62 0d 0a 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 b......SELECT PR
9be0: 4f 4a 5f 53 65 74 44 61 74 61 62 61 73 65 50 61 OJ_SetDatabasePa
9bf0: 74 68 28 27 2f 68 6f 6d 65 2f 73 61 6e 64 72 6f th('/home/sandro
9c00: 2f 6e 6f 74 5f 65 78 69 73 74 69 6e 67 5f 70 72 /not_existing_pr
9c10: 6f 6a 2e 64 62 27 29 3b 20 2d 2d 20 6e 6f 6e 20 oj.db'); -- non
9c20: 65 78 69 73 74 69 6e 67 20 64 61 74 61 62 61 73 existing databas
9c30: 65 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d e..-------------
9c40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9c50: 2d 0d 0a 4e 55 4c 4c 0d 0a 0d 0a 0d 0a 53 45 4c -..NULL......SEL
9c60: 45 43 54 20 50 52 4f 4a 5f 47 65 74 4c 61 73 74 ECT PROJ_GetLast
9c70: 45 72 72 6f 72 4d 73 67 28 29 3b 20 2d 2d 20 72 ErrorMsg(); -- r
9c80: 65 74 72 69 65 76 69 6e 67 20 74 68 65 20 66 61 etrieving the fa
9c90: 69 6c 75 72 65 20 63 61 75 73 65 0d 0a 2d 2d 2d ilure cause..---
9ca0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9cb0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 70 72 6f -----------..pro
9cc0: 6a 5f 63 6f 6e 74 65 78 74 5f 73 65 74 5f 64 61 j_context_set_da
9cd0: 74 61 62 61 73 65 5f 70 61 74 68 3a 20 4f 70 65 tabase_path: Ope
9ce0: 6e 20 6f 66 20 2f 68 6f 6d 65 2f 73 61 6e 64 72 n of /home/sandr
9cf0: 6f 2f 6e 6f 74 5f 65 78 69 73 74 69 6e 67 5f 70 o/not_existing_p
9d00: 72 6f 6a 2e 64 62 20 66 61 69 6c 65 64 0d 0a 0d roj.db failed...
9d10: 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f 53 ...SELECT PROJ_S
9d20: 65 74 44 61 74 61 62 61 73 65 50 61 74 68 28 27 etDatabasePath('
9d30: 2f 68 6f 6d 65 2f 73 61 6e 64 72 6f 2f 76 61 6c /home/sandro/val
9d40: 69 64 5f 70 72 6f 6a 2e 64 62 27 29 3b 20 2d 2d id_proj.db'); --
9d50: 20 76 61 6c 69 64 20 64 61 74 61 62 61 73 65 0d valid database.
9d60: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
9d70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d ---------------.
9d80: 0a 2f 68 6f 6d 65 2f 73 61 6e 64 72 6f 2f 76 61 ./home/sandro/va
9d90: 6c 69 64 5f 70 72 6f 6a 2e 64 62 0d 0a 0d 0a 0d lid_proj.db.....
9da0: 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f 41 73 50 .SELECT PROJ_AsP
9db0: 72 6f 6a 53 74 72 69 6e 67 28 27 45 50 53 47 27 rojString('EPSG'
9dc0: 2c 20 33 32 36 33 32 29 3b 0d 0a 2d 2d 2d 2d 2d , 32632);..-----
9dd0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9de0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 2b 70 72 6f 6a ---------..+proj
9df0: 3d 75 74 6d 20 2b 7a 6f 6e 65 3d 33 32 20 2b 64 =utm +zone=32 +d
9e00: 61 74 75 6d 3d 57 47 53 38 34 20 2b 75 6e 69 74 atum=WGS84 +unit
9e10: 73 3d 6d 20 2b 6e 6f 5f 64 65 66 73 20 2b 74 79 s=m +no_defs +ty
9e20: 70 65 3d 63 72 73 0d 0a 0d 0a 0d 0a 53 45 4c 45 pe=crs......SELE
9e30: 43 54 20 50 52 4f 4a 5f 41 73 57 4b 54 28 27 45 CT PROJ_AsWKT('E
9e40: 50 53 47 27 2c 20 34 33 32 36 29 3b 20 2d 2d 20 PSG', 4326); --
9e50: 64 65 66 61 75 6c 74 20 73 65 74 74 69 6e 67 73 default settings
9e60: 3a 20 49 53 4f 2d 32 30 31 38 20 73 74 79 6c 65 : ISO-2018 style
9e70: 2c 20 69 6e 64 65 6e 74 65 64 20 77 69 74 68 20 , indented with
9e80: 69 6e 64 65 6e 74 61 74 69 6f 6e 20 34 0d 0a 2d indentation 4..-
9e90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9ea0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 47 -------------..G
9eb0: 45 4f 44 43 52 53 5b 22 57 47 53 20 38 34 22 2c EODCRS["WGS 84",
9ec0: 0d 0a 20 20 20 20 44 41 54 55 4d 5b 22 57 6f 72 .. DATUM["Wor
9ed0: 6c 64 20 47 65 6f 64 65 74 69 63 20 53 79 73 74 ld Geodetic Syst
9ee0: 65 6d 20 31 39 38 34 22 2c 0d 0a 20 20 20 20 20 em 1984",..
9ef0: 20 20 20 45 4c 4c 49 50 53 4f 49 44 5b 22 57 47 ELLIPSOID["WG
9f00: 53 20 38 34 22 2c 36 33 37 38 31 33 37 2c 32 39 S 84",6378137,29
9f10: 38 2e 32 35 37 32 32 33 35 36 33 2c 0d 0a 20 20 8.257223563,..
9f20: 20 20 20 20 20 20 20 20 20 20 4c 45 4e 47 54 48 LENGTH
9f30: 55 4e 49 54 5b 22 6d 65 74 72 65 22 2c 31 5d 5d UNIT["metre",1]]
9f40: 5d 2c 0d 0a 20 20 20 20 50 52 49 4d 45 4d 5b 22 ],.. PRIMEM["
9f50: 47 72 65 65 6e 77 69 63 68 22 2c 30 2c 0d 0a 20 Greenwich",0,..
9f60: 20 20 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 ANGLEUNIT
9f70: 5b 22 64 65 67 72 65 65 22 2c 30 2e 30 31 37 34 ["degree",0.0174
9f80: 35 33 32 39 32 35 31 39 39 34 33 33 5d 5d 2c 0d 532925199433]],.
9f90: 0a 20 20 20 20 43 53 5b 65 6c 6c 69 70 73 6f 69 . CS[ellipsoi
9fa0: 64 61 6c 2c 32 5d 2c 0d 0a 20 20 20 20 20 20 20 dal,2],..
9fb0: 20 41 58 49 53 5b 22 67 65 6f 64 65 74 69 63 20 AXIS["geodetic
9fc0: 6c 61 74 69 74 75 64 65 20 28 4c 61 74 29 22 2c latitude (Lat)",
9fd0: 6e 6f 72 74 68 2c 0d 0a 20 20 20 20 20 20 20 20 north,..
9fe0: 20 20 20 20 4f 52 44 45 52 5b 31 5d 2c 0d 0a 20 ORDER[1],..
9ff0: 20 20 20 20 20 20 20 20 20 20 20 41 4e 47 4c 45 ANGLE
a000: 55 4e 49 54 5b 22 64 65 67 72 65 65 22 2c 30 2e UNIT["degree",0.
a010: 30 31 37 34 35 33 32 39 32 35 31 39 39 34 33 33 0174532925199433
a020: 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 41 58 49 ]],.. AXI
a030: 53 5b 22 67 65 6f 64 65 74 69 63 20 6c 6f 6e 67 S["geodetic long
a040: 69 74 75 64 65 20 28 4c 6f 6e 29 22 2c 65 61 73 itude (Lon)",eas
a050: 74 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 t,..
a060: 4f 52 44 45 52 5b 32 5d 2c 0d 0a 20 20 20 20 20 ORDER[2],..
a070: 20 20 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 ANGLEUNIT
a080: 5b 22 64 65 67 72 65 65 22 2c 30 2e 30 31 37 34 ["degree",0.0174
a090: 35 33 32 39 32 35 31 39 39 34 33 33 5d 5d 2c 0d 532925199433]],.
a0a0: 0a 20 20 20 20 41 52 45 41 5b 22 57 6f 72 6c 64 . AREA["World
a0b0: 22 5d 2c 0d 0a 20 20 20 20 42 42 4f 58 5b 2d 39 "],.. BBOX[-9
a0c0: 30 2c 2d 31 38 30 2c 39 30 2c 31 38 30 5d 2c 0d 0,-180,90,180],.
a0d0: 0a 20 20 20 20 49 44 5b 22 45 50 53 47 22 2c 34 . ID["EPSG",4
a0e0: 33 32 36 5d 5d 0d 0a 0d 0a 0d 0a 53 45 4c 45 43 326]]......SELEC
a0f0: 54 20 50 52 4f 4a 5f 41 73 57 4b 54 28 27 45 50 T PROJ_AsWKT('EP
a100: 53 47 27 2c 20 34 33 32 36 2c 20 27 45 53 52 49 SG', 4326, 'ESRI
a110: 27 2c 20 30 2c 20 30 29 3b 20 2d 2d 20 45 53 52 ', 0, 0); -- ESR
a120: 49 20 73 74 79 6c 65 2c 20 6d 6f 6e 6f 6c 69 74 I style, monolit
a130: 68 69 63 20 6c 69 6e 65 0d 0a 2d 2d 2d 2d 2d 2d hic line..------
a140: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a150: 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 47 45 4f 47 43 53 --------..GEOGCS
a160: 5b 22 47 43 53 5f 57 47 53 5f 31 39 38 34 22 2c ["GCS_WGS_1984",
a170: 44 41 54 55 4d 5b 22 44 5f 57 47 53 5f 31 39 38 DATUM["D_WGS_198
a180: 34 22 2c 53 50 48 45 52 4f 49 44 5b 22 57 47 53 4",SPHEROID["WGS
a190: 5f 31 39 38 34 22 2c 36 33 37 38 31 33 37 2e 30 _1984",6378137.0
a1a0: 2c 32 39 38 2e 32 35 37 32 32 33 35 36 33 5d 5d ,298.257223563]]
a1b0: 2c 50 52 49 4d 45 4d 5b 22 47 72 65 65 6e 77 69 ,PRIMEM["Greenwi
a1c0: 63 68 22 2c 30 2e 30 5d 2c 55 4e 49 54 5b 22 44 ch",0.0],UNIT["D
a1d0: 65 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 egree",0.0174532
a1e0: 39 32 35 31 39 39 34 33 33 5d 5d 0d 0a 0d 0a 0d 925199433]].....
a1f0: 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f 47 75 65 .SELECT PROJ_Gue
a200: 73 73 53 72 69 64 46 72 6f 6d 57 4b 54 28 27 47 ssSridFromWKT('G
a210: 45 4f 47 43 53 5b 22 47 43 53 5f 4d 6f 6e 74 65 EOGCS["GCS_Monte
a220: 5f 4d 61 72 69 6f 5f 52 6f 6d 65 22 2c 44 41 54 _Mario_Rome",DAT
a230: 55 4d 5b 22 44 5f 4d 6f 6e 74 65 5f 4d 61 72 69 UM["D_Monte_Mari
a240: 6f 22 2c 53 50 48 45 52 4f 49 44 5b 22 49 6e 74 o",SPHEROID["Int
a250: 65 72 6e 61 74 69 6f 6e 61 6c 5f 31 39 32 34 22 ernational_1924"
a260: 2c 36 33 37 38 33 38 38 2e 30 2c 32 39 37 2e 30 ,6378388.0,297.0
a270: 5d 5d 2c 50 52 49 4d 45 4d 5b 22 52 6f 6d 65 22 ]],PRIMEM["Rome"
a280: 2c 31 32 2e 34 35 32 33 33 33 33 33 33 33 33 33 ,12.452333333333
a290: 33 5d 2c 55 4e 49 54 5b 22 44 65 67 72 65 65 22 3],UNIT["Degree"
a2a0: 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 39 39 ,0.0174532925199
a2b0: 34 33 33 5d 5d 27 29 3b 20 0d 0a 2d 2d 2d 2d 2d 433]]'); ..-----
a2c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a2d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 34 38 30 36 0d ---------..4806.
a2e0: 0a 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a .....SELECT PROJ
a2f0: 5f 47 75 65 73 73 53 72 69 64 46 72 6f 6d 53 48 _GuessSridFromSH
a300: 50 28 27 2f 68 6f 6d 65 2f 73 61 6e 64 72 6f 2f P('/home/sandro/
a310: 74 75 73 63 61 6e 79 5f 73 68 70 2f 70 72 6f 76 tuscany_shp/prov
a320: 32 30 31 31 27 29 3b 20 2d 2d 20 72 65 6d 65 6d 2011'); -- remem
a330: 62 65 72 3a 20 72 65 71 75 69 72 65 73 20 74 6f ber: requires to
a340: 20 65 78 70 6c 69 63 69 74 6c 79 20 73 65 74 20 explicitly set
a350: 53 50 41 54 49 41 4c 49 54 45 5f 53 45 43 55 52 SPATIALITE_SECUR
a360: 49 54 59 3d 72 65 6c 61 78 65 64 0d 0a 2d 2d 2d ITY=relaxed..---
a370: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a380: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 33 30 30 -----------..300
a390: 33 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 3..</verbatim>..
a3a0: 3c 62 72 3e 0d 0a 3c 68 72 3e 3c 62 72 3e 0d 0a <br>..<hr><br>..
a3b0: 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 <table cellspaci
a3c0: 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 69 ng="8" cellpaddi
a3d0: 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 3d 22 ng="8" bgcolor="
a3e0: 23 66 66 65 30 65 39 22 20 77 69 64 74 68 3d 22 #ffe0e9" width="
a3f0: 31 30 30 25 22 3e 0d 0a 3c 74 72 3e 3c 74 68 3e 100%">..<tr><th>
a400: 0d 0a 3c 68 31 3e 49 6d 70 6f 72 74 61 6e 74 20 ..<h1>Important
a410: 6e 6f 74 69 63 65 20 66 6f 72 20 57 69 6e 64 6f notice for Windo
a420: 77 73 20 75 73 65 72 73 3c 2f 68 31 3e 0d 0a 3c ws users</h1>..<
a430: 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c /th></tr>..<tr><
a440: 74 64 3e 0d 0a 3c 62 3e 50 52 4f 4a 2e 36 3c 2f td>..<b>PROJ.6</
a450: 62 3e 20 63 72 69 74 69 63 61 6c 6c 79 20 64 65 b> critically de
a460: 70 65 6e 64 73 20 6f 6e 20 69 74 73 20 6f 77 6e pends on its own
a470: 20 70 72 69 76 61 74 65 20 53 51 4c 69 74 65 20 private SQLite
a480: 64 61 74 61 62 61 73 65 20 28 3c 62 3e 70 72 6f database (<b>pro
a490: 6a 2e 64 62 3c 2f 62 3e 29 20 63 6f 6e 74 61 69 j.db</b>) contai
a4a0: 6e 69 6e 67 20 61 6c 6c 20 72 65 6c 65 76 61 6e ning all relevan
a4b0: 74 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 61 62 t definitions ab
a4c0: 6f 75 74 20 45 6c 6c 69 70 73 6f 69 64 73 2c 20 out Ellipsoids,
a4d0: 50 72 69 6d 65 20 4d 65 72 69 64 69 61 6e 73 2c Prime Meridians,
a4e0: 20 43 52 53 65 73 2c 20 54 72 61 6e 73 66 6f 72 CRSes, Transfor
a4f0: 6d 61 74 69 6f 6e 73 20 61 6e 64 20 61 6c 69 6b mations and alik
a500: 65 2e 3c 62 72 3e 0d 0a 49 66 20 50 52 4f 4a 2e e.<br>..If PROJ.
a510: 36 20 69 73 20 75 6e 61 62 6c 65 20 74 6f 20 63 6 is unable to c
a520: 6f 72 72 65 63 74 6c 79 20 65 73 74 61 62 6c 69 orrectly establi
a530: 73 68 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 sh a connection
a540: 74 6f 20 74 68 69 73 20 64 61 74 61 62 61 73 65 to this database
a550: 20 69 74 20 77 69 6c 6c 20 62 65 20 73 65 76 65 it will be seve
a560: 72 65 6c 79 20 6c 69 6d 69 74 65 64 20 61 6e 64 rely limited and
a570: 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 61 62 6c will not be abl
a580: 65 20 74 6f 20 63 6f 72 72 65 63 74 6c 79 20 62 e to correctly b
a590: 65 68 61 76 65 20 61 73 20 65 78 70 65 63 74 65 ehave as expecte
a5a0: 64 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 75 6c 3e d.<br><br>..<ul>
a5b0: 0d 0a 3c 6c 69 3e 3c 62 3e 3c 75 3e 3c 69 3e 53 ..<li><b><u><i>S
a5c0: 68 6f 72 74 20 63 6f 6e 63 6c 75 73 69 6f 6e 3c hort conclusion<
a5d0: 2f 69 3e 3c 2f 75 3e 3c 2f 62 3e 3a 20 69 6e 73 /i></u></b>: ins
a5e0: 74 61 6c 6c 69 6e 67 20 74 68 65 20 73 6f 66 74 talling the soft
a5f0: 77 61 72 65 20 61 6c 6f 6e 65 20 69 73 20 6e 6f ware alone is no
a600: 74 20 65 6e 6f 75 67 68 2e 3c 62 72 3e 0d 0a 54 t enough.<br>..T
a610: 68 65 20 50 52 4f 4a 2e 36 20 70 72 69 76 61 74 he PROJ.6 privat
a620: 65 20 64 61 74 61 62 61 73 65 20 3c 62 3e 70 72 e database <b>pr
a630: 6f 6a 2e 64 62 3c 2f 62 3e 20 6d 75 73 74 20 62 oj.db</b> must b
a640: 65 20 70 72 6f 70 65 72 6c 79 20 69 6e 73 74 61 e properly insta
a650: 6c 6c 65 64 20 61 73 20 77 65 6c 6c 2c 20 69 6e lled as well, in
a660: 20 6f 72 64 65 72 20 74 6f 20 65 6e 73 75 72 65 order to ensure
a670: 20 74 68 61 74 20 61 6e 79 74 68 69 6e 67 20 72 that anything r
a680: 75 6e 73 20 73 6d 6f 6f 74 68 6c 79 2e 3c 2f 6c uns smoothly.</l
a690: 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 0d 0a 54 i>..</ul><br>..T
a6a0: 68 69 73 20 69 73 6e 27 74 20 75 73 75 61 6c 6c his isn't usuall
a6b0: 79 20 61 20 62 69 67 20 69 73 73 75 65 20 6f 6e y a big issue on
a6c0: 20 4c 69 6e 75 78 20 61 6e 64 20 55 6e 69 78 2d Linux and Unix-
a6d0: 6c 69 6b 65 20 70 6c 61 74 66 6f 72 6d 73 2c 20 like platforms,
a6e0: 77 68 65 72 65 20 61 20 72 61 74 69 6f 6e 61 6c where a rational
a6f0: 20 61 6e 64 20 76 65 72 79 20 63 6c 65 61 72 20 and very clear
a700: 66 69 6c 65 73 79 73 74 65 6d 20 6c 61 79 6f 75 filesystem layou
a710: 74 20 65 78 69 73 74 73 2e 3c 62 72 3e 0d 0a 4f t exists.<br>..O
a720: 6e 20 74 68 65 73 65 20 6f 70 65 72 61 74 69 6e n these operatin
a730: 67 20 73 79 73 74 65 6d 73 20 74 68 65 20 70 61 g systems the pa
a740: 63 6b 61 67 65 20 6d 61 6e 61 67 65 72 20 28 6f ckage manager (o
a750: 72 20 3c 62 3e 6d 61 6b 65 20 69 6e 73 74 61 6c r <b>make instal
a760: 6c 3c 2f 62 3e 29 20 77 69 6c 6c 20 61 75 74 6f l</b>) will auto
a770: 6d 61 74 69 63 61 6c 6c 79 20 74 61 6b 65 20 63 matically take c
a780: 61 72 65 20 74 6f 20 69 6e 73 74 61 6c 6c 20 3c are to install <
a790: 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20 6f 6e b>proj.db</b> on
a7a0: 20 74 68 65 20 6d 6f 73 74 20 61 70 70 72 6f 70 the most approp
a7b0: 72 69 61 74 65 20 64 69 72 65 63 74 6f 72 79 20 riate directory
a7c0: 28 75 73 75 61 6c 6c 79 20 61 73 20 3c 62 3e 2f (usually as <b>/
a7d0: 75 73 72 2f 73 68 61 72 65 2f 70 72 6f 6a 2f 70 usr/share/proj/p
a7e0: 72 6f 6a 2e 64 62 3c 2f 62 3e 20 6f 72 20 61 73 roj.db</b> or as
a7f0: 20 3c 62 3e 2f 75 73 72 2f 6c 6f 63 61 6c 2f 73 <b>/usr/local/s
a800: 68 61 72 65 2f 70 72 6f 6a 2f 70 72 6f 6a 2e 64 hare/proj/proj.d
a810: 62 3c 2f 62 3e 29 20 61 6e 64 20 74 68 61 74 27 b</b>) and that'
a820: 73 20 61 6c 6c 2e 3c 62 72 3e 3c 62 72 3e 0d 0a s all.<br><br>..
a830: 54 68 69 6e 67 73 20 61 72 65 20 75 6e 68 61 70 Things are unhap
a840: 70 69 6c 79 20 61 20 6c 69 74 74 6c 65 20 62 69 pily a little bi
a850: 74 20 6d 6f 72 65 20 64 69 66 66 69 63 75 6c 74 t more difficult
a860: 20 6f 6e 20 57 69 6e 64 6f 77 73 20 70 6c 61 74 on Windows plat
a870: 66 6f 72 6d 73 2e 0d 0a 54 68 65 20 75 73 65 72 forms...The user
a880: 20 69 74 73 65 6c 66 20 69 73 20 72 65 73 70 6f itself is respo
a890: 6e 73 69 62 6c 65 20 66 6f 72 20 70 72 6f 70 65 nsible for prope
a8a0: 72 6c 79 20 69 6e 73 74 61 6c 6c 69 6e 67 20 3c rly installing <
a8b0: 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e 0d 0a 53 b>proj.db</b>..S
a8c0: 6f 20 69 74 20 62 65 63 6f 6d 65 73 20 63 72 69 o it becomes cri
a8d0: 74 69 63 61 6c 20 75 6e 64 65 72 73 74 61 6e 64 tical understand
a8e0: 69 6e 67 20 74 68 65 20 62 61 73 69 63 20 72 75 ing the basic ru
a8f0: 6c 65 73 20 61 64 6f 70 74 65 64 20 62 79 20 3c les adopted by <
a900: 62 3e 6c 69 62 73 70 61 74 69 61 6c 69 74 65 3c b>libspatialite<
a910: 2f 62 3e 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 /b> in order to
a920: 70 72 6f 70 65 72 6c 79 20 6c 6f 63 61 74 65 20 properly locate
a930: 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20 6f <b>proj.db</b> o
a940: 6e 20 57 69 6e 64 6f 77 73 2e 0d 0a 3c 2f 74 64 n Windows...</td
a950: 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 68 3e ></tr>..<tr><th>
a960: 0d 0a 3c 68 32 3e 57 68 65 72 65 20 70 72 6f 6a ..<h2>Where proj
a970: 2e 64 62 20 69 73 20 65 78 70 65 63 74 65 64 20 .db is expected
a980: 74 6f 20 62 65 20 66 6f 75 6e 64 20 6f 6e 20 57 to be found on W
a990: 69 6e 64 6f 77 73 3c 2f 68 32 3e 0d 0a 3c 2f 74 indows</h2>..</t
a9a0: 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 d></tr>..<tr><td
a9b0: 3e 0d 0a 3c 6f 6c 3e 0d 0a 3c 6c 69 3e 74 68 65 >..<ol>..<li>the
a9c0: 20 66 69 72 73 74 20 70 6c 61 63 65 20 77 68 65 first place whe
a9d0: 72 65 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 re <b>proj.db</b
a9e0: 3e 20 77 69 6c 6c 20 62 65 20 73 65 61 72 63 68 > will be search
a9f0: 65 64 20 69 73 20 74 68 65 20 73 61 6d 65 20 66 ed is the same f
aa00: 6f 6c 64 65 72 20 66 6f 72 6d 20 77 68 65 72 65 older form where
aa10: 20 74 68 65 20 3c 62 3e 45 58 45 3c 2f 62 3e 20 the <b>EXE</b>
aa20: 62 69 6e 61 72 79 20 77 61 73 20 69 6e 69 74 69 binary was initi
aa30: 61 6c 6c 79 20 6c 6f 61 64 65 64 2e 3c 62 72 3e ally loaded.<br>
aa40: 0d 0a 3c 69 3e 3c 75 3e 45 78 61 6d 70 6c 65 3c ..<i><u>Example<
aa50: 2f 69 3e 3c 2f 75 3e 3a 20 61 73 73 75 6d 69 6e /i></u>: assumin
aa60: 67 20 74 68 61 74 20 79 6f 75 20 61 72 65 20 63 g that you are c
aa70: 75 72 72 65 6e 74 6c 79 20 65 78 65 63 75 74 69 urrently executi
aa80: 6e 67 20 3c 62 3e 43 3a 5c 6d 79 70 72 6f 67 73 ng <b>C:\myprogs
aa90: 5c 73 70 61 74 69 61 6c 69 74 65 5c 62 69 6e 5c \spatialite\bin\
aaa0: 73 70 61 74 69 61 6c 69 74 65 2e 65 78 65 3c 2f spatialite.exe</
aab0: 62 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 74 68 b>..<ul>..<li>th
aac0: 65 6e 20 61 6e 20 61 74 74 65 6d 70 74 20 77 69 en an attempt wi
aad0: 6c 6c 20 62 65 20 6d 61 64 65 20 74 6f 20 63 6f ll be made to co
aae0: 6e 6e 65 63 74 20 3c 62 3e 43 3a 5c 6d 79 70 72 nnect <b>C:\mypr
aaf0: 6f 67 73 5c 73 70 61 74 69 61 6c 69 74 65 5c 62 ogs\spatialite\b
ab00: 69 6e 5c 70 72 6f 6a 2e 64 62 3c 2f 62 3e 3c 2f in\proj.db</b></
ab10: 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c 69 3e 0d li>..</ul></li>.
ab20: 0a 3c 6c 69 3e 61 20 73 65 63 6f 6e 64 20 61 74 .<li>a second at
ab30: 74 65 6d 70 74 20 77 69 6c 6c 20 62 65 20 6d 61 tempt will be ma
ab40: 64 65 20 6f 6e 20 62 65 68 61 6c 66 20 6f 66 20 de on behalf of
ab50: 74 68 65 20 3c 62 3e 50 75 62 6c 69 63 3c 2f 62 the <b>Public</b
ab60: 3e 20 66 6f 6c 64 65 72 2e 3c 62 72 3e 0d 0a 3c > folder.<br>..<
ab70: 69 3e 3c 75 3e 45 78 61 6d 70 6c 65 3c 2f 75 3e i><u>Example</u>
ab80: 3c 2f 69 3e 3a 20 61 6e 20 61 74 74 65 6d 70 74 </i>: an attempt
ab90: 20 77 69 6c 6c 20 62 65 20 6d 61 64 65 20 74 6f will be made to
aba0: 20 63 6f 6e 6e 65 63 74 20 3c 62 3e 43 3a 5c 55 connect <b>C:\U
abb0: 73 65 72 73 5c 50 75 62 6c 69 63 5c 73 70 61 74 sers\Public\spat
abc0: 69 61 6c 69 74 65 5c 70 72 6f 6a 5c 70 72 6f 6a ialite\proj\proj
abd0: 2e 64 62 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 6c .db</b></li>..<l
abe0: 69 3e 61 20 74 68 69 72 64 20 28 61 6e 64 20 6c i>a third (and l
abf0: 61 73 74 29 20 61 74 74 65 6d 70 74 20 77 69 6c ast) attempt wil
ac00: 6c 20 62 65 20 6d 61 64 65 20 6f 6e 20 62 65 68 l be made on beh
ac10: 61 6c 66 20 6f 66 20 74 68 65 20 3c 62 3e 55 73 alf of the <b>Us
ac20: 65 72 3c 2f 62 3e 20 66 6f 6c 64 65 72 2e 3c 62 er</b> folder.<b
ac30: 72 3e 0d 0a 3c 69 3e 3c 75 3e 45 78 61 6d 70 6c r>..<i><u>Exampl
ac40: 65 3c 2f 69 3e 3c 2f 75 3e 3a 20 61 6e 20 61 74 e</i></u>: an at
ac50: 74 65 6d 70 74 20 77 69 6c 6c 20 62 65 20 6d 61 tempt will be ma
ac60: 64 65 20 74 6f 20 63 6f 6e 6e 65 63 74 20 3c 62 de to connect <b
ac70: 3e 43 3a 5c 55 73 65 72 73 5c 73 61 6e 64 72 6f >C:\Users\sandro
ac80: 5c 73 70 61 74 69 61 6c 69 74 65 5c 70 72 6f 6a \spatialite\proj
ac90: 5c 70 72 6f 6a 2e 64 62 3c 2f 62 3e 3c 2f 6c 69 \proj.db</b></li
aca0: 3e 0d 0a 3c 2f 6f 6c 3e 0d 0a 3c 68 33 3e 41 6e >..</ol>..<h3>An
acb0: 20 75 73 65 66 75 6c 20 64 69 61 67 6e 6f 73 74 useful diagnost
acc0: 69 63 20 63 68 65 63 6b 3c 2f 68 33 3e 0d 0a 3c ic check</h3>..<
acd0: 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 verbatim>..SELEC
ace0: 54 20 50 52 4f 4a 5f 47 65 74 44 61 74 61 62 61 T PROJ_GetDataba
acf0: 73 65 50 61 74 68 28 29 3b 0d 0a 3c 2f 76 65 72 sePath();..</ver
ad00: 62 61 74 69 6d 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c batim>..<ul>..<l
ad10: 69 3e 69 66 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e i>if <b>NULL</b>
ad20: 20 69 73 20 72 65 74 75 72 6e 65 64 2c 20 74 68 is returned, th
ad30: 65 6e 20 50 52 4f 4a 2e 36 20 69 73 20 64 65 66 en PROJ.6 is def
ad40: 69 6e 69 74 65 6c 79 20 75 6e 61 62 6c 65 20 74 initely unable t
ad50: 6f 20 63 6f 6e 6e 65 63 74 20 74 6f 20 69 74 73 o connect to its
ad60: 20 6f 77 6e 20 70 72 69 76 61 74 65 20 53 51 4c own private SQL
ad70: 69 74 65 20 64 61 74 61 62 61 73 65 20 3c 62 3e ite database <b>
ad80: 70 72 6f 6a 2e 64 62 3c 2f 62 3e 3c 62 72 3e 0d proj.db</b><br>.
ad90: 0a 59 6f 75 20 68 61 76 65 20 74 6f 20 63 61 72 .You have to car
ada0: 65 66 75 6c 6c 79 20 76 65 72 69 66 79 20 74 68 efully verify th
adb0: 61 74 20 69 74 27 73 20 72 65 61 6c 6c 79 20 69 at it's really i
adc0: 6e 73 74 61 6c 6c 65 64 20 6f 6e 20 6f 6e 65 20 nstalled on one
add0: 6f 66 20 74 68 65 20 65 78 70 65 63 74 65 64 20 of the expected
ade0: 73 74 61 6e 64 61 72 64 20 6c 6f 63 61 74 69 6f standard locatio
adf0: 6e 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 6f 74 ns.</li>..<li>ot
ae00: 68 65 72 77 69 73 65 20 74 68 65 20 70 61 74 68 herwise the path
ae10: 20 6c 65 61 64 69 6e 67 20 74 6f 20 74 68 65 20 leading to the
ae20: 63 75 72 72 65 6e 74 6c 79 20 63 6f 6e 6e 65 63 currently connec
ae30: 74 65 64 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f ted <b>proj.db</
ae40: 62 3e 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 b> will be retur
ae50: 6e 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e ned.</li>..</ul>
ae60: 3c 62 72 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e <br>..</td></tr>
ae70: 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 3c 62 ..</table><br><b
ae80: 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 r>..<table cells
ae90: 70 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 pacing="8" cellp
aea0: 61 64 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c adding="8" bgcol
aeb0: 6f 72 3d 22 23 63 39 66 66 66 30 22 3e 0d 0a 3c or="#c9fff0">..<
aec0: 74 72 3e 3c 74 68 3e 0d 0a 3c 68 32 3e 55 73 69 tr><th>..<h2>Usi
aed0: 6e 67 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 ng the environme
aee0: 6e 74 20 76 61 72 69 61 62 6c 65 20 50 52 4f 4a nt variable PROJ
aef0: 5f 4c 49 42 3c 2f 68 32 3e 0d 0a 3c 2f 74 68 3e _LIB</h2>..</th>
af00: 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d </tr>..<tr><td>.
af10: 0a 3c 62 3e 50 52 4f 4a 5f 4c 49 42 3c 2f 62 3e .<b>PROJ_LIB</b>
af20: 20 69 73 20 61 20 73 74 61 6e 64 61 72 64 20 65 is a standard e
af30: 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 nvironment varia
af40: 62 6c 65 20 73 75 70 70 6f 72 74 65 64 20 62 79 ble supported by
af50: 20 50 52 4f 4a 20 69 74 73 65 6c 66 2e 3c 62 72 PROJ itself.<br
af60: 3e 0d 0a 57 68 65 6e 20 3c 62 3e 50 52 4f 4a 5f >..When <b>PROJ_
af70: 4c 49 42 3c 2f 62 3e 20 69 73 20 73 65 74 2c 20 LIB</b> is set,
af80: 74 68 65 6e 20 50 52 4f 4a 2e 36 20 77 69 6c 6c then PROJ.6 will
af90: 20 64 69 72 65 63 74 6c 79 20 73 65 61 72 63 68 directly search
afa0: 20 69 74 73 20 6f 77 6e 20 70 72 69 76 61 74 65 its own private
afb0: 20 64 61 74 61 62 61 73 65 20 69 6e 74 6f 20 74 database into t
afc0: 68 65 20 64 69 72 65 63 74 6f 72 79 20 72 65 66 he directory ref
afd0: 65 72 65 6e 63 65 64 20 62 79 20 74 68 65 20 76 erenced by the v
afe0: 61 72 69 61 62 6c 65 2e 3c 62 72 3e 0d 0a 53 75 ariable.<br>..Su
aff0: 63 68 20 61 20 63 61 70 61 62 69 6c 69 74 79 20 ch a capability
b000: 69 73 20 73 75 70 70 6f 72 74 65 64 20 6f 6e 20 is supported on
b010: 62 6f 74 68 20 57 69 6e 64 6f 77 73 20 61 6e 64 both Windows and
b020: 20 4c 69 6e 75 78 20 28 61 6e 64 20 6f 6e 20 61 Linux (and on a
b030: 6e 79 20 6f 74 68 65 72 20 70 6c 61 74 66 6f 72 ny other platfor
b040: 6d 29 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 69 3e m).<br><br>..<i>
b050: 3c 75 3e 4c 69 6e 75 78 20 65 78 61 6d 70 6c 65 <u>Linux example
b060: 3c 2f 75 3e 3c 2f 69 3e 3a 0d 0a 3c 75 6c 3e 0d </u></i>:..<ul>.
b070: 0a 3c 6c 69 3e 3c 62 3e 65 78 70 6f 72 74 20 22 .<li><b>export "
b080: 50 52 4f 4a 5f 4c 49 42 3d 2f 68 6f 6d 65 2f 73 PROJ_LIB=/home/s
b090: 61 6e 64 72 6f 2f 70 72 6f 6a 22 3c 62 72 3e 0d andro/proj"<br>.
b0a0: 0a 65 63 68 6f 20 24 50 52 4f 4a 5f 4c 49 42 3c .echo $PROJ_LIB<
b0b0: 62 72 3e 0d 0a 73 70 61 74 69 61 6c 69 74 65 3c br>..spatialite<
b0c0: 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 b></li>..</ul><b
b0d0: 72 3e 3c 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 57 69 r><br>..<i><u>Wi
b0e0: 6e 64 6f 77 73 20 65 78 61 6d 70 6c 65 3c 2f 75 ndows example</u
b0f0: 3e 3c 2f 69 3e 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c ></i>:..<ul>..<l
b100: 69 3e 3c 62 3e 53 45 54 20 50 52 4f 4a 5f 4c 49 i><b>SET PROJ_LI
b110: 42 3d 43 3a 5c 55 73 65 72 73 5c 73 61 6e 64 72 B=C:\Users\sandr
b120: 6f 5c 70 72 6f 6a 3c 62 72 3e 0d 0a 65 63 68 6f o\proj<br>..echo
b130: 20 25 50 52 4f 4a 5f 4c 49 42 25 3c 62 72 3e 0d %PROJ_LIB%<br>.
b140: 0a 73 70 61 74 69 61 6c 69 74 65 5f 67 75 69 3c .spatialite_gui<
b150: 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 b></li>..</ul><b
b160: 72 3e 3c 62 72 3e 0d 0a 3c 2f 74 68 3e 3c 2f 74 r><br>..</th></t
b170: 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e r>..</table><br>
b180: 0d 0a 3c 68 72 3e 0d 0a 3c 68 31 3e 50 52 4f 4a ..<hr>..<h1>PROJ
b190: 2e 36 20 73 75 70 70 6f 72 74 20 6f 6e 20 73 70 .6 support on sp
b1a0: 61 74 69 61 6c 69 74 65 5f 67 75 69 3c 2f 68 31 atialite_gui</h1
b1b0: 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 >..<table cellsp
b1c0: 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 acing="8" cellpa
b1d0: 64 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f dding="8" bgcolo
b1e0: 72 3d 22 23 65 38 66 66 65 38 22 20 62 6f 72 64 r="#e8ffe8" bord
b1f0: 65 72 3d 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 64 er="1">..<tr><td
b200: 3e 0d 0a 54 68 65 20 47 55 49 20 74 6f 6f 6c 20 >..The GUI tool
b210: 6a 75 73 74 20 69 6e 74 72 6f 64 75 63 65 73 20 just introduces
b220: 61 20 73 69 6e 67 6c 65 20 6e 65 77 20 66 65 61 a single new fea
b230: 74 75 72 65 20 69 6e 74 65 6e 64 65 64 20 74 6f ture intended to
b240: 20 6d 61 6b 65 20 61 73 20 65 61 73 79 20 61 73 make as easy as
b250: 20 70 6f 73 73 69 62 6c 65 20 75 73 69 6e 67 20 possible using
b260: 50 52 4f 4a 2e 36 3c 62 72 3e 3c 62 72 3e 0d 0a PROJ.6<br><br>..
b270: 54 68 65 20 6d 61 69 6e 20 6d 65 6e 75 20 6e 6f The main menu no
b280: 77 20 63 6f 6e 74 61 69 6e 73 20 61 6e 20 3c 62 w contains an <b
b290: 3e 3c 69 3e 45 78 74 65 72 6e 61 6c 20 76 61 72 ><i>External var
b2a0: 69 61 62 6c 65 20 50 52 4f 4a 5f 4c 49 42 3c 2f iable PROJ_LIB</
b2b0: 69 3e 3c 2f 62 3e 20 69 74 65 6d 2e 3c 62 72 3e i></b> item.<br>
b2c0: 0d 0a 41 66 74 65 72 20 61 63 74 69 76 61 74 69 ..After activati
b2d0: 6e 67 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e ng the correspon
b2e0: 64 69 6e 67 20 6f 70 74 69 6f 6e 20 61 20 73 74 ding option a st
b2f0: 61 6e 64 61 72 64 20 3c 62 3e 3c 69 3e 46 69 6c andard <b><i>Fil
b300: 65 20 53 65 6c 65 63 74 69 6f 6e 20 44 69 61 6c e Selection Dial
b310: 6f 67 20 3c 2f 69 3e 3c 2f 62 3e 20 77 69 6c 6c og </i></b> will
b320: 20 73 68 6f 77 20 6f 6e 20 74 68 65 20 73 63 72 show on the scr
b330: 65 65 6e 2c 20 74 68 75 73 20 65 6e 61 62 6c 69 een, thus enabli
b340: 6e 67 20 74 68 65 20 75 73 65 72 20 74 6f 20 6c ng the user to l
b350: 6f 63 61 74 65 20 6f 6e 20 74 68 65 20 66 69 6c ocate on the fil
b360: 65 2d 73 79 73 74 65 6d 20 74 68 65 20 70 72 69 e-system the pri
b370: 76 61 74 65 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c vate <b>proj.db<
b380: 2f 62 3e 20 64 61 74 61 62 61 73 65 20 6f 66 20 /b> database of
b390: 50 52 4f 4a 2e 36 2e 3c 62 72 3e 3c 62 72 3e 0d PROJ.6.<br><br>.
b3a0: 0a 4f 6e 63 65 20 74 68 61 74 20 3c 62 3e 70 72 .Once that <b>pr
b3b0: 6f 6a 2e 64 62 3c 2f 62 3e 20 77 69 6c 6c 20 62 oj.db</b> will b
b3c0: 65 20 63 6f 72 72 65 63 74 6c 79 20 6c 6f 63 61 e correctly loca
b3d0: 74 65 64 20 74 68 65 6e 20 3c 62 3e 73 70 61 74 ted then <b>spat
b3e0: 69 61 6c 69 74 65 5f 67 75 69 3c 2f 62 3e 20 77 ialite_gui</b> w
b3f0: 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c ill automaticall
b400: 79 20 73 65 74 20 74 68 65 20 3c 62 3e 50 52 4f y set the <b>PRO
b410: 4a 5f 4c 49 42 3c 2f 62 3e 20 76 61 72 69 61 62 J_LIB</b> variab
b420: 6c 65 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 41 6e 64 le.<br><br>..And
b430: 20 74 68 61 74 27 73 20 6e 6f 74 20 61 6c 6c 3b that's not all;
b440: 20 3c 62 3e 73 70 61 74 69 61 6c 69 74 65 5f 67 <b>spatialite_g
b450: 75 69 3c 2f 62 3e 20 77 69 6c 6c 20 70 65 72 73 ui</b> will pers
b460: 69 73 74 65 6e 74 6c 79 20 73 74 6f 72 65 20 74 istently store t
b470: 68 65 20 63 75 72 72 65 6e 74 20 76 61 6c 75 65 he current value
b480: 20 6f 66 20 3c 62 3e 50 52 4f 4a 5f 4c 49 42 3c of <b>PROJ_LIB<
b490: 2f 62 3e 2c 20 73 6f 20 61 73 20 74 6f 20 61 62 /b>, so as to ab
b4a0: 6c 65 20 74 6f 20 73 65 74 20 69 74 20 61 75 74 le to set it aut
b4b0: 6f 6d 61 74 69 63 61 6c 6c 79 20 66 6f 72 20 65 omatically for e
b4c0: 61 63 68 20 73 75 62 73 65 71 75 65 6e 74 20 69 ach subsequent i
b4d0: 6e 76 6f 63 61 74 69 6f 6e 2e 0d 0a 3c 2f 74 64 nvocation...</td
b4e0: 3e 0d 0a 3c 74 64 3e 0d 0a 3c 69 6d 67 20 73 72 >..<td>..<img sr
b4f0: 63 3d 22 68 74 74 70 73 3a 2f 2f 77 77 77 2e 67 c="https://www.g
b500: 61 69 61 2d 67 69 73 2e 69 74 2f 67 61 69 61 2d aia-gis.it/gaia-
b510: 73 69 6e 73 2f 70 72 6f 6a 36 70 69 63 73 2f 67 sins/proj6pics/g
b520: 75 69 2d 70 72 6f 6a 36 2e 70 6e 67 22 20 61 6c ui-proj6.png" al
b530: 74 3d 22 67 75 69 20 70 72 6f 6a 36 22 3e 0d 0a t="gui proj6">..
b540: 3c 2f 74 64 3e 3c 2f 74 72 3e 3c 74 72 3e 3c 74 </td></tr><tr><t
b550: 64 3e 0d 0a 54 68 65 72 65 20 69 73 20 61 20 66 d>..There is a f
b560: 75 72 74 68 65 72 20 65 6e 68 61 6e 63 65 6d 65 urther enhanceme
b570: 6e 74 20 61 76 61 69 6c 61 62 6c 65 20 77 68 65 nt available whe
b580: 6e 20 3c 62 3e 73 70 61 74 69 61 6c 69 74 65 5f n <b>spatialite_
b590: 67 75 69 3c 2f 62 3e 20 69 73 20 62 61 63 6b 65 gui</b> is backe
b5a0: 64 20 75 70 20 62 79 20 50 52 4f 4a 2e 36 3c 62 d up by PROJ.6<b
b5b0: 72 3e 0d 0a 49 74 27 73 20 61 20 76 65 72 79 20 r>..It's a very
b5c0: 6c 69 74 74 6c 65 20 65 76 69 64 65 6e 74 20 69 little evident i
b5d0: 6e 6e 6f 76 61 74 69 6f 6e 2c 20 62 75 74 20 69 nnovation, but i
b5e0: 74 20 77 69 6c 6c 20 70 72 6f 62 61 62 6c 79 20 t will probably
b5f0: 62 65 20 68 69 67 68 6c 79 20 61 70 70 72 65 63 be highly apprec
b600: 69 61 74 65 64 20 62 79 20 6d 61 6e 79 20 75 73 iated by many us
b610: 65 72 73 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 57 68 ers.<br><br>..Wh
b620: 65 6e 20 6c 6f 61 64 69 6e 67 20 73 6f 6d 65 20 en loading some
b630: 53 68 61 70 65 66 69 6c 65 20 6e 6f 77 20 74 68 Shapefile now th
b640: 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 3c 62 e appropriate <b
b650: 3e 53 52 49 44 20 76 61 6c 75 65 3c 2f 62 3e 20 >SRID value</b>
b660: 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74 69 will be automati
b670: 63 61 6c 6c 79 20 64 65 74 65 72 6d 69 6e 65 64 cally determined
b680: 20 62 79 20 65 78 61 6d 69 6e 69 6e 67 20 74 68 by examining th
b690: 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 e content of the
b6a0: 20 63 6f 6d 70 61 6e 69 6f 6e 20 3c 62 3e 2e 70 companion <b>.p
b6b0: 72 6a 3c 2f 62 3e 20 28 69 66 20 73 75 70 70 6c rj</b> (if suppl
b6c0: 69 65 64 29 2e 0d 0a 3c 2f 74 64 3e 0d 0a 3c 74 ied)...</td>..<t
b6d0: 64 3e 0d 0a 3c 69 6d 67 20 73 72 63 3d 22 68 74 d>..<img src="ht
b6e0: 74 70 73 3a 2f 2f 77 77 77 2e 67 61 69 61 2d 67 tps://www.gaia-g
b6f0: 69 73 2e 69 74 2f 67 61 69 61 2d 73 69 6e 73 2f is.it/gaia-sins/
b700: 70 72 6f 6a 36 70 69 63 73 2f 6c 6f 61 64 2d 73 proj6pics/load-s
b710: 68 70 2d 70 72 6f 6a 36 2e 70 6e 67 22 20 61 6c hp-proj6.png" al
b720: 74 3d 22 67 75 69 20 70 72 6f 6a 36 22 3e 0d 0a t="gui proj6">..
b730: 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 </td></tr>..</ta
b740: 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 68 72 3e 3c 62 ble><br>..<hr><b
b750: 72 3e 0d 0a 3c 61 20 68 72 65 66 3d 22 68 74 74 r>..<a href="htt
b760: 70 73 3a 2f 2f 77 77 77 2e 67 61 69 61 2d 67 69 ps://www.gaia-gi
b770: 73 2e 69 74 2f 66 6f 73 73 69 6c 2f 6c 69 62 73 s.it/fossil/libs
b780: 70 61 74 69 61 6c 69 74 65 2f 77 69 6b 69 3f 6e patialite/wiki?n
b790: 61 6d 65 3d 34 2e 33 2e 30 2d 64 6f 63 22 3e 62 ame=4.3.0-doc">b
b7a0: 61 63 6b 3c 2f 61 3e 0a 5a 20 31 32 37 61 35 30 ack</a>.Z 127a50
b7b0: 63 38 62 64 61 31 39 30 31 32 61 66 30 38 30 38 c8bda19012af0808
b7c0: 39 30 30 36 62 36 63 37 63 63 0a 9006b6c7cc.