0000: 44 20 32 30 31 39 2d 30 35 2d 31 35 54 30 37 3a D 2019-05-15T07:
0010: 31 35 3a 34 39 2e 36 34 32 0a 4c 20 50 52 4f 4a 15:49.642.L PROJ
0020: 2e 36 0a 50 20 66 34 62 63 39 36 30 64 66 31 66 .6.P f4bc960df1f
0030: 30 31 36 37 34 61 65 61 31 66 66 65 35 37 63 66 01674aea1ffe57cf
0040: 30 61 65 37 36 63 65 37 64 64 38 36 34 0a 55 20 0ae76ce7dd864.U
0050: 73 61 6e 64 72 6f 0a 57 20 34 36 39 32 35 0a 3c sandro.W 46925.<
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 0d 0a valign="top">..
1970: 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 50 52 4f 4a <verbatim>..PROJ
1980: 43 52 53 5b 22 4d 6f 6e 74 65 20 4d 61 72 69 6f CRS["Monte Mario
1990: 20 2f 20 49 74 61 6c 79 20 7a 6f 6e 65 20 31 22 / Italy zone 1"
19a0: 2c 0d 0a 20 20 20 20 42 41 53 45 47 45 4f 44 43 ,.. BASEGEODC
19b0: 52 53 5b 22 4d 6f 6e 74 65 20 4d 61 72 69 6f 22 RS["Monte Mario"
19c0: 2c 0d 0a 20 20 20 20 20 20 20 20 44 41 54 55 4d ,.. DATUM
19d0: 5b 22 4d 6f 6e 74 65 20 4d 61 72 69 6f 22 2c 0d ["Monte Mario",.
19e0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 45 4c 4c . ELL
19f0: 49 50 53 4f 49 44 5b 22 49 6e 74 65 72 6e 61 74 IPSOID["Internat
1a00: 69 6f 6e 61 6c 20 31 39 32 34 22 2c 36 33 37 38 ional 1924",6378
1a10: 33 38 38 2c 32 39 37 2c 0d 0a 20 20 20 20 20 20 388,297,..
1a20: 20 20 20 20 20 20 20 20 20 20 4c 45 4e 47 54 48 LENGTH
1a30: 55 4e 49 54 5b 22 6d 65 74 72 65 22 2c 31 5d 5d UNIT["metre",1]]
1a40: 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 52 49 4d ],.. PRIM
1a50: 45 4d 5b 22 47 72 65 65 6e 77 69 63 68 22 2c 30 EM["Greenwich",0
1a60: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 41 ,.. A
1a70: 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 65 NGLEUNIT["degree
1a80: 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 39 ",0.017453292519
1a90: 39 34 33 33 5d 5d 5d 2c 0d 0a 20 20 20 20 43 4f 9433]]],.. CO
1aa0: 4e 56 45 52 53 49 4f 4e 5b 22 49 74 61 6c 79 20 NVERSION["Italy
1ab0: 7a 6f 6e 65 20 31 22 2c 0d 0a 20 20 20 20 20 20 zone 1",..
1ac0: 20 20 4d 45 54 48 4f 44 5b 22 54 72 61 6e 73 76 METHOD["Transv
1ad0: 65 72 73 65 20 4d 65 72 63 61 74 6f 72 22 2c 0d erse Mercator",.
1ae0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 44 5b . ID[
1af0: 22 45 50 53 47 22 2c 39 38 30 37 5d 5d 2c 0d 0a "EPSG",9807]],..
1b00: 20 20 20 20 20 20 20 20 50 41 52 41 4d 45 54 45 PARAMETE
1b10: 52 5b 22 4c 61 74 69 74 75 64 65 20 6f 66 20 6e R["Latitude of n
1b20: 61 74 75 72 61 6c 20 6f 72 69 67 69 6e 22 2c 30 atural origin",0
1b30: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 41 ,.. A
1b40: 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 65 NGLEUNIT["degree
1b50: 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 39 ",0.017453292519
1b60: 39 34 33 33 5d 2c 0d 0a 20 20 20 20 20 20 20 20 9433],..
1b70: 20 20 20 20 49 44 5b 22 45 50 53 47 22 2c 38 38 ID["EPSG",88
1b80: 30 31 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 01]],.. P
1b90: 41 52 41 4d 45 54 45 52 5b 22 4c 6f 6e 67 69 74 ARAMETER["Longit
1ba0: 75 64 65 20 6f 66 20 6e 61 74 75 72 61 6c 20 6f ude of natural o
1bb0: 72 69 67 69 6e 22 2c 39 2c 0d 0a 20 20 20 20 20 rigin",9,..
1bc0: 20 20 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 ANGLEUNIT
1bd0: 5b 22 64 65 67 72 65 65 22 2c 30 2e 30 31 37 34 ["degree",0.0174
1be0: 35 33 32 39 32 35 31 39 39 34 33 33 5d 2c 0d 0a 532925199433],..
1bf0: 20 20 20 20 20 20 20 20 20 20 20 20 49 44 5b 22 ID["
1c00: 45 50 53 47 22 2c 38 38 30 32 5d 5d 2c 0d 0a 20 EPSG",8802]],..
1c10: 20 20 20 20 20 20 20 50 41 52 41 4d 45 54 45 52 PARAMETER
1c20: 5b 22 53 63 61 6c 65 20 66 61 63 74 6f 72 20 61 ["Scale factor a
1c30: 74 20 6e 61 74 75 72 61 6c 20 6f 72 69 67 69 6e t natural origin
1c40: 22 2c 30 2e 39 39 39 36 2c 0d 0a 20 20 20 20 20 ",0.9996,..
1c50: 20 20 20 20 20 20 20 53 43 41 4c 45 55 4e 49 54 SCALEUNIT
1c60: 5b 22 75 6e 69 74 79 22 2c 31 5d 2c 0d 0a 20 20 ["unity",1],..
1c70: 20 20 20 20 20 20 20 20 20 20 49 44 5b 22 45 50 ID["EP
1c80: 53 47 22 2c 38 38 30 35 5d 5d 2c 0d 0a 20 20 20 SG",8805]],..
1c90: 20 20 20 20 20 50 41 52 41 4d 45 54 45 52 5b 22 PARAMETER["
1ca0: 46 61 6c 73 65 20 65 61 73 74 69 6e 67 22 2c 31 False easting",1
1cb0: 35 30 30 30 30 30 2c 0d 0a 20 20 20 20 20 20 20 500000,..
1cc0: 20 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b LENGTHUNIT[
1cd0: 22 6d 65 74 72 65 22 2c 31 5d 2c 0d 0a 20 20 20 "metre",1],..
1ce0: 20 20 20 20 20 20 20 20 20 49 44 5b 22 45 50 53 ID["EPS
1cf0: 47 22 2c 38 38 30 36 5d 5d 2c 0d 0a 20 20 20 20 G",8806]],..
1d00: 20 20 20 20 50 41 52 41 4d 45 54 45 52 5b 22 46 PARAMETER["F
1d10: 61 6c 73 65 20 6e 6f 72 74 68 69 6e 67 22 2c 30 alse northing",0
1d20: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4c ,.. L
1d30: 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 74 72 65 ENGTHUNIT["metre
1d40: 22 2c 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 ",1],..
1d50: 20 20 20 49 44 5b 22 45 50 53 47 22 2c 38 38 30 ID["EPSG",880
1d60: 37 5d 5d 5d 2c 0d 0a 20 20 20 20 43 53 5b 43 61 7]]],.. CS[Ca
1d70: 72 74 65 73 69 61 6e 2c 32 5d 2c 0d 0a 20 20 20 rtesian,2],..
1d80: 20 20 20 20 20 41 58 49 53 5b 22 65 61 73 74 69 AXIS["easti
1d90: 6e 67 20 28 58 29 22 2c 65 61 73 74 2c 0d 0a 20 ng (X)",east,..
1da0: 20 20 20 20 20 20 20 20 20 20 20 4f 52 44 45 52 ORDER
1db0: 5b 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 [1],..
1dc0: 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 LENGTHUNIT["me
1dd0: 74 72 65 22 2c 31 5d 5d 2c 0d 0a 20 20 20 20 20 tre",1]],..
1de0: 20 20 20 41 58 49 53 5b 22 6e 6f 72 74 68 69 6e AXIS["northin
1df0: 67 20 28 59 29 22 2c 6e 6f 72 74 68 2c 0d 0a 20 g (Y)",north,..
1e00: 20 20 20 20 20 20 20 20 20 20 20 4f 52 44 45 52 ORDER
1e10: 5b 32 5d 2c 3c 62 72 3e 0d 0a 20 20 20 20 20 20 [2],<br>..
1e20: 20 20 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 LENGTHUNIT
1e30: 5b 22 6d 65 74 72 65 22 2c 31 5d 5d 2c 0d 0a 20 ["metre",1]],..
1e40: 20 20 20 41 52 45 41 5b 22 49 74 61 6c 79 20 2d AREA["Italy -
1e50: 20 77 65 73 74 20 6f 66 20 31 32 c2 b0 45 22 5d west of 12..E"]
1e60: 2c 0d 0a 20 20 20 20 42 42 4f 58 5b 33 36 2e 35 ,.. BBOX[36.5
1e70: 33 2c 35 2e 39 34 2c 34 37 2e 30 34 2c 31 32 5d 3,5.94,47.04,12]
1e80: 2c 0d 0a 20 20 20 20 49 44 5b 22 45 50 53 47 22 ,.. ID["EPSG"
1e90: 2c 33 30 30 33 5d 5d 0d 0a 3c 2f 76 65 72 62 61 ,3003]]..</verba
1ea0: 74 69 6d 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 20 76 tim></td>..<td v
1eb0: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 3c 76 65 72 align="top"><ver
1ec0: 62 61 74 69 6d 3e 0d 0a 47 45 4f 44 43 52 53 5b batim>..GEODCRS[
1ed0: 22 57 47 53 20 38 34 22 2c 0d 0a 20 20 20 20 44 "WGS 84",.. D
1ee0: 41 54 55 4d 5b 22 57 6f 72 6c 64 20 47 65 6f 64 ATUM["World Geod
1ef0: 65 74 69 63 20 53 79 73 74 65 6d 20 31 39 38 34 etic System 1984
1f00: 22 2c 0d 0a 20 20 20 20 20 20 20 20 45 4c 4c 49 ",.. ELLI
1f10: 50 53 4f 49 44 5b 22 57 47 53 20 38 34 22 2c 36 PSOID["WGS 84",6
1f20: 33 37 38 31 33 37 2c 32 39 38 2e 32 35 37 32 32 378137,298.25722
1f30: 33 35 36 33 2c 0d 0a 20 20 20 20 20 20 20 20 20 3563,..
1f40: 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d LENGTHUNIT["m
1f50: 65 74 72 65 22 2c 31 5d 5d 5d 2c 0d 0a 20 20 20 etre",1]]],..
1f60: 20 50 52 49 4d 45 4d 5b 22 47 72 65 65 6e 77 69 PRIMEM["Greenwi
1f70: 63 68 22 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 ch",0,..
1f80: 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 ANGLEUNIT["degre
1f90: 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 e",0.01745329251
1fa0: 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20 43 53 99433]],.. CS
1fb0: 5b 65 6c 6c 69 70 73 6f 69 64 61 6c 2c 32 5d 2c [ellipsoidal,2],
1fc0: 0d 0a 20 20 20 20 20 20 20 20 41 58 49 53 5b 22 .. AXIS["
1fd0: 67 65 6f 64 65 74 69 63 20 6c 61 74 69 74 75 64 geodetic latitud
1fe0: 65 20 28 4c 61 74 29 22 2c 6e 6f 72 74 68 2c 0d e (Lat)",north,.
1ff0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 4f 52 44 . ORD
2000: 45 52 5b 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 ER[1],..
2010: 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 ANGLEUNIT["d
2020: 65 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 egree",0.0174532
2030: 39 32 35 31 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 925199433]],..
2040: 20 20 20 20 20 20 41 58 49 53 5b 22 67 65 6f 64 AXIS["geod
2050: 65 74 69 63 20 6c 6f 6e 67 69 74 75 64 65 20 28 etic longitude (
2060: 4c 6f 6e 29 22 2c 65 61 73 74 2c 0d 0a 20 20 20 Lon)",east,..
2070: 20 20 20 20 20 20 20 20 20 4f 52 44 45 52 5b 32 ORDER[2
2080: 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ],..
2090: 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 ANGLEUNIT["degre
20a0: 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 e",0.01745329251
20b0: 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20 41 52 99433]],.. AR
20c0: 45 41 5b 22 57 6f 72 6c 64 22 5d 2c 0d 0a 20 20 EA["World"],..
20d0: 20 20 42 42 4f 58 5b 2d 39 30 2c 2d 31 38 30 2c BBOX[-90,-180,
20e0: 39 30 2c 31 38 30 5d 2c 0d 0a 20 20 20 20 49 44 90,180],.. ID
20f0: 5b 22 45 50 53 47 22 2c 34 33 32 36 5d 5d 0d 0a ["EPSG",4326]]..
2100: 3c 2f 76 65 72 62 61 74 69 6d 3e 3c 2f 74 64 3e </verbatim></td>
2110: 0d 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f ..<td valign="to
2120: 70 22 3e 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 50 p"><verbatim>..P
2130: 52 4f 4a 43 52 53 5b 22 57 47 53 20 38 34 20 2f ROJCRS["WGS 84 /
2140: 20 55 54 4d 20 7a 6f 6e 65 20 33 32 4e 22 2c 0d UTM zone 32N",.
2150: 0a 20 20 20 20 42 41 53 45 47 45 4f 44 43 52 53 . BASEGEODCRS
2160: 5b 22 57 47 53 20 38 34 22 2c 0d 0a 20 20 20 20 ["WGS 84",..
2170: 20 20 20 20 44 41 54 55 4d 5b 22 57 6f 72 6c 64 DATUM["World
2180: 20 47 65 6f 64 65 74 69 63 20 53 79 73 74 65 6d Geodetic System
2190: 20 31 39 38 34 22 2c 0d 0a 20 20 20 20 20 20 20 1984",..
21a0: 20 20 20 20 20 45 4c 4c 49 50 53 4f 49 44 5b 22 ELLIPSOID["
21b0: 57 47 53 20 38 34 22 2c 36 33 37 38 31 33 37 2c WGS 84",6378137,
21c0: 32 39 38 2e 32 35 37 32 32 33 35 36 33 2c 0d 0a 298.257223563,..
21d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21e0: 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 74 72 LENGTHUNIT["metr
21f0: 65 22 2c 31 5d 5d 5d 2c 0d 0a 20 20 20 20 20 20 e",1]]],..
2200: 20 20 50 52 49 4d 45 4d 5b 22 47 72 65 65 6e 77 PRIMEM["Greenw
2210: 69 63 68 22 2c 30 2c 0d 0a 20 20 20 20 20 20 20 ich",0,..
2220: 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 ANGLEUNIT["
2230: 64 65 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 degree",0.017453
2240: 32 39 32 35 31 39 39 34 33 33 5d 5d 5d 2c 0d 0a 2925199433]]],..
2250: 20 20 20 20 43 4f 4e 56 45 52 53 49 4f 4e 5b 22 CONVERSION["
2260: 55 54 4d 20 7a 6f 6e 65 20 33 32 4e 22 2c 0d 0a UTM zone 32N",..
2270: 20 20 20 20 20 20 20 20 4d 45 54 48 4f 44 5b 22 METHOD["
2280: 54 72 61 6e 73 76 65 72 73 65 20 4d 65 72 63 61 Transverse Merca
2290: 74 6f 72 22 2c 0d 0a 20 20 20 20 20 20 20 20 20 tor",..
22a0: 20 20 20 49 44 5b 22 45 50 53 47 22 2c 39 38 30 ID["EPSG",980
22b0: 37 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 41 7]],.. PA
22c0: 52 41 4d 45 54 45 52 5b 22 4c 61 74 69 74 75 64 RAMETER["Latitud
22d0: 65 20 6f 66 20 6e 61 74 75 72 61 6c 20 6f 72 69 e of natural ori
22e0: 67 69 6e 22 2c 30 2c 0d 0a 20 20 20 20 20 20 20 gin",0,..
22f0: 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 ANGLEUNIT["
2300: 64 65 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 degree",0.017453
2310: 32 39 32 35 31 39 39 34 33 33 5d 2c 0d 0a 20 20 2925199433],..
2320: 20 20 20 20 20 20 20 20 20 20 49 44 5b 22 45 50 ID["EP
2330: 53 47 22 2c 38 38 30 31 5d 5d 2c 0d 0a 20 20 20 SG",8801]],..
2340: 20 20 20 20 20 50 41 52 41 4d 45 54 45 52 5b 22 PARAMETER["
2350: 4c 6f 6e 67 69 74 75 64 65 20 6f 66 20 6e 61 74 Longitude of nat
2360: 75 72 61 6c 20 6f 72 69 67 69 6e 22 2c 39 2c 0d ural origin",9,.
2370: 0a 20 20 20 20 20 20 20 20 20 20 20 20 41 4e 47 . ANG
2380: 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 65 22 2c LEUNIT["degree",
2390: 30 2e 30 31 37 34 35 33 32 39 32 35 31 39 39 34 0.01745329251994
23a0: 33 33 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 33],..
23b0: 20 20 49 44 5b 22 45 50 53 47 22 2c 38 38 30 32 ID["EPSG",8802
23c0: 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 41 52 ]],.. PAR
23d0: 41 4d 45 54 45 52 5b 22 53 63 61 6c 65 20 66 61 AMETER["Scale fa
23e0: 63 74 6f 72 20 61 74 20 6e 61 74 75 72 61 6c 20 ctor at natural
23f0: 6f 72 69 67 69 6e 22 2c 30 2e 39 39 39 36 2c 0d origin",0.9996,.
2400: 0a 20 20 20 20 20 20 20 20 20 20 20 20 53 43 41 . SCA
2410: 4c 45 55 4e 49 54 5b 22 75 6e 69 74 79 22 2c 31 LEUNIT["unity",1
2420: 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ],..
2430: 49 44 5b 22 45 50 53 47 22 2c 38 38 30 35 5d 5d ID["EPSG",8805]]
2440: 2c 0d 0a 20 20 20 20 20 20 20 20 50 41 52 41 4d ,.. PARAM
2450: 45 54 45 52 5b 22 46 61 6c 73 65 20 65 61 73 74 ETER["False east
2460: 69 6e 67 22 2c 35 30 30 30 30 30 2c 0d 0a 20 20 ing",500000,..
2470: 20 20 20 20 20 20 20 20 20 20 4c 45 4e 47 54 48 LENGTH
2480: 55 4e 49 54 5b 22 6d 65 74 72 65 22 2c 31 5d 2c UNIT["metre",1],
2490: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 44 .. ID
24a0: 5b 22 45 50 53 47 22 2c 38 38 30 36 5d 5d 2c 0d ["EPSG",8806]],.
24b0: 0a 20 20 20 20 20 20 20 20 50 41 52 41 4d 45 54 . PARAMET
24c0: 45 52 5b 22 46 61 6c 73 65 20 6e 6f 72 74 68 69 ER["False northi
24d0: 6e 67 22 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 ng",0,..
24e0: 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 LENGTHUNIT["
24f0: 6d 65 74 72 65 22 2c 31 5d 2c 0d 0a 20 20 20 20 metre",1],..
2500: 20 20 20 20 20 20 20 20 49 44 5b 22 45 50 53 47 ID["EPSG
2510: 22 2c 38 38 30 37 5d 5d 5d 2c 0d 0a 20 20 20 20 ",8807]]],..
2520: 43 53 5b 43 61 72 74 65 73 69 61 6e 2c 32 5d 2c CS[Cartesian,2],
2530: 0d 0a 20 20 20 20 20 20 20 20 41 58 49 53 5b 22 .. AXIS["
2540: 28 45 29 22 2c 65 61 73 74 2c 0d 0a 20 20 20 20 (E)",east,..
2550: 20 20 20 20 20 20 20 20 4f 52 44 45 52 5b 31 5d ORDER[1]
2560: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4c ,.. L
2570: 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 74 72 65 ENGTHUNIT["metre
2580: 22 2c 31 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 ",1]],..
2590: 41 58 49 53 5b 22 28 4e 29 22 2c 6e 6f 72 74 68 AXIS["(N)",north
25a0: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4f ,.. O
25b0: 52 44 45 52 5b 32 5d 2c 0d 0a 20 20 20 20 20 20 RDER[2],..
25c0: 20 20 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 LENGTHUNIT
25d0: 5b 22 6d 65 74 72 65 22 2c 31 5d 5d 2c 0d 0a 20 ["metre",1]],..
25e0: 20 20 20 41 52 45 41 5b 22 57 6f 72 6c 64 20 2d AREA["World -
25f0: 20 4e 20 68 65 6d 69 73 70 68 65 72 65 20 2d 20 N hemisphere -
2600: 36 c2 b0 45 20 74 6f 20 31 32 c2 b0 45 20 2d 20 6..E to 12..E -
2610: 62 79 20 63 6f 75 6e 74 72 79 22 5d 2c 0d 0a 20 by country"],..
2620: 20 20 20 42 42 4f 58 5b 30 2c 36 2c 38 34 2c 31 BBOX[0,6,84,1
2630: 32 5d 2c 0d 0a 20 20 20 20 49 44 5b 22 45 50 53 2],.. ID["EPS
2640: 47 22 2c 33 32 36 33 32 5d 5d 0d 0a 3c 2f 76 65 G",32632]]..</ve
2650: 72 62 61 74 69 6d 3e 3c 2f 74 64 3e 0d 0a 3c 2f rbatim></td>..</
2660: 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 0d 0a 3c tr>..</table>..<
2670: 62 72 3e 0d 0a 41 73 20 79 6f 75 20 63 61 6e 20 br>..As you can
2680: 65 61 73 69 6c 79 20 6e 6f 74 69 63 65 2c 20 74 easily notice, t
2690: 68 65 20 74 77 6f 20 6e 6f 74 61 74 69 6f 6e 73 he two notations
26a0: 20 61 72 65 20 70 72 6f 66 6f 75 6e 64 6c 79 20 are profoundly
26b0: 64 69 66 66 65 72 65 6e 74 2e 0d 0a 54 68 65 20 different...The
26c0: 6f 6c 64 20 3c 62 3e 70 72 6f 6a 2d 73 74 72 69 old <b>proj-stri
26d0: 6e 67 3c 2f 62 3e 20 6e 6f 74 61 74 69 6f 6e 20 ng</b> notation
26e0: 69 73 20 65 78 74 72 65 6d 65 6c 79 20 63 6f 6e is extremely con
26f0: 63 69 73 65 20 61 6e 64 20 72 6f 75 67 68 2c 20 cise and rough,
2700: 77 68 69 6c 73 74 20 74 68 65 20 6e 65 77 20 3c whilst the new <
2710: 62 3e 49 53 4f 2d 57 4b 54 3c 2f 62 3e 20 69 73 b>ISO-WKT</b> is
2720: 20 76 65 72 62 6f 73 65 20 62 75 74 20 65 78 68 verbose but exh
2730: 61 75 73 74 69 76 65 2c 20 64 65 74 61 69 6c 65 austive, detaile
2740: 64 20 61 6e 64 20 70 72 65 63 69 73 65 2e 3c 62 d and precise.<b
2750: 72 3e 0d 0a 54 68 65 72 65 20 69 73 20 6e 6f 20 r>..There is no
2760: 70 6f 73 73 69 62 6c 65 20 6d 61 74 63 68 3a 20 possible match:
2770: 49 53 4f 2d 57 4b 54 20 69 73 20 63 6c 65 61 72 ISO-WKT is clear
2780: 6c 79 20 73 75 70 65 72 69 6f 72 20 61 6e 64 20 ly superior and
2790: 6d 6f 72 65 20 73 6f 70 68 69 73 74 69 63 61 74 more sophisticat
27a0: 65 64 20 75 6e 64 65 72 20 61 6e 79 20 70 6f 73 ed under any pos
27b0: 73 69 62 6c 65 20 61 73 70 65 63 74 2e 3c 62 72 sible aspect.<br
27c0: 3e 0d 0a 4e 6f 74 20 61 74 20 61 6c 6c 20 73 75 >..Not at all su
27d0: 72 70 72 69 73 69 6e 67 6c 79 2c 20 63 6f 6f 72 rprisingly, coor
27e0: 64 69 6e 61 74 65 20 74 72 61 6e 73 66 6f 72 6d dinate transform
27f0: 61 74 69 6f 6e 73 20 62 61 73 65 64 20 6f 6e 20 ations based on
2800: 49 53 4f 2d 57 4b 54 20 64 65 66 69 6e 69 74 69 ISO-WKT definiti
2810: 6f 6e 73 20 28 69 6e 73 74 65 61 64 20 6f 66 20 ons (instead of
2820: 70 72 6f 6a 2d 73 74 72 69 6e 67 73 29 20 61 72 proj-strings) ar
2830: 65 20 75 73 75 61 6c 6c 79 20 65 78 70 65 63 74 e usually expect
2840: 65 64 20 74 6f 20 62 65 20 6d 6f 72 65 20 61 63 ed to be more ac
2850: 63 75 72 61 74 65 2e 3c 62 72 3e 3c 62 72 3e 0d curate.<br><br>.
2860: 0a 41 6e 64 20 74 68 61 74 27 73 20 6e 6f 74 20 .And that's not
2870: 61 6c 6c 3b 20 74 68 65 20 6f 6c 64 20 3c 62 3e all; the old <b>
2880: 70 72 6f 6a 2d 73 74 72 69 6e 67 73 3c 2f 62 3e proj-strings</b>
2890: 20 77 65 72 65 6e 27 74 20 66 6f 72 6d 61 6c 6c weren't formall
28a0: 79 20 64 65 66 69 6e 65 64 20 62 79 20 61 6e 79 y defined by any
28b0: 20 73 74 61 6e 64 61 72 64 2c 20 61 6e 64 20 6f standard, and o
28c0: 6e 6c 79 20 50 52 4f 4a 2c 20 47 44 41 4c 20 61 nly PROJ, GDAL a
28d0: 6e 64 20 66 65 77 20 6f 74 68 65 72 20 46 4c 4f nd few other FLO
28e0: 53 53 20 2f 20 47 46 4f 53 53 20 69 6d 70 6c 65 SS / GFOSS imple
28f0: 6d 65 6e 74 61 74 69 6f 6e 73 20 63 6f 75 6c 64 mentations could
2900: 20 62 65 20 65 78 70 65 63 74 65 64 20 74 6f 20 be expected to
2910: 75 6e 64 65 72 73 74 61 6e 64 20 74 68 65 6d 2e understand them.
2920: 3c 62 72 3e 0d 0a 41 74 20 74 68 65 20 6f 70 70 <br>..At the opp
2930: 6f 73 69 74 65 2c 20 74 68 65 20 6e 65 77 20 3c osite, the new <
2940: 62 3e 49 53 4f 2d 57 4b 54 3c 2f 62 3e 20 69 73 b>ISO-WKT</b> is
2950: 20 66 6f 72 6d 61 6c 6c 79 20 64 65 66 69 6e 65 formally define
2960: 64 20 62 79 20 61 6e 20 69 6e 74 65 72 6e 61 74 d by an internat
2970: 69 6f 6e 61 6c 20 73 74 61 6e 64 61 72 64 2c 20 ional standard,
2980: 61 6e 64 20 61 6c 6d 6f 73 74 20 61 6c 6c 20 66 and almost all f
2990: 72 65 65 20 61 6e 64 20 70 72 6f 70 72 69 65 74 ree and propriet
29a0: 61 72 79 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 ary implementati
29b0: 6f 6e 73 20 61 72 65 20 65 78 70 65 63 74 65 64 ons are expected
29c0: 20 74 6f 20 73 75 70 70 6f 72 74 20 69 74 2e 3c to support it.<
29d0: 62 72 3e 0d 0a 54 68 69 73 20 69 73 20 61 20 76 br>..This is a v
29e0: 65 72 79 20 72 65 6c 65 76 61 6e 74 20 63 68 61 ery relevant cha
29f0: 6e 67 65 20 74 68 61 74 20 65 6e 73 75 72 65 73 nge that ensures
2a00: 20 61 20 72 6f 62 75 73 74 20 63 6f 6d 70 61 74 a robust compat
2a10: 69 62 69 6c 69 74 79 20 62 65 74 77 65 65 6e 20 ibility between
2a20: 64 69 66 66 65 72 65 6e 74 20 61 70 70 6c 69 63 different applic
2a30: 61 74 69 6f 6e 73 2e 3c 62 72 3e 3c 62 72 3e 0d ations.<br><br>.
2a40: 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 .<table cellspac
2a50: 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 ing="8" cellpadd
2a60: 69 6e 67 3d 22 31 36 22 20 62 67 63 6f 6c 6f 72 ing="16" bgcolor
2a70: 3d 22 23 66 66 66 66 65 39 22 3e 0d 0a 3c 74 72 ="#ffffe9">..<tr
2a80: 3e 3c 74 64 3e 0d 0a 3c 62 3e 3c 75 3e 49 6d 70 ><td>..<b><u>Imp
2a90: 6f 72 74 61 6e 74 20 6e 6f 74 69 63 65 3c 2f 75 ortant notice</u
2aa0: 3e 3c 2f 62 3e 3a 20 74 68 65 72 65 20 61 72 65 ></b>: there are
2ab0: 20 73 65 76 65 72 61 6c 20 64 69 61 6c 65 63 74 several dialect
2ac0: 73 20 69 6e 20 74 68 65 20 57 4b 54 20 6e 6f 74 s in the WKT not
2ad0: 61 74 69 6f 6e 20 64 65 73 63 72 69 62 69 6e 67 ation describing
2ae0: 20 43 52 53 65 73 2e 3c 62 72 3e 0d 0a 41 6c 6c CRSes.<br>..All
2af0: 20 74 68 65 6d 20 73 68 61 72 65 20 74 68 65 20 them share the
2b00: 73 61 6d 65 20 63 6f 6d 6d 6f 6e 20 63 6f 72 65 same common core
2b10: 20 61 6e 64 20 6d 61 69 6e 6c 79 20 64 69 66 66 and mainly diff
2b20: 65 72 20 69 6e 20 66 65 77 20 6d 69 6e 6f 72 20 er in few minor
2b30: 64 65 74 61 69 6c 73 2e 3c 62 72 3e 0d 0a 50 52 details.<br>..PR
2b40: 4f 4a 2e 36 20 63 61 6e 20 75 6e 64 65 72 73 74 OJ.6 can underst
2b50: 61 6e 64 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e and the followin
2b60: 67 20 64 69 61 6c 65 63 74 73 3a 0d 0a 3c 6f 6c g dialects:..<ol
2b70: 3e 0d 0a 3c 6c 69 3e 3c 62 3e 45 53 52 49 20 57 >..<li><b>ESRI W
2b80: 4b 54 3c 2f 62 3e 3a 20 61 20 64 69 61 6c 65 63 KT</b>: a dialec
2b90: 74 20 77 69 64 65 6c 79 20 61 64 6f 70 74 65 64 t widely adopted
2ba0: 20 62 79 20 45 53 52 49 20 70 72 6f 70 72 69 65 by ESRI proprie
2bb0: 74 61 72 79 20 73 6f 66 74 77 61 72 65 2e 3c 2f tary software.</
2bc0: 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 47 44 41 4c li>..<li><b>GDAL
2bd0: 20 57 4b 54 31 3c 2f 62 3e 3a 20 61 20 64 69 61 WKT1</b>: a dia
2be0: 6c 65 63 74 20 68 69 73 74 6f 72 69 63 61 6c 6c lect historicall
2bf0: 79 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 74 y supported by t
2c00: 68 65 20 6f 70 65 6e 20 73 6f 75 72 63 65 20 47 he open source G
2c10: 44 41 4c 20 6c 69 62 72 61 72 79 2e 3c 2f 6c 69 DAL library.</li
2c20: 3e 0d 0a 3c 6c 69 3e 3c 62 3e 57 4b 54 32 3a 32 >..<li><b>WKT2:2
2c30: 30 31 35 3c 2f 62 3e 3a 20 61 73 20 64 65 66 69 015</b>: as defi
2c40: 6e 65 64 20 62 79 20 3c 62 3e 49 53 4f 20 31 39 ned by <b>ISO 19
2c50: 31 36 32 3a 32 30 31 35 3c 2f 62 3e 20 73 74 61 162:2015</b> sta
2c60: 6e 64 61 72 64 20 73 70 65 63 69 66 69 63 61 74 ndard specificat
2c70: 69 6f 6e 20 28 6e 6f 77 20 73 75 70 65 72 73 65 ion (now superse
2c80: 64 65 64 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e ded).</li>..<li>
2c90: 3c 62 3e 57 4b 54 32 3a 32 30 31 38 3c 2f 62 3e <b>WKT2:2018</b>
2ca0: 3a 20 61 73 20 64 65 66 69 6e 65 64 20 62 79 20 : as defined by
2cb0: 74 68 65 20 6d 6f 72 65 20 72 65 63 65 6e 74 20 the more recent
2cc0: 3c 62 3e 49 53 4f 20 31 39 31 36 32 3a 32 30 31 <b>ISO 19162:201
2cd0: 38 3c 2f 62 3e 20 73 74 61 6e 64 61 72 64 20 73 8</b> standard s
2ce0: 70 65 63 69 66 69 63 61 74 69 6f 6e 20 2e 3c 2f pecification .</
2cf0: 6c 69 3e 0d 0a 3c 2f 6f 6c 3e 0d 0a 3c 2f 74 64 li>..</ol>..</td
2d00: 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e ></tr>..</table>
2d10: 3c 62 72 3e 0d 0a 3c 68 33 3e 54 68 65 20 70 72 <br>..<h3>The pr
2d20: 69 76 61 74 65 20 53 51 4c 69 74 65 20 64 61 74 ivate SQLite dat
2d30: 61 62 61 73 65 20 73 75 70 70 6f 72 74 69 6e 67 abase supporting
2d40: 20 50 52 4f 4a 2e 36 3c 2f 68 33 3e 0d 0a 53 74 PROJ.6</h3>..St
2d50: 61 72 74 69 6e 67 20 73 69 6e 63 65 20 3c 62 3e arting since <b>
2d60: 50 52 4f 4a 2e 36 3c 2f 62 3e 20 74 68 65 20 50 PROJ.6</b> the P
2d70: 52 4f 4a 20 6c 69 62 72 61 72 79 20 69 73 20 73 ROJ library is s
2d80: 75 70 70 6f 72 74 65 64 20 62 79 20 61 20 70 72 upported by a pr
2d90: 69 76 61 74 65 20 53 51 4c 69 74 65 20 64 61 74 ivate SQLite dat
2da0: 61 62 61 73 65 20 63 6f 6e 74 61 69 6e 69 6e 67 abase containing
2db0: 20 61 6c 6c 20 64 65 66 69 6e 69 74 69 6f 6e 73 all definitions
2dc0: 20 61 62 6f 75 74 20 73 75 70 70 6f 72 74 65 64 about supported
2dd0: 20 43 52 53 65 73 2c 20 45 6c 6c 69 70 73 6f 69 CRSes, Ellipsoi
2de0: 64 73 2c 20 50 72 69 6d 65 20 4d 65 72 69 64 69 ds, Prime Meridi
2df0: 61 6e 73 2c 20 55 6e 69 74 73 20 6f 66 20 4d 65 ans, Units of Me
2e00: 61 73 75 72 65 2c 20 43 6f 6e 76 65 72 73 69 6f asure, Conversio
2e10: 6e 73 2c 20 54 72 61 6e 73 66 6f 72 6d 61 74 69 ns, Transformati
2e20: 6f 6e 73 20 61 6e 64 20 61 6c 69 6b 65 2e 3c 62 ons and alike.<b
2e30: 72 3e 0d 0a 3c 62 3e 3c 75 3e 4e 6f 74 65 3c 2f r>..<b><u>Note</
2e40: 75 3e 3c 2f 62 3e 3a 20 6d 61 6e 79 20 6f 66 20 u></b>: many of
2e50: 74 68 65 20 6e 65 77 20 61 64 76 61 6e 63 65 64 the new advanced
2e60: 20 50 52 4f 4a 2e 36 20 66 65 61 74 75 72 65 73 PROJ.6 features
2e70: 20 77 69 6c 6c 20 66 61 69 6c 20 69 66 20 73 75 will fail if su
2e80: 63 68 20 64 61 74 61 62 61 73 65 20 69 73 20 6e ch database is n
2e90: 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 61 74 20 ot available at
2ea0: 72 75 6e 20 74 69 6d 65 2e 0d 0a 3c 68 33 3e 44 run time...<h3>D
2eb0: 69 72 65 63 74 20 74 72 61 6e 73 66 6f 72 6d 61 irect transforma
2ec0: 74 69 6f 6e 73 20 66 72 6f 6d 20 43 52 53 20 74 tions from CRS t
2ed0: 6f 20 43 52 53 3c 2f 68 33 3e 0d 0a 44 69 66 66 o CRS</h3>..Diff
2ee0: 65 72 65 6e 74 6c 79 20 66 72 6f 6d 20 61 6c 6c erently from all
2ef0: 20 70 72 65 76 69 6f 75 73 20 76 65 72 73 69 6f previous versio
2f00: 6e 73 2c 20 50 52 4f 4a 2e 36 20 63 61 6e 20 6e ns, PROJ.6 can n
2f10: 6f 77 20 61 70 70 6c 79 20 61 6e 79 20 74 72 61 ow apply any tra
2f20: 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d nsformation from
2f30: 20 61 20 43 52 53 20 74 6f 20 61 6e 6f 74 68 65 a CRS to anothe
2f40: 72 20 77 69 74 68 6f 75 74 20 72 65 71 75 69 72 r without requir
2f50: 69 6e 67 20 74 6f 20 73 70 65 63 69 66 79 20 61 ing to specify a
2f60: 6e 79 20 3c 62 3e 3c 69 3e 70 72 6f 6a 2d 73 74 ny <b><i>proj-st
2f70: 72 69 6e 67 3c 2f 69 3e 3c 2f 62 3e 20 6f 72 20 ring</i></b> or
2f80: 3c 62 3e 3c 69 3e 57 4b 54 20 65 78 70 72 65 73 <b><i>WKT expres
2f90: 73 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 71 75 61 sion</i></b> qua
2fa0: 6c 69 66 79 69 6e 67 20 65 61 63 68 20 43 52 53 lifying each CRS
2fb0: 2e 3c 62 72 3e 0d 0a 54 68 69 73 20 69 73 20 62 .<br>..This is b
2fc0: 65 63 61 75 73 65 20 50 52 4f 4a 2e 36 20 69 73 ecause PROJ.6 is
2fd0: 20 6e 6f 77 20 63 61 70 61 62 6c 65 20 74 6f 20 now capable to
2fe0: 72 65 74 72 69 65 76 65 20 61 6e 79 20 43 52 53 retrieve any CRS
2ff0: 20 64 65 66 69 6e 69 74 69 6f 6e 20 64 69 72 65 definition dire
3000: 63 74 6c 79 0d 0a 66 72 6f 6d 20 69 74 73 20 6f ctly..from its o
3010: 77 6e 20 70 72 69 76 61 74 65 20 53 51 4c 69 74 wn private SQLit
3020: 65 20 64 61 74 61 62 61 73 65 2c 20 61 6e 64 20 e database, and
3030: 63 6f 6e 73 65 71 75 65 6e 74 6c 79 20 65 61 63 consequently eac
3040: 68 20 43 52 53 20 63 61 6e 20 62 65 20 66 75 6c h CRS can be ful
3050: 6c 79 20 69 64 65 6e 74 69 66 69 65 64 20 62 79 ly identified by
3060: 20 73 69 6d 70 6c 79 20 73 70 65 63 69 66 79 69 simply specifyi
3070: 6e 67 20 69 74 73 20 73 79 6d 62 6f 6c 69 63 20 ng its symbolic
3080: 6e 61 6d 65 2c 20 61 73 20 69 6e 3a 0d 0a 3c 75 name, as in:..<u
3090: 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 45 50 53 47 3a l>..<li><b>EPSG:
30a0: 34 33 32 36 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 4326</b></li>..<
30b0: 6c 69 3e 6f 72 20 61 6c 74 65 72 6e 61 74 69 76 li>or alternativ
30c0: 65 6c 79 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 ely</li>..<li><b
30d0: 3e 75 72 6e 3a 6f 67 63 3a 64 65 66 3a 63 72 73 >urn:ogc:def:crs
30e0: 3a 45 50 53 47 3a 3a 34 33 32 36 3c 2f 62 3e 3c :EPSG::4326</b><
30f0: 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 68 33 /li>..</ul>..<h3
3100: 3e 53 75 70 70 6f 72 74 69 6e 67 20 73 70 65 63 >Supporting spec
3110: 69 66 69 63 20 61 72 65 61 73 20 6f 66 20 75 73 ific areas of us
3120: 65 3c 2f 68 33 3e 0d 0a 3c 74 61 62 6c 65 20 63 e</h3>..<table c
3130: 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 ellspacing="8" c
3140: 65 6c 6c 70 61 64 64 69 6e 67 3d 22 38 22 20 62 ellpadding="8" b
3150: 67 63 6f 6c 6f 72 3d 22 23 65 38 66 66 65 38 22 gcolor="#e8ffe8"
3160: 20 62 6f 72 64 65 72 3d 22 31 22 3e 0d 0a 3c 74 border="1">..<t
3170: 72 3e 3c 74 64 3e 0d 0a 50 52 4f 4a 2e 36 20 69 r><td>..PROJ.6 i
3180: 73 20 6e 6f 77 20 61 62 6c 65 20 74 6f 20 6d 61 s now able to ma
3190: 6b 65 20 61 20 64 69 73 74 69 6e 63 74 69 6f 6e ke a distinction
31a0: 20 62 65 74 77 65 65 6e 20 64 69 66 66 65 72 65 between differe
31b0: 6e 74 20 3c 62 3e 61 72 65 61 73 20 6f 66 20 75 nt <b>areas of u
31c0: 73 65 3c 2f 62 3e 20 77 69 74 68 69 6e 20 61 20 se</b> within a
31d0: 43 52 53 2c 20 61 6e 64 20 63 61 6e 20 65 76 65 CRS, and can eve
31e0: 6e 74 75 61 6c 6c 79 20 61 70 70 6c 79 20 74 68 ntually apply th
31f0: 65 20 6d 6f 73 74 20 61 70 70 72 6f 70 72 69 61 e most appropria
3200: 74 65 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f te transformatio
3210: 6e 20 77 68 65 6e 20 74 68 65 20 69 6e 74 65 6e n when the inten
3220: 64 65 64 20 61 72 65 61 2d 6f 66 2d 75 73 65 20 ded area-of-use
3230: 69 73 20 65 78 70 6c 69 63 69 74 6c 79 20 73 70 is explicitly sp
3240: 65 63 69 66 69 65 64 2c 20 74 68 75 73 20 6c 65 ecified, thus le
3250: 61 64 69 6e 67 20 74 6f 20 6d 6f 72 65 20 70 72 ading to more pr
3260: 65 63 69 73 65 20 72 65 73 75 6c 74 73 2e 3c 62 ecise results.<b
3270: 72 3e 3c 62 72 3e 0d 0a 54 68 65 20 73 69 64 65 r><br>..The side
3280: 20 66 69 67 75 72 65 20 73 68 6f 77 73 20 74 68 figure shows th
3290: 65 20 73 69 74 75 61 74 69 6f 6e 20 66 6f 72 20 e situation for
32a0: 74 68 65 20 49 74 61 6c 69 61 6e 20 70 65 6e 69 the Italian peni
32b0: 6e 73 75 6c 61 2e 3c 62 72 3e 0d 0a 41 73 20 79 nsula.<br>..As y
32c0: 6f 75 20 63 61 6e 20 6e 6f 74 69 63 65 20 74 68 ou can notice th
32d0: 65 72 65 20 61 72 65 20 74 77 6f 20 6d 61 69 6e ere are two main
32e0: 20 61 72 65 61 73 20 28 3c 62 3e 3c 69 3e 45 61 areas (<b><i>Ea
32f0: 73 74 3c 2f 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c st</i></b> and <
3300: 62 3e 3c 69 3e 57 65 73 74 3c 2f 69 3e 3c 2f 62 b><i>West</i></b
3310: 3e 20 6f 66 20 6c 6f 6e 67 69 74 75 64 65 20 3c > of longitude <
3320: 62 3e 31 32 45 3c 2f 62 3e 29 2c 20 62 75 74 20 b>12E</b>), but
3330: 74 68 65 72 65 20 61 72 65 20 73 65 76 65 72 61 there are severa
3340: 6c 20 73 6d 61 6c 6c 65 72 20 61 72 65 61 73 20 l smaller areas
3350: 63 6f 76 65 72 69 6e 67 20 73 70 65 63 69 66 69 covering specifi
3360: 63 20 72 65 67 69 6f 6e 73 2e 0d 0a 3c 75 6c 3e c regions...<ul>
3370: 0d 0a 3c 6c 69 3e 54 68 65 20 74 77 6f 20 6d 61 ..<li>The two ma
3380: 69 6e 20 61 72 65 61 73 20 63 6f 72 72 65 73 70 in areas corresp
3390: 6f 6e 64 20 74 6f 20 3c 62 3e 45 50 53 47 3a 33 ond to <b>EPSG:3
33a0: 30 30 33 20 3c 69 3e 4d 6f 6e 74 65 20 4d 61 72 003 <i>Monte Mar
33b0: 69 6f 20 2f 20 49 74 61 6c 79 20 7a 6f 6e 65 20 io / Italy zone
33c0: 31 3c 2f 69 3e 3c 2f 62 3e 20 61 6e 64 20 3c 62 1</i></b> and <b
33d0: 3e 45 50 53 47 3a 33 30 30 34 20 3c 69 3e 4d 6f >EPSG:3004 <i>Mo
33e0: 6e 74 65 20 4d 61 72 69 6f 20 2f 20 49 74 61 6c nte Mario / Ital
33f0: 79 20 7a 6f 6e 65 20 32 3c 2f 69 3e 3c 2f 62 3e y zone 2</i></b>
3400: 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 54 68 65 20 .</li>..<li>The
3410: 73 6d 61 6c 6c 65 73 74 20 61 72 65 61 73 20 63 smallest areas c
3420: 6f 72 72 65 73 70 6f 6e 64 20 74 6f 20 74 68 65 orrespond to the
3430: 20 6d 6f 72 65 20 73 70 65 63 69 66 69 63 20 3c more specific <
3440: 62 3e 3c 69 3e 61 72 65 61 73 20 6f 66 20 75 73 b><i>areas of us
3450: 65 3c 2f 69 3e 3c 2f 62 3e 20 6e 6f 77 20 73 75 e</i></b> now su
3460: 70 70 6f 72 74 65 64 20 62 79 20 50 52 4f 4a 2e pported by PROJ.
3470: 36 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 6</li>..</ul><br
3480: 3e 0d 0a 49 66 20 79 6f 75 72 20 73 70 65 63 69 >..If your speci
3490: 66 69 63 20 61 72 65 61 20 6f 66 20 69 6e 74 65 fic area of inte
34a0: 72 65 73 74 20 69 73 20 63 6f 6e 74 61 69 6e 65 rest is containe
34b0: 64 20 77 69 74 68 69 6e 20 6f 6e 65 20 6f 66 20 d within one of
34c0: 73 75 63 68 20 73 75 62 2d 72 65 67 69 6f 6e 73 such sub-regions
34d0: 20 79 6f 75 20 63 61 6e 20 75 73 65 66 75 6c 6c you can usefull
34e0: 79 20 69 6e 66 6f 72 6d 20 50 52 4f 4a 2e 36 20 y inform PROJ.6
34f0: 61 62 6f 75 74 20 74 68 65 20 69 6e 74 65 6e 64 about the intend
3500: 65 64 20 42 42 4f 58 2c 20 61 6e 64 20 74 68 65 ed BBOX, and the
3510: 6e 20 50 52 4f 4a 2e 36 20 77 69 6c 6c 20 61 74 n PROJ.6 will at
3520: 74 65 6d 70 74 20 74 6f 20 75 73 65 20 74 68 65 tempt to use the
3530: 20 6d 6f 73 74 20 73 70 65 63 69 66 69 63 20 74 most specific t
3540: 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 61 ransformation pa
3550: 72 61 6d 65 74 65 72 73 20 61 76 61 69 6c 61 62 rameters availab
3560: 6c 65 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 57 65 27 le.<br><br>..We'
3570: 6c 6c 20 65 78 61 6d 69 6e 65 20 69 6e 20 6d 6f ll examine in mo
3580: 72 65 20 64 65 70 74 68 20 74 68 69 73 20 74 6f re depth this to
3590: 70 69 63 20 6f 6e 20 66 6f 6c 6c 6f 77 69 6e 67 pic on following
35a0: 20 73 65 63 74 69 6f 6e 73 2e 20 0d 0a 3c 2f 74 sections. ..</t
35b0: 64 3e 0d 0a 3c 74 64 3e 0d 0a 3c 69 6d 67 20 73 d>..<td>..<img s
35c0: 72 63 3d 22 68 74 74 70 73 3a 2f 2f 77 77 77 2e rc="https://www.
35d0: 67 61 69 61 2d 67 69 73 2e 69 74 2f 67 61 69 61 gaia-gis.it/gaia
35e0: 2d 73 69 6e 73 2f 70 72 6f 6a 36 70 69 63 73 2f -sins/proj6pics/
35f0: 69 74 61 6c 79 2d 61 72 65 61 73 2d 6f 66 2d 75 italy-areas-of-u
3600: 73 65 2e 70 6e 67 22 20 61 6c 74 3d 22 69 74 61 se.png" alt="ita
3610: 6c 79 20 61 72 65 61 73 20 6f 66 20 75 73 65 22 ly areas of use"
3620: 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c >..</td></tr>..<
3630: 2f 74 61 62 6c 65 3e 0d 0a 3c 62 72 3e 3c 62 72 /table>..<br><br
3640: 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 >..<table cellsp
3650: 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 acing="8" cellpa
3660: 64 64 69 6e 67 3d 22 31 36 22 20 62 67 63 6f 6c dding="16" bgcol
3670: 6f 72 3d 22 23 66 66 66 66 65 39 22 3e 0d 0a 3c or="#ffffe9">..<
3680: 74 72 3e 3c 74 64 3e 0d 0a 3c 68 33 3e 43 6f 6e tr><td>..<h3>Con
3690: 63 65 70 74 73 20 74 6f 20 6b 65 65 70 20 77 65 cepts to keep we
36a0: 6c 6c 20 69 6e 20 6d 69 6e 64 3c 2f 68 33 3e 0d ll in mind</h3>.
36b0: 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 66 6f 72 67 65 .<ul>..<li>forge
36c0: 74 20 74 68 65 20 6f 6c 64 20 70 72 6f 6a 2d 73 t the old proj-s
36d0: 74 72 69 6e 67 73 3b 20 74 68 65 79 20 61 72 65 trings; they are
36e0: 20 6e 6f 20 6c 6f 6e 67 65 72 20 74 68 65 20 62 no longer the b
36f0: 65 73 74 20 77 61 79 20 66 6f 72 20 74 61 6b 69 est way for taki
3700: 6e 67 20 66 75 6c 6c 20 70 72 6f 66 69 74 20 66 ng full profit f
3710: 72 6f 6d 20 50 52 4f 4a 2e 36 3c 2f 6c 69 3e 0d rom PROJ.6</li>.
3720: 0a 3c 6c 69 3e 74 68 65 20 62 65 73 74 20 77 61 .<li>the best wa
3730: 79 20 74 6f 20 6d 61 6b 65 20 74 68 65 20 6d 6f y to make the mo
3740: 73 74 20 6f 66 20 50 52 4f 4a 2e 36 20 63 61 70 st of PROJ.6 cap
3750: 61 62 69 6c 69 74 69 65 73 20 69 73 20 62 79 20 abilities is by
3760: 6c 65 61 76 69 6e 67 20 74 68 65 20 6c 69 62 72 leaving the libr
3770: 61 72 79 20 66 75 6c 6c 79 20 66 72 65 65 20 74 ary fully free t
3780: 6f 20 63 68 6f 6f 73 65 20 74 68 65 20 62 65 73 o choose the bes
3790: 74 20 70 6f 73 73 69 62 6c 65 20 74 72 61 6e 73 t possible trans
37a0: 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 74 formation from t
37b0: 68 65 20 6f 72 69 67 69 6e 20 61 6e 64 20 74 68 he origin and th
37c0: 65 20 64 65 73 74 69 6e 61 74 69 6f 6e 20 43 52 e destination CR
37d0: 53 65 73 2e 3c 62 72 3e 0d 0a 62 75 74 20 74 68 Ses.<br>..but th
37e0: 69 73 20 73 74 72 69 63 74 6c 79 20 72 65 71 75 is strictly requ
37f0: 69 72 65 73 20 74 68 61 74 20 74 68 65 20 6c 69 ires that the li
3800: 62 72 61 72 79 20 77 69 6c 6c 20 62 65 20 62 61 brary will be ba
3810: 63 6b 65 64 20 75 70 20 62 79 20 69 74 73 20 6f cked up by its o
3820: 77 6e 20 70 72 69 76 61 74 65 20 64 61 74 61 62 wn private datab
3830: 61 73 65 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e ase.</li>..</ul>
3840: 0d 0a 3c 68 33 3e 41 64 64 69 74 69 6f 6e 61 6c ..<h3>Additional
3850: 20 63 6f 6e 63 65 70 74 3c 2f 68 33 3e 0d 0a 54 concept</h3>..T
3860: 68 65 20 74 72 61 64 69 74 69 6f 6e 61 6c 20 3c he traditional <
3870: 62 3e 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 b>spatial_ref_sy
3880: 73 3c 2f 62 3e 20 74 61 62 6c 65 20 63 6f 6e 74 s</b> table cont
3890: 61 69 6e 65 64 20 77 69 74 68 69 6e 20 61 6e 79 ained within any
38a0: 20 53 70 61 74 69 61 4c 69 74 65 20 44 42 20 6e SpatiaLite DB n
38b0: 6f 74 69 63 65 61 62 6c 79 20 63 68 61 6e 67 65 oticeably change
38c0: 73 20 69 74 73 20 69 6e 74 65 6e 64 65 64 20 73 s its intended s
38d0: 63 6f 70 65 20 69 6e 20 50 52 4f 4a 2e 36 3a 0d cope in PROJ.6:.
38e0: 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 73 72 .<ul>..<li><b>sr
38f0: 69 64 3c 2f 62 3e 2c 20 3c 62 3e 61 75 74 68 5f id</b>, <b>auth_
3900: 6e 61 6d 65 3c 2f 62 3e 2c 20 3c 62 3e 61 75 74 name</b>, <b>aut
3910: 68 5f 73 72 69 64 3c 2f 62 3e 20 61 6e 64 20 3c h_srid</b> and <
3920: 62 3e 72 65 66 5f 73 79 73 5f 6e 61 6d 65 3c 2f b>ref_sys_name</
3930: 62 3e 20 63 6f 6c 75 6d 6e 73 20 61 72 65 20 73 b> columns are s
3940: 74 69 6c 6c 20 72 65 71 75 69 72 65 64 20 69 6e till required in
3950: 20 6f 72 64 65 72 20 74 6f 20 64 65 66 69 6e 65 order to define
3960: 20 61 6c 6c 20 73 75 70 70 6f 72 74 65 64 20 43 all supported C
3970: 52 53 65 73 20 61 6e 64 20 74 6f 20 73 75 70 70 RSes and to supp
3980: 6f 72 74 20 0d 0a 72 65 6c 61 74 69 6f 6e 73 20 ort ..relations
3990: 62 61 73 65 64 20 6f 6e 20 50 72 69 6d 61 72 79 based on Primary
39a0: 20 61 6e 64 20 46 6f 72 65 69 67 6e 20 4b 65 79 and Foreign Key
39b0: 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 62 75 74 s.</li>..<li>but
39c0: 20 63 6f 6c 75 6d 6e 73 20 3c 62 3e 70 72 6f 6a columns <b>proj
39d0: 34 74 65 78 74 3c 2f 62 3e 20 61 6e 64 20 3c 62 4text</b> and <b
39e0: 3e 73 72 74 65 78 74 3c 2f 62 3e 20 61 72 65 20 >srtext</b> are
39f0: 6e 6f 77 20 70 72 61 63 74 69 63 61 6c 6c 79 20 now practically
3a00: 75 73 65 6c 65 73 73 2c 20 62 65 63 61 75 73 65 useless, because
3a10: 20 50 52 4f 4a 2e 36 20 69 73 20 6e 6f 77 20 63 PROJ.6 is now c
3a20: 61 70 61 62 6c 65 20 74 6f 20 66 75 6c 6c 79 20 apable to fully
3a30: 64 65 66 69 6e 65 20 61 6e 79 20 43 52 53 20 62 define any CRS b
3a40: 79 20 64 69 72 65 63 74 6c 79 20 71 75 65 72 79 y directly query
3a50: 69 6e 67 20 69 74 73 20 6f 77 6e 20 70 72 69 76 ing its own priv
3a60: 61 74 65 20 64 61 74 61 62 61 73 65 2e 3c 2f 6c ate database.</l
3a70: 69 3e 0d 0a 3c 6c 69 3e 3c 69 3e 3c 75 3e 46 75 i>..<li><i><u>Fu
3a80: 74 75 72 65 20 46 6f 72 65 63 61 73 74 73 3c 2f ture Forecasts</
3a90: 75 3e 3c 2f 69 3e 3a 20 62 6f 74 68 20 3c 62 3e u></i>: both <b>
3aa0: 70 72 6f 6a 34 74 65 78 74 3c 2f 62 3e 20 61 6e proj4text</b> an
3ab0: 64 20 3c 62 3e 73 72 74 65 78 74 3c 2f 62 3e 20 d <b>srtext</b>
3ac0: 77 69 6c 6c 20 62 65 20 70 72 6f 62 61 62 6c 79 will be probably
3ad0: 20 72 65 6d 6f 76 65 64 20 69 6e 20 73 6f 6d 65 removed in some
3ae0: 20 66 75 74 75 72 65 20 76 65 72 73 69 6f 6e 20 future version
3af0: 6f 66 20 53 70 61 74 69 61 4c 69 74 65 2e 3c 62 of SpatiaLite.<b
3b00: 72 3e 0d 0a 46 6f 72 20 6e 6f 77 20 74 68 65 79 r>..For now they
3b10: 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20 62 65 20 continue to be
3b20: 73 75 70 70 6f 72 74 65 64 20 6d 61 69 6e 6c 79 supported mainly
3b30: 20 74 6f 20 74 68 65 20 62 65 6e 65 66 69 74 20 to the benefit
3b40: 6f 66 20 70 72 65 76 69 6f 75 73 20 76 65 72 73 of previous vers
3b50: 69 6f 6e 73 20 6f 66 20 53 70 61 74 69 61 4c 69 ions of SpatiaLi
3b60: 74 65 20 62 65 69 6e 67 20 62 61 73 65 64 20 6f te being based o
3b70: 6e 20 74 68 65 20 6e 6f 77 20 73 75 70 65 72 73 n the now supers
3b80: 65 64 65 64 20 50 52 4f 4a 2e 34 3c 2f 6c 69 3e eded PROJ.4</li>
3b90: 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 2f 74 64 3e 3c 2f ..</ul>..</td></
3ba0: 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 0d 0a 3c tr>..</table>..<
3bb0: 68 33 3e 54 72 61 6e 73 66 6f 72 6d 61 74 69 6f h3>Transformatio
3bc0: 6e 20 70 69 70 65 6c 69 6e 65 73 3c 2f 68 33 3e n pipelines</h3>
3bd0: 0d 0a 54 68 65 72 65 20 69 73 20 61 20 6c 61 73 ..There is a las
3be0: 74 20 61 73 74 6f 6e 69 73 68 69 6e 67 20 69 6d t astonishing im
3bf0: 70 72 6f 76 65 6d 65 6e 74 20 73 75 70 70 6f 72 provement suppor
3c00: 74 65 64 20 62 79 20 50 52 4f 4a 2e 36 2c 20 74 ted by PROJ.6, t
3c10: 68 61 74 20 61 72 65 20 3c 62 3e 3c 69 3e 74 72 hat are <b><i>tr
3c20: 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 ansformation pip
3c30: 65 6c 69 6e 65 73 3c 2f 69 3e 3c 2f 62 3e 2e 3c elines</i></b>.<
3c40: 62 72 3e 0d 0a 57 68 65 6e 20 75 73 69 6e 67 20 br>..When using
3c50: 61 20 3c 62 3e 3c 69 3e 70 69 70 65 6c 69 6e 65 a <b><i>pipeline
3c60: 3c 2f 69 3e 3c 2f 62 3e 20 79 6f 75 20 63 61 6e </i></b> you can
3c70: 20 66 72 65 65 6c 79 20 64 65 66 69 6e 65 20 61 freely define a
3c80: 6e 79 20 63 6f 6d 70 6c 65 78 20 67 65 6f 64 65 ny complex geode
3c90: 74 69 63 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 tic transformati
3ca0: 6f 6e 20 62 79 20 63 68 61 69 6e 69 6e 67 20 74 on by chaining t
3cb0: 6f 67 65 74 68 65 72 20 6d 61 6e 79 20 65 6c 65 ogether many ele
3cc0: 6d 65 6e 74 61 72 79 20 73 74 65 70 73 20 73 75 mentary steps su
3cd0: 63 68 20 61 73 20 63 6f 6e 76 65 72 73 69 6f 6e ch as conversion
3ce0: 2c 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e , transformation
3cf0: 2c 20 70 72 6f 6a 65 63 74 69 6f 6e 2c 20 61 78 , projection, ax
3d00: 69 73 20 73 77 61 70 20 61 6e 64 20 73 6f 20 6f is swap and so o
3d10: 6e 2e 3c 62 72 3e 0d 0a 41 20 70 69 70 65 6c 69 n.<br>..A pipeli
3d20: 6e 65 20 69 73 20 63 6f 6e 63 65 70 74 75 61 6c ne is conceptual
3d30: 6c 79 20 73 69 6d 69 6c 61 72 20 74 6f 20 61 20 ly similar to a
3d40: 55 4e 49 58 20 73 68 65 6c 6c 20 73 63 72 69 70 UNIX shell scrip
3d50: 74 2c 20 77 69 74 68 20 61 20 64 61 74 61 66 6c t, with a datafl
3d60: 6f 77 20 72 65 67 75 6c 61 72 6c 79 20 70 72 6f ow regularly pro
3d70: 63 65 65 64 69 6e 67 20 66 6f 72 77 61 72 64 20 ceeding forward
3d80: 66 72 6f 6d 20 73 74 65 70 20 74 6f 20 73 74 65 from step to ste
3d90: 70 20 75 6e 74 69 6c 20 70 72 6f 64 75 63 69 6e p until producin
3da0: 67 20 74 68 65 20 66 69 6e 61 6c 20 72 65 73 75 g the final resu
3db0: 6c 74 2e 3c 62 72 3e 0d 0a 54 68 65 20 66 6f 6c lt.<br>..The fol
3dc0: 6c 6f 77 69 6e 67 20 69 73 20 61 20 70 72 61 63 lowing is a prac
3dd0: 74 69 63 61 6c 20 65 78 61 6d 70 6c 65 20 6f 66 tical example of
3de0: 20 61 20 70 69 70 65 6c 69 6e 65 20 63 6f 72 72 a pipeline corr
3df0: 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 61 20 74 esponding to a t
3e00: 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 66 72 ransformation fr
3e10: 6f 6d 20 3c 62 3e 45 50 53 47 3a 34 33 32 36 3c om <b>EPSG:4326<
3e20: 2f 62 3e 20 3c 69 3e 57 47 53 20 38 34 3c 2f 69 /b> <i>WGS 84</i
3e30: 3e 20 74 6f 20 3c 62 3e 45 50 53 47 3a 33 32 36 > to <b>EPSG:326
3e40: 33 32 3c 2f 62 3e 20 3c 69 3e 57 47 53 20 38 34 32</b> <i>WGS 84
3e50: 20 2f 20 55 54 4d 20 7a 6f 6e 65 20 33 32 4e 3c / UTM zone 32N<
3e60: 2f 69 3e 3a 0d 0a 3c 76 65 72 62 61 74 69 6d 3e /i>:..<verbatim>
3e70: 0d 0a 2b 70 72 6f 6a 3d 70 69 70 65 6c 69 6e 65 ..+proj=pipeline
3e80: 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 61 ..+step +proj=a
3e90: 78 69 73 73 77 61 70 20 2b 6f 72 64 65 72 3d 32 xisswap +order=2
3ea0: 2c 31 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a ,1 ..+step +proj
3eb0: 3d 75 6e 69 74 63 6f 6e 76 65 72 74 20 2b 78 79 =unitconvert +xy
3ec0: 5f 69 6e 3d 64 65 67 20 2b 78 79 5f 6f 75 74 3d _in=deg +xy_out=
3ed0: 72 61 64 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f rad ..+step +pro
3ee0: 6a 3d 75 74 6d 20 2b 7a 6f 6e 65 3d 33 32 20 2b j=utm +zone=32 +
3ef0: 65 6c 6c 70 73 3d 57 47 53 38 34 0d 0a 3c 2f 76 ellps=WGS84..</v
3f00: 65 72 62 61 74 69 6d 3e 0d 0a 3c 74 61 62 6c 65 erbatim>..<table
3f10: 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 cellspacing="8"
3f20: 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 31 36 cellpadding="16
3f30: 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 " bgcolor="#ffff
3f40: 64 30 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a d0">..<tr><td>..
3f50: 3c 62 3e 3c 75 3e 55 73 65 66 75 6c 20 68 69 6e <b><u>Useful hin
3f60: 74 3c 2f 75 3e 3c 2f 62 3e 3a 20 50 52 4f 4a 2e t</u></b>: PROJ.
3f70: 36 20 73 75 70 70 6f 72 74 73 20 61 20 6e 65 77 6 supports a new
3f80: 20 43 4c 49 20 74 6f 6f 6c 20 28 3c 62 3e 70 72 CLI tool (<b>pr
3f90: 6f 6a 69 6e 66 6f 3c 2f 62 3e 29 20 66 6f 72 20 ojinfo</b>) for
3fa0: 69 6e 73 70 65 63 74 69 6e 67 20 69 6e 20 66 75 inspecting in fu
3fb0: 6c 6c 20 64 65 74 61 69 6c 20 74 68 65 20 69 6e ll detail the in
3fc0: 74 65 72 6e 61 6c 20 64 65 66 69 6e 69 74 69 6f ternal definitio
3fd0: 6e 73 20 6f 66 20 43 52 53 65 73 2c 20 54 72 61 ns of CRSes, Tra
3fe0: 6e 73 66 6f 72 6d 61 74 69 6f 6e 73 20 65 74 63 nsformations etc
3ff0: 2e 3c 62 72 3e 0d 0a 54 68 65 20 61 62 6f 76 65 .<br>..The above
4000: 20 70 69 70 65 6c 69 6e 65 20 69 73 20 73 69 6d pipeline is sim
4010: 70 6c 79 20 74 68 65 20 6f 75 74 70 75 74 20 6f ply the output o
4020: 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 f the following
4030: 63 6f 6d 6d 61 6e 64 3a 0d 0a 3c 76 65 72 62 61 command:..<verba
4040: 74 69 6d 3e 0d 0a 70 72 6f 6a 69 6e 66 6f 20 2d tim>..projinfo -
4050: 73 20 45 50 53 47 3a 34 33 32 36 20 2d 74 20 45 s EPSG:4326 -t E
4060: 50 53 47 3a 33 32 36 33 32 20 2d 6f 20 70 72 6f PSG:32632 -o pro
4070: 6a 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a j..</verbatim>..
4080: 3c 62 3e 70 72 6f 6a 69 6e 66 6f 3c 2f 62 3e 20 <b>projinfo</b>
4090: 69 73 20 61 20 76 65 72 79 20 70 72 65 63 69 6f is a very precio
40a0: 75 73 20 72 65 73 6f 75 72 63 65 3b 20 64 6f 6e us resource; don
40b0: 27 74 20 68 65 73 69 74 61 74 65 20 74 6f 20 66 't hesitate to f
40c0: 72 65 71 75 65 6e 74 6c 79 20 75 73 65 20 69 74 requently use it
40d0: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 64 69 73 in order to dis
40e0: 63 6f 76 65 72 20 77 68 61 74 27 73 20 72 65 61 cover what's rea
40f0: 6c 6c 79 20 68 61 70 70 65 6e 69 6e 67 20 62 65 lly happening be
4100: 68 69 6e 64 20 74 68 65 20 73 63 65 6e 65 73 2e hind the scenes.
4110: 3c 62 72 3e 0d 0a 49 74 27 73 20 74 68 65 20 62 <br>..It's the b
4120: 65 73 74 20 61 6e 64 20 65 61 73 69 65 73 74 20 est and easiest
4130: 77 61 79 20 66 6f 72 20 66 75 6c 6c 79 20 75 6e way for fully un
4140: 64 65 72 73 74 61 6e 64 69 6e 67 20 68 6f 77 20 derstanding how
4150: 50 52 4f 4a 2e 36 20 64 6f 20 72 65 61 6c 6c 79 PROJ.6 do really
4160: 20 77 6f 72 6b 73 2e 0d 0a 3c 2f 74 64 3e 3c 2f works...</td></
4170: 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 tr>..</table><br
4180: 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 ><br>..<table ce
4190: 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65 llspacing="8" ce
41a0: 6c 6c 70 61 64 64 69 6e 67 3d 22 38 22 20 62 67 llpadding="8" bg
41b0: 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 39 22 3e color="#ffffe9">
41c0: 0d 0a 3c 74 72 3e 3c 74 68 3e 0d 0a 49 6e 20 6f ..<tr><th>..In o
41d0: 72 64 65 72 20 74 6f 20 6c 65 61 72 6e 20 6d 6f rder to learn mo
41e0: 72 65 20 61 62 6f 75 74 20 74 68 65 20 6d 61 6e re about the man
41f0: 79 20 69 6e 74 65 72 65 73 74 69 6e 67 20 63 6f y interesting co
4200: 6f 6c 20 6e 65 77 20 66 65 61 74 75 72 65 73 20 ol new features
4210: 73 75 70 70 6f 72 74 65 64 20 62 79 20 50 52 4f supported by PRO
4220: 4a 2e 36 20 70 6c 65 61 73 65 20 63 6f 6e 73 75 J.6 please consu
4230: 6c 74 20 74 68 65 20 3c 61 20 68 72 65 66 3d 22 lt the <a href="
4240: 68 74 74 70 73 3a 2f 2f 70 72 6f 6a 34 2e 6f 72 https://proj4.or
4250: 67 2f 22 3e 6f 72 69 67 69 6e 61 6c 20 64 6f 63 g/">original doc
4260: 75 6d 65 6e 74 61 74 69 6f 6e 3c 2f 61 3e 0d 0a umentation</a>..
4270: 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 </th></tr>..</ta
4280: 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 68 72 3e 0d 0a ble><br>..<hr>..
4290: 3c 68 31 3e 50 52 4f 4a 2e 36 20 73 75 70 70 6f <h1>PROJ.6 suppo
42a0: 72 74 20 6f 6e 20 53 70 61 74 69 61 4c 69 74 65 rt on SpatiaLite
42b0: 2d 35 2e 30 2e 30 3c 2f 68 31 3e 0d 0a 3c 68 33 -5.0.0</h1>..<h3
42c0: 3e 43 72 65 61 74 69 6e 67 20 61 6e 64 20 70 6f >Creating and po
42d0: 70 75 6c 61 74 69 6e 67 20 74 68 65 20 73 70 61 pulating the spa
42e0: 74 69 61 6c 5f 72 65 66 5f 73 79 73 20 6d 65 74 tial_ref_sys met
42f0: 61 74 61 62 6c 65 3c 2f 68 33 3e 0d 0a 54 68 65 atable</h3>..The
4300: 72 65 20 69 73 20 6e 6f 20 72 65 6c 65 76 61 6e re is no relevan
4310: 74 20 63 68 61 6e 67 65 2e 20 41 73 20 69 6e 20 t change. As in
4320: 61 6c 6c 20 70 72 65 76 69 6f 75 73 20 76 65 72 all previous ver
4330: 73 69 6f 6e 73 20 3c 62 3e 73 70 61 74 69 61 6c sions <b>spatial
4340: 5f 72 65 66 5f 73 79 73 3c 2f 62 3e 20 77 69 6c _ref_sys</b> wil
4350: 6c 20 62 65 20 61 75 74 6f 6d 61 74 69 63 61 6c l be automatical
4360: 6c 79 20 63 72 65 61 74 65 64 20 61 6e 64 20 70 ly created and p
4370: 72 6f 70 65 72 6c 79 20 70 6f 70 75 6c 61 74 65 roperly populate
4380: 20 62 79 20 63 61 6c 6c 69 6e 67 20 74 68 65 20 by calling the
4390: 61 70 70 72 6f 70 72 69 61 74 65 20 53 51 4c 20 appropriate SQL
43a0: 66 75 6e 63 74 69 6f 6e 2e 0d 0a 3c 76 65 72 62 function...<verb
43b0: 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 54 20 49 6e atim>..SELECT In
43c0: 69 74 53 70 61 74 69 61 6c 4d 65 74 61 44 61 74 itSpatialMetaDat
43d0: 61 28 31 29 3b 0d 0a 20 20 20 20 20 20 6f 72 0d a(1);.. or.
43e0: 0a 53 45 4c 45 43 54 20 49 6e 69 74 53 70 61 74 .SELECT InitSpat
43f0: 69 61 6c 4d 65 74 61 44 61 74 61 46 75 6c 6c 28 ialMetaDataFull(
4400: 31 29 3b 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 1);..</verbatim>
4410: 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 ..<table cellspa
4420: 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 cing="8" cellpad
4430: 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 ding="8" bgcolor
4440: 3d 22 23 66 66 66 66 65 39 22 3e 0d 0a 3c 74 72 ="#ffffe9">..<tr
4450: 3e 3c 74 64 3e 0d 0a 50 6c 65 61 73 65 20 72 65 ><td>..Please re
4460: 6d 65 6d 62 65 72 20 74 68 61 74 20 6e 6f 77 20 member that now
4470: 69 6e 20 53 70 61 74 69 61 4c 69 74 65 2d 35 2e in SpatiaLite-5.
4480: 30 2e 30 20 3c 62 3e 49 6e 69 74 53 70 61 74 69 0.0 <b>InitSpati
4490: 61 6c 4d 65 74 61 44 61 74 61 46 75 6c 6c 3c 2f alMetaDataFull</
44a0: 62 3e 20 72 65 70 72 65 73 65 6e 74 73 20 74 68 b> represents th
44b0: 65 20 70 72 65 66 65 72 72 65 64 20 6d 65 74 68 e preferred meth
44c0: 6f 64 20 66 6f 72 20 63 72 65 61 74 69 6e 67 20 od for creating
44d0: 61 6c 6c 20 6d 65 74 61 64 61 74 61 20 74 61 62 all metadata tab
44e0: 6c 65 73 20 72 65 71 75 69 72 65 64 20 62 79 20 les required by
44f0: 74 68 69 73 20 76 65 72 73 69 6f 6e 2e 3c 62 72 this version.<br
4500: 3e 0d 0a 3c 62 3e 49 6e 69 74 53 70 61 74 69 61 >..<b>InitSpatia
4510: 6c 4d 65 74 61 44 61 74 61 3c 2f 62 3e 20 69 73 lMetaData</b> is
4520: 20 73 74 69 6c 6c 20 6d 61 69 6e 74 61 69 6e 65 still maintaine
4530: 64 20 73 6f 20 74 6f 20 6e 6f 74 20 62 72 65 61 d so to not brea
4540: 6b 20 68 69 73 74 6f 72 69 63 61 6c 20 63 6f 6d k historical com
4550: 70 61 74 69 62 69 6c 69 74 79 2c 20 62 75 74 20 patibility, but
4560: 73 68 6f 75 6c 64 6e 27 74 20 62 65 20 75 73 65 shouldn't be use
4570: 64 20 61 6e 79 20 6c 6f 6e 67 65 72 2e 0d 0a 3c d any longer...<
4580: 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 /td></tr>..</tab
4590: 6c 65 3e 3c 62 72 3e 0d 0a 54 68 65 20 6d 6f 73 le><br>..The mos
45a0: 74 20 72 65 6c 65 76 61 6e 74 20 63 68 61 6e 67 t relevant chang
45b0: 65 20 69 73 20 74 68 61 74 20 64 69 66 66 65 72 e is that differ
45c0: 65 6e 74 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 ent versions of
45d0: 53 70 61 74 69 61 4c 69 74 65 2f 50 52 4f 4a 20 SpatiaLite/PROJ
45e0: 77 69 6c 6c 20 6e 6f 77 20 62 65 68 61 76 65 20 will now behave
45f0: 69 6e 20 72 61 64 69 63 61 6c 6c 79 20 64 69 66 in radically dif
4600: 66 65 72 65 6e 74 20 77 61 79 73 2c 20 61 73 20 ferent ways, as
4610: 73 75 6d 6d 61 72 69 7a 65 64 20 69 6e 20 74 68 summarized in th
4620: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 72 6f 73 e following cros
4630: 73 2d 76 65 72 73 69 6f 6e 20 63 6f 6d 70 61 74 s-version compat
4640: 69 62 69 6c 69 74 79 20 74 61 62 6c 65 2e 3c 62 ibility table.<b
4650: 72 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 r><br>..<table c
4660: 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 ellspacing="8" c
4670: 65 6c 6c 70 61 64 64 69 6e 67 3d 22 31 36 22 20 ellpadding="16"
4680: 62 67 63 6f 6c 6f 72 3d 22 23 65 38 66 66 65 38 bgcolor="#e8ffe8
4690: 22 20 62 6f 72 64 65 72 3d 22 31 22 3e 0d 0a 3c " border="1">..<
46a0: 74 72 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 tr><th bgcolor="
46b0: 23 66 66 62 30 33 65 22 3e 53 70 61 74 69 61 4c #ffb03e">SpatiaL
46c0: 69 74 65 20 2f 20 50 52 4f 4a 20 76 65 72 73 69 ite / PROJ versi
46d0: 6f 6e 3c 2f 74 68 3e 3c 74 68 20 62 67 63 6f 6c on</th><th bgcol
46e0: 6f 72 3d 22 23 66 66 62 30 33 65 22 3e 43 6f 6e or="#ffb03e">Con
46f0: 6e 65 63 74 65 64 20 44 42 3c 2f 74 68 3e 3c 74 nected DB</th><t
4700: 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 h bgcolor="#ffb0
4710: 33 65 22 3e 41 63 74 69 6f 6e 3c 2f 74 68 3e 3c 3e">Action</th><
4720: 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 20 /tr>..<tr>..<td
4730: 72 6f 77 73 70 61 6e 3d 22 32 22 3e 53 70 61 74 rowspan="2">Spat
4740: 69 61 4c 69 74 65 2d 35 20 62 75 69 6c 74 20 6f iaLite-5 built o
4750: 6e 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 3c n <b>PROJ.6</b><
4760: 2f 74 64 3e 0d 0a 3c 74 64 3e 44 42 20 63 72 65 /td>..<td>DB cre
4770: 61 74 65 64 20 62 79 20 53 70 61 74 69 61 4c 69 ated by SpatiaLi
4780: 74 65 2d 35 20 2f 20 50 52 4f 4a 2e 36 3c 2f 74 te-5 / PROJ.6</t
4790: 64 3e 0d 0a 3c 74 64 20 72 6f 77 73 70 61 6e 3d d>..<td rowspan=
47a0: 22 32 22 3e 0d 0a 3c 62 3e 6c 69 62 73 70 61 74 "2">..<b>libspat
47b0: 69 61 6c 69 74 65 2d 35 3c 2f 62 3e 20 77 68 65 ialite-5</b> whe
47c0: 6e 20 62 75 69 6c 74 20 6f 6e 20 3c 62 3e 50 52 n built on <b>PR
47d0: 4f 4a 2e 36 3c 2f 62 3e 20 77 69 6c 6c 20 61 6c OJ.6</b> will al
47e0: 77 61 79 73 20 69 67 6e 6f 72 65 20 62 6f 74 68 ways ignore both
47f0: 20 74 68 65 20 70 72 6f 6a 2d 73 74 72 69 6e 67 the proj-string
4800: 73 20 73 74 6f 72 65 64 20 69 6e 20 63 6f 6c 75 s stored in colu
4810: 6d 6e 20 3c 62 3e 70 72 6f 6a 34 74 65 78 74 3c mn <b>proj4text<
4820: 2f 62 3e 20 61 6e 64 20 74 68 65 20 57 4b 54 20 /b> and the WKT
4830: 64 65 66 69 6e 69 74 69 6f 6e 73 20 73 74 6f 72 definitions stor
4840: 65 64 20 69 6e 20 63 6f 6c 75 6d 6e 20 3c 62 3e ed in column <b>
4850: 73 72 74 65 78 74 3c 2f 62 3e 2e 3c 62 72 3e 0d srtext</b>.<br>.
4860: 0a 49 74 20 77 69 6c 6c 20 69 6e 73 74 65 61 64 .It will instead
4870: 20 6c 65 61 76 65 20 50 52 4f 4a 2e 36 20 66 75 leave PROJ.6 fu
4880: 6c 6c 79 20 66 72 65 65 20 74 6f 20 75 73 65 20 lly free to use
4890: 74 68 65 20 43 52 53 20 64 65 66 69 6e 69 74 69 the CRS definiti
48a0: 6f 6e 73 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e ons contained in
48b0: 20 69 74 73 20 6f 77 6e 20 70 72 69 76 61 74 65 its own private
48c0: 20 64 61 74 61 62 61 73 65 2e 3c 62 72 3e 3c 62 database.<br><b
48d0: 72 3e 0d 0a 4e 6f 74 65 20 74 68 61 74 20 74 68 r>..Note that th
48e0: 69 73 20 61 70 70 6c 69 65 73 20 69 6e 64 69 66 is applies indif
48f0: 66 65 72 65 6e 74 6c 79 20 74 6f 20 62 6f 74 68 ferently to both
4900: 20 3c 62 3e 3c 69 3e 6c 65 67 61 63 79 20 64 61 <b><i>legacy da
4910: 74 61 62 61 73 65 73 3c 2f 69 3e 3c 2f 62 3e 20 tabases</i></b>
4920: 63 72 65 61 74 65 64 20 62 79 20 61 6e 79 20 70 created by any p
4930: 72 65 76 69 6f 75 73 20 76 65 72 73 69 6f 6e 20 revious version
4940: 61 6e 64 20 3c 62 3e 3c 69 3e 6d 6f 73 74 20 6d and <b><i>most m
4950: 6f 64 65 72 6e 20 64 61 74 61 62 61 73 65 73 3c odern databases<
4960: 2f 69 3e 3c 2f 62 3e 20 63 72 65 61 74 65 64 20 /i></b> created
4970: 62 79 20 74 68 65 20 6c 61 74 65 73 74 20 76 65 by the latest ve
4980: 72 73 69 6f 6e 2e 0d 0a 3c 2f 74 64 3e 3c 2f 74 rsion...</td></t
4990: 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 44 42 r>..<tr>..<td>DB
49a0: 20 63 72 65 61 74 65 64 20 62 79 20 53 70 61 74 created by Spat
49b0: 69 61 4c 69 74 65 2d 35 20 2f 20 50 52 4f 4a 2e iaLite-5 / PROJ.
49c0: 34 3c 62 72 3e 0d 0a 6f 72 3c 62 72 3e 0d 0a 62 4<br>..or<br>..b
49d0: 79 20 61 6e 79 20 70 72 65 76 69 6f 75 73 20 76 y any previous v
49e0: 65 72 73 69 6f 6e 20 6f 66 20 53 70 61 74 69 61 ersion of Spatia
49f0: 4c 69 74 65 20 28 3c 20 35 2e 30 2e 30 29 3c 2f Lite (< 5.0.0)</
4a00: 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e td>..</tr>..<tr>
4a10: 0d 0a 3c 74 64 20 72 6f 77 73 70 61 6e 3d 22 32 ..<td rowspan="2
4a20: 22 3e 53 70 61 74 69 61 4c 69 74 65 2d 35 20 62 ">SpatiaLite-5 b
4a30: 75 69 6c 74 20 6f 6e 20 3c 62 3e 50 52 4f 4a 2e uilt on <b>PROJ.
4a40: 34 3c 2f 62 3e 3c 62 72 3e 0d 0a 6f 72 3c 62 72 4</b><br>..or<br
4a50: 3e 0d 0a 61 6e 79 20 70 72 65 76 69 6f 75 73 20 >..any previous
4a60: 76 65 72 73 69 6f 6e 20 6f 66 20 53 70 61 74 69 version of Spati
4a70: 61 4c 69 74 65 20 28 3c 20 35 2e 30 2e 30 29 3c aLite (< 5.0.0)<
4a80: 2f 74 64 3e 0d 0a 3c 74 64 3e 44 42 20 63 72 65 /td>..<td>DB cre
4a90: 61 74 65 64 20 62 79 20 53 70 61 74 69 61 4c 69 ated by SpatiaLi
4aa0: 74 65 2d 35 20 2f 20 50 52 4f 4a 2e 36 3c 2f 74 te-5 / PROJ.6</t
4ab0: 64 3e 0d 0a 3c 74 64 20 72 6f 77 73 70 61 6e 3d d>..<td rowspan=
4ac0: 22 32 22 3e 0d 0a 57 68 65 6e 20 3c 62 3e 6c 69 "2">..When <b>li
4ad0: 62 73 70 61 74 69 61 6c 69 74 65 3c 2f 62 3e 20 bspatialite</b>
4ae0: 28 61 6e 79 20 76 65 72 73 69 6f 6e 2c 20 69 6e (any version, in
4af0: 63 6c 75 64 69 6e 67 20 35 2e 30 2e 30 29 20 69 cluding 5.0.0) i
4b00: 73 20 6e 6f 74 20 73 75 70 70 6f 72 74 65 64 20 s not supported
4b10: 62 79 20 50 52 4f 4a 2e 36 20 74 68 65 6e 20 74 by PROJ.6 then t
4b20: 68 65 20 74 72 61 64 69 74 69 6f 6e 61 6c 20 61 he traditional a
4b30: 70 70 72 6f 61 63 68 20 77 69 6c 6c 20 62 65 20 pproach will be
4b40: 61 6c 77 61 79 73 20 61 70 70 6c 69 65 64 2c 20 always applied,
4b50: 61 6e 64 20 65 61 63 68 20 43 52 53 20 77 69 6c and each CRS wil
4b60: 6c 20 62 65 20 63 6f 6e 73 65 71 75 65 6e 74 6c l be consequentl
4b70: 79 20 69 64 65 6e 74 69 66 69 65 64 20 62 79 20 y identified by
4b80: 69 74 73 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e its correspondin
4b90: 67 20 70 72 6f 6a 2d 73 74 72 69 6e 67 20 73 74 g proj-string st
4ba0: 6f 72 65 64 20 69 6e 20 63 6f 6c 75 6d 6e 20 3c ored in column <
4bb0: 62 3e 70 72 6f 6a 34 74 65 78 74 3c 2f 62 3e 3c b>proj4text</b><
4bc0: 62 72 3e 3c 62 72 3e 0d 0a 4e 6f 74 65 20 74 68 br><br>..Note th
4bd0: 61 74 20 65 76 65 6e 20 77 68 65 6e 20 50 52 4f at even when PRO
4be0: 4a 2e 36 20 69 73 20 6e 6f 74 20 73 75 70 70 6f J.6 is not suppo
4bf0: 72 74 65 64 20 61 6e 79 20 76 65 72 73 69 6f 6e rted any version
4c00: 20 6f 66 20 53 70 61 74 69 61 4c 69 74 65 20 28 of SpatiaLite (
4c10: 74 68 69 73 20 69 6e 63 6c 75 64 69 6e 67 20 35 this including 5
4c20: 2e 30 2e 30 29 20 63 61 6e 20 73 61 66 65 6c 79 .0.0) can safely
4c30: 20 63 6f 6e 6e 65 63 74 20 74 6f 20 61 6e 79 20 connect to any
4c40: 44 42 2d 66 69 6c 65 20 63 72 65 61 74 65 64 20 DB-file created
4c50: 62 79 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 by the most rece
4c60: 6e 74 20 76 65 72 73 69 6f 6e 20 77 69 74 68 20 nt version with
4c70: 66 75 6c 6c 20 50 52 4f 4a 2e 36 20 73 75 70 70 full PROJ.6 supp
4c80: 6f 72 74 2e 0d 0a 3c 2f 74 64 3e 0d 0a 3c 2f 74 ort...</td>..</t
4c90: 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 44 42 r>..<tr>..<td>DB
4ca0: 20 63 72 65 61 74 65 64 20 62 79 20 53 70 61 74 created by Spat
4cb0: 69 61 4c 69 74 65 2d 35 20 2f 20 50 52 4f 4a 2e iaLite-5 / PROJ.
4cc0: 34 3c 62 72 3e 0d 0a 6f 72 3c 62 72 3e 0d 0a 62 4<br>..or<br>..b
4cd0: 79 20 61 6e 79 20 70 72 65 76 69 6f 75 73 20 76 y any previous v
4ce0: 65 72 73 69 6f 6e 20 6f 66 20 53 70 61 74 69 61 ersion of Spatia
4cf0: 4c 69 74 65 20 28 3c 20 35 2e 30 2e 30 29 3c 2f Lite (< 5.0.0)</
4d00: 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 td>..</tr>..</ta
4d10: 62 6c 65 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 68 ble><br><br>..<h
4d20: 33 3e 45 78 69 73 74 69 6e 67 20 53 51 4c 20 66 3>Existing SQL f
4d30: 75 6e 63 74 69 6f 6e 73 20 61 66 66 65 63 74 65 unctions affecte
4d40: 64 20 62 79 20 50 52 4f 4a 2e 36 3c 2f 68 33 3e d by PROJ.6</h3>
4d50: 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 ..<table cellspa
4d60: 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 cing="8" cellpad
4d70: 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 ding="8" bgcolor
4d80: 3d 22 23 65 38 66 66 65 38 22 20 62 6f 72 64 65 ="#e8ffe8" borde
4d90: 72 3d 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 r="1">..<tr><th
4da0: 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 bgcolor="#ffb03e
4db0: 22 3e 53 51 4c 20 46 75 6e 63 74 69 6f 6e 3c 2f ">SQL Function</
4dc0: 74 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 th><th bgcolor="
4dd0: 23 66 66 62 30 33 65 22 3e 45 78 74 65 6e 64 65 #ffb03e">Extende
4de0: 64 20 73 69 67 6e 61 74 75 72 65 3c 2f 74 68 3e d signature</th>
4df0: 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 <th bgcolor="#ff
4e00: 62 30 33 65 22 3e 42 65 68 61 76 69 6f 72 20 75 b03e">Behavior u
4e10: 6e 64 65 72 20 50 52 4f 4a 2e 36 3c 2f 74 68 3e nder PROJ.6</th>
4e20: 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c </tr>..<tr><td><
4e30: 62 3e 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 29 b>ST_Transform()
4e40: 3c 2f 62 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 0d </b></td>..<td>.
4e50: 0a 3c 62 3e 53 54 5f 54 72 61 6e 73 66 6f 72 6d .<b>ST_Transform
4e60: 3c 2f 62 3e 20 28 20 67 65 6f 6d 20 3c 69 3e 47 </b> ( geom <i>G
4e70: 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 6e 65 eometry</i> , ne
4e80: 77 53 72 69 64 20 3c 69 3e 49 6e 74 65 67 65 72 wSrid <i>Integer
4e90: 3c 2f 69 3e 20 2c 20 61 72 65 61 20 3c 69 3e 47 </i> , area <i>G
4ea0: 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 29 20 3a 20 eometry</i> ) :
4eb0: 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 3c <i>Geometry</i><
4ec0: 68 72 3e 0d 0a 3c 62 3e 53 54 5f 54 72 61 6e 73 hr>..<b>ST_Trans
4ed0: 66 6f 72 6d 3c 2f 62 3e 20 28 20 67 65 6f 6d 20 form</b> ( geom
4ee0: 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 <i>Geometry</i>
4ef0: 2c 20 6e 65 77 53 72 69 64 20 3c 69 3e 49 6e 74 , newSrid <i>Int
4f00: 65 67 65 72 3c 2f 69 3e 20 2c 20 61 72 65 61 20 eger</i> , area
4f10: 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 <i>Geometry</i>
4f20: 2c 20 70 72 6f 6a 5f 73 74 72 69 6e 67 5f 66 72 , proj_string_fr
4f30: 6f 6d 20 3c 69 3e 54 65 78 74 3c 2f 69 3e 20 29 om <i>Text</i> )
4f40: 20 3a 20 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f : <i>Geometry</
4f50: 69 3e 3c 68 72 3e 0d 0a 3c 62 3e 53 54 5f 54 72 i><hr>..<b>ST_Tr
4f60: 61 6e 73 66 6f 72 6d 3c 2f 62 3e 20 28 20 67 65 ansform</b> ( ge
4f70: 6f 6d 20 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f om <i>Geometry</
4f80: 69 3e 20 2c 20 6e 65 77 53 72 69 64 20 3c 69 3e i> , newSrid <i>
4f90: 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 61 72 Integer</i> , ar
4fa0: 65 61 20 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f ea <i>Geometry</
4fb0: 69 3e 20 2c 20 70 72 6f 6a 5f 73 74 72 69 6e 67 i> , proj_string
4fc0: 5f 66 72 6f 6d 20 3c 69 3e 54 65 78 74 3c 2f 69 _from <i>Text</i
4fd0: 3e 20 2c 20 70 72 6f 6a 5f 73 74 72 69 6e 67 5f > , proj_string_
4fe0: 74 6f 20 3c 69 3e 54 65 78 74 3c 2f 69 3e 20 29 to <i>Text</i> )
4ff0: 20 3a 20 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f : <i>Geometry</
5000: 69 3e 0d 0a 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 0d i>..</td>..<td>.
5010: 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 .<table cellspac
5020: 69 6e 67 3d 22 34 22 20 63 65 6c 6c 70 61 64 64 ing="4" cellpadd
5030: 69 6e 67 3d 22 34 22 20 62 67 63 6f 6c 6f 72 3d ing="4" bgcolor=
5040: 22 23 66 66 66 66 64 30 22 3e 0d 0a 3c 74 72 3e "#ffffd0">..<tr>
5050: 3c 74 64 3e 0d 0a 3c 62 3e 3c 75 3e 3c 69 3e 4e <td>..<b><u><i>N
5060: 6f 74 65 3c 2f 69 3e 3c 2f 75 3e 3c 2f 62 3e 3a ote</i></u></b>:
5070: 20 61 6c 6c 20 74 68 65 73 65 20 3c 62 3e 3c 69 all these <b><i
5080: 3e 65 78 74 65 6e 64 65 64 20 73 69 67 6e 61 74 >extended signat
5090: 75 72 65 73 3c 2f 69 3e 3c 2f 62 3e 20 61 72 65 ures</i></b> are
50a0: 20 73 75 70 70 6f 72 74 65 64 20 6f 6e 6c 79 20 supported only
50b0: 77 68 65 6e 20 3c 62 3e 6c 69 62 73 70 61 74 69 when <b>libspati
50c0: 61 6c 69 74 65 2d 35 2e 30 3c 2f 62 3e 20 68 61 alite-5.0</b> ha
50d0: 73 20 62 65 65 6e 20 62 75 69 6c 74 20 6f 6e 20 s been built on
50e0: 74 68 65 20 74 6f 70 20 6f 66 20 3c 62 3e 50 52 the top of <b>PR
50f0: 4f 4a 2e 36 3c 2f 62 3e 3c 62 72 3e 0d 0a 49 66 OJ.6</b><br>..If
5100: 20 74 68 65 20 6c 69 62 72 61 72 79 20 68 61 73 the library has
5110: 20 62 65 65 6e 20 62 75 69 6c 74 20 69 6e 73 74 been built inst
5120: 65 61 64 20 6f 6e 20 65 61 72 6c 69 65 72 20 76 ead on earlier v
5130: 65 72 73 69 6f 6e 73 20 6f 66 20 50 52 4f 4a 20 ersions of PROJ
5140: 61 6e 79 20 61 74 74 65 6d 70 74 20 74 6f 20 63 any attempt to c
5150: 61 6c 6c 20 74 68 65 73 65 20 65 78 74 65 6e 64 all these extend
5160: 65 64 20 73 69 67 6e 61 74 75 72 65 73 20 77 69 ed signatures wi
5170: 6c 6c 20 6a 75 73 74 20 72 65 74 75 72 6e 20 61 ll just return a
5180: 20 3c 62 3e 3c 69 3e 77 72 6f 6e 67 20 6e 75 6d <b><i>wrong num
5190: 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 ber of arguments
51a0: 20 74 6f 20 66 75 6e 63 74 69 6f 6e 20 53 54 5f to function ST_
51b0: 54 72 61 6e 73 66 6f 72 6d 28 29 3c 2f 69 3e 3c Transform()</i><
51c0: 2f 62 3e 20 65 72 72 6f 72 2e 0d 0a 3c 2f 74 64 /b> error...</td
51d0: 3e 3c 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c ><tr>..</table><
51e0: 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c br>..<table cell
51f0: 73 70 61 63 69 6e 67 3d 22 34 22 20 63 65 6c 6c spacing="4" cell
5200: 70 61 64 64 69 6e 67 3d 22 34 22 20 62 67 63 6f padding="4" bgco
5210: 6c 6f 72 3d 22 23 66 66 64 66 64 30 22 3e 0d 0a lor="#ffdfd0">..
5220: 3c 74 72 3e 3c 74 64 3e 0d 0a 41 6e 79 20 69 6e <tr><td>..Any in
5230: 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 20 70 valid argument p
5240: 61 73 73 65 64 20 74 6f 20 3c 62 3e 53 54 5f 54 assed to <b>ST_T
5250: 72 61 6e 73 66 6f 72 6d 28 29 3c 2f 62 3e 20 28 ransform()</b> (
5260: 3c 62 3e 3c 69 3e 65 78 74 65 6e 64 65 64 20 73 <b><i>extended s
5270: 69 67 6e 61 74 75 72 65 73 3c 2f 69 3e 3c 2f 62 ignatures</i></b
5280: 3e 29 20 77 69 6c 6c 20 72 61 69 73 65 20 61 6e >) will raise an
5290: 20 3c 62 3e 53 51 4c 20 45 78 63 65 70 74 69 6f <b>SQL Exceptio
52a0: 6e 3c 2f 62 3e 2e 0d 0a 3c 2f 74 64 3e 3c 74 72 n</b>...</td><tr
52b0: 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d >..</table><br>.
52c0: 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f .<ul>..<li>the o
52d0: 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 ptional argument
52e0: 20 3c 62 3e 61 72 65 61 3c 2f 62 3e 20 6d 61 79 <b>area</b> may
52f0: 20 62 65 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 be <b>NULL</b>
5300: 28 3c 69 3e 64 65 66 61 75 6c 74 20 73 65 74 74 (<i>default sett
5310: 69 6e 67 3c 2f 69 3e 29 2e 3c 62 72 3e 0d 0a 4f ing</i>).<br>..O
5320: 74 68 65 72 77 69 73 65 20 69 74 27 73 20 65 78 therwise it's ex
5330: 70 65 63 74 65 64 20 74 6f 20 63 6f 6e 74 61 69 pected to contai
5340: 6e 20 61 20 76 61 6c 69 64 20 47 65 6f 6d 65 74 n a valid Geomet
5350: 72 79 20 69 6e 20 3c 62 3e 53 52 49 44 3d 34 33 ry in <b>SRID=43
5360: 32 36 20 28 6c 6f 6e 67 2f 6c 61 74 29 3c 2f 62 26 (long/lat)</b
5370: 3e 2e 0d 0a 57 68 65 6e 20 61 6e 20 3c 62 3e 3c >...When an <b><
5380: 69 3e 61 72 65 61 20 6f 66 20 75 73 65 3c 2f 69 i>area of use</i
5390: 3e 3c 2f 62 3e 20 69 73 20 65 78 70 6c 69 63 69 ></b> is explici
53a0: 74 6c 79 20 73 75 70 70 6c 69 65 64 2c 20 74 68 tly supplied, th
53b0: 65 6e 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e en <b>PROJ.6</b>
53c0: 20 6d 61 79 20 65 76 65 6e 74 75 61 6c 6c 79 20 may eventually
53d0: 75 73 65 20 74 68 65 20 63 6f 72 72 65 73 70 6f use the correspo
53e0: 6e 64 69 6e 67 20 3c 62 3e 42 42 4f 58 3c 2f 62 nding <b>BBOX</b
53f0: 3e 20 66 6f 72 20 66 69 6e 65 6c 79 20 74 75 6e > for finely tun
5400: 69 6e 67 20 74 68 65 20 6d 6f 72 65 20 61 63 63 ing the more acc
5410: 75 72 61 74 65 20 74 72 61 6e 73 66 6f 72 6d 61 urate transforma
5420: 74 69 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e tion.</li>..<li>
5430: 62 6f 74 68 20 74 68 65 20 6f 70 74 69 6f 6e 61 both the optiona
5440: 6c 20 61 72 67 75 6d 65 6e 74 73 20 3c 62 3e 70 l arguments <b>p
5450: 72 6f 6a 5f 73 74 72 69 6e 67 5f 66 72 6f 6d 3c roj_string_from<
5460: 2f 62 3e 20 61 6e 64 20 3c 62 3e 70 72 6f 6a 5f /b> and <b>proj_
5470: 73 74 72 69 6e 67 5f 74 6f 3c 2f 62 3e 20 6d 61 string_to</b> ma
5480: 79 20 62 65 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e y be <b>NULL</b>
5490: 20 28 3c 69 3e 64 65 66 61 75 6c 74 20 73 65 74 (<i>default set
54a0: 74 69 6e 67 3c 2f 69 3e 29 2e 3c 62 72 3e 0d 0a ting</i>).<br>..
54b0: 4f 74 68 65 72 77 69 73 65 20 74 68 65 79 20 61 Otherwise they a
54c0: 72 65 20 65 78 70 65 63 74 65 64 20 74 6f 20 63 re expected to c
54d0: 6f 6e 74 61 69 6e 20 61 20 76 61 6c 69 64 20 73 ontain a valid s
54e0: 74 72 69 6e 67 20 74 6f 20 62 65 20 75 73 65 64 tring to be used
54f0: 20 66 6f 72 20 69 64 65 6e 74 69 66 79 69 6e 67 for identifying
5500: 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 the correspondi
5510: 6e 67 20 43 52 53 2e 3c 62 72 3e 0d 0a 50 52 4f ng CRS.<br>..PRO
5520: 4a 2e 36 20 61 63 63 65 70 74 73 20 74 68 65 20 J.6 accepts the
5530: 66 6f 6c 6c 6f 77 69 6e 67 20 43 52 53 20 73 74 following CRS st
5540: 72 69 6e 67 73 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c rings:..<ul>..<l
5550: 69 3e 74 72 61 64 69 74 69 6f 6e 61 6c 20 3c 62 i>traditional <b
5560: 3e 3c 69 3e 70 72 6f 6a 2d 73 74 72 69 6e 67 73 ><i>proj-strings
5570: 3c 2f 69 3e 3c 2f 62 3e 20 75 73 65 64 20 62 79 </i></b> used by
5580: 20 61 6c 6c 20 70 72 65 76 69 6f 75 73 20 76 65 all previous ve
5590: 72 73 69 6f 6e 73 20 6f 66 20 50 52 4f 4a 2c 20 rsions of PROJ,
55a0: 61 73 20 65 2e 67 2e 0d 0a 3c 75 6c 3e 0d 0a 3c as e.g...<ul>..<
55b0: 6c 69 3e 3c 62 3e 2b 70 72 6f 6a 3d 6d 65 72 63 li><b>+proj=merc
55c0: 20 2b 61 3d 36 33 37 38 31 33 37 20 2b 62 3d 36 +a=6378137 +b=6
55d0: 33 37 38 31 33 37 20 2b 6c 61 74 5f 74 73 3d 30 378137 +lat_ts=0
55e0: 20 2b 6c 6f 6e 5f 30 3d 30 20 2b 78 5f 30 3d 30 +lon_0=0 +x_0=0
55f0: 20 2b 79 5f 30 3d 30 20 2b 6b 3d 31 20 2b 75 6e +y_0=0 +k=1 +un
5600: 69 74 73 3d 6d 20 2b 6e 61 64 67 72 69 64 73 3d its=m +nadgrids=
5610: 40 6e 75 6c 6c 20 2b 77 6b 74 65 78 74 20 2b 6e @null +wktext +n
5620: 6f 5f 64 65 66 73 3c 2f 62 3e 3c 2f 6c 69 3e 0d o_defs</b></li>.
5630: 0a 3c 6c 69 3e 3c 62 3e 2b 70 72 6f 6a 3d 75 74 .<li><b>+proj=ut
5640: 6d 20 2b 7a 6f 6e 65 3d 33 32 20 2b 73 6f 75 74 m +zone=32 +sout
5650: 68 20 2b 65 6c 6c 70 73 3d 57 47 53 37 32 20 2b h +ellps=WGS72 +
5660: 74 6f 77 67 73 38 34 3d 30 2c 30 2c 34 2e 35 2c towgs84=0,0,4.5,
5670: 30 2c 30 2c 30 2e 35 35 34 2c 30 2e 32 32 36 33 0,0,0.554,0.2263
5680: 20 2b 75 6e 69 74 73 3d 6d 20 2b 6e 6f 5f 64 65 +units=m +no_de
5690: 66 73 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 fs</b></li>..<li
56a0: 3e 3c 62 3e 2b 70 72 6f 6a 3d 75 74 6d 20 2b 7a ><b>+proj=utm +z
56b0: 6f 6e 65 3d 33 32 20 2b 65 6c 6c 70 73 3d 69 6e one=32 +ellps=in
56c0: 74 6c 20 2b 74 6f 77 67 73 38 34 3d 2d 38 37 2c tl +towgs84=-87,
56d0: 2d 39 38 2c 2d 31 32 31 2c 30 2c 30 2c 30 2c 30 -98,-121,0,0,0,0
56e0: 20 2b 75 6e 69 74 73 3d 6d 20 2b 6e 6f 5f 64 65 +units=m +no_de
56f0: 66 73 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 fs</b></li>..</u
5700: 6c 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c 69 3e 0d 0a l>..</ul></li>..
5710: 3c 6c 69 3e 61 6e 79 20 3c 62 3e 3c 69 3e 57 4b <li>any <b><i>WK
5720: 54 20 65 78 70 72 65 73 73 69 6f 6e 3c 2f 69 3e T expression</i>
5730: 3c 2f 62 3e 20 64 65 66 69 6e 69 6e 67 20 61 20 </b> defining a
5740: 43 52 53 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 61 CRS.</li>..<li>a
5750: 20 3c 62 3e 3c 69 3e 43 52 53 20 6e 61 6d 65 3c <b><i>CRS name<
5760: 2f 69 3e 3c 2f 62 3e 20 61 73 20 65 2e 67 2e 0d /i></b> as e.g..
5770: 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 57 47 .<ul>..<li><b>WG
5780: 53 20 38 34 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c S 84</b></li>..<
5790: 6c 69 3e 3c 62 3e 57 47 53 20 38 34 20 2f 20 55 li><b>WGS 84 / U
57a0: 54 4d 20 7a 6f 6e 65 20 33 32 4e 3c 2f 62 3e 3c TM zone 32N</b><
57b0: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 49 47 4d /li>..<li><b>IGM
57c0: 39 35 20 2f 20 55 54 4d 20 7a 6f 6e 65 20 33 33 95 / UTM zone 33
57d0: 4e 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c N</b></li>..</ul
57e0: 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 61 6e 79 20 ></li>..<li>any
57f0: 3c 62 3e 3c 69 3e 63 61 6e 6f 6e 69 63 61 6c 20 <b><i>canonical
5800: 43 52 53 20 72 65 66 65 72 65 6e 63 65 3c 2f 69 CRS reference</i
5810: 3e 3c 2f 62 3e 20 61 73 20 65 2e 67 2e 0d 0a 3c ></b> as e.g...<
5820: 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 45 50 53 47 ul>..<li><b>EPSG
5830: 3a 34 33 32 36 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a :4326</b></li>..
5840: 3c 6c 69 3e 3c 62 3e 75 72 6e 3a 6f 67 63 3a 64 <li><b>urn:ogc:d
5850: 65 66 3a 63 72 73 3a 45 50 53 47 3a 3a 33 30 30 ef:crs:EPSG::300
5860: 33 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3</b></li>..</ul
5870: 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c ></li>..</ul>..<
5880: 62 72 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c br>..<ul>..<li><
5890: 62 3e 3c 75 3e 3c 69 3e 53 70 65 63 69 61 6c 20 b><u><i>Special
58a0: 63 61 73 65 3c 2f 69 3e 3c 2f 75 3e 3c 2f 62 3e case</i></u></b>
58b0: 3a 20 69 66 20 3c 62 3e 70 72 6f 6a 5f 73 74 72 : if <b>proj_str
58c0: 69 6e 67 5f 74 6f 3c 2f 62 3e 20 69 73 20 4e 55 ing_to</b> is NU
58d0: 4c 4c 20 77 68 69 6c 73 74 20 3c 62 3e 70 72 6f LL whilst <b>pro
58e0: 6a 5f 73 74 72 69 6e 67 5f 66 72 6f 6d 3c 2f 62 j_string_from</b
58f0: 3e 20 69 73 20 65 78 70 6c 69 63 69 74 6c 79 20 > is explicitly
5900: 73 65 74 2c 20 74 68 65 6e 20 69 74 20 77 69 6c set, then it wil
5910: 6c 20 69 6e 74 65 72 70 72 65 74 65 64 20 61 73 l interpreted as
5920: 20 61 6e 20 75 73 65 72 20 64 65 66 69 6e 65 64 an user defined
5930: 20 3c 62 3e 74 72 61 6e 73 66 6f 72 6d 61 74 69 <b>transformati
5940: 6f 6e 20 73 74 72 69 6e 67 3c 2f 62 3e 20 28 70 on string</b> (p
5950: 6f 73 73 69 62 6c 79 2c 20 61 73 20 61 20 3c 62 ossibly, as a <b
5960: 3e 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 >transformation
5970: 70 69 70 65 6c 69 6e 65 3c 2f 62 3e 29 20 61 73 pipeline</b>) as
5980: 20 65 2e 67 2e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 e.g...<ul>..<li
5990: 3e 3c 62 3e 2b 70 72 6f 6a 3d 70 69 70 65 6c 69 ><b>+proj=pipeli
59a0: 6e 65 3c 62 72 3e 0d 0a 2b 73 74 65 70 20 2b 70 ne<br>..+step +p
59b0: 72 6f 6a 3d 61 78 69 73 73 77 61 70 20 2b 6f 72 roj=axisswap +or
59c0: 64 65 72 3d 32 2c 31 3c 62 72 3e 20 0d 0a 2b 73 der=2,1<br> ..+s
59d0: 74 65 70 20 2b 70 72 6f 6a 3d 75 6e 69 74 63 6f tep +proj=unitco
59e0: 6e 76 65 72 74 20 2b 78 79 5f 69 6e 3d 64 65 67 nvert +xy_in=deg
59f0: 20 2b 78 79 5f 6f 75 74 3d 72 61 64 3c 62 72 3e +xy_out=rad<br>
5a00: 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 75 ..+step +proj=pu
5a10: 73 68 20 2b 76 5f 33 3c 62 72 3e 0d 0a 2b 73 74 sh +v_3<br>..+st
5a20: 65 70 20 2b 70 72 6f 6a 3d 63 61 72 74 20 2b 65 ep +proj=cart +e
5a30: 6c 6c 70 73 3d 57 47 53 38 34 3c 62 72 3e 20 0d llps=WGS84<br> .
5a40: 0a 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f .+step +inv +pro
5a50: 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 3d 2d 31 30 j=helmert +x=-10
5a60: 34 2e 31 20 2b 79 3d 2d 34 39 2e 31 20 2b 7a 3d 4.1 +y=-49.1 +z=
5a70: 2d 39 2e 39 20 2b 72 78 3d 30 2e 39 37 31 20 2b -9.9 +rx=0.971 +
5a80: 72 79 3d 2d 32 2e 39 31 37 20 2b 72 7a 3d 30 2e ry=-2.917 +rz=0.
5a90: 37 31 34 20 2b 73 3d 2d 31 31 2e 36 38 20 2b 63 714 +s=-11.68 +c
5aa0: 6f 6e 76 65 6e 74 69 6f 6e 3d 70 6f 73 69 74 69 onvention=positi
5ab0: 6f 6e 5f 76 65 63 74 6f 72 3c 62 72 3e 0d 0a 2b on_vector<br>..+
5ac0: 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d step +inv +proj=
5ad0: 63 61 72 74 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c cart +ellps=intl
5ae0: 3c 62 72 3e 0d 0a 2b 73 74 65 70 20 2b 70 72 6f <br>..+step +pro
5af0: 6a 3d 70 6f 70 20 2b 76 5f 33 3c 62 72 3e 20 0d j=pop +v_3<br> .
5b00: 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 74 6d 65 .+step +proj=tme
5b10: 72 63 20 2b 6c 61 74 5f 30 3d 30 20 2b 6c 6f 6e rc +lat_0=0 +lon
5b20: 5f 30 3d 39 20 2b 6b 3d 30 2e 39 39 39 36 20 2b _0=9 +k=0.9996 +
5b30: 78 5f 30 3d 31 35 30 30 30 30 30 20 2b 79 5f 30 x_0=1500000 +y_0
5b40: 3d 30 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c 3c 2f =0 +ellps=intl</
5b50: 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a b></li>..</ul>..
5b60: 3c 2f 75 6c 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 </ul>..</td></tr
5b70: 3e 0d 0a 3c 74 72 3e 3c 74 64 20 63 6f 6c 73 70 >..<tr><td colsp
5b80: 61 6e 3d 22 33 22 3e 0d 0a 3c 68 33 3e 4e 6f 74 an="3">..<h3>Not
5b90: 65 73 3c 2f 68 33 3e 0d 0a 3c 75 6c 3e 0d 0a 3c es</h3>..<ul>..<
5ba0: 6c 69 3e 53 70 61 74 69 61 4c 69 74 65 20 64 6f li>SpatiaLite do
5bb0: 65 73 20 6e 6f 74 20 63 6f 6e 73 74 72 61 69 6e es not constrain
5bc0: 74 73 20 79 6f 75 20 69 6e 20 61 6e 79 20 77 61 ts you in any wa
5bd0: 79 20 61 6e 64 20 66 75 6c 6c 79 20 72 65 73 70 y and fully resp
5be0: 65 63 74 73 20 75 73 65 72 73 20 66 72 65 65 64 ects users freed
5bf0: 6f 6d 20 63 61 72 65 66 75 6c 6c 79 20 61 76 6f om carefully avo
5c00: 69 64 69 6e 67 20 3c 69 3e 61 75 74 6f 2d 6d 61 iding <i>auto-ma
5c10: 67 69 63 61 6c 3c 2f 69 3e 20 61 73 73 75 6d 70 gical</i> assump
5c20: 74 69 6f 6e 73 2e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c tions...<ul>..<l
5c30: 69 3e 54 68 65 20 6e 65 77 20 3c 62 3e 3c 69 3e i>The new <b><i>
5c40: 65 78 74 65 6e 64 65 64 20 73 69 67 6e 61 74 75 extended signatu
5c50: 72 65 73 3c 2f 69 3e 3c 2f 62 3e 20 73 75 70 70 res</i></b> supp
5c60: 6f 72 74 65 64 20 62 79 20 3c 62 3e 53 54 5f 54 orted by <b>ST_T
5c70: 72 61 6e 73 66 6f 72 6d 3c 2f 62 3e 20 63 6c 6f ransform</b> clo
5c80: 73 65 6c 79 20 6d 69 6d 69 63 20 74 68 65 20 6d sely mimic the m
5c90: 6f 73 74 20 72 65 63 65 6e 74 20 50 52 4f 4a 2e ost recent PROJ.
5ca0: 36 20 41 50 49 2c 20 73 6f 20 79 6f 75 20 61 72 6 API, so you ar
5cb0: 65 20 66 72 65 65 20 74 6f 20 64 65 66 69 6e 65 e free to define
5cc0: 20 79 6f 75 72 20 63 6f 6f 72 64 69 6e 61 74 65 your coordinate
5cd0: 73 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e s transformation
5ce0: 73 20 69 6e 20 73 65 76 65 72 61 6c 20 64 69 66 s in several dif
5cf0: 66 65 72 65 6e 74 20 77 61 79 73 2e 3c 2f 6c 69 ferent ways.</li
5d00: 3e 20 0d 0a 3c 6c 69 3e 54 68 65 20 64 65 66 61 > ..<li>The defa
5d10: 75 6c 74 20 62 65 68 61 76 69 6f 72 20 6f 66 20 ult behavior of
5d20: 53 70 61 74 69 61 4c 69 74 65 20 77 68 65 6e 20 SpatiaLite when
5d30: 75 73 69 6e 67 20 50 52 4f 4a 2e 36 20 69 73 20 using PROJ.6 is
5d40: 74 6f 20 63 6f 6d 70 6c 65 74 65 6c 79 20 69 67 to completely ig
5d50: 6e 6f 72 65 20 74 68 65 20 43 52 53 20 64 65 66 nore the CRS def
5d60: 69 6e 69 74 69 6f 6e 73 20 73 74 6f 72 65 64 20 initions stored
5d70: 77 69 74 68 69 6e 20 74 68 65 20 69 6e 74 65 72 within the inter
5d80: 6e 61 6c 20 74 61 62 6c 65 20 3c 62 3e 73 70 61 nal table <b>spa
5d90: 74 69 61 6c 5f 72 65 66 5f 73 79 73 3c 2f 62 3e tial_ref_sys</b>
5da0: 3c 62 72 3e 0d 0a 41 6e 79 20 72 65 71 75 69 72 <br>..Any requir
5db0: 65 64 20 43 52 53 20 64 65 66 69 6e 69 74 69 6f ed CRS definitio
5dc0: 6e 20 77 69 6c 6c 20 62 65 20 61 6c 77 61 79 73 n will be always
5dd0: 20 72 65 74 72 69 65 76 65 64 20 66 72 6f 6d 20 retrieved from
5de0: 50 52 4f 4a 2e 36 20 69 74 73 65 6c 66 20 74 68 PROJ.6 itself th
5df0: 61 74 20 77 69 6c 6c 20 73 69 6d 70 6c 79 20 72 at will simply r
5e00: 65 63 65 69 76 65 20 61 20 72 65 71 75 65 73 74 eceive a request
5e10: 20 69 6e 20 74 68 65 20 66 6f 72 6d 20 3c 62 3e in the form <b>
5e20: 3c 69 3e 66 72 6f 6d 20 45 50 53 47 3a 33 32 36 <i>from EPSG:326
5e30: 33 32 20 74 6f 20 45 50 53 47 3a 33 30 30 33 3c 32 to EPSG:3003<
5e40: 2f 69 3e 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c /i></b>.</li>..<
5e50: 6c 69 3e 49 66 20 79 6f 75 20 68 61 76 65 20 61 li>If you have a
5e60: 6e 79 20 67 6f 6f 64 20 72 65 61 73 6f 6e 20 73 ny good reason s
5e70: 75 67 67 65 73 74 69 6e 67 20 74 6f 20 64 6f 20 uggesting to do
5e80: 73 75 63 68 20 61 20 74 68 69 6e 67 2c 20 79 6f such a thing, yo
5e90: 75 20 61 72 65 20 61 6e 79 77 61 79 20 66 72 65 u are anyway fre
5ea0: 65 20 74 6f 20 75 73 65 20 61 6e 79 20 6b 69 6e e to use any kin
5eb0: 64 20 6f 66 20 70 72 6f 6a 2d 73 74 72 69 6e 67 d of proj-string
5ec0: 73 2c 20 57 4b 54 20 64 65 66 69 6e 69 74 69 6f s, WKT definitio
5ed0: 6e 73 20 6f 72 20 43 52 53 20 6e 61 6d 65 73 20 ns or CRS names
5ee0: 73 75 70 70 6f 72 74 65 64 20 62 79 20 50 52 4f supported by PRO
5ef0: 4a 2e 36 3c 2f 62 3e 2e 3c 62 72 3e 0d 0a 42 75 J.6</b>.<br>..Bu
5f00: 74 20 74 68 69 73 20 69 73 20 75 6e 64 65 72 20 t this is under
5f10: 79 6f 75 72 20 66 75 6c 6c 20 72 65 73 70 6f 6e your full respon
5f20: 73 69 62 69 6c 69 74 79 2c 20 61 6e 64 20 79 6f sibility, and yo
5f30: 75 20 6d 75 73 74 20 62 65 20 77 65 6c 6c 20 73 u must be well s
5f40: 65 6c 66 2d 63 6f 6e 73 63 69 6f 75 73 20 6f 66 elf-conscious of
5f50: 20 77 68 61 74 20 61 72 65 20 79 6f 75 20 64 6f what are you do
5f60: 69 6e 67 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e ing.</li>..</ul>
5f70: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 53 70 61 74 69 </li>..<li>Spati
5f80: 61 4c 69 74 65 20 65 6e 63 6f 75 72 61 67 65 73 aLite encourages
5f90: 20 61 6e 64 20 70 72 6f 6d 6f 74 65 73 20 74 68 and promotes th
5fa0: 65 20 6d 6f 73 74 20 63 72 65 61 74 69 76 65 20 e most creative
5fb0: 75 73 65 73 20 6f 66 20 50 52 4f 4a 2e 36 2c 20 uses of PROJ.6,
5fc0: 74 68 69 73 20 69 6e 63 6c 75 64 69 6e 67 20 75 this including u
5fd0: 73 69 6e 67 20 79 6f 75 72 20 6f 77 6e 20 63 75 sing your own cu
5fe0: 73 74 6f 6d 69 7a 65 64 20 3c 62 3e 74 72 61 6e stomized <b>tran
5ff0: 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 6c sformation pipel
6000: 69 6e 65 73 3c 2f 62 3e 2e 3c 62 72 3e 0d 0a 43 ines</b>.<br>..C
6010: 6f 72 72 65 63 74 6c 79 20 75 73 69 6e 67 20 63 orrectly using c
6020: 75 73 74 6f 6d 20 74 72 61 6e 73 66 6f 72 6d 61 ustom transforma
6030: 74 69 6f 6e 73 20 69 73 6e 27 74 20 6e 65 63 65 tions isn't nece
6040: 73 73 61 72 69 6c 79 20 73 69 6d 70 6c 65 20 61 ssarily simple a
6050: 6e 64 20 65 61 73 79 2c 20 62 75 74 20 69 74 27 nd easy, but it'
6060: 73 20 61 20 62 69 67 20 6f 70 70 6f 72 74 75 6e s a big opportun
6070: 69 74 79 20 66 6f 72 20 61 6c 6c 20 73 6b 69 6c ity for all skil
6080: 6c 65 64 20 61 6e 64 20 74 61 6c 65 6e 74 65 64 led and talented
6090: 20 70 6f 77 65 72 20 75 73 65 72 73 2e 3c 2f 6c power users.</l
60a0: 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 3c 62 72 i>..</ul><br><br
60b0: 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c >..</td></tr>..<
60c0: 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 46 65 77 /table><br>..Few
60d0: 20 70 72 61 63 74 69 63 61 6c 20 53 51 4c 20 65 practical SQL e
60e0: 78 61 6d 70 6c 65 73 3a 0d 0a 3c 76 65 72 62 61 xamples:..<verba
60f0: 74 69 6d 3e 0d 0a 2d 2d 20 66 72 6f 6d 20 45 50 tim>..-- from EP
6100: 53 47 3a 34 33 32 36 20 74 6f 20 45 50 53 47 3a SG:4326 to EPSG:
6110: 33 30 30 33 20 2d 20 64 65 66 61 75 6c 74 20 73 3003 - default s
6120: 65 74 74 69 6e 67 73 3b 20 69 67 6e 6f 72 69 6e ettings; ignorin
6130: 67 20 73 70 61 74 69 61 6c 69 74 65 5f 72 65 66 g spatialite_ref
6140: 5f 73 79 73 20 61 6e 64 20 72 65 6c 79 69 6e 67 _sys and relying
6150: 20 6f 6e 20 50 52 4f 4a 2e 36 20 6f 77 6e 20 70 on PROJ.6 own p
6160: 72 69 76 61 74 65 20 64 61 74 61 62 61 73 65 0d rivate database.
6170: 0a 53 45 4c 45 43 54 20 41 73 45 57 4b 54 20 28 .SELECT AsEWKT (
6180: 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d ST_Transform( M
6190: 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 38 akePoint( 11.878
61a0: 30 35 36 20 2c 20 34 33 2e 34 36 33 30 35 36 20 056 , 43.463056
61b0: 2c 20 34 33 32 36 20 29 20 2c 20 33 30 30 33 20 , 4326 ) , 3003
61c0: 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ));..-----------
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 0d 0a 53 52 49 44 ----------..SRID
61f0: 3d 33 30 30 33 3b 50 4f 49 4e 54 28 31 37 33 32 =3003;POINT(1732
6200: 38 35 32 2e 39 34 32 37 31 36 37 36 39 20 34 38 852.942716769 48
6210: 31 36 32 37 37 2e 36 31 37 36 39 30 36 37 34 29 16277.617690674)
6220: 0d 0a 0d 0a 0d 0a 2d 2d 20 66 72 6f 6d 20 45 50 ......-- from EP
6230: 53 47 3a 34 33 32 36 20 74 6f 20 45 50 53 47 3a SG:4326 to EPSG:
6240: 33 30 30 33 20 2d 20 65 78 61 63 74 6c 79 20 74 3003 - exactly t
6250: 68 65 20 73 61 6d 65 20 61 73 20 61 62 6f 76 65 he same as above
6260: 2c 20 62 75 74 20 74 68 69 73 20 74 69 6d 65 20 , but this time
6270: 69 6e 20 61 6e 20 65 78 70 6c 69 63 69 74 20 66 in an explicit f
6280: 6f 72 6d 0d 0a 53 45 4c 45 43 54 20 41 73 45 57 orm..SELECT AsEW
6290: 4b 54 20 28 20 53 54 5f 54 72 61 6e 73 66 6f 72 KT ( ST_Transfor
62a0: 6d 28 20 4d 61 6b 65 50 6f 69 6e 74 28 20 31 31 m( MakePoint( 11
62b0: 2e 38 37 38 30 35 36 20 2c 20 34 33 2e 34 36 33 .878056 , 43.463
62c0: 30 35 36 2c 20 34 33 32 36 20 29 20 2c 20 33 30 056, 4326 ) , 30
62d0: 30 33 2c 20 4e 55 4c 4c 2c 20 27 45 50 53 47 3a 03, NULL, 'EPSG:
62e0: 34 33 32 36 27 2c 20 27 45 50 53 47 3a 33 30 30 4326', 'EPSG:300
62f0: 33 27 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 3'));..---------
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 0d 0a 53 52 ------------..SR
6320: 49 44 3d 33 30 30 33 3b 50 4f 49 4e 54 28 31 37 ID=3003;POINT(17
6330: 33 32 38 35 32 2e 39 34 32 37 31 36 37 36 39 20 32852.942716769
6340: 34 38 31 36 32 37 37 2e 36 31 37 36 39 30 36 37 4816277.61769067
6350: 34 29 0d 0a 0d 0a 0d 0a 2d 2d 20 66 72 6f 6d 20 4)......-- from
6360: 45 50 53 47 3a 34 33 32 36 20 74 6f 20 45 50 53 EPSG:4326 to EPS
6370: 47 3a 33 30 30 33 20 2d 20 73 61 6d 65 20 61 73 G:3003 - same as
6380: 20 61 62 6f 76 65 2c 20 75 73 69 6e 67 20 74 68 above, using th
6390: 65 20 61 6c 74 65 72 6e 61 74 69 76 65 20 6e 6f e alternative no
63a0: 74 61 74 69 6f 6e 0d 0a 53 45 4c 45 43 54 20 41 tation..SELECT A
63b0: 73 45 57 4b 54 20 28 20 53 54 5f 54 72 61 6e 73 sEWKT ( ST_Trans
63c0: 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 6e 74 28 form( MakePoint(
63d0: 20 31 31 2e 38 37 38 30 35 36 20 2c 20 34 33 2e 11.878056 , 43.
63e0: 34 36 33 30 35 36 2c 20 34 33 32 36 20 29 20 2c 463056, 4326 ) ,
63f0: 20 33 30 30 33 2c 20 4e 55 4c 4c 2c 20 27 75 72 3003, NULL, 'ur
6400: 6e 3a 6f 67 63 3a 64 65 66 3a 63 72 73 3a 45 50 n:ogc:def:crs:EP
6410: 53 47 3a 3a 34 33 32 36 27 2c 20 27 75 72 6e 3a SG::4326', 'urn:
6420: 6f 67 63 3a 64 65 66 3a 63 72 73 3a 45 50 53 47 ogc:def:crs:EPSG
6430: 3a 3a 33 30 30 33 27 29 29 3b 0d 0a 2d 2d 2d 2d ::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 0d 0a 53 52 49 44 3d 33 30 30 33 3b 50 4f 49 -..SRID=3003;POI
6470: 4e 54 28 31 37 33 32 38 35 32 2e 39 34 32 37 31 NT(1732852.94271
6480: 36 37 36 39 20 34 38 31 36 32 37 37 2e 36 31 37 6769 4816277.617
6490: 36 39 30 36 37 34 29 0d 0a 0d 0a 0d 0a 2d 2d 20 690674)......--
64a0: 66 72 6f 6d 20 45 50 53 47 3a 34 33 32 36 20 74 from EPSG:4326 t
64b0: 6f 20 45 50 53 47 3a 33 30 30 33 20 2d 20 65 78 o EPSG:3003 - ex
64c0: 70 6c 69 63 69 74 6c 79 20 70 61 73 73 69 6e 67 plicitly passing
64d0: 20 43 52 53 20 6e 61 6d 65 73 0d 0a 53 45 4c 45 CRS names..SELE
64e0: 43 54 20 41 73 45 57 4b 54 20 28 20 53 54 5f 54 CT AsEWKT ( ST_T
64f0: 72 61 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f ransform( MakePo
6500: 69 6e 74 28 20 31 31 2e 38 37 38 30 35 36 20 2c int( 11.878056 ,
6510: 20 34 33 2e 34 36 33 30 35 36 2c 20 34 33 32 36 43.463056, 4326
6520: 20 29 20 2c 20 33 30 30 33 2c 20 4e 55 4c 4c 2c ) , 3003, NULL,
6530: 20 27 57 47 53 20 38 34 27 2c 20 27 4d 6f 6e 74 'WGS 84', 'Mont
6540: 65 20 4d 61 72 69 6f 20 2f 20 49 74 61 6c 79 20 e Mario / Italy
6550: 7a 6f 6e 65 20 31 27 29 29 3b 0d 0a 2d 2d 2d 2d 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 0d 0a 53 52 49 44 3d 33 30 30 33 3b 50 4f 49 -..SRID=3003;POI
6590: 4e 54 28 31 37 33 32 38 35 32 2e 39 34 32 37 31 NT(1732852.94271
65a0: 36 37 36 39 20 34 38 31 36 32 37 37 2e 36 31 37 6769 4816277.617
65b0: 36 39 30 36 37 34 29 0d 0a 0d 0a 0d 0a 2d 2d 20 690674)......--
65c0: 66 72 6f 6d 20 45 50 53 47 3a 34 33 32 36 20 74 from EPSG:4326 t
65d0: 6f 20 45 50 53 47 3a 33 30 30 33 20 2d 20 73 69 o EPSG:3003 - si
65e0: 6d 75 6c 61 74 69 6e 67 20 74 68 65 20 63 6c 61 mulating the cla
65f0: 73 73 69 63 20 50 52 4f 4a 2e 34 20 61 70 70 72 ssic PROJ.4 appr
6600: 6f 61 63 68 20 62 61 73 65 64 20 6f 6e 20 70 72 oach based on pr
6610: 6f 6a 2d 73 74 72 69 6e 67 73 20 73 74 6f 72 65 oj-strings store
6620: 64 20 69 6e 74 6f 20 73 70 61 74 69 61 6c 5f 72 d into spatial_r
6630: 65 66 5f 73 79 73 0d 0a 53 45 4c 45 43 54 20 41 ef_sys..SELECT A
6640: 73 45 57 4b 54 20 28 20 53 54 5f 54 72 61 6e 73 sEWKT ( ST_Trans
6650: 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 6e 74 28 form( MakePoint(
6660: 20 31 31 2e 38 37 38 30 35 36 20 2c 20 34 33 2e 11.878056 , 43.
6670: 34 36 33 30 35 36 2c 20 34 33 32 36 20 29 20 2c 463056, 4326 ) ,
6680: 20 33 30 30 33 20 2c 20 4e 55 4c 4c 20 2c 20 0d 3003 , NULL , .
6690: 0a 20 20 28 53 45 4c 45 43 54 20 70 72 6f 6a 34 . (SELECT proj4
66a0: 74 65 78 74 20 46 52 4f 4d 20 73 70 61 74 69 61 text FROM spatia
66b0: 6c 5f 72 65 66 5f 73 79 73 20 57 48 45 52 45 20 l_ref_sys WHERE
66c0: 73 72 69 64 20 3d 20 34 33 32 36 29 2c 0d 0a 20 srid = 4326),..
66d0: 20 28 53 45 4c 45 43 54 20 70 72 6f 6a 34 74 65 (SELECT proj4te
66e0: 78 74 20 46 52 4f 4d 20 73 70 61 74 69 61 6c 5f xt FROM spatial_
66f0: 72 65 66 5f 73 79 73 20 57 48 45 52 45 20 73 72 ref_sys WHERE sr
6700: 69 64 20 3d 20 33 30 30 33 29 29 29 3b 0d 0a 2d id = 3003)));..-
6710: 2d 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 0d 0a 53 52 49 44 3d 33 30 30 33 3b ----..SRID=3003;
6740: 50 4f 49 4e 54 28 31 37 33 32 38 35 32 2e 39 34 POINT(1732852.94
6750: 32 37 31 36 37 36 39 20 34 38 31 36 32 37 37 2e 2716769 4816277.
6760: 36 31 37 36 39 30 36 37 34 29 0d 0a 0d 0a 0d 0a 617690674)......
6770: 2d 2d 20 66 72 6f 6d 20 45 50 53 47 3a 34 33 32 -- from EPSG:432
6780: 36 20 74 6f 20 45 50 53 47 3a 33 30 30 33 20 2d 6 to EPSG:3003 -
6790: 20 66 61 6e 63 79 20 6d 6f 64 65 20 62 61 73 65 fancy mode base
67a0: 64 20 6f 6e 20 57 4b 54 20 65 78 70 72 65 73 73 d on WKT express
67b0: 69 6f 6e 73 20 73 74 6f 72 65 64 20 69 6e 74 6f ions stored into
67c0: 20 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 spatial_ref_sys
67d0: 0d 0a 53 45 4c 45 43 54 20 41 73 45 57 4b 54 20 ..SELECT AsEWKT
67e0: 28 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 ( ST_Transform(
67f0: 4d 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 MakePoint( 11.87
6800: 38 30 35 36 20 2c 20 34 33 2e 34 36 33 30 35 36 8056 , 43.463056
6810: 2c 20 34 33 32 36 20 29 20 2c 20 33 30 30 33 2c , 4326 ) , 3003,
6820: 20 4e 55 4c 4c 2c 20 0d 0a 20 20 28 53 45 4c 45 NULL, .. (SELE
6830: 43 54 20 73 72 74 65 78 74 20 46 52 4f 4d 20 73 CT srtext FROM s
6840: 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 20 57 patial_ref_sys W
6850: 48 45 52 45 20 73 72 69 64 20 3d 20 34 33 32 36 HERE srid = 4326
6860: 29 2c 0d 0a 20 20 28 53 45 4c 45 43 54 20 73 72 ),.. (SELECT sr
6870: 74 65 78 74 20 46 52 4f 4d 20 73 70 61 74 69 61 text FROM spatia
6880: 6c 5f 72 65 66 5f 73 79 73 20 57 48 45 52 45 20 l_ref_sys WHERE
6890: 73 72 69 64 20 3d 20 33 30 30 33 29 29 29 3b 0d srid = 3003)));.
68a0: 0a 2d 2d 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 0d 0a 53 52 49 44 3d 33 30 30 ------..SRID=300
68d0: 33 3b 50 4f 49 4e 54 28 31 37 33 32 38 35 32 2e 3;POINT(1732852.
68e0: 39 34 32 37 31 36 37 36 39 20 34 38 31 36 32 37 942716769 481627
68f0: 37 2e 36 31 37 36 39 30 36 37 34 29 0d 0a 3c 2f 7.617690674)..</
6900: 76 65 72 62 61 74 69 6d 3e 0d 0a 54 68 69 73 20 verbatim>..This
6910: 66 69 72 73 74 20 74 65 73 74 20 69 73 20 62 61 first test is ba
6920: 73 65 64 20 6f 6e 20 61 20 6e 65 77 20 53 70 61 sed on a new Spa
6930: 74 69 61 4c 69 74 65 20 64 61 74 61 62 61 73 65 tiaLite database
6940: 20 63 72 65 61 74 65 64 20 77 69 74 68 20 66 75 created with fu
6950: 6c 6c 20 50 52 4f 4a 2e 36 20 73 75 70 70 6f 72 ll PROJ.6 suppor
6960: 74 2e 20 54 68 65 72 65 20 69 73 6e 27 74 20 61 t. There isn't a
6970: 6e 79 74 68 69 6e 67 20 77 6f 72 74 68 20 74 6f nything worth to
6980: 20 62 65 20 6e 6f 74 65 64 2c 20 65 78 63 65 70 be noted, excep
6990: 74 20 74 68 61 74 20 61 6c 6c 20 6d 65 74 68 6f t that all metho
69a0: 64 73 20 72 65 74 75 72 6e 20 74 68 65 20 73 61 ds return the sa
69b0: 6d 65 20 72 65 73 75 6c 74 73 2e 3c 62 72 3e 3c me results.<br><
69c0: 62 72 3e 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d br>..<verbatim>.
69d0: 0a 2d 2d 20 66 72 6f 6d 20 45 50 53 47 3a 34 33 .-- from EPSG:43
69e0: 32 36 20 74 6f 20 45 50 53 47 3a 33 30 30 33 20 26 to EPSG:3003
69f0: 2d 20 75 73 69 6e 67 20 61 20 74 72 61 6e 73 66 - using a transf
6a00: 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 6c 69 6e ormation pipelin
6a10: 65 0d 0a 53 45 4c 45 43 54 20 41 73 45 57 4b 54 e..SELECT AsEWKT
6a20: 20 28 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 ( ST_Transform(
6a30: 20 53 77 61 70 43 6f 6f 72 64 73 20 28 20 4d 61 SwapCoords ( Ma
6a40: 6b 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 38 30 kePoint( 11.8780
6a50: 35 36 20 2c 20 34 33 2e 34 36 33 30 35 36 2c 20 56 , 43.463056,
6a60: 34 33 32 36 20 29 20 29 20 2c 20 33 30 30 33 20 4326 ) ) , 3003
6a70: 2c 20 4e 55 4c 4c 20 2c 0d 0a 27 2b 70 72 6f 6a , NULL ,..'+proj
6a80: 3d 70 69 70 65 6c 69 6e 65 20 0d 0a 2b 73 74 65 =pipeline ..+ste
6a90: 70 20 2b 70 72 6f 6a 3d 61 78 69 73 73 77 61 70 p +proj=axisswap
6aa0: 20 2b 6f 72 64 65 72 3d 32 2c 31 20 0d 0a 2b 73 +order=2,1 ..+s
6ab0: 74 65 70 20 2b 70 72 6f 6a 3d 75 6e 69 74 63 6f tep +proj=unitco
6ac0: 6e 76 65 72 74 20 2b 78 79 5f 69 6e 3d 64 65 67 nvert +xy_in=deg
6ad0: 20 2b 78 79 5f 6f 75 74 3d 72 61 64 20 0d 0a 2b +xy_out=rad ..+
6ae0: 73 74 65 70 20 2b 70 72 6f 6a 3d 70 75 73 68 20 step +proj=push
6af0: 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 +v_3 ..+step +pr
6b00: 6f 6a 3d 63 61 72 74 20 2b 65 6c 6c 70 73 3d 57 oj=cart +ellps=W
6b10: 47 53 38 34 20 0d 0a 2b 73 74 65 70 20 2b 69 6e GS84 ..+step +in
6b20: 76 20 2b 70 72 6f 6a 3d 68 65 6c 6d 65 72 74 20 v +proj=helmert
6b30: 2b 78 3d 2d 31 30 34 2e 31 20 2b 79 3d 2d 34 39 +x=-104.1 +y=-49
6b40: 2e 31 20 2b 7a 3d 2d 39 2e 39 20 2b 72 78 3d 30 .1 +z=-9.9 +rx=0
6b50: 2e 39 37 31 20 2b 72 79 3d 2d 32 2e 39 31 37 20 .971 +ry=-2.917
6b60: 2b 72 7a 3d 30 2e 37 31 34 20 2b 73 3d 2d 31 31 +rz=0.714 +s=-11
6b70: 2e 36 38 20 2b 63 6f 6e 76 65 6e 74 69 6f 6e 3d .68 +convention=
6b80: 70 6f 73 69 74 69 6f 6e 5f 76 65 63 74 6f 72 20 position_vector
6b90: 0d 0a 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 ..+step +inv +pr
6ba0: 6f 6a 3d 63 61 72 74 20 2b 65 6c 6c 70 73 3d 69 oj=cart +ellps=i
6bb0: 6e 74 6c 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f ntl ..+step +pro
6bc0: 6a 3d 70 6f 70 20 2b 76 5f 33 20 0d 0a 2b 73 74 j=pop +v_3 ..+st
6bd0: 65 70 20 2b 70 72 6f 6a 3d 74 6d 65 72 63 20 2b ep +proj=tmerc +
6be0: 6c 61 74 5f 30 3d 30 20 2b 6c 6f 6e 5f 30 3d 39 lat_0=0 +lon_0=9
6bf0: 20 2b 6b 3d 30 2e 39 39 39 36 20 2b 78 5f 30 3d +k=0.9996 +x_0=
6c00: 31 35 30 30 30 30 30 20 2b 79 5f 30 3d 30 20 2b 1500000 +y_0=0 +
6c10: 65 6c 6c 70 73 3d 69 6e 74 6c 27 20 29 29 3b 0d ellps=intl' ));.
6c20: 0a 2d 2d 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 0d 0a 53 52 49 44 3d 33 30 30 ------..SRID=300
6c50: 33 3b 50 4f 49 4e 54 28 31 37 33 32 38 35 32 2e 3;POINT(1732852.
6c60: 39 34 32 37 31 36 37 36 39 20 34 38 31 36 32 37 942716769 481627
6c70: 37 2e 36 31 37 36 39 30 36 37 34 29 0d 0a 0d 0a 7.617690674)....
6c80: 0d 0a 2d 2d 20 66 72 6f 6d 20 45 50 53 47 3a 34 ..-- from EPSG:4
6c90: 33 32 36 20 74 6f 20 45 50 53 47 3a 33 30 30 33 326 to EPSG:3003
6ca0: 20 2d 20 75 73 69 6e 67 20 61 20 63 75 73 74 6f - using a custo
6cb0: 6d 69 7a 65 64 20 74 72 61 6e 73 66 6f 72 6d 61 mized transforma
6cc0: 74 69 6f 6e 20 70 69 70 65 6c 69 6e 65 0d 0a 53 tion pipeline..S
6cd0: 45 4c 45 43 54 20 41 73 45 57 4b 54 20 28 20 53 ELECT AsEWKT ( S
6ce0: 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d 61 6b T_Transform( Mak
6cf0: 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 38 30 35 ePoint( 11.87805
6d00: 36 20 2c 20 34 33 2e 34 36 33 30 35 36 2c 20 34 6 , 43.463056, 4
6d10: 33 32 36 20 29 20 2c 20 33 30 30 33 20 2c 20 4e 326 ) , 3003 , N
6d20: 55 4c 4c 20 2c 0d 0a 27 2b 70 72 6f 6a 3d 70 69 ULL ,..'+proj=pi
6d30: 70 65 6c 69 6e 65 20 20 0d 0a 2b 73 74 65 70 20 peline ..+step
6d40: 2b 70 72 6f 6a 3d 75 6e 69 74 63 6f 6e 76 65 72 +proj=unitconver
6d50: 74 20 2b 78 79 5f 69 6e 3d 64 65 67 20 2b 78 79 t +xy_in=deg +xy
6d60: 5f 6f 75 74 3d 72 61 64 20 0d 0a 2b 73 74 65 70 _out=rad ..+step
6d70: 20 2b 70 72 6f 6a 3d 70 75 73 68 20 2b 76 5f 33 +proj=push +v_3
6d80: 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 63 ..+step +proj=c
6d90: 61 72 74 20 2b 65 6c 6c 70 73 3d 57 47 53 38 34 art +ellps=WGS84
6da0: 20 0d 0a 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 ..+step +inv +p
6db0: 72 6f 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 3d 2d roj=helmert +x=-
6dc0: 31 30 34 2e 31 20 2b 79 3d 2d 34 39 2e 31 20 2b 104.1 +y=-49.1 +
6dd0: 7a 3d 2d 39 2e 39 20 2b 72 78 3d 30 2e 39 37 31 z=-9.9 +rx=0.971
6de0: 20 2b 72 79 3d 2d 32 2e 39 31 37 20 2b 72 7a 3d +ry=-2.917 +rz=
6df0: 30 2e 37 31 34 20 2b 73 3d 2d 31 31 2e 36 38 20 0.714 +s=-11.68
6e00: 2b 63 6f 6e 76 65 6e 74 69 6f 6e 3d 70 6f 73 69 +convention=posi
6e10: 74 69 6f 6e 5f 76 65 63 74 6f 72 20 0d 0a 2b 73 tion_vector ..+s
6e20: 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d 63 tep +inv +proj=c
6e30: 61 72 74 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20 art +ellps=intl
6e40: 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 6f ..+step +proj=po
6e50: 70 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b p +v_3 ..+step +
6e60: 70 72 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 5f proj=tmerc +lat_
6e70: 30 3d 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 0=0 +lon_0=9 +k=
6e80: 30 2e 39 39 39 36 20 2b 78 5f 30 3d 31 35 30 30 0.9996 +x_0=1500
6e90: 30 30 30 20 2b 79 5f 30 3d 30 20 2b 65 6c 6c 70 000 +y_0=0 +ellp
6ea0: 73 3d 69 6e 74 6c 27 20 29 29 3b 0d 0a 2d 2d 2d s=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 0d 0a 53 52 49 44 3d 33 30 30 33 3b 50 4f --..SRID=3003;PO
6ee0: 49 4e 54 28 31 37 33 32 38 35 32 2e 39 34 32 37 INT(1732852.9427
6ef0: 31 36 37 36 39 20 34 38 31 36 32 37 37 2e 36 31 16769 4816277.61
6f00: 37 36 39 30 36 37 34 29 0d 0a 3c 2f 76 65 72 62 7690674)..</verb
6f10: 61 74 69 6d 3e 0d 0a 54 68 69 73 20 73 65 63 6f atim>..This seco
6f20: 6e 64 20 74 65 73 74 20 69 73 20 62 61 73 65 64 nd test is based
6f30: 20 6f 6e 20 75 73 69 6e 67 20 3c 62 3e 3c 69 3e on using <b><i>
6f40: 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 transformation p
6f50: 69 70 65 6c 69 6e 65 73 3c 2f 69 3e 3c 2f 62 3e ipelines</i></b>
6f60: 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 74 68 65 :..<ul>..<li>the
6f70: 20 66 69 72 73 74 20 71 75 65 72 79 20 64 69 72 first query dir
6f80: 65 63 74 6c 79 20 75 73 65 73 20 61 20 63 61 6e ectly uses a can
6f90: 6f 6e 69 63 61 6c 20 73 74 72 69 6e 67 20 72 65 onical string re
6fa0: 70 72 65 73 65 6e 74 69 6e 67 20 74 68 65 20 70 presenting the p
6fb0: 69 70 65 6c 69 6e 65 20 61 73 20 72 65 74 75 72 ipeline as retur
6fc0: 6e 69 6e 67 20 62 79 20 74 68 69 73 20 63 6f 6d ning by this com
6fd0: 6d 61 6e 64 20 65 78 65 63 75 74 65 64 20 66 72 mand executed fr
6fe0: 6f 6d 20 74 68 65 20 73 68 65 6c 6c 3a 0d 0a 3c om the shell:..<
6ff0: 76 65 72 62 61 74 69 6d 3e 0d 0a 70 72 6f 6a 69 verbatim>..proji
7000: 6e 66 6f 20 20 2d 73 20 45 50 53 47 3a 34 33 32 nfo -s EPSG:432
7010: 36 20 2d 74 20 45 50 53 47 3a 33 30 30 33 20 2d 6 -t EPSG:3003 -
7020: 2d 61 72 65 61 20 20 22 49 74 61 6c 79 20 2d 20 -area "Italy -
7030: 6d 61 69 6e 6c 61 6e 64 22 20 2d 6f 20 70 72 6f mainland" -o pro
7040: 6a 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a j..</verbatim>..
7050: 28 77 65 27 6c 6c 20 73 65 65 20 74 68 69 73 20 (we'll see this
7060: 74 6f 70 69 63 20 69 6e 20 6d 6f 72 65 20 64 65 topic in more de
7070: 70 74 68 20 6f 6e 20 74 68 65 20 6e 65 78 74 20 pth on the next
7080: 73 65 63 74 69 6f 6e 29 2e 3c 2f 6c 69 3e 0d 0a section).</li>..
7090: 3c 6c 69 3e 74 68 65 20 73 65 63 6f 6e 64 20 71 <li>the second q
70a0: 75 65 72 79 20 69 73 20 6a 75 73 74 20 61 20 73 uery is just a s
70b0: 6d 61 6c 6c 20 61 64 61 70 74 61 74 69 6f 6e 20 mall adaptation
70c0: 6f 66 20 74 68 65 20 66 69 72 73 74 20 6f 6e 65 of the first one
70d0: 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 41 73 20 :..<ul>..<li>As
70e0: 79 6f 75 20 63 61 6e 20 6e 6f 74 69 63 65 20 74 you can notice t
70f0: 68 65 20 66 69 72 73 74 20 71 75 65 72 79 20 72 he first query r
7100: 65 71 75 69 72 65 73 20 63 61 6c 6c 69 6e 67 20 equires calling
7110: 3c 62 3e 53 77 61 70 43 6f 6f 64 69 6e 61 74 65 <b>SwapCoodinate
7120: 73 28 29 3c 2f 62 3e 20 62 65 63 61 75 73 65 20 s()</b> because
7130: 74 68 65 20 66 69 72 73 74 20 73 74 65 70 20 6f the first step o
7140: 66 20 74 68 65 20 70 69 70 65 6c 69 6e 65 20 68 f the pipeline h
7150: 61 73 20 61 6e 20 3c 62 3e 61 78 69 73 73 77 61 as an <b>axisswa
7160: 70 3c 2f 62 3e 20 64 69 72 65 63 74 69 76 65 2e p</b> directive.
7170: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 54 68 65 20 73 </li>..<li>The s
7180: 65 63 6f 6e 64 20 71 75 65 72 79 20 6a 75 73 74 econd query just
7190: 20 61 76 6f 69 64 73 20 74 6f 20 63 61 6c 6c 20 avoids to call
71a0: 3c 62 3e 53 77 61 70 43 6f 6f 72 64 73 28 29 3c <b>SwapCoords()<
71b0: 2f 62 3e 20 61 6e 64 20 63 6f 6e 73 65 71 75 65 /b> and conseque
71c0: 6e 74 6c 79 20 74 68 69 73 20 66 69 72 73 74 20 ntly this first
71d0: 73 74 65 70 20 68 61 73 20 62 65 65 6e 20 72 65 step has been re
71e0: 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 20 70 moved from the p
71f0: 69 70 65 6c 69 6e 65 20 73 6f 20 74 6f 20 67 65 ipeline so to ge
7200: 74 20 74 68 65 20 73 61 6d 65 20 69 64 65 6e 74 t the same ident
7210: 69 63 61 6c 20 6f 76 65 72 61 6c 6c 20 65 66 66 ical overall eff
7220: 65 63 74 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e ect.</li>..</ul>
7230: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 3c 75 </li>..<li><b><u
7240: 3e 4e 6f 74 65 3c 2f 75 3e 3c 2f 62 3e 3a 20 53 >Note</u></b>: S
7250: 70 61 74 69 61 4c 69 74 65 20 61 6e 64 20 50 52 patiaLite and PR
7260: 4f 4a 2e 36 20 77 69 6c 6c 20 61 6c 77 61 79 73 OJ.6 will always
7270: 20 64 6f 20 61 20 62 65 73 74 20 65 66 66 6f 72 do a best effor
7280: 74 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 67 75 t in order to gu
7290: 65 73 73 20 69 66 20 73 77 61 70 70 69 6e 67 20 ess if swapping
72a0: 74 68 65 20 63 6f 6f 72 64 69 6e 61 74 65 73 20 the coordinates
72b0: 69 73 20 72 65 71 75 69 72 65 64 20 6f 72 20 6e is required or n
72c0: 6f 74 2e 3c 62 72 3e 0d 0a 42 75 74 20 69 6e 20 ot.<br>..But in
72d0: 74 68 65 20 73 70 65 63 69 66 69 63 20 63 61 73 the specific cas
72e0: 65 20 6f 66 20 74 72 61 6e 73 66 6f 72 6d 61 74 e of transformat
72f0: 69 6f 6e 20 70 69 70 65 6c 69 6e 65 73 20 74 68 ion pipelines th
7300: 65 20 75 73 65 72 20 69 73 20 65 78 70 65 63 74 e user is expect
7310: 65 64 20 74 6f 20 65 78 70 6c 69 63 69 74 6c 79 ed to explicitly
7320: 20 63 61 6c 6c 20 3c 62 3e 53 77 61 70 43 6f 6f call <b>SwapCoo
7330: 72 64 73 28 29 3c 2f 62 3e 20 77 68 65 6e 65 76 rds()</b> whenev
7340: 65 72 20 72 65 71 75 69 72 65 64 2e 3c 2f 6c 69 er required.</li
7350: 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 0d 0a 3c 74 >..</ul><br>..<t
7360: 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 able cellspacing
7370: 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 ="8" cellpadding
7380: 3d 22 31 36 22 20 62 67 63 6f 6c 6f 72 3d 22 23 ="16" bgcolor="#
7390: 63 39 66 66 66 30 22 3e 0d 0a 3c 74 72 3e 3c 74 c9fff0">..<tr><t
73a0: 64 3e 0d 0a 3c 68 32 3e 54 65 63 68 20 4e 6f 74 d>..<h2>Tech Not
73b0: 65 3a 20 75 73 69 6e 67 20 70 72 6f 6a 69 6e 66 e: using projinf
73c0: 6f 20 66 6f 72 20 64 69 73 63 6f 76 65 72 69 6e o for discoverin
73d0: 67 20 70 69 70 65 6c 69 6e 65 73 20 61 6e 64 20 g pipelines and
73e0: 61 72 65 61 73 20 6f 66 20 75 73 65 3c 2f 68 32 areas of use</h2
73f0: 3e 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 70 >..<verbatim>..p
7400: 72 6f 6a 69 6e 66 6f 20 2d 73 20 45 50 53 47 3a rojinfo -s EPSG:
7410: 34 33 32 36 20 2d 74 20 45 50 53 47 3a 33 30 30 4326 -t EPSG:300
7420: 33 20 2d 6f 20 70 72 6f 6a 20 2d 2d 73 70 61 74 3 -o proj --spat
7430: 69 61 6c 2d 74 65 73 74 20 69 6e 74 65 72 73 65 ial-test interse
7440: 63 74 0d 0a 43 61 6e 64 69 64 61 74 65 20 6f 70 ct..Candidate op
7450: 65 72 61 74 69 6f 6e 73 20 66 6f 75 6e 64 3a 20 erations found:
7460: 33 0d 0a 2d 2d 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 0d 0a 4f 70 65 72 61 74 --------..Operat
7490: 69 6f 6e 20 6e c2 b0 31 3a 0d 0a 0d 0a 75 6e 6b ion n..1:....unk
74a0: 6e 6f 77 6e 20 69 64 2c 20 49 6e 76 65 72 73 65 nown id, Inverse
74b0: 20 6f 66 20 4d 6f 6e 74 65 20 4d 61 72 69 6f 20 of Monte Mario
74c0: 74 6f 20 57 47 53 20 38 34 20 28 34 29 20 2b 20 to WGS 84 (4) +
74d0: 49 74 61 6c 79 20 7a 6f 6e 65 20 31 2c 20 34 20 Italy zone 1, 4
74e0: 6d 2c 20 49 74 61 6c 79 20 2d 20 6d 61 69 6e 6c m, Italy - mainl
74f0: 61 6e 64 0d 0a 0d 0a 50 52 4f 4a 20 73 74 72 69 and....PROJ stri
7500: 6e 67 3a 0d 0a 2b 70 72 6f 6a 3d 70 69 70 65 6c ng:..+proj=pipel
7510: 69 6e 65 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f ine ..+step +pro
7520: 6a 3d 61 78 69 73 73 77 61 70 20 2b 6f 72 64 65 j=axisswap +orde
7530: 72 3d 32 2c 31 20 0d 0a 2b 73 74 65 70 20 2b 70 r=2,1 ..+step +p
7540: 72 6f 6a 3d 75 6e 69 74 63 6f 6e 76 65 72 74 20 roj=unitconvert
7550: 2b 78 79 5f 69 6e 3d 64 65 67 20 2b 78 79 5f 6f +xy_in=deg +xy_o
7560: 75 74 3d 72 61 64 20 0d 0a 2b 73 74 65 70 20 2b ut=rad ..+step +
7570: 70 72 6f 6a 3d 70 75 73 68 20 2b 76 5f 33 20 0d proj=push +v_3 .
7580: 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 63 61 72 .+step +proj=car
7590: 74 20 2b 65 6c 6c 70 73 3d 57 47 53 38 34 20 0d t +ellps=WGS84 .
75a0: 0a 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f .+step +inv +pro
75b0: 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 3d 2d 31 30 j=helmert +x=-10
75c0: 34 2e 31 20 2b 79 3d 2d 34 39 2e 31 20 2b 7a 3d 4.1 +y=-49.1 +z=
75d0: 2d 39 2e 39 20 2b 72 78 3d 30 2e 39 37 31 20 2b -9.9 +rx=0.971 +
75e0: 72 79 3d 2d 32 2e 39 31 37 20 2b 72 7a 3d 30 2e ry=-2.917 +rz=0.
75f0: 37 31 34 20 2b 73 3d 2d 31 31 2e 36 38 20 2b 63 714 +s=-11.68 +c
7600: 6f 6e 76 65 6e 74 69 6f 6e 3d 70 6f 73 69 74 69 onvention=positi
7610: 6f 6e 5f 76 65 63 74 6f 72 20 0d 0a 2b 73 74 65 on_vector ..+ste
7620: 70 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d 63 61 72 p +inv +proj=car
7630: 74 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20 0d 0a t +ellps=intl ..
7640: 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 6f 70 20 +step +proj=pop
7650: 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 +v_3 ..+step +pr
7660: 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 5f 30 3d oj=tmerc +lat_0=
7670: 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 2e 0 +lon_0=9 +k=0.
7680: 39 39 39 36 20 2b 78 5f 30 3d 31 35 30 30 30 30 9996 +x_0=150000
7690: 30 20 2b 79 5f 30 3d 30 20 2b 65 6c 6c 70 73 3d 0 +y_0=0 +ellps=
76a0: 69 6e 74 6c 0d 0a 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 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 0d 0a 4f -------------..O
76d0: 70 65 72 61 74 69 6f 6e 20 6e c2 b0 32 3a 0d 0a peration n..2:..
76e0: 0d 0a 75 6e 6b 6e 6f 77 6e 20 69 64 2c 20 49 6e ..unknown id, In
76f0: 76 65 72 73 65 20 6f 66 20 4d 6f 6e 74 65 20 4d verse of Monte M
7700: 61 72 69 6f 20 74 6f 20 57 47 53 20 38 34 20 28 ario to WGS 84 (
7710: 32 29 20 2b 20 49 74 61 6c 79 20 7a 6f 6e 65 20 2) + Italy zone
7720: 31 2c 20 34 20 6d 2c 20 49 74 61 6c 79 20 2d 20 1, 4 m, Italy -
7730: 53 61 72 64 69 6e 69 61 20 6f 6e 73 68 6f 72 65 Sardinia onshore
7740: 0d 0a 0d 0a 50 52 4f 4a 20 73 74 72 69 6e 67 3a ....PROJ string:
7750: 0d 0a 2b 70 72 6f 6a 3d 70 69 70 65 6c 69 6e 65 ..+proj=pipeline
7760: 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 61 ..+step +proj=a
7770: 78 69 73 73 77 61 70 20 2b 6f 72 64 65 72 3d 32 xisswap +order=2
7780: 2c 31 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a ,1 ..+step +proj
7790: 3d 75 6e 69 74 63 6f 6e 76 65 72 74 20 2b 78 79 =unitconvert +xy
77a0: 5f 69 6e 3d 64 65 67 20 2b 78 79 5f 6f 75 74 3d _in=deg +xy_out=
77b0: 72 61 64 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f rad ..+step +pro
77c0: 6a 3d 70 75 73 68 20 2b 76 5f 33 20 0d 0a 2b 73 j=push +v_3 ..+s
77d0: 74 65 70 20 2b 70 72 6f 6a 3d 63 61 72 74 20 2b tep +proj=cart +
77e0: 65 6c 6c 70 73 3d 57 47 53 38 34 20 0d 0a 2b 73 ellps=WGS84 ..+s
77f0: 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d 68 tep +inv +proj=h
7800: 65 6c 6d 65 72 74 20 2b 78 3d 2d 31 36 38 2e 36 elmert +x=-168.6
7810: 20 2b 79 3d 2d 33 34 20 2b 7a 3d 33 38 2e 36 20 +y=-34 +z=38.6
7820: 2b 72 78 3d 2d 30 2e 33 37 34 20 2b 72 79 3d 2d +rx=-0.374 +ry=-
7830: 30 2e 36 37 39 20 2b 72 7a 3d 2d 31 2e 33 37 39 0.679 +rz=-1.379
7840: 20 2b 73 3d 2d 39 2e 34 38 20 2b 63 6f 6e 76 65 +s=-9.48 +conve
7850: 6e 74 69 6f 6e 3d 70 6f 73 69 74 69 6f 6e 5f 76 ntion=position_v
7860: 65 63 74 6f 72 20 0d 0a 2b 73 74 65 70 20 2b 69 ector ..+step +i
7870: 6e 76 20 2b 70 72 6f 6a 3d 63 61 72 74 20 2b 65 nv +proj=cart +e
7880: 6c 6c 70 73 3d 69 6e 74 6c 20 0d 0a 2b 73 74 65 llps=intl ..+ste
7890: 70 20 2b 70 72 6f 6a 3d 70 6f 70 20 2b 76 5f 33 p +proj=pop +v_3
78a0: 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 74 ..+step +proj=t
78b0: 6d 65 72 63 20 2b 6c 61 74 5f 30 3d 30 20 2b 6c merc +lat_0=0 +l
78c0: 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 2e 39 39 39 36 on_0=9 +k=0.9996
78d0: 20 2b 78 5f 30 3d 31 35 30 30 30 30 30 20 2b 79 +x_0=1500000 +y
78e0: 5f 30 3d 30 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c _0=0 +ellps=intl
78f0: 0d 0a 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ....------------
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 0d 0a 4f 70 65 72 61 ---------..Opera
7920: 74 69 6f 6e 20 6e c2 b0 33 3a 0d 0a 0d 0a 75 6e tion n..3:....un
7930: 6b 6e 6f 77 6e 20 69 64 2c 20 49 6e 76 65 72 73 known id, Invers
7940: 65 20 6f 66 20 4d 6f 6e 74 65 20 4d 61 72 69 6f e of Monte Mario
7950: 20 74 6f 20 57 47 53 20 38 34 20 28 31 31 29 20 to WGS 84 (11)
7960: 2b 20 49 74 61 6c 79 20 7a 6f 6e 65 20 31 2c 20 + Italy zone 1,
7970: 31 30 20 6d 2c 20 49 74 61 6c 79 20 2d 20 53 69 10 m, Italy - Si
7980: 63 69 6c 79 20 53 74 72 61 69 74 20 77 65 73 74 cily Strait west
7990: 20 6f 66 20 31 33 c2 b0 45 0d 0a 0d 0a 50 52 4f of 13..E....PRO
79a0: 4a 20 73 74 72 69 6e 67 3a 0d 0a 2b 70 72 6f 6a J string:..+proj
79b0: 3d 70 69 70 65 6c 69 6e 65 20 0d 0a 2b 73 74 65 =pipeline ..+ste
79c0: 70 20 2b 70 72 6f 6a 3d 61 78 69 73 73 77 61 70 p +proj=axisswap
79d0: 20 2b 6f 72 64 65 72 3d 32 2c 31 20 0d 0a 2b 73 +order=2,1 ..+s
79e0: 74 65 70 20 2b 70 72 6f 6a 3d 75 6e 69 74 63 6f tep +proj=unitco
79f0: 6e 76 65 72 74 20 2b 78 79 5f 69 6e 3d 64 65 67 nvert +xy_in=deg
7a00: 20 2b 78 79 5f 6f 75 74 3d 72 61 64 20 0d 0a 2b +xy_out=rad ..+
7a10: 73 74 65 70 20 2b 70 72 6f 6a 3d 70 75 73 68 20 step +proj=push
7a20: 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 +v_3 ..+step +pr
7a30: 6f 6a 3d 63 61 72 74 20 2b 65 6c 6c 70 73 3d 57 oj=cart +ellps=W
7a40: 47 53 38 34 20 0d 0a 2b 73 74 65 70 20 2b 70 72 GS84 ..+step +pr
7a50: 6f 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 3d 32 33 oj=helmert +x=23
7a60: 30 2e 34 37 20 2b 79 3d 35 36 2e 30 38 20 2b 7a 0.47 +y=56.08 +z
7a70: 3d 2d 32 32 2e 34 33 20 0d 0a 2b 73 74 65 70 20 =-22.43 ..+step
7a80: 2b 69 6e 76 20 2b 70 72 6f 6a 3d 63 61 72 74 20 +inv +proj=cart
7a90: 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20 0d 0a 2b 73 +ellps=intl ..+s
7aa0: 74 65 70 20 2b 70 72 6f 6a 3d 70 6f 70 20 2b 76 tep +proj=pop +v
7ab0: 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a _3 ..+step +proj
7ac0: 3d 74 6d 65 72 63 20 2b 6c 61 74 5f 30 3d 30 20 =tmerc +lat_0=0
7ad0: 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 2e 39 39 +lon_0=9 +k=0.99
7ae0: 39 36 20 2b 78 5f 30 3d 31 35 30 30 30 30 30 20 96 +x_0=1500000
7af0: 2b 79 5f 30 3d 30 20 2b 65 6c 6c 70 73 3d 69 6e +y_0=0 +ellps=in
7b00: 74 6c 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d tl..</verbatim>.
7b10: 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 .</td></tr>..</t
7b20: 61 62 6c 65 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c able><br><br>..<
7b30: 76 65 72 62 61 74 69 6d 3e 0d 0a 2d 2d 20 66 72 verbatim>..-- fr
7b40: 6f 6d 20 45 50 53 47 3a 34 32 36 20 74 6f 20 45 om EPSG:426 to E
7b50: 50 53 47 3a 33 30 30 33 20 2d 20 64 65 66 61 75 PSG:3003 - defau
7b60: 6c 74 20 73 65 74 74 69 6e 67 73 2c 20 4e 55 4c lt settings, NUL
7b70: 4c 20 61 72 65 61 20 6f 66 20 75 73 65 0d 0a 53 L area of use..S
7b80: 45 4c 45 43 54 20 41 73 45 57 4b 54 20 28 20 53 ELECT AsEWKT ( S
7b90: 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d 61 6b T_Transform( Mak
7ba0: 65 50 6f 69 6e 74 28 20 39 2e 31 36 39 34 36 34 ePoint( 9.169464
7bb0: 2c 20 33 39 2e 34 37 38 32 37 35 2c 20 34 33 32 , 39.478275, 432
7bc0: 36 20 29 2c 20 33 30 30 33 20 29 29 3b 0d 0a 2d 6 ), 3003 ));..-
7bd0: 2d 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 0d 0a 53 52 49 44 3d 33 30 30 33 3b ----..SRID=3003;
7c00: 50 4f 49 4e 54 28 31 35 31 34 36 30 30 2e 31 33 POINT(1514600.13
7c10: 34 33 32 31 38 36 32 20 34 33 36 39 38 37 34 2e 4321862 4369874.
7c20: 34 38 39 32 36 39 39 35 37 29 0d 0a 0d 0a 0d 0a 489269957)......
7c30: 2d 2d 20 66 72 6f 6d 20 45 50 53 47 3a 34 32 36 -- from EPSG:426
7c40: 20 74 6f 20 45 50 53 47 3a 33 30 30 33 20 2d 20 to EPSG:3003 -
7c50: 64 65 66 61 75 6c 74 20 73 65 74 74 69 6e 67 73 default settings
7c60: 2c 20 62 75 74 20 74 68 69 73 20 74 69 6d 65 20 , but this time
7c70: 65 78 70 6c 69 63 69 74 6c 79 20 64 65 66 69 6e explicitly defin
7c80: 69 6e 67 20 74 68 65 20 4d 42 52 20 61 6b 61 20 ing the MBR aka
7c90: 42 42 4f 58 20 6f 66 20 61 20 73 70 65 63 69 66 BBOX of a specif
7ca0: 69 63 20 61 72 65 61 20 6f 66 20 75 73 65 0d 0a ic area of use..
7cb0: 53 45 4c 45 43 54 20 41 73 45 57 4b 54 20 28 20 SELECT AsEWKT (
7cc0: 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d 61 ST_Transform( Ma
7cd0: 6b 65 50 6f 69 6e 74 28 20 39 2e 31 36 39 34 36 kePoint( 9.16946
7ce0: 34 2c 20 33 39 2e 34 37 38 32 37 35 2c 20 34 33 4, 39.478275, 43
7cf0: 32 36 20 29 2c 20 33 30 30 33 20 2c 20 42 75 69 26 ), 3003 , Bui
7d00: 6c 64 4d 42 52 28 39 2e 31 20 2c 20 33 39 2e 34 ldMBR(9.1 , 39.4
7d10: 20 2c 20 39 2e 32 20 2c 20 33 39 2e 35 20 2c 20 , 9.2 , 39.5 ,
7d20: 34 33 32 36 20 29 29 29 3b 0d 0a 2d 2d 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: 0d 0a 53 52 49 44 3d 33 30 30 33 3b 50 4f 49 4e ..SRID=3003;POIN
7d60: 54 28 31 35 31 34 36 30 35 2e 39 38 32 37 36 32 T(1514605.982762
7d70: 32 34 38 20 34 33 36 39 38 37 33 2e 30 30 34 32 248 4369873.0042
7d80: 32 36 39 34 33 29 0d 0a 3c 2f 76 65 72 62 61 74 26943)..</verbat
7d90: 69 6d 3e 0d 0a 54 68 69 72 64 20 61 6e 64 20 66 im>..Third and f
7da0: 69 6e 61 6c 20 65 78 61 6d 70 6c 65 2e 20 49 6e inal example. In
7db0: 20 73 6f 6d 65 20 63 61 73 65 73 20 65 78 70 6c some cases expl
7dc0: 69 63 69 74 6c 79 20 64 65 66 69 6e 69 6e 67 20 icitly defining
7dd0: 61 20 73 70 65 63 69 66 69 63 20 3c 62 3e 3c 69 a specific <b><i
7de0: 3e 61 72 65 61 20 6f 66 20 75 73 65 3c 2f 69 3e >area of use</i>
7df0: 3c 2f 62 3e 20 6d 61 79 20 65 6e 61 62 6c 65 20 </b> may enable
7e00: 50 52 4f 4a 2e 36 20 74 6f 20 73 65 6c 65 63 74 PROJ.6 to select
7e10: 20 61 6e 20 6f 70 74 69 6d 69 7a 65 64 20 74 72 an optimized tr
7e20: 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 6c 65 61 ansformation lea
7e30: 64 69 6e 67 20 74 6f 20 6d 6f 72 65 20 70 72 65 ding to more pre
7e40: 63 69 73 65 20 72 65 73 75 6c 74 73 2e 3c 62 72 cise results.<br
7e50: 3e 0d 0a 49 6e 20 74 68 69 73 20 65 78 61 6d 70 >..In this examp
7e60: 6c 65 20 77 65 27 76 65 20 75 73 65 64 20 61 20 le we've used a
7e70: 50 6f 69 6e 74 20 6c 6f 63 61 74 65 64 20 69 6e Point located in
7e80: 20 53 61 72 64 69 6e 69 61 2c 20 61 6e 64 20 50 Sardinia, and P
7e90: 52 4f 4a 2e 36 20 73 75 70 70 6f 72 74 73 20 73 ROJ.6 supports s
7ea0: 65 76 65 72 61 6c 20 66 6c 61 76 6f 72 73 20 6f everal flavors o
7eb0: 66 20 3c 62 3e 45 50 53 47 3a 33 30 30 33 3c 2f f <b>EPSG:3003</
7ec0: 62 3e 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 b> depending on
7ed0: 74 68 65 20 73 70 65 63 69 66 69 63 20 61 72 65 the specific are
7ee0: 61 20 6f 66 20 75 73 65 20 61 6e 64 0d 0a 3c 62 a of use and..<b
7ef0: 3e 49 74 61 6c 79 20 2d 20 53 61 72 64 69 6e 69 >Italy - Sardini
7f00: 61 20 6f 6e 73 68 6f 72 65 3c 2f 62 3e 20 69 73 a onshore</b> is
7f10: 20 6f 6e 65 20 62 65 74 77 65 65 6e 20 74 68 65 one between the
7f20: 6d 2e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 74 68 m...<ul>..<li>th
7f30: 65 20 66 69 72 73 74 20 71 75 65 72 79 20 64 6f e first query do
7f40: 65 73 20 6e 6f 74 20 64 65 66 69 6e 65 20 61 6e es not define an
7f50: 79 20 73 70 65 63 69 66 69 63 20 61 72 65 61 20 y specific area
7f60: 6f 66 20 75 73 65 2c 20 61 6e 64 20 63 6f 6e 73 of use, and cons
7f70: 65 71 75 65 6e 74 6c 79 20 50 52 4f 4a 2e 36 20 equently PROJ.6
7f80: 63 61 6c 63 75 6c 61 74 65 64 20 74 68 65 20 74 calculated the t
7f90: 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 62 79 ransformation by
7fa0: 20 61 70 70 6c 79 69 6e 67 20 74 68 65 20 67 65 applying the ge
7fb0: 6e 65 72 69 63 20 70 61 72 61 6d 65 74 65 72 73 neric parameters
7fc0: 20 73 75 70 70 6f 72 74 69 6e 67 20 3c 62 3e 49 supporting <b>I
7fd0: 74 61 6c 79 20 2d 20 4d 61 69 6e 6c 61 6e 64 3c taly - Mainland<
7fe0: 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 /b>.</li>..<li>t
7ff0: 68 65 20 73 65 63 6f 6e 64 20 71 75 65 72 79 20 he second query
8000: 69 6e 73 74 65 61 64 20 64 65 66 69 6e 65 73 20 instead defines
8010: 61 20 73 70 65 63 69 66 69 63 20 61 72 65 20 6f a specific are o
8020: 66 20 75 73 65 2c 20 61 6e 64 20 74 68 69 73 20 f use, and this
8030: 74 69 6d 65 20 50 52 4f 4a 2e 36 20 63 61 6c 63 time PROJ.6 calc
8040: 75 6c 61 74 65 64 20 74 68 65 20 74 72 61 6e 73 ulated the trans
8050: 66 6f 72 6d 61 74 69 6f 6e 20 62 79 20 61 70 70 formation by app
8060: 6c 79 69 6e 67 20 74 68 65 20 6d 6f 73 74 20 70 lying the most p
8070: 72 65 63 69 73 65 20 70 61 72 61 6d 65 74 65 72 recise parameter
8080: 73 20 73 75 70 70 6f 72 74 69 6e 67 20 3c 62 3e s supporting <b>
8090: 49 74 61 6c 79 20 2d 20 53 61 72 64 69 6e 69 61 Italy - Sardinia
80a0: 20 6f 6e 73 68 6f 72 65 3c 2f 62 3e 2e 3c 2f 6c onshore</b>.</l
80b0: 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 3c 62 72 i>..</ul><br><br
80c0: 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 >..<table cellsp
80d0: 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 acing="8" cellpa
80e0: 64 64 69 6e 67 3d 22 31 36 22 20 62 67 63 6f 6c dding="16" bgcol
80f0: 6f 72 3d 22 23 66 66 66 66 64 30 22 3e 0d 0a 3c or="#ffffd0">..<
8100: 74 72 3e 3c 74 64 3e 0d 0a 3c 62 3e 3c 75 3e 4c tr><td>..<b><u>L
8110: 65 73 73 6f 6e 20 6c 65 61 72 6e 65 64 3c 2f 75 esson learned</u
8120: 3e 3c 2f 62 3e 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c ></b>:..<ul>..<l
8130: 69 3e 54 68 65 20 62 65 73 74 20 6d 6f 64 65 20 i>The best mode
8140: 66 6f 72 20 74 61 6b 69 6e 67 20 66 75 6c 6c 20 for taking full
8150: 70 72 6f 66 69 74 20 66 72 6f 6d 20 50 52 4f 4a profit from PROJ
8160: 2e 36 20 69 73 20 62 79 20 69 67 6e 6f 72 69 6e .6 is by ignorin
8170: 67 20 61 6c 6c 20 43 52 53 20 64 65 66 69 6e 69 g all CRS defini
8180: 74 69 6f 6e 73 20 63 6f 6e 74 61 69 6e 65 64 20 tions contained
8190: 69 6e 74 6f 20 3c 62 3e 73 70 61 74 69 61 6c 5f into <b>spatial_
81a0: 72 65 66 5f 73 79 73 3c 2f 62 3e 2c 20 74 68 75 ref_sys</b>, thu
81b0: 73 20 6c 65 61 76 69 6e 67 20 50 52 4f 4a 20 66 s leaving PROJ f
81c0: 72 65 65 20 74 6f 20 63 68 6f 6f 73 65 20 74 68 ree to choose th
81d0: 65 20 62 65 73 74 20 70 6f 73 73 69 62 6c 65 20 e best possible
81e0: 61 70 70 72 6f 61 63 68 2e 20 28 61 6e 64 20 74 approach. (and t
81f0: 68 69 73 20 69 73 20 74 68 65 20 3c 62 3e 3c 69 his is the <b><i
8200: 3e 64 65 66 61 75 6c 74 20 73 65 74 74 69 6e 67 >default setting
8210: 3c 2f 69 3e 3c 2f 62 3e 29 2e 3c 62 72 3e 0d 0a </i></b>).<br>..
8220: 54 68 69 73 20 77 61 79 20 79 6f 75 27 6c 6c 20 This way you'll
8230: 62 65 20 61 62 73 6f 6c 75 74 65 6c 79 20 73 75 be absolutely su
8240: 72 65 20 74 68 61 74 20 74 68 65 20 6d 6f 73 74 re that the most
8250: 20 72 65 63 65 6e 74 20 61 6e 64 20 66 75 6c 6c recent and full
8260: 79 20 64 65 74 61 69 6c 65 64 20 64 65 66 69 6e y detailed defin
8270: 69 74 69 6f 6e 73 20 77 69 6c 6c 20 62 65 20 61 itions will be a
8280: 6c 77 61 79 73 20 72 65 74 72 69 65 76 65 64 20 lways retrieved
8290: 66 72 6f 6d 20 74 68 65 20 50 52 4f 4a 2e 36 20 from the PROJ.6
82a0: 6f 77 6e 20 70 72 69 76 61 74 65 20 64 61 74 61 own private data
82b0: 62 61 73 65 2e 3c 62 72 3e 0d 0a 54 68 69 73 20 base.<br>..This
82c0: 77 69 6c 6c 20 62 65 20 65 6e 73 75 72 65 64 20 will be ensured
82d0: 65 76 65 6e 20 77 68 65 6e 20 70 72 6f 63 65 73 even when proces
82e0: 73 69 6e 67 20 73 6f 6d 65 20 3c 62 3e 3c 69 3e sing some <b><i>
82f0: 6c 65 67 61 63 79 20 44 42 3c 2f 69 3e 3c 2f 62 legacy DB</i></b
8300: 3e 20 62 65 69 6e 67 20 63 72 65 61 74 65 64 20 > being created
8310: 62 79 20 65 61 72 6c 69 65 72 20 76 65 72 73 69 by earlier versi
8320: 6f 6e 73 20 61 6e 64 20 74 68 75 73 20 70 6f 74 ons and thus pot
8330: 65 6e 74 69 61 6c 6c 79 20 63 6f 6e 74 61 69 6e entially contain
8340: 69 6e 67 20 61 6e 20 6f 75 74 64 61 74 65 64 20 ing an outdated
8350: 3c 62 3e 3c 69 3e 73 70 61 74 69 61 6c 5f 72 65 <b><i>spatial_re
8360: 66 5f 73 79 73 3c 2f 69 3e 3c 2f 62 3e 20 74 61 f_sys</i></b> ta
8370: 62 6c 65 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 53 ble.</li>..<li>S
8380: 70 61 74 69 61 4c 69 74 65 20 66 75 6c 6c 79 20 patiaLite fully
8390: 72 65 73 70 65 63 74 73 20 75 73 65 72 73 20 66 respects users f
83a0: 72 65 65 64 6f 6d 20 61 76 6f 69 64 69 6e 67 20 reedom avoiding
83b0: 61 6e 79 20 69 6d 70 6f 73 65 64 20 63 6f 6e 73 any imposed cons
83c0: 74 72 61 69 6e 74 2e 3c 62 72 3e 0d 0a 49 66 20 traint.<br>..If
83d0: 79 6f 75 20 74 68 69 6e 6b 20 74 68 61 74 20 75 you think that u
83e0: 73 69 6e 67 20 6f 74 68 65 72 20 64 69 66 66 65 sing other diffe
83f0: 72 65 6e 74 20 43 52 53 20 64 65 66 69 6e 69 74 rent CRS definit
8400: 69 6f 6e 73 20 69 73 20 61 20 67 6f 6f 64 20 69 ions is a good i
8410: 64 65 61 2c 20 79 6f 75 20 61 72 65 20 66 72 65 dea, you are fre
8420: 65 20 74 6f 20 75 73 65 20 74 72 61 64 69 74 69 e to use traditi
8430: 6f 6e 61 6c 20 70 72 6f 6a 2d 73 74 72 69 6e 67 onal proj-string
8440: 73 2c 20 57 4b 54 20 64 65 66 69 6e 69 74 69 6f s, WKT definitio
8450: 6e 73 2c 20 43 52 53 20 6e 61 6d 65 73 20 61 6e ns, CRS names an
8460: 64 20 77 68 61 74 65 76 65 72 20 65 6c 73 65 20 d whatever else
8470: 74 68 61 74 20 6d 61 79 20 62 65 20 64 65 65 6d that may be deem
8480: 65 64 20 61 70 70 72 6f 70 72 69 61 74 65 2e 3c ed appropriate.<
8490: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 53 70 61 74 69 61 /li>..<li>Spatia
84a0: 4c 69 74 65 20 65 6e 63 6f 75 72 61 67 65 73 20 Lite encourages
84b0: 61 6e 64 20 70 72 6f 6d 6f 74 65 73 20 74 68 65 and promotes the
84c0: 20 6d 6f 73 74 20 63 72 65 61 74 69 76 65 20 75 most creative u
84d0: 73 65 73 20 6f 66 20 50 52 4f 4a 2e 36 3a 20 75 ses of PROJ.6: u
84e0: 73 69 6e 67 20 79 6f 75 72 20 6f 77 6e 20 63 75 sing your own cu
84f0: 73 74 6f 6d 20 3c 62 3e 3c 69 3e 74 72 61 6e 73 stom <b><i>trans
8500: 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 6c 69 formation pipeli
8510: 6e 65 73 3c 2f 69 3e 3c 2f 62 3e 20 69 73 6e 27 nes</i></b> isn'
8520: 74 20 6e 65 63 65 73 73 61 72 69 6c 79 20 73 69 t necessarily si
8530: 6d 70 6c 65 20 61 6e 64 20 65 61 73 79 2c 20 62 mple and easy, b
8540: 75 74 20 69 73 20 61 20 62 69 67 20 6f 70 70 6f ut is a big oppo
8550: 72 74 75 6e 69 74 79 20 66 6f 72 20 61 6c 6c 20 rtunity for all
8560: 73 6b 69 6c 6c 65 64 20 61 6e 64 20 74 61 6c 65 skilled and tale
8570: 6e 74 65 64 20 70 6f 77 65 72 20 75 73 65 72 73 nted power users
8580: 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c .</li>..</ul>..<
8590: 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 /td></tr>..</tab
85a0: 6c 65 3e 3c 62 72 3e 0d 0a 3c 68 33 3e 4e 65 77 le><br>..<h3>New
85b0: 20 61 75 78 69 6c 69 61 72 79 20 53 51 4c 20 66 auxiliary SQL f
85c0: 75 6e 63 74 69 6f 6e 73 20 73 70 65 63 69 66 69 unctions specifi
85d0: 63 61 6c 6c 79 20 73 75 70 70 6f 72 74 69 6e 67 cally supporting
85e0: 20 50 52 4f 4a 2e 36 3c 2f 68 33 3e 0d 0a 3c 74 PROJ.6</h3>..<t
85f0: 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 able cellspacing
8600: 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 ="8" cellpadding
8610: 3d 22 38 22 20 62 67 63 6f 6c 6f 72 3d 22 23 65 ="8" bgcolor="#e
8620: 38 66 66 65 38 22 20 62 6f 72 64 65 72 3d 22 31 8ffe8" border="1
8630: 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 67 63 6f ">..<tr><th bgco
8640: 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 3e 53 51 lor="#ffb03e">SQ
8650: 4c 20 46 75 6e 63 74 69 6f 6e 3c 2f 74 68 3e 3c L Function</th><
8660: 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 th bgcolor="#ffb
8670: 30 33 65 22 3e 53 75 70 70 6f 72 74 65 64 20 61 03e">Supported a
8680: 72 67 75 6d 65 6e 74 73 3c 2f 74 68 3e 3c 74 68 rguments</th><th
8690: 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 bgcolor="#ffb03
86a0: 65 22 3e 44 65 73 63 72 69 70 74 69 6f 6e 3c 2f e">Description</
86b0: 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 th></tr>..<tr><t
86c0: 64 3e 3c 62 3e 48 61 73 50 72 6f 6a 36 3c 2f 62 d><b>HasProj6</b
86d0: 3e 28 20 3c 69 3e 76 6f 69 64 3c 2f 69 3e 20 29 >( <i>void</i> )
86e0: 20 3a 20 3c 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 : <i>Boolean</i
86f0: 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4e 6f 6e 65 ></td>..<td>None
8700: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 </td>..<td>Will
8710: 72 65 74 75 72 6e 20 3c 62 3e 31 3c 2f 62 3e 20 return <b>1</b>
8720: 28 3c 62 3e 54 52 55 45 3c 2f 62 3e 29 20 69 66 (<b>TRUE</b>) if
8730: 20 74 68 65 20 6c 69 62 72 61 72 79 20 68 61 73 the library has
8740: 20 62 65 65 6e 20 62 75 69 6c 74 20 6f 6e 20 3c been built on <
8750: 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 20 28 6f 72 b>PROJ.6</b> (or
8760: 20 61 6e 79 20 6c 61 74 65 72 20 76 65 72 73 69 any later versi
8770: 6f 6e 29 2c 20 6f 74 68 65 72 77 69 73 65 20 3c on), otherwise <
8780: 62 3e 30 3c 2f 62 3e 20 28 3c 62 3e 46 41 4c 53 b>0</b> (<b>FALS
8790: 45 3c 2f 62 3e 29 2e 3c 2f 74 64 3e 3c 2f 74 72 E</b>).</td></tr
87a0: 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 >..<tr><td><b>PR
87b0: 4f 4a 5f 47 65 74 4c 61 73 74 45 72 72 6f 72 4d OJ_GetLastErrorM
87c0: 73 67 3c 2f 62 3e 28 20 3c 69 3e 76 6f 69 64 3c sg</b>( <i>void<
87d0: 2f 69 3e 20 29 20 3a 20 3c 69 3e 53 74 72 69 6e /i> ) : <i>Strin
87e0: 67 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e g</i></td>..<td>
87f0: 4e 6f 6e 65 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 None</td>..<td>W
8800: 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 65 20 6d ill return the m
8810: 6f 73 74 20 72 65 63 65 6e 74 20 65 72 72 6f 72 ost recent error
8820: 20 6d 65 73 73 61 67 65 20 72 65 74 75 72 6e 65 message returne
8830: 64 20 62 79 20 50 52 4f 4a 20 28 69 66 20 61 6e d by PROJ (if an
8840: 79 29 2e 3c 62 72 3e 0d 0a 3c 62 3e 4e 55 4c 4c y).<br>..<b>NULL
8850: 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72 65 74 </b> will be ret
8860: 75 72 6e 65 64 20 69 66 20 74 68 65 72 65 20 69 urned if there i
8870: 73 20 6e 6f 20 63 75 72 72 65 6e 74 6c 79 20 70 s no currently p
8880: 65 6e 64 69 6e 67 20 50 52 4f 4a 20 65 72 72 6f ending PROJ erro
8890: 72 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 r.</td></tr>..<t
88a0: 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f 47 65 r><td><b>PROJ_Ge
88b0: 74 44 61 74 61 62 61 73 65 50 61 74 68 3c 2f 62 tDatabasePath</b
88c0: 3e 28 20 3c 69 3e 76 6f 69 64 3c 2f 69 3e 20 3a >( <i>void</i> :
88d0: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 29 3c <i>String</i>)<
88e0: 2f 74 64 3e 0d 0a 3c 74 64 3e 4e 6f 6e 65 3c 2f /td>..<td>None</
88f0: 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 72 65 td>..<td>Will re
8900: 74 75 72 6e 20 74 68 65 20 63 75 72 72 65 6e 74 turn the current
8910: 6c 79 20 73 65 74 20 70 61 74 68 6e 61 6d 65 20 ly set pathname
8920: 6c 65 61 64 69 6e 67 20 74 6f 20 74 68 65 20 70 leading to the p
8930: 72 69 76 61 74 65 20 50 52 4f 4a 27 73 20 53 51 rivate PROJ's SQ
8940: 4c 69 74 65 20 64 61 74 61 62 61 73 65 2e 3c 62 Lite database.<b
8950: 72 3e 0d 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 r>..<b>NULL</b>
8960: 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 will be returned
8970: 20 69 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20 if there is no
8980: 70 72 69 76 61 74 65 20 50 52 4f 4a 27 73 20 53 private PROJ's S
8990: 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 20 63 QLite database c
89a0: 75 72 72 65 6e 74 6c 79 20 63 6f 6e 6e 65 63 74 urrently connect
89b0: 65 64 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c ed.</td></tr>..<
89c0: 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f 53 tr><td><b>PROJ_S
89d0: 65 74 44 61 74 61 62 61 73 65 50 61 74 68 3c 2f etDatabasePath</
89e0: 62 3e 20 28 20 6e 65 77 5f 70 61 74 68 20 3c 69 b> ( new_path <i
89f0: 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 >String</i> ) :
8a00: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f 74 <i>String</i></t
8a10: 64 3e 0d 0a 3c 74 64 3e 0d 0a 3c 75 6c 3e 0d 0a d>..<td>..<ul>..
8a20: 3c 6c 69 3e 3c 62 3e 6e 65 77 5f 70 61 74 68 3c <li><b>new_path<
8a30: 2f 62 3e 3a 20 61 20 72 65 6c 61 74 69 76 65 20 /b>: a relative
8a40: 6f 72 20 61 62 73 6f 6c 75 74 65 20 70 61 74 68 or absolute path
8a50: 6e 61 6d 65 20 6c 65 61 64 69 6e 67 20 74 6f 20 name leading to
8a60: 61 20 76 61 6c 69 64 20 50 52 4f 4a 27 73 20 53 a valid PROJ's S
8a70: 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 2e 3c QLite database.<
8a80: 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 74 64 3e /li>..</ul></td>
8a90: 0d 0a 3c 74 64 3e 57 69 6c 6c 20 63 68 61 6e 67 ..<td>Will chang
8aa0: 65 20 74 68 65 20 63 75 72 72 65 6e 74 6c 79 20 e the currently
8ab0: 73 65 74 20 70 61 74 68 6e 61 6d 65 20 6c 65 61 set pathname lea
8ac0: 64 69 6e 67 20 74 6f 20 74 68 65 20 70 72 69 76 ding to the priv
8ad0: 61 74 65 20 50 52 4f 4a 27 73 20 53 51 4c 69 74 ate PROJ's SQLit
8ae0: 65 20 64 61 74 61 62 61 73 65 2e 3c 62 72 3e 0d e database.<br>.
8af0: 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c .<b>NULL</b> wil
8b00: 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 69 66 l be returned if
8b10: 20 74 68 65 20 70 61 73 73 65 64 20 70 61 74 68 the passed path
8b20: 20 69 73 20 69 6e 76 61 6c 69 64 2c 20 6f 74 68 is invalid, oth
8b30: 65 72 77 69 73 65 20 74 68 65 20 70 61 74 68 20 erwise the path
8b40: 6f 66 20 74 68 65 20 63 75 72 72 65 6e 74 6c 79 of the currently
8b50: 20 73 65 74 20 70 72 69 76 61 74 65 20 50 52 4f set private PRO
8b60: 4a 27 73 20 53 51 4c 69 74 65 20 64 61 74 61 62 J's SQLite datab
8b70: 61 73 65 20 77 69 6c 6c 20 62 65 20 72 65 74 75 ase will be retu
8b80: 72 6e 65 64 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d rned.</td></tr>.
8b90: 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a .<tr><td><b>PROJ
8ba0: 5f 41 73 50 72 6f 6a 53 74 72 69 6e 67 3c 2f 62 _AsProjString</b
8bb0: 3e 20 28 20 61 75 74 68 5f 6e 61 6d 65 20 3c 69 > ( auth_name <i
8bc0: 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 61 75 >String</i> , au
8bd0: 74 68 5f 73 72 69 64 20 3c 69 3e 49 6e 74 65 67 th_srid <i>Integ
8be0: 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 53 74 er</i> ) : <i>St
8bf0: 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c ring</i></td>..<
8c00: 74 64 3e 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e td><ul>..<li><b>
8c10: 61 75 74 68 5f 6e 61 6d 65 3c 2f 62 3e 20 61 6e auth_name</b> an
8c20: 64 20 3c 62 3e 61 75 74 68 5f 73 72 69 64 3c 2f d <b>auth_srid</
8c30: 62 3e 20 69 64 65 6e 74 69 66 79 20 74 68 65 20 b> identify the
8c40: 69 6e 74 65 6e 64 65 64 20 43 52 53 2e 3c 62 72 intended CRS.<br
8c50: 3e 0d 0a 3c 62 3e 61 75 74 68 5f 6e 61 6d 65 3c >..<b>auth_name<
8c60: 2f 62 3e 20 63 61 6e 20 62 65 20 3c 62 3e 4e 55 /b> can be <b>NU
8c70: 4c 4c 3c 2f 62 3e 2c 20 61 6e 64 20 69 6e 20 74 LL</b>, and in t
8c80: 68 69 73 20 63 61 73 65 20 3c 62 3e 45 50 53 47 his case <b>EPSG
8c90: 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 61 73 73 </b> will be ass
8ca0: 75 6d 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c umed.</li>..</ul
8cb0: 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c ></td>..<td>Will
8cc0: 20 72 65 74 75 72 6e 20 74 68 65 20 57 4b 54 20 return the WKT
8cd0: 65 78 70 72 65 73 73 69 6f 6e 20 63 6f 72 72 65 expression corre
8ce0: 73 70 6f 6e 64 69 6e 67 20 74 6f 20 61 20 67 69 sponding to a gi
8cf0: 76 65 6e 20 43 52 53 3b 20 74 68 65 20 64 65 66 ven CRS; the def
8d00: 69 6e 69 74 69 6f 6e 73 20 77 69 6c 6c 20 62 65 initions will be
8d10: 20 74 61 6b 65 6e 20 64 69 72 65 63 74 6c 79 20 taken directly
8d20: 66 72 6f 6d 20 74 68 65 20 70 72 69 76 61 74 65 from the private
8d30: 20 50 52 4f 4a 27 73 20 6f 77 6e 20 64 61 74 61 PROJ's own data
8d40: 62 61 73 65 2e 3c 62 72 3e 0d 0a 3c 62 3e 4e 55 base.<br>..<b>NU
8d50: 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72 LL</b> will be r
8d60: 65 74 75 72 6e 65 64 20 6f 6e 20 66 61 69 6c 75 eturned on failu
8d70: 72 65 20 6f 72 20 6f 6e 20 69 6e 76 61 6c 69 64 re or on invalid
8d80: 20 61 72 67 75 6d 65 6e 74 73 2e 3c 2f 74 64 3e arguments.</td>
8d90: 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c </tr>..<tr><td><
8da0: 62 3e 50 52 4f 4a 5f 41 73 57 4b 54 3c 2f 62 3e b>PROJ_AsWKT</b>
8db0: 20 28 20 61 75 74 68 5f 6e 61 6d 65 20 3c 69 3e ( auth_name <i>
8dc0: 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 61 75 74 String</i> , aut
8dd0: 68 5f 73 72 69 64 20 3c 69 3e 49 6e 74 65 67 65 h_srid <i>Intege
8de0: 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 53 74 72 r</i> ) : <i>Str
8df0: 69 6e 67 3c 2f 69 3e 3c 68 72 3e 0d 0a 3c 62 3e ing</i><hr>..<b>
8e00: 50 52 4f 4a 5f 41 73 57 4b 54 3c 2f 62 3e 20 28 PROJ_AsWKT</b> (
8e10: 20 61 75 74 68 5f 6e 61 6d 65 20 3c 69 3e 53 74 auth_name <i>St
8e20: 72 69 6e 67 3c 2f 69 3e 20 2c 20 61 75 74 68 5f ring</i> , auth_
8e30: 73 72 69 64 20 3c 69 3e 49 6e 74 65 67 65 72 3c srid <i>Integer<
8e40: 2f 69 3e 20 2c 20 77 6b 74 5f 73 74 79 6c 65 20 /i> , wkt_style
8e50: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 <i>String</i> )
8e60: 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c : <i>String</i><
8e70: 68 72 3e 0d 0a 3c 62 3e 50 52 4f 4a 5f 41 73 57 hr>..<b>PROJ_AsW
8e80: 4b 54 3c 2f 62 3e 20 28 20 61 75 74 68 5f 6e 61 KT</b> ( auth_na
8e90: 6d 65 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e me <i>String</i>
8ea0: 20 2c 20 61 75 74 68 5f 73 72 69 64 20 3c 69 3e , auth_srid <i>
8eb0: 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 77 6b Integer</i> , wk
8ec0: 74 5f 73 74 79 6c 65 20 3c 69 3e 53 74 72 69 6e t_style <i>Strin
8ed0: 67 3c 2f 69 3e 20 2c 20 69 6e 64 65 6e 74 65 64 g</i> , indented
8ee0: 20 3c 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 20 <i>Boolean</i>
8ef0: 29 20 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 ) : <i>String</i
8f00: 3e 3c 68 72 3e 0d 0a 3c 62 3e 50 52 4f 4a 5f 41 ><hr>..<b>PROJ_A
8f10: 73 57 4b 54 3c 2f 62 3e 20 28 20 61 75 74 68 5f sWKT</b> ( auth_
8f20: 6e 61 6d 65 20 3c 69 3e 53 74 72 69 6e 67 3c 2f name <i>String</
8f30: 69 3e 20 2c 20 61 75 74 68 5f 73 72 69 64 20 3c i> , auth_srid <
8f40: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 i>Integer</i> ,
8f50: 77 6b 74 5f 73 74 79 6c 65 20 3c 69 3e 53 74 72 wkt_style <i>Str
8f60: 69 6e 67 3c 2f 69 3e 20 2c 20 69 6e 64 65 6e 74 ing</i> , indent
8f70: 65 64 20 3c 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 ed <i>Boolean</i
8f80: 3e 20 2c 20 69 6e 64 65 6e 74 61 74 69 6f 6e 20 > , indentation
8f90: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 <i>Integer</i> )
8fa0: 20 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e : <i>String</i>
8fb0: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 3c 75 6c 3e 0d </td>..<td><ul>.
8fc0: 0a 3c 6c 69 3e 3c 62 3e 61 75 74 68 5f 6e 61 6d .<li><b>auth_nam
8fd0: 65 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 61 75 74 e</b> and <b>aut
8fe0: 68 5f 73 72 69 64 3c 2f 62 3e 20 69 64 65 6e 74 h_srid</b> ident
8ff0: 69 66 79 20 74 68 65 20 69 6e 74 65 6e 64 65 64 ify the intended
9000: 20 43 52 53 2e 3c 62 72 3e 0d 0a 3c 62 3e 61 75 CRS.<br>..<b>au
9010: 74 68 5f 6e 61 6d 65 3c 2f 62 3e 20 63 61 6e 20 th_name</b> can
9020: 62 65 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 2c 20 be <b>NULL</b>,
9030: 61 6e 64 20 69 6e 20 74 68 69 73 20 63 61 73 65 and in this case
9040: 20 3c 62 3e 45 50 53 47 3c 2f 62 3e 20 77 69 6c <b>EPSG</b> wil
9050: 6c 20 62 65 20 61 73 73 75 6d 65 64 2e 3c 2f 6c l be assumed.</l
9060: 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69 i>..<li>the opti
9070: 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62 onal argument <b
9080: 3e 73 74 79 6c 65 3c 2f 62 3e 20 64 65 74 65 72 >style</b> deter
9090: 6d 69 6e 65 73 20 77 68 69 63 68 20 73 70 65 63 mines which spec
90a0: 69 66 69 63 20 57 4b 54 20 66 6f 72 6d 61 74 20 ific WKT format
90b0: 73 68 6f 75 6c 64 20 62 65 20 61 64 6f 70 74 65 should be adopte
90c0: 64 2c 20 61 6e 64 20 6d 75 73 74 20 62 65 20 6f d, and must be o
90d0: 6e 65 20 62 65 74 77 65 65 6e 20 3c 62 3e 47 44 ne between <b>GD
90e0: 41 4c 3c 2f 62 3e 2c 20 3c 62 3e 45 53 52 49 3c AL</b>, <b>ESRI<
90f0: 2f 62 3e 2c 20 3c 62 3e 49 53 4f 2d 32 30 31 35 /b>, <b>ISO-2015
9100: 3c 2f 62 3e 20 6f 72 20 3c 62 3e 49 53 4f 2d 32 </b> or <b>ISO-2
9110: 30 31 38 3c 2f 62 3e 20 28 74 68 69 73 20 6c 61 018</b> (this la
9120: 74 74 65 72 20 62 65 69 6e 67 20 74 68 65 20 64 tter being the d
9130: 65 66 61 75 6c 74 20 73 65 74 74 69 6e 67 29 2e efault setting).
9140: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f </li>..<li>the o
9150: 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 ptional argument
9160: 20 3c 62 3e 69 6e 64 65 6e 74 65 64 3c 2f 62 3e <b>indented</b>
9170: 20 69 66 20 73 65 74 20 74 6f 20 3c 62 3e 54 52 if set to <b>TR
9180: 55 45 3c 2f 62 3e 20 77 69 6c 6c 20 6e 69 63 65 UE</b> will nice
9190: 6c 79 20 66 6f 72 6d 61 74 20 61 20 6d 75 6c 74 ly format a mult
91a0: 69 6c 69 6e 65 20 57 4b 54 20 65 78 70 72 65 73 iline WKT expres
91b0: 73 69 6f 6e 2c 20 6f 74 68 65 72 77 69 73 65 20 sion, otherwise
91c0: 61 20 73 69 6e 67 6c 65 20 6d 6f 6e 6f 6c 69 74 a single monolit
91d0: 68 69 63 20 6c 69 6e 65 20 6c 61 63 6b 69 6e 67 hic line lacking
91e0: 20 61 6e 79 20 77 68 69 74 65 2d 73 70 61 63 65 any white-space
91f0: 20 6f 72 20 6e 65 77 2d 6c 69 6e 65 20 77 69 6c or new-line wil
9200: 6c 20 62 65 20 70 72 69 6e 74 65 64 20 28 74 68 l be printed (th
9210: 65 20 64 65 66 61 75 6c 74 20 69 73 20 3c 62 3e e default is <b>
9220: 54 52 55 45 3c 2f 62 3e 29 2e 3c 2f 6c 69 3e 0d TRUE</b>).</li>.
9230: 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e 61 .<li>the optiona
9240: 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e 69 6e l argument <b>in
9250: 64 65 6e 74 61 74 69 6f 6e 3c 2f 62 3e 20 64 65 dentation</b> de
9260: 74 65 72 6d 69 6e 65 73 20 68 6f 77 20 6d 61 6e termines how man
9270: 79 20 77 68 69 74 65 2d 73 70 61 63 65 73 20 61 y white-spaces a
9280: 72 65 20 74 6f 20 62 65 20 75 73 65 64 20 66 6f re to be used fo
9290: 72 20 69 6e 64 65 6e 74 69 6e 67 20 28 6f 6e 6c r indenting (onl
92a0: 79 20 6d 65 61 6e 69 6e 67 66 75 6c 20 69 66 20 y meaningful if
92b0: 3c 62 3e 3c 69 3e 69 6e 64 65 6e 74 65 64 3d 54 <b><i>indented=T
92c0: 52 55 45 3c 2f 69 3e 3c 2f 62 3e 3b 20 74 68 65 RUE</i></b>; the
92d0: 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 73 20 default values
92e0: 69 73 20 3c 62 3e 34 3c 2f 62 3e 29 2e 3c 2f 6c is <b>4</b>).</l
92f0: 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 74 64 3e 0d 0a i>..</ul></td>..
9300: 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20 <td>Will return
9310: 74 68 65 20 57 4b 54 20 65 78 70 72 65 73 73 69 the WKT expressi
9320: 6f 6e 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 on corresponding
9330: 20 74 6f 20 61 20 67 69 76 65 6e 20 43 52 53 3b to a given CRS;
9340: 20 74 68 65 20 64 65 66 69 6e 69 74 69 6f 6e 73 the definitions
9350: 20 77 69 6c 6c 20 62 65 20 74 61 6b 65 6e 20 64 will be taken d
9360: 69 72 65 63 74 6c 79 20 66 72 6f 6d 20 74 68 65 irectly from the
9370: 20 70 72 69 76 61 74 65 20 50 52 4f 4a 27 73 20 private PROJ's
9380: 6f 77 6e 20 64 61 74 61 62 61 73 65 2e 3c 62 72 own database.<br
9390: 3e 0d 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 >..<b>NULL</b> w
93a0: 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 ill be returned
93b0: 6f 6e 20 66 61 69 6c 75 72 65 20 6f 72 20 6f 6e on failure or on
93c0: 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e invalid argumen
93d0: 74 73 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c ts.</td></tr>..<
93e0: 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f 47 tr><td><b>PROJ_G
93f0: 75 65 73 73 53 72 69 64 46 72 6f 6d 57 4b 54 3c uessSridFromWKT<
9400: 2f 62 3e 20 28 20 77 6b 74 5f 65 78 70 72 20 3c /b> ( wkt_expr <
9410: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a i>String</i> ) :
9420: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c <i>Integer</i><
9430: 2f 74 64 3e 0d 0a 3c 74 64 3e 3c 75 6c 3e 0d 0a /td>..<td><ul>..
9440: 3c 6c 69 3e 3c 62 3e 77 6b 74 5f 65 78 70 72 3c <li><b>wkt_expr<
9450: 2f 62 3e 3a 20 74 68 65 20 57 4b 54 20 65 78 70 /b>: the WKT exp
9460: 72 65 73 73 69 6f 6e 20 74 6f 20 62 65 20 65 76 ression to be ev
9470: 61 6c 75 61 74 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c aluated.</li>..<
9480: 2f 75 6c 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 0d /ul></td>..<td>.
9490: 0a 57 69 6c 6c 20 70 6f 73 73 69 62 6c 79 20 72 .Will possibly r
94a0: 65 74 75 72 6e 20 74 68 65 20 3c 62 3e 53 52 49 eturn the <b>SRI
94b0: 44 20 76 61 6c 75 65 3c 2f 62 3e 20 63 6f 72 72 D value</b> corr
94c0: 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 61 20 67 esponding to a g
94d0: 69 76 65 6e 20 57 4b 54 20 65 78 70 72 65 73 73 iven WKT express
94e0: 69 6f 6e 20 64 65 66 69 6e 69 6e 67 20 61 20 43 ion defining a C
94f0: 52 53 2e 3c 62 72 3e 0d 0a 3c 62 3e 2d 31 3c 2f RS.<br>..<b>-1</
9500: 62 3e 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 b> will be retur
9510: 6e 65 64 20 69 66 20 6e 6f 20 43 52 53 20 73 75 ned if no CRS su
9520: 70 70 6f 72 74 65 64 20 62 79 20 50 52 4f 4a 2e pported by PROJ.
9530: 36 20 6d 61 74 63 68 65 73 20 74 68 65 20 57 4b 6 matches the WK
9540: 54 20 65 78 70 72 65 73 73 69 6f 6e 2e 3c 62 72 T expression.<br
9550: 3e 0d 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 >..<b>NULL</b> w
9560: 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 ill be returned
9570: 6f 6e 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d on invalid argum
9580: 65 6e 74 2e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e ent...</td></tr>
9590: 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f ..<tr><td><b>PRO
95a0: 4a 5f 47 75 65 73 73 53 72 69 64 46 72 6f 6d 53 J_GuessSridFromS
95b0: 48 50 3c 2f 62 3e 20 28 20 66 69 6c 65 6e 61 6d HP</b> ( filenam
95c0: 65 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 e <i>String</i>
95d0: 29 20 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f ) : <i>Integer</
95e0: 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 3c 75 6c i></td>..<td><ul
95f0: 3e 0d 0a 3c 6c 69 3e 3c 62 3e 66 69 6c 65 6e 61 >..<li><b>filena
9600: 6d 65 3c 2f 62 3e 3a 20 74 68 65 20 61 62 73 6f me</b>: the abso
9610: 6c 75 74 65 20 6f 72 20 72 65 6c 61 74 69 76 65 lute or relative
9620: 20 70 61 74 68 20 6c 65 61 64 69 6e 67 20 74 6f path leading to
9630: 20 73 6f 6d 65 20 53 68 61 70 65 66 69 6c 65 2e some Shapefile.
9640: 3c 62 72 3e 0d 0a 4e 6f 74 65 3a 20 65 78 61 63 <br>..Note: exac
9650: 74 6c 79 20 61 73 20 72 65 71 75 69 72 65 64 20 tly as required
9660: 62 79 20 3c 62 3e 3c 69 3e 49 6d 70 6f 72 74 53 by <b><i>ImportS
9670: 48 50 3c 2f 69 3e 3c 2f 62 3e 28 29 20 3c 62 3e HP</i></b>() <b>
9680: 3c 69 3e 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 3c <i>filename</i><
9690: 2f 62 3e 20 6d 75 73 74 20 6f 6d 69 74 20 61 6e /b> must omit an
96a0: 79 20 3c 62 3e 2e 73 68 70 3c 2f 62 3e 2c 20 3c y <b>.shp</b>, <
96b0: 62 3e 2e 73 68 78 3c 2f 62 3e 2c 20 3c 62 3e 2e b>.shx</b>, <b>.
96c0: 64 62 66 3c 2f 62 3e 20 6f 72 20 3c 62 3e 2e 70 dbf</b> or <b>.p
96d0: 72 6a 3c 2f 62 3e 20 73 75 66 66 69 78 2e 3c 2f rj</b> suffix.</
96e0: 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 74 64 3e 0d li>..</ul></td>.
96f0: 0a 3c 74 64 3e 0d 0a 57 69 6c 6c 20 70 6f 73 73 .<td>..Will poss
9700: 69 62 6c 79 20 72 65 74 75 72 6e 20 74 68 65 20 ibly return the
9710: 3c 62 3e 53 52 49 44 20 76 61 6c 75 65 3c 2f 62 <b>SRID value</b
9720: 3e 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 > corresponding
9730: 74 6f 20 74 68 65 20 43 52 53 20 64 65 66 69 6e to the CRS defin
9740: 65 64 20 62 79 20 74 68 65 20 2e 50 52 4a 20 6d ed by the .PRJ m
9750: 65 6d 62 65 72 20 6f 66 20 74 68 65 20 53 68 61 ember of the Sha
9760: 70 65 66 69 6c 65 2e 3c 62 72 3e 0d 0a 3c 62 3e pefile.<br>..<b>
9770: 2d 31 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72 -1</b> will be r
9780: 65 74 75 72 6e 65 64 20 69 66 20 6e 6f 20 43 52 eturned if no CR
9790: 53 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 50 S supported by P
97a0: 52 4f 4a 2e 36 20 6d 61 74 63 68 65 73 20 50 52 ROJ.6 matches PR
97b0: 4a 20 6d 65 6d 62 65 72 20 6f 66 20 74 68 65 20 J member of the
97c0: 53 68 61 70 65 66 69 6c 65 2e 3c 62 72 3e 0d 0a Shapefile.<br>..
97d0: 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c <b>NULL</b> will
97e0: 20 62 65 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 be returned on
97f0: 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 invalid argument
9800: 2e 3c 68 72 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 .<hr>..<u>Please
9810: 20 6e 6f 74 65 20 77 65 6c 6c 3c 2f 75 3e 3a 20 note well</u>:
9820: 74 68 69 73 20 53 51 4c 20 66 75 6e 63 74 69 6f this SQL functio
9830: 6e 20 6f 70 65 6e 73 20 74 68 65 20 64 6f 6f 72 n opens the door
9840: 20 74 6f 20 6d 61 6e 79 20 70 6f 74 65 6e 74 69 to many potenti
9850: 61 6c 20 73 65 63 75 72 69 74 79 20 69 73 73 75 al security issu
9860: 65 73 2c 20 61 6e 64 20 74 68 75 73 20 69 73 20 es, and thus is
9870: 61 6c 77 61 79 73 20 3c 69 3e 64 69 73 61 62 6c always <i>disabl
9880: 65 64 20 62 79 20 64 65 66 61 75 6c 74 3c 2f 69 ed by default</i
9890: 3e 2e 3c 62 72 3e 0d 0a 45 78 70 6c 69 63 69 74 >.<br>..Explicit
98a0: 6c 79 20 73 65 74 74 69 6e 67 20 74 68 65 20 65 ly setting the e
98b0: 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 nvironment varia
98c0: 62 6c 65 20 3c 62 3e 53 50 41 54 49 41 4c 49 54 ble <b>SPATIALIT
98d0: 45 5f 53 45 43 55 52 49 54 59 3d 72 65 6c 61 78 E_SECURITY=relax
98e0: 65 64 3c 2f 62 3e 20 69 73 20 61 62 73 6f 6c 75 ed</b> is absolu
98f0: 74 65 6c 79 20 72 65 71 75 69 72 65 64 20 69 6e tely required in
9900: 20 6f 72 64 65 72 20 74 6f 20 65 6e 61 62 6c 65 order to enable
9910: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0d this function..
9920: 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 .</td></tr>..</t
9930: 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c able><br>..<tabl
9940: 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 e cellspacing="8
9950: 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 31 " cellpadding="1
9960: 36 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 6" bgcolor="#fff
9970: 66 65 39 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d fe9">..<tr><td>.
9980: 0a 3c 62 3e 3c 75 3e 4e 6f 74 65 3c 2f 75 3e 3c .<b><u>Note</u><
9990: 2f 62 3e 3a 20 61 6c 6c 20 74 68 65 20 61 62 6f /b>: all the abo
99a0: 76 65 20 53 51 4c 20 46 75 6e 63 74 69 6f 6e 73 ve SQL Functions
99b0: 20 77 69 6c 6c 20 62 65 20 61 76 61 69 6c 61 62 will be availab
99c0: 6c 65 20 6f 6e 6c 79 20 77 68 65 6e 20 53 70 61 le only when Spa
99d0: 74 69 61 6c 69 74 65 2d 35 2e 30 2e 30 20 68 61 tialite-5.0.0 ha
99e0: 73 20 62 65 65 6e 20 62 75 69 6c 74 20 61 67 61 s been built aga
99f0: 69 6e 73 74 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f inst <b>PROJ.6</
9a00: 62 3e 20 28 6f 72 20 61 6e 79 20 73 75 62 73 65 b> (or any subse
9a10: 71 75 65 6e 74 20 76 65 72 73 69 6f 6e 29 2e 3c quent version).<
9a20: 62 72 3e 0d 0a 49 66 20 53 70 61 74 69 61 4c 69 br>..If SpatiaLi
9a30: 74 65 2d 35 2e 30 2e 30 20 68 61 73 20 62 65 65 te-5.0.0 has bee
9a40: 6e 20 62 75 69 6c 74 20 69 6e 73 74 65 61 64 20 n built instead
9a50: 61 67 61 69 6e 73 74 20 61 6e 79 20 70 72 65 76 against any prev
9a60: 69 6f 75 73 20 76 65 72 73 69 6f 6e 20 28 61 73 ious version (as
9a70: 20 65 2e 67 2e 20 3c 62 3e 50 52 4f 4a 2e 34 3c e.g. <b>PROJ.4<
9a80: 2f 62 3e 29 20 61 6e 79 20 61 74 74 65 6d 70 74 /b>) any attempt
9a90: 20 74 6f 20 63 61 6c 6c 20 6f 6e 65 20 6f 66 20 to call one of
9aa0: 74 68 65 73 65 20 53 51 4c 20 46 75 6e 63 74 69 these SQL Functi
9ab0: 6f 6e 73 20 77 69 6c 6c 20 73 69 6d 70 6c 79 20 ons will simply
9ac0: 72 65 74 75 72 6e 20 61 20 3c 62 3e 3c 69 3e 3c return a <b><i><
9ad0: 75 3e 6e 6f 20 73 75 63 68 20 66 75 6e 63 74 69 u>no such functi
9ae0: 6f 6e 3c 2f 75 3e 3c 2f 69 3e 3c 2f 62 3e 20 53 on</u></i></b> S
9af0: 51 4c 20 65 72 72 6f 72 2e 0d 0a 3c 2f 74 64 3e QL error...</td>
9b00: 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c </tr>..</table><
9b10: 62 72 3e 0d 0a 3c 62 3e 50 72 61 63 74 69 63 61 br>..<b>Practica
9b20: 6c 20 65 78 61 6d 70 6c 65 73 3a 3c 2f 62 3e 0d l examples:</b>.
9b30: 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c .<verbatim>..SEL
9b40: 45 43 54 20 50 52 4f 4a 5f 47 65 74 44 61 74 61 ECT PROJ_GetData
9b50: 62 61 73 65 50 61 74 68 28 29 3b 20 20 2d 2d 20 basePath(); --
9b60: 72 65 74 72 69 65 76 69 6e 67 20 74 68 65 20 63 retrieving the c
9b70: 75 72 72 65 6e 74 6c 79 20 73 65 74 20 50 52 4f urrently set PRO
9b80: 4a 27 73 20 6f 77 6e 20 64 61 74 61 62 61 73 65 J's own database
9b90: 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ..--------------
9ba0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9bb0: 0d 0a 2f 75 73 72 2f 6c 6f 63 61 6c 2f 73 68 61 ../usr/local/sha
9bc0: 72 65 2f 70 72 6f 6a 2f 70 72 6f 6a 2e 64 62 0d re/proj/proj.db.
9bd0: 0a 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a .....SELECT PROJ
9be0: 5f 53 65 74 44 61 74 61 62 61 73 65 50 61 74 68 _SetDatabasePath
9bf0: 28 27 2f 68 6f 6d 65 2f 73 61 6e 64 72 6f 2f 6e ('/home/sandro/n
9c00: 6f 74 5f 65 78 69 73 74 69 6e 67 5f 70 72 6f 6a ot_existing_proj
9c10: 2e 64 62 27 29 3b 20 2d 2d 20 6e 6f 6e 20 65 78 .db'); -- non ex
9c20: 69 73 74 69 6e 67 20 64 61 74 61 62 61 73 65 0d isting database.
9c30: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
9c40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d ---------------.
9c50: 0a 4e 55 4c 4c 0d 0a 0d 0a 0d 0a 53 45 4c 45 43 .NULL......SELEC
9c60: 54 20 50 52 4f 4a 5f 47 65 74 4c 61 73 74 45 72 T PROJ_GetLastEr
9c70: 72 6f 72 4d 73 67 28 29 3b 20 2d 2d 20 72 65 74 rorMsg(); -- ret
9c80: 72 69 65 76 69 6e 67 20 74 68 65 20 66 61 69 6c rieving the fail
9c90: 75 72 65 20 63 61 75 73 65 0d 0a 2d 2d 2d 2d 2d ure 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 0d 0a 70 72 6f 6a 5f ---------..proj_
9cc0: 63 6f 6e 74 65 78 74 5f 73 65 74 5f 64 61 74 61 context_set_data
9cd0: 62 61 73 65 5f 70 61 74 68 3a 20 4f 70 65 6e 20 base_path: Open
9ce0: 6f 66 20 2f 68 6f 6d 65 2f 73 61 6e 64 72 6f 2f of /home/sandro/
9cf0: 6e 6f 74 5f 65 78 69 73 74 69 6e 67 5f 70 72 6f not_existing_pro
9d00: 6a 2e 64 62 20 66 61 69 6c 65 64 0d 0a 0d 0a 0d j.db failed.....
9d10: 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f 53 65 74 .SELECT PROJ_Set
9d20: 44 61 74 61 62 61 73 65 50 61 74 68 28 27 2f 68 DatabasePath('/h
9d30: 6f 6d 65 2f 73 61 6e 64 72 6f 2f 76 61 6c 69 64 ome/sandro/valid
9d40: 5f 70 72 6f 6a 2e 64 62 27 29 3b 20 2d 2d 20 76 _proj.db'); -- v
9d50: 61 6c 69 64 20 64 61 74 61 62 61 73 65 0d 0a 2d alid database..-
9d60: 2d 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 0d 0a 2f -------------../
9d80: 68 6f 6d 65 2f 73 61 6e 64 72 6f 2f 76 61 6c 69 home/sandro/vali
9d90: 64 5f 70 72 6f 6a 2e 64 62 0d 0a 0d 0a 0d 0a 53 d_proj.db......S
9da0: 45 4c 45 43 54 20 50 52 4f 4a 5f 41 73 50 72 6f ELECT PROJ_AsPro
9db0: 6a 53 74 72 69 6e 67 28 27 45 50 53 47 27 2c 20 jString('EPSG',
9dc0: 33 32 36 33 32 29 3b 0d 0a 2d 2d 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 0d 0a 2b 70 72 6f 6a 3d 75 -------..+proj=u
9df0: 74 6d 20 2b 7a 6f 6e 65 3d 33 32 20 2b 64 61 74 tm +zone=32 +dat
9e00: 75 6d 3d 57 47 53 38 34 20 2b 75 6e 69 74 73 3d um=WGS84 +units=
9e10: 6d 20 2b 6e 6f 5f 64 65 66 73 20 2b 74 79 70 65 m +no_defs +type
9e20: 3d 63 72 73 0d 0a 0d 0a 0d 0a 53 45 4c 45 43 54 =crs......SELECT
9e30: 20 50 52 4f 4a 5f 41 73 57 4b 54 28 27 45 50 53 PROJ_AsWKT('EPS
9e40: 47 27 2c 20 34 33 32 36 29 3b 20 2d 2d 20 64 65 G', 4326); -- de
9e50: 66 61 75 6c 74 20 73 65 74 74 69 6e 67 73 3a 20 fault settings:
9e60: 49 53 4f 2d 32 30 31 38 20 73 74 79 6c 65 2c 20 ISO-2018 style,
9e70: 69 6e 64 65 6e 74 65 64 20 77 69 74 68 20 69 6e indented with in
9e80: 64 65 6e 74 61 74 69 6f 6e 20 34 0d 0a 2d 2d 2d dentation 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 0d 0a 47 45 4f -----------..GEO
9eb0: 44 43 52 53 5b 22 57 47 53 20 38 34 22 2c 0d 0a DCRS["WGS 84",..
9ec0: 20 20 20 20 44 41 54 55 4d 5b 22 57 6f 72 6c 64 DATUM["World
9ed0: 20 47 65 6f 64 65 74 69 63 20 53 79 73 74 65 6d Geodetic System
9ee0: 20 31 39 38 34 22 2c 0d 0a 20 20 20 20 20 20 20 1984",..
9ef0: 20 45 4c 4c 49 50 53 4f 49 44 5b 22 57 47 53 20 ELLIPSOID["WGS
9f00: 38 34 22 2c 36 33 37 38 31 33 37 2c 32 39 38 2e 84",6378137,298.
9f10: 32 35 37 32 32 33 35 36 33 2c 0d 0a 20 20 20 20 257223563,..
9f20: 20 20 20 20 20 20 20 20 4c 45 4e 47 54 48 55 4e LENGTHUN
9f30: 49 54 5b 22 6d 65 74 72 65 22 2c 31 5d 5d 5d 2c IT["metre",1]]],
9f40: 0d 0a 20 20 20 20 50 52 49 4d 45 4d 5b 22 47 72 .. PRIMEM["Gr
9f50: 65 65 6e 77 69 63 68 22 2c 30 2c 0d 0a 20 20 20 eenwich",0,..
9f60: 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 ANGLEUNIT["
9f70: 64 65 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 degree",0.017453
9f80: 32 39 32 35 31 39 39 34 33 33 5d 5d 2c 0d 0a 20 2925199433]],..
9f90: 20 20 20 43 53 5b 65 6c 6c 69 70 73 6f 69 64 61 CS[ellipsoida
9fa0: 6c 2c 32 5d 2c 0d 0a 20 20 20 20 20 20 20 20 41 l,2],.. A
9fb0: 58 49 53 5b 22 67 65 6f 64 65 74 69 63 20 6c 61 XIS["geodetic la
9fc0: 74 69 74 75 64 65 20 28 4c 61 74 29 22 2c 6e 6f titude (Lat)",no
9fd0: 72 74 68 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 rth,..
9fe0: 20 20 4f 52 44 45 52 5b 31 5d 2c 0d 0a 20 20 20 ORDER[1],..
9ff0: 20 20 20 20 20 20 20 20 20 41 4e 47 4c 45 55 4e ANGLEUN
a000: 49 54 5b 22 64 65 67 72 65 65 22 2c 30 2e 30 31 IT["degree",0.01
a010: 37 34 35 33 32 39 32 35 31 39 39 34 33 33 5d 5d 74532925199433]]
a020: 2c 0d 0a 20 20 20 20 20 20 20 20 41 58 49 53 5b ,.. AXIS[
a030: 22 67 65 6f 64 65 74 69 63 20 6c 6f 6e 67 69 74 "geodetic longit
a040: 75 64 65 20 28 4c 6f 6e 29 22 2c 65 61 73 74 2c ude (Lon)",east,
a050: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4f 52 .. OR
a060: 44 45 52 5b 32 5d 2c 0d 0a 20 20 20 20 20 20 20 DER[2],..
a070: 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 ANGLEUNIT["
a080: 64 65 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 degree",0.017453
a090: 32 39 32 35 31 39 39 34 33 33 5d 5d 2c 0d 0a 20 2925199433]],..
a0a0: 20 20 20 41 52 45 41 5b 22 57 6f 72 6c 64 22 5d AREA["World"]
a0b0: 2c 0d 0a 20 20 20 20 42 42 4f 58 5b 2d 39 30 2c ,.. BBOX[-90,
a0c0: 2d 31 38 30 2c 39 30 2c 31 38 30 5d 2c 0d 0a 20 -180,90,180],..
a0d0: 20 20 20 49 44 5b 22 45 50 53 47 22 2c 34 33 32 ID["EPSG",432
a0e0: 36 5d 5d 0d 0a 0d 0a 0d 0a 53 45 4c 45 43 54 20 6]]......SELECT
a0f0: 50 52 4f 4a 5f 41 73 57 4b 54 28 27 45 50 53 47 PROJ_AsWKT('EPSG
a100: 27 2c 20 34 33 32 36 2c 20 27 45 53 52 49 27 2c ', 4326, 'ESRI',
a110: 20 30 2c 20 30 29 3b 20 2d 2d 20 45 53 52 49 20 0, 0); -- ESRI
a120: 73 74 79 6c 65 2c 20 6d 6f 6e 6f 6c 69 74 68 69 style, monolithi
a130: 63 20 6c 69 6e 65 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d c 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 0d 0a 47 45 4f 47 43 53 5b 22 ------..GEOGCS["
a160: 47 43 53 5f 57 47 53 5f 31 39 38 34 22 2c 44 41 GCS_WGS_1984",DA
a170: 54 55 4d 5b 22 44 5f 57 47 53 5f 31 39 38 34 22 TUM["D_WGS_1984"
a180: 2c 53 50 48 45 52 4f 49 44 5b 22 57 47 53 5f 31 ,SPHEROID["WGS_1
a190: 39 38 34 22 2c 36 33 37 38 31 33 37 2e 30 2c 32 984",6378137.0,2
a1a0: 39 38 2e 32 35 37 32 32 33 35 36 33 5d 5d 2c 50 98.257223563]],P
a1b0: 52 49 4d 45 4d 5b 22 47 72 65 65 6e 77 69 63 68 RIMEM["Greenwich
a1c0: 22 2c 30 2e 30 5d 2c 55 4e 49 54 5b 22 44 65 67 ",0.0],UNIT["Deg
a1d0: 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 ree",0.017453292
a1e0: 35 31 39 39 34 33 33 5d 5d 0d 0a 0d 0a 0d 0a 53 5199433]]......S
a1f0: 45 4c 45 43 54 20 50 52 4f 4a 5f 47 75 65 73 73 ELECT PROJ_Guess
a200: 53 72 69 64 46 72 6f 6d 57 4b 54 28 27 47 45 4f SridFromWKT('GEO
a210: 47 43 53 5b 22 47 43 53 5f 4d 6f 6e 74 65 5f 4d GCS["GCS_Monte_M
a220: 61 72 69 6f 5f 52 6f 6d 65 22 2c 44 41 54 55 4d ario_Rome",DATUM
a230: 5b 22 44 5f 4d 6f 6e 74 65 5f 4d 61 72 69 6f 22 ["D_Monte_Mario"
a240: 2c 53 50 48 45 52 4f 49 44 5b 22 49 6e 74 65 72 ,SPHEROID["Inter
a250: 6e 61 74 69 6f 6e 61 6c 5f 31 39 32 34 22 2c 36 national_1924",6
a260: 33 37 38 33 38 38 2e 30 2c 32 39 37 2e 30 5d 5d 378388.0,297.0]]
a270: 2c 50 52 49 4d 45 4d 5b 22 52 6f 6d 65 22 2c 31 ,PRIMEM["Rome",1
a280: 32 2e 34 35 32 33 33 33 33 33 33 33 33 33 33 5d 2.4523333333333]
a290: 2c 55 4e 49 54 5b 22 44 65 67 72 65 65 22 2c 30 ,UNIT["Degree",0
a2a0: 2e 30 31 37 34 35 33 32 39 32 35 31 39 39 34 33 .017453292519943
a2b0: 33 5d 5d 27 29 3b 20 0d 0a 2d 2d 2d 2d 2d 2d 2d 3]]'); ..-------
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 0d 0a 34 38 30 36 0d 0a 0d -------..4806...
a2e0: 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f 47 ...SELECT PROJ_G
a2f0: 75 65 73 73 53 72 69 64 46 72 6f 6d 53 48 50 28 uessSridFromSHP(
a300: 27 2f 68 6f 6d 65 2f 73 61 6e 64 72 6f 2f 74 75 '/home/sandro/tu
a310: 73 63 61 6e 79 5f 73 68 70 2f 70 72 6f 76 32 30 scany_shp/prov20
a320: 31 31 27 29 3b 20 2d 2d 20 72 65 6d 65 6d 62 65 11'); -- remembe
a330: 72 3a 20 72 65 71 75 69 72 65 73 20 74 6f 20 65 r: requires to e
a340: 78 70 6c 69 63 69 74 6c 79 20 73 65 74 20 53 50 xplicitly set SP
a350: 41 54 49 41 4c 49 54 45 5f 53 45 43 55 52 49 54 ATIALITE_SECURIT
a360: 59 3d 72 65 6c 61 78 65 64 0d 0a 2d 2d 2d 2d 2d Y=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 0d 0a 33 30 30 33 0d ---------..3003.
a390: 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 3c 62 .</verbatim>..<b
a3a0: 72 3e 0d 0a 3c 68 72 3e 3c 62 72 3e 0d 0a 3c 74 r>..<hr><br>..<t
a3b0: 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 able cellspacing
a3c0: 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 ="8" cellpadding
a3d0: 3d 22 38 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 ="8" bgcolor="#f
a3e0: 66 65 30 65 39 22 20 77 69 64 74 68 3d 22 31 30 fe0e9" width="10
a3f0: 30 25 22 3e 0d 0a 3c 74 72 3e 3c 74 68 3e 0d 0a 0%">..<tr><th>..
a400: 3c 68 31 3e 49 6d 70 6f 72 74 61 6e 74 20 6e 6f <h1>Important no
a410: 74 69 63 65 20 66 6f 72 20 57 69 6e 64 6f 77 73 tice for Windows
a420: 20 75 73 65 72 73 3c 2f 68 31 3e 0d 0a 3c 2f 74 users</h1>..</t
a430: 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 h></tr>..<tr><td
a440: 3e 0d 0a 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e >..<b>PROJ.6</b>
a450: 20 63 72 69 74 69 63 61 6c 6c 79 20 64 65 70 65 critically depe
a460: 6e 64 73 20 6f 6e 20 69 74 73 20 6f 77 6e 20 70 nds on its own p
a470: 72 69 76 61 74 65 20 53 51 4c 69 74 65 20 64 61 rivate SQLite da
a480: 74 61 62 61 73 65 20 28 3c 62 3e 70 72 6f 6a 2e tabase (<b>proj.
a490: 64 62 3c 2f 62 3e 29 20 63 6f 6e 74 61 69 6e 69 db</b>) containi
a4a0: 6e 67 20 61 6c 6c 20 72 65 6c 65 76 61 6e 74 20 ng all relevant
a4b0: 64 65 66 69 6e 69 74 69 6f 6e 73 20 61 62 6f 75 definitions abou
a4c0: 74 20 45 6c 6c 69 70 73 6f 69 64 73 2c 20 50 72 t Ellipsoids, Pr
a4d0: 69 6d 65 20 4d 65 72 69 64 69 61 6e 73 2c 20 43 ime Meridians, C
a4e0: 52 53 65 73 2c 20 54 72 61 6e 73 66 6f 72 6d 61 RSes, Transforma
a4f0: 74 69 6f 6e 73 20 61 6e 64 20 61 6c 69 6b 65 2e tions and alike.
a500: 3c 62 72 3e 0d 0a 49 66 20 50 52 4f 4a 2e 36 20 <br>..If PROJ.6
a510: 69 73 20 75 6e 61 62 6c 65 20 74 6f 20 63 6f 72 is unable to cor
a520: 72 65 63 74 6c 79 20 65 73 74 61 62 6c 69 73 68 rectly establish
a530: 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f a connection to
a540: 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 69 this database i
a550: 74 20 77 69 6c 6c 20 62 65 20 73 65 76 65 72 65 t will be severe
a560: 6c 79 20 6c 69 6d 69 74 65 64 20 61 6e 64 20 77 ly limited and w
a570: 69 6c 6c 20 6e 6f 74 20 62 65 20 61 62 6c 65 20 ill not be able
a580: 74 6f 20 63 6f 72 72 65 63 74 6c 79 20 62 65 68 to correctly beh
a590: 61 76 65 20 61 73 20 65 78 70 65 63 74 65 64 2e ave as expected.
a5a0: 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 75 6c 3e 0d 0a <br><br>..<ul>..
a5b0: 3c 6c 69 3e 3c 62 3e 3c 75 3e 3c 69 3e 53 68 6f <li><b><u><i>Sho
a5c0: 72 74 20 63 6f 6e 63 6c 75 73 69 6f 6e 3c 2f 69 rt conclusion</i
a5d0: 3e 3c 2f 75 3e 3c 2f 62 3e 3a 20 69 6e 73 74 61 ></u></b>: insta
a5e0: 6c 6c 69 6e 67 20 74 68 65 20 73 6f 66 74 77 61 lling the softwa
a5f0: 72 65 20 61 6c 6f 6e 65 20 69 73 20 6e 6f 74 20 re alone is not
a600: 65 6e 6f 75 67 68 2e 3c 62 72 3e 0d 0a 54 68 65 enough.<br>..The
a610: 20 50 52 4f 4a 2e 36 20 70 72 69 76 61 74 65 20 PROJ.6 private
a620: 64 61 74 61 62 61 73 65 20 3c 62 3e 70 72 6f 6a database <b>proj
a630: 2e 64 62 3c 2f 62 3e 20 6d 75 73 74 20 62 65 20 .db</b> must be
a640: 70 72 6f 70 65 72 6c 79 20 69 6e 73 74 61 6c 6c properly install
a650: 65 64 20 61 73 20 77 65 6c 6c 2c 20 69 6e 20 6f ed as well, in o
a660: 72 64 65 72 20 74 6f 20 65 6e 73 75 72 65 20 74 rder to ensure t
a670: 68 61 74 20 61 6e 79 74 68 69 6e 67 20 72 75 6e hat anything run
a680: 73 20 73 6d 6f 6f 74 68 6c 79 2e 3c 2f 6c 69 3e s smoothly.</li>
a690: 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 0d 0a 54 68 69 ..</ul><br>..Thi
a6a0: 73 20 69 73 6e 27 74 20 75 73 75 61 6c 6c 79 20 s isn't usually
a6b0: 61 20 62 69 67 20 69 73 73 75 65 20 6f 6e 20 4c a big issue on L
a6c0: 69 6e 75 78 20 61 6e 64 20 55 6e 69 78 2d 6c 69 inux and Unix-li
a6d0: 6b 65 20 70 6c 61 74 66 6f 72 6d 73 2c 20 77 68 ke platforms, wh
a6e0: 65 72 65 20 61 20 72 61 74 69 6f 6e 61 6c 20 61 ere a rational a
a6f0: 6e 64 20 76 65 72 79 20 63 6c 65 61 72 20 66 69 nd very clear fi
a700: 6c 65 73 79 73 74 65 6d 20 6c 61 79 6f 75 74 20 lesystem layout
a710: 65 78 69 73 74 73 2e 3c 62 72 3e 0d 0a 4f 6e 20 exists.<br>..On
a720: 74 68 65 73 65 20 6f 70 65 72 61 74 69 6e 67 20 these operating
a730: 73 79 73 74 65 6d 73 20 74 68 65 20 70 61 63 6b systems the pack
a740: 61 67 65 20 6d 61 6e 61 67 65 72 20 28 6f 72 20 age manager (or
a750: 3c 62 3e 6d 61 6b 65 20 69 6e 73 74 61 6c 6c 3c <b>make install<
a760: 2f 62 3e 29 20 77 69 6c 6c 20 61 75 74 6f 6d 61 /b>) will automa
a770: 74 69 63 61 6c 6c 79 20 74 61 6b 65 20 63 61 72 tically take car
a780: 65 20 74 6f 20 69 6e 73 74 61 6c 6c 20 3c 62 3e e to install <b>
a790: 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20 6f 6e 20 74 proj.db</b> on t
a7a0: 68 65 20 6d 6f 73 74 20 61 70 70 72 6f 70 72 69 he most appropri
a7b0: 61 74 65 20 64 69 72 65 63 74 6f 72 79 20 28 75 ate directory (u
a7c0: 73 75 61 6c 6c 79 20 61 73 20 3c 62 3e 2f 75 73 sually as <b>/us
a7d0: 72 2f 73 68 61 72 65 2f 70 72 6f 6a 2f 70 72 6f r/share/proj/pro
a7e0: 6a 2e 64 62 3c 2f 62 3e 20 6f 72 20 61 73 20 3c j.db</b> or as <
a7f0: 62 3e 2f 75 73 72 2f 6c 6f 63 61 6c 2f 73 68 61 b>/usr/local/sha
a800: 72 65 2f 70 72 6f 6a 2f 70 72 6f 6a 2e 64 62 3c re/proj/proj.db<
a810: 2f 62 3e 29 20 61 6e 64 20 74 68 61 74 27 73 20 /b>) and that's
a820: 61 6c 6c 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 54 68 all.<br><br>..Th
a830: 69 6e 67 73 20 61 72 65 20 75 6e 68 61 70 70 69 ings are unhappi
a840: 6c 79 20 61 20 6c 69 74 74 6c 65 20 62 69 74 20 ly a little bit
a850: 6d 6f 72 65 20 64 69 66 66 69 63 75 6c 74 20 6f more difficult o
a860: 6e 20 57 69 6e 64 6f 77 73 20 70 6c 61 74 66 6f n Windows platfo
a870: 72 6d 73 2e 0d 0a 54 68 65 20 75 73 65 72 20 69 rms...The user i
a880: 74 73 65 6c 66 20 69 73 20 72 65 73 70 6f 6e 73 tself is respons
a890: 69 62 6c 65 20 66 6f 72 20 70 72 6f 70 65 72 6c ible for properl
a8a0: 79 20 69 6e 73 74 61 6c 6c 69 6e 67 20 3c 62 3e y installing <b>
a8b0: 70 72 6f 6a 2e 64 62 3c 2f 62 3e 0d 0a 53 6f 20 proj.db</b>..So
a8c0: 69 74 20 62 65 63 6f 6d 65 73 20 63 72 69 74 69 it becomes criti
a8d0: 63 61 6c 20 75 6e 64 65 72 73 74 61 6e 64 69 6e cal understandin
a8e0: 67 20 74 68 65 20 62 61 73 69 63 20 72 75 6c 65 g the basic rule
a8f0: 73 20 61 64 6f 70 74 65 64 20 62 79 20 3c 62 3e s adopted by <b>
a900: 6c 69 62 73 70 61 74 69 61 6c 69 74 65 3c 2f 62 libspatialite</b
a910: 3e 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 70 72 > in order to pr
a920: 6f 70 65 72 6c 79 20 6c 6f 63 61 74 65 20 3c 62 operly locate <b
a930: 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20 6f 6e 20 >proj.db</b> on
a940: 57 69 6e 64 6f 77 73 2e 0d 0a 3c 2f 74 64 3e 3c Windows...</td><
a950: 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 68 3e 0d 0a /tr>..<tr><th>..
a960: 3c 68 32 3e 57 68 65 72 65 20 70 72 6f 6a 2e 64 <h2>Where proj.d
a970: 62 20 69 73 20 65 78 70 65 63 74 65 64 20 74 6f b is expected to
a980: 20 62 65 20 66 6f 75 6e 64 20 6f 6e 20 57 69 6e be found on Win
a990: 64 6f 77 73 3c 2f 68 32 3e 0d 0a 3c 2f 74 64 3e dows</h2>..</td>
a9a0: 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d </tr>..<tr><td>.
a9b0: 0a 3c 6f 6c 3e 0d 0a 3c 6c 69 3e 74 68 65 20 66 .<ol>..<li>the f
a9c0: 69 72 73 74 20 70 6c 61 63 65 20 77 68 65 72 65 irst place where
a9d0: 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20 <b>proj.db</b>
a9e0: 77 69 6c 6c 20 62 65 20 73 65 61 72 63 68 65 64 will be searched
a9f0: 20 69 73 20 74 68 65 20 73 61 6d 65 20 66 6f 6c is the same fol
aa00: 64 65 72 20 66 6f 72 6d 20 77 68 65 72 65 20 74 der form where t
aa10: 68 65 20 3c 62 3e 45 58 45 3c 2f 62 3e 20 62 69 he <b>EXE</b> bi
aa20: 6e 61 72 79 20 77 61 73 20 69 6e 69 74 69 61 6c nary was initial
aa30: 6c 79 20 6c 6f 61 64 65 64 2e 3c 62 72 3e 0d 0a ly loaded.<br>..
aa40: 3c 69 3e 3c 75 3e 45 78 61 6d 70 6c 65 3c 2f 69 <i><u>Example</i
aa50: 3e 3c 2f 75 3e 3a 20 61 73 73 75 6d 69 6e 67 20 ></u>: assuming
aa60: 74 68 61 74 20 79 6f 75 20 61 72 65 20 63 75 72 that you are cur
aa70: 72 65 6e 74 6c 79 20 65 78 65 63 75 74 69 6e 67 rently executing
aa80: 20 3c 62 3e 43 3a 5c 6d 79 70 72 6f 67 73 5c 73 <b>C:\myprogs\s
aa90: 70 61 74 69 61 6c 69 74 65 5c 62 69 6e 5c 73 70 patialite\bin\sp
aaa0: 61 74 69 61 6c 69 74 65 2e 65 78 65 3c 2f 62 3e atialite.exe</b>
aab0: 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 74 68 65 6e ..<ul>..<li>then
aac0: 20 61 6e 20 61 74 74 65 6d 70 74 20 77 69 6c 6c an attempt will
aad0: 20 62 65 20 6d 61 64 65 20 74 6f 20 63 6f 6e 6e be made to conn
aae0: 65 63 74 20 3c 62 3e 43 3a 5c 6d 79 70 72 6f 67 ect <b>C:\myprog
aaf0: 73 5c 73 70 61 74 69 61 6c 69 74 65 5c 62 69 6e s\spatialite\bin
ab00: 5c 70 72 6f 6a 2e 64 62 3c 2f 62 3e 3c 2f 6c 69 \proj.db</b></li
ab10: 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c 69 3e 0d 0a 3c >..</ul></li>..<
ab20: 6c 69 3e 61 20 73 65 63 6f 6e 64 20 61 74 74 65 li>a second atte
ab30: 6d 70 74 20 77 69 6c 6c 20 62 65 20 6d 61 64 65 mpt will be made
ab40: 20 6f 6e 20 62 65 68 61 6c 66 20 6f 66 20 74 68 on behalf of th
ab50: 65 20 3c 62 3e 50 75 62 6c 69 63 3c 2f 62 3e 20 e <b>Public</b>
ab60: 66 6f 6c 64 65 72 2e 3c 62 72 3e 0d 0a 3c 69 3e folder.<br>..<i>
ab70: 3c 75 3e 45 78 61 6d 70 6c 65 3c 2f 75 3e 3c 2f <u>Example</u></
ab80: 69 3e 3a 20 61 6e 20 61 74 74 65 6d 70 74 20 77 i>: an attempt w
ab90: 69 6c 6c 20 62 65 20 6d 61 64 65 20 74 6f 20 63 ill be made to c
aba0: 6f 6e 6e 65 63 74 20 3c 62 3e 43 3a 5c 55 73 65 onnect <b>C:\Use
abb0: 72 73 5c 50 75 62 6c 69 63 5c 73 70 61 74 69 61 rs\Public\spatia
abc0: 6c 69 74 65 5c 70 72 6f 6a 5c 70 72 6f 6a 2e 64 lite\proj\proj.d
abd0: 62 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e b</b></li>..<li>
abe0: 61 20 74 68 69 72 64 20 28 61 6e 64 20 6c 61 73 a third (and las
abf0: 74 29 20 61 74 74 65 6d 70 74 20 77 69 6c 6c 20 t) attempt will
ac00: 62 65 20 6d 61 64 65 20 6f 6e 20 62 65 68 61 6c be made on behal
ac10: 66 20 6f 66 20 74 68 65 20 3c 62 3e 55 73 65 72 f of the <b>User
ac20: 3c 2f 62 3e 20 66 6f 6c 64 65 72 2e 3c 62 72 3e </b> folder.<br>
ac30: 0d 0a 3c 69 3e 3c 75 3e 45 78 61 6d 70 6c 65 3c ..<i><u>Example<
ac40: 2f 69 3e 3c 2f 75 3e 3a 20 61 6e 20 61 74 74 65 /i></u>: an atte
ac50: 6d 70 74 20 77 69 6c 6c 20 62 65 20 6d 61 64 65 mpt will be made
ac60: 20 74 6f 20 63 6f 6e 6e 65 63 74 20 3c 62 3e 43 to connect <b>C
ac70: 3a 5c 55 73 65 72 73 5c 73 61 6e 64 72 6f 5c 73 :\Users\sandro\s
ac80: 70 61 74 69 61 6c 69 74 65 5c 70 72 6f 6a 5c 70 patialite\proj\p
ac90: 72 6f 6a 2e 64 62 3c 2f 62 3e 3c 2f 6c 69 3e 0d roj.db</b></li>.
aca0: 0a 3c 2f 6f 6c 3e 0d 0a 3c 68 33 3e 41 6e 20 75 .</ol>..<h3>An u
acb0: 73 65 66 75 6c 20 64 69 61 67 6e 6f 73 74 69 63 seful diagnostic
acc0: 20 63 68 65 63 6b 3c 2f 68 33 3e 0d 0a 3c 76 65 check</h3>..<ve
acd0: 72 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 54 20 rbatim>..SELECT
ace0: 50 52 4f 4a 5f 47 65 74 44 61 74 61 62 61 73 65 PROJ_GetDatabase
acf0: 50 61 74 68 28 29 3b 0d 0a 3c 2f 76 65 72 62 61 Path();..</verba
ad00: 74 69 6d 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e tim>..<ul>..<li>
ad10: 69 66 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 69 if <b>NULL</b> i
ad20: 73 20 72 65 74 75 72 6e 65 64 2c 20 74 68 65 6e s returned, then
ad30: 20 50 52 4f 4a 2e 36 20 69 73 20 64 65 66 69 6e PROJ.6 is defin
ad40: 69 74 65 6c 79 20 75 6e 61 62 6c 65 20 74 6f 20 itely unable to
ad50: 63 6f 6e 6e 65 63 74 20 74 6f 20 69 74 73 20 6f connect to its o
ad60: 77 6e 20 70 72 69 76 61 74 65 20 53 51 4c 69 74 wn private SQLit
ad70: 65 20 64 61 74 61 62 61 73 65 20 3c 62 3e 70 72 e database <b>pr
ad80: 6f 6a 2e 64 62 3c 2f 62 3e 3c 62 72 3e 0d 0a 59 oj.db</b><br>..Y
ad90: 6f 75 20 68 61 76 65 20 74 6f 20 63 61 72 65 66 ou have to caref
ada0: 75 6c 6c 79 20 76 65 72 69 66 79 20 74 68 61 74 ully verify that
adb0: 20 69 74 27 73 20 72 65 61 6c 6c 79 20 69 6e 73 it's really ins
adc0: 74 61 6c 6c 65 64 20 6f 6e 20 6f 6e 65 20 6f 66 talled on one of
add0: 20 74 68 65 20 65 78 70 65 63 74 65 64 20 73 74 the expected st
ade0: 61 6e 64 61 72 64 20 6c 6f 63 61 74 69 6f 6e 73 andard locations
adf0: 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 6f 74 68 65 .</li>..<li>othe
ae00: 72 77 69 73 65 20 74 68 65 20 70 61 74 68 20 6c rwise the path l
ae10: 65 61 64 69 6e 67 20 74 6f 20 74 68 65 20 63 75 eading to the cu
ae20: 72 72 65 6e 74 6c 79 20 63 6f 6e 6e 65 63 74 65 rrently connecte
ae30: 64 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e d <b>proj.db</b>
ae40: 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 will be returne
ae50: 64 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 d.</li>..</ul><b
ae60: 72 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a r>..</td></tr>..
ae70: 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 3c 62 72 3e </table><br><br>
ae80: 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 ..<table cellspa
ae90: 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 cing="8" cellpad
aea0: 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 ding="8" bgcolor
aeb0: 3d 22 23 63 39 66 66 66 30 22 3e 0d 0a 3c 74 72 ="#c9fff0">..<tr
aec0: 3e 3c 74 68 3e 0d 0a 3c 68 32 3e 55 73 69 6e 67 ><th>..<h2>Using
aed0: 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 the environment
aee0: 20 76 61 72 69 61 62 6c 65 20 50 52 4f 4a 5f 4c variable PROJ_L
aef0: 49 42 3c 2f 68 32 3e 0d 0a 3c 2f 74 68 3e 3c 2f IB</h2>..</th></
af00: 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c tr>..<tr><td>..<
af10: 62 3e 50 52 4f 4a 5f 4c 49 42 3c 2f 62 3e 20 69 b>PROJ_LIB</b> i
af20: 73 20 61 20 73 74 61 6e 64 61 72 64 20 65 6e 76 s a standard env
af30: 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c ironment variabl
af40: 65 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 50 e supported by P
af50: 52 4f 4a 20 69 74 73 65 6c 66 2e 3c 62 72 3e 0d ROJ itself.<br>.
af60: 0a 57 68 65 6e 20 3c 62 3e 50 52 4f 4a 5f 4c 49 .When <b>PROJ_LI
af70: 42 3c 2f 62 3e 20 69 73 20 73 65 74 2c 20 74 68 B</b> is set, th
af80: 65 6e 20 50 52 4f 4a 2e 36 20 77 69 6c 6c 20 64 en PROJ.6 will d
af90: 69 72 65 63 74 6c 79 20 73 65 61 72 63 68 20 69 irectly search i
afa0: 74 73 20 6f 77 6e 20 70 72 69 76 61 74 65 20 64 ts own private d
afb0: 61 74 61 62 61 73 65 20 69 6e 74 6f 20 74 68 65 atabase into the
afc0: 20 64 69 72 65 63 74 6f 72 79 20 72 65 66 65 72 directory refer
afd0: 65 6e 63 65 64 20 62 79 20 74 68 65 20 76 61 72 enced by the var
afe0: 69 61 62 6c 65 2e 3c 62 72 3e 0d 0a 53 75 63 68 iable.<br>..Such
aff0: 20 61 20 63 61 70 61 62 69 6c 69 74 79 20 69 73 a capability is
b000: 20 73 75 70 70 6f 72 74 65 64 20 6f 6e 20 62 6f supported on bo
b010: 74 68 20 57 69 6e 64 6f 77 73 20 61 6e 64 20 4c th Windows and L
b020: 69 6e 75 78 20 28 61 6e 64 20 6f 6e 20 61 6e 79 inux (and on any
b030: 20 6f 74 68 65 72 20 70 6c 61 74 66 6f 72 6d 29 other platform)
b040: 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 69 3e 3c 75 .<br><br>..<i><u
b050: 3e 4c 69 6e 75 78 20 65 78 61 6d 70 6c 65 3c 2f >Linux example</
b060: 75 3e 3c 2f 69 3e 3a 0d 0a 3c 75 6c 3e 0d 0a 3c u></i>:..<ul>..<
b070: 6c 69 3e 3c 62 3e 65 78 70 6f 72 74 20 22 50 52 li><b>export "PR
b080: 4f 4a 5f 4c 49 42 3d 2f 68 6f 6d 65 2f 73 61 6e OJ_LIB=/home/san
b090: 64 72 6f 2f 70 72 6f 6a 22 3c 62 72 3e 0d 0a 65 dro/proj"<br>..e
b0a0: 63 68 6f 20 24 50 52 4f 4a 5f 4c 49 42 3c 62 72 cho $PROJ_LIB<br
b0b0: 3e 0d 0a 73 70 61 74 69 61 6c 69 74 65 3c 62 3e >..spatialite<b>
b0c0: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e </li>..</ul><br>
b0d0: 3c 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 57 69 6e 64 <br>..<i><u>Wind
b0e0: 6f 77 73 20 65 78 61 6d 70 6c 65 3c 2f 75 3e 3c ows example</u><
b0f0: 2f 69 3e 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e /i>:..<ul>..<li>
b100: 3c 62 3e 53 45 54 20 50 52 4f 4a 5f 4c 49 42 3d <b>SET PROJ_LIB=
b110: 43 3a 5c 55 73 65 72 73 5c 73 61 6e 64 72 6f 5c C:\Users\sandro\
b120: 70 72 6f 6a 3c 62 72 3e 0d 0a 65 63 68 6f 20 25 proj<br>..echo %
b130: 50 52 4f 4a 5f 4c 49 42 25 3c 62 72 3e 0d 0a 73 PROJ_LIB%<br>..s
b140: 70 61 74 69 61 6c 69 74 65 5f 67 75 69 3c 62 3e patialite_gui<b>
b150: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e </li>..</ul><br>
b160: 3c 62 72 3e 0d 0a 3c 2f 74 68 3e 3c 2f 74 72 3e <br>..</th></tr>
b170: 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a ..</table><br>..
b180: 3c 68 72 3e 0d 0a 3c 68 31 3e 50 52 4f 4a 2e 36 <hr>..<h1>PROJ.6
b190: 20 73 75 70 70 6f 72 74 20 6f 6e 20 73 70 61 74 support on spat
b1a0: 69 61 6c 69 74 65 5f 67 75 69 3c 2f 68 31 3e 0d ialite_gui</h1>.
b1b0: 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 .<table cellspac
b1c0: 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 ing="8" cellpadd
b1d0: 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 3d ing="8" bgcolor=
b1e0: 22 23 65 38 66 66 65 38 22 20 62 6f 72 64 65 72 "#e8ffe8" border
b1f0: 3d 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d ="1">..<tr><td>.
b200: 0a 54 68 65 20 47 55 49 20 74 6f 6f 6c 20 6a 75 .The GUI tool ju
b210: 73 74 20 69 6e 74 72 6f 64 75 63 65 73 20 61 20 st introduces a
b220: 73 69 6e 67 6c 65 20 6e 65 77 20 66 65 61 74 75 single new featu
b230: 72 65 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 6d re intended to m
b240: 61 6b 65 20 61 73 20 65 61 73 79 20 61 73 20 70 ake as easy as p
b250: 6f 73 73 69 62 6c 65 20 75 73 69 6e 67 20 50 52 ossible using PR
b260: 4f 4a 2e 36 3c 62 72 3e 3c 62 72 3e 0d 0a 54 68 OJ.6<br><br>..Th
b270: 65 20 6d 61 69 6e 20 6d 65 6e 75 20 6e 6f 77 20 e main menu now
b280: 63 6f 6e 74 61 69 6e 73 20 61 6e 20 3c 62 3e 3c contains an <b><
b290: 69 3e 45 78 74 65 72 6e 61 6c 20 76 61 72 69 61 i>External varia
b2a0: 62 6c 65 20 50 52 4f 4a 5f 4c 49 42 3c 2f 69 3e ble PROJ_LIB</i>
b2b0: 3c 2f 62 3e 20 69 74 65 6d 2e 3c 62 72 3e 0d 0a </b> item.<br>..
b2c0: 41 66 74 65 72 20 61 63 74 69 76 61 74 69 6e 67 After activating
b2d0: 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 the correspondi
b2e0: 6e 67 20 6f 70 74 69 6f 6e 20 61 20 73 74 61 6e ng option a stan
b2f0: 64 61 72 64 20 3c 62 3e 3c 69 3e 46 69 6c 65 20 dard <b><i>File
b300: 53 65 6c 65 63 74 69 6f 6e 20 44 69 61 6c 6f 67 Selection Dialog
b310: 20 3c 2f 69 3e 3c 2f 62 3e 20 77 69 6c 6c 20 73 </i></b> will s
b320: 68 6f 77 20 6f 6e 20 74 68 65 20 73 63 72 65 65 how on the scree
b330: 6e 2c 20 74 68 75 73 20 65 6e 61 62 6c 69 6e 67 n, thus enabling
b340: 20 74 68 65 20 75 73 65 72 20 74 6f 20 6c 6f 63 the user to loc
b350: 61 74 65 20 6f 6e 20 74 68 65 20 66 69 6c 65 2d ate on the file-
b360: 73 79 73 74 65 6d 20 74 68 65 20 70 72 69 76 61 system the priva
b370: 74 65 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 te <b>proj.db</b
b380: 3e 20 64 61 74 61 62 61 73 65 20 6f 66 20 50 52 > database of PR
b390: 4f 4a 2e 36 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 4f OJ.6.<br><br>..O
b3a0: 6e 63 65 20 74 68 61 74 20 3c 62 3e 70 72 6f 6a nce that <b>proj
b3b0: 2e 64 62 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 .db</b> will be
b3c0: 63 6f 72 72 65 63 74 6c 79 20 6c 6f 63 61 74 65 correctly locate
b3d0: 64 20 74 68 65 6e 20 3c 62 3e 73 70 61 74 69 61 d then <b>spatia
b3e0: 6c 69 74 65 5f 67 75 69 3c 2f 62 3e 20 77 69 6c lite_gui</b> wil
b3f0: 6c 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 l automatically
b400: 73 65 74 20 74 68 65 20 3c 62 3e 50 52 4f 4a 5f set the <b>PROJ_
b410: 4c 49 42 3c 2f 62 3e 20 76 61 72 69 61 62 6c 65 LIB</b> variable
b420: 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 41 6e 64 20 74 .<br><br>..And t
b430: 68 61 74 27 73 20 6e 6f 74 20 61 6c 6c 3b 20 3c hat's not all; <
b440: 62 3e 73 70 61 74 69 61 6c 69 74 65 5f 67 75 69 b>spatialite_gui
b450: 3c 2f 62 3e 20 77 69 6c 6c 20 70 65 72 73 69 73 </b> will persis
b460: 74 65 6e 74 6c 79 20 73 74 6f 72 65 20 74 68 65 tently store the
b470: 20 63 75 72 72 65 6e 74 20 76 61 6c 75 65 20 6f current value o
b480: 66 20 3c 62 3e 50 52 4f 4a 5f 4c 49 42 3c 2f 62 f <b>PROJ_LIB</b
b490: 3e 2c 20 73 6f 20 61 73 20 74 6f 20 61 62 6c 65 >, so as to able
b4a0: 20 74 6f 20 73 65 74 20 69 74 20 61 75 74 6f 6d to set it autom
b4b0: 61 74 69 63 61 6c 6c 79 20 66 6f 72 20 65 61 63 atically for eac
b4c0: 68 20 73 75 62 73 65 71 75 65 6e 74 20 69 6e 76 h subsequent inv
b4d0: 6f 63 61 74 69 6f 6e 2e 0d 0a 3c 2f 74 64 3e 0d ocation...</td>.
b4e0: 0a 3c 74 64 3e 0d 0a 3c 69 6d 67 20 73 72 63 3d .<td>..<img src=
b4f0: 22 68 74 74 70 73 3a 2f 2f 77 77 77 2e 67 61 69 "https://www.gai
b500: 61 2d 67 69 73 2e 69 74 2f 67 61 69 61 2d 73 69 a-gis.it/gaia-si
b510: 6e 73 2f 70 72 6f 6a 36 70 69 63 73 2f 67 75 69 ns/proj6pics/gui
b520: 2d 70 72 6f 6a 36 2e 70 6e 67 22 20 61 6c 74 3d -proj6.png" alt=
b530: 22 67 75 69 20 70 72 6f 6a 36 22 3e 0d 0a 3c 2f "gui proj6">..</
b540: 74 64 3e 3c 2f 74 72 3e 3c 74 72 3e 3c 74 64 3e td></tr><tr><td>
b550: 0d 0a 54 68 65 72 65 20 69 73 20 61 20 66 75 72 ..There is a fur
b560: 74 68 65 72 20 65 6e 68 61 6e 63 65 6d 65 6e 74 ther enhancement
b570: 20 61 76 61 69 6c 61 62 6c 65 20 77 68 65 6e 20 available when
b580: 3c 62 3e 73 70 61 74 69 61 6c 69 74 65 5f 67 75 <b>spatialite_gu
b590: 69 3c 2f 62 3e 20 69 73 20 62 61 63 6b 65 64 20 i</b> is backed
b5a0: 75 70 20 62 79 20 50 52 4f 4a 2e 36 3c 62 72 3e up by PROJ.6<br>
b5b0: 0d 0a 49 74 27 73 20 61 20 76 65 72 79 20 6c 69 ..It's a very li
b5c0: 74 74 6c 65 20 65 76 69 64 65 6e 74 20 69 6e 6e ttle evident inn
b5d0: 6f 76 61 74 69 6f 6e 2c 20 62 75 74 20 69 74 20 ovation, but it
b5e0: 77 69 6c 6c 20 70 72 6f 62 61 62 6c 79 20 62 65 will probably be
b5f0: 20 68 69 67 68 6c 79 20 61 70 70 72 65 63 69 61 highly apprecia
b600: 74 65 64 20 62 79 20 6d 61 6e 79 20 75 73 65 72 ted by many user
b610: 73 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 57 68 65 6e s.<br><br>..When
b620: 20 6c 6f 61 64 69 6e 67 20 73 6f 6d 65 20 53 68 loading some Sh
b630: 61 70 65 66 69 6c 65 20 6e 6f 77 20 74 68 65 20 apefile now the
b640: 61 70 70 72 6f 70 72 69 61 74 65 20 3c 62 3e 53 appropriate <b>S
b650: 52 49 44 20 76 61 6c 75 65 3c 2f 62 3e 20 77 69 RID value</b> wi
b660: 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74 69 63 61 ll be automatica
b670: 6c 6c 79 20 64 65 74 65 72 6d 69 6e 65 64 20 62 lly determined b
b680: 79 20 65 78 61 6d 69 6e 69 6e 67 20 74 68 65 20 y examining the
b690: 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 63 content of the c
b6a0: 6f 6d 70 61 6e 69 6f 6e 20 3c 62 3e 2e 70 72 6a ompanion <b>.prj
b6b0: 3c 2f 62 3e 20 6d 65 6d 65 62 72 20 28 69 66 20 </b> memebr (if
b6c0: 73 75 70 70 6c 69 65 64 29 2e 0d 0a 3c 2f 74 64 supplied)...</td
b6d0: 3e 0d 0a 3c 74 64 3e 0d 0a 3c 69 6d 67 20 73 72 >..<td>..<img sr
b6e0: 63 3d 22 68 74 74 70 73 3a 2f 2f 77 77 77 2e 67 c="https://www.g
b6f0: 61 69 61 2d 67 69 73 2e 69 74 2f 67 61 69 61 2d aia-gis.it/gaia-
b700: 73 69 6e 73 2f 70 72 6f 6a 36 70 69 63 73 2f 6c sins/proj6pics/l
b710: 6f 61 64 2d 73 68 70 2d 70 72 6f 6a 36 2e 70 6e oad-shp-proj6.pn
b720: 67 22 20 61 6c 74 3d 22 67 75 69 20 70 72 6f 6a g" alt="gui proj
b730: 36 22 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 6">..</td></tr>.
b740: 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c .</table><br>..<
b750: 68 72 3e 3c 62 72 3e 0d 0a 3c 61 20 68 72 65 66 hr><br>..<a href
b760: 3d 22 68 74 74 70 73 3a 2f 2f 77 77 77 2e 67 61 ="https://www.ga
b770: 69 61 2d 67 69 73 2e 69 74 2f 66 6f 73 73 69 6c ia-gis.it/fossil
b780: 2f 6c 69 62 73 70 61 74 69 61 6c 69 74 65 2f 77 /libspatialite/w
b790: 69 6b 69 3f 6e 61 6d 65 3d 34 2e 33 2e 30 2d 64 iki?name=4.3.0-d
b7a0: 6f 63 22 3e 62 61 63 6b 3c 2f 61 3e 0a 5a 20 61 oc">back</a>.Z a
b7b0: 32 30 35 35 63 66 39 30 35 30 34 63 66 32 62 66 2055cf90504cf2bf
b7c0: 62 64 64 63 38 63 65 61 33 31 37 66 38 33 36 0a bddc8cea317f836.