0000: 44 20 32 30 31 39 2d 30 35 2d 30 31 54 31 38 3a D 2019-05-01T18:
0010: 31 35 3a 32 38 2e 36 31 34 0a 4c 20 50 52 4f 4a 15:28.614.L PROJ
0020: 2e 36 0a 50 20 63 35 30 39 34 36 66 65 39 66 36 .6.P c50946fe9f6
0030: 39 62 65 35 65 30 32 63 66 66 61 63 34 33 33 65 9be5e02cffac433e
0040: 37 33 35 66 63 38 65 61 34 39 66 34 61 0a 55 20 735fc8ea49f4a.U
0050: 73 61 6e 64 72 6f 0a 57 20 34 30 37 37 30 0a 3c sandro.W 40770.<
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 74 68 65 te time in futhe
01c0: 72 20 70 72 65 73 65 6e 74 61 74 69 6f 6e 73 2e r presentations.
01d0: 3c 62 72 3e 0d 0a 57 65 20 6a 75 73 74 20 6e 65 <br>..We just ne
01e0: 65 64 20 61 20 62 69 74 20 6f 66 20 68 69 73 74 ed a bit of hist
01f0: 6f 72 79 20 74 6f 20 66 75 6c 6c 79 20 75 6e 64 ory to fully und
0200: 65 72 73 74 61 6e 64 20 74 68 65 20 63 75 72 72 erstand the curr
0210: 65 6e 74 20 73 74 61 74 65 20 6f 66 20 74 68 65 ent state of the
0220: 20 61 72 74 20 6f 66 20 74 68 69 73 20 6c 69 62 art of this lib
0230: 72 61 72 79 3a 3c 62 72 3e 0d 0a 3c 68 33 3e 50 rary:<br>..<h3>P
0240: 61 73 74 20 48 69 73 74 6f 72 79 3c 2f 68 33 3e ast History</h3>
0250: 0d 0a 3c 62 3e 3c 75 3e 54 69 6d 65 6c 69 6e 65 ..<b><u>Timeline
0260: 3c 2f 75 3e 3c 2f 62 3e 3a 0d 0a 3c 75 6c 3e 0d </u></b>:..<ul>.
0270: 0a 3c 6c 69 3e 56 65 72 79 20 66 65 77 20 75 73 .<li>Very few us
0280: 65 72 73 20 61 6e 64 20 64 65 76 65 6c 6f 70 65 ers and develope
0290: 72 73 20 64 6f 20 72 65 61 6c 6c 79 20 72 65 61 rs do really rea
02a0: 6c 69 7a 65 20 68 6f 77 20 61 6e 63 69 65 6e 74 lize how ancient
02b0: 20 69 73 20 50 52 4f 4a 2c 20 61 6e 64 20 68 6f is PROJ, and ho
02c0: 77 20 66 61 72 20 69 6e 20 74 69 6d 65 20 69 74 w far in time it
02d0: 20 73 74 61 72 74 65 64 20 6d 6f 76 69 6e 67 20 started moving
02e0: 69 74 73 20 66 69 72 73 74 20 73 74 65 70 73 2e its first steps.
02f0: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 69 6e 20 3c 62 </li>..<li>in <b
0300: 3e 31 39 38 30 3c 2f 62 3e 20 28 61 62 6f 75 74 >1980</b> (about
0310: 20 34 30 20 79 65 61 72 73 20 61 67 6f 29 20 47 40 years ago) G
0320: 65 72 61 6c 64 20 45 76 65 6e 64 65 6e 20 73 74 erald Evenden st
0330: 61 72 74 65 64 20 77 6f 72 6b 69 6e 67 20 6f 6e arted working on
0340: 20 74 68 65 20 76 65 72 79 20 66 69 72 73 74 20 the very first
0350: 50 52 4f 4a 20 76 65 72 73 69 6f 6e 2c 20 61 6e PROJ version, an
0360: 64 20 61 74 20 74 68 65 20 74 69 6d 65 20 69 74 d at the time it
0370: 20 77 61 73 20 61 20 52 61 74 66 6f 72 20 70 72 was a Ratfor pr
0380: 6f 67 72 61 6d 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 ogram.</li>..<li
0390: 3e 69 6e 20 3c 62 3e 31 39 38 35 3c 2f 62 3e 20 >in <b>1985</b>
03a0: 74 68 65 20 63 6f 64 65 20 77 61 73 20 63 6f 6d the code was com
03b0: 70 6c 65 74 65 6c 79 20 72 65 77 72 69 74 74 65 pletely rewritte
03c0: 6e 20 69 6e 20 43 20 74 6f 20 72 75 6e 20 6f 6e n in C to run on
03d0: 20 55 4e 49 58 20 73 79 73 74 65 6d 73 2c 20 61 UNIX systems, a
03e0: 6e 64 20 69 74 20 77 61 73 20 6e 61 6d 65 64 20 nd it was named
03f0: 3c 62 3e 50 52 4f 4a 2e 32 3c 2f 62 3e 2e 3c 2f <b>PROJ.2</b>.</
0400: 6c 69 3e 0d 0a 3c 6c 69 3e 69 6e 20 3c 62 3e 31 li>..<li>in <b>1
0410: 39 39 30 3c 2f 62 3e 20 77 61 73 20 72 65 6c 65 990</b> was rele
0420: 61 73 65 64 20 61 6e 20 75 70 64 61 74 65 64 20 ased an updated
0430: 76 65 72 73 69 6f 6e 20 6e 61 6d 65 64 20 3c 62 version named <b
0440: 3e 50 52 4f 4a 2e 33 3c 2f 6c 69 3e 0d 0a 3c 6c >PROJ.3</li>..<l
0450: 69 3e 69 6e 20 3c 62 3e 31 39 39 34 3c 2f 62 3e i>in <b>1994</b>
0460: 20 61 20 6d 6f 72 65 20 61 64 76 61 6e 63 65 64 a more advanced
0470: 20 76 65 72 73 69 6f 6e 20 77 61 73 20 72 65 6c version was rel
0480: 65 61 73 65 64 2c 20 61 6e 64 20 69 74 20 77 61 eased, and it wa
0490: 73 20 6f 62 76 69 6f 75 73 6c 79 20 6e 61 6d 65 s obviously name
04a0: 64 20 3c 62 3e 50 52 4f 4a 2e 34 3c 2f 62 3e 3c d <b>PROJ.4</b><
04b0: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 69 6e 20 3c 62 3e /li>..<li>in <b>
04c0: 31 39 39 35 3c 2f 62 3e 20 45 76 65 6e 64 65 6e 1995</b> Evenden
04d0: 20 73 74 6f 70 70 65 64 20 61 6e 79 20 66 75 72 stopped any fur
04e0: 74 68 65 72 20 64 65 76 65 6c 6f 70 6d 65 6e 74 ther development
04f0: 20 61 63 74 69 76 69 74 79 20 61 6e 64 20 74 68 activity and th
0500: 65 20 70 72 6f 6a 65 63 74 20 62 65 63 6f 6d 65 e project become
0510: 20 69 6e 61 63 74 69 76 65 20 66 6f 72 20 73 65 inactive for se
0520: 76 65 72 61 6c 20 79 65 61 72 73 2e 3c 2f 6c 69 veral years.</li
0530: 3e 0d 0a 3c 6c 69 3e 69 6e 20 3c 62 3e 32 30 30 >..<li>in <b>200
0540: 30 3c 2f 62 3e 20 46 72 61 6e 6b 20 57 61 72 6d 0</b> Frank Warm
0550: 65 72 64 61 6d 20 62 61 63 61 6d 65 20 74 68 65 erdam bacame the
0560: 20 6e 65 77 20 6d 61 69 6e 74 61 69 6e 65 72 20 new maintainer
0570: 61 6e 64 20 72 65 6c 65 61 73 65 64 20 76 65 72 and released ver
0580: 73 69 6f 6e 20 3c 62 3e 34 2e 34 3c 2f 62 3e 3c sion <b>4.4</b><
0590: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 41 66 74 65 72 20 /li>..<li>After
05a0: 74 68 69 73 20 72 65 62 6f 72 6e 20 74 68 65 20 this reborn the
05b0: 72 65 76 69 74 61 6c 69 7a 65 64 20 70 72 6f 6a revitalized proj
05c0: 65 63 74 20 63 6f 6e 74 69 6e 75 65 64 20 74 6f ect continued to
05d0: 20 62 65 20 72 65 67 75 6c 61 72 6c 79 20 6d 61 be regularly ma
05e0: 69 6e 74 61 69 6e 65 64 2c 20 62 75 74 20 6e 6f intained, but no
05f0: 20 66 75 72 74 68 65 72 20 72 65 6c 65 76 61 6e further relevan
0600: 74 20 69 6d 70 72 6f 76 65 6d 65 6e 74 73 20 77 t improvements w
0610: 65 72 65 20 69 6e 74 72 6f 64 75 63 65 64 2e 3c ere introduced.<
0620: 62 72 3e 0d 0a 50 52 4f 4a 2e 34 20 6a 75 73 74 br>..PROJ.4 just
0630: 20 63 6f 6e 74 69 6e 75 65 64 20 69 74 73 20 76 continued its v
0640: 65 72 79 20 70 6c 61 63 69 64 20 65 76 6f 6c 75 ery placid evolu
0650: 74 69 6f 6e 20 69 6e 20 61 20 73 75 62 73 74 61 tion in a substa
0660: 6e 74 69 61 6c 6c 79 20 63 6f 6e 73 65 72 76 61 ntially conserva
0670: 74 69 76 65 20 77 61 79 2e 3c 2f 6c 69 3e 0d 0a tive way.</li>..
0680: 3c 2f 75 6c 3e 3c 62 72 3e 0d 0a 3c 62 3e 3c 75 </ul><br>..<b><u
0690: 3e 53 68 6f 72 74 20 63 6f 6e 63 6c 75 73 69 6f >Short conclusio
06a0: 6e 3c 2f 75 3e 3c 2f 62 3e 3a 20 74 68 65 20 66 n</u></b>: the f
06b0: 6f 75 72 74 68 20 76 65 72 73 69 6f 6e 20 6f 66 ourth version of
06c0: 20 50 52 4f 4a 20 28 61 6b 61 20 3c 62 3e 50 52 PROJ (aka <b>PR
06d0: 4f 4a 2e 34 3c 2f 62 3e 29 20 6c 61 73 74 65 64 OJ.4</b>) lasted
06e0: 20 66 6f 72 20 61 62 6f 75 74 20 74 77 6f 20 64 for about two d
06f0: 65 63 61 64 65 73 2c 20 61 20 76 65 72 79 20 75 ecades, a very u
0700: 6e 63 6f 6d 6d 6f 6e 20 73 69 74 75 61 74 69 6f ncommon situatio
0710: 6e 2e 3c 62 72 3e 0d 0a 41 6e 64 20 63 6f 6e 73 n.<br>..And cons
0720: 65 71 75 65 6e 74 6c 79 20 61 20 66 75 6c 6c 20 equently a full
0730: 67 65 6e 65 72 61 74 69 6f 6e 20 6f 66 20 64 65 generation of de
0740: 76 65 6c 6f 70 65 72 73 20 61 6e 64 20 75 73 65 velopers and use
0750: 72 73 20 62 65 63 61 6d 65 20 73 69 6e 63 65 72 rs became sincer
0760: 65 6c 79 20 63 6f 6e 76 69 6e 63 65 64 20 74 68 ely convinced th
0770: 61 74 20 50 52 4f 4a 2e 34 20 77 61 73 20 74 68 at PROJ.4 was th
0780: 65 20 72 65 61 6c 20 6e 61 6d 65 20 6f 66 20 74 e real name of t
0790: 68 65 20 6c 69 62 72 61 72 79 2e 0d 0a 3c 68 33 he library...<h3
07a0: 3e 54 68 65 20 72 65 76 6f 6c 75 74 69 6f 6e 20 >The revolution
07b0: 63 6f 6d 65 73 3c 2f 68 33 3e 0d 0a 3c 62 3e 3c comes</h3>..<b><
07c0: 75 3e 54 69 6d 65 6c 69 6e 65 3c 2f 75 3e 3c 2f u>Timeline</u></
07d0: 62 3e 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 69 b>:..<ul>..<li>i
07e0: 6e 20 3c 62 3e 32 30 31 38 3c 2f 62 3e 20 45 76 n <b>2018</b> Ev
07f0: 65 6e 20 52 6f 75 61 75 6c 74 2c 20 4b 72 69 73 en Rouault, Kris
0800: 74 69 61 6e 20 45 76 65 72 73 20 61 6e 64 20 6f tian Evers and o
0810: 74 68 65 72 73 20 73 74 61 72 74 20 64 65 76 65 thers start deve
0820: 6c 6f 70 69 6e 67 20 61 20 72 65 76 6f 6c 75 74 loping a revolut
0830: 69 6f 6e 69 7a 65 64 20 50 52 4f 4a 20 73 75 70 ionized PROJ sup
0840: 70 6f 72 74 69 6e 67 20 6d 61 6e 79 20 72 65 6c porting many rel
0850: 65 76 61 6e 74 20 69 6e 6e 6f 76 61 74 69 6f 6e evant innovation
0860: 73 2e 3c 62 72 3e 0d 0a 3c 62 3e 50 52 4f 4a 2e s.<br>..<b>PROJ.
0870: 35 3c 2f 62 3e 20 69 73 20 69 6e 74 65 6e 64 65 5</b> is intende
0880: 64 20 74 6f 20 62 65 20 74 68 65 20 66 69 72 73 d to be the firs
0890: 74 20 70 72 65 6c 69 6d 69 6e 61 72 79 20 73 74 t preliminary st
08a0: 65 70 20 6f 66 20 61 20 6d 6f 72 65 20 63 6f 6d ep of a more com
08b0: 70 6c 65 78 20 65 76 6f 6c 75 74 69 6f 6e 20 73 plex evolution s
08c0: 63 68 65 6d 61 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 chema.</li>..<li
08d0: 3e 6f 6e 20 3c 62 3e 4d 61 72 63 68 20 32 30 31 >on <b>March 201
08e0: 39 3c 2f 62 3e 20 61 20 6d 6f 72 65 20 6d 61 74 9</b> a more mat
08f0: 75 72 65 20 76 65 72 73 69 6f 6e 20 69 73 20 72 ure version is r
0900: 65 6c 65 61 73 65 64 2c 20 61 6e 64 20 69 74 27 eleased, and it'
0910: 73 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 3c s <b>PROJ.6</b><
0920: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 4e 65 78 74 20 79 /li>..<li>Next y
0930: 65 61 72 20 28 32 30 32 30 29 20 3c 62 3e 50 52 ear (2020) <b>PR
0940: 4f 4a 2e 37 3c 2f 62 3e 20 69 73 20 65 78 70 65 OJ.7</b> is expe
0950: 63 74 65 64 20 74 6f 20 62 65 20 72 65 6c 65 61 cted to be relea
0960: 73 65 64 2c 20 61 6e 64 20 69 74 20 77 69 6c 6c sed, and it will
0970: 20 66 75 6c 6c 79 20 63 6f 6d 70 6c 65 74 65 20 fully complete
0980: 74 68 65 20 74 72 61 6e 73 69 74 69 6f 6e 20 62 the transition b
0990: 65 74 77 65 65 6e 20 74 68 65 20 6f 6c 64 20 61 etween the old a
09a0: 6e 64 20 6e 65 77 20 61 72 63 68 69 74 65 63 74 nd new architect
09b0: 75 72 65 73 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c ures.</li>..</ul
09c0: 3e 0d 0a 3c 62 72 3e 0d 0a 3c 62 3e 3c 75 3e 4e >..<br>..<b><u>N
09d0: 6f 74 65 3c 2f 75 3e 3c 2f 62 3e 3a 20 74 68 65 ote</u></b>: the
09e0: 20 77 68 6f 6c 65 20 74 72 61 6e 73 69 74 69 6f whole transitio
09f0: 6e 20 69 6d 70 6c 69 65 73 20 6d 61 6e 79 20 72 n implies many r
0a00: 65 6c 65 76 61 6e 74 20 63 68 61 6e 67 65 73 2c elevant changes,
0a10: 20 73 6f 20 74 68 61 74 20 61 20 64 65 65 70 6c so that a deepl
0a20: 79 20 72 65 76 69 73 65 64 20 41 50 49 20 77 69 y revised API wi
0a30: 6c 6c 20 62 65 20 72 65 71 75 69 72 65 64 2e 0d ll be required..
0a40: 0a 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c .In other words,
0a50: 20 74 68 65 20 6f 6c 64 20 3c 62 3e 50 52 4f 4a the old <b>PROJ
0a60: 2e 34 3c 2f 62 3e 20 61 6e 64 20 74 68 65 20 6e .4</b> and the n
0a70: 65 77 20 3c 62 3e 50 52 4f 4a 2e 37 3c 2f 62 3e ew <b>PROJ.7</b>
0a80: 20 77 69 6c 6c 20 73 75 70 70 6f 72 74 20 74 77 will support tw
0a90: 6f 20 64 69 66 66 65 72 65 6e 74 20 41 50 49 73 o different APIs
0aa0: 2c 20 74 68 75 73 20 61 62 72 75 70 74 6c 79 20 , thus abruptly
0ab0: 62 72 65 61 6b 69 6e 67 20 63 72 6f 73 73 2d 76 breaking cross-v
0ac0: 65 72 73 69 6f 6e 20 63 6f 6d 70 61 74 69 62 69 ersion compatibi
0ad0: 6c 69 74 79 2e 3c 62 72 3e 0d 0a 54 68 69 73 20 lity.<br>..This
0ae0: 69 73 20 61 6e 20 75 6d 70 6c 65 61 73 61 6e 74 is an umpleasant
0af0: 20 6e 65 77 2c 20 62 65 63 61 75 73 65 20 69 74 new, because it
0b00: 20 70 72 61 63 74 69 63 61 6c 6c 79 20 6d 65 61 practically mea
0b10: 6e 73 20 74 68 61 74 20 61 6c 6c 20 73 6f 66 74 ns that all soft
0b20: 77 61 72 65 20 6d 6f 64 75 6c 65 73 20 64 65 70 ware modules dep
0b30: 65 6e 64 69 6e 67 20 6f 6e 20 50 52 4f 4a 20 28 ending on PROJ (
0b40: 74 68 69 73 20 69 6e 63 6c 75 64 69 6e 67 20 53 this including S
0b50: 70 61 74 69 61 4c 69 74 65 29 20 77 69 6c 6c 20 patiaLite) will
0b60: 72 65 71 75 69 72 65 20 61 20 6e 6f 74 20 61 74 require a not at
0b70: 20 61 6c 6c 20 74 72 69 76 69 61 6c 20 72 65 77 all trivial rew
0b80: 72 69 74 65 20 69 6e 20 6f 72 64 65 72 20 74 6f rite in order to
0b90: 20 66 75 6c 66 69 6c 6c 20 74 68 65 20 6e 65 77 fulfill the new
0ba0: 20 41 50 49 20 72 65 71 75 69 72 65 6d 65 6e 74 API requirement
0bb0: 73 2e 3c 62 72 3e 0d 0a 42 75 74 20 77 68 65 6e s.<br>..But when
0bc0: 20 79 6f 75 20 63 6f 6e 73 69 64 65 72 20 74 68 you consider th
0bd0: 61 74 27 73 20 74 68 65 20 66 69 72 73 74 20 74 at's the first t
0be0: 69 6d 65 20 69 6e 20 69 74 73 20 76 65 72 79 20 ime in its very
0bf0: 6c 6f 6e 67 20 6c 69 66 65 20 74 68 61 74 20 50 long life that P
0c00: 52 4f 4a 20 72 65 71 75 69 72 65 73 20 61 6e 20 ROJ requires an
0c10: 65 78 74 72 61 20 65 66 66 6f 72 74 20 69 6e 20 extra effort in
0c20: 6f 72 64 65 72 20 74 6f 20 69 6e 74 72 6f 64 75 order to introdu
0c30: 63 65 20 73 6f 20 6d 61 6e 79 20 75 73 65 66 75 ce so many usefu
0c40: 6c 20 69 6e 6e 6f 76 61 74 69 6f 6e 73 2c 20 74 l innovations, t
0c50: 68 69 73 20 75 6e 65 78 70 65 63 74 65 64 20 41 his unexpected A
0c60: 50 49 20 62 72 65 61 6b 61 67 65 20 6c 6f 6f 6b PI breakage look
0c70: 73 20 66 75 6c 6c 79 20 6a 75 73 74 69 66 69 65 s fully justifie
0c80: 64 20 61 6e 64 20 61 62 73 6f 6c 75 74 65 6c 79 d and absolutely
0c90: 20 72 65 61 73 6f 6e 61 62 6c 65 2e 3c 62 72 3e reasonable.<br>
0ca0: 3c 62 72 3e 0d 0a 3c 62 3e 3c 75 3e 4d 6f 72 65 <br>..<b><u>More
0cb0: 20 64 65 74 61 69 6c 73 20 61 62 6f 75 74 20 74 details about t
0cc0: 68 65 20 41 50 49 20 62 72 65 61 6b 61 67 65 3c he API breakage<
0cd0: 2f 75 3e 3c 2f 62 3e 3a 0d 0a 3c 75 6c 3e 0d 0a /u></b>:..<ul>..
0ce0: 3c 6c 69 3e 3c 62 3e 50 52 4f 4a 2e 35 3c 2f 62 <li><b>PROJ.5</b
0cf0: 3e 20 73 74 61 72 74 65 64 20 69 6e 74 72 6f 64 > started introd
0d00: 75 63 69 6e 67 20 74 68 65 20 6e 65 77 20 41 50 ucing the new AP
0d10: 49 2c 20 62 75 74 20 77 61 73 20 73 74 69 6c 6c I, but was still
0d20: 20 61 62 6c 65 20 74 6f 20 73 75 70 70 6f 72 74 able to support
0d30: 20 74 68 65 20 6f 6c 64 20 74 72 61 64 69 74 69 the old traditi
0d40: 6f 6e 61 6c 20 41 50 49 20 77 69 74 68 6f 75 74 onal API without
0d50: 20 61 6e 79 20 63 6f 6d 70 6c 61 69 6e 74 2e 3c any complaint.<
0d60: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 50 52 4f /li>..<li><b>PRO
0d70: 4a 2e 36 3c 2f 62 3e 20 68 61 76 65 20 64 65 70 J.6</b> have dep
0d80: 72 65 63 65 74 65 64 20 74 68 65 20 6f 6c 64 20 receted the old
0d90: 74 72 61 64 69 74 69 6f 6e 61 6c 20 41 50 49 2e traditional API.
0da0: 3c 62 72 3e 0d 0a 49 74 20 73 74 69 6c 6c 20 63 <br>..It still c
0db0: 6f 6e 74 69 6e 75 65 73 20 74 6f 20 62 65 20 72 ontinues to be r
0dc0: 65 6c 75 63 74 61 6e 63 74 6c 79 20 73 75 70 70 eluctanctly supp
0dd0: 6f 72 74 65 64 2c 20 62 75 74 20 74 68 65 20 6c orted, but the l
0de0: 69 62 72 61 72 79 20 72 65 71 75 69 72 65 73 20 ibrary requires
0df0: 74 6f 20 62 65 20 63 6f 6d 70 69 6c 65 64 20 62 to be compiled b
0e00: 79 20 65 78 70 6c 69 63 69 74 6c 79 20 64 65 66 y explicitly def
0e10: 69 6e 69 6e 67 20 61 20 3c 62 3e 2d 44 41 43 43 ining a <b>-DACC
0e20: 45 50 54 5f 55 53 45 5f 4f 46 5f 44 45 50 52 45 EPT_USE_OF_DEPRE
0e30: 43 41 54 45 44 5f 50 52 4f 4a 5f 41 50 49 5f 48 CATED_PROJ_API_H
0e40: 3d 31 3c 2f 62 3e 20 64 69 72 65 63 74 69 76 65 =1</b> directive
0e50: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 65 66 66 in order to eff
0e60: 65 63 74 69 76 65 6c 79 20 65 6e 61 62 6c 65 20 ectively enable
0e70: 74 68 69 73 20 6f 70 74 69 6f 6e 2e 3c 2f 6c 69 this option.</li
0e80: 3e 0d 0a 3c 6c 69 3e 61 6e 64 20 66 69 6e 61 6c >..<li>and final
0e90: 6c 79 20 74 68 65 20 6e 65 78 74 2d 74 6f 2d 63 ly the next-to-c
0ea0: 6f 6d 65 20 3c 62 3e 50 52 4f 4a 2e 37 3c 2f 62 ome <b>PROJ.7</b
0eb0: 3e 20 77 69 6c 6c 20 63 6f 6d 70 6c 65 74 65 6c > will completel
0ec0: 79 20 67 65 74 20 72 69 64 20 6f 66 20 74 68 65 y get rid of the
0ed0: 20 6f 6c 64 20 41 50 49 2e 3c 2f 6c 69 3e 0d 0a old API.</li>..
0ee0: 3c 2f 75 6c 3e 0d 0a 3c 62 72 3e 0d 0a 3c 68 72 </ul>..<br>..<hr
0ef0: 3e 0d 0a 3c 68 31 3e 57 68 61 74 27 73 20 6e 65 >..<h1>What's ne
0f00: 77 20 69 6e 20 50 52 4f 4a 2e 36 3c 2f 68 31 3e w in PROJ.6</h1>
0f10: 0d 0a 3c 68 33 3e 46 75 6c 6c 79 20 73 75 70 70 ..<h3>Fully supp
0f20: 6f 72 74 69 6e 67 20 49 53 4f 2d 31 39 31 31 31 orting ISO-19111
0f30: 3a 32 30 31 39 20 57 4b 54 3c 2f 68 33 3e 0d 0a :2019 WKT</h3>..
0f40: 4f 6c 64 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 Old versions of
0f50: 50 52 4f 4a 20 28 69 6e 63 6c 75 64 69 6e 67 20 PROJ (including
0f60: 3c 62 3e 50 52 4f 4a 2e 34 3c 2f 62 3e 29 20 72 <b>PROJ.4</b>) r
0f70: 65 71 75 69 72 65 64 20 74 6f 20 64 65 66 69 6e equired to defin
0f80: 65 20 65 61 63 68 20 3c 62 3e 43 52 53 3c 2f 62 e each <b>CRS</b
0f90: 3e 20 28 3c 69 3e 43 6f 6f 72 64 69 6e 61 74 65 > (<i>Coordinate
0fa0: 20 52 65 66 65 72 65 6e 63 65 20 53 79 73 74 65 Reference Syste
0fb0: 6d 3c 2f 69 3e 29 20 62 79 20 61 20 63 6f 72 72 m</i>) by a corr
0fc0: 65 73 70 6f 6e 64 69 6e 67 20 3c 62 3e 70 72 6f esponding <b>pro
0fd0: 6a 2d 73 74 72 69 6e 67 3c 2f 62 3e 2e 0d 0a 54 j-string</b>...T
0fe0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 61 62 he following tab
0ff0: 6c 65 20 65 78 65 6d 70 6c 69 66 69 65 73 20 74 le exemplifies t
1000: 68 65 20 63 61 73 65 20 6f 66 20 66 65 77 20 43 he case of few C
1010: 52 53 65 73 3a 3c 62 72 3e 3c 62 72 3e 0d 0a 3c RSes:<br><br>..<
1020: 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 6e table cellspacin
1030: 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 69 6e g="8" cellpaddin
1040: 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 3d 22 23 g="8" bgcolor="#
1050: 65 38 66 66 65 38 22 20 62 6f 72 64 65 72 3d 22 e8ffe8" border="
1060: 31 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 67 63 1">..<tr><th bgc
1070: 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 3e 53 olor="#ffb03e">S
1080: 52 49 44 3c 2f 74 68 3e 3c 74 68 20 62 67 63 6f RID</th><th bgco
1090: 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 3e 43 52 lor="#ffb03e">CR
10a0: 53 20 4e 61 6d 65 3c 2f 74 68 3e 3c 74 68 20 62 S Name</th><th b
10b0: 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 gcolor="#ffb03e"
10c0: 3e 70 72 6f 6a 2d 73 74 72 69 6e 67 3c 2f 74 68 >proj-string</th
10d0: 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 20 ></tr>..<tr><td
10e0: 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 33 30 align="right">30
10f0: 30 33 3c 2f 74 64 3e 3c 74 64 3e 4d 6f 6e 74 65 03</td><td>Monte
1100: 20 4d 61 72 69 6f 20 2f 20 49 74 61 6c 79 20 7a Mario / Italy z
1110: 6f 6e 65 20 31 3c 2f 74 64 3e 0d 0a 3c 74 64 3e one 1</td>..<td>
1120: 2b 70 72 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 +proj=tmerc +lat
1130: 5f 30 3d 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b _0=0 +lon_0=9 +k
1140: 3d 30 2e 39 39 39 36 20 2b 78 5f 30 3d 31 35 30 =0.9996 +x_0=150
1150: 30 30 30 30 20 2b 79 5f 30 3d 30 20 2b 65 6c 6c 0000 +y_0=0 +ell
1160: 70 73 3d 69 6e 74 6c 20 2b 74 6f 77 67 73 38 34 ps=intl +towgs84
1170: 3d 2d 31 30 34 2e 31 2c 2d 34 39 2e 31 2c 2d 39 =-104.1,-49.1,-9
1180: 2e 39 2c 30 2e 39 37 31 2c 2d 32 2e 39 31 37 2c .9,0.971,-2.917,
1190: 30 2e 37 31 34 2c 2d 31 31 2e 36 38 20 2b 75 6e 0.714,-11.68 +un
11a0: 69 74 73 3d 6d 20 2b 6e 6f 5f 64 65 66 73 3c 2f its=m +no_defs</
11b0: 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 td></tr>..<tr><t
11c0: 64 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e d align="right">
11d0: 34 33 32 36 3c 2f 74 64 3e 3c 74 64 3e 57 47 53 4326</td><td>WGS
11e0: 20 38 34 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 2b 70 84</td>..<td>+p
11f0: 72 6f 6a 3d 6c 6f 6e 67 6c 61 74 20 2b 64 61 74 roj=longlat +dat
1200: 75 6d 3d 57 47 53 38 34 20 2b 6e 6f 5f 64 65 66 um=WGS84 +no_def
1210: 73 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 s</td></tr>..<tr
1220: 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 68 ><td align="righ
1230: 74 22 3e 33 32 36 33 32 3c 2f 74 64 3e 3c 74 64 t">32632</td><td
1240: 3e 57 47 53 20 38 34 20 2f 20 55 54 4d 20 7a 6f >WGS 84 / UTM zo
1250: 6e 65 20 33 32 4e 3c 2f 74 64 3e 0d 0a 3c 74 64 ne 32N</td>..<td
1260: 3e 2b 70 72 6f 6a 3d 75 74 6d 20 2b 7a 6f 6e 65 >+proj=utm +zone
1270: 3d 33 32 20 2b 64 61 74 75 6d 3d 57 47 53 38 34 =32 +datum=WGS84
1280: 20 2b 75 6e 69 74 73 3d 6d 20 2b 6e 6f 5f 64 65 +units=m +no_de
1290: 66 73 3c 2f 74 64 3e 0d 0a 3c 2f 74 61 62 6c 65 fs</td>..</table
12a0: 3e 0d 0a 3c 62 72 3e 0d 0a 4e 65 77 20 76 65 72 >..<br>..New ver
12b0: 73 69 6f 6e 73 20 6f 66 20 50 52 4f 4a 20 28 73 sions of PROJ (s
12c0: 74 61 72 74 69 6e 67 20 73 69 6e 63 65 20 3c 62 tarting since <b
12d0: 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 29 20 73 74 69 >PROJ.6</b>) sti
12e0: 6c 6c 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20 73 ll continue to s
12f0: 75 70 70 6f 72 74 20 74 68 65 20 6f 6c 64 20 3c upport the old <
1300: 62 3e 70 72 6f 6a 2d 73 74 72 69 6e 67 73 3c 2f b>proj-strings</
1310: 62 3e 2c 20 62 75 74 20 74 68 65 20 70 72 65 66 b>, but the pref
1320: 65 72 72 65 64 20 6e 6f 74 61 74 69 6f 6e 20 66 erred notation f
1330: 6f 72 20 64 65 66 69 6e 69 6e 67 20 61 6e 79 20 or defining any
1340: 43 52 53 20 69 73 20 6e 6f 77 20 63 6f 6e 66 6f CRS is now confo
1350: 72 6d 61 6e 74 20 74 6f 20 74 68 65 20 3c 62 3e rmant to the <b>
1360: 49 53 4f 2d 31 39 31 31 31 3a 32 30 31 39 3c 2f ISO-19111:2019</
1370: 62 3e 20 69 6e 74 65 72 6e 61 74 69 6f 6e 61 6c b> international
1380: 20 73 74 61 6e 64 61 72 64 3c 62 72 3e 0d 0a 28 standard<br>..(
1390: 3c 69 3e 4f 47 43 20 41 62 73 74 72 61 63 74 20 <i>OGC Abstract
13a0: 53 70 65 63 69 66 69 63 61 74 69 6f 6e 20 54 6f Specification To
13b0: 70 69 63 20 32 3a 20 e2 80 9c 52 65 66 65 72 65 pic 2: ...Refere
13c0: 6e 63 69 6e 67 20 42 79 20 43 6f 6f 72 64 69 6e ncing By Coordin
13d0: 61 74 65 73 e2 80 9d 3c 2f 69 3e 29 2e 3c 62 72 ates...</i>).<br
13e0: 3e 0d 0a 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 >..The following
13f0: 20 74 61 62 6c 65 20 65 78 65 6d 70 6c 69 66 69 table exemplifi
1400: 65 73 20 74 68 65 20 73 61 6d 65 20 43 52 53 65 es the same CRSe
1410: 73 20 61 73 20 61 62 6f 76 65 20 69 6e 20 74 68 s as above in th
1420: 65 20 49 53 4f 20 57 4b 54 20 6e 6f 74 61 74 69 e ISO WKT notati
1430: 6f 6e 3a 0d 0a 3c 62 72 3e 3c 62 72 3e 0d 0a 3c on:..<br><br>..<
1440: 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 6e table cellspacin
1450: 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 69 6e g="8" cellpaddin
1460: 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 3d 22 23 g="8" bgcolor="#
1470: 65 38 66 66 65 38 22 20 62 6f 72 64 65 72 3d 22 e8ffe8" border="
1480: 31 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 67 63 1">..<tr><th bgc
1490: 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 3e 53 olor="#ffb03e">S
14a0: 52 49 44 3c 2f 74 68 3e 3c 74 64 3e 33 30 30 33 RID</th><td>3003
14b0: 3c 2f 74 64 3e 3c 74 64 3e 34 33 32 36 3c 2f 74 </td><td>4326</t
14c0: 64 3e 3c 74 64 3e 33 32 36 33 32 3c 2f 74 64 3e d><td>32632</td>
14d0: 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 </tr>..<tr><th b
14e0: 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 gcolor="#ffb03e"
14f0: 3e 43 52 53 20 4e 61 6d 65 3c 2f 74 68 3e 3c 74 >CRS Name</th><t
1500: 64 3e 4d 6f 6e 74 65 20 4d 61 72 69 6f 20 2f 20 d>Monte Mario /
1510: 49 74 61 6c 79 20 7a 6f 6e 65 20 31 3c 2f 74 64 Italy zone 1</td
1520: 3e 3c 2f 74 64 3e 3c 74 64 3e 57 47 53 20 38 34 ></td><td>WGS 84
1530: 3c 2f 74 64 3e 3c 74 64 3e 57 47 53 20 38 34 20 </td><td>WGS 84
1540: 2f 20 55 54 4d 20 7a 6f 6e 65 20 33 32 4e 3c 2f / UTM zone 32N</
1550: 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 td></tr>..<tr><t
1560: 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 h bgcolor="#ffb0
1570: 33 65 22 3e 49 53 4f 2d 32 30 31 38 20 57 4b 54 3e">ISO-2018 WKT
1580: 3c 2f 74 68 3e 0d 0a 3c 74 64 20 76 61 6c 69 67 </th>..<td valig
1590: 6e 3d 22 74 6f 70 22 3e 3c 76 65 72 62 61 74 69 n="top"><verbati
15a0: 6d 3e 0d 0a 50 52 4f 4a 43 52 53 5b 22 4d 6f 6e m>..PROJCRS["Mon
15b0: 74 65 20 4d 61 72 69 6f 20 2f 20 49 74 61 6c 79 te Mario / Italy
15c0: 20 7a 6f 6e 65 20 31 22 2c 0d 0a 20 20 20 20 42 zone 1",.. B
15d0: 41 53 45 47 45 4f 44 43 52 53 5b 22 4d 6f 6e 74 ASEGEODCRS["Mont
15e0: 65 20 4d 61 72 69 6f 22 2c 0d 0a 20 20 20 20 20 e Mario",..
15f0: 20 20 20 44 41 54 55 4d 5b 22 4d 6f 6e 74 65 20 DATUM["Monte
1600: 4d 61 72 69 6f 22 2c 3c 62 72 3e 0d 0a 20 20 20 Mario",<br>..
1610: 20 20 20 20 20 20 20 20 20 45 4c 4c 49 50 53 4f ELLIPSO
1620: 49 44 5b 22 49 6e 74 65 72 6e 61 74 69 6f 6e 61 ID["Internationa
1630: 6c 20 31 39 32 34 22 2c 36 33 37 38 33 38 38 2c l 1924",6378388,
1640: 32 39 37 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 297,..
1650: 20 20 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 LENGTHUNIT
1660: 5b 22 6d 65 74 72 65 22 2c 31 5d 5d 5d 2c 0d 0a ["metre",1]]],..
1670: 20 20 20 20 20 20 20 20 50 52 49 4d 45 4d 5b 22 PRIMEM["
1680: 47 72 65 65 6e 77 69 63 68 22 2c 30 2c 0d 0a 20 Greenwich",0,..
1690: 20 20 20 20 20 20 20 20 20 20 20 41 4e 47 4c 45 ANGLE
16a0: 55 4e 49 54 5b 22 64 65 67 72 65 65 22 2c 30 2e UNIT["degree",0.
16b0: 30 31 37 34 35 33 32 39 32 35 31 39 39 34 33 33 0174532925199433
16c0: 5d 5d 5d 2c 0d 0a 20 20 20 20 43 4f 4e 56 45 52 ]]],.. CONVER
16d0: 53 49 4f 4e 5b 22 49 74 61 6c 79 20 7a 6f 6e 65 SION["Italy zone
16e0: 20 31 22 2c 0d 0a 20 20 20 20 20 20 20 20 4d 45 1",.. ME
16f0: 54 48 4f 44 5b 22 54 72 61 6e 73 76 65 72 73 65 THOD["Transverse
1700: 20 4d 65 72 63 61 74 6f 72 22 2c 0d 0a 20 20 20 Mercator",..
1710: 20 20 20 20 20 20 20 20 20 49 44 5b 22 45 50 53 ID["EPS
1720: 47 22 2c 39 38 30 37 5d 5d 2c 0d 0a 20 20 20 20 G",9807]],..
1730: 20 20 20 20 50 41 52 41 4d 45 54 45 52 5b 22 4c PARAMETER["L
1740: 61 74 69 74 75 64 65 20 6f 66 20 6e 61 74 75 72 atitude of natur
1750: 61 6c 20 6f 72 69 67 69 6e 22 2c 30 2c 0d 0a 20 al origin",0,..
1760: 20 20 20 20 20 20 20 20 20 20 20 41 4e 47 4c 45 ANGLE
1770: 55 4e 49 54 5b 22 64 65 67 72 65 65 22 2c 30 2e UNIT["degree",0.
1780: 30 31 37 34 35 33 32 39 32 35 31 39 39 34 33 33 0174532925199433
1790: 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ],..
17a0: 49 44 5b 22 45 50 53 47 22 2c 38 38 30 31 5d 5d ID["EPSG",8801]]
17b0: 2c 0d 0a 20 20 20 20 20 20 20 20 50 41 52 41 4d ,.. PARAM
17c0: 45 54 45 52 5b 22 4c 6f 6e 67 69 74 75 64 65 20 ETER["Longitude
17d0: 6f 66 20 6e 61 74 75 72 61 6c 20 6f 72 69 67 69 of natural origi
17e0: 6e 22 2c 39 2c 0d 0a 20 20 20 20 20 20 20 20 20 n",9,..
17f0: 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 ANGLEUNIT["de
1800: 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 gree",0.01745329
1810: 32 35 31 39 39 34 33 33 5d 2c 0d 0a 20 20 20 20 25199433],..
1820: 20 20 20 20 20 20 20 20 49 44 5b 22 45 50 53 47 ID["EPSG
1830: 22 2c 38 38 30 32 5d 5d 2c 0d 0a 20 20 20 20 20 ",8802]],..
1840: 20 20 20 50 41 52 41 4d 45 54 45 52 5b 22 53 63 PARAMETER["Sc
1850: 61 6c 65 20 66 61 63 74 6f 72 20 61 74 20 6e 61 ale factor at na
1860: 74 75 72 61 6c 20 6f 72 69 67 69 6e 22 2c 30 2e tural origin",0.
1870: 39 39 39 36 2c 0d 0a 20 20 20 20 20 20 20 20 20 9996,..
1880: 20 20 20 53 43 41 4c 45 55 4e 49 54 5b 22 75 6e SCALEUNIT["un
1890: 69 74 79 22 2c 31 5d 2c 0d 0a 20 20 20 20 20 20 ity",1],..
18a0: 20 20 20 20 20 20 49 44 5b 22 45 50 53 47 22 2c ID["EPSG",
18b0: 38 38 30 35 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 8805]],..
18c0: 20 50 41 52 41 4d 45 54 45 52 5b 22 46 61 6c 73 PARAMETER["Fals
18d0: 65 20 65 61 73 74 69 6e 67 22 2c 31 35 30 30 30 e easting",15000
18e0: 30 30 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 00,..
18f0: 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 74 LENGTHUNIT["met
1900: 72 65 22 2c 31 5d 2c 0d 0a 20 20 20 20 20 20 20 re",1],..
1910: 20 20 20 20 20 49 44 5b 22 45 50 53 47 22 2c 38 ID["EPSG",8
1920: 38 30 36 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 806]],..
1930: 50 41 52 41 4d 45 54 45 52 5b 22 46 61 6c 73 65 PARAMETER["False
1940: 20 6e 6f 72 74 68 69 6e 67 22 2c 30 2c 0d 0a 20 northing",0,..
1950: 20 20 20 20 20 20 20 20 20 20 20 4c 45 4e 47 54 LENGT
1960: 48 55 4e 49 54 5b 22 6d 65 74 72 65 22 2c 31 5d HUNIT["metre",1]
1970: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 ,.. I
1980: 44 5b 22 45 50 53 47 22 2c 38 38 30 37 5d 5d 5d D["EPSG",8807]]]
1990: 2c 0d 0a 20 20 20 20 43 53 5b 43 61 72 74 65 73 ,.. CS[Cartes
19a0: 69 61 6e 2c 32 5d 2c 0d 0a 20 20 20 20 20 20 20 ian,2],..
19b0: 20 41 58 49 53 5b 22 65 61 73 74 69 6e 67 20 28 AXIS["easting (
19c0: 58 29 22 2c 65 61 73 74 2c 0d 0a 20 20 20 20 20 X)",east,..
19d0: 20 20 20 20 20 20 20 4f 52 44 45 52 5b 31 5d 2c ORDER[1],
19e0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4c 45 .. LE
19f0: 4e 47 54 48 55 4e 49 54 5b 22 6d 65 74 72 65 22 NGTHUNIT["metre"
1a00: 2c 31 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 41 ,1]],.. A
1a10: 58 49 53 5b 22 6e 6f 72 74 68 69 6e 67 20 28 59 XIS["northing (Y
1a20: 29 22 2c 6e 6f 72 74 68 2c 0d 0a 20 20 20 20 20 )",north,..
1a30: 20 20 20 20 20 20 20 4f 52 44 45 52 5b 32 5d 2c ORDER[2],
1a40: 3c 62 72 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 <br>..
1a50: 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 LENGTHUNIT["me
1a60: 74 72 65 22 2c 31 5d 5d 2c 0d 0a 20 20 20 20 41 tre",1]],.. A
1a70: 52 45 41 5b 22 49 74 61 6c 79 20 2d 20 77 65 73 REA["Italy - wes
1a80: 74 20 6f 66 20 31 32 c2 b0 45 22 5d 2c 0d 0a 20 t of 12..E"],..
1a90: 20 20 20 42 42 4f 58 5b 33 36 2e 35 33 2c 35 2e BBOX[36.53,5.
1aa0: 39 34 2c 34 37 2e 30 34 2c 31 32 5d 2c 0d 0a 20 94,47.04,12],..
1ab0: 20 20 20 49 44 5b 22 45 50 53 47 22 2c 33 30 30 ID["EPSG",300
1ac0: 33 5d 5d 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 3]]..</verbatim>
1ad0: 3c 2f 74 64 3e 0d 0a 3c 74 64 20 76 61 6c 69 67 </td>..<td valig
1ae0: 6e 3d 22 74 6f 70 22 3e 3c 76 65 72 62 61 74 69 n="top"><verbati
1af0: 6d 3e 0d 0a 47 45 4f 44 43 52 53 5b 22 57 47 53 m>..GEODCRS["WGS
1b00: 20 38 34 22 2c 0d 0a 20 20 20 20 44 41 54 55 4d 84",.. DATUM
1b10: 5b 22 57 6f 72 6c 64 20 47 65 6f 64 65 74 69 63 ["World Geodetic
1b20: 20 53 79 73 74 65 6d 20 31 39 38 34 22 2c 0d 0a System 1984",..
1b30: 20 20 20 20 20 20 20 20 45 4c 4c 49 50 53 4f 49 ELLIPSOI
1b40: 44 5b 22 57 47 53 20 38 34 22 2c 36 33 37 38 31 D["WGS 84",63781
1b50: 33 37 2c 32 39 38 2e 32 35 37 32 32 33 35 36 33 37,298.257223563
1b60: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4c ,.. L
1b70: 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 74 72 65 ENGTHUNIT["metre
1b80: 22 2c 31 5d 5d 5d 2c 0d 0a 20 20 20 20 50 52 49 ",1]]],.. PRI
1b90: 4d 45 4d 5b 22 47 72 65 65 6e 77 69 63 68 22 2c MEM["Greenwich",
1ba0: 30 2c 0d 0a 20 20 20 20 20 20 20 20 41 4e 47 4c 0,.. ANGL
1bb0: 45 55 4e 49 54 5b 22 64 65 67 72 65 65 22 2c 30 EUNIT["degree",0
1bc0: 2e 30 31 37 34 35 33 32 39 32 35 31 39 39 34 33 .017453292519943
1bd0: 33 5d 5d 2c 0d 0a 20 20 20 20 43 53 5b 65 6c 6c 3]],.. CS[ell
1be0: 69 70 73 6f 69 64 61 6c 2c 32 5d 2c 0d 0a 20 20 ipsoidal,2],..
1bf0: 20 20 20 20 20 20 41 58 49 53 5b 22 67 65 6f 64 AXIS["geod
1c00: 65 74 69 63 20 6c 61 74 69 74 75 64 65 20 28 4c etic latitude (L
1c10: 61 74 29 22 2c 6e 6f 72 74 68 2c 0d 0a 20 20 20 at)",north,..
1c20: 20 20 20 20 20 20 20 20 20 4f 52 44 45 52 5b 31 ORDER[1
1c30: 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ],..
1c40: 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 ANGLEUNIT["degre
1c50: 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 e",0.01745329251
1c60: 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20 20 20 99433]],..
1c70: 20 20 41 58 49 53 5b 22 67 65 6f 64 65 74 69 63 AXIS["geodetic
1c80: 20 6c 6f 6e 67 69 74 75 64 65 20 28 4c 6f 6e 29 longitude (Lon)
1c90: 22 2c 65 61 73 74 2c 0d 0a 20 20 20 20 20 20 20 ",east,..
1ca0: 20 20 20 20 20 4f 52 44 45 52 5b 32 5d 2c 0d 0a ORDER[2],..
1cb0: 20 20 20 20 20 20 20 20 20 20 20 20 41 4e 47 4c ANGL
1cc0: 45 55 4e 49 54 5b 22 64 65 67 72 65 65 22 2c 30 EUNIT["degree",0
1cd0: 2e 30 31 37 34 35 33 32 39 32 35 31 39 39 34 33 .017453292519943
1ce0: 33 5d 5d 2c 0d 0a 20 20 20 20 41 52 45 41 5b 22 3]],.. AREA["
1cf0: 57 6f 72 6c 64 22 5d 2c 0d 0a 20 20 20 20 42 42 World"],.. BB
1d00: 4f 58 5b 2d 39 30 2c 2d 31 38 30 2c 39 30 2c 31 OX[-90,-180,90,1
1d10: 38 30 5d 2c 0d 0a 20 20 20 20 49 44 5b 22 45 50 80],.. ID["EP
1d20: 53 47 22 2c 34 33 32 36 5d 5d 0d 0a 3c 2f 76 65 SG",4326]]..</ve
1d30: 72 62 61 74 69 6d 3e 3c 2f 74 64 3e 0d 0a 3c 74 rbatim></td>..<t
1d40: 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 3c d valign="top"><
1d50: 76 65 72 62 61 74 69 6d 3e 0d 0a 50 52 4f 4a 43 verbatim>..PROJC
1d60: 52 53 5b 22 57 47 53 20 38 34 20 2f 20 55 54 4d RS["WGS 84 / UTM
1d70: 20 7a 6f 6e 65 20 33 32 4e 22 2c 0d 0a 20 20 20 zone 32N",..
1d80: 20 42 41 53 45 47 45 4f 44 43 52 53 5b 22 57 47 BASEGEODCRS["WG
1d90: 53 20 38 34 22 2c 0d 0a 20 20 20 20 20 20 20 20 S 84",..
1da0: 44 41 54 55 4d 5b 22 57 6f 72 6c 64 20 47 65 6f DATUM["World Geo
1db0: 64 65 74 69 63 20 53 79 73 74 65 6d 20 31 39 38 detic System 198
1dc0: 34 22 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 4",..
1dd0: 20 45 4c 4c 49 50 53 4f 49 44 5b 22 57 47 53 20 ELLIPSOID["WGS
1de0: 38 34 22 2c 36 33 37 38 31 33 37 2c 32 39 38 2e 84",6378137,298.
1df0: 32 35 37 32 32 33 35 36 33 2c 0d 0a 20 20 20 20 257223563,..
1e00: 20 20 20 20 20 20 20 20 20 20 20 20 4c 45 4e 47 LENG
1e10: 54 48 55 4e 49 54 5b 22 6d 65 74 72 65 22 2c 31 THUNIT["metre",1
1e20: 5d 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 52 ]]],.. PR
1e30: 49 4d 45 4d 5b 22 47 72 65 65 6e 77 69 63 68 22 IMEM["Greenwich"
1e40: 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ,0,..
1e50: 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 ANGLEUNIT["degr
1e60: 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 ee",0.0174532925
1e70: 31 39 39 34 33 33 5d 5d 5d 2c 0d 0a 20 20 20 20 199433]]],..
1e80: 43 4f 4e 56 45 52 53 49 4f 4e 5b 22 55 54 4d 20 CONVERSION["UTM
1e90: 7a 6f 6e 65 20 33 32 4e 22 2c 0d 0a 20 20 20 20 zone 32N",..
1ea0: 20 20 20 20 4d 45 54 48 4f 44 5b 22 54 72 61 6e METHOD["Tran
1eb0: 73 76 65 72 73 65 20 4d 65 72 63 61 74 6f 72 22 sverse Mercator"
1ec0: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 ,.. I
1ed0: 44 5b 22 45 50 53 47 22 2c 39 38 30 37 5d 5d 2c D["EPSG",9807]],
1ee0: 0d 0a 20 20 20 20 20 20 20 20 50 41 52 41 4d 45 .. PARAME
1ef0: 54 45 52 5b 22 4c 61 74 69 74 75 64 65 20 6f 66 TER["Latitude of
1f00: 20 6e 61 74 75 72 61 6c 20 6f 72 69 67 69 6e 22 natural origin"
1f10: 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ,0,..
1f20: 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 ANGLEUNIT["degr
1f30: 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 ee",0.0174532925
1f40: 31 39 39 34 33 33 5d 2c 0d 0a 20 20 20 20 20 20 199433],..
1f50: 20 20 20 20 20 20 49 44 5b 22 45 50 53 47 22 2c ID["EPSG",
1f60: 38 38 30 31 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 8801]],..
1f70: 20 50 41 52 41 4d 45 54 45 52 5b 22 4c 6f 6e 67 PARAMETER["Long
1f80: 69 74 75 64 65 20 6f 66 20 6e 61 74 75 72 61 6c itude of natural
1f90: 20 6f 72 69 67 69 6e 22 2c 39 2c 0d 0a 20 20 20 origin",9,..
1fa0: 20 20 20 20 20 20 20 20 20 41 4e 47 4c 45 55 4e ANGLEUN
1fb0: 49 54 5b 22 64 65 67 72 65 65 22 2c 30 2e 30 31 IT["degree",0.01
1fc0: 37 34 35 33 32 39 32 35 31 39 39 34 33 33 5d 2c 74532925199433],
1fd0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 44 .. ID
1fe0: 5b 22 45 50 53 47 22 2c 38 38 30 32 5d 5d 2c 0d ["EPSG",8802]],.
1ff0: 0a 20 20 20 20 20 20 20 20 50 41 52 41 4d 45 54 . PARAMET
2000: 45 52 5b 22 53 63 61 6c 65 20 66 61 63 74 6f 72 ER["Scale factor
2010: 20 61 74 20 6e 61 74 75 72 61 6c 20 6f 72 69 67 at natural orig
2020: 69 6e 22 2c 30 2e 39 39 39 36 2c 0d 0a 20 20 20 in",0.9996,..
2030: 20 20 20 20 20 20 20 20 20 53 43 41 4c 45 55 4e SCALEUN
2040: 49 54 5b 22 75 6e 69 74 79 22 2c 31 5d 2c 0d 0a IT["unity",1],..
2050: 20 20 20 20 20 20 20 20 20 20 20 20 49 44 5b 22 ID["
2060: 45 50 53 47 22 2c 38 38 30 35 5d 5d 2c 0d 0a 20 EPSG",8805]],..
2070: 20 20 20 20 20 20 20 50 41 52 41 4d 45 54 45 52 PARAMETER
2080: 5b 22 46 61 6c 73 65 20 65 61 73 74 69 6e 67 22 ["False easting"
2090: 2c 35 30 30 30 30 30 2c 0d 0a 20 20 20 20 20 20 ,500000,..
20a0: 20 20 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 LENGTHUNIT
20b0: 5b 22 6d 65 74 72 65 22 2c 31 5d 2c 0d 0a 20 20 ["metre",1],..
20c0: 20 20 20 20 20 20 20 20 20 20 49 44 5b 22 45 50 ID["EP
20d0: 53 47 22 2c 38 38 30 36 5d 5d 2c 0d 0a 20 20 20 SG",8806]],..
20e0: 20 20 20 20 20 50 41 52 41 4d 45 54 45 52 5b 22 PARAMETER["
20f0: 46 61 6c 73 65 20 6e 6f 72 74 68 69 6e 67 22 2c False northing",
2100: 30 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 0,..
2110: 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 74 72 LENGTHUNIT["metr
2120: 65 22 2c 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 e",1],..
2130: 20 20 20 20 49 44 5b 22 45 50 53 47 22 2c 38 38 ID["EPSG",88
2140: 30 37 5d 5d 5d 2c 0d 0a 20 20 20 20 43 53 5b 43 07]]],.. CS[C
2150: 61 72 74 65 73 69 61 6e 2c 32 5d 2c 0d 0a 20 20 artesian,2],..
2160: 20 20 20 20 20 20 41 58 49 53 5b 22 28 45 29 22 AXIS["(E)"
2170: 2c 65 61 73 74 2c 0d 0a 20 20 20 20 20 20 20 20 ,east,..
2180: 20 20 20 20 4f 52 44 45 52 5b 31 5d 2c 0d 0a 20 ORDER[1],..
2190: 20 20 20 20 20 20 20 20 20 20 20 4c 45 4e 47 54 LENGT
21a0: 48 55 4e 49 54 5b 22 6d 65 74 72 65 22 2c 31 5d HUNIT["metre",1]
21b0: 5d 2c 0d 0a 20 20 20 20 20 20 20 20 41 58 49 53 ],.. AXIS
21c0: 5b 22 28 4e 29 22 2c 6e 6f 72 74 68 2c 0d 0a 20 ["(N)",north,..
21d0: 20 20 20 20 20 20 20 20 20 20 20 4f 52 44 45 52 ORDER
21e0: 5b 32 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 [2],..
21f0: 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 LENGTHUNIT["me
2200: 74 72 65 22 2c 31 5d 5d 2c 0d 0a 20 20 20 20 41 tre",1]],.. A
2210: 52 45 41 5b 22 57 6f 72 6c 64 20 2d 20 4e 20 68 REA["World - N h
2220: 65 6d 69 73 70 68 65 72 65 20 2d 20 36 c2 b0 45 emisphere - 6..E
2230: 20 74 6f 20 31 32 c2 b0 45 20 2d 20 62 79 20 63 to 12..E - by c
2240: 6f 75 6e 74 72 79 22 5d 2c 0d 0a 20 20 20 20 42 ountry"],.. B
2250: 42 4f 58 5b 30 2c 36 2c 38 34 2c 31 32 5d 2c 0d BOX[0,6,84,12],.
2260: 0a 20 20 20 20 49 44 5b 22 45 50 53 47 22 2c 33 . ID["EPSG",3
2270: 32 36 33 32 5d 5d 0d 0a 3c 2f 76 65 72 62 61 74 2632]]..</verbat
2280: 69 6d 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d im></td>..</tr>.
2290: 0a 3c 2f 74 61 62 6c 65 3e 0d 0a 3c 62 72 3e 0d .</table>..<br>.
22a0: 0a 41 73 20 79 6f 75 20 63 61 6e 20 65 61 73 69 .As you can easi
22b0: 6c 79 20 6e 6f 74 69 63 65 2c 20 74 68 65 20 74 ly notice, the t
22c0: 77 6f 20 6e 6f 74 61 74 69 6f 6e 73 20 61 72 65 wo notations are
22d0: 20 70 72 6f 66 6f 75 6e 64 6c 79 20 64 69 66 66 profoundly diff
22e0: 65 72 65 6e 74 2e 0d 0a 54 68 65 20 6f 6c 64 20 erent...The old
22f0: 3c 62 3e 70 72 6f 6a 2d 73 74 72 69 6e 67 3c 2f <b>proj-string</
2300: 62 3e 20 6e 6f 74 61 74 69 6f 6e 20 69 73 20 65 b> notation is e
2310: 78 74 72 65 6d 65 6c 79 20 63 6f 6e 63 69 73 65 xtremely concise
2320: 20 61 6e 64 20 72 6f 75 67 68 2c 20 77 68 69 6c and rough, whil
2330: 73 74 20 74 68 65 20 6e 65 77 20 3c 62 3e 49 53 st the new <b>IS
2340: 4f 2d 57 4b 54 3c 2f 62 3e 20 69 73 20 76 65 72 O-WKT</b> is ver
2350: 62 6f 73 65 20 62 75 74 20 65 78 68 61 75 73 74 bose but exhaust
2360: 69 76 65 2c 20 64 65 74 61 69 6c 65 64 20 61 6e ive, detailed an
2370: 64 20 70 72 65 63 69 73 65 2e 3c 62 72 3e 0d 0a d precise.<br>..
2380: 54 68 65 72 65 20 69 73 20 6e 6f 20 70 6f 73 73 There is no poss
2390: 69 62 6c 65 20 6d 61 74 63 68 3a 20 49 53 4f 2d ible match: ISO-
23a0: 57 4b 54 20 69 73 20 63 6c 65 61 72 6c 79 20 73 WKT is clearly s
23b0: 75 70 65 72 69 6f 72 20 61 6e 64 20 6d 6f 72 65 uperior and more
23c0: 20 73 6f 70 68 69 73 74 69 63 61 74 65 64 20 75 sophisticated u
23d0: 6e 64 65 72 20 61 6e 79 20 70 6f 73 73 69 62 6c nder any possibl
23e0: 65 20 61 73 70 65 63 74 2e 3c 62 72 3e 0d 0a 4e e aspect.<br>..N
23f0: 6f 74 20 61 74 20 61 6c 6c 20 73 75 72 70 72 69 ot at all surpri
2400: 73 69 6e 67 6c 79 2c 20 63 6f 6f 72 64 69 6e 61 singly, coordina
2410: 74 65 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f te transformatio
2420: 6e 73 20 62 61 73 65 64 20 6f 6e 20 49 53 4f 2d ns based on ISO-
2430: 57 4b 54 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 WKT definitions
2440: 28 69 6e 73 74 65 61 64 20 6f 66 20 70 72 6f 6a (instead of proj
2450: 2d 73 74 72 69 6e 67 73 29 20 61 72 65 20 75 73 -strings) are us
2460: 75 61 6c 6c 79 20 65 78 70 65 63 74 65 64 20 74 ually expected t
2470: 6f 20 62 65 20 6d 6f 72 65 20 61 63 63 75 72 61 o be more accura
2480: 74 65 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 41 6e 64 te.<br><br>..And
2490: 20 74 68 61 74 27 73 20 6e 6f 74 20 61 6c 6c 3b that's not all;
24a0: 20 74 68 65 20 6f 6c 64 20 3c 62 3e 70 72 6f 6a the old <b>proj
24b0: 2d 73 74 72 69 6e 67 73 3c 2f 62 3e 20 77 65 72 -strings</b> wer
24c0: 65 6e 27 74 20 66 6f 72 6d 61 6c 6c 79 20 64 65 en't formally de
24d0: 66 69 6e 65 64 20 62 79 20 61 6e 79 20 73 74 61 fined by any sta
24e0: 6e 64 61 72 64 2c 20 61 6e 64 20 6f 6e 6c 79 20 ndard, and only
24f0: 50 52 4f 4a 2c 20 47 44 41 4c 20 61 6e 64 20 66 PROJ, GDAL and f
2500: 65 77 20 6f 74 68 65 72 20 46 4c 4f 53 53 20 2f ew other FLOSS /
2510: 20 47 46 4f 53 53 20 69 6d 70 6c 65 6d 65 6e 74 GFOSS implement
2520: 61 74 69 6f 6e 73 20 63 61 6e 20 75 6e 64 65 72 ations can under
2530: 73 74 61 6e 64 20 74 68 65 6d 2e 3c 62 72 3e 0d stand them.<br>.
2540: 0a 41 74 20 74 68 65 20 6f 70 70 6f 73 69 74 65 .At the opposite
2550: 2c 20 74 68 65 20 6e 65 77 20 3c 62 3e 49 53 4f , the new <b>ISO
2560: 2d 57 4b 54 3c 2f 62 3e 20 69 73 20 66 6f 72 6d -WKT</b> is form
2570: 61 6c 6c 79 20 64 65 66 69 6e 65 64 20 62 79 20 ally defined by
2580: 61 6e 20 69 6e 74 65 72 6e 61 74 69 6f 6e 61 6c an international
2590: 20 73 74 61 6e 64 61 72 64 2c 20 61 6e 64 20 6d standard, and m
25a0: 61 6e 79 20 66 72 65 65 20 61 6e 64 20 70 72 6f any free and pro
25b0: 70 72 69 65 74 61 72 79 20 69 6d 70 6c 65 6d 65 prietary impleme
25c0: 6e 74 61 74 69 6f 6e 73 20 63 61 6e 20 75 6e 64 ntations can und
25d0: 65 72 73 74 61 6e 64 20 69 74 2e 3c 62 72 3e 3c erstand it.<br><
25e0: 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c br>..<table cell
25f0: 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c spacing="8" cell
2600: 70 61 64 64 69 6e 67 3d 22 31 36 22 20 62 67 63 padding="16" bgc
2610: 6f 6c 6f 72 3d 22 23 66 66 66 66 65 39 22 3e 0d olor="#ffffe9">.
2620: 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 62 3e 3c 75 .<tr><td>..<b><u
2630: 3e 49 6d 70 6f 72 74 61 6e 74 20 6e 6f 74 69 63 >Important notic
2640: 65 3c 2f 75 3e 3c 2f 62 3e 3a 20 74 68 65 72 65 e</u></b>: there
2650: 20 61 72 65 20 73 65 76 65 72 61 6c 20 64 69 61 are several dia
2660: 6c 65 63 74 73 20 69 6e 20 74 68 65 20 57 4b 54 lects in the WKT
2670: 20 6e 6f 74 61 74 69 6f 6e 20 64 65 73 63 72 69 notation descri
2680: 62 69 6e 67 20 43 52 53 65 73 2e 3c 62 72 3e 0d bing CRSes.<br>.
2690: 0a 41 6c 6c 20 74 68 65 6d 20 73 68 61 72 65 20 .All them share
26a0: 74 68 65 20 73 61 6d 65 20 63 6f 6d 6d 6f 6e 20 the same common
26b0: 63 6f 72 65 20 61 6e 64 20 6d 61 69 6e 6c 79 20 core and mainly
26c0: 64 69 66 66 65 72 20 69 6e 20 66 65 77 20 6d 69 differ in few mi
26d0: 6e 6f 72 20 64 65 74 61 69 6c 73 2e 3c 62 72 3e nor details.<br>
26e0: 0d 0a 50 52 4f 4a 2e 36 20 63 61 6e 20 75 6e 64 ..PROJ.6 can und
26f0: 65 72 73 74 61 6e 64 20 74 68 65 20 66 6f 6c 6c erstand the foll
2700: 6f 77 69 6e 67 20 64 69 61 6c 65 63 74 73 3a 0d owing dialects:.
2710: 0a 3c 6f 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 45 53 .<ol>..<li><b>ES
2720: 52 49 20 57 4b 54 3c 2f 62 3e 3a 20 61 20 64 69 RI WKT</b>: a di
2730: 61 6c 65 63 74 20 77 69 64 65 6c 79 20 61 64 6f alect widely ado
2740: 70 74 65 64 20 62 79 20 45 53 52 49 20 70 72 6f pted by ESRI pro
2750: 70 72 69 65 74 61 72 79 20 73 6f 66 74 77 61 72 prietary softwar
2760: 65 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e e.</li>..<li><b>
2770: 47 44 41 4c 20 57 4b 54 31 3c 2f 62 3e 3a 20 61 GDAL WKT1</b>: a
2780: 20 64 69 61 6c 65 63 74 20 68 69 73 74 6f 72 69 dialect histori
2790: 63 61 6c 6c 79 20 73 75 70 70 6f 72 74 65 64 20 cally supported
27a0: 62 79 20 74 68 65 20 6f 70 65 6e 20 73 6f 75 72 by the open sour
27b0: 63 65 20 47 44 41 4c 20 6c 69 62 72 61 72 79 2e ce GDAL library.
27c0: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 57 4b </li>..<li><b>WK
27d0: 54 32 3a 32 30 31 35 3c 2f 62 3e 3a 20 61 73 20 T2:2015</b>: as
27e0: 64 65 66 69 6e 65 64 20 62 79 20 3c 62 3e 49 53 defined by <b>IS
27f0: 4f 20 31 39 31 36 32 3a 32 30 31 35 3c 2f 62 3e O 19162:2015</b>
2800: 20 73 74 61 6e 64 61 72 64 20 73 70 65 63 69 66 standard specif
2810: 69 63 61 74 69 6f 6e 73 2e 3c 2f 6c 69 3e 0d 0a ications.</li>..
2820: 3c 6c 69 3e 3c 62 3e 57 4b 54 32 3a 32 30 31 38 <li><b>WKT2:2018
2830: 3c 2f 62 3e 3a 20 61 73 20 64 65 66 69 6e 65 64 </b>: as defined
2840: 20 62 79 20 3c 62 3e 49 53 4f 20 31 39 31 36 32 by <b>ISO 19162
2850: 3a 32 30 31 38 3c 2f 62 3e 20 73 74 61 6e 64 61 :2018</b> standa
2860: 72 64 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e rd specification
2870: 73 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 6f 6c 3e 0d 0a s.</li>..</ol>..
2880: 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 </td></tr>..</ta
2890: 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 68 33 3e 54 72 ble><br>..<h3>Tr
28a0: 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 ansformation pip
28b0: 65 6c 69 6e 65 73 3c 2f 68 33 3e 0d 0a 54 68 65 elines</h3>..The
28c0: 72 65 20 69 73 20 61 20 73 65 63 6f 6e 64 20 61 re is a second a
28d0: 73 74 6f 6e 69 73 68 69 6e 67 20 69 6d 70 72 6f stonishing impro
28e0: 76 65 6d 65 6e 74 20 73 75 70 70 6f 72 74 65 64 vement supported
28f0: 20 62 79 20 50 52 4f 4a 2e 36 2c 20 74 68 61 74 by PROJ.6, that
2900: 20 61 72 65 20 3c 62 3e 3c 69 3e 74 72 61 6e 73 are <b><i>trans
2910: 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 6c 69 formation pipeli
2920: 6e 65 73 3c 2f 69 3e 3c 2f 62 3e 2e 3c 62 72 3e nes</i></b>.<br>
2930: 0d 0a 57 68 65 6e 20 75 73 69 6e 67 20 61 20 3c ..When using a <
2940: 62 3e 3c 69 3e 70 69 70 65 6c 69 6e 65 3c 2f 69 b><i>pipeline</i
2950: 3e 3c 2f 62 3e 20 79 6f 75 20 63 61 6e 20 66 72 ></b> you can fr
2960: 65 65 6c 79 20 64 65 66 69 6e 65 20 61 6e 79 20 eely define any
2970: 63 6f 6d 70 6c 65 78 20 67 65 6f 64 65 74 69 63 complex geodetic
2980: 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 transformation
2990: 62 79 20 63 68 61 69 6e 69 6e 67 20 74 6f 67 65 by chaining toge
29a0: 74 68 65 72 20 6d 61 6e 79 20 65 6c 65 6d 65 6e ther many elemen
29b0: 74 61 72 79 20 73 74 65 70 73 20 73 75 63 68 20 tary steps such
29c0: 61 73 20 63 6f 6e 76 65 72 73 69 6f 6e 2c 20 74 as conversion, t
29d0: 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 2c 20 70 ransformation, p
29e0: 72 6f 6a 65 63 74 69 6f 6e 2c 20 61 78 69 73 20 rojection, axis
29f0: 73 77 61 70 20 61 6e 64 20 73 6f 20 6f 6e 2e 3c swap and so on.<
2a00: 62 72 3e 0d 0a 41 20 70 69 70 65 6c 69 6e 65 20 br>..A pipeline
2a10: 69 73 20 63 6f 6e 63 65 70 74 75 61 6c 6c 79 20 is conceptually
2a20: 73 69 6d 69 6c 61 72 20 74 6f 20 61 20 55 4e 49 similar to a UNI
2a30: 58 20 73 68 65 6c 6c 20 73 63 72 69 70 74 2c 20 X shell script,
2a40: 77 69 74 68 20 61 20 64 61 74 61 66 6c 6f 77 20 with a dataflow
2a50: 72 65 67 75 6c 61 72 6c 79 20 70 72 6f 63 65 64 regularly proced
2a60: 69 6e 67 20 66 6f 72 77 61 72 64 20 66 72 6f 6d ing forward from
2a70: 20 73 74 65 70 20 74 6f 20 73 74 65 70 20 75 6e step to step un
2a80: 74 69 6c 20 70 72 6f 64 75 63 69 6e 67 20 74 68 til producing th
2a90: 65 20 66 69 6e 61 6c 20 72 65 73 75 6c 74 2e 3c e final result.<
2aa0: 62 72 3e 0d 0a 54 68 65 20 66 6f 6c 6c 6f 77 69 br>..The followi
2ab0: 6e 67 20 69 73 20 61 20 70 72 61 63 74 69 61 6c ng is a practial
2ac0: 20 65 78 61 6d 70 6c 65 20 6f 66 20 61 20 70 69 example of a pi
2ad0: 70 65 6c 69 6e 65 20 63 6f 72 72 65 73 70 6f 6e peline correspon
2ae0: 64 69 6e 67 20 74 6f 20 61 20 74 72 61 6e 73 66 ding to a transf
2af0: 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 3c 62 ormation from <b
2b00: 3e 45 50 53 47 3a 34 33 32 36 3c 2f 62 3e 20 3c >EPSG:4326</b> <
2b10: 69 3e 57 47 53 20 38 34 3c 2f 69 3e 20 74 6f 20 i>WGS 84</i> to
2b20: 3c 62 3e 45 50 53 47 3a 33 32 36 33 32 3c 2f 62 <b>EPSG:32632</b
2b30: 3e 20 3c 69 3e 57 47 53 20 38 34 20 2f 20 55 54 > <i>WGS 84 / UT
2b40: 4d 20 7a 6f 6e 65 20 33 32 4e 3c 2f 69 3e 3a 0d M zone 32N</i>:.
2b50: 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 2b 70 72 .<verbatim>..+pr
2b60: 6f 6a 3d 70 69 70 65 6c 69 6e 65 20 0d 0a 2b 73 oj=pipeline ..+s
2b70: 74 65 70 20 2b 70 72 6f 6a 3d 61 78 69 73 73 77 tep +proj=axissw
2b80: 61 70 20 2b 6f 72 64 65 72 3d 32 2c 31 20 0d 0a ap +order=2,1 ..
2b90: 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 75 6e 69 74 +step +proj=unit
2ba0: 63 6f 6e 76 65 72 74 20 2b 78 79 5f 69 6e 3d 64 convert +xy_in=d
2bb0: 65 67 20 2b 78 79 5f 6f 75 74 3d 72 61 64 20 0d eg +xy_out=rad .
2bc0: 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 75 74 6d .+step +proj=utm
2bd0: 20 2b 7a 6f 6e 65 3d 33 32 20 2b 65 6c 6c 70 73 +zone=32 +ellps
2be0: 3d 57 47 53 38 34 0d 0a 3c 2f 76 65 72 62 61 74 =WGS84..</verbat
2bf0: 69 6d 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c im>..<table cell
2c00: 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c spacing="8" cell
2c10: 70 61 64 64 69 6e 67 3d 22 31 36 22 20 62 67 63 padding="16" bgc
2c20: 6f 6c 6f 72 3d 22 23 66 66 66 66 64 30 22 3e 0d olor="#ffffd0">.
2c30: 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 62 3e 3c 75 .<tr><td>..<b><u
2c40: 3e 55 73 65 66 75 6c 20 68 69 6e 74 3c 2f 75 3e >Useful hint</u>
2c50: 3c 2f 62 3e 3a 20 50 52 4f 4a 2e 36 20 73 75 70 </b>: PROJ.6 sup
2c60: 70 6f 72 74 73 20 61 20 6e 65 77 20 43 4c 49 20 ports a new CLI
2c70: 74 6f 6f 6c 20 28 3c 62 3e 70 72 6f 6a 69 6e 66 tool (<b>projinf
2c80: 6f 3c 2f 62 3e 29 20 66 6f 72 20 69 6e 73 70 65 o</b>) for inspe
2c90: 63 74 69 6e 67 20 69 6e 20 66 75 6c 6c 20 64 65 cting in full de
2ca0: 74 61 69 6c 20 74 68 65 20 69 6e 74 65 72 6e 61 tail the interna
2cb0: 6c 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 6f 66 l definitions of
2cc0: 20 43 52 53 65 73 2c 20 54 72 61 6e 73 66 6f 72 CRSes, Transfor
2cd0: 6d 61 74 69 6f 6e 73 20 65 74 63 2e 3c 62 72 3e mations etc.<br>
2ce0: 0d 0a 54 68 65 20 61 62 6f 76 65 20 70 69 70 65 ..The above pipe
2cf0: 6c 69 6e 65 20 69 73 20 73 69 6d 70 6c 79 20 74 line is simply t
2d00: 68 65 20 6f 75 74 70 75 74 20 6f 66 20 74 68 65 he output of the
2d10: 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d 6d 61 following comma
2d20: 6e 64 3a 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d nd:..<verbatim>.
2d30: 0a 70 72 6f 6a 69 6e 66 6f 20 2d 73 20 45 50 53 .projinfo -s EPS
2d40: 47 3a 34 33 32 36 20 2d 74 20 45 50 53 47 3a 33 G:4326 -t EPSG:3
2d50: 32 36 33 32 20 2d 6f 20 70 72 6f 6a 0d 0a 3c 2f 2632 -o proj..</
2d60: 76 65 72 62 61 74 69 6d 3e 0d 0a 3c 62 3e 70 72 verbatim>..<b>pr
2d70: 6f 6a 69 6e 66 6f 3c 2f 62 3e 20 69 73 20 61 20 ojinfo</b> is a
2d80: 76 65 72 79 20 70 72 65 63 69 6f 75 73 20 72 65 very precious re
2d90: 73 6f 75 72 63 65 3b 20 64 6f 6e 27 74 20 65 73 source; don't es
2da0: 69 74 61 74 65 20 74 6f 20 66 72 65 71 75 65 6e itate to frequen
2db0: 74 6c 79 20 75 73 65 20 69 74 20 69 6e 20 6f 72 tly use it in or
2dc0: 64 65 72 20 74 6f 20 64 69 73 63 6f 76 65 72 20 der to discover
2dd0: 77 68 61 74 27 73 20 72 65 61 6c 6c 79 20 68 61 what's really ha
2de0: 70 70 65 6e 69 6e 67 20 62 65 68 69 6e 64 20 74 ppening behind t
2df0: 68 65 20 73 63 65 6e 65 73 2e 3c 62 72 3e 0d 0a he scenes.<br>..
2e00: 49 74 27 73 20 74 68 65 20 62 65 73 74 20 61 6e It's the best an
2e10: 64 20 65 61 73 69 65 73 74 20 77 61 79 20 66 6f d easiest way fo
2e20: 72 20 66 75 6c 6c 79 20 75 6e 64 65 72 73 74 61 r fully understa
2e30: 6e 74 69 6e 67 20 68 6f 77 20 50 52 4f 4a 2e 36 nting how PROJ.6
2e40: 20 64 6f 20 72 65 61 6c 6c 79 20 77 6f 72 6b 73 do really works
2e50: 2e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c ...</td></tr>..<
2e60: 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 68 33 /table><br>..<h3
2e70: 3e 54 68 65 20 70 72 69 76 61 74 65 20 53 51 4c >The private SQL
2e80: 69 74 65 20 64 61 74 61 62 61 73 65 20 73 75 70 ite database sup
2e90: 70 6f 72 74 69 6e 67 20 50 52 4f 4a 2e 36 3c 2f porting PROJ.6</
2ea0: 68 33 3e 0d 0a 53 74 61 72 74 69 6e 67 20 73 69 h3>..Starting si
2eb0: 6e 63 65 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 nce <b>PROJ.6</b
2ec0: 3e 20 74 68 65 20 50 52 4f 4a 20 6c 69 62 72 61 > the PROJ libra
2ed0: 72 79 20 72 65 71 75 69 72 65 73 20 61 6e 20 65 ry requires an e
2ee0: 78 74 65 72 6e 61 6c 20 53 51 4c 69 74 65 20 64 xternal SQLite d
2ef0: 61 74 61 62 61 73 65 20 63 6f 6e 74 61 69 6e 69 atabase containi
2f00: 6e 67 20 61 6c 6c 20 64 65 66 69 6e 69 74 69 6f ng all definitio
2f10: 6e 73 20 61 62 6f 75 74 20 73 75 70 70 6f 72 74 ns about support
2f20: 65 64 20 43 52 53 65 73 2c 20 45 6c 6c 69 70 73 ed CRSes, Ellips
2f30: 6f 69 64 73 2c 20 50 72 69 6d 65 20 4d 65 72 69 oids, Prime Meri
2f40: 64 69 61 6e 73 2c 20 55 6e 69 74 73 20 6f 66 20 dians, Units of
2f50: 4d 65 61 73 75 72 65 2c 20 54 72 61 6e 73 66 6f Measure, Transfo
2f60: 72 6d 61 74 69 6f 6e 73 20 61 6e 64 20 61 6c 69 rmations and ali
2f70: 6b 65 2e 3c 62 72 3e 0d 0a 4d 61 6e 79 20 6f 66 ke.<br>..Many of
2f80: 20 74 68 65 20 6e 65 77 20 61 64 76 61 6e 63 65 the new advance
2f90: 64 20 50 52 4f 4a 27 73 20 41 50 49 20 77 69 6c d PROJ's API wil
2fa0: 6c 20 66 61 69 6c 20 69 66 20 73 75 63 68 20 64 l fail if such d
2fb0: 61 74 61 62 61 73 65 20 69 73 20 6e 6f 74 20 61 atabase is not a
2fc0: 76 61 69 6c 61 62 6c 65 20 61 74 20 72 75 6e 20 vailable at run
2fd0: 74 69 6d 65 2e 0d 0a 3c 62 72 3e 3c 62 72 3e 0d time...<br><br>.
2fe0: 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 .<table cellspac
2ff0: 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 ing="8" cellpadd
3000: 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 3d ing="8" bgcolor=
3010: 22 23 66 66 66 66 65 39 22 3e 0d 0a 3c 74 72 3e "#ffffe9">..<tr>
3020: 3c 74 68 3e 0d 0a 49 6e 20 6f 72 64 65 72 20 74 <th>..In order t
3030: 6f 20 6c 65 61 72 6e 20 6d 6f 72 65 20 61 62 6f o learn more abo
3040: 75 74 20 74 68 65 20 6d 61 6e 79 20 69 6e 74 65 ut the many inte
3050: 72 65 73 74 69 6e 67 20 63 6f 6f 6c 20 6e 65 77 resting cool new
3060: 20 66 65 61 74 75 72 65 73 20 73 75 70 70 6f 72 features suppor
3070: 74 65 64 20 62 79 20 50 52 4f 4a 2e 36 20 70 6c ted by PROJ.6 pl
3080: 65 61 73 65 20 63 6f 6e 73 75 6c 74 20 74 68 65 ease consult the
3090: 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 73 3a <a href="https:
30a0: 2f 2f 70 72 6f 6a 34 2e 6f 72 67 2f 22 3e 6f 72 //proj4.org/">or
30b0: 69 67 69 6e 61 6c 20 64 6f 63 75 6d 65 6e 74 61 iginal documenta
30c0: 74 69 6f 6e 3c 2f 61 3e 0d 0a 3c 2f 74 68 3e 3c tion</a>..</th><
30d0: 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 /tr>..</table><b
30e0: 72 3e 0d 0a 3c 68 72 3e 0d 0a 3c 68 31 3e 53 70 r>..<hr>..<h1>Sp
30f0: 61 74 69 61 4c 69 74 65 2d 35 2e 30 2e 30 20 73 atiaLite-5.0.0 s
3100: 75 70 70 6f 72 74 69 6e 67 20 50 52 4f 4a 2e 36 upporting PROJ.6
3110: 3c 2f 68 31 3e 0d 0a 3c 68 33 3e 45 78 69 73 74 </h1>..<h3>Exist
3120: 69 6e 67 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e ing SQL function
3130: 73 20 61 66 66 65 63 74 65 64 20 62 79 20 50 52 s affected by PR
3140: 4f 4a 2e 36 3c 2f 68 33 3e 0d 0a 3c 74 61 62 6c OJ.6</h3>..<tabl
3150: 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 e cellspacing="8
3160: 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 38 " cellpadding="8
3170: 22 20 62 67 63 6f 6c 6f 72 3d 22 23 65 38 66 66 " bgcolor="#e8ff
3180: 65 38 22 20 62 6f 72 64 65 72 3d 22 31 22 3e 0d e8" border="1">.
3190: 0a 3c 74 72 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 .<tr><th bgcolor
31a0: 3d 22 23 66 66 62 30 33 65 22 3e 53 51 4c 20 46 ="#ffb03e">SQL F
31b0: 75 6e 63 74 69 6f 6e 3c 2f 74 68 3e 3c 74 68 20 unction</th><th
31c0: 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 bgcolor="#ffb03e
31d0: 22 3e 45 78 74 65 6e 64 65 64 20 73 69 67 6e 61 ">Extended signa
31e0: 74 75 72 65 3c 2f 74 68 3e 3c 74 68 20 62 67 63 ture</th><th bgc
31f0: 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 3e 42 olor="#ffb03e">B
3200: 65 68 61 76 69 6f 72 20 75 6e 64 65 72 20 50 52 ehavior under PR
3210: 4f 4a 2e 36 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a OJ.6</th></tr>..
3220: 3c 74 72 3e 3c 74 64 3e 3c 62 3e 53 54 5f 54 72 <tr><td><b>ST_Tr
3230: 61 6e 73 66 6f 72 6d 28 29 3c 2f 62 3e 3c 2f 74 ansform()</b></t
3240: 64 3e 0d 0a 3c 74 64 3e 0d 0a 3c 62 3e 53 54 5f d>..<td>..<b>ST_
3250: 54 72 61 6e 73 66 6f 72 6d 3c 2f 62 3e 20 28 20 Transform</b> (
3260: 67 65 6f 6d 20 3c 69 3e 47 65 6f 6d 65 74 72 79 geom <i>Geometry
3270: 3c 2f 69 3e 20 2c 20 6e 65 77 53 72 69 64 20 3c </i> , newSrid <
3280: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 i>Integer</i> ,
3290: 61 72 65 61 20 3c 69 3e 47 65 6f 6d 65 74 72 79 area <i>Geometry
32a0: 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 47 65 6f 6d </i> ) : <i>Geom
32b0: 65 74 72 79 3c 2f 69 3e 3c 68 72 3e 0d 0a 3c 62 etry</i><hr>..<b
32c0: 3e 53 54 5f 54 72 61 6e 73 66 6f 72 6d 3c 2f 62 >ST_Transform</b
32d0: 3e 20 28 20 67 65 6f 6d 20 3c 69 3e 47 65 6f 6d > ( geom <i>Geom
32e0: 65 74 72 79 3c 2f 69 3e 20 2c 20 6e 65 77 53 72 etry</i> , newSr
32f0: 69 64 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 id <i>Integer</i
3300: 3e 20 2c 20 61 72 65 61 20 3c 69 3e 47 65 6f 6d > , area <i>Geom
3310: 65 74 72 79 3c 2f 69 3e 20 2c 20 6d 65 74 68 6f etry</i> , metho
3320: 64 20 3c 69 3e 54 65 78 74 3c 2f 69 3e 20 29 20 d <i>Text</i> )
3330: 3a 20 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 : <i>Geometry</i
3340: 3e 3c 68 72 3e 0d 0a 3c 62 3e 53 54 5f 54 72 61 ><hr>..<b>ST_Tra
3350: 6e 73 66 6f 72 6d 3c 2f 62 3e 20 28 20 67 65 6f nsform</b> ( geo
3360: 6d 20 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 m <i>Geometry</i
3370: 3e 20 2c 20 6e 65 77 53 72 69 64 20 3c 69 3e 49 > , newSrid <i>I
3380: 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 61 72 65 nteger</i> , are
3390: 61 20 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 a <i>Geometry</i
33a0: 3e 20 2c 20 6d 65 74 68 6f 64 20 3c 69 3e 54 65 > , method <i>Te
33b0: 78 74 3c 2f 69 3e 20 2c 20 70 72 6f 6a 5f 73 74 xt</i> , proj_st
33c0: 72 69 6e 67 20 3c 69 3e 54 65 78 74 3c 2f 69 3e ring <i>Text</i>
33d0: 20 29 20 3a 20 3c 69 3e 47 65 6f 6d 65 74 72 79 ) : <i>Geometry
33e0: 3c 2f 69 3e 0d 0a 3c 2f 74 64 3e 0d 0a 3c 74 64 </i>..</td>..<td
33f0: 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 >..<table cellsp
3400: 61 63 69 6e 67 3d 22 34 22 20 63 65 6c 6c 70 61 acing="4" cellpa
3410: 64 64 69 6e 67 3d 22 34 22 20 62 67 63 6f 6c 6f dding="4" bgcolo
3420: 72 3d 22 23 66 66 66 66 64 30 22 3e 0d 0a 3c 74 r="#ffffd0">..<t
3430: 72 3e 3c 74 64 3e 0d 0a 3c 62 3e 3c 75 3e 3c 69 r><td>..<b><u><i
3440: 3e 4e 6f 74 65 3c 2f 69 3e 3c 2f 75 3e 3c 2f 62 >Note</i></u></b
3450: 3e 3a 20 61 6c 6c 20 74 68 65 73 65 20 3c 62 3e >: all these <b>
3460: 3c 69 3e 65 78 74 65 6e 64 65 64 20 73 69 67 6e <i>extended sign
3470: 61 74 75 72 65 73 3c 2f 69 3e 3c 2f 62 3e 20 61 atures</i></b> a
3480: 72 65 20 73 75 70 70 6f 72 74 65 64 20 6f 6e 6c re supported onl
3490: 79 20 77 68 65 6e 20 3c 62 3e 6c 69 62 73 70 61 y when <b>libspa
34a0: 74 69 61 6c 69 74 65 2d 35 2e 30 3c 2f 62 3e 20 tialite-5.0</b>
34b0: 68 61 73 20 62 65 65 6e 20 62 75 69 6c 74 20 6f has been built o
34c0: 6e 20 74 68 65 20 74 6f 70 20 6f 66 20 3c 62 3e n the top of <b>
34d0: 50 52 4f 4a 2e 36 3c 2f 62 3e 3c 62 72 3e 0d 0a PROJ.6</b><br>..
34e0: 49 66 20 74 68 65 20 6c 69 62 72 61 72 79 20 68 If the library h
34f0: 61 73 20 62 65 65 6e 20 62 75 69 6c 74 20 69 6e as been built in
3500: 73 74 65 61 64 20 6f 6e 20 65 61 72 6c 69 65 72 stead on earlier
3510: 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 50 52 4f versions of PRO
3520: 4a 20 61 6e 79 20 61 74 74 65 6d 70 74 20 74 6f J any attempt to
3530: 20 63 61 6c 6c 20 74 68 65 73 65 20 65 78 74 65 call these exte
3540: 6e 64 65 64 20 73 69 67 6e 61 74 75 72 65 73 20 nded signatures
3550: 77 69 6c 6c 20 6a 75 73 74 20 72 65 74 75 72 6e will just return
3560: 20 61 20 3c 62 3e 3c 69 3e 77 72 6f 6e 67 20 6e a <b><i>wrong n
3570: 75 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e umber of argumen
3580: 74 73 20 74 6f 20 66 75 6e 63 74 69 6f 6e 20 53 ts to function S
3590: 54 5f 54 72 61 6e 73 66 6f 72 6d 28 29 3c 2f 69 T_Transform()</i
35a0: 3e 3c 2f 62 3e 20 65 72 72 6f 72 2e 0d 0a 3c 2f ></b> error...</
35b0: 74 64 3e 3c 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 td><tr>..</table
35c0: 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 ><br>..<table ce
35d0: 6c 6c 73 70 61 63 69 6e 67 3d 22 34 22 20 63 65 llspacing="4" ce
35e0: 6c 6c 70 61 64 64 69 6e 67 3d 22 34 22 20 62 67 llpadding="4" bg
35f0: 63 6f 6c 6f 72 3d 22 23 66 66 64 66 64 30 22 3e color="#ffdfd0">
3600: 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 41 6e 79 20 ..<tr><td>..Any
3610: 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 invalid argument
3620: 20 70 61 73 73 65 64 20 74 6f 20 3c 62 3e 53 54 passed to <b>ST
3630: 5f 54 72 61 6e 73 66 6f 72 6d 28 29 3c 2f 62 3e _Transform()</b>
3640: 20 28 3c 62 3e 3c 69 3e 65 78 74 65 6e 64 65 64 (<b><i>extended
3650: 20 73 69 67 6e 61 74 75 72 65 73 3c 2f 69 3e 3c signatures</i><
3660: 2f 62 3e 29 20 77 69 6c 6c 20 72 61 69 73 65 20 /b>) will raise
3670: 61 6e 20 3c 62 3e 53 51 4c 20 45 78 63 65 70 74 an <b>SQL Except
3680: 69 6f 6e 3c 2f 62 3e 2e 0d 0a 3c 2f 74 64 3e 3c ion</b>...</td><
3690: 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 tr>..</table><br
36a0: 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 74 68 65 >..<ul>..<li>the
36b0: 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 optional argume
36c0: 6e 74 20 3c 62 3e 61 72 65 61 3c 2f 62 3e 20 6d nt <b>area</b> m
36d0: 61 79 20 62 65 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 ay be <b>NULL</b
36e0: 3e 20 28 3c 69 3e 64 65 66 61 75 6c 74 20 73 65 > (<i>default se
36f0: 74 74 69 6e 67 3c 2f 69 3e 29 2e 3c 62 72 3e 0d tting</i>).<br>.
3700: 0a 4f 74 68 65 72 77 69 73 65 20 69 74 27 73 20 .Otherwise it's
3710: 65 78 70 65 63 74 65 64 20 74 6f 20 63 6f 6e 74 expected to cont
3720: 61 69 6e 20 61 20 76 61 6c 69 64 20 47 65 6f 6d ain a valid Geom
3730: 65 74 72 79 20 69 6e 20 3c 62 3e 53 52 49 44 3d etry in <b>SRID=
3740: 34 33 32 36 20 28 6c 6f 6e 67 2f 6c 61 74 29 3c 4326 (long/lat)<
3750: 2f 62 3e 2e 0d 0a 57 68 65 6e 20 61 6e 20 3c 62 /b>...When an <b
3760: 3e 3c 69 3e 61 72 65 61 20 6f 66 20 75 73 65 3c ><i>area of use<
3770: 2f 69 3e 3c 2f 62 3e 20 69 73 20 65 78 70 6c 69 /i></b> is expli
3780: 63 69 74 6c 79 20 73 75 70 70 6c 69 65 64 2c 20 citly supplied,
3790: 74 68 65 6e 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f then <b>PROJ.6</
37a0: 62 3e 20 6d 61 79 20 65 76 65 6e 74 75 61 6c 6c b> may eventuall
37b0: 79 20 75 73 65 20 74 68 65 20 63 6f 72 72 65 73 y use the corres
37c0: 70 6f 6e 64 69 6e 67 20 3c 62 3e 42 42 4f 58 3c ponding <b>BBOX<
37d0: 2f 62 3e 20 66 6f 72 20 66 69 6e 65 6c 79 20 74 /b> for finely t
37e0: 75 6e 69 6e 67 20 74 68 65 20 6d 6f 72 65 20 61 uning the more a
37f0: 63 63 75 72 61 74 65 20 74 72 61 6e 73 66 6f 72 ccurate transfor
3800: 6d 61 74 69 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c mation.</li>..<l
3810: 69 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 i>the optional a
3820: 72 67 75 6d 65 6e 74 20 3c 62 3e 6d 65 74 68 6f rgument <b>metho
3830: 64 3c 2f 62 3e 20 69 73 20 65 78 70 65 63 74 65 d</b> is expecte
3840: 64 20 74 6f 20 63 6f 6e 74 61 69 6e 20 6f 6e 65 d to contain one
3850: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 the following v
3860: 61 6c 75 65 73 20 28 3c 62 3e 61 75 74 68 5f 6e alues (<b>auth_n
3870: 61 6d 65 3a 61 75 74 68 5f 73 74 72 69 64 3c 2f ame:auth_strid</
3880: 62 3e 20 77 69 6c 6c 20 62 65 20 61 6c 77 61 79 b> will be alway
3890: 73 20 61 73 73 75 6d 65 64 20 61 73 20 74 68 65 s assumed as the
38a0: 20 3c 69 3e 64 65 66 61 75 6c 74 20 73 65 74 74 <i>default sett
38b0: 69 6e 67 3c 2f 69 3e 29 3a 3c 2f 6c 69 3e 0d 0a ing</i>):</li>..
38c0: 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 70 72 6f <ul>..<li><b>pro
38d0: 6a 34 74 65 78 74 3c 2f 62 3e 3a 20 62 6f 74 68 j4text</b>: both
38e0: 20 43 52 53 65 73 20 28 6f 72 69 67 69 6e 20 61 CRSes (origin a
38f0: 6e 64 20 64 65 73 74 69 6e 61 74 69 6f 6e 29 20 nd destination)
3900: 77 69 6c 6c 20 62 65 20 64 65 66 69 6e 65 64 20 will be defined
3910: 62 79 20 70 61 73 73 69 6e 67 20 74 6f 20 50 52 by passing to PR
3920: 4f 4a 2e 36 20 74 68 65 20 74 72 61 64 69 74 69 OJ.6 the traditi
3930: 6f 6e 61 6c 73 20 3c 62 3e 70 72 6f 6a 2d 73 74 onals <b>proj-st
3940: 72 69 6e 67 3c 2f 62 3e 20 64 65 66 69 6e 69 74 ring</b> definit
3950: 69 6f 6e 73 20 66 6f 72 20 74 68 65 20 63 6f 72 ions for the cor
3960: 72 65 73 70 6f 6e 64 69 6e 67 20 53 52 49 44 73 responding SRIDs
3970: 20 72 65 74 72 69 65 76 65 64 20 66 72 6f 6d 20 retrieved from
3980: 63 6f 6c 75 6d 6e 20 3c 62 3e 70 72 6f 6a 34 74 column <b>proj4t
3990: 65 78 74 3c 2f 62 3e 20 69 6e 20 54 61 62 6c 65 ext</b> in Table
39a0: 20 3c 62 3e 73 70 61 74 69 61 6c 5f 72 65 66 5f <b>spatial_ref_
39b0: 73 79 73 3c 2f 62 3e 3c 62 72 3e 0d 0a 54 68 69 sys</b><br>..Thi
39c0: 73 20 65 78 61 63 74 6c 79 20 63 6f 72 72 65 73 s exactly corres
39d0: 70 6f 6e 64 73 20 74 6f 20 74 68 65 20 77 65 6c ponds to the wel
39e0: 6c 20 65 78 74 61 62 6c 69 73 68 65 64 20 74 72 l extablished tr
39f0: 61 64 69 74 69 6f 6e 61 6c 20 62 65 68 61 76 69 aditional behavi
3a00: 6f 72 20 6f 66 20 61 6c 6c 20 70 72 65 76 69 6f or of all previo
3a10: 75 73 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 3c us versions of <
3a20: 62 3e 6c 69 62 73 70 61 74 69 61 6c 69 74 65 3c b>libspatialite<
3a30: 2f 62 3e 20 61 6e 64 20 73 74 69 6c 6c 20 63 6f /b> and still co
3a40: 6e 74 69 6e 75 65 73 20 74 6f 20 62 65 20 73 75 ntinues to be su
3a50: 70 70 6f 72 74 65 64 20 6d 61 69 6e 6c 79 20 66 pported mainly f
3a60: 6f 72 20 68 69 73 74 6f 72 69 63 61 6c 20 63 6f or historical co
3a70: 6d 70 61 74 69 62 69 6c 69 74 79 2c 20 62 75 74 mpatibility, but
3a80: 20 3c 62 3e 3c 75 3e 3c 69 3e 69 73 6e 27 74 20 <b><u><i>isn't
3a90: 61 6e 79 20 6c 6f 6e 67 65 72 20 74 68 65 20 62 any longer the b
3aa0: 65 73 74 20 77 61 79 20 66 6f 72 20 74 61 6b 69 est way for taki
3ab0: 6e 67 20 66 75 6c 6c 20 70 72 6f 66 69 74 20 6f ng full profit o
3ac0: 66 20 74 68 65 20 6d 6f 72 65 20 61 64 76 61 6e f the more advan
3ad0: 63 65 64 20 63 61 70 61 62 69 6c 69 74 69 65 73 ced capabilities
3ae0: 20 6f 66 20 50 52 4f 4a 2e 36 3c 2f 69 3e 3c 2f of PROJ.6</i></
3af0: 75 3e 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 u></b></li>..<li
3b00: 3e 3c 62 3e 73 72 74 65 78 74 3c 2f 62 3e 3a 20 ><b>srtext</b>:
3b10: 62 6f 74 68 20 43 52 53 65 73 20 28 6f 72 69 67 both CRSes (orig
3b20: 69 6e 20 61 6e 64 20 64 65 73 74 69 6e 61 74 69 in and destinati
3b30: 6f 6e 29 20 77 69 6c 6c 20 62 65 20 64 65 66 69 on) will be defi
3b40: 6e 65 64 20 62 79 20 70 61 73 73 69 6e 67 20 74 ned by passing t
3b50: 6f 20 50 52 4f 4a 2e 36 20 74 68 65 20 3c 62 3e o PROJ.6 the <b>
3b60: 57 4b 54 3c 2f 62 3e 20 64 65 66 69 6e 69 74 69 WKT</b> definiti
3b70: 6f 6e 73 20 66 6f 72 20 74 68 65 20 63 6f 72 72 ons for the corr
3b80: 65 73 70 6f 6e 64 69 6e 67 20 53 52 49 44 73 20 esponding SRIDs
3b90: 72 65 74 72 69 65 76 65 64 20 66 72 6f 6d 20 63 retrieved from c
3ba0: 6f 6c 75 6d 6e 20 3c 62 3e 73 72 74 65 78 74 3c olumn <b>srtext<
3bb0: 2f 62 3e 20 69 6e 20 54 61 62 6c 65 20 3c 62 3e /b> in Table <b>
3bc0: 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 3c spatial_ref_sys<
3bd0: 2f 62 3e 3c 62 72 3e 0d 0a 3c 62 3e 3c 75 3e 3c /b><br>..<b><u><
3be0: 69 3e 4e 6f 74 65 3c 2f 69 3e 3c 2f 75 3e 3c 2f i>Note</i></u></
3bf0: 62 3e 3a 20 74 68 69 73 20 6d 65 74 68 6f 64 20 b>: this method
3c00: 63 6f 75 6c 64 20 65 66 66 65 63 74 69 76 65 6c could effectivel
3c10: 79 20 74 61 6b 65 20 66 75 6c 6c 20 70 72 6f 66 y take full prof
3c20: 69 74 20 6f 66 20 74 68 65 20 6d 6f 72 65 20 61 it of the more a
3c30: 64 76 61 6e 63 65 64 20 63 61 70 61 62 69 6c 69 dvanced capabili
3c40: 74 69 65 73 20 6f 66 20 50 52 4f 4a 2e 36 2c 20 ties of PROJ.6,
3c50: 62 75 74 20 6f 6e 6c 79 20 69 66 20 74 68 65 20 but only if the
3c60: 75 6e 64 65 72 6c 61 79 69 6e 67 20 53 70 61 74 underlaying Spat
3c70: 69 61 4c 69 74 65 20 64 61 74 61 62 61 73 65 20 iaLite database
3c80: 68 61 73 20 62 65 65 6e 20 63 72 65 61 74 65 64 has been created
3c90: 20 77 69 74 68 20 50 52 4f 4a 2e 36 20 73 75 70 with PROJ.6 sup
3ca0: 70 6f 72 74 2e 0d 0a 42 75 74 20 69 74 20 63 6f port...But it co
3cb0: 75 6c 64 20 65 61 73 69 6c 79 20 62 65 20 69 6e uld easily be in
3cc0: 61 64 65 71 75 61 74 65 20 77 68 65 6e 20 74 68 adequate when th
3cd0: 65 20 75 6e 64 65 72 6c 61 79 69 6e 67 20 53 70 e underlaying Sp
3ce0: 61 74 69 61 4c 69 74 65 20 64 61 74 61 62 61 73 atiaLite databas
3cf0: 65 20 77 61 73 20 63 72 65 61 74 65 64 20 62 79 e was created by
3d00: 20 73 6f 6d 65 20 65 61 72 6c 69 65 72 20 76 65 some earlier ve
3d10: 72 73 69 6f 6e 20 6c 61 63 6b 69 6e 67 20 50 52 rsion lacking PR
3d20: 4f 4a 2e 36 20 73 75 70 70 6f 72 74 2e 3c 2f 6c OJ.6 support.</l
3d30: 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 61 75 74 68 5f i>..<li><b>auth_
3d40: 6e 61 6d 65 3a 61 75 74 68 5f 73 72 69 64 3c 2f name:auth_srid</
3d50: 62 3e 3a 20 62 6f 74 68 20 43 52 53 65 73 20 28 b>: both CRSes (
3d60: 6f 72 69 67 69 6e 20 61 6e 64 20 64 65 73 74 69 origin and desti
3d70: 6e 61 74 69 6f 6e 29 20 77 69 6c 6c 20 62 65 20 nation) will be
3d80: 64 65 66 69 6e 65 64 20 62 79 20 69 67 6e 6f 72 defined by ignor
3d90: 69 6e 67 20 74 68 65 20 64 65 66 69 6e 69 74 69 ing the definiti
3da0: 6f 6e 73 20 73 74 6f 72 65 64 20 69 6e 20 3c 62 ons stored in <b
3db0: 3e 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 >spatial_ref_sys
3dc0: 3c 2f 62 3e 20 61 6e 64 20 6c 65 61 76 69 6e 67 </b> and leaving
3dd0: 20 50 52 4f 4a 2e 36 20 66 72 65 65 20 74 6f 20 PROJ.6 free to
3de0: 72 65 74 72 69 65 76 65 20 74 68 65 69 72 20 63 retrieve their c
3df0: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 64 65 66 orresponding def
3e00: 69 6e 69 74 69 6f 6e 73 20 66 72 6f 6d 20 69 74 initions from it
3e10: 73 20 6f 77 6e 20 70 72 69 76 61 74 65 20 53 51 s own private SQ
3e20: 4c 69 74 65 20 64 61 74 61 62 61 73 65 2e 3c 62 Lite database.<b
3e30: 72 3e 0d 0a 3c 62 3e 3c 75 3e 3c 69 3e 4e 6f 74 r>..<b><u><i>Not
3e40: 65 3c 2f 69 3e 3c 2f 75 3e 3c 2f 62 3e 3a 20 74 e</i></u></b>: t
3e50: 68 69 73 20 6d 65 74 68 6f 64 20 77 69 6c 6c 20 his method will
3e60: 61 6c 77 61 79 73 20 74 61 6b 65 20 66 75 6c 6c always take full
3e70: 20 70 72 6f 66 69 74 20 6f 66 20 74 68 65 20 6d profit of the m
3e80: 6f 72 65 20 61 64 76 61 6e 63 65 64 20 63 61 70 ore advanced cap
3e90: 61 62 69 6c 69 74 69 65 73 20 6f 66 20 50 52 4f abilities of PRO
3ea0: 4a 2e 36 2c 20 65 76 65 6e 20 77 68 65 6e 20 75 J.6, even when u
3eb0: 73 69 6e 67 20 73 6f 6d 65 20 53 70 61 74 69 61 sing some Spatia
3ec0: 4c 69 74 65 20 64 61 74 61 62 61 73 65 20 63 72 Lite database cr
3ed0: 65 61 74 65 64 20 62 79 20 65 61 72 6c 69 65 72 eated by earlier
3ee0: 20 76 65 72 73 69 6f 6e 73 20 6e 6f 74 20 79 65 versions not ye
3ef0: 74 20 73 75 70 70 6f 72 74 69 6e 67 20 50 52 4f t supporting PRO
3f00: 4a 2e 36 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 J.6</li>..<li><b
3f10: 3e 70 72 6f 6a 5f 73 74 72 69 6e 67 3c 2f 62 3e >proj_string</b>
3f20: 3a 20 61 6e 20 3c 62 3e 3c 69 3e 75 73 65 72 2d : an <b><i>user-
3f30: 64 65 66 69 6e 65 64 20 70 72 6f 6a 2d 73 74 72 defined proj-str
3f40: 69 6e 67 3c 2f 69 3e 3c 2f 62 3e 20 28 6d 61 79 ing</i></b> (may
3f50: 20 62 65 20 6f 6e 65 20 64 65 66 69 6e 69 6e 69 be one definini
3f60: 6e 67 20 61 20 3c 62 3e 3c 69 3e 74 72 61 6e 73 ng a <b><i>trans
3f70: 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 6c 69 formation pipeli
3f80: 6e 65 3c 2f 69 3e 3c 2f 62 3e 29 20 77 69 6c 6c ne</i></b>) will
3f90: 20 62 65 20 70 61 73 73 65 64 20 74 6f 20 50 52 be passed to PR
3fa0: 4f 4a 2e 36 3b 20 74 68 69 73 20 69 73 20 61 6e OJ.6; this is an
3fb0: 20 61 64 76 61 6e 63 65 64 20 6f 70 74 69 6f 6e advanced option
3fc0: 20 72 65 73 65 72 76 65 64 20 74 6f 20 73 6b 69 reserved to ski
3fd0: 6c 6c 65 64 20 70 6f 77 65 72 20 75 73 65 72 73 lled power users
3fe0: 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c .</li>..</ul></l
3ff0: 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69 i>..<li>the opti
4000: 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62 onal argument <b
4010: 3e 70 72 6f 6a 5f 73 74 72 69 6e 67 3c 2f 62 3e >proj_string</b>
4020: 20 6d 61 79 20 62 65 20 3c 62 3e 4e 55 4c 4c 3c may be <b>NULL<
4030: 2f 62 3e 20 28 3c 69 3e 64 65 66 61 75 6c 74 20 /b> (<i>default
4040: 73 65 74 74 69 6e 67 3c 2f 69 3e 29 2e 3c 62 72 setting</i>).<br
4050: 3e 0d 0a 4f 74 68 65 72 77 69 73 65 20 69 74 27 >..Otherwise it'
4060: 73 20 65 78 70 65 63 74 65 64 20 74 6f 20 63 6f s expected to co
4070: 6e 74 61 69 6e 20 61 20 76 61 6c 69 64 20 3c 62 ntain a valid <b
4080: 3e 50 52 4f 4a 2e 36 20 3c 69 3e 74 72 61 6e 73 >PROJ.6 <i>trans
4090: 66 6f 72 6d 61 74 69 6f 6e 20 73 74 72 69 6e 67 formation string
40a0: 3c 2f 69 3e 3c 2f 62 3e 2c 20 6d 61 79 20 77 65 </i></b>, may we
40b0: 6c 6c 20 62 65 20 63 6f 72 72 65 73 70 6f 6e 64 ll be correspond
40c0: 69 6e 67 20 74 6f 20 61 6e 20 3c 62 3e 3c 69 3e ing to an <b><i>
40d0: 75 73 65 72 2d 64 65 66 69 6e 65 64 20 74 72 61 user-defined tra
40e0: 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 nsformation pipe
40f0: 6c 69 6e 65 3c 2f 69 3e 3c 2f 62 3e 2e 0d 0a 4d line</i></b>...M
4100: 65 61 6e 69 6e 67 66 75 6c 20 6f 6e 6c 79 20 69 eaningful only i
4110: 6e 20 74 68 65 20 63 61 73 65 20 6f 66 20 3c 62 n the case of <b
4120: 3e 6d 65 74 68 6f 64 3d 70 72 6f 6a 5f 73 74 72 >method=proj_str
4130: 69 6e 67 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f ing</b></li>..</
4140: 75 6c 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d ul>..</td></tr>.
4150: 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 49 6e 69 74 .<tr><td><b>Init
4160: 53 70 61 74 69 61 6c 4d 65 74 61 44 61 74 61 28 SpatialMetaData(
4170: 29 3c 2f 62 3e 3c 68 72 3e 0d 0a 3c 62 3e 49 6e )</b><hr>..<b>In
4180: 69 74 53 70 61 74 69 61 6c 4d 65 74 61 44 61 74 itSpatialMetaDat
4190: 61 46 75 6c 6c 28 29 3c 2f 62 3e 3c 68 72 3e 0d aFull()</b><hr>.
41a0: 0a 3c 62 3e 49 6e 73 65 72 74 45 70 73 67 53 52 .<b>InsertEpsgSR
41b0: 49 44 28 29 3c 2f 74 64 3e 3c 74 64 20 61 6c 69 ID()</td><td ali
41c0: 67 6e 3d 22 63 65 6e 74 65 72 22 3e 3c 62 3e 75 gn="center"><b>u
41d0: 6e 63 68 61 6e 67 65 64 3c 2f 62 3e 3c 2f 74 64 nchanged</b></td
41e0: 3e 0d 0a 3c 74 64 3e 0d 0a 41 6c 6c 20 74 68 65 >..<td>..All the
41f0: 73 65 20 53 51 4c 20 46 75 6e 63 74 69 6f 6e 73 se SQL Functions
4200: 20 64 6f 65 73 6e 27 74 20 63 68 61 6e 67 65 20 doesn't change
4210: 74 68 65 69 72 20 73 69 67 6e 61 74 75 72 65 73 their signatures
4220: 2c 20 62 75 74 20 62 65 68 61 76 65 20 69 6e 20 , but behave in
4230: 61 20 73 69 67 6e 69 66 69 63 61 6e 74 6c 79 20 a significantly
4240: 64 69 66 66 65 72 65 6e 74 20 77 61 79 20 77 68 different way wh
4250: 65 6e 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e en <b>PROJ.6</b>
4260: 20 73 75 70 70 6f 72 74 20 69 73 20 61 76 61 69 support is avai
4270: 6c 61 62 6c 65 2e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c lable...<ul>..<l
4280: 69 3e 74 72 61 64 69 74 69 6f 6e 61 6c 20 62 65 i>traditional be
4290: 68 61 76 69 6f 72 20 6f 6e 20 6f 6c 64 20 3c 62 havior on old <b
42a0: 3e 50 52 4f 4a 2e 34 3c 2f 62 3e 3a 20 74 68 65 >PROJ.4</b>: the
42b0: 20 3c 62 3e 73 70 61 74 69 61 6c 5f 72 65 66 5f <b>spatial_ref_
42c0: 73 79 73 3c 2f 62 3e 20 6d 65 74 61 64 61 74 61 sys</b> metadata
42d0: 20 54 61 62 6c 65 20 77 69 6c 6c 20 62 65 20 70 Table will be p
42e0: 6f 70 75 6c 61 74 65 64 20 62 79 20 75 73 69 6e opulated by usin
42f0: 67 20 74 68 65 20 43 52 53 65 73 20 64 65 66 69 g the CRSes defi
4300: 6e 69 74 69 6f 6e 73 20 69 6e 74 65 72 6e 61 6c nitions internal
4310: 6c 79 20 69 6e 6c 69 6e 65 64 20 77 69 74 68 69 ly inlined withi
4320: 6e 20 74 68 65 20 63 6f 64 65 20 6f 66 20 3c 62 n the code of <b
4330: 3e 6c 69 62 73 70 61 74 69 61 6c 69 74 65 3c 2f >libspatialite</
4340: 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 6e 65 b>.</li>..<li>ne
4350: 77 20 62 65 68 61 76 69 6f 72 20 6f 6e 20 3c 62 w behavior on <b
4360: 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 3a 20 74 68 65 >PROJ.6</b>: the
4370: 20 3c 62 3e 73 70 61 74 69 61 6c 5f 72 65 66 5f <b>spatial_ref_
4380: 73 79 73 3c 2f 62 3e 20 6d 65 74 61 64 61 74 61 sys</b> metadata
4390: 20 54 61 62 6c 65 20 77 69 6c 6c 20 62 65 20 70 Table will be p
43a0: 6f 70 75 6c 61 74 65 64 20 62 79 20 69 6e 73 65 opulated by inse
43b0: 72 74 69 6e 67 20 74 68 65 20 43 52 53 65 73 20 rting the CRSes
43c0: 64 65 66 69 6e 69 74 69 6f 6e 73 20 65 78 74 72 definitions extr
43d0: 61 63 74 65 64 20 66 72 6f 6d 20 74 68 65 20 53 acted from the S
43e0: 51 4c 69 74 65 20 70 72 69 76 61 74 65 20 64 61 QLite private da
43f0: 74 61 62 61 73 65 20 63 75 72 72 65 6e 74 6c 79 tabase currently
4400: 20 63 6f 6e 6e 65 63 74 65 64 20 74 6f 20 50 52 connected to PR
4410: 4f 4a 2e 36 3b 20 6d 6f 72 65 20 70 72 65 63 69 OJ.6; more preci
4420: 73 65 6c 79 2c 20 63 6f 6c 75 6d 6e 20 3c 62 3e sely, column <b>
4430: 70 72 6f 6a 34 74 65 78 74 3c 2f 62 3e 20 77 69 proj4text</b> wi
4440: 6c 6c 20 62 65 20 70 6f 70 75 6c 61 74 65 64 20 ll be populated
4450: 62 79 20 69 6e 73 65 72 74 69 6e 67 20 74 68 65 by inserting the
4460: 20 6e 65 77 20 3c 62 3e 70 72 6f 6a 2d 73 74 72 new <b>proj-str
4470: 69 6e 67 73 3c 2f 62 3e 20 61 73 20 73 75 70 70 ings</b> as supp
4480: 6f 72 74 65 64 20 62 79 20 50 52 4f 4a 2e 36 2c orted by PROJ.6,
4490: 20 77 68 69 6c 73 74 20 63 6f 6c 75 6d 6e 20 3c whilst column <
44a0: 62 3e 73 72 74 65 78 74 3c 2f 62 3e 20 77 69 6c b>srtext</b> wil
44b0: 6c 20 62 65 20 70 6f 70 75 6c 61 74 65 64 20 62 l be populated b
44c0: 79 20 69 6e 73 65 72 74 69 6e 67 20 74 68 65 20 y inserting the
44d0: 3c 62 3e 49 53 4f 2d 32 30 31 38 20 57 4b 54 3c <b>ISO-2018 WKT<
44e0: 2f 62 3e 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 /b> definitions
44f0: 61 73 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 as supported by
4500: 50 52 4f 4a 2e 36 3c 62 72 3e 0d 0a 3c 75 3e 3c PROJ.6<br>..<u><
4510: 62 3e 3c 69 3e 49 6d 70 6f 72 74 61 6e 74 20 63 b><i>Important c
4520: 6f 6e 73 65 71 75 65 6e 63 65 3c 2f 69 3e 3c 2f onsequence</i></
4530: 62 3e 3c 2f 75 3e 3a 20 69 66 20 74 68 65 72 65 b></u>: if there
4540: 20 69 73 20 6e 6f 20 64 61 74 61 62 61 73 65 20 is no database
4550: 63 75 72 72 65 6e 74 6c 79 20 63 6f 6e 6e 65 63 currently connec
4560: 74 65 64 20 74 6f 20 50 52 4f 4a 2e 36 20 74 68 ted to PROJ.6 th
4570: 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e e initialization
4580: 20 6f 66 20 3c 62 3e 73 70 61 74 69 61 6c 5f 72 of <b>spatial_r
4590: 65 66 5f 73 79 73 3c 2f 62 3e 20 77 69 6c 6c 20 ef_sys</b> will
45a0: 66 61 69 6c 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c fail.</li>..</ul
45b0: 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c >..</td></tr>..<
45c0: 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 46 65 77 /table><br>..Few
45d0: 20 70 72 61 63 74 69 63 61 6c 20 53 51 4c 20 65 practical SQL e
45e0: 78 61 6d 70 6c 65 73 3a 0d 0a 3c 76 65 72 62 61 xamples:..<verba
45f0: 74 69 6d 3e 0d 0a 2d 2d 20 74 6f 20 45 50 53 47 tim>..-- to EPSG
4600: 3a 33 30 30 33 20 2d 20 64 65 66 61 75 6c 74 20 :3003 - default
4610: 73 65 74 74 69 6e 67 73 3b 20 69 67 6e 6f 72 69 settings; ignori
4620: 6e 67 20 73 70 61 74 69 61 6c 69 74 65 5f 72 65 ng spatialite_re
4630: 66 5f 73 79 73 20 61 6e 64 20 75 73 69 6e 67 20 f_sys and using
4640: 74 68 65 20 50 52 4f 4a 2e 36 20 6f 77 6e 20 70 the PROJ.6 own p
4650: 72 69 76 61 74 65 20 64 61 74 61 62 61 73 65 0d rivate database.
4660: 0a 53 45 4c 45 43 54 20 41 73 45 57 4b 54 20 28 .SELECT AsEWKT (
4670: 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d ST_Transform( M
4680: 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 38 akePoint( 11.878
4690: 30 35 36 20 2c 20 34 33 2e 34 36 33 30 35 36 20 056 , 43.463056
46a0: 2c 20 34 33 32 36 20 29 20 2c 20 33 30 30 33 20 , 4326 ) , 3003
46b0: 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ));..-----------
46c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
46d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 ----------..SRID
46e0: 3d 33 30 30 33 3b 50 4f 49 4e 54 28 31 37 33 32 =3003;POINT(1732
46f0: 38 35 32 2e 39 34 32 37 31 36 37 36 39 20 34 38 852.942716769 48
4700: 31 36 32 37 37 2e 36 31 37 36 39 30 36 37 34 29 16277.617690674)
4710: 0d 0a 0d 0a 2d 2d 20 74 6f 20 45 50 53 47 3a 33 ....-- to EPSG:3
4720: 30 30 33 20 2d 20 4e 55 4c 4c 20 61 72 65 61 20 003 - NULL area
4730: 6f 66 20 75 73 65 2c 20 75 73 69 6e 67 20 49 53 of use, using IS
4740: 4f 2d 32 30 31 38 20 57 4b 54 20 64 65 66 69 6e O-2018 WKT defin
4750: 69 74 69 6f 6e 73 20 66 72 6f 6d 20 73 70 61 74 itions from spat
4760: 69 61 6c 5f 72 65 66 5f 73 79 73 2e 73 72 74 65 ial_ref_sys.srte
4770: 78 74 0d 0a 53 45 4c 45 43 54 20 41 73 45 57 4b xt..SELECT AsEWK
4780: 54 20 28 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d T ( ST_Transform
4790: 28 20 4d 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e ( MakePoint( 11.
47a0: 38 37 38 30 35 36 20 2c 20 34 33 2e 34 36 33 30 878056 , 43.4630
47b0: 35 36 2c 20 34 33 32 36 20 29 20 2c 20 33 30 30 56, 4326 ) , 300
47c0: 33 20 2c 20 4e 55 4c 4c 20 2c 20 27 73 72 74 65 3 , NULL , 'srte
47d0: 78 74 27 20 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d xt' ));..-------
47e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
47f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a --------------..
4800: 53 52 49 44 3d 33 30 30 33 3b 50 4f 49 4e 54 28 SRID=3003;POINT(
4810: 31 37 33 32 38 35 32 2e 39 34 32 37 31 36 37 36 1732852.94271676
4820: 39 20 34 38 31 36 32 37 37 2e 36 31 37 36 39 30 9 4816277.617690
4830: 36 37 34 29 0d 0a 0d 0a 2d 2d 20 74 6f 20 45 50 674)....-- to EP
4840: 53 47 3a 33 30 30 33 20 2d 20 4e 55 4c 4c 20 61 SG:3003 - NULL a
4850: 72 65 61 20 6f 66 20 75 73 65 2c 20 75 73 69 6e rea of use, usin
4860: 67 20 70 72 6f 6a 2d 73 74 72 69 6e 67 20 64 65 g proj-string de
4870: 66 69 6e 69 74 69 6f 6e 73 20 66 72 6f 6d 20 73 finitions from s
4880: 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 2e 70 patial_ref_sys.p
4890: 72 6f 6a 34 74 65 78 74 0d 0a 53 45 4c 45 43 54 roj4text..SELECT
48a0: 20 41 73 45 57 4b 54 20 28 20 53 54 5f 54 72 61 AsEWKT ( ST_Tra
48b0: 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 6e nsform( MakePoin
48c0: 74 28 20 31 31 2e 38 37 38 30 35 36 20 2c 20 34 t( 11.878056 , 4
48d0: 33 2e 34 36 33 30 35 36 2c 20 34 33 32 36 20 29 3.463056, 4326 )
48e0: 20 2c 20 33 30 30 33 20 2c 20 4e 55 4c 4c 20 2c , 3003 , NULL ,
48f0: 20 27 70 72 6f 6a 34 74 65 78 74 27 20 29 29 3b 'proj4text' ));
4900: 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ..--------------
4910: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4920: 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d 33 30 -------..SRID=30
4930: 30 33 3b 50 4f 49 4e 54 28 31 37 33 32 38 33 32 03;POINT(1732832
4940: 2e 34 34 34 38 39 32 33 38 20 34 38 31 36 33 35 .44489238 481635
4950: 30 2e 31 34 36 32 34 36 34 31 34 29 0d 0a 0d 0a 0.146246414)....
4960: 2d 2d 20 74 6f 20 45 50 53 47 3a 33 32 36 33 32 -- to EPSG:32632
4970: 20 2d 20 64 65 66 61 75 6c 74 20 73 65 74 74 69 - default setti
4980: 6e 67 73 3b 20 69 67 6e 6f 72 69 6e 67 20 73 70 ngs; ignoring sp
4990: 61 74 69 61 6c 69 74 65 5f 72 65 66 5f 73 79 73 atialite_ref_sys
49a0: 20 61 6e 64 20 75 73 69 6e 67 20 74 68 65 20 50 and using the P
49b0: 52 4f 4a 2e 36 20 6f 77 6e 20 70 72 69 76 61 74 ROJ.6 own privat
49c0: 65 20 64 61 74 61 62 61 73 65 0d 0a 53 45 4c 45 e database..SELE
49d0: 43 54 20 41 73 45 57 4b 54 20 28 20 53 54 5f 54 CT AsEWKT ( ST_T
49e0: 72 61 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f ransform( MakePo
49f0: 69 6e 74 28 20 31 31 2e 38 37 38 30 35 36 20 2c int( 11.878056 ,
4a00: 20 34 33 2e 34 36 33 30 35 36 20 2c 20 34 33 32 43.463056 , 432
4a10: 36 20 29 2c 20 33 32 36 33 32 20 29 29 3b 0d 0a 6 ), 32632 ));..
4a20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4a30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4a40: 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d 33 32 36 33 -----..SRID=3263
4a50: 32 3b 50 4f 49 4e 54 28 37 33 32 38 32 31 2e 37 2;POINT(732821.7
4a60: 31 38 34 37 35 31 31 32 33 20 34 38 31 36 32 36 184751123 481626
4a70: 32 2e 36 33 31 32 34 35 32 35 33 29 0d 0a 0d 0a 2.631245253)....
4a80: 2d 2d 20 74 6f 20 45 50 53 47 3a 33 32 36 33 32 -- to EPSG:32632
4a90: 20 2d 20 4e 55 4c 4c 20 61 72 65 61 20 6f 66 20 - NULL area of
4aa0: 75 73 65 2c 20 75 73 69 6e 67 20 49 53 4f 2d 32 use, using ISO-2
4ab0: 30 31 38 20 57 4b 54 20 64 65 66 69 6e 69 74 69 018 WKT definiti
4ac0: 6f 6e 73 20 66 72 6f 6d 20 73 70 61 74 69 61 6c ons from spatial
4ad0: 5f 72 65 66 5f 73 79 73 2e 73 72 74 65 78 74 0d _ref_sys.srtext.
4ae0: 0a 53 45 4c 45 43 54 20 41 73 45 57 4b 54 20 28 .SELECT AsEWKT (
4af0: 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d ST_Transform( M
4b00: 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 38 akePoint( 11.878
4b10: 30 35 36 20 2c 20 34 33 2e 34 36 33 30 35 36 20 056 , 43.463056
4b20: 2c 20 34 33 32 36 20 29 20 2c 20 33 32 36 33 32 , 4326 ) , 32632
4b30: 20 2c 20 4e 55 4c 4c 20 2c 20 27 73 72 74 65 78 , NULL , 'srtex
4b40: 74 27 20 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d t' ));..--------
4b50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4b60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 -------------..S
4b70: 52 49 44 3d 33 32 36 33 32 3b 50 4f 49 4e 54 28 RID=32632;POINT(
4b80: 37 33 32 38 32 31 2e 37 31 38 34 37 35 31 31 32 732821.718475112
4b90: 33 20 34 38 31 36 32 36 32 2e 36 33 31 32 34 35 3 4816262.631245
4ba0: 32 35 33 29 0d 0a 0d 0a 2d 2d 20 74 6f 20 45 50 253)....-- to EP
4bb0: 53 47 3a 33 32 36 33 32 20 2d 20 4e 55 4c 4c 20 SG:32632 - NULL
4bc0: 61 72 65 61 20 6f 66 20 75 73 65 2c 20 75 73 69 area of use, usi
4bd0: 6e 67 20 70 72 6f 6a 2d 73 74 72 69 6e 67 20 64 ng proj-string d
4be0: 65 66 69 6e 69 74 69 6f 6e 73 20 66 72 6f 6d 20 efinitions from
4bf0: 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 2e spatial_ref_sys.
4c00: 70 72 6f 6a 34 74 65 78 74 0d 0a 53 45 4c 45 43 proj4text..SELEC
4c10: 54 20 41 73 45 57 4b 54 20 28 20 53 54 5f 54 72 T AsEWKT ( ST_Tr
4c20: 61 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 ansform( MakePoi
4c30: 6e 74 28 20 31 31 2e 38 37 38 30 35 36 20 2c 20 nt( 11.878056 ,
4c40: 34 33 2e 34 36 33 30 35 36 2c 20 34 33 32 36 20 43.463056, 4326
4c50: 29 20 2c 20 33 32 36 33 32 20 2c 20 4e 55 4c 4c ) , 32632 , NULL
4c60: 20 2c 20 27 70 72 6f 6a 34 74 65 78 74 27 20 29 , 'proj4text' )
4c70: 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d );..------------
4c80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4c90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d ---------..SRID=
4ca0: 33 32 36 33 32 3b 50 4f 49 4e 54 28 37 33 32 38 32632;POINT(7328
4cb0: 32 31 2e 37 31 38 34 37 35 31 31 32 33 20 34 38 21.7184751123 48
4cc0: 31 36 32 36 32 2e 36 33 31 32 34 35 32 35 33 29 16262.631245253)
4cd0: 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 54 ..</verbatim>..T
4ce0: 68 69 73 20 66 69 72 73 74 20 74 65 73 74 20 69 his first test i
4cf0: 73 20 62 61 73 65 64 20 6f 6e 20 61 20 6e 65 77 s based on a new
4d00: 20 53 70 61 74 69 61 4c 69 74 65 20 64 61 74 61 SpatiaLite data
4d10: 62 61 73 65 20 63 72 65 61 74 65 64 20 77 69 74 base created wit
4d20: 68 20 66 75 6c 6c 20 50 52 4f 4a 2e 36 20 73 75 h full PROJ.6 su
4d30: 70 70 6f 72 74 2e 20 41 73 20 79 6f 75 20 63 61 pport. As you ca
4d40: 6e 20 65 61 73 69 6c 79 20 6e 6f 74 69 63 65 3a n easily notice:
4d50: 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 74 68 65 20 ..<ul>..<li>the
4d60: 6c 61 73 74 20 74 72 61 6e 73 66 6f 72 6d 61 74 last transformat
4d70: 69 6f 6e 20 66 72 6f 6d 20 53 52 49 44 3d 34 33 ion from SRID=43
4d80: 32 36 20 74 6f 20 53 52 49 44 3d 33 30 30 33 20 26 to SRID=3003
4d90: 62 61 73 65 64 20 6f 6e 20 74 72 61 64 69 74 69 based on traditi
4da0: 6f 6e 61 6c 20 3c 62 3e 70 72 6f 6a 2d 73 74 72 onal <b>proj-str
4db0: 69 6e 67 73 3c 2f 62 3e 20 72 65 74 72 69 65 76 ings</b> retriev
4dc0: 65 64 20 66 72 6f 6d 20 3c 62 3e 73 70 61 74 69 ed from <b>spati
4dd0: 61 6c 5f 72 65 66 5f 73 79 73 2e 70 72 6f 6a 34 al_ref_sys.proj4
4de0: 74 65 78 74 3c 2f 62 3e 20 72 61 74 68 65 72 20 text</b> rather
4df0: 73 75 72 70 72 69 73 69 6e 67 6c 79 20 73 69 67 surprisingly sig
4e00: 6e 69 66 69 63 61 6e 74 6c 79 20 64 69 66 66 65 nificantly diffe
4e10: 72 73 20 66 72 6f 6d 20 74 68 65 20 66 69 72 73 rs from the firs
4e20: 74 20 74 77 6f 20 72 65 73 75 6c 74 73 2e 3c 62 t two results.<b
4e30: 72 3e 0d 0a 74 68 65 72 65 20 69 73 20 61 6e 20 r>..there is an
4e40: 69 6d 70 72 65 73 73 69 76 65 20 64 69 73 74 61 impressive dista
4e50: 6e 63 65 20 6f 66 20 61 62 6f 75 74 20 3c 62 3e nce of about <b>
4e60: 37 35 6d 3c 2f 62 3e 20 62 65 74 77 65 65 6e 20 75m</b> between
4e70: 74 68 65 20 74 77 6f 20 72 65 70 72 6f 6a 65 63 the two reprojec
4e80: 74 65 64 20 70 6f 69 6e 74 73 2e 3c 2f 6c 69 3e ted points.</li>
4e90: 0d 0a 3c 6c 69 3e 62 75 74 20 61 6c 6c 20 74 72 ..<li>but all tr
4ea0: 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 73 20 66 72 ansformations fr
4eb0: 6f 6d 20 53 52 49 44 3d 34 33 32 36 20 74 6f 20 om SRID=4326 to
4ec0: 53 52 49 44 3d 33 32 36 33 32 20 72 65 74 75 72 SRID=32632 retur
4ed0: 6e 20 69 64 65 6e 74 69 63 61 6c 20 72 65 73 75 n identical resu
4ee0: 6c 74 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 lts.</li>..<li>t
4ef0: 68 69 73 20 69 73 20 61 20 64 69 72 65 63 74 20 his is a direct
4f00: 63 6f 6e 66 69 72 6d 61 74 69 6f 6e 20 74 68 61 confirmation tha
4f10: 74 20 73 74 69 6c 6c 20 63 6f 6e 74 69 6e 75 69 t still continui
4f20: 6e 67 20 74 6f 20 75 73 65 20 74 68 65 20 74 72 ng to use the tr
4f30: 61 64 69 74 69 6f 6e 61 6c 20 61 70 70 72 6f 61 aditional approa
4f40: 63 68 20 6f 66 20 74 72 61 6e 73 66 6f 72 6d 61 ch of transforma
4f50: 74 69 6f 6e 73 20 64 72 69 76 65 6e 20 62 79 20 tions driven by
4f60: 70 72 6f 6a 2d 73 74 72 69 6e 67 73 20 3c 62 3e proj-strings <b>
4f70: 3c 75 3e 3c 69 3e 64 65 66 69 6e 69 74 65 6c 79 <u><i>definitely
4f80: 20 69 73 6e 27 74 20 74 68 65 20 6f 70 74 69 6d isn't the optim
4f90: 61 6c 20 6d 65 74 68 6f 64 20 66 6f 72 20 75 73 al method for us
4fa0: 69 6e 67 20 50 52 4f 4a 2e 36 3c 2f 69 3e 3c 2f ing PROJ.6</i></
4fb0: 75 3e 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 u></b></li>..</u
4fc0: 6c 3e 3c 62 72 3e 0d 0a 3c 76 65 72 62 61 74 69 l><br>..<verbati
4fd0: 6d 3e 0d 0a 2d 2d 20 74 6f 20 45 50 53 47 3a 33 m>..-- to EPSG:3
4fe0: 30 30 33 20 2d 20 64 65 66 61 75 6c 74 20 73 65 003 - default se
4ff0: 74 74 69 6e 67 73 3b 20 69 67 6e 6f 72 69 6e 67 ttings; ignoring
5000: 20 73 70 61 74 69 61 6c 69 74 65 5f 72 65 66 5f spatialite_ref_
5010: 73 79 73 20 61 6e 64 20 75 73 69 6e 67 20 74 68 sys and using th
5020: 65 20 50 52 4f 4a 2e 36 20 6f 77 6e 20 70 72 69 e PROJ.6 own pri
5030: 76 61 74 65 20 64 61 74 61 62 61 73 65 0d 0a 53 vate database..S
5040: 45 4c 45 43 54 20 41 73 45 57 4b 54 20 28 20 53 ELECT AsEWKT ( S
5050: 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d 61 6b T_Transform( Mak
5060: 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 38 30 35 ePoint( 11.87805
5070: 36 20 2c 20 34 33 2e 34 36 33 30 35 36 20 2c 20 6 , 43.463056 ,
5080: 34 33 32 36 20 29 20 2c 20 33 30 30 33 20 29 29 4326 ) , 3003 ))
5090: 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ;..-------------
50a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
50b0: 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d 33 --------..SRID=3
50c0: 30 30 33 3b 50 4f 49 4e 54 28 31 37 33 32 38 35 003;POINT(173285
50d0: 32 2e 39 34 32 37 31 36 37 36 39 20 34 38 31 36 2.942716769 4816
50e0: 32 37 37 2e 36 31 37 36 39 30 36 37 34 29 0d 0a 277.617690674)..
50f0: 0d 0a 2d 2d 20 74 6f 20 45 50 53 47 3a 33 30 30 ..-- to EPSG:300
5100: 33 20 2d 20 4e 55 4c 4c 20 61 72 65 61 20 6f 66 3 - NULL area of
5110: 20 75 73 65 2c 20 75 73 69 6e 67 20 49 53 4f 2d use, using ISO-
5120: 32 30 31 38 20 57 4b 54 20 64 65 66 69 6e 69 74 2018 WKT definit
5130: 69 6f 6e 73 20 66 72 6f 6d 20 73 70 61 74 69 61 ions from spatia
5140: 6c 5f 72 65 66 5f 73 79 73 2e 73 72 74 65 78 74 l_ref_sys.srtext
5150: 0d 0a 53 45 4c 45 43 54 20 41 73 45 57 4b 54 20 ..SELECT AsEWKT
5160: 28 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 ( ST_Transform(
5170: 4d 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 MakePoint( 11.87
5180: 38 30 35 36 20 2c 20 34 33 2e 34 36 33 30 35 36 8056 , 43.463056
5190: 20 2c 20 34 33 32 36 20 29 20 2c 20 33 30 30 33 , 4326 ) , 3003
51a0: 20 2c 20 4e 55 4c 4c 20 2c 20 27 73 72 74 65 78 , NULL , 'srtex
51b0: 74 27 20 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d t' ));..--------
51c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
51d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 -------------..S
51e0: 52 49 44 3d 33 30 30 33 3b 50 4f 49 4e 54 28 31 RID=3003;POINT(1
51f0: 37 33 32 38 35 32 2e 39 34 32 37 31 36 37 36 39 732852.942716769
5200: 20 34 38 31 36 32 37 37 2e 36 31 37 36 39 30 36 4816277.6176906
5210: 37 34 29 0d 0a 0d 0a 2d 2d 20 74 6f 20 45 50 53 74)....-- to EPS
5220: 47 3a 33 30 30 33 20 2d 20 4e 55 4c 4c 20 61 72 G:3003 - NULL ar
5230: 65 61 20 6f 66 20 75 73 65 2c 20 75 73 69 6e 67 ea of use, using
5240: 20 70 72 6f 6a 2d 73 74 72 69 6e 67 20 64 65 66 proj-string def
5250: 69 6e 69 74 69 6f 6e 73 20 66 72 6f 6d 20 73 70 initions from sp
5260: 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 2e 70 72 atial_ref_sys.pr
5270: 6f 6a 34 74 65 78 74 0d 0a 53 45 4c 45 43 54 20 oj4text..SELECT
5280: 41 73 45 57 4b 54 20 28 20 53 54 5f 54 72 61 6e AsEWKT ( ST_Tran
5290: 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 6e 74 sform( MakePoint
52a0: 28 20 31 31 2e 38 37 38 30 35 36 20 2c 20 34 33 ( 11.878056 , 43
52b0: 2e 34 36 33 30 35 36 2c 20 34 33 32 36 20 29 20 .463056, 4326 )
52c0: 2c 20 33 30 30 33 20 2c 20 4e 55 4c 4c 20 2c 20 , 3003 , NULL ,
52d0: 27 70 72 6f 6a 34 74 65 78 74 27 20 29 29 3b 0d 'proj4text' ));.
52e0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
52f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5300: 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d 33 30 30 ------..SRID=300
5310: 33 3b 50 4f 49 4e 54 28 31 37 33 32 38 35 32 2e 3;POINT(1732852.
5320: 39 34 32 37 31 36 37 36 39 20 34 38 31 36 32 37 942716769 481627
5330: 37 2e 36 31 37 36 39 30 36 37 34 29 0d 0a 0d 0a 7.617690674)....
5340: 2d 2d 20 74 6f 20 45 50 53 47 3a 33 32 36 33 32 -- to EPSG:32632
5350: 20 2d 20 64 65 66 61 75 6c 74 20 73 65 74 74 69 - default setti
5360: 6e 67 73 3b 20 69 67 6e 6f 72 69 6e 67 20 73 70 ngs; ignoring sp
5370: 61 74 69 61 6c 69 74 65 5f 72 65 66 5f 73 79 73 atialite_ref_sys
5380: 20 61 6e 64 20 75 73 69 6e 67 20 74 68 65 20 50 and using the P
5390: 52 4f 4a 2e 36 20 6f 77 6e 20 70 72 69 76 61 74 ROJ.6 own privat
53a0: 65 20 64 61 74 61 62 61 73 65 0d 0a 53 45 4c 45 e database..SELE
53b0: 43 54 20 41 73 45 57 4b 54 20 28 20 53 54 5f 54 CT AsEWKT ( ST_T
53c0: 72 61 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f ransform( MakePo
53d0: 69 6e 74 28 20 31 31 2e 38 37 38 30 35 36 20 2c int( 11.878056 ,
53e0: 20 34 33 2e 34 36 33 30 35 36 2c 20 34 33 32 36 43.463056, 4326
53f0: 20 29 20 2c 20 33 32 36 33 32 20 29 29 3b 0d 0a ) , 32632 ));..
5400: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5410: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5420: 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d 33 32 36 33 -----..SRID=3263
5430: 32 3b 50 4f 49 4e 54 28 37 33 32 38 32 31 2e 37 2;POINT(732821.7
5440: 31 38 34 37 35 31 31 32 33 20 34 38 31 36 32 36 184751123 481626
5450: 32 2e 36 33 31 32 34 35 32 35 33 29 0d 0a 0d 0a 2.631245253)....
5460: 2d 2d 20 74 6f 20 45 50 53 47 3a 33 32 36 33 32 -- to EPSG:32632
5470: 20 2d 20 4e 55 4c 4c 20 61 72 65 61 20 6f 66 20 - NULL area of
5480: 75 73 65 2c 20 75 73 69 6e 67 20 49 53 4f 2d 32 use, using ISO-2
5490: 30 31 38 20 57 4b 54 20 64 65 66 69 6e 69 74 69 018 WKT definiti
54a0: 6f 6e 73 20 66 72 6f 6d 20 73 70 61 74 69 61 6c ons from spatial
54b0: 5f 72 65 66 5f 73 79 73 2e 73 72 74 65 78 74 0d _ref_sys.srtext.
54c0: 0a 53 45 4c 45 43 54 20 41 73 45 57 4b 54 20 28 .SELECT AsEWKT (
54d0: 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d ST_Transform( M
54e0: 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 38 akePoint( 11.878
54f0: 30 35 36 20 2c 20 34 33 2e 34 36 33 30 35 36 2c 056 , 43.463056,
5500: 20 34 33 32 36 20 29 20 2c 20 33 32 36 33 32 20 4326 ) , 32632
5510: 2c 20 4e 55 4c 4c 20 2c 20 27 73 72 74 65 78 74 , NULL , 'srtext
5520: 27 20 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d ' ));..---------
5530: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5540: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52 ------------..SR
5550: 49 44 3d 33 32 36 33 32 3b 50 4f 49 4e 54 28 37 ID=32632;POINT(7
5560: 33 32 38 32 31 2e 37 31 38 34 37 35 31 31 32 33 32821.7184751123
5570: 20 34 38 31 36 32 36 32 2e 36 33 31 32 34 35 32 4816262.6312452
5580: 35 33 29 0d 0a 0d 0a 2d 2d 20 74 6f 20 45 50 53 53)....-- to EPS
5590: 47 3a 33 32 36 33 32 20 2d 20 4e 55 4c 4c 20 61 G:32632 - NULL a
55a0: 72 65 61 20 6f 66 20 75 73 65 2c 20 75 73 69 6e rea of use, usin
55b0: 67 20 70 72 6f 6a 2d 73 74 72 69 6e 67 20 64 65 g proj-string de
55c0: 66 69 6e 69 74 69 6f 6e 73 20 66 72 6f 6d 20 73 finitions from s
55d0: 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 2e 70 patial_ref_sys.p
55e0: 72 6f 6a 34 74 65 78 74 0d 0a 53 45 4c 45 43 54 roj4text..SELECT
55f0: 20 41 73 45 57 4b 54 20 28 20 53 54 5f 54 72 61 AsEWKT ( ST_Tra
5600: 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 6e nsform( MakePoin
5610: 74 28 20 31 31 2e 38 37 38 30 35 36 20 2c 20 34 t( 11.878056 , 4
5620: 33 2e 34 36 33 30 35 36 2c 20 34 33 32 36 20 29 3.463056, 4326 )
5630: 20 2c 20 33 32 36 33 32 20 2c 20 4e 55 4c 4c 20 , 32632 , NULL
5640: 2c 20 27 70 72 6f 6a 34 74 65 78 74 27 20 29 29 , 'proj4text' ))
5650: 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ;..-------------
5660: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5670: 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d 33 --------..SRID=3
5680: 32 36 33 32 3b 50 4f 49 4e 54 28 37 33 32 38 32 2632;POINT(73282
5690: 31 2e 37 31 38 34 37 35 31 31 32 33 20 34 38 31 1.7184751123 481
56a0: 36 32 36 32 2e 36 33 31 32 34 35 32 35 33 29 0d 6262.631245253).
56b0: 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 54 68 .</verbatim>..Th
56c0: 69 73 20 73 65 63 6f 6e 64 20 74 65 73 74 20 69 is second test i
56d0: 73 20 62 61 73 65 64 20 69 6e 73 74 65 61 64 20 s based instead
56e0: 6f 6e 20 61 20 6c 65 67 61 63 79 20 53 70 61 74 on a legacy Spat
56f0: 69 61 4c 69 74 65 20 64 61 74 61 62 61 73 65 20 iaLite database
5700: 63 72 65 61 74 65 64 20 62 79 20 73 6f 6d 65 20 created by some
5710: 65 61 72 6c 69 65 72 20 76 65 72 73 69 6f 6e 20 earlier version
5720: 6c 61 63 6b 69 6e 67 20 50 52 4f 4a 2e 36 20 73 lacking PROJ.6 s
5730: 75 70 70 6f 72 74 2e 3c 62 72 3e 0d 0a 49 6e 20 upport.<br>..In
5740: 74 68 69 73 20 73 70 65 63 69 66 69 63 20 63 61 this specific ca
5750: 73 65 20 74 68 65 72 65 20 69 73 20 6e 6f 20 64 se there is no d
5760: 69 66 66 65 72 65 6e 63 65 20 69 6e 20 74 68 65 ifference in the
5770: 20 72 65 73 75 6c 74 73 20 72 65 74 75 72 6e 65 results returne
5780: 64 20 62 79 20 64 69 66 66 65 72 65 6e 74 20 6d d by different m
5790: 65 74 68 6f 64 73 2e 3c 62 72 3e 3c 62 72 3e 0d ethods.<br><br>.
57a0: 0a 3c 62 3e 3c 75 3e 4d 69 73 74 65 72 79 20 75 .<b><u>Mistery u
57b0: 6e 76 65 69 6c 65 64 3c 2f 75 3e 3c 2f 62 3e 3a nveiled</u></b>:
57c0: 20 6a 75 73 74 20 61 20 71 75 69 63 6b 20 67 6c just a quick gl
57d0: 61 6e 63 65 20 74 6f 20 74 68 65 20 6f 6c 64 20 ance to the old
57e0: 61 6e 64 20 6e 65 77 20 3c 62 3e 70 72 6f 6a 2d and new <b>proj-
57f0: 73 74 72 69 6e 67 73 3c 2f 62 3e 3a 0d 0a 3c 75 strings</b>:..<u
5800: 6c 3e 0d 0a 3c 6c 69 3e 53 52 49 44 3d 33 30 30 l>..<li>SRID=300
5810: 33 20 70 72 6f 6a 2d 73 74 72 69 6e 67 20 61 73 3 proj-string as
5820: 20 64 65 66 69 6e 65 64 20 62 79 20 6f 6c 64 20 defined by old
5830: 50 52 4f 4a 2e 34 3a 0d 0a 3c 75 6c 3e 0d 0a 3c PROJ.4:..<ul>..<
5840: 6c 69 3e 3c 62 3e 2b 70 72 6f 6a 3d 74 6d 65 72 li><b>+proj=tmer
5850: 63 20 2b 6c 61 74 5f 30 3d 30 20 2b 6c 6f 6e 5f c +lat_0=0 +lon_
5860: 30 3d 39 20 2b 6b 3d 30 2e 39 39 39 36 20 2b 78 0=9 +k=0.9996 +x
5870: 5f 30 3d 31 35 30 30 30 30 30 20 2b 79 5f 30 3d _0=1500000 +y_0=
5880: 30 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20 2b 74 0 +ellps=intl +t
5890: 6f 77 67 73 38 34 3d 2d 31 30 34 2e 31 2c 2d 34 owgs84=-104.1,-4
58a0: 39 2e 31 2c 2d 39 2e 39 2c 30 2e 39 37 31 2c 2d 9.1,-9.9,0.971,-
58b0: 32 2e 39 31 37 2c 30 2e 37 31 34 2c 2d 31 31 2e 2.917,0.714,-11.
58c0: 36 38 20 2b 75 6e 69 74 73 3d 6d 20 2b 6e 6f 5f 68 +units=m +no_
58d0: 64 65 66 73 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c defs</b></li>..<
58e0: 2f 75 6c 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 53 /ul></li>..<li>S
58f0: 52 49 44 3d 33 30 30 33 20 70 72 6f 6a 2d 73 74 RID=3003 proj-st
5900: 72 69 6e 67 20 61 73 20 64 65 66 69 6e 65 64 20 ring as defined
5910: 62 79 20 6e 65 77 20 50 52 4f 4a 2e 36 3a 0d 0a by new PROJ.6:..
5920: 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 2b 70 72 <ul>..<li><b>+pr
5930: 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 5f 30 3d oj=tmerc +lat_0=
5940: 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 2e 0 +lon_0=9 +k=0.
5950: 39 39 39 36 20 2b 78 5f 30 3d 31 35 30 30 30 30 9996 +x_0=150000
5960: 30 20 2b 79 5f 30 3d 30 20 2b 65 6c 6c 70 73 3d 0 +y_0=0 +ellps=
5970: 69 6e 74 6c 20 2b 75 6e 69 74 73 3d 6d 20 2b 6e intl +units=m +n
5980: 6f 5f 64 65 66 73 20 2b 74 79 70 65 3d 63 72 73 o_defs +type=crs
5990: 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e </b></li>..</ul>
59a0: 3c 2f 6c 69 3e 0d 0a 41 73 20 79 6f 75 20 63 61 </li>..As you ca
59b0: 6e 20 65 61 73 69 6c 79 20 6e 6f 74 69 63 65 2c n easily notice,
59c0: 20 74 68 65 72 65 20 69 73 20 6e 6f 20 3c 62 3e there is no <b>
59d0: 2b 74 6f 77 67 73 38 34 3c 2f 62 3e 20 74 65 72 +towgs84</b> ter
59e0: 6d 20 64 65 66 69 6e 65 64 20 69 6e 20 6e 65 77 m defined in new
59f0: 20 50 52 4f 4a 2e 36 2c 20 61 6e 64 20 74 68 69 PROJ.6, and thi
5a00: 73 20 66 75 6c 6c 79 20 65 78 70 6c 61 69 6e 73 s fully explains
5a10: 20 61 6c 6c 2e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e all...</ul><br>
5a20: 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 2d 2d ..<verbatim>..--
5a30: 20 74 6f 20 45 50 53 47 3a 33 30 30 33 20 2d 20 to EPSG:3003 -
5a40: 75 73 69 6e 67 20 61 20 74 72 61 6e 73 66 6f 72 using a transfor
5a50: 6d 61 74 69 6f 6e 20 70 69 70 65 6c 69 6e 65 0d mation pipeline.
5a60: 0a 53 45 4c 45 43 54 20 41 73 45 57 4b 54 20 28 .SELECT AsEWKT (
5a70: 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 53 ST_Transform( S
5a80: 77 61 70 43 6f 6f 72 64 73 20 28 20 4d 61 6b 65 wapCoords ( Make
5a90: 50 6f 69 6e 74 28 20 31 31 2e 38 37 38 30 35 36 Point( 11.878056
5aa0: 20 2c 20 34 33 2e 34 36 33 30 35 36 2c 20 34 33 , 43.463056, 43
5ab0: 32 36 20 29 20 29 20 2c 20 33 30 30 33 20 2c 20 26 ) ) , 3003 ,
5ac0: 4e 55 4c 4c 20 2c 20 27 70 72 6f 6a 5f 73 74 72 NULL , 'proj_str
5ad0: 69 6e 67 27 20 2c 0d 0a 27 2b 70 72 6f 6a 3d 70 ing' ,..'+proj=p
5ae0: 69 70 65 6c 69 6e 65 20 0d 0a 2b 73 74 65 70 20 ipeline ..+step
5af0: 2b 70 72 6f 6a 3d 61 78 69 73 73 77 61 70 20 2b +proj=axisswap +
5b00: 6f 72 64 65 72 3d 32 2c 31 20 0d 0a 2b 73 74 65 order=2,1 ..+ste
5b10: 70 20 2b 70 72 6f 6a 3d 75 6e 69 74 63 6f 6e 76 p +proj=unitconv
5b20: 65 72 74 20 2b 78 79 5f 69 6e 3d 64 65 67 20 2b ert +xy_in=deg +
5b30: 78 79 5f 6f 75 74 3d 72 61 64 20 0d 0a 2b 73 74 xy_out=rad ..+st
5b40: 65 70 20 2b 70 72 6f 6a 3d 70 75 73 68 20 2b 76 ep +proj=push +v
5b50: 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a _3 ..+step +proj
5b60: 3d 63 61 72 74 20 2b 65 6c 6c 70 73 3d 57 47 53 =cart +ellps=WGS
5b70: 38 34 20 0d 0a 2b 73 74 65 70 20 2b 69 6e 76 20 84 ..+step +inv
5b80: 2b 70 72 6f 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 +proj=helmert +x
5b90: 3d 2d 31 30 34 2e 31 20 2b 79 3d 2d 34 39 2e 31 =-104.1 +y=-49.1
5ba0: 20 2b 7a 3d 2d 39 2e 39 20 2b 72 78 3d 30 2e 39 +z=-9.9 +rx=0.9
5bb0: 37 31 20 2b 72 79 3d 2d 32 2e 39 31 37 20 2b 72 71 +ry=-2.917 +r
5bc0: 7a 3d 30 2e 37 31 34 20 2b 73 3d 2d 31 31 2e 36 z=0.714 +s=-11.6
5bd0: 38 20 2b 63 6f 6e 76 65 6e 74 69 6f 6e 3d 70 6f 8 +convention=po
5be0: 73 69 74 69 6f 6e 5f 76 65 63 74 6f 72 20 0d 0a sition_vector ..
5bf0: 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a +step +inv +proj
5c00: 3d 63 61 72 74 20 2b 65 6c 6c 70 73 3d 69 6e 74 =cart +ellps=int
5c10: 6c 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d l ..+step +proj=
5c20: 70 6f 70 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 pop +v_3 ..+step
5c30: 20 2b 70 72 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61 +proj=tmerc +la
5c40: 74 5f 30 3d 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b t_0=0 +lon_0=9 +
5c50: 6b 3d 30 2e 39 39 39 36 20 2b 78 5f 30 3d 31 35 k=0.9996 +x_0=15
5c60: 30 30 30 30 30 20 2b 79 5f 30 3d 30 20 2b 65 6c 00000 +y_0=0 +el
5c70: 6c 70 73 3d 69 6e 74 6c 27 20 29 29 3b 0d 0a 2d lps=intl' ));..-
5c80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5c90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5ca0: 2d 2d 2d 2d 0d 0a 53 52 49 44 3d 33 30 30 33 3b ----..SRID=3003;
5cb0: 50 4f 49 4e 54 28 31 37 33 32 38 35 32 2e 39 34 POINT(1732852.94
5cc0: 32 37 31 36 37 36 39 20 34 38 31 36 32 37 37 2e 2716769 4816277.
5cd0: 36 31 37 36 39 30 36 37 34 29 0d 0a 0d 0a 2d 2d 617690674)....--
5ce0: 20 74 6f 20 45 50 53 47 3a 33 30 30 33 20 2d 20 to EPSG:3003 -
5cf0: 75 73 69 6e 67 20 61 20 63 75 73 74 6f 6d 69 7a using a customiz
5d00: 65 64 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f ed transformatio
5d10: 6e 20 70 69 70 65 6c 69 6e 65 0d 0a 53 45 4c 45 n pipeline..SELE
5d20: 43 54 20 41 73 45 57 4b 54 20 28 20 53 54 5f 54 CT AsEWKT ( ST_T
5d30: 72 61 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f ransform( MakePo
5d40: 69 6e 74 28 20 31 31 2e 38 37 38 30 35 36 20 2c int( 11.878056 ,
5d50: 20 34 33 2e 34 36 33 30 35 36 2c 20 34 33 32 36 43.463056, 4326
5d60: 20 29 20 2c 20 33 30 30 33 20 2c 20 4e 55 4c 4c ) , 3003 , NULL
5d70: 20 2c 20 27 70 72 6f 6a 5f 73 74 72 69 6e 67 27 , 'proj_string'
5d80: 20 2c 0d 0a 27 2b 70 72 6f 6a 3d 70 69 70 65 6c ,..'+proj=pipel
5d90: 69 6e 65 20 20 0d 0a 2b 73 74 65 70 20 2b 70 72 ine ..+step +pr
5da0: 6f 6a 3d 75 6e 69 74 63 6f 6e 76 65 72 74 20 2b oj=unitconvert +
5db0: 78 79 5f 69 6e 3d 64 65 67 20 2b 78 79 5f 6f 75 xy_in=deg +xy_ou
5dc0: 74 3d 72 61 64 20 0d 0a 2b 73 74 65 70 20 2b 70 t=rad ..+step +p
5dd0: 72 6f 6a 3d 70 75 73 68 20 2b 76 5f 33 20 0d 0a roj=push +v_3 ..
5de0: 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 63 61 72 74 +step +proj=cart
5df0: 20 2b 65 6c 6c 70 73 3d 57 47 53 38 34 20 0d 0a +ellps=WGS84 ..
5e00: 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a +step +inv +proj
5e10: 3d 68 65 6c 6d 65 72 74 20 2b 78 3d 2d 31 30 34 =helmert +x=-104
5e20: 2e 31 20 2b 79 3d 2d 34 39 2e 31 20 2b 7a 3d 2d .1 +y=-49.1 +z=-
5e30: 39 2e 39 20 2b 72 78 3d 30 2e 39 37 31 20 2b 72 9.9 +rx=0.971 +r
5e40: 79 3d 2d 32 2e 39 31 37 20 2b 72 7a 3d 30 2e 37 y=-2.917 +rz=0.7
5e50: 31 34 20 2b 73 3d 2d 31 31 2e 36 38 20 2b 63 6f 14 +s=-11.68 +co
5e60: 6e 76 65 6e 74 69 6f 6e 3d 70 6f 73 69 74 69 6f nvention=positio
5e70: 6e 5f 76 65 63 74 6f 72 20 0d 0a 2b 73 74 65 70 n_vector ..+step
5e80: 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d 63 61 72 74 +inv +proj=cart
5e90: 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20 0d 0a 2b +ellps=intl ..+
5ea0: 73 74 65 70 20 2b 70 72 6f 6a 3d 70 6f 70 20 2b step +proj=pop +
5eb0: 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f v_3 ..+step +pro
5ec0: 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 5f 30 3d 30 j=tmerc +lat_0=0
5ed0: 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 2e 39 +lon_0=9 +k=0.9
5ee0: 39 39 36 20 2b 78 5f 30 3d 31 35 30 30 30 30 30 996 +x_0=1500000
5ef0: 20 2b 79 5f 30 3d 30 20 2b 65 6c 6c 70 73 3d 69 +y_0=0 +ellps=i
5f00: 6e 74 6c 27 20 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d ntl' ));..------
5f10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5f20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d ---------------.
5f30: 0a 53 52 49 44 3d 33 30 30 33 3b 50 4f 49 4e 54 .SRID=3003;POINT
5f40: 28 31 37 33 32 38 35 32 2e 39 34 32 37 31 36 37 (1732852.9427167
5f50: 36 39 20 34 38 31 36 32 37 37 2e 36 31 37 36 39 69 4816277.61769
5f60: 30 36 37 34 29 0d 0a 3c 2f 76 65 72 62 61 74 69 0674)..</verbati
5f70: 6d 3e 0d 0a 54 68 69 73 20 74 68 69 72 64 20 74 m>..This third t
5f80: 65 73 74 20 69 73 20 62 61 73 65 64 20 6f 6e 20 est is based on
5f90: 75 73 69 6e 67 20 3c 62 3e 3c 69 3e 74 72 61 6e using <b><i>tran
5fa0: 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 6c sformation pipel
5fb0: 69 6e 65 73 3c 2f 69 3e 3c 2f 62 3e 3a 0d 0a 3c ines</i></b>:..<
5fc0: 75 6c 3e 0d 0a 3c 6c 69 3e 74 68 65 20 66 69 72 ul>..<li>the fir
5fd0: 73 74 20 71 75 65 72 79 20 64 69 72 65 63 74 6c st query directl
5fe0: 79 20 75 73 65 73 20 61 20 70 72 6f 6a 2d 73 74 y uses a proj-st
5ff0: 72 69 6e 67 20 72 65 70 72 65 73 65 6e 74 69 6e ring representin
6000: 67 20 74 68 65 20 70 69 70 65 6c 69 6e 65 20 61 g the pipeline a
6010: 73 20 64 65 66 69 6e 65 64 20 62 79 20 65 78 65 s defined by exe
6020: 63 75 74 69 6e 67 3c 62 72 3e 0d 0a 3c 62 3e 70 cuting<br>..<b>p
6030: 72 6f 6a 69 6e 66 6f 20 20 2d 73 20 45 50 53 47 rojinfo -s EPSG
6040: 3a 34 33 32 36 20 2d 74 20 45 50 53 47 3a 33 30 :4326 -t EPSG:30
6050: 30 33 20 2d 2d 61 72 65 61 20 20 22 49 74 61 6c 03 --area "Ital
6060: 79 20 2d 20 6d 61 69 6e 6c 61 6e 64 22 20 2d 6f y - mainland" -o
6070: 20 70 72 6f 6a 3c 2f 62 3e 3c 62 72 3e 0d 0a 28 proj</b><br>..(
6080: 77 65 27 6c 6c 20 73 65 65 20 74 68 69 73 20 74 we'll see this t
6090: 6f 70 69 63 20 69 6e 20 6d 6f 72 65 20 64 65 70 opic in more dep
60a0: 74 68 20 6f 6e 20 74 68 65 20 6e 65 78 74 20 70 th on the next p
60b0: 61 72 61 67 72 61 70 68 29 3c 2f 6c 69 3e 0d 0a aragraph)</li>..
60c0: 3c 6c 69 3e 74 68 65 20 73 65 63 6f 6e 64 20 71 <li>the second q
60d0: 75 65 72 79 20 69 73 20 6a 75 73 74 20 61 20 73 uery is just a s
60e0: 6d 61 6c 6c 20 61 64 61 70 74 61 74 69 6f 6e 20 mall adaptation
60f0: 6f 66 20 74 68 65 20 66 69 72 73 74 20 6f 6e 65 of the first one
6100: 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 41 73 20 :..<ul>..<li>As
6110: 79 6f 75 20 63 61 6e 20 6e 6f 74 69 63 65 20 74 you can notice t
6120: 68 65 20 66 69 72 73 74 20 71 75 65 72 79 20 72 he first query r
6130: 65 71 75 69 72 65 73 20 63 61 6c 6c 69 6e 67 20 equires calling
6140: 3c 62 3e 53 77 61 70 43 6f 6f 64 69 6e 61 74 65 <b>SwapCoodinate
6150: 73 28 29 3c 2f 62 3e 20 62 65 63 61 75 73 65 20 s()</b> because
6160: 74 68 65 20 66 69 72 73 74 20 73 74 65 70 20 6f the first step o
6170: 66 20 74 68 65 20 70 69 70 65 6c 69 6e 65 20 68 f the pipeline h
6180: 61 73 20 61 6e 20 3c 62 3e 61 78 69 73 73 77 61 as an <b>axisswa
6190: 70 3c 2f 62 3e 20 64 69 72 65 63 74 69 76 65 2e p</b> directive.
61a0: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 54 68 65 20 73 </li>..<li>The s
61b0: 65 63 6f 6e 64 20 71 75 65 72 79 20 6a 75 73 74 econd query just
61c0: 20 61 76 6f 69 64 73 20 74 6f 20 63 61 6c 6c 20 avoids to call
61d0: 3c 62 3e 53 77 61 70 43 6f 6f 72 64 73 28 29 3c <b>SwapCoords()<
61e0: 2f 62 3e 20 61 6e 64 20 63 6f 6e 73 65 71 75 65 /b> and conseque
61f0: 6e 74 6c 79 20 74 68 65 20 74 72 61 73 66 6f 72 ntly the trasfor
6200: 6d 61 74 69 6f 6e 20 70 69 70 65 6c 69 6e 65 20 mation pipeline
6210: 73 74 65 70 20 72 65 6d 6f 76 65 73 20 74 68 69 step removes thi
6220: 73 20 66 69 72 73 74 20 73 74 65 70 20 73 6f 20 s first step so
6230: 74 6f 20 67 65 74 20 74 68 65 20 73 61 6d 65 20 to get the same
6240: 69 64 65 6e 74 69 63 61 6c 20 6f 76 65 72 61 6c identical overal
6250: 6c 20 65 66 66 65 63 74 2e 3c 2f 6c 69 3e 0d 0a l effect.</li>..
6260: 3c 2f 75 6c 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e </ul></li>..<li>
6270: 3c 62 3e 3c 75 3e 4e 6f 74 65 3c 2f 75 3e 3c 2f <b><u>Note</u></
6280: 62 3e 3a 20 53 70 61 74 69 61 4c 69 74 65 20 77 b>: SpatiaLite w
6290: 69 6c 6c 20 61 6c 77 61 79 73 20 64 6f 20 61 20 ill always do a
62a0: 62 65 73 74 20 65 66 66 6f 72 74 20 69 6e 20 6f best effort in o
62b0: 72 64 65 72 20 74 6f 20 67 75 65 73 73 20 69 66 rder to guess if
62c0: 20 73 77 61 70 70 69 6e 67 20 74 68 65 20 63 6f swapping the co
62d0: 6f 72 64 69 6e 61 74 65 73 20 62 65 66 6f 72 65 ordinates before
62e0: 20 70 61 73 73 69 6e 67 20 74 68 65 6d 20 74 6f passing them to
62f0: 20 50 52 4f 4a 2e 36 20 69 73 20 72 65 71 75 69 PROJ.6 is requi
6300: 72 65 64 20 6f 72 20 6e 6f 74 2e 3c 62 72 3e 0d red or not.<br>.
6310: 0a 42 75 74 20 69 6e 20 74 68 65 20 73 70 65 63 .But in the spec
6320: 69 66 69 63 20 63 61 73 65 20 6f 66 20 61 20 74 ific case of a t
6330: 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 ransformation pi
6340: 70 65 6c 69 6e 65 20 74 68 69 73 20 74 65 73 74 peline this test
6350: 20 6d 61 79 20 65 61 73 69 6c 79 20 66 61 69 6c may easily fail
6360: 2c 20 74 68 75 73 20 72 65 71 75 69 72 69 6e 67 , thus requiring
6370: 20 74 6f 20 65 78 70 6c 69 63 69 74 6c 79 20 63 to explicitly c
6380: 61 6c 6c 20 3c 62 3e 53 77 61 70 43 6f 6f 72 64 all <b>SwapCoord
6390: 73 28 29 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f s()</b></li>..</
63a0: 75 6c 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 ul><br>..<table
63b0: 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 cellspacing="8"
63c0: 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 31 36 22 cellpadding="16"
63d0: 20 62 67 63 6f 6c 6f 72 3d 22 23 63 39 66 66 66 bgcolor="#c9fff
63e0: 30 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 0">..<tr><td>..<
63f0: 68 33 3e 75 73 69 6e 67 20 70 72 6f 6a 69 6e 66 h3>using projinf
6400: 6f 20 66 6f 72 20 64 65 74 65 63 74 69 6e 67 20 o for detecting
6410: 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 transformation p
6420: 69 70 65 6c 69 6e 65 73 20 61 6e 64 20 73 75 70 ipelines and sup
6430: 70 6f 72 74 65 64 20 61 72 65 61 73 20 6f 66 20 ported areas of
6440: 75 73 65 3c 2f 68 33 3e 0d 0a 3c 76 65 72 62 61 use</h3>..<verba
6450: 74 69 6d 3e 0d 0a 70 72 6f 6a 69 6e 66 6f 20 2d tim>..projinfo -
6460: 73 20 45 50 53 47 3a 34 33 32 36 20 2d 74 20 45 s EPSG:4326 -t E
6470: 50 53 47 3a 33 30 30 33 20 2d 6f 20 70 72 6f 6a PSG:3003 -o proj
6480: 20 2d 2d 73 70 61 74 69 61 6c 2d 74 65 73 74 20 --spatial-test
6490: 69 6e 74 65 72 73 65 63 74 0d 0a 43 61 6e 64 69 intersect..Candi
64a0: 64 61 74 65 20 6f 70 65 72 61 74 69 6f 6e 73 20 date operations
64b0: 66 6f 75 6e 64 3a 20 33 0d 0a 2d 2d 2d 2d 2d 2d found: 3..------
64c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
64d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d ---------------.
64e0: 0a 4f 70 65 72 61 74 69 6f 6e 20 6e c2 b0 31 3a .Operation n..1:
64f0: 0d 0a 0d 0a 75 6e 6b 6e 6f 77 6e 20 69 64 2c 20 ....unknown id,
6500: 49 6e 76 65 72 73 65 20 6f 66 20 4d 6f 6e 74 65 Inverse of Monte
6510: 20 4d 61 72 69 6f 20 74 6f 20 57 47 53 20 38 34 Mario to WGS 84
6520: 20 28 34 29 20 2b 20 49 74 61 6c 79 20 7a 6f 6e (4) + Italy zon
6530: 65 20 31 2c 20 34 20 6d 2c 20 49 74 61 6c 79 20 e 1, 4 m, Italy
6540: 2d 20 6d 61 69 6e 6c 61 6e 64 0d 0a 0d 0a 50 52 - mainland....PR
6550: 4f 4a 20 73 74 72 69 6e 67 3a 0d 0a 2b 70 72 6f OJ string:..+pro
6560: 6a 3d 70 69 70 65 6c 69 6e 65 20 0d 0a 2b 73 74 j=pipeline ..+st
6570: 65 70 20 2b 70 72 6f 6a 3d 61 78 69 73 73 77 61 ep +proj=axisswa
6580: 70 20 2b 6f 72 64 65 72 3d 32 2c 31 20 0d 0a 2b p +order=2,1 ..+
6590: 73 74 65 70 20 2b 70 72 6f 6a 3d 75 6e 69 74 63 step +proj=unitc
65a0: 6f 6e 76 65 72 74 20 2b 78 79 5f 69 6e 3d 64 65 onvert +xy_in=de
65b0: 67 20 2b 78 79 5f 6f 75 74 3d 72 61 64 20 0d 0a g +xy_out=rad ..
65c0: 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 75 73 68 +step +proj=push
65d0: 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 +v_3 ..+step +p
65e0: 72 6f 6a 3d 63 61 72 74 20 2b 65 6c 6c 70 73 3d roj=cart +ellps=
65f0: 57 47 53 38 34 20 0d 0a 2b 73 74 65 70 20 2b 69 WGS84 ..+step +i
6600: 6e 76 20 2b 70 72 6f 6a 3d 68 65 6c 6d 65 72 74 nv +proj=helmert
6610: 20 2b 78 3d 2d 31 30 34 2e 31 20 2b 79 3d 2d 34 +x=-104.1 +y=-4
6620: 39 2e 31 20 2b 7a 3d 2d 39 2e 39 20 2b 72 78 3d 9.1 +z=-9.9 +rx=
6630: 30 2e 39 37 31 20 2b 72 79 3d 2d 32 2e 39 31 37 0.971 +ry=-2.917
6640: 20 2b 72 7a 3d 30 2e 37 31 34 20 2b 73 3d 2d 31 +rz=0.714 +s=-1
6650: 31 2e 36 38 20 2b 63 6f 6e 76 65 6e 74 69 6f 6e 1.68 +convention
6660: 3d 70 6f 73 69 74 69 6f 6e 5f 76 65 63 74 6f 72 =position_vector
6670: 20 0d 0a 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 ..+step +inv +p
6680: 72 6f 6a 3d 63 61 72 74 20 2b 65 6c 6c 70 73 3d roj=cart +ellps=
6690: 69 6e 74 6c 20 0d 0a 2b 73 74 65 70 20 2b 70 72 intl ..+step +pr
66a0: 6f 6a 3d 70 6f 70 20 2b 76 5f 33 20 0d 0a 2b 73 oj=pop +v_3 ..+s
66b0: 74 65 70 20 2b 70 72 6f 6a 3d 74 6d 65 72 63 20 tep +proj=tmerc
66c0: 2b 6c 61 74 5f 30 3d 30 20 2b 6c 6f 6e 5f 30 3d +lat_0=0 +lon_0=
66d0: 39 20 2b 6b 3d 30 2e 39 39 39 36 20 2b 78 5f 30 9 +k=0.9996 +x_0
66e0: 3d 31 35 30 30 30 30 30 20 2b 79 5f 30 3d 30 20 =1500000 +y_0=0
66f0: 2b 65 6c 6c 70 73 3d 69 6e 74 6c 0d 0a 0d 0a 2d +ellps=intl....-
6700: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6710: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6720: 2d 2d 2d 2d 0d 0a 4f 70 65 72 61 74 69 6f 6e 20 ----..Operation
6730: 6e c2 b0 32 3a 0d 0a 0d 0a 75 6e 6b 6e 6f 77 6e n..2:....unknown
6740: 20 69 64 2c 20 49 6e 76 65 72 73 65 20 6f 66 20 id, Inverse of
6750: 4d 6f 6e 74 65 20 4d 61 72 69 6f 20 74 6f 20 57 Monte Mario to W
6760: 47 53 20 38 34 20 28 32 29 20 2b 20 49 74 61 6c GS 84 (2) + Ital
6770: 79 20 7a 6f 6e 65 20 31 2c 20 34 20 6d 2c 20 49 y zone 1, 4 m, I
6780: 74 61 6c 79 20 2d 20 53 61 72 64 69 6e 69 61 20 taly - Sardinia
6790: 6f 6e 73 68 6f 72 65 0d 0a 0d 0a 50 52 4f 4a 20 onshore....PROJ
67a0: 73 74 72 69 6e 67 3a 0d 0a 2b 70 72 6f 6a 3d 70 string:..+proj=p
67b0: 69 70 65 6c 69 6e 65 20 0d 0a 2b 73 74 65 70 20 ipeline ..+step
67c0: 2b 70 72 6f 6a 3d 61 78 69 73 73 77 61 70 20 2b +proj=axisswap +
67d0: 6f 72 64 65 72 3d 32 2c 31 20 0d 0a 2b 73 74 65 order=2,1 ..+ste
67e0: 70 20 2b 70 72 6f 6a 3d 75 6e 69 74 63 6f 6e 76 p +proj=unitconv
67f0: 65 72 74 20 2b 78 79 5f 69 6e 3d 64 65 67 20 2b ert +xy_in=deg +
6800: 78 79 5f 6f 75 74 3d 72 61 64 20 0d 0a 2b 73 74 xy_out=rad ..+st
6810: 65 70 20 2b 70 72 6f 6a 3d 70 75 73 68 20 2b 76 ep +proj=push +v
6820: 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a _3 ..+step +proj
6830: 3d 63 61 72 74 20 2b 65 6c 6c 70 73 3d 57 47 53 =cart +ellps=WGS
6840: 38 34 20 0d 0a 2b 73 74 65 70 20 2b 69 6e 76 20 84 ..+step +inv
6850: 2b 70 72 6f 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 +proj=helmert +x
6860: 3d 2d 31 36 38 2e 36 20 2b 79 3d 2d 33 34 20 2b =-168.6 +y=-34 +
6870: 7a 3d 33 38 2e 36 20 2b 72 78 3d 2d 30 2e 33 37 z=38.6 +rx=-0.37
6880: 34 20 2b 72 79 3d 2d 30 2e 36 37 39 20 2b 72 7a 4 +ry=-0.679 +rz
6890: 3d 2d 31 2e 33 37 39 20 2b 73 3d 2d 39 2e 34 38 =-1.379 +s=-9.48
68a0: 20 2b 63 6f 6e 76 65 6e 74 69 6f 6e 3d 70 6f 73 +convention=pos
68b0: 69 74 69 6f 6e 5f 76 65 63 74 6f 72 20 0d 0a 2b ition_vector ..+
68c0: 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d step +inv +proj=
68d0: 63 61 72 74 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c cart +ellps=intl
68e0: 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 ..+step +proj=p
68f0: 6f 70 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 op +v_3 ..+step
6900: 2b 70 72 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 +proj=tmerc +lat
6910: 5f 30 3d 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b _0=0 +lon_0=9 +k
6920: 3d 30 2e 39 39 39 36 20 2b 78 5f 30 3d 31 35 30 =0.9996 +x_0=150
6930: 30 30 30 30 20 2b 79 5f 30 3d 30 20 2b 65 6c 6c 0000 +y_0=0 +ell
6940: 70 73 3d 69 6e 74 6c 0d 0a 0d 0a 2d 2d 2d 2d 2d ps=intl....-----
6950: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6960: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6970: 0d 0a 4f 70 65 72 61 74 69 6f 6e 20 6e c2 b0 33 ..Operation n..3
6980: 3a 0d 0a 0d 0a 75 6e 6b 6e 6f 77 6e 20 69 64 2c :....unknown id,
6990: 20 49 6e 76 65 72 73 65 20 6f 66 20 4d 6f 6e 74 Inverse of Mont
69a0: 65 20 4d 61 72 69 6f 20 74 6f 20 57 47 53 20 38 e Mario to WGS 8
69b0: 34 20 28 31 31 29 20 2b 20 49 74 61 6c 79 20 7a 4 (11) + Italy z
69c0: 6f 6e 65 20 31 2c 20 31 30 20 6d 2c 20 49 74 61 one 1, 10 m, Ita
69d0: 6c 79 20 2d 20 53 69 63 69 6c 79 20 53 74 72 61 ly - Sicily Stra
69e0: 69 74 20 77 65 73 74 20 6f 66 20 31 33 c2 b0 45 it west of 13..E
69f0: 0d 0a 0d 0a 50 52 4f 4a 20 73 74 72 69 6e 67 3a ....PROJ string:
6a00: 0d 0a 2b 70 72 6f 6a 3d 70 69 70 65 6c 69 6e 65 ..+proj=pipeline
6a10: 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 61 ..+step +proj=a
6a20: 78 69 73 73 77 61 70 20 2b 6f 72 64 65 72 3d 32 xisswap +order=2
6a30: 2c 31 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a ,1 ..+step +proj
6a40: 3d 75 6e 69 74 63 6f 6e 76 65 72 74 20 2b 78 79 =unitconvert +xy
6a50: 5f 69 6e 3d 64 65 67 20 2b 78 79 5f 6f 75 74 3d _in=deg +xy_out=
6a60: 72 61 64 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f rad ..+step +pro
6a70: 6a 3d 70 75 73 68 20 2b 76 5f 33 20 0d 0a 2b 73 j=push +v_3 ..+s
6a80: 74 65 70 20 2b 70 72 6f 6a 3d 63 61 72 74 20 2b tep +proj=cart +
6a90: 65 6c 6c 70 73 3d 57 47 53 38 34 20 0d 0a 2b 73 ellps=WGS84 ..+s
6aa0: 74 65 70 20 2b 70 72 6f 6a 3d 68 65 6c 6d 65 72 tep +proj=helmer
6ab0: 74 20 2b 78 3d 32 33 30 2e 34 37 20 2b 79 3d 35 t +x=230.47 +y=5
6ac0: 36 2e 30 38 20 2b 7a 3d 2d 32 32 2e 34 33 20 0d 6.08 +z=-22.43 .
6ad0: 0a 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f .+step +inv +pro
6ae0: 6a 3d 63 61 72 74 20 2b 65 6c 6c 70 73 3d 69 6e j=cart +ellps=in
6af0: 74 6c 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a tl ..+step +proj
6b00: 3d 70 6f 70 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 =pop +v_3 ..+ste
6b10: 70 20 2b 70 72 6f 6a 3d 74 6d 65 72 63 20 2b 6c p +proj=tmerc +l
6b20: 61 74 5f 30 3d 30 20 2b 6c 6f 6e 5f 30 3d 39 20 at_0=0 +lon_0=9
6b30: 2b 6b 3d 30 2e 39 39 39 36 20 2b 78 5f 30 3d 31 +k=0.9996 +x_0=1
6b40: 35 30 30 30 30 30 20 2b 79 5f 30 3d 30 20 2b 65 500000 +y_0=0 +e
6b50: 6c 6c 70 73 3d 69 6e 74 6c 0d 0a 3c 2f 76 65 72 llps=intl..</ver
6b60: 62 61 74 69 6d 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 batim>..</td></t
6b70: 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e r>..</table><br>
6b80: 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 2d 2d ..<verbatim>..--
6b90: 20 74 6f 20 45 50 53 47 3a 33 30 30 33 20 2d 20 to EPSG:3003 -
6ba0: 64 65 66 61 75 6c 74 20 73 65 74 74 69 6e 67 73 default settings
6bb0: 3b 20 69 67 6e 6f 72 69 6e 67 20 73 70 61 74 69 ; ignoring spati
6bc0: 61 6c 69 74 65 5f 72 65 66 5f 73 79 73 20 61 6e alite_ref_sys an
6bd0: 64 20 75 73 69 6e 67 20 74 68 65 20 50 52 4f 4a d using the PROJ
6be0: 2e 36 20 6f 77 6e 20 70 72 69 76 61 74 65 20 64 .6 own private d
6bf0: 61 74 61 62 61 73 65 0d 0a 53 45 4c 45 43 54 20 atabase..SELECT
6c00: 41 73 45 57 4b 54 20 28 20 53 54 5f 54 72 61 6e AsEWKT ( ST_Tran
6c10: 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 6e 74 sform( MakePoint
6c20: 28 20 39 2e 31 36 39 34 36 34 2c 20 33 39 2e 34 ( 9.169464, 39.4
6c30: 37 38 32 37 35 2c 20 34 33 32 36 20 29 2c 20 33 78275, 4326 ), 3
6c40: 30 30 33 20 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 003 ));..-------
6c50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6c60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a --------------..
6c70: 53 52 49 44 3d 33 30 30 33 3b 50 4f 49 4e 54 28 SRID=3003;POINT(
6c80: 31 35 31 34 36 30 30 2e 31 33 34 33 32 31 38 36 1514600.13432186
6c90: 32 20 34 33 36 39 38 37 34 2e 34 38 39 32 36 39 2 4369874.489269
6ca0: 39 35 37 29 0d 0a 0d 0a 2d 2d 20 74 6f 20 45 50 957)....-- to EP
6cb0: 53 47 3a 33 30 30 33 20 2d 20 73 61 6d 65 20 61 SG:3003 - same a
6cc0: 73 20 61 62 6f 76 65 2c 20 62 75 74 20 65 78 70 s above, but exp
6cd0: 6c 69 63 69 74 6c 79 20 64 65 66 69 6e 69 6e 67 licitly defining
6ce0: 20 61 20 73 70 65 63 69 66 69 63 20 61 72 65 61 a specific area
6cf0: 20 6f 66 20 75 73 65 0d 0a 53 45 4c 45 43 54 20 of use..SELECT
6d00: 41 73 45 57 4b 54 20 28 20 53 54 5f 54 72 61 6e AsEWKT ( ST_Tran
6d10: 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 6e 74 sform( MakePoint
6d20: 28 20 39 2e 31 36 39 34 36 34 2c 20 33 39 2e 34 ( 9.169464, 39.4
6d30: 37 38 32 37 35 2c 20 34 33 32 36 20 29 2c 20 33 78275, 4326 ), 3
6d40: 30 30 33 20 2c 20 42 75 69 6c 64 4d 42 52 28 39 003 , BuildMBR(9
6d50: 2e 31 20 2c 20 33 39 2e 34 20 2c 20 39 2e 32 20 .1 , 39.4 , 9.2
6d60: 2c 20 33 39 2e 35 20 2c 20 34 33 32 36 20 29 29 , 39.5 , 4326 ))
6d70: 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d );..------------
6d80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6d90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d ---------..SRID=
6da0: 33 30 30 33 3b 50 4f 49 4e 54 28 31 35 31 34 36 3003;POINT(15146
6db0: 30 35 2e 39 38 32 37 36 32 32 34 38 20 34 33 36 05.982762248 436
6dc0: 39 38 37 33 2e 30 30 34 32 32 36 39 34 33 29 0d 9873.004226943).
6dd0: 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 46 6f .</verbatim>..Fo
6de0: 75 72 74 68 20 61 6e 64 20 6c 61 73 74 20 65 78 urth and last ex
6df0: 61 6d 70 6c 65 2e 20 49 6e 20 73 6f 6d 65 20 63 ample. In some c
6e00: 61 73 65 73 20 65 78 70 6c 69 63 69 74 6c 79 20 ases explicitly
6e10: 64 65 66 69 6e 69 6e 67 20 61 20 73 70 65 63 69 defining a speci
6e20: 66 69 63 20 3c 62 3e 3c 69 3e 61 72 65 61 20 6f fic <b><i>area o
6e30: 66 20 75 73 65 3c 2f 69 3e 3c 2f 62 3e 20 6d 61 f use</i></b> ma
6e40: 79 20 65 6e 61 62 6c 65 20 50 52 4f 4a 2e 36 20 y enable PROJ.6
6e50: 74 6f 20 73 65 6c 65 63 74 20 61 6e 20 6f 70 74 to select an opt
6e60: 69 6d 69 7a 65 64 20 74 72 61 6e 73 66 6f 72 6d imized transform
6e70: 61 74 69 6f 6e 20 6c 65 61 64 69 6e 67 20 74 6f ation leading to
6e80: 20 6d 6f 72 65 20 70 72 65 63 69 73 65 20 72 65 more precise re
6e90: 73 75 6c 74 73 2e 3c 62 72 3e 0d 0a 49 6e 20 74 sults.<br>..In t
6ea0: 68 69 73 20 65 78 61 6d 70 6c 65 20 77 65 27 76 his example we'v
6eb0: 65 20 75 73 65 64 20 61 20 50 6f 69 6e 74 20 6c e used a Point l
6ec0: 6f 63 61 74 65 64 20 69 6e 20 53 61 72 64 69 6e ocated in Sardin
6ed0: 69 61 2c 20 61 6e 64 20 50 52 4f 4a 2e 36 20 73 ia, and PROJ.6 s
6ee0: 75 70 70 6f 72 74 73 20 73 65 76 65 72 61 6c 20 upports several
6ef0: 66 6c 61 76 6f 72 73 20 6f 66 20 3c 62 3e 45 50 flavors of <b>EP
6f00: 53 47 3a 33 30 30 33 3c 2f 62 3e 20 64 65 70 65 SG:3003</b> depe
6f10: 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 73 70 65 nding on the spe
6f20: 63 69 66 69 63 20 61 72 65 61 20 6f 66 20 75 73 cific area of us
6f30: 65 2e 3c 62 72 3e 0d 0a 3c 62 3e 49 74 61 6c 79 e.<br>..<b>Italy
6f40: 20 2d 20 53 61 72 64 69 6e 69 61 20 6f 6e 73 68 - Sardinia onsh
6f50: 6f 72 65 3c 2f 62 3e 20 69 73 20 6f 6e 65 20 62 ore</b> is one b
6f60: 65 74 77 65 65 6e 20 74 68 65 6d 2c 20 73 6f 20 etween them, so
6f70: 61 66 74 65 72 20 73 70 65 63 69 66 79 69 6e 67 after specifying
6f80: 20 61 6e 20 65 78 70 6c 69 63 69 74 20 3c 62 3e an explicit <b>
6f90: 61 72 65 61 20 6f 66 20 75 73 65 3c 2f 62 3e 20 area of use</b>
6fa0: 61 20 6d 6f 72 65 20 70 72 65 63 69 73 65 20 74 a more precise t
6fb0: 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 ransformation pi
6fc0: 70 65 6c 69 6e 65 20 77 61 73 20 73 65 6c 65 63 peline was selec
6fd0: 74 65 64 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 74 ted.<br><br>..<t
6fe0: 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 able cellspacing
6ff0: 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 ="8" cellpadding
7000: 3d 22 31 36 22 20 62 67 63 6f 6c 6f 72 3d 22 23 ="16" bgcolor="#
7010: 66 66 66 66 64 30 22 3e 0d 0a 3c 74 72 3e 3c 74 ffffd0">..<tr><t
7020: 64 3e 0d 0a 3c 62 3e 3c 75 3e 4c 65 73 73 6f 6e d>..<b><u>Lesson
7030: 20 6c 65 61 72 6e 65 64 3c 2f 75 3e 3c 2f 62 3e learned</u></b>
7040: 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 54 68 65 :..<ul>..<li>The
7050: 20 62 65 73 74 20 6d 6f 64 65 20 66 6f 72 20 74 best mode for t
7060: 61 6b 69 6e 67 20 66 75 6c 6c 20 70 72 6f 66 69 aking full profi
7070: 74 20 66 72 6f 6d 20 50 52 4f 4a 2e 36 20 69 73 t from PROJ.6 is
7080: 20 62 79 20 75 73 69 6e 67 20 3c 69 3e 6d 65 74 by using <i>met
7090: 68 6f 64 3c 2f 69 3e 3d 3c 62 3e 61 75 74 68 5f hod</i>=<b>auth_
70a0: 6e 61 6d 65 3a 61 75 74 68 5f 73 72 69 64 3c 2f name:auth_srid</
70b0: 62 3e 20 28 74 68 61 74 20 69 73 20 74 68 65 20 b> (that is the
70c0: 3c 62 3e 3c 69 3e 64 65 66 61 75 6c 74 20 73 65 <b><i>default se
70d0: 74 74 69 6e 67 3c 2f 69 3e 3c 2f 62 3e 29 2e 3c tting</i></b>).<
70e0: 62 72 3e 0d 0a 54 68 69 73 20 77 61 79 20 79 6f br>..This way yo
70f0: 75 27 6c 6c 20 62 65 20 61 62 73 6f 6c 75 74 65 u'll be absolute
7100: 6c 79 20 73 75 72 65 20 74 68 61 74 20 74 68 65 ly sure that the
7110: 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 61 6e 64 most recent and
7120: 20 66 75 6c 6c 79 20 64 65 74 61 69 6c 65 64 20 fully detailed
7130: 64 65 66 69 6e 69 74 69 6f 6e 73 20 77 69 6c 6c definitions will
7140: 20 62 65 20 61 6c 77 61 79 73 20 72 65 74 72 69 be always retri
7150: 65 76 65 64 20 66 72 6f 6d 20 74 68 65 20 50 52 eved from the PR
7160: 4f 4a 2e 36 20 6f 77 6e 20 64 61 74 61 62 61 73 OJ.6 own databas
7170: 65 20 63 6f 6d 70 6c 65 74 65 6c 79 20 69 67 6e e completely ign
7180: 6f 72 69 6e 67 20 61 6e 79 20 64 65 66 69 6e 69 oring any defini
7190: 74 69 6f 6e 20 28 6d 61 79 20 62 65 20 69 6e 63 tion (may be inc
71a0: 6f 6d 70 6c 65 74 65 20 6f 72 20 6f 62 73 6f 6c omplete or obsol
71b0: 65 74 65 29 20 65 76 65 6e 74 75 61 6c 6c 79 20 ete) eventually
71c0: 73 74 6f 72 65 64 20 69 6e 74 6f 20 74 68 65 20 stored into the
71d0: 3c 62 3e 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 <b>spatial_ref_s
71e0: 79 73 3c 2f 62 3e 20 74 61 62 6c 65 2e 0d 0a 54 ys</b> table...T
71f0: 68 69 73 20 69 73 20 61 20 70 61 72 74 69 63 75 his is a particu
7200: 6c 61 72 79 20 75 73 65 66 75 6c 20 6f 70 74 69 lary useful opti
7210: 6f 6e 20 77 68 65 6e 20 70 72 6f 63 65 73 73 69 on when processi
7220: 6e 67 20 6f 6c 64 65 72 20 64 61 74 61 62 61 73 ng older databas
7230: 65 73 20 62 65 69 6e 67 20 63 72 65 61 74 65 64 es being created
7240: 20 62 79 20 65 61 72 6c 69 65 72 20 76 65 72 73 by earlier vers
7250: 69 6f 6e 73 20 6f 66 20 53 70 61 74 69 61 4c 69 ions of SpatiaLi
7260: 74 65 20 6e 6f 74 20 79 65 74 20 73 75 70 70 6f te not yet suppo
7270: 72 74 69 6e 67 20 50 52 4f 4a 2e 36 3c 2f 6c 69 rting PROJ.6</li
7280: 3e 0d 0a 3c 6c 69 3e 53 70 61 74 69 61 4c 69 74 >..<li>SpatiaLit
7290: 65 20 64 6f 65 73 20 6e 6f 74 20 63 6f 6e 73 74 e does not const
72a0: 72 61 69 6e 74 73 20 79 6f 75 20 69 6e 20 61 6e raints you in an
72b0: 79 20 77 61 79 20 61 6e 64 20 66 75 6c 6c 79 20 y way and fully
72c0: 72 65 73 70 65 63 74 73 20 75 73 65 72 73 20 66 respects users f
72d0: 72 65 65 64 6f 6d 20 63 61 72 65 66 75 6c 6c 79 reedom carefully
72e0: 20 61 76 6f 69 64 69 6e 67 20 3c 69 3e 61 75 74 avoiding <i>aut
72f0: 6f 2d 6d 61 67 69 63 61 6c 3c 2f 69 3e 20 61 73 o-magical</i> as
7300: 73 75 6d 70 74 69 6f 6e 73 2e 3c 62 72 3e 0d 0a sumptions.<br>..
7310: 49 66 20 79 6f 75 20 68 61 76 65 20 61 6e 79 20 If you have any
7320: 67 6f 6f 64 20 72 65 61 73 6f 6e 20 73 75 67 67 good reason sugg
7330: 65 73 74 69 6e 67 20 74 6f 20 64 6f 20 73 75 63 esting to do suc
7340: 68 20 61 20 74 68 69 6e 67 20 79 6f 75 20 61 72 h a thing you ar
7350: 65 20 61 6e 79 77 61 79 20 66 72 65 65 20 74 6f e anyway free to
7360: 20 75 73 65 20 74 68 65 20 70 72 6f 6a 2d 73 74 use the proj-st
7370: 72 69 6e 67 73 20 28 3c 69 3e 6d 65 74 68 6f 64 rings (<i>method
7380: 3c 2f 69 3e 3d 3c 62 3e 70 72 6f 6a 34 74 65 78 </i>=<b>proj4tex
7390: 74 3c 2f 62 3e 29 20 6f 72 20 74 68 65 20 57 4b t</b>) or the WK
73a0: 54 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 28 3c T definitions (<
73b0: 69 3e 6d 65 74 68 6f 64 3c 2f 69 3e 3d 3c 62 3e i>method</i>=<b>
73c0: 73 72 74 65 78 74 3c 2f 62 3e 29 20 73 74 6f 72 srtext</b>) stor
73d0: 65 64 20 69 6e 74 6f 20 74 68 65 20 3c 62 3e 73 ed into the <b>s
73e0: 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 3c 2f patial_ref_sys</
73f0: 62 3e 20 74 61 62 6c 65 2e 3c 62 72 3e 0d 0a 42 b> table.<br>..B
7400: 75 74 20 74 68 69 73 20 69 73 20 75 6e 64 65 72 ut this is under
7410: 20 79 6f 75 72 20 66 75 6c 6c 20 72 65 73 70 6f your full respo
7420: 6e 73 69 62 69 6c 69 74 79 2c 20 61 6e 64 20 79 nsibility, and y
7430: 6f 75 20 6d 75 73 74 20 62 65 20 77 65 6c 6c 20 ou must be well
7440: 73 75 72 65 20 6f 66 20 77 68 61 74 20 61 72 65 sure of what are
7450: 20 79 6f 75 20 64 6f 69 6e 67 2e 3c 2f 6c 69 3e you doing.</li>
7460: 0d 0a 3c 6c 69 3e 53 70 61 74 69 61 4c 69 74 65 ..<li>SpatiaLite
7470: 20 65 6e 63 6f 75 72 61 67 65 73 20 61 6e 64 20 encourages and
7480: 70 72 6f 6d 6f 74 65 73 20 74 68 65 20 6d 6f 73 promotes the mos
7490: 74 20 63 72 65 61 74 69 76 65 20 75 73 65 73 20 t creative uses
74a0: 6f 66 20 50 52 4f 4a 2e 36 2c 20 74 68 69 73 20 of PROJ.6, this
74b0: 69 6e 63 6c 75 64 69 6e 67 20 3c 62 3e 3c 69 3e including <b><i>
74c0: 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 transformation p
74d0: 69 70 65 6c 69 6e 65 73 3c 2f 69 3e 3c 2f 62 3e ipelines</i></b>
74e0: 2e 3c 62 72 3e 0d 0a 43 6f 72 72 65 63 74 6c 79 .<br>..Correctly
74f0: 20 75 73 69 6e 67 20 3c 69 3e 6d 65 74 68 6f 64 using <i>method
7500: 3c 2f 69 3e 3d 3c 62 3e 70 72 6f 6a 5f 73 74 72 </i>=<b>proj_str
7510: 69 6e 67 3c 2f 62 3e 20 66 6f 72 20 63 6f 6d 70 ing</b> for comp
7520: 75 74 69 6e 67 20 63 75 73 74 6f 6d 20 74 72 61 uting custom tra
7530: 6e 73 66 6f 72 6d 61 74 69 6f 6e 73 20 69 73 6e nsformations isn
7540: 27 74 20 6e 65 63 65 73 73 61 72 69 6c 79 20 73 't necessarily s
7550: 69 6d 70 6c 65 20 61 6e 64 20 65 61 73 79 2c 20 imple and easy,
7560: 62 75 74 20 69 74 27 73 20 61 20 62 69 67 20 6f but it's a big o
7570: 70 70 6f 72 74 75 6e 69 74 79 20 66 6f 72 20 61 pportunity for a
7580: 6c 6c 20 73 6b 69 6c 6c 65 64 20 61 6e 64 20 74 ll skilled and t
7590: 61 6c 65 6e 74 65 64 20 70 6f 77 65 72 20 75 73 alented power us
75a0: 65 72 73 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e ers.</li>..</ul>
75b0: 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f ..</td></tr>..</
75c0: 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 68 33 3e table><br>..<h3>
75d0: 4e 65 77 20 61 75 78 69 6c 69 61 72 79 20 53 51 New auxiliary SQ
75e0: 4c 20 66 75 6e 63 74 69 6f 6e 73 20 73 70 65 63 L functions spec
75f0: 69 66 69 63 61 6c 6c 79 20 73 75 70 70 6f 72 74 ifically support
7600: 69 6e 67 20 50 52 4f 4a 2e 36 3c 2f 68 33 3e 0d ing PROJ.6</h3>.
7610: 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 .<table cellspac
7620: 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 ing="8" cellpadd
7630: 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 3d ing="8" bgcolor=
7640: 22 23 65 38 66 66 65 38 22 20 62 6f 72 64 65 72 "#e8ffe8" border
7650: 3d 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 ="1">..<tr><th b
7660: 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 gcolor="#ffb03e"
7670: 3e 53 51 4c 20 46 75 6e 63 74 69 6f 6e 3c 2f 74 >SQL Function</t
7680: 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 h><th bgcolor="#
7690: 66 66 62 30 33 65 22 3e 53 75 70 70 6f 72 74 65 ffb03e">Supporte
76a0: 64 20 61 72 67 75 6d 65 6e 74 73 3c 2f 74 68 3e d arguments</th>
76b0: 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 <th bgcolor="#ff
76c0: 62 30 33 65 22 3e 44 65 73 63 72 69 70 74 69 6f b03e">Descriptio
76d0: 6e 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 n</th></tr>..<tr
76e0: 3e 3c 74 64 3e 3c 62 3e 48 61 73 50 72 6f 6a 36 ><td><b>HasProj6
76f0: 3c 2f 62 3e 28 20 3c 69 3e 76 6f 69 64 3c 2f 69 </b>( <i>void</i
7700: 3e 20 29 20 3a 20 3c 69 3e 42 6f 6f 6c 65 61 6e > ) : <i>Boolean
7710: 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4e </i></td>..<td>N
7720: 6f 6e 65 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 one</td>..<td>Wi
7730: 6c 6c 20 72 65 74 75 72 6e 20 3c 62 3e 31 3c 2f ll return <b>1</
7740: 62 3e 20 28 3c 62 3e 54 52 55 45 3c 2f 62 3e 29 b> (<b>TRUE</b>)
7750: 20 69 66 20 74 68 65 20 6c 69 62 72 61 72 79 20 if the library
7760: 68 61 73 20 62 65 65 6e 20 62 75 69 6c 74 20 6f has been built o
7770: 6e 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 20 n <b>PROJ.6</b>
7780: 28 6f 72 20 61 6e 79 20 6c 61 74 65 72 20 76 65 (or any later ve
7790: 72 73 69 6f 6e 29 2c 20 6f 74 68 65 72 77 69 73 rsion), otherwis
77a0: 65 20 3c 62 3e 30 3c 2f 62 3e 20 28 3c 62 3e 46 e <b>0</b> (<b>F
77b0: 41 4c 53 45 3c 2f 62 3e 29 2e 3c 2f 74 64 3e 3c ALSE</b>).</td><
77c0: 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 /tr>..<tr><td><b
77d0: 3e 50 52 4f 4a 5f 47 65 74 4c 61 73 74 45 72 72 >PROJ_GetLastErr
77e0: 6f 72 4d 73 67 3c 2f 62 3e 28 20 3c 69 3e 76 6f orMsg</b>( <i>vo
77f0: 69 64 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 53 74 id</i> ) : <i>St
7800: 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c ring</i></td>..<
7810: 74 64 3e 4e 6f 6e 65 3c 2f 74 64 3e 0d 0a 3c 74 td>None</td>..<t
7820: 64 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 d>Will return th
7830: 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 65 72 e most recent er
7840: 72 6f 72 20 6d 65 73 73 61 67 65 20 72 65 74 75 ror message retu
7850: 72 6e 65 64 20 62 79 20 50 52 4f 4a 20 28 69 66 rned by PROJ (if
7860: 20 61 6e 79 29 2e 3c 62 72 3e 0d 0a 3c 62 3e 4e any).<br>..<b>N
7870: 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 ULL</b> will be
7880: 72 65 74 75 72 6e 65 64 20 69 66 20 74 68 65 72 returned if ther
7890: 65 20 69 73 20 6e 6f 20 63 75 72 65 6e 74 6c 79 e is no curently
78a0: 20 70 65 6e 64 69 6e 67 20 50 52 4f 4a 20 65 72 pending PROJ er
78b0: 72 6f 72 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a ror.</td></tr>..
78c0: 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f <tr><td><b>PROJ_
78d0: 47 65 74 44 61 74 61 62 61 73 65 50 61 74 68 3c GetDatabasePath<
78e0: 2f 62 3e 28 20 3c 69 3e 76 6f 69 64 3c 2f 69 3e /b>( <i>void</i>
78f0: 20 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e : <i>String</i>
7900: 29 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4e 6f 6e 65 )</td>..<td>None
7910: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 </td>..<td>Will
7920: 72 65 74 75 72 6e 20 74 68 65 20 63 75 72 72 65 return the curre
7930: 6e 74 6c 79 20 73 65 74 20 70 61 74 68 6e 61 6d ntly set pathnam
7940: 65 20 6c 65 61 64 69 6e 67 20 74 6f 20 74 68 65 e leading to the
7950: 20 70 72 69 76 61 74 65 20 50 52 4f 4a 27 73 20 private PROJ's
7960: 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 2e SQLite database.
7970: 3c 62 72 3e 0d 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 <br>..<b>NULL</b
7980: 3e 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e > will be return
7990: 65 64 20 69 66 20 74 68 65 72 65 20 69 73 20 6e ed if there is n
79a0: 6f 20 70 72 69 76 61 74 65 20 50 52 4f 4a 27 73 o private PROJ's
79b0: 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 SQLite database
79c0: 20 63 75 72 72 65 6e 74 6c 79 20 63 6f 6e 6e 65 currently conne
79d0: 63 74 65 64 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d cted.</td></tr>.
79e0: 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a .<tr><td><b>PROJ
79f0: 5f 53 65 74 44 61 74 61 62 61 73 65 50 61 74 68 _SetDatabasePath
7a00: 3c 2f 62 3e 20 28 20 6e 65 77 5f 70 61 74 68 20 </b> ( new_path
7a10: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 <i>String</i> )
7a20: 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c : <i>String</i><
7a30: 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a 3c 75 6c 3e /td>..<td>..<ul>
7a40: 0d 0a 3c 6c 69 3e 3c 62 3e 6e 65 77 5f 70 61 74 ..<li><b>new_pat
7a50: 68 3c 2f 62 3e 3a 20 61 20 72 65 6c 61 74 69 76 h</b>: a relativ
7a60: 65 20 6f 72 20 61 62 73 6f 6c 75 74 65 20 70 61 e or absolute pa
7a70: 74 68 6e 61 6d 65 20 6c 65 61 64 69 6e 67 20 74 thname leading t
7a80: 6f 20 61 20 76 61 6c 69 64 20 50 52 4f 4a 27 73 o a valid PROJ's
7a90: 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 SQLite database
7aa0: 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 74 .</li>..</ul></t
7ab0: 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 63 68 61 d>..<td>Will cha
7ac0: 6e 67 65 20 74 68 65 20 63 75 72 72 65 6e 74 6c nge the currentl
7ad0: 79 20 73 65 74 20 70 61 74 68 6e 61 6d 65 20 6c y set pathname l
7ae0: 65 61 64 69 6e 67 20 74 6f 20 74 68 65 20 70 72 eading to the pr
7af0: 69 76 61 74 65 20 50 52 4f 4a 27 73 20 53 51 4c ivate PROJ's SQL
7b00: 69 74 65 20 64 61 74 61 62 61 73 65 2e 3c 62 72 ite database.<br
7b10: 3e 0d 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 >..<b>NULL</b> w
7b20: 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 ill be returned
7b30: 69 66 20 74 68 65 20 70 61 73 73 65 64 20 70 61 if the passed pa
7b40: 74 68 20 69 73 20 69 6e 76 61 6c 69 64 2c 20 6f th is invalid, o
7b50: 74 68 65 72 77 69 73 65 20 74 68 65 20 70 61 74 therwise the pat
7b60: 68 20 6f 66 20 74 68 65 20 63 75 72 72 65 6e 74 h of the current
7b70: 6c 79 20 73 65 74 20 70 72 69 76 61 74 65 20 50 ly set private P
7b80: 52 4f 4a 27 73 20 53 51 4c 69 74 65 20 64 61 74 ROJ's SQLite dat
7b90: 61 62 61 73 65 20 77 69 6c 6c 20 62 65 20 72 65 abase will be re
7ba0: 74 75 72 6e 65 64 2e 3c 2f 74 64 3e 3c 2f 74 72 turned.</td></tr
7bb0: 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 >..<tr><td><b>PR
7bc0: 4f 4a 5f 41 73 57 4b 54 3c 2f 62 3e 20 28 20 61 OJ_AsWKT</b> ( a
7bd0: 75 74 68 5f 6e 61 6d 65 20 3c 69 3e 53 74 72 69 uth_name <i>Stri
7be0: 6e 67 3c 2f 69 3e 20 2c 20 61 75 74 68 5f 73 72 ng</i> , auth_sr
7bf0: 69 64 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 id <i>Integer</i
7c00: 3e 20 29 20 3a 20 3c 69 3e 53 74 72 69 6e 67 3c > ) : <i>String<
7c10: 2f 69 3e 3c 68 72 3e 0d 0a 3c 62 3e 50 52 4f 4a /i><hr>..<b>PROJ
7c20: 5f 41 73 57 4b 54 3c 2f 62 3e 20 28 20 61 75 74 _AsWKT</b> ( aut
7c30: 68 5f 6e 61 6d 65 20 3c 69 3e 53 74 72 69 6e 67 h_name <i>String
7c40: 3c 2f 69 3e 20 2c 20 61 75 74 68 5f 73 72 69 64 </i> , auth_srid
7c50: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 <i>Integer</i>
7c60: 2c 20 77 6b 74 5f 73 74 79 6c 65 20 3c 69 3e 53 , wkt_style <i>S
7c70: 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 tring</i> ) : <i
7c80: 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 68 72 3e 0d >String</i><hr>.
7c90: 0a 3c 62 3e 50 52 4f 4a 5f 41 73 57 4b 54 3c 2f .<b>PROJ_AsWKT</
7ca0: 62 3e 20 28 20 61 75 74 68 5f 6e 61 6d 65 20 3c b> ( auth_name <
7cb0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 61 i>String</i> , a
7cc0: 75 74 68 5f 73 72 69 64 20 3c 69 3e 49 6e 74 65 uth_srid <i>Inte
7cd0: 67 65 72 3c 2f 69 3e 20 2c 20 77 6b 74 5f 73 74 ger</i> , wkt_st
7ce0: 79 6c 65 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 yle <i>String</i
7cf0: 3e 20 2c 20 69 6e 64 65 6e 74 65 64 20 3c 69 3e > , indented <i>
7d00: 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 20 29 20 3a 20 Boolean</i> ) :
7d10: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 68 72 <i>String</i><hr
7d20: 3e 0d 0a 3c 62 3e 50 52 4f 4a 5f 41 73 57 4b 54 >..<b>PROJ_AsWKT
7d30: 3c 2f 62 3e 20 28 20 61 75 74 68 5f 6e 61 6d 65 </b> ( auth_name
7d40: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c <i>String</i> ,
7d50: 20 61 75 74 68 5f 73 72 69 64 20 3c 69 3e 49 6e auth_srid <i>In
7d60: 74 65 67 65 72 3c 2f 69 3e 20 2c 20 77 6b 74 5f teger</i> , wkt_
7d70: 73 74 79 6c 65 20 3c 69 3e 53 74 72 69 6e 67 3c style <i>String<
7d80: 2f 69 3e 20 2c 20 69 6e 64 65 6e 74 65 64 20 3c /i> , indented <
7d90: 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 20 2c 20 i>Boolean</i> ,
7da0: 69 6e 64 65 6e 74 61 74 69 6f 6e 20 3c 69 3e 49 indentation <i>I
7db0: 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c nteger</i> ) : <
7dc0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 i>String</i></td
7dd0: 3e 0d 0a 3c 74 64 3e 3c 75 6c 3e 0d 0a 3c 6c 69 >..<td><ul>..<li
7de0: 3e 3c 62 3e 61 75 74 68 5f 6e 61 6d 65 3c 2f 62 ><b>auth_name</b
7df0: 3e 20 61 6e 64 20 3c 62 3e 61 75 74 68 5f 73 72 > and <b>auth_sr
7e00: 69 64 3c 2f 62 3e 20 69 64 65 6e 74 69 66 79 20 id</b> identify
7e10: 74 68 65 20 69 6e 74 65 6e 64 65 64 20 43 52 53 the intended CRS
7e20: 2e 3c 62 72 3e 0d 0a 3c 62 3e 61 75 74 68 5f 6e .<br>..<b>auth_n
7e30: 61 6d 65 3c 2f 62 3e 20 63 61 6e 20 62 65 20 3c ame</b> can be <
7e40: 62 3e 4e 55 4c 4c 3c 2f 62 3e 2c 20 61 6e 64 20 b>NULL</b>, and
7e50: 69 6e 20 74 68 69 73 20 63 61 73 65 20 3c 62 3e in this case <b>
7e60: 45 50 53 47 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 EPSG</b> will be
7e70: 20 61 73 73 75 6d 65 64 2e 3c 2f 6c 69 3e 0d 0a assumed.</li>..
7e80: 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c <li>the optional
7e90: 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e 73 74 79 argument <b>sty
7ea0: 6c 65 3c 2f 62 3e 20 64 65 74 65 72 6d 69 6e 65 le</b> determine
7eb0: 73 20 77 68 69 63 68 20 73 70 65 63 69 66 69 63 s which specific
7ec0: 20 57 4b 54 20 66 6f 72 6d 61 74 20 73 68 6f 75 WKT format shou
7ed0: 6c 64 20 62 65 20 61 64 6f 70 74 65 64 2c 20 61 ld be adopted, a
7ee0: 6e 64 20 6d 75 73 74 20 62 65 20 6f 6e 65 20 62 nd must be one b
7ef0: 65 74 77 65 65 6e 20 3c 62 3e 47 44 41 4c 3c 2f etween <b>GDAL</
7f00: 62 3e 2c 20 3c 62 3e 45 53 52 49 3c 2f 62 3e 2c b>, <b>ESRI</b>,
7f10: 20 3c 62 3e 49 53 4f 2d 32 30 31 35 3c 2f 62 3e <b>ISO-2015</b>
7f20: 20 6f 72 20 3c 62 3e 49 53 4f 2d 32 30 31 38 3c or <b>ISO-2018<
7f30: 2f 62 3e 20 28 74 68 69 73 20 6c 61 74 74 65 72 /b> (this latter
7f40: 20 62 65 69 6e 67 20 74 68 65 20 64 65 66 61 75 being the defau
7f50: 6c 74 20 73 65 74 74 69 6e 67 29 2e 3c 2f 6c 69 lt setting).</li
7f60: 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f >..<li>the optio
7f70: 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e nal argument <b>
7f80: 69 6e 64 65 6e 74 65 64 3c 2f 62 3e 20 69 66 20 indented</b> if
7f90: 73 65 74 20 74 6f 20 3c 62 3e 54 52 55 45 3c 2f set to <b>TRUE</
7fa0: 62 3e 20 77 69 6c 6c 20 6e 69 63 65 6c 79 20 66 b> will nicely f
7fb0: 6f 72 6d 61 74 20 61 20 6d 75 6c 74 69 6c 69 6e ormat a multilin
7fc0: 65 20 57 4b 54 20 65 78 70 72 65 73 73 69 6f 6e e WKT expression
7fd0: 2c 20 6f 74 68 65 72 77 69 73 65 20 61 20 73 69 , otherwise a si
7fe0: 6e 67 6c 65 20 6d 6f 6e 6f 6c 69 74 68 69 63 20 ngle monolithic
7ff0: 6c 69 6e 65 20 6c 61 63 6b 69 6e 67 20 61 6e 79 line lacking any
8000: 20 77 68 69 74 65 2d 73 70 61 63 65 20 6f 72 20 white-space or
8010: 6e 65 77 2d 6c 69 6e 65 20 77 69 6c 6c 20 62 65 new-line will be
8020: 20 70 72 69 6e 74 65 64 20 28 74 68 65 20 64 65 printed (the de
8030: 66 61 75 6c 74 20 69 73 20 3c 62 3e 54 52 55 45 fault is <b>TRUE
8040: 3c 2f 62 3e 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 </b>).</li>..<li
8050: 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72 >the optional ar
8060: 67 75 6d 65 6e 74 20 3c 62 3e 69 6e 64 65 6e 74 gument <b>indent
8070: 61 74 69 6f 6e 3c 2f 62 3e 20 64 65 74 65 72 6d ation</b> determ
8080: 69 6e 65 73 20 68 6f 77 20 6d 61 6e 79 20 77 68 ines how many wh
8090: 69 74 65 2d 73 70 61 63 65 73 20 61 72 65 20 74 ite-spaces are t
80a0: 6f 20 62 65 20 75 73 65 64 20 66 6f 72 20 69 6e o be used for in
80b0: 64 65 6e 74 69 6e 67 20 28 6f 6e 6c 79 20 6d 65 denting (only me
80c0: 61 6e 69 6e 67 66 75 6c 20 69 66 20 3c 62 3e 3c aningful if <b><
80d0: 69 3e 69 6e 64 65 6e 74 65 64 3d 54 52 55 45 3c i>indented=TRUE<
80e0: 2f 69 3e 3c 2f 62 3e 3b 20 74 68 65 20 64 65 66 /i></b>; the def
80f0: 61 75 6c 74 20 76 61 6c 75 65 73 20 69 73 20 3c ault values is <
8100: 62 3e 34 3c 2f 62 3e 29 2e 3c 2f 6c 69 3e 0d 0a b>4</b>).</li>..
8110: 3c 2f 75 6c 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e </ul></td>..<td>
8120: 57 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 65 20 Will return the
8130: 57 4b 54 20 65 78 70 72 65 73 73 69 6f 6e 20 63 WKT expression c
8140: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 orresponding to
8150: 61 20 67 69 76 65 6e 20 43 52 53 3b 20 74 68 65 a given CRS; the
8160: 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 77 69 6c definitions wil
8170: 6c 20 62 65 20 74 61 6b 65 6e 20 64 69 72 65 63 l be taken direc
8180: 74 6c 79 20 66 72 6f 6d 20 74 68 65 20 70 72 69 tly from the pri
8190: 76 61 74 65 20 50 52 4f 4a 27 73 20 6f 77 6e 20 vate PROJ's own
81a0: 64 61 74 61 62 61 73 65 2e 3c 62 72 3e 0d 0a 3c database.<br>..<
81b0: 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 b>NULL</b> will
81c0: 62 65 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 66 be returned on f
81d0: 61 69 6c 75 72 65 20 6f 72 20 6f 6e 20 69 6e 76 ailure or on inv
81e0: 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 73 2e 3c alid arguments.<
81f0: 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c /td></tr>..<tr><
8200: 74 64 3e 3c 62 3e 50 52 4f 4a 5f 47 75 65 73 73 td><b>PROJ_Guess
8210: 53 72 69 64 46 72 6f 6d 57 4b 54 3c 2f 62 3e 20 SridFromWKT</b>
8220: 28 20 77 6b 74 5f 65 78 70 72 20 3c 69 3e 53 74 ( wkt_expr <i>St
8230: 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e ring</i> ) : <i>
8240: 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 64 3e Integer</i></td>
8250: 0d 0a 3c 74 64 3e 3c 75 6c 3e 0d 0a 3c 6c 69 3e ..<td><ul>..<li>
8260: 3c 62 3e 77 6b 74 5f 65 78 70 72 3c 2f 62 3e 3a <b>wkt_expr</b>:
8270: 20 74 68 65 20 57 4b 54 20 65 78 70 72 65 73 73 the WKT express
8280: 69 6f 6e 20 74 6f 20 62 65 20 65 76 61 6c 75 61 ion to be evalua
8290: 74 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e ted.</li>..</ul>
82a0: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a 57 69 6c </td>..<td>..Wil
82b0: 6c 20 70 6f 73 73 69 62 6c 79 20 72 65 74 75 72 l possibly retur
82c0: 6e 20 74 68 65 20 3c 62 3e 53 52 49 44 20 76 61 n the <b>SRID va
82d0: 6c 75 65 3c 2f 62 3e 20 63 6f 72 72 65 73 70 6f lue</b> correspo
82e0: 6e 64 69 6e 67 20 74 6f 20 61 20 67 69 76 65 6e nding to a given
82f0: 20 57 4b 54 20 65 78 70 72 65 73 73 69 6f 6e 20 WKT expression
8300: 64 65 66 69 6e 69 6e 67 20 61 20 43 52 53 2e 3c defining a CRS.<
8310: 62 72 3e 0d 0a 3c 62 3e 2d 31 3c 2f 62 3e 20 77 br>..<b>-1</b> w
8320: 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 ill be returned
8330: 69 66 20 6e 6f 20 43 52 53 20 73 75 70 70 6f 72 if no CRS suppor
8340: 74 65 64 20 62 79 20 50 52 4f 4a 2e 36 20 6d 61 ted by PROJ.6 ma
8350: 74 63 68 65 73 20 74 68 65 20 57 4b 54 20 65 78 tches the WKT ex
8360: 70 72 65 73 73 69 6f 6e 2e 3c 62 72 3e 0d 0a 3c pression.<br>..<
8370: 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 b>NULL</b> will
8380: 62 65 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 69 be returned on i
8390: 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 2e nvalid argument.
83a0: 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 ..</td></tr>..<t
83b0: 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f 47 75 r><td><b>PROJ_Gu
83c0: 65 73 73 53 72 69 64 46 72 6f 6d 53 48 50 3c 2f essSridFromSHP</
83d0: 62 3e 20 28 20 66 69 6c 65 6e 61 6d 65 20 3c 69 b> ( filename <i
83e0: 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 >String</i> ) :
83f0: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f <i>Integer</i></
8400: 74 64 3e 0d 0a 3c 74 64 3e 3c 75 6c 3e 0d 0a 3c td>..<td><ul>..<
8410: 6c 69 3e 3c 62 3e 66 69 6c 65 6e 61 6d 65 3c 2f li><b>filename</
8420: 62 3e 3a 20 74 68 65 20 61 62 73 6f 6c 75 74 65 b>: the absolute
8430: 20 6f 72 20 72 65 6c 61 74 69 76 65 20 70 61 74 or relative pat
8440: 68 20 6c 65 61 64 69 6e 67 20 74 6f 20 73 6f 6d h leading to som
8450: 65 20 53 68 61 70 65 66 69 6c 65 2e 3c 62 72 3e e Shapefile.<br>
8460: 0d 0a 4e 6f 74 65 3a 20 65 78 61 63 74 6c 65 79 ..Note: exactley
8470: 20 61 73 20 72 65 71 75 69 72 65 64 20 62 79 20 as required by
8480: 3c 62 3e 3c 69 3e 49 6d 70 6f 72 74 53 48 50 3c <b><i>ImportSHP<
8490: 2f 69 3e 3c 2f 62 3e 28 29 20 3c 62 3e 3c 69 3e /i></b>() <b><i>
84a0: 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 3c 2f 62 3e filename</i></b>
84b0: 20 6d 75 73 74 20 6f 6d 69 74 20 61 6e 79 20 3c must omit any <
84c0: 62 3e 2e 73 68 70 3c 2f 62 3e 2c 20 3c 62 3e 2e b>.shp</b>, <b>.
84d0: 73 68 78 3c 2f 62 3e 2c 20 3c 62 3e 2e 64 62 66 shx</b>, <b>.dbf
84e0: 3c 2f 62 3e 20 6f 72 20 3c 62 3e 2e 70 72 6a 3c </b> or <b>.prj<
84f0: 2f 62 3e 20 73 75 66 66 69 78 2e 3c 2f 6c 69 3e /b> suffix.</li>
8500: 0d 0a 3c 2f 75 6c 3e 3c 2f 74 64 3e 0d 0a 3c 74 ..</ul></td>..<t
8510: 64 3e 0d 0a 57 69 6c 6c 20 70 6f 73 73 69 62 6c d>..Will possibl
8520: 79 20 72 65 74 75 72 6e 20 74 68 65 20 3c 62 3e y return the <b>
8530: 53 52 49 44 20 76 61 6c 75 65 3c 2f 62 3e 20 63 SRID value</b> c
8540: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 orresponding to
8550: 74 68 65 20 43 52 53 20 64 65 66 69 6e 65 64 20 the CRS defined
8560: 62 79 20 74 68 65 20 2e 50 52 4a 20 6d 65 6d 62 by the .PRJ memb
8570: 65 72 20 6f 66 20 74 68 65 20 53 68 61 70 65 66 er of the Shapef
8580: 69 6c 65 2e 3c 62 72 3e 0d 0a 3c 62 3e 2d 31 3c ile.<br>..<b>-1<
8590: 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72 65 74 75 /b> will be retu
85a0: 72 6e 65 64 20 69 66 20 6e 6f 20 43 52 53 20 73 rned if no CRS s
85b0: 75 70 70 6f 72 74 65 64 20 62 79 20 50 52 4f 4a upported by PROJ
85c0: 2e 36 20 6d 61 74 63 68 65 73 20 50 52 4a 20 6d .6 matches PRJ m
85d0: 65 6d 62 65 72 20 6f 66 20 74 68 65 20 53 68 61 ember of the Sha
85e0: 70 65 66 69 6c 65 2e 3c 62 72 3e 0d 0a 3c 62 3e pefile.<br>..<b>
85f0: 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 NULL</b> will be
8600: 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 69 6e 76 returned on inv
8610: 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 2e 3c 68 alid argument.<h
8620: 72 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f r>..<u>Please no
8630: 74 65 20 77 65 6c 6c 3c 2f 75 3e 3a 20 74 68 69 te well</u>: thi
8640: 73 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 6f s SQL function o
8650: 70 65 6e 64 20 74 68 65 20 64 6f 6f 72 20 74 6f pend the door to
8660: 20 6d 61 6e 79 20 70 6f 74 65 6e 74 69 61 6c 20 many potential
8670: 73 65 63 75 72 69 74 79 20 69 73 73 75 65 73 2c security issues,
8680: 20 61 6e 64 20 74 68 75 73 20 69 73 20 61 6c 77 and thus is alw
8690: 61 79 73 20 3c 69 3e 64 69 73 61 62 6c 65 64 20 ays <i>disabled
86a0: 62 79 20 64 65 66 61 75 6c 74 3c 2f 69 3e 2e 3c by default</i>.<
86b0: 62 72 3e 0d 0a 45 78 70 6c 69 63 69 74 6c 79 20 br>..Explicitly
86c0: 73 65 74 74 69 6e 67 20 74 68 65 20 65 6e 76 69 setting the envi
86d0: 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 ronment variable
86e0: 20 3c 62 3e 53 50 41 54 49 41 4c 49 54 45 5f 53 <b>SPATIALITE_S
86f0: 45 43 55 52 49 54 59 3d 72 65 6c 61 78 65 64 3c ECURITY=relaxed<
8700: 2f 62 3e 20 69 73 20 61 62 73 6f 6c 75 74 65 6c /b> is absolutel
8710: 79 20 72 65 71 75 69 72 65 64 20 69 6e 20 6f 72 y required in or
8720: 64 65 72 20 74 6f 20 65 6e 61 62 6c 65 20 74 68 der to enable th
8730: 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0d 0a 3c 2f is function...</
8740: 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c td></tr>..</tabl
8750: 65 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 e><br>..<table c
8760: 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 ellspacing="8" c
8770: 65 6c 6c 70 61 64 64 69 6e 67 3d 22 31 36 22 20 ellpadding="16"
8780: 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 39 bgcolor="#ffffe9
8790: 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 62 ">..<tr><td>..<b
87a0: 3e 3c 75 3e 4e 6f 74 65 3c 2f 75 3e 3c 2f 62 3e ><u>Note</u></b>
87b0: 3a 20 61 6c 6c 20 74 68 65 20 61 62 6f 76 65 20 : all the above
87c0: 53 51 4c 20 46 75 6e 63 74 69 6f 6e 73 20 77 69 SQL Functions wi
87d0: 6c 6c 20 62 65 20 61 76 61 69 6c 61 62 6c 65 20 ll be available
87e0: 6f 6e 6c 79 20 77 68 65 6e 20 53 70 61 74 69 61 only when Spatia
87f0: 6c 69 74 65 2d 35 2e 30 2e 30 20 68 61 73 20 62 lite-5.0.0 has b
8800: 65 65 6e 20 62 75 69 6c 74 20 61 67 61 69 6e 73 een built agains
8810: 74 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 20 t <b>PROJ.6</b>
8820: 28 6f 72 20 61 6e 79 20 73 75 62 73 65 71 75 65 (or any subseque
8830: 6e 74 20 76 65 72 73 69 6f 6e 29 2e 3c 62 72 3e nt version).<br>
8840: 0d 0a 49 66 20 53 70 61 74 69 61 4c 69 74 65 2d ..If SpatiaLite-
8850: 35 2e 30 2e 30 20 68 61 73 20 62 65 65 6e 20 62 5.0.0 has been b
8860: 75 69 6c 74 20 69 6e 73 74 65 61 64 20 61 67 61 uilt instead aga
8870: 69 6e 73 74 20 61 6e 79 20 70 72 65 76 69 6f 73 inst any previos
8880: 75 73 20 76 65 72 73 69 6f 6e 20 28 61 73 20 65 us version (as e
8890: 2e 67 2e 20 3c 62 3e 50 52 4f 4a 2e 34 3c 2f 62 .g. <b>PROJ.4</b
88a0: 3e 29 20 61 6e 79 20 61 74 74 65 6d 70 74 20 74 >) any attempt t
88b0: 6f 20 63 61 6c 6c 20 6f 6e 65 20 6f 66 20 74 68 o call one of th
88c0: 65 73 65 20 53 51 4c 20 46 75 6e 63 74 69 6f 6e ese SQL Function
88d0: 73 20 77 69 6c 6c 20 73 69 6d 70 6c 79 20 72 65 s will simply re
88e0: 74 75 72 6e 20 61 20 3c 62 3e 3c 69 3e 3c 75 3e turn a <b><i><u>
88f0: 6e 6f 20 73 75 63 68 20 66 75 6e 63 74 69 6f 6e no such function
8900: 3c 2f 75 3e 3c 2f 69 3e 3c 2f 62 3e 20 53 51 4c </u></i></b> SQL
8910: 20 65 72 72 6f 72 2e 0d 0a 3c 2f 74 64 3e 3c 2f error...</td></
8920: 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 tr>..</table><br
8930: 3e 0d 0a 3c 62 3e 50 72 61 63 74 69 63 61 6c 20 >..<b>Practical
8940: 65 78 61 6d 70 6c 65 73 3a 3c 2f 62 3e 0d 0a 3c examples:</b>..<
8950: 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 verbatim>..SELEC
8960: 54 20 50 52 4f 4a 5f 47 65 74 44 61 74 61 62 61 T PROJ_GetDataba
8970: 73 65 50 61 74 68 28 29 3b 20 20 2d 2d 20 72 65 sePath(); -- re
8980: 74 72 69 65 76 69 6e 67 20 74 68 65 20 63 75 72 trieving the cur
8990: 72 65 6e 74 6c 79 20 73 65 74 20 50 52 4f 4a 27 rently set PROJ'
89a0: 73 20 6f 77 6e 20 64 61 74 61 62 61 73 65 0d 0a s own database..
89b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
89c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a --------------..
89d0: 2f 75 73 72 2f 6c 6f 63 61 6c 2f 73 68 61 72 65 /usr/local/share
89e0: 2f 70 72 6f 6a 2f 70 72 6f 6a 2e 64 62 0d 0a 0d /proj/proj.db...
89f0: 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f 53 65 74 .SELECT PROJ_Set
8a00: 44 61 74 61 62 61 73 65 50 61 74 68 28 27 2f 68 DatabasePath('/h
8a10: 6f 6d 65 2f 73 61 6e 64 72 6f 2f 6e 6f 74 5f 65 ome/sandro/not_e
8a20: 78 69 73 74 69 6e 67 5f 70 72 6f 6a 2e 64 62 27 xisting_proj.db'
8a30: 29 3b 20 2d 2d 20 6e 6f 6e 20 65 78 69 73 74 69 ); -- non existi
8a40: 6e 67 20 64 61 74 61 62 61 73 65 0d 0a 2d 2d 2d ng database..---
8a50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
8a60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 4e 55 4c -----------..NUL
8a70: 4c 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a L....SELECT PROJ
8a80: 5f 47 65 74 4c 61 73 74 45 72 72 6f 72 4d 73 67 _GetLastErrorMsg
8a90: 28 29 3b 20 2d 2d 20 72 65 74 72 69 65 76 69 6e (); -- retrievin
8aa0: 67 20 74 68 65 20 66 61 69 6c 75 72 65 20 63 61 g the failure ca
8ab0: 75 73 65 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d use..-----------
8ac0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
8ad0: 2d 2d 2d 0d 0a 70 72 6f 6a 5f 63 6f 6e 74 65 78 ---..proj_contex
8ae0: 74 5f 73 65 74 5f 64 61 74 61 62 61 73 65 5f 70 t_set_database_p
8af0: 61 74 68 3a 20 4f 70 65 6e 20 6f 66 20 2f 68 6f ath: Open of /ho
8b00: 6d 65 2f 73 61 6e 64 72 6f 2f 6e 6f 74 5f 65 78 me/sandro/not_ex
8b10: 69 73 74 69 6e 67 5f 70 72 6f 6a 2e 64 62 20 66 isting_proj.db f
8b20: 61 69 6c 65 64 0d 0a 0d 0a 53 45 4c 45 43 54 20 ailed....SELECT
8b30: 50 52 4f 4a 5f 53 65 74 44 61 74 61 62 61 73 65 PROJ_SetDatabase
8b40: 50 61 74 68 28 27 2f 68 6f 6d 65 2f 73 61 6e 64 Path('/home/sand
8b50: 72 6f 2f 76 61 6c 69 64 5f 70 72 6f 6a 2e 64 62 ro/valid_proj.db
8b60: 27 29 3b 20 2d 2d 20 76 61 6c 69 64 20 64 61 74 '); -- valid dat
8b70: 61 62 61 73 65 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d abase..---------
8b80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
8b90: 2d 2d 2d 2d 2d 0d 0a 2f 68 6f 6d 65 2f 73 61 6e -----../home/san
8ba0: 64 72 6f 2f 76 61 6c 69 64 5f 70 72 6f 6a 2e 64 dro/valid_proj.d
8bb0: 62 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a b....SELECT PROJ
8bc0: 5f 41 73 57 4b 54 28 27 45 50 53 47 27 2c 20 34 _AsWKT('EPSG', 4
8bd0: 33 32 36 29 3b 20 2d 2d 20 64 65 66 61 75 6c 74 326); -- default
8be0: 20 73 65 74 74 69 6e 67 73 3a 20 49 53 4f 2d 32 settings: ISO-2
8bf0: 30 31 38 20 73 74 79 6c 65 2c 20 69 6e 64 65 6e 018 style, inden
8c00: 74 65 64 20 77 69 74 68 20 69 6e 64 65 6e 74 61 ted with indenta
8c10: 74 69 6f 6e 20 34 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d tion 4..--------
8c20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
8c30: 2d 2d 2d 2d 2d 2d 0d 0a 47 45 4f 44 43 52 53 5b ------..GEODCRS[
8c40: 22 57 47 53 20 38 34 22 2c 0d 0a 20 20 20 20 44 "WGS 84",.. D
8c50: 41 54 55 4d 5b 22 57 6f 72 6c 64 20 47 65 6f 64 ATUM["World Geod
8c60: 65 74 69 63 20 53 79 73 74 65 6d 20 31 39 38 34 etic System 1984
8c70: 22 2c 0d 0a 20 20 20 20 20 20 20 20 45 4c 4c 49 ",.. ELLI
8c80: 50 53 4f 49 44 5b 22 57 47 53 20 38 34 22 2c 36 PSOID["WGS 84",6
8c90: 33 37 38 31 33 37 2c 32 39 38 2e 32 35 37 32 32 378137,298.25722
8ca0: 33 35 36 33 2c 0d 0a 20 20 20 20 20 20 20 20 20 3563,..
8cb0: 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d LENGTHUNIT["m
8cc0: 65 74 72 65 22 2c 31 5d 5d 5d 2c 0d 0a 20 20 20 etre",1]]],..
8cd0: 20 50 52 49 4d 45 4d 5b 22 47 72 65 65 6e 77 69 PRIMEM["Greenwi
8ce0: 63 68 22 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 ch",0,..
8cf0: 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 ANGLEUNIT["degre
8d00: 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 e",0.01745329251
8d10: 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20 43 53 99433]],.. CS
8d20: 5b 65 6c 6c 69 70 73 6f 69 64 61 6c 2c 32 5d 2c [ellipsoidal,2],
8d30: 0d 0a 20 20 20 20 20 20 20 20 41 58 49 53 5b 22 .. AXIS["
8d40: 67 65 6f 64 65 74 69 63 20 6c 61 74 69 74 75 64 geodetic latitud
8d50: 65 20 28 4c 61 74 29 22 2c 6e 6f 72 74 68 2c 0d e (Lat)",north,.
8d60: 0a 20 20 20 20 20 20 20 20 20 20 20 20 4f 52 44 . ORD
8d70: 45 52 5b 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 ER[1],..
8d80: 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 ANGLEUNIT["d
8d90: 65 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 egree",0.0174532
8da0: 39 32 35 31 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 925199433]],..
8db0: 20 20 20 20 20 20 41 58 49 53 5b 22 67 65 6f 64 AXIS["geod
8dc0: 65 74 69 63 20 6c 6f 6e 67 69 74 75 64 65 20 28 etic longitude (
8dd0: 4c 6f 6e 29 22 2c 65 61 73 74 2c 0d 0a 20 20 20 Lon)",east,..
8de0: 20 20 20 20 20 20 20 20 20 4f 52 44 45 52 5b 32 ORDER[2
8df0: 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ],..
8e00: 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 ANGLEUNIT["degre
8e10: 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 e",0.01745329251
8e20: 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20 41 52 99433]],.. AR
8e30: 45 41 5b 22 57 6f 72 6c 64 22 5d 2c 0d 0a 20 20 EA["World"],..
8e40: 20 20 42 42 4f 58 5b 2d 39 30 2c 2d 31 38 30 2c BBOX[-90,-180,
8e50: 39 30 2c 31 38 30 5d 2c 0d 0a 20 20 20 20 49 44 90,180],.. ID
8e60: 5b 22 45 50 53 47 22 2c 34 33 32 36 5d 5d 0d 0a ["EPSG",4326]]..
8e70: 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f 41 73 ..SELECT PROJ_As
8e80: 57 4b 54 28 27 45 50 53 47 27 2c 20 34 33 32 36 WKT('EPSG', 4326
8e90: 2c 20 27 45 53 52 49 27 2c 20 30 2c 20 30 29 3b , 'ESRI', 0, 0);
8ea0: 20 2d 2d 20 45 53 52 49 20 73 74 79 6c 65 2c 20 -- ESRI style,
8eb0: 6d 6f 6e 6f 6c 69 74 68 69 63 20 6c 69 6e 65 0d monolithic line.
8ec0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
8ed0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d ---------------.
8ee0: 0a 47 45 4f 47 43 53 5b 22 47 43 53 5f 57 47 53 .GEOGCS["GCS_WGS
8ef0: 5f 31 39 38 34 22 2c 44 41 54 55 4d 5b 22 44 5f _1984",DATUM["D_
8f00: 57 47 53 5f 31 39 38 34 22 2c 53 50 48 45 52 4f WGS_1984",SPHERO
8f10: 49 44 5b 22 57 47 53 5f 31 39 38 34 22 2c 36 33 ID["WGS_1984",63
8f20: 37 38 31 33 37 2e 30 2c 32 39 38 2e 32 35 37 32 78137.0,298.2572
8f30: 32 33 35 36 33 5d 5d 2c 50 52 49 4d 45 4d 5b 22 23563]],PRIMEM["
8f40: 47 72 65 65 6e 77 69 63 68 22 2c 30 2e 30 5d 2c Greenwich",0.0],
8f50: 55 4e 49 54 5b 22 44 65 67 72 65 65 22 2c 30 2e UNIT["Degree",0.
8f60: 30 31 37 34 35 33 32 39 32 35 31 39 39 34 33 33 0174532925199433
8f70: 5d 5d 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f ]]....SELECT PRO
8f80: 4a 5f 47 75 65 73 73 53 72 69 64 46 72 6f 6d 57 J_GuessSridFromW
8f90: 4b 54 28 27 47 45 4f 47 43 53 5b 22 47 43 53 5f KT('GEOGCS["GCS_
8fa0: 4d 6f 6e 74 65 5f 4d 61 72 69 6f 5f 52 6f 6d 65 Monte_Mario_Rome
8fb0: 22 2c 44 41 54 55 4d 5b 22 44 5f 4d 6f 6e 74 65 ",DATUM["D_Monte
8fc0: 5f 4d 61 72 69 6f 22 2c 53 50 48 45 52 4f 49 44 _Mario",SPHEROID
8fd0: 5b 22 49 6e 74 65 72 6e 61 74 69 6f 6e 61 6c 5f ["International_
8fe0: 31 39 32 34 22 2c 36 33 37 38 33 38 38 2e 30 2c 1924",6378388.0,
8ff0: 32 39 37 2e 30 5d 5d 2c 50 52 49 4d 45 4d 5b 22 297.0]],PRIMEM["
9000: 52 6f 6d 65 22 2c 31 32 2e 34 35 32 33 33 33 33 Rome",12.4523333
9010: 33 33 33 33 33 33 5d 2c 55 4e 49 54 5b 22 44 65 333333],UNIT["De
9020: 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 gree",0.01745329
9030: 32 35 31 39 39 34 33 33 5d 5d 27 29 3b 20 0d 0a 25199433]]'); ..
9040: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9050: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a --------------..
9060: 34 38 30 36 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 4806....SELECT P
9070: 52 4f 4a 5f 47 75 65 73 73 53 72 69 64 46 72 6f ROJ_GuessSridFro
9080: 6d 53 48 50 28 27 2f 68 6f 6d 65 2f 73 61 6e 64 mSHP('/home/sand
9090: 72 6f 2f 74 75 73 63 61 6e 79 5f 73 68 70 2f 70 ro/tuscany_shp/p
90a0: 72 6f 76 32 30 31 31 27 29 3b 20 2d 2d 20 72 65 rov2011'); -- re
90b0: 6d 65 6d 62 65 72 3a 20 72 65 71 75 69 72 65 73 member: requires
90c0: 20 74 6f 20 65 78 70 6c 69 63 69 74 6c 79 20 73 to explicitly s
90d0: 65 74 20 53 50 41 54 49 41 4c 49 54 45 5f 53 45 et SPATIALITE_SE
90e0: 43 55 52 49 54 59 3d 72 65 6c 61 78 65 64 0d 0a CURITY=relaxed..
90f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9100: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a --------------..
9110: 33 30 30 33 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3003..</verbatim
9120: 3e 0d 0a 3c 62 72 3e 0d 0a 3c 68 72 3e 3c 62 72 >..<br>..<hr><br
9130: 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 >..<table cellsp
9140: 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 acing="8" cellpa
9150: 64 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f dding="8" bgcolo
9160: 72 3d 22 23 66 66 65 30 65 39 22 20 77 69 64 74 r="#ffe0e9" widt
9170: 68 3d 22 31 30 30 25 22 3e 0d 0a 3c 74 72 3e 3c h="100%">..<tr><
9180: 74 68 3e 0d 0a 3c 68 31 3e 49 6d 70 6f 72 74 61 th>..<h1>Importa
9190: 6e 74 20 6e 6f 74 69 63 65 20 66 6f 72 20 57 69 nt notice for Wi
91a0: 6e 64 6f 77 73 20 75 73 65 72 73 3c 2f 68 31 3e ndows users</h1>
91b0: 0d 0a 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 ..</th></tr>..<t
91c0: 72 3e 3c 74 64 3e 0d 0a 3c 62 3e 50 52 4f 4a 2e r><td>..<b>PROJ.
91d0: 36 3c 2f 62 3e 20 63 72 69 74 69 63 61 6c 6c 79 6</b> critically
91e0: 20 64 65 70 65 6e 64 73 20 6f 6e 20 69 74 73 20 depends on its
91f0: 6f 77 6e 20 70 72 69 76 61 74 65 20 53 51 4c 69 own private SQLi
9200: 74 65 20 64 61 74 61 62 61 73 65 20 28 3c 62 3e te database (<b>
9210: 70 72 6f 6a 2e 64 62 3c 2f 62 3e 29 20 63 6f 6e proj.db</b>) con
9220: 74 61 69 6e 69 6e 67 20 61 6c 6c 20 72 65 6c 65 taining all rele
9230: 76 61 6e 74 20 64 65 66 69 6e 69 74 69 6f 6e 73 vant definitions
9240: 20 61 62 6f 75 74 20 45 6c 6c 69 70 73 6f 69 64 about Ellipsoid
9250: 73 2c 20 50 72 69 6d 65 20 4d 65 72 69 64 69 61 s, Prime Meridia
9260: 6e 73 2c 20 43 52 53 65 73 2c 20 54 72 61 6e 73 ns, CRSes, Trans
9270: 66 6f 72 6d 61 74 69 6f 6e 73 20 61 6e 64 20 61 formations and a
9280: 6c 69 6b 65 2e 3c 62 72 3e 0d 0a 49 66 20 50 52 like.<br>..If PR
9290: 4f 4a 2e 36 20 69 73 20 75 6e 61 62 6c 65 20 74 OJ.6 is unable t
92a0: 6f 20 63 6f 72 72 65 63 74 6c 79 20 65 73 74 61 o correctly esta
92b0: 62 6c 69 73 68 20 61 20 63 6f 6e 6e 65 63 74 69 blish a connecti
92c0: 6f 6e 20 74 6f 20 74 68 69 73 20 64 61 74 61 62 on to this datab
92d0: 61 73 65 20 69 74 20 77 69 6c 6c 20 62 65 20 73 ase it will be s
92e0: 65 76 65 72 65 6c 79 20 6c 69 6d 69 74 65 64 20 everely limited
92f0: 61 6e 64 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 and will not be
9300: 61 62 6c 65 20 74 6f 20 63 6f 72 72 65 63 74 6c able to correctl
9310: 79 20 62 65 68 61 76 65 20 61 73 20 65 78 70 65 y behave as expe
9320: 63 74 65 64 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c cted.<br><br>..<
9330: 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 3c 75 3e 3c ul>..<li><b><u><
9340: 69 3e 53 68 6f 72 74 20 63 6f 6e 63 6c 75 73 69 i>Short conclusi
9350: 6f 6e 3c 2f 69 3e 3c 2f 75 3e 3c 2f 62 3e 3a 20 on</i></u></b>:
9360: 69 6e 73 74 61 6c 6c 69 6e 67 20 74 68 65 20 73 installing the s
9370: 6f 66 74 77 61 72 65 20 61 6c 6f 6e 65 20 69 73 oftware alone is
9380: 20 6e 6f 74 20 65 6e 6f 75 67 68 2e 3c 62 72 3e not enough.<br>
9390: 0d 0a 54 68 65 20 50 52 4f 4a 2e 36 20 70 72 69 ..The PROJ.6 pri
93a0: 76 61 74 65 20 64 61 74 61 62 61 73 65 20 3c 62 vate database <b
93b0: 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20 6d 75 73 >proj.db</b> mus
93c0: 74 20 62 65 20 70 72 6f 70 65 72 6c 79 20 69 6e t be properly in
93d0: 73 74 61 6c 6c 65 64 20 61 73 20 77 65 6c 6c 2c stalled as well,
93e0: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 65 6e 73 in order to ens
93f0: 75 72 65 20 74 68 61 74 20 61 6e 79 74 68 69 6e ure that anythin
9400: 67 20 72 75 6e 73 20 73 6d 6f 6f 74 68 6c 79 2e g runs smoothly.
9410: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e </li>..</ul><br>
9420: 0d 0a 54 68 69 73 20 69 73 6e 27 74 20 75 73 75 ..This isn't usu
9430: 61 6c 6c 79 20 61 20 62 69 67 20 69 73 73 75 65 ally a big issue
9440: 20 6f 6e 20 4c 69 6e 75 78 20 61 6e 64 20 55 6e on Linux and Un
9450: 69 78 2d 6c 69 6b 65 20 70 6c 61 74 66 6f 72 6d ix-like platform
9460: 73 2c 20 77 68 65 72 65 20 61 20 72 61 74 69 6f s, where a ratio
9470: 6e 61 6c 20 61 6e 64 20 76 65 72 79 20 63 6c 65 nal and very cle
9480: 61 72 20 66 69 6c 65 73 79 73 74 65 6d 20 6c 61 ar filesystem la
9490: 79 6f 75 74 20 65 78 69 73 74 73 2e 3c 62 72 3e yout exists.<br>
94a0: 0d 0a 4f 6e 20 74 68 65 73 65 20 6f 70 65 72 61 ..On these opera
94b0: 74 69 6e 67 20 73 79 73 74 65 6d 73 20 74 68 65 ting systems the
94c0: 20 70 61 63 6b 61 67 65 20 6d 61 6e 61 67 65 72 package manager
94d0: 20 28 6f 72 20 3c 62 3e 6d 61 6b 65 20 69 6e 73 (or <b>make ins
94e0: 74 61 6c 6c 3c 2f 62 3e 29 20 77 69 6c 6c 20 61 tall</b>) will a
94f0: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 74 61 6b utomatically tak
9500: 65 20 63 61 72 65 20 74 6f 20 69 6e 73 74 61 6c e care to instal
9510: 6c 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e l <b>proj.db</b>
9520: 20 6f 6e 20 74 68 65 20 6d 6f 73 74 20 61 70 70 on the most app
9530: 72 6f 70 72 69 61 74 65 20 64 69 72 65 63 74 6f ropriate directo
9540: 72 79 20 28 75 73 75 61 6c 6c 79 20 61 73 20 3c ry (usually as <
9550: 62 3e 2f 75 73 72 2f 73 68 61 72 65 2f 70 72 6f b>/usr/share/pro
9560: 6a 2f 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20 6f 72 j/proj.db</b> or
9570: 20 61 73 20 3c 62 3e 2f 75 73 72 2f 6c 6f 63 61 as <b>/usr/loca
9580: 6c 2f 73 68 61 72 65 2f 70 72 6f 6a 2f 70 72 6f l/share/proj/pro
9590: 6a 2e 64 62 3c 2f 62 3e 29 20 61 6e 64 20 74 68 j.db</b>) and th
95a0: 61 74 27 73 20 61 6c 6c 2e 3c 62 72 3e 3c 62 72 at's all.<br><br
95b0: 3e 0d 0a 54 68 69 6e 67 73 20 61 72 65 20 75 6e >..Things are un
95c0: 68 61 70 70 69 6c 79 20 61 20 6c 69 74 74 6c 65 happily a little
95d0: 20 62 69 74 20 6d 6f 72 65 20 64 69 66 66 69 63 bit more diffic
95e0: 75 6c 74 73 20 6f 6e 20 57 69 6e 64 6f 77 73 20 ults on Windows
95f0: 70 6c 61 74 66 6f 72 6d 73 2e 0d 0a 54 68 65 20 platforms...The
9600: 75 73 65 72 20 69 74 73 65 6c 66 20 69 73 20 72 user itself is r
9610: 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 70 esponsible for p
9620: 72 6f 70 65 72 6c 79 20 69 6e 73 74 61 6c 6c 69 roperly installi
9630: 6e 67 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 ng <b>proj.db</b
9640: 3e 0d 0a 53 6f 20 69 74 20 62 65 63 6f 6d 65 73 >..So it becomes
9650: 20 63 72 69 74 69 63 61 6c 20 75 6e 64 65 72 73 critical unders
9660: 74 61 6e 64 69 6e 67 20 74 68 65 20 62 61 73 69 tanding the basi
9670: 63 20 72 75 6c 65 73 20 61 64 6f 70 74 65 64 20 c rules adopted
9680: 62 79 20 3c 62 3e 6c 69 62 73 70 61 74 69 61 6c by <b>libspatial
9690: 69 74 65 3c 2f 62 3e 20 69 6e 20 6f 72 64 65 72 ite</b> in order
96a0: 20 74 6f 20 70 72 6f 70 65 72 6c 79 20 6c 6f 63 to properly loc
96b0: 61 74 65 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f ate <b>proj.db</
96c0: 62 3e 20 6f 6e 20 57 69 6e 64 6f 77 73 2e 0d 0a b> on Windows...
96d0: 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e </td></tr>..<tr>
96e0: 3c 74 68 3e 0d 0a 3c 68 32 3e 57 68 65 72 65 20 <th>..<h2>Where
96f0: 70 72 6f 6a 2e 64 62 20 69 73 20 65 78 70 65 63 proj.db is expec
9700: 74 65 64 20 74 6f 20 62 65 20 66 6f 75 6e 64 20 ted to be found
9710: 6f 6e 20 57 69 6e 64 6f 77 73 3c 2f 68 32 3e 0d on Windows</h2>.
9720: 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 .</td></tr>..<tr
9730: 3e 3c 74 64 3e 0d 0a 3c 6f 6c 3e 0d 0a 3c 6c 69 ><td>..<ol>..<li
9740: 3e 74 68 65 20 66 69 72 73 74 20 70 6c 61 63 65 >the first place
9750: 20 77 68 65 72 65 20 3c 62 3e 70 72 6f 6a 2e 64 where <b>proj.d
9760: 62 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 73 65 b</b> will be se
9770: 61 72 63 68 65 64 20 69 73 20 74 68 65 20 73 61 arched is the sa
9780: 6d 65 20 66 6f 6c 64 65 72 20 66 6f 72 6d 20 77 me folder form w
9790: 68 65 72 65 20 74 68 65 20 3c 62 3e 45 58 45 3c here the <b>EXE<
97a0: 2f 62 3e 20 62 69 6e 61 72 79 20 77 61 73 20 69 /b> binary was i
97b0: 6e 69 74 69 61 6c 6c 79 20 6c 6f 61 64 65 64 2e nitially loaded.
97c0: 3c 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 45 78 61 6d <br>..<i><u>Exam
97d0: 70 6c 65 3c 2f 69 3e 3c 2f 75 3e 3a 20 61 73 73 ple</i></u>: ass
97e0: 75 6d 69 6e 67 20 74 68 61 74 20 79 6f 75 20 61 uming that you a
97f0: 72 65 20 63 75 72 72 65 6e 74 6c 79 20 65 78 65 re currently exe
9800: 63 75 74 69 6e 67 20 3c 62 3e 43 3a 5c 6d 79 70 cuting <b>C:\myp
9810: 72 6f 67 73 5c 73 70 61 74 69 61 6c 69 74 65 5c rogs\spatialite\
9820: 62 69 6e 5c 73 70 61 74 69 61 6c 69 74 65 2e 65 bin\spatialite.e
9830: 78 65 3c 2f 62 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c xe</b>..<ul>..<l
9840: 69 3e 74 68 65 6e 20 61 6e 20 61 74 74 65 6d 70 i>then an attemp
9850: 74 20 77 69 6c 6c 20 62 65 20 6d 61 64 65 20 74 t will be made t
9860: 6f 20 63 6f 6e 6e 65 63 74 20 3c 62 3e 43 3a 5c o connect <b>C:\
9870: 6d 79 70 72 6f 67 73 5c 73 70 61 74 69 61 6c 69 myprogs\spatiali
9880: 74 65 5c 62 69 6e 5c 70 72 6f 6a 2e 64 62 3c 2f te\bin\proj.db</
9890: 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f b></li>..</ul></
98a0: 6c 69 3e 0d 0a 3c 6c 69 3e 61 20 73 65 63 6f 6e li>..<li>a secon
98b0: 64 20 61 74 74 65 6d 70 74 20 77 69 6c 6c 20 62 d attempt will b
98c0: 65 20 6d 61 64 65 20 6f 6e 20 62 65 68 61 6c 66 e made on behalf
98d0: 20 6f 66 20 74 68 65 20 3c 62 3e 50 75 62 6c 69 of the <b>Publi
98e0: 63 3c 2f 62 3e 20 66 6f 6c 64 65 72 2e 3c 62 72 c</b> folder.<br
98f0: 3e 0d 0a 3c 69 3e 3c 75 3e 45 78 61 6d 70 6c 65 >..<i><u>Example
9900: 3c 2f 75 3e 3c 2f 69 3e 3a 20 61 6e 20 61 74 74 </u></i>: an att
9910: 65 6d 70 74 20 77 69 6c 6c 20 62 65 20 6d 61 64 empt will be mad
9920: 65 20 74 6f 20 63 6f 6e 6e 65 63 74 20 3c 62 3e e to connect <b>
9930: 43 3a 5c 55 73 65 72 73 5c 50 75 62 6c 69 63 5c C:\Users\Public\
9940: 73 70 61 74 69 61 6c 69 74 65 5c 70 72 6f 6a 5c spatialite\proj\
9950: 70 72 6f 6a 2e 64 62 3c 2f 62 3e 3c 2f 6c 69 3e proj.db</b></li>
9960: 0d 0a 3c 6c 69 3e 61 20 74 68 69 72 64 20 28 61 ..<li>a third (a
9970: 6e 64 20 6c 61 73 74 29 20 61 74 74 65 6d 70 74 nd last) attempt
9980: 20 77 69 6c 6c 20 62 65 20 6d 61 64 65 20 6f 6e will be made on
9990: 20 62 65 68 61 6c 66 20 6f 66 20 74 68 65 20 3c behalf of the <
99a0: 62 3e 55 73 65 72 3c 2f 62 3e 20 66 6f 6c 64 65 b>User</b> folde
99b0: 72 2e 3c 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 45 78 r.<br>..<i><u>Ex
99c0: 61 6d 70 6c 65 3c 2f 69 3e 3c 2f 75 3e 3a 20 61 ample</i></u>: a
99d0: 6e 20 61 74 74 65 6d 70 74 20 77 69 6c 6c 20 62 n attempt will b
99e0: 65 20 6d 61 64 65 20 74 6f 20 63 6f 6e 6e 65 63 e made to connec
99f0: 74 20 3c 62 3e 43 3a 5c 55 73 65 72 73 5c 73 61 t <b>C:\Users\sa
9a00: 6e 64 72 6f 5c 73 70 61 74 69 61 6c 69 74 65 5c ndro\spatialite\
9a10: 70 72 6f 6a 5c 70 72 6f 6a 2e 64 62 3c 2f 62 3e proj\proj.db</b>
9a20: 3c 2f 6c 69 3e 0d 0a 3c 2f 6f 6c 3e 0d 0a 3c 68 </li>..</ol>..<h
9a30: 33 3e 41 6e 20 75 73 65 66 75 6c 20 64 69 61 67 3>An useful diag
9a40: 6e 6f 73 74 69 63 20 63 68 65 63 6b 3c 2f 68 33 nostic check</h3
9a50: 3e 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 >..<verbatim>..S
9a60: 45 4c 45 43 54 20 50 52 4f 4a 5f 47 65 74 44 61 ELECT PROJ_GetDa
9a70: 74 61 62 61 73 65 50 61 74 68 28 29 3b 0d 0a 3c tabasePath();..<
9a80: 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 3c 75 6c 3e /verbatim>..<ul>
9a90: 0d 0a 3c 6c 69 3e 69 66 20 3c 62 3e 4e 55 4c 4c ..<li>if <b>NULL
9aa0: 3c 2f 62 3e 20 69 73 20 72 65 74 75 72 6e 65 64 </b> is returned
9ab0: 2c 20 74 68 65 6e 20 50 52 4f 4a 2e 36 20 69 73 , then PROJ.6 is
9ac0: 20 64 65 66 69 6e 69 74 65 6c 79 20 75 6e 61 62 definitely unab
9ad0: 6c 65 20 74 6f 20 63 6f 6e 6e 65 63 74 20 74 6f le to connect to
9ae0: 20 69 74 73 20 6f 77 6e 20 70 72 69 76 61 74 65 its own private
9af0: 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 SQLite database
9b00: 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e 3c <b>proj.db</b><
9b10: 62 72 3e 0d 0a 59 6f 75 20 68 61 76 65 20 74 6f br>..You have to
9b20: 20 63 61 72 65 66 75 6c 6c 79 20 76 65 72 69 66 carefully verif
9b30: 69 79 20 74 68 61 74 20 69 74 27 73 20 72 65 61 iy that it's rea
9b40: 6c 6c 79 20 69 6e 73 74 61 6c 6c 65 64 20 6f 6e lly installed on
9b50: 20 6f 6e 65 20 6f 66 20 74 68 65 20 65 78 70 65 one of the expe
9b60: 63 74 65 64 20 73 74 61 6e 64 61 72 64 20 6c 6f cted standard lo
9b70: 63 61 74 69 6f 6e 73 2e 3c 2f 6c 69 3e 0d 0a 3c cations.</li>..<
9b80: 6c 69 3e 6f 74 68 65 72 77 69 73 65 20 74 68 65 li>otherwise the
9b90: 20 70 61 74 68 20 6c 65 61 64 69 6e 67 20 74 6f path leading to
9ba0: 20 74 68 65 20 63 75 72 72 65 6e 74 6c 79 20 63 the currently c
9bb0: 6f 6e 6e 65 63 74 65 64 20 3c 62 3e 70 72 6f 6a onnected <b>proj
9bc0: 2e 64 62 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 .db</b> will be
9bd0: 72 65 74 75 72 6e 65 64 2e 3c 2f 6c 69 3e 0d 0a returned.</li>..
9be0: 3c 2f 75 6c 3e 3c 62 72 3e 0d 0a 3c 2f 74 64 3e </ul><br>..</td>
9bf0: 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c </tr>..</table><
9c00: 62 72 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 br><br>..<table
9c10: 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 cellspacing="8"
9c20: 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 38 22 20 cellpadding="8"
9c30: 62 67 63 6f 6c 6f 72 3d 22 23 63 39 66 66 66 30 bgcolor="#c9fff0
9c40: 22 20 77 69 64 74 68 3d 22 31 30 30 25 22 3e 0d " width="100%">.
9c50: 0a 3c 74 72 3e 3c 74 68 3e 0d 0a 3c 68 32 3e 55 .<tr><th>..<h2>U
9c60: 73 69 6e 67 20 74 68 65 20 65 6e 76 69 72 6f 6e sing the environ
9c70: 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 53 50 ment variable SP
9c80: 41 54 49 41 4c 49 54 45 5f 50 52 4f 4a 5f 44 42 ATIALITE_PROJ_DB
9c90: 5f 50 41 54 48 3c 2f 68 32 3e 0d 0a 3c 2f 74 68 _PATH</h2>..</th
9ca0: 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e ></tr>..<tr><td>
9cb0: 0d 0a 49 66 20 74 68 65 20 65 6e 76 69 72 6f 6e ..If the environ
9cc0: 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 3c 62 ment variable <b
9cd0: 3e 53 50 41 54 49 41 4c 49 54 45 5f 50 52 4f 4a >SPATIALITE_PROJ
9ce0: 5f 44 42 5f 50 41 54 48 3c 2f 62 3e 20 69 73 20 _DB_PATH</b> is
9cf0: 73 65 74 2c 20 74 68 65 6e 20 3c 62 3e 6c 69 62 set, then <b>lib
9d00: 73 70 61 74 69 61 6c 69 74 65 3c 2f 62 3e 20 77 spatialite</b> w
9d10: 69 6c 6c 20 73 69 6d 70 6c 79 20 61 74 74 65 6d ill simply attem
9d20: 70 74 20 74 6f 20 63 6f 6e 6e 65 63 74 20 74 68 pt to connect th
9d30: 65 20 64 61 74 61 62 61 73 65 20 70 6f 69 6e 74 e database point
9d40: 65 64 20 62 79 20 74 68 69 73 20 76 61 72 69 61 ed by this varia
9d50: 62 6c 65 2e 3c 62 72 3e 0d 0a 53 75 63 68 20 61 ble.<br>..Such a
9d60: 20 63 61 70 61 62 69 6c 69 74 79 20 69 73 20 73 capability is s
9d70: 75 70 70 6f 72 74 65 64 20 6e 6f 74 20 6f 6e 6c upported not onl
9d80: 79 20 6f 6e 20 57 69 6e 64 6f 77 73 20 62 75 74 y on Windows but
9d90: 20 61 6c 73 6f 20 6f 6e 20 4c 69 6e 75 78 20 28 also on Linux (
9da0: 61 6e 64 20 6f 6e 20 61 6e 79 20 6f 74 68 65 72 and on any other
9db0: 20 70 6c 61 74 66 6f 72 6d 29 2e 3c 62 72 3e 3c platform).<br><
9dc0: 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 4c 69 6e 75 78 br>..<i><u>Linux
9dd0: 20 65 78 61 6d 70 6c 65 3c 2f 75 3e 3c 2f 69 3e example</u></i>
9de0: 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e :..<ul>..<li><b>
9df0: 65 78 70 6f 72 74 20 22 53 50 41 54 49 41 4c 49 export "SPATIALI
9e00: 54 45 5f 50 52 4f 4a 5f 44 42 5f 50 41 54 48 3d TE_PROJ_DB_PATH=
9e10: 2f 68 6f 6d 65 2f 73 61 6e 64 72 6f 2f 61 75 78 /home/sandro/aux
9e20: 2f 70 72 6f 6a 2e 64 62 22 3c 62 72 3e 0d 0a 65 /proj.db"<br>..e
9e30: 63 68 6f 20 24 53 50 41 54 49 41 4c 49 54 45 5f cho $SPATIALITE_
9e40: 50 52 4f 4a 5f 44 42 5f 50 41 54 48 3c 62 72 3e PROJ_DB_PATH<br>
9e50: 0d 0a 73 70 61 74 69 61 6c 69 74 65 3c 62 3e 3c ..spatialite<b><
9e60: 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 3c /li>..</ul><br><
9e70: 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 57 69 6e 64 6f br>..<i><u>Windo
9e80: 77 73 20 65 78 61 6d 70 6c 65 3c 2f 75 3e 3c 2f ws example</u></
9e90: 69 3e 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c i>:..<ul>..<li><
9ea0: 62 3e 53 45 54 20 53 50 41 54 49 41 4c 49 54 45 b>SET SPATIALITE
9eb0: 5f 50 52 4f 4a 5f 44 42 5f 50 41 54 48 3d 43 3a _PROJ_DB_PATH=C:
9ec0: 5c 55 73 65 72 73 5c 73 61 6e 64 72 6f 5c 61 75 \Users\sandro\au
9ed0: 78 5c 70 72 6f 6a 2e 64 62 3c 62 72 3e 0d 0a 65 x\proj.db<br>..e
9ee0: 63 68 6f 20 25 53 50 41 54 49 41 4c 49 54 45 5f cho %SPATIALITE_
9ef0: 50 52 4f 4a 5f 44 42 5f 50 41 54 48 25 3c 62 72 PROJ_DB_PATH%<br
9f00: 3e 0d 0a 73 70 61 74 69 61 6c 69 74 65 5f 67 75 >..spatialite_gu
9f10: 69 3c 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e i<b></li>..</ul>
9f20: 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 2f 74 68 3e 3c <br><br>..</th><
9f30: 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 /tr>..</table><b
9f40: 72 3e 0d 0a 3c 68 72 3e 3c 62 72 3e 0d 0a 3c 61 r>..<hr><br>..<a
9f50: 20 68 72 65 66 3d 22 68 74 74 70 73 3a 2f 2f 77 href="https://w
9f60: 77 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 2f 66 ww.gaia-gis.it/f
9f70: 6f 73 73 69 6c 2f 6c 69 62 73 70 61 74 69 61 6c ossil/libspatial
9f80: 69 74 65 2f 77 69 6b 69 3f 6e 61 6d 65 3d 34 2e ite/wiki?name=4.
9f90: 33 2e 30 2d 64 6f 63 22 3e 62 61 63 6b 3c 2f 61 3.0-doc">back</a
9fa0: 3e 0a 5a 20 64 62 32 35 30 33 35 37 35 65 61 31 >.Z db2503575ea1
9fb0: 30 30 30 64 30 39 38 61 66 63 61 33 61 36 31 61 000d098afca3a61a
9fc0: 65 32 35 36 0a e256.