0000: 44 20 32 30 31 39 2d 30 35 2d 30 38 54 31 36 3a D 2019-05-08T16:
0010: 32 30 3a 32 35 2e 37 30 32 0a 4c 20 50 52 4f 4a 20:25.702.L PROJ
0020: 2e 36 0a 50 20 37 30 61 34 66 63 64 31 33 37 62 .6.P 70a4fcd137b
0030: 63 35 30 33 35 62 30 30 64 65 32 35 31 39 62 64 c5035b00de2519bd
0040: 39 31 35 62 31 37 38 30 39 30 34 31 35 0a 55 20 915b178090415.U
0050: 73 61 6e 64 72 6f 0a 57 20 33 37 34 34 32 0a 3c sandro.W 37442.<
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 65 63 61 6d 65 20 74 68 65 erdam became 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 6d 6f 72 65 20 72 65 63 65 6e 74 20 49 53 e more recent IS
1430: 4f 20 57 4b 54 20 6e 6f 74 61 74 69 6f 6e 3a 0d O WKT notation:.
1440: 0a 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c .<br><br>..<tabl
1450: 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 e cellspacing="8
1460: 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 38 " cellpadding="8
1470: 22 20 62 67 63 6f 6c 6f 72 3d 22 23 65 38 66 66 " bgcolor="#e8ff
1480: 65 38 22 20 62 6f 72 64 65 72 3d 22 31 22 3e 0d e8" border="1">.
1490: 0a 3c 74 72 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 .<tr><th bgcolor
14a0: 3d 22 23 66 66 62 30 33 65 22 3e 53 52 49 44 3c ="#ffb03e">SRID<
14b0: 2f 74 68 3e 3c 74 64 3e 33 30 30 33 3c 2f 74 64 /th><td>3003</td
14c0: 3e 3c 74 64 3e 34 33 32 36 3c 2f 74 64 3e 3c 74 ><td>4326</td><t
14d0: 64 3e 33 32 36 33 32 3c 2f 74 64 3e 3c 2f 74 72 d>32632</td></tr
14e0: 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 67 63 6f 6c >..<tr><th bgcol
14f0: 6f 72 3d 22 23 66 66 62 30 33 65 22 3e 43 52 53 or="#ffb03e">CRS
1500: 20 4e 61 6d 65 3c 2f 74 68 3e 3c 74 64 3e 4d 6f Name</th><td>Mo
1510: 6e 74 65 20 4d 61 72 69 6f 20 2f 20 49 74 61 6c nte Mario / Ital
1520: 79 20 7a 6f 6e 65 20 31 3c 2f 74 64 3e 3c 2f 74 y zone 1</td></t
1530: 64 3e 3c 74 64 3e 57 47 53 20 38 34 3c 2f 74 64 d><td>WGS 84</td
1540: 3e 3c 74 64 3e 57 47 53 20 38 34 20 2f 20 55 54 ><td>WGS 84 / UT
1550: 4d 20 7a 6f 6e 65 20 33 32 4e 3c 2f 74 64 3e 3c M zone 32N</td><
1560: 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 67 /tr>..<tr><th bg
1570: 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 3e color="#ffb03e">
1580: 49 53 4f 2d 32 30 31 38 20 57 4b 54 3c 2f 74 68 ISO-2018 WKT</th
1590: 3e 0d 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 >..<td valign="t
15a0: 6f 70 22 3e 3c 76 65 72 62 61 74 69 6d 3e 0d 0a op"><verbatim>..
15b0: 50 52 4f 4a 43 52 53 5b 22 4d 6f 6e 74 65 20 4d PROJCRS["Monte M
15c0: 61 72 69 6f 20 2f 20 49 74 61 6c 79 20 7a 6f 6e ario / Italy zon
15d0: 65 20 31 22 2c 0d 0a 20 20 20 20 42 41 53 45 47 e 1",.. BASEG
15e0: 45 4f 44 43 52 53 5b 22 4d 6f 6e 74 65 20 4d 61 EODCRS["Monte Ma
15f0: 72 69 6f 22 2c 0d 0a 20 20 20 20 20 20 20 20 44 rio",.. D
1600: 41 54 55 4d 5b 22 4d 6f 6e 74 65 20 4d 61 72 69 ATUM["Monte Mari
1610: 6f 22 2c 3c 62 72 3e 0d 0a 20 20 20 20 20 20 20 o",<br>..
1620: 20 20 20 20 20 45 4c 4c 49 50 53 4f 49 44 5b 22 ELLIPSOID["
1630: 49 6e 74 65 72 6e 61 74 69 6f 6e 61 6c 20 31 39 International 19
1640: 32 34 22 2c 36 33 37 38 33 38 38 2c 32 39 37 2c 24",6378388,297,
1650: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
1660: 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 LENGTHUNIT["me
1670: 74 72 65 22 2c 31 5d 5d 5d 2c 0d 0a 20 20 20 20 tre",1]]],..
1680: 20 20 20 20 50 52 49 4d 45 4d 5b 22 47 72 65 65 PRIMEM["Gree
1690: 6e 77 69 63 68 22 2c 30 2c 0d 0a 20 20 20 20 20 nwich",0,..
16a0: 20 20 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 ANGLEUNIT
16b0: 5b 22 64 65 67 72 65 65 22 2c 30 2e 30 31 37 34 ["degree",0.0174
16c0: 35 33 32 39 32 35 31 39 39 34 33 33 5d 5d 5d 2c 532925199433]]],
16d0: 0d 0a 20 20 20 20 43 4f 4e 56 45 52 53 49 4f 4e .. CONVERSION
16e0: 5b 22 49 74 61 6c 79 20 7a 6f 6e 65 20 31 22 2c ["Italy zone 1",
16f0: 0d 0a 20 20 20 20 20 20 20 20 4d 45 54 48 4f 44 .. METHOD
1700: 5b 22 54 72 61 6e 73 76 65 72 73 65 20 4d 65 72 ["Transverse Mer
1710: 63 61 74 6f 72 22 2c 0d 0a 20 20 20 20 20 20 20 cator",..
1720: 20 20 20 20 20 49 44 5b 22 45 50 53 47 22 2c 39 ID["EPSG",9
1730: 38 30 37 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 807]],..
1740: 50 41 52 41 4d 45 54 45 52 5b 22 4c 61 74 69 74 PARAMETER["Latit
1750: 75 64 65 20 6f 66 20 6e 61 74 75 72 61 6c 20 6f ude of natural o
1760: 72 69 67 69 6e 22 2c 30 2c 0d 0a 20 20 20 20 20 rigin",0,..
1770: 20 20 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 ANGLEUNIT
1780: 5b 22 64 65 67 72 65 65 22 2c 30 2e 30 31 37 34 ["degree",0.0174
1790: 35 33 32 39 32 35 31 39 39 34 33 33 5d 2c 0d 0a 532925199433],..
17a0: 20 20 20 20 20 20 20 20 20 20 20 20 49 44 5b 22 ID["
17b0: 45 50 53 47 22 2c 38 38 30 31 5d 5d 2c 0d 0a 20 EPSG",8801]],..
17c0: 20 20 20 20 20 20 20 50 41 52 41 4d 45 54 45 52 PARAMETER
17d0: 5b 22 4c 6f 6e 67 69 74 75 64 65 20 6f 66 20 6e ["Longitude of n
17e0: 61 74 75 72 61 6c 20 6f 72 69 67 69 6e 22 2c 39 atural origin",9
17f0: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 41 ,.. A
1800: 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 65 NGLEUNIT["degree
1810: 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 39 ",0.017453292519
1820: 39 34 33 33 5d 2c 0d 0a 20 20 20 20 20 20 20 20 9433],..
1830: 20 20 20 20 49 44 5b 22 45 50 53 47 22 2c 38 38 ID["EPSG",88
1840: 30 32 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 02]],.. P
1850: 41 52 41 4d 45 54 45 52 5b 22 53 63 61 6c 65 20 ARAMETER["Scale
1860: 66 61 63 74 6f 72 20 61 74 20 6e 61 74 75 72 61 factor at natura
1870: 6c 20 6f 72 69 67 69 6e 22 2c 30 2e 39 39 39 36 l origin",0.9996
1880: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 53 ,.. S
1890: 43 41 4c 45 55 4e 49 54 5b 22 75 6e 69 74 79 22 CALEUNIT["unity"
18a0: 2c 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 ,1],..
18b0: 20 20 49 44 5b 22 45 50 53 47 22 2c 38 38 30 35 ID["EPSG",8805
18c0: 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 41 52 ]],.. PAR
18d0: 41 4d 45 54 45 52 5b 22 46 61 6c 73 65 20 65 61 AMETER["False ea
18e0: 73 74 69 6e 67 22 2c 31 35 30 30 30 30 30 2c 0d sting",1500000,.
18f0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 4c 45 4e . LEN
1900: 47 54 48 55 4e 49 54 5b 22 6d 65 74 72 65 22 2c GTHUNIT["metre",
1910: 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 1],..
1920: 20 49 44 5b 22 45 50 53 47 22 2c 38 38 30 36 5d ID["EPSG",8806]
1930: 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 41 52 41 ],.. PARA
1940: 4d 45 54 45 52 5b 22 46 61 6c 73 65 20 6e 6f 72 METER["False nor
1950: 74 68 69 6e 67 22 2c 30 2c 0d 0a 20 20 20 20 20 thing",0,..
1960: 20 20 20 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 LENGTHUNI
1970: 54 5b 22 6d 65 74 72 65 22 2c 31 5d 2c 0d 0a 20 T["metre",1],..
1980: 20 20 20 20 20 20 20 20 20 20 20 49 44 5b 22 45 ID["E
1990: 50 53 47 22 2c 38 38 30 37 5d 5d 5d 2c 0d 0a 20 PSG",8807]]],..
19a0: 20 20 20 43 53 5b 43 61 72 74 65 73 69 61 6e 2c CS[Cartesian,
19b0: 32 5d 2c 0d 0a 20 20 20 20 20 20 20 20 41 58 49 2],.. AXI
19c0: 53 5b 22 65 61 73 74 69 6e 67 20 28 58 29 22 2c S["easting (X)",
19d0: 65 61 73 74 2c 0d 0a 20 20 20 20 20 20 20 20 20 east,..
19e0: 20 20 20 4f 52 44 45 52 5b 31 5d 2c 0d 0a 20 20 ORDER[1],..
19f0: 20 20 20 20 20 20 20 20 20 20 4c 45 4e 47 54 48 LENGTH
1a00: 55 4e 49 54 5b 22 6d 65 74 72 65 22 2c 31 5d 5d UNIT["metre",1]]
1a10: 2c 0d 0a 20 20 20 20 20 20 20 20 41 58 49 53 5b ,.. AXIS[
1a20: 22 6e 6f 72 74 68 69 6e 67 20 28 59 29 22 2c 6e "northing (Y)",n
1a30: 6f 72 74 68 2c 0d 0a 20 20 20 20 20 20 20 20 20 orth,..
1a40: 20 20 20 4f 52 44 45 52 5b 32 5d 2c 3c 62 72 3e ORDER[2],<br>
1a50: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4c 45 .. LE
1a60: 4e 47 54 48 55 4e 49 54 5b 22 6d 65 74 72 65 22 NGTHUNIT["metre"
1a70: 2c 31 5d 5d 2c 0d 0a 20 20 20 20 41 52 45 41 5b ,1]],.. AREA[
1a80: 22 49 74 61 6c 79 20 2d 20 77 65 73 74 20 6f 66 "Italy - west of
1a90: 20 31 32 c2 b0 45 22 5d 2c 0d 0a 20 20 20 20 42 12..E"],.. B
1aa0: 42 4f 58 5b 33 36 2e 35 33 2c 35 2e 39 34 2c 34 BOX[36.53,5.94,4
1ab0: 37 2e 30 34 2c 31 32 5d 2c 0d 0a 20 20 20 20 49 7.04,12],.. I
1ac0: 44 5b 22 45 50 53 47 22 2c 33 30 30 33 5d 5d 0d D["EPSG",3003]].
1ad0: 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 3c 2f 74 64 .</verbatim></td
1ae0: 3e 0d 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 >..<td valign="t
1af0: 6f 70 22 3e 3c 76 65 72 62 61 74 69 6d 3e 0d 0a op"><verbatim>..
1b00: 47 45 4f 44 43 52 53 5b 22 57 47 53 20 38 34 22 GEODCRS["WGS 84"
1b10: 2c 0d 0a 20 20 20 20 44 41 54 55 4d 5b 22 57 6f ,.. DATUM["Wo
1b20: 72 6c 64 20 47 65 6f 64 65 74 69 63 20 53 79 73 rld Geodetic Sys
1b30: 74 65 6d 20 31 39 38 34 22 2c 0d 0a 20 20 20 20 tem 1984",..
1b40: 20 20 20 20 45 4c 4c 49 50 53 4f 49 44 5b 22 57 ELLIPSOID["W
1b50: 47 53 20 38 34 22 2c 36 33 37 38 31 33 37 2c 32 GS 84",6378137,2
1b60: 39 38 2e 32 35 37 32 32 33 35 36 33 2c 0d 0a 20 98.257223563,..
1b70: 20 20 20 20 20 20 20 20 20 20 20 4c 45 4e 47 54 LENGT
1b80: 48 55 4e 49 54 5b 22 6d 65 74 72 65 22 2c 31 5d HUNIT["metre",1]
1b90: 5d 5d 2c 0d 0a 20 20 20 20 50 52 49 4d 45 4d 5b ]],.. PRIMEM[
1ba0: 22 47 72 65 65 6e 77 69 63 68 22 2c 30 2c 0d 0a "Greenwich",0,..
1bb0: 20 20 20 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 ANGLEUNI
1bc0: 54 5b 22 64 65 67 72 65 65 22 2c 30 2e 30 31 37 T["degree",0.017
1bd0: 34 35 33 32 39 32 35 31 39 39 34 33 33 5d 5d 2c 4532925199433]],
1be0: 0d 0a 20 20 20 20 43 53 5b 65 6c 6c 69 70 73 6f .. CS[ellipso
1bf0: 69 64 61 6c 2c 32 5d 2c 0d 0a 20 20 20 20 20 20 idal,2],..
1c00: 20 20 41 58 49 53 5b 22 67 65 6f 64 65 74 69 63 AXIS["geodetic
1c10: 20 6c 61 74 69 74 75 64 65 20 28 4c 61 74 29 22 latitude (Lat)"
1c20: 2c 6e 6f 72 74 68 2c 0d 0a 20 20 20 20 20 20 20 ,north,..
1c30: 20 20 20 20 20 4f 52 44 45 52 5b 31 5d 2c 0d 0a ORDER[1],..
1c40: 20 20 20 20 20 20 20 20 20 20 20 20 41 4e 47 4c ANGL
1c50: 45 55 4e 49 54 5b 22 64 65 67 72 65 65 22 2c 30 EUNIT["degree",0
1c60: 2e 30 31 37 34 35 33 32 39 32 35 31 39 39 34 33 .017453292519943
1c70: 33 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 41 58 3]],.. AX
1c80: 49 53 5b 22 67 65 6f 64 65 74 69 63 20 6c 6f 6e IS["geodetic lon
1c90: 67 69 74 75 64 65 20 28 4c 6f 6e 29 22 2c 65 61 gitude (Lon)",ea
1ca0: 73 74 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 st,..
1cb0: 20 4f 52 44 45 52 5b 32 5d 2c 0d 0a 20 20 20 20 ORDER[2],..
1cc0: 20 20 20 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 ANGLEUNI
1cd0: 54 5b 22 64 65 67 72 65 65 22 2c 30 2e 30 31 37 T["degree",0.017
1ce0: 34 35 33 32 39 32 35 31 39 39 34 33 33 5d 5d 2c 4532925199433]],
1cf0: 0d 0a 20 20 20 20 41 52 45 41 5b 22 57 6f 72 6c .. AREA["Worl
1d00: 64 22 5d 2c 0d 0a 20 20 20 20 42 42 4f 58 5b 2d d"],.. BBOX[-
1d10: 39 30 2c 2d 31 38 30 2c 39 30 2c 31 38 30 5d 2c 90,-180,90,180],
1d20: 0d 0a 20 20 20 20 49 44 5b 22 45 50 53 47 22 2c .. ID["EPSG",
1d30: 34 33 32 36 5d 5d 0d 0a 3c 2f 76 65 72 62 61 74 4326]]..</verbat
1d40: 69 6d 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 20 76 61 im></td>..<td va
1d50: 6c 69 67 6e 3d 22 74 6f 70 22 3e 3c 76 65 72 62 lign="top"><verb
1d60: 61 74 69 6d 3e 0d 0a 50 52 4f 4a 43 52 53 5b 22 atim>..PROJCRS["
1d70: 57 47 53 20 38 34 20 2f 20 55 54 4d 20 7a 6f 6e WGS 84 / UTM zon
1d80: 65 20 33 32 4e 22 2c 0d 0a 20 20 20 20 42 41 53 e 32N",.. BAS
1d90: 45 47 45 4f 44 43 52 53 5b 22 57 47 53 20 38 34 EGEODCRS["WGS 84
1da0: 22 2c 0d 0a 20 20 20 20 20 20 20 20 44 41 54 55 ",.. DATU
1db0: 4d 5b 22 57 6f 72 6c 64 20 47 65 6f 64 65 74 69 M["World Geodeti
1dc0: 63 20 53 79 73 74 65 6d 20 31 39 38 34 22 2c 0d c System 1984",.
1dd0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 45 4c 4c . ELL
1de0: 49 50 53 4f 49 44 5b 22 57 47 53 20 38 34 22 2c IPSOID["WGS 84",
1df0: 36 33 37 38 31 33 37 2c 32 39 38 2e 32 35 37 32 6378137,298.2572
1e00: 32 33 35 36 33 2c 0d 0a 20 20 20 20 20 20 20 20 23563,..
1e10: 20 20 20 20 20 20 20 20 4c 45 4e 47 54 48 55 4e LENGTHUN
1e20: 49 54 5b 22 6d 65 74 72 65 22 2c 31 5d 5d 5d 2c IT["metre",1]]],
1e30: 0d 0a 20 20 20 20 20 20 20 20 50 52 49 4d 45 4d .. PRIMEM
1e40: 5b 22 47 72 65 65 6e 77 69 63 68 22 2c 30 2c 0d ["Greenwich",0,.
1e50: 0a 20 20 20 20 20 20 20 20 20 20 20 20 41 4e 47 . ANG
1e60: 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 65 22 2c LEUNIT["degree",
1e70: 30 2e 30 31 37 34 35 33 32 39 32 35 31 39 39 34 0.01745329251994
1e80: 33 33 5d 5d 5d 2c 0d 0a 20 20 20 20 43 4f 4e 56 33]]],.. CONV
1e90: 45 52 53 49 4f 4e 5b 22 55 54 4d 20 7a 6f 6e 65 ERSION["UTM zone
1ea0: 20 33 32 4e 22 2c 0d 0a 20 20 20 20 20 20 20 20 32N",..
1eb0: 4d 45 54 48 4f 44 5b 22 54 72 61 6e 73 76 65 72 METHOD["Transver
1ec0: 73 65 20 4d 65 72 63 61 74 6f 72 22 2c 0d 0a 20 se Mercator",..
1ed0: 20 20 20 20 20 20 20 20 20 20 20 49 44 5b 22 45 ID["E
1ee0: 50 53 47 22 2c 39 38 30 37 5d 5d 2c 0d 0a 20 20 PSG",9807]],..
1ef0: 20 20 20 20 20 20 50 41 52 41 4d 45 54 45 52 5b PARAMETER[
1f00: 22 4c 61 74 69 74 75 64 65 20 6f 66 20 6e 61 74 "Latitude of nat
1f10: 75 72 61 6c 20 6f 72 69 67 69 6e 22 2c 30 2c 0d ural origin",0,.
1f20: 0a 20 20 20 20 20 20 20 20 20 20 20 20 41 4e 47 . ANG
1f30: 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 65 22 2c LEUNIT["degree",
1f40: 30 2e 30 31 37 34 35 33 32 39 32 35 31 39 39 34 0.01745329251994
1f50: 33 33 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 33],..
1f60: 20 20 49 44 5b 22 45 50 53 47 22 2c 38 38 30 31 ID["EPSG",8801
1f70: 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 41 52 ]],.. PAR
1f80: 41 4d 45 54 45 52 5b 22 4c 6f 6e 67 69 74 75 64 AMETER["Longitud
1f90: 65 20 6f 66 20 6e 61 74 75 72 61 6c 20 6f 72 69 e of natural ori
1fa0: 67 69 6e 22 2c 39 2c 0d 0a 20 20 20 20 20 20 20 gin",9,..
1fb0: 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 ANGLEUNIT["
1fc0: 64 65 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 degree",0.017453
1fd0: 32 39 32 35 31 39 39 34 33 33 5d 2c 0d 0a 20 20 2925199433],..
1fe0: 20 20 20 20 20 20 20 20 20 20 49 44 5b 22 45 50 ID["EP
1ff0: 53 47 22 2c 38 38 30 32 5d 5d 2c 0d 0a 20 20 20 SG",8802]],..
2000: 20 20 20 20 20 50 41 52 41 4d 45 54 45 52 5b 22 PARAMETER["
2010: 53 63 61 6c 65 20 66 61 63 74 6f 72 20 61 74 20 Scale factor at
2020: 6e 61 74 75 72 61 6c 20 6f 72 69 67 69 6e 22 2c natural origin",
2030: 30 2e 39 39 39 36 2c 0d 0a 20 20 20 20 20 20 20 0.9996,..
2040: 20 20 20 20 20 53 43 41 4c 45 55 4e 49 54 5b 22 SCALEUNIT["
2050: 75 6e 69 74 79 22 2c 31 5d 2c 0d 0a 20 20 20 20 unity",1],..
2060: 20 20 20 20 20 20 20 20 49 44 5b 22 45 50 53 47 ID["EPSG
2070: 22 2c 38 38 30 35 5d 5d 2c 0d 0a 20 20 20 20 20 ",8805]],..
2080: 20 20 20 50 41 52 41 4d 45 54 45 52 5b 22 46 61 PARAMETER["Fa
2090: 6c 73 65 20 65 61 73 74 69 6e 67 22 2c 35 30 30 lse easting",500
20a0: 30 30 30 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 000,..
20b0: 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 LENGTHUNIT["me
20c0: 74 72 65 22 2c 31 5d 2c 0d 0a 20 20 20 20 20 20 tre",1],..
20d0: 20 20 20 20 20 20 49 44 5b 22 45 50 53 47 22 2c ID["EPSG",
20e0: 38 38 30 36 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 8806]],..
20f0: 20 50 41 52 41 4d 45 54 45 52 5b 22 46 61 6c 73 PARAMETER["Fals
2100: 65 20 6e 6f 72 74 68 69 6e 67 22 2c 30 2c 0d 0a e northing",0,..
2110: 20 20 20 20 20 20 20 20 20 20 20 20 4c 45 4e 47 LENG
2120: 54 48 55 4e 49 54 5b 22 6d 65 74 72 65 22 2c 31 THUNIT["metre",1
2130: 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ],..
2140: 49 44 5b 22 45 50 53 47 22 2c 38 38 30 37 5d 5d ID["EPSG",8807]]
2150: 5d 2c 0d 0a 20 20 20 20 43 53 5b 43 61 72 74 65 ],.. CS[Carte
2160: 73 69 61 6e 2c 32 5d 2c 0d 0a 20 20 20 20 20 20 sian,2],..
2170: 20 20 41 58 49 53 5b 22 28 45 29 22 2c 65 61 73 AXIS["(E)",eas
2180: 74 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 t,..
2190: 4f 52 44 45 52 5b 31 5d 2c 0d 0a 20 20 20 20 20 ORDER[1],..
21a0: 20 20 20 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 LENGTHUNI
21b0: 54 5b 22 6d 65 74 72 65 22 2c 31 5d 5d 2c 0d 0a T["metre",1]],..
21c0: 20 20 20 20 20 20 20 20 41 58 49 53 5b 22 28 4e AXIS["(N
21d0: 29 22 2c 6e 6f 72 74 68 2c 0d 0a 20 20 20 20 20 )",north,..
21e0: 20 20 20 20 20 20 20 4f 52 44 45 52 5b 32 5d 2c ORDER[2],
21f0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4c 45 .. LE
2200: 4e 47 54 48 55 4e 49 54 5b 22 6d 65 74 72 65 22 NGTHUNIT["metre"
2210: 2c 31 5d 5d 2c 0d 0a 20 20 20 20 41 52 45 41 5b ,1]],.. AREA[
2220: 22 57 6f 72 6c 64 20 2d 20 4e 20 68 65 6d 69 73 "World - N hemis
2230: 70 68 65 72 65 20 2d 20 36 c2 b0 45 20 74 6f 20 phere - 6..E to
2240: 31 32 c2 b0 45 20 2d 20 62 79 20 63 6f 75 6e 74 12..E - by count
2250: 72 79 22 5d 2c 0d 0a 20 20 20 20 42 42 4f 58 5b ry"],.. BBOX[
2260: 30 2c 36 2c 38 34 2c 31 32 5d 2c 0d 0a 20 20 20 0,6,84,12],..
2270: 20 49 44 5b 22 45 50 53 47 22 2c 33 32 36 33 32 ID["EPSG",32632
2280: 5d 5d 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 3c ]]..</verbatim><
2290: 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 2f 74 /td>..</tr>..</t
22a0: 61 62 6c 65 3e 0d 0a 3c 62 72 3e 0d 0a 41 73 20 able>..<br>..As
22b0: 79 6f 75 20 63 61 6e 20 65 61 73 69 6c 79 20 6e you can easily n
22c0: 6f 74 69 63 65 2c 20 74 68 65 20 74 77 6f 20 6e otice, the two n
22d0: 6f 74 61 74 69 6f 6e 73 20 61 72 65 20 70 72 6f otations are pro
22e0: 66 6f 75 6e 64 6c 79 20 64 69 66 66 65 72 65 6e foundly differen
22f0: 74 2e 0d 0a 54 68 65 20 6f 6c 64 20 3c 62 3e 70 t...The old <b>p
2300: 72 6f 6a 2d 73 74 72 69 6e 67 3c 2f 62 3e 20 6e roj-string</b> n
2310: 6f 74 61 74 69 6f 6e 20 69 73 20 65 78 74 72 65 otation is extre
2320: 6d 65 6c 79 20 63 6f 6e 63 69 73 65 20 61 6e 64 mely concise and
2330: 20 72 6f 75 67 68 2c 20 77 68 69 6c 73 74 20 74 rough, whilst t
2340: 68 65 20 6e 65 77 20 3c 62 3e 49 53 4f 2d 57 4b he new <b>ISO-WK
2350: 54 3c 2f 62 3e 20 69 73 20 76 65 72 62 6f 73 65 T</b> is verbose
2360: 20 62 75 74 20 65 78 68 61 75 73 74 69 76 65 2c but exhaustive,
2370: 20 64 65 74 61 69 6c 65 64 20 61 6e 64 20 70 72 detailed and pr
2380: 65 63 69 73 65 2e 3c 62 72 3e 0d 0a 54 68 65 72 ecise.<br>..Ther
2390: 65 20 69 73 20 6e 6f 20 70 6f 73 73 69 62 6c 65 e is no possible
23a0: 20 6d 61 74 63 68 3a 20 49 53 4f 2d 57 4b 54 20 match: ISO-WKT
23b0: 69 73 20 63 6c 65 61 72 6c 79 20 73 75 70 65 72 is clearly super
23c0: 69 6f 72 20 61 6e 64 20 6d 6f 72 65 20 73 6f 70 ior and more sop
23d0: 68 69 73 74 69 63 61 74 65 64 20 75 6e 64 65 72 histicated under
23e0: 20 61 6e 79 20 70 6f 73 73 69 62 6c 65 20 61 73 any possible as
23f0: 70 65 63 74 2e 3c 62 72 3e 0d 0a 4e 6f 74 20 61 pect.<br>..Not a
2400: 74 20 61 6c 6c 20 73 75 72 70 72 69 73 69 6e 67 t all surprising
2410: 6c 79 2c 20 63 6f 6f 72 64 69 6e 61 74 65 20 74 ly, coordinate t
2420: 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 73 20 62 ransformations b
2430: 61 73 65 64 20 6f 6e 20 49 53 4f 2d 57 4b 54 20 ased on ISO-WKT
2440: 64 65 66 69 6e 69 74 69 6f 6e 73 20 28 69 6e 73 definitions (ins
2450: 74 65 61 64 20 6f 66 20 70 72 6f 6a 2d 73 74 72 tead of proj-str
2460: 69 6e 67 73 29 20 61 72 65 20 75 73 75 61 6c 6c ings) are usuall
2470: 79 20 65 78 70 65 63 74 65 64 20 74 6f 20 62 65 y expected to be
2480: 20 6d 6f 72 65 20 61 63 63 75 72 61 74 65 2e 3c more accurate.<
2490: 62 72 3e 3c 62 72 3e 0d 0a 41 6e 64 20 74 68 61 br><br>..And tha
24a0: 74 27 73 20 6e 6f 74 20 61 6c 6c 3b 20 74 68 65 t's not all; the
24b0: 20 6f 6c 64 20 3c 62 3e 70 72 6f 6a 2d 73 74 72 old <b>proj-str
24c0: 69 6e 67 73 3c 2f 62 3e 20 77 65 72 65 6e 27 74 ings</b> weren't
24d0: 20 66 6f 72 6d 61 6c 6c 79 20 64 65 66 69 6e 65 formally define
24e0: 64 20 62 79 20 61 6e 79 20 73 74 61 6e 64 61 72 d by any standar
24f0: 64 2c 20 61 6e 64 20 6f 6e 6c 79 20 50 52 4f 4a d, and only PROJ
2500: 2c 20 47 44 41 4c 20 61 6e 64 20 66 65 77 20 6f , GDAL and few o
2510: 74 68 65 72 20 46 4c 4f 53 53 20 2f 20 47 46 4f ther FLOSS / GFO
2520: 53 53 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f SS implementatio
2530: 6e 73 20 63 61 6e 20 75 6e 64 65 72 73 74 61 6e ns can understan
2540: 64 20 74 68 65 6d 2e 3c 62 72 3e 0d 0a 41 74 20 d them.<br>..At
2550: 74 68 65 20 6f 70 70 6f 73 69 74 65 2c 20 74 68 the opposite, th
2560: 65 20 6e 65 77 20 3c 62 3e 49 53 4f 2d 57 4b 54 e new <b>ISO-WKT
2570: 3c 2f 62 3e 20 69 73 20 66 6f 72 6d 61 6c 6c 79 </b> is formally
2580: 20 64 65 66 69 6e 65 64 20 62 79 20 61 6e 20 69 defined by an i
2590: 6e 74 65 72 6e 61 74 69 6f 6e 61 6c 20 73 74 61 nternational sta
25a0: 6e 64 61 72 64 2c 20 61 6e 64 20 61 6c 6d 6f 73 ndard, and almos
25b0: 74 20 61 6c 6c 20 66 72 65 65 20 61 6e 64 20 70 t all free and p
25c0: 72 6f 70 72 69 65 74 61 72 79 20 69 6d 70 6c 65 roprietary imple
25d0: 6d 65 6e 74 61 74 69 6f 6e 73 20 61 72 65 20 65 mentations are e
25e0: 78 70 65 63 74 65 64 20 74 6f 20 73 75 70 70 6f xpected to suppo
25f0: 72 74 20 69 74 2e 3c 62 72 3e 3c 62 72 3e 0d 0a rt it.<br><br>..
2600: 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 <table cellspaci
2610: 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 69 ng="8" cellpaddi
2620: 6e 67 3d 22 31 36 22 20 62 67 63 6f 6c 6f 72 3d ng="16" bgcolor=
2630: 22 23 66 66 66 66 65 39 22 3e 0d 0a 3c 74 72 3e "#ffffe9">..<tr>
2640: 3c 74 64 3e 0d 0a 3c 62 3e 3c 75 3e 49 6d 70 6f <td>..<b><u>Impo
2650: 72 74 61 6e 74 20 6e 6f 74 69 63 65 3c 2f 75 3e rtant notice</u>
2660: 3c 2f 62 3e 3a 20 74 68 65 72 65 20 61 72 65 20 </b>: there are
2670: 73 65 76 65 72 61 6c 20 64 69 61 6c 65 63 74 73 several dialects
2680: 20 69 6e 20 74 68 65 20 57 4b 54 20 6e 6f 74 61 in the WKT nota
2690: 74 69 6f 6e 20 64 65 73 63 72 69 62 69 6e 67 20 tion describing
26a0: 43 52 53 65 73 2e 3c 62 72 3e 0d 0a 41 6c 6c 20 CRSes.<br>..All
26b0: 74 68 65 6d 20 73 68 61 72 65 20 74 68 65 20 73 them share the s
26c0: 61 6d 65 20 63 6f 6d 6d 6f 6e 20 63 6f 72 65 20 ame common core
26d0: 61 6e 64 20 6d 61 69 6e 6c 79 20 64 69 66 66 65 and mainly diffe
26e0: 72 20 69 6e 20 66 65 77 20 6d 69 6e 6f 72 20 64 r in few minor d
26f0: 65 74 61 69 6c 73 2e 3c 62 72 3e 0d 0a 50 52 4f etails.<br>..PRO
2700: 4a 2e 36 20 63 61 6e 20 75 6e 64 65 72 73 74 61 J.6 can understa
2710: 6e 64 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 nd the following
2720: 20 64 69 61 6c 65 63 74 73 3a 0d 0a 3c 6f 6c 3e dialects:..<ol>
2730: 0d 0a 3c 6c 69 3e 3c 62 3e 45 53 52 49 20 57 4b ..<li><b>ESRI WK
2740: 54 3c 2f 62 3e 3a 20 61 20 64 69 61 6c 65 63 74 T</b>: a dialect
2750: 20 77 69 64 65 6c 79 20 61 64 6f 70 74 65 64 20 widely adopted
2760: 62 79 20 45 53 52 49 20 70 72 6f 70 72 69 65 74 by ESRI propriet
2770: 61 72 79 20 73 6f 66 74 77 61 72 65 2e 3c 2f 6c ary software.</l
2780: 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 47 44 41 4c 20 i>..<li><b>GDAL
2790: 57 4b 54 31 3c 2f 62 3e 3a 20 61 20 64 69 61 6c WKT1</b>: a dial
27a0: 65 63 74 20 68 69 73 74 6f 72 69 63 61 6c 6c 79 ect historically
27b0: 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 74 68 supported by th
27c0: 65 20 6f 70 65 6e 20 73 6f 75 72 63 65 20 47 44 e open source GD
27d0: 41 4c 20 6c 69 62 72 61 72 79 2e 3c 2f 6c 69 3e AL library.</li>
27e0: 0d 0a 3c 6c 69 3e 3c 62 3e 57 4b 54 32 3a 32 30 ..<li><b>WKT2:20
27f0: 31 35 3c 2f 62 3e 3a 20 61 73 20 64 65 66 69 6e 15</b>: as defin
2800: 65 64 20 62 79 20 3c 62 3e 49 53 4f 20 31 39 31 ed by <b>ISO 191
2810: 36 32 3a 32 30 31 35 3c 2f 62 3e 20 73 74 61 6e 62:2015</b> stan
2820: 64 61 72 64 20 73 70 65 63 69 66 69 63 61 74 69 dard specificati
2830: 6f 6e 20 28 6e 6f 77 20 73 75 70 65 72 73 65 64 on (now supersed
2840: 65 64 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c ed).</li>..<li><
2850: 62 3e 57 4b 54 32 3a 32 30 31 38 3c 2f 62 3e 3a b>WKT2:2018</b>:
2860: 20 61 73 20 64 65 66 69 6e 65 64 20 62 79 20 74 as defined by t
2870: 68 65 20 6d 6f 72 65 20 72 65 63 65 6e 74 20 3c he more recent <
2880: 62 3e 49 53 4f 20 31 39 31 36 32 3a 32 30 31 38 b>ISO 19162:2018
2890: 3c 2f 62 3e 20 73 74 61 6e 64 61 72 64 20 73 70 </b> standard sp
28a0: 65 63 69 66 69 63 61 74 69 6f 6e 20 2e 3c 2f 6c ecification .</l
28b0: 69 3e 0d 0a 3c 2f 6f 6c 3e 0d 0a 3c 2f 74 64 3e i>..</ol>..</td>
28c0: 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c </tr>..</table><
28d0: 62 72 3e 0d 0a 3c 68 33 3e 54 68 65 20 70 72 69 br>..<h3>The pri
28e0: 76 61 74 65 20 53 51 4c 69 74 65 20 64 61 74 61 vate SQLite data
28f0: 62 61 73 65 20 73 75 70 70 6f 72 74 69 6e 67 20 base supporting
2900: 50 52 4f 4a 2e 36 3c 2f 68 33 3e 0d 0a 53 74 61 PROJ.6</h3>..Sta
2910: 72 74 69 6e 67 20 73 69 6e 63 65 20 3c 62 3e 50 rting since <b>P
2920: 52 4f 4a 2e 36 3c 2f 62 3e 20 74 68 65 20 50 52 ROJ.6</b> the PR
2930: 4f 4a 20 6c 69 62 72 61 72 79 20 69 73 20 73 75 OJ library is su
2940: 70 70 6f 72 74 65 64 20 62 79 20 61 20 70 72 69 pported by a pri
2950: 76 61 74 65 20 53 51 4c 69 74 65 20 64 61 74 61 vate SQLite data
2960: 62 61 73 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 base containing
2970: 61 6c 6c 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 all definitions
2980: 61 62 6f 75 74 20 73 75 70 70 6f 72 74 65 64 20 about supported
2990: 43 52 53 65 73 2c 20 45 6c 6c 69 70 73 6f 69 64 CRSes, Ellipsoid
29a0: 73 2c 20 50 72 69 6d 65 20 4d 65 72 69 64 69 61 s, Prime Meridia
29b0: 6e 73 2c 20 55 6e 69 74 73 20 6f 66 20 4d 65 61 ns, Units of Mea
29c0: 73 75 72 65 2c 20 54 72 61 6e 73 66 6f 72 6d 61 sure, Transforma
29d0: 74 69 6f 6e 73 20 61 6e 64 20 61 6c 69 6b 65 2e tions and alike.
29e0: 3c 62 72 3e 0d 0a 3c 62 3e 3c 75 3e 4e 6f 74 65 <br>..<b><u>Note
29f0: 3c 2f 75 3e 3c 2f 62 3e 3a 20 6d 61 6e 79 20 6f </u></b>: many o
2a00: 66 20 74 68 65 20 6e 65 77 20 61 64 76 61 6e 63 f the new advanc
2a10: 65 64 20 50 52 4f 4a 2e 36 20 66 65 61 74 75 72 ed PROJ.6 featur
2a20: 65 73 20 77 69 6c 6c 20 66 61 69 6c 20 69 66 20 es will fail if
2a30: 73 75 63 68 20 64 61 74 61 62 61 73 65 20 69 73 such database is
2a40: 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 61 not available a
2a50: 74 20 72 75 6e 20 74 69 6d 65 2e 3c 62 72 3e 3c t run time.<br><
2a60: 62 72 3e 0d 0a 3c 68 33 3e 54 72 61 6e 73 66 6f br>..<h3>Transfo
2a70: 72 6d 61 74 69 6f 6e 73 20 66 72 6f 6d 20 43 52 rmations from CR
2a80: 53 20 74 6f 20 43 52 53 3c 2f 68 33 3e 0d 0a 44 S to CRS</h3>..D
2a90: 69 66 66 65 72 65 6e 74 6c 79 20 66 72 6f 6d 20 ifferently from
2aa0: 61 6c 6c 20 70 72 65 76 69 6f 75 73 20 76 65 72 all previous ver
2ab0: 73 69 6f 6e 73 2c 20 50 52 4f 4a 2e 36 20 63 61 sions, PROJ.6 ca
2ac0: 6e 20 6e 6f 77 20 61 70 70 6c 79 20 61 6e 79 20 n now apply any
2ad0: 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 66 transformation f
2ae0: 72 6f 6d 20 61 20 43 52 53 20 74 6f 20 61 6e 6f rom a CRS to ano
2af0: 74 68 65 72 20 77 69 74 68 6f 75 74 20 72 65 71 ther without req
2b00: 75 69 72 69 6e 67 20 74 6f 20 73 70 65 63 69 66 uiring to specif
2b10: 79 20 61 6e 79 20 3c 62 3e 3c 69 3e 70 72 6f 6a y any <b><i>proj
2b20: 2d 73 74 72 69 6e 67 3c 2f 69 3e 3c 2f 62 3e 20 -string</i></b>
2b30: 6f 72 20 3c 62 3e 3c 69 3e 57 4b 54 20 65 78 70 or <b><i>WKT exp
2b40: 72 65 73 73 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 ression</i></b>
2b50: 71 75 61 6c 69 66 79 69 6e 67 20 65 61 63 68 20 qualifying each
2b60: 43 52 53 2e 3c 62 72 3e 0d 0a 54 68 69 73 20 69 CRS.<br>..This i
2b70: 73 20 62 65 63 61 75 73 65 20 50 52 4f 4a 2e 36 s because PROJ.6
2b80: 20 69 73 20 6e 6f 77 20 73 75 70 70 6f 72 74 65 is now supporte
2b90: 64 20 62 79 20 61 20 70 72 69 76 61 74 65 20 53 d by a private S
2ba0: 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 20 6f QLite database o
2bb0: 66 20 69 74 73 20 6f 77 6e 20 63 6f 6e 74 61 69 f its own contai
2bc0: 6e 69 6e 67 20 61 6c 6c 20 74 68 65 20 43 52 53 ning all the CRS
2bd0: 20 64 65 66 69 6e 69 74 69 6f 6e 73 2c 20 61 6e definitions, an
2be0: 64 20 63 6f 6e 73 65 71 75 65 6e 74 6c 79 20 65 d consequently e
2bf0: 61 63 68 20 43 52 53 20 63 61 6e 20 62 65 20 66 ach CRS can be f
2c00: 75 6c 6c 79 20 69 64 65 6e 74 69 66 69 65 64 20 ully identified
2c10: 62 79 20 73 69 6d 70 6c 79 20 73 70 65 63 69 66 by simply specif
2c20: 79 69 6e 67 20 69 74 73 20 73 79 6d 62 6f 6c 69 ying its symboli
2c30: 63 20 6e 61 6d 65 2c 20 61 73 20 69 6e 3a 0d 0a c name, as in:..
2c40: 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 45 50 53 <ul>..<li><b>EPS
2c50: 47 3a 34 33 32 36 3c 2f 62 3e 20 6f 72 3c 2f 6c G:4326</b> or</l
2c60: 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 75 72 6e 3a 6f i>..<li><b>urn:o
2c70: 67 63 3a 64 65 66 3a 63 72 73 3a 45 50 53 47 3a gc:def:crs:EPSG:
2c80: 3a 34 33 32 36 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a :4326</b></li>..
2c90: 3c 2f 75 6c 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 </ul>..<table ce
2ca0: 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65 llspacing="8" ce
2cb0: 6c 6c 70 61 64 64 69 6e 67 3d 22 31 36 22 20 62 llpadding="16" b
2cc0: 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 39 22 gcolor="#ffffe9"
2cd0: 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 61 7a 7a >..<tr><td>..azz
2ce0: 6f 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c o..</td></tr>..<
2cf0: 2f 74 61 62 6c 65 3e 0d 0a 3c 62 72 3e 3c 62 72 /table>..<br><br
2d00: 3e 0d 0a 3c 68 33 3e 54 72 61 6e 73 66 6f 72 6d >..<h3>Transform
2d10: 61 74 69 6f 6e 20 70 69 70 65 6c 69 6e 65 73 3c ation pipelines<
2d20: 2f 68 33 3e 0d 0a 54 68 65 72 65 20 69 73 20 61 /h3>..There is a
2d30: 20 6c 61 73 74 20 61 73 74 6f 6e 69 73 68 69 6e last astonishin
2d40: 67 20 69 6d 70 72 6f 76 65 6d 65 6e 74 20 73 75 g improvement su
2d50: 70 70 6f 72 74 65 64 20 62 79 20 50 52 4f 4a 2e pported by PROJ.
2d60: 36 2c 20 74 68 61 74 20 61 72 65 20 3c 62 3e 3c 6, that are <b><
2d70: 69 3e 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e i>transformation
2d80: 20 70 69 70 65 6c 69 6e 65 73 3c 2f 69 3e 3c 2f pipelines</i></
2d90: 62 3e 2e 3c 62 72 3e 0d 0a 57 68 65 6e 20 75 73 b>.<br>..When us
2da0: 69 6e 67 20 61 20 3c 62 3e 3c 69 3e 70 69 70 65 ing a <b><i>pipe
2db0: 6c 69 6e 65 3c 2f 69 3e 3c 2f 62 3e 20 79 6f 75 line</i></b> you
2dc0: 20 63 61 6e 20 66 72 65 65 6c 79 20 64 65 66 69 can freely defi
2dd0: 6e 65 20 61 6e 79 20 63 6f 6d 70 6c 65 78 20 67 ne any complex g
2de0: 65 6f 64 65 74 69 63 20 74 72 61 6e 73 66 6f 72 eodetic transfor
2df0: 6d 61 74 69 6f 6e 20 62 79 20 63 68 61 69 6e 69 mation by chaini
2e00: 6e 67 20 74 6f 67 65 74 68 65 72 20 6d 61 6e 79 ng together many
2e10: 20 65 6c 65 6d 65 6e 74 61 72 79 20 73 74 65 70 elementary step
2e20: 73 20 73 75 63 68 20 61 73 20 63 6f 6e 76 65 72 s such as conver
2e30: 73 69 6f 6e 2c 20 74 72 61 6e 73 66 6f 72 6d 61 sion, transforma
2e40: 74 69 6f 6e 2c 20 70 72 6f 6a 65 63 74 69 6f 6e tion, projection
2e50: 2c 20 61 78 69 73 20 73 77 61 70 20 61 6e 64 20 , axis swap and
2e60: 73 6f 20 6f 6e 2e 3c 62 72 3e 0d 0a 41 20 70 69 so on.<br>..A pi
2e70: 70 65 6c 69 6e 65 20 69 73 20 63 6f 6e 63 65 70 peline is concep
2e80: 74 75 61 6c 6c 79 20 73 69 6d 69 6c 61 72 20 74 tually similar t
2e90: 6f 20 61 20 55 4e 49 58 20 73 68 65 6c 6c 20 73 o a UNIX shell s
2ea0: 63 72 69 70 74 2c 20 77 69 74 68 20 61 20 64 61 cript, with a da
2eb0: 74 61 66 6c 6f 77 20 72 65 67 75 6c 61 72 6c 79 taflow regularly
2ec0: 20 70 72 6f 63 65 64 69 6e 67 20 66 6f 72 77 61 proceding forwa
2ed0: 72 64 20 66 72 6f 6d 20 73 74 65 70 20 74 6f 20 rd from step to
2ee0: 73 74 65 70 20 75 6e 74 69 6c 20 70 72 6f 64 75 step until produ
2ef0: 63 69 6e 67 20 74 68 65 20 66 69 6e 61 6c 20 72 cing the final r
2f00: 65 73 75 6c 74 2e 3c 62 72 3e 0d 0a 54 68 65 20 esult.<br>..The
2f10: 66 6f 6c 6c 6f 77 69 6e 67 20 69 73 20 61 20 70 following is a p
2f20: 72 61 63 74 69 61 6c 20 65 78 61 6d 70 6c 65 20 ractial example
2f30: 6f 66 20 61 20 70 69 70 65 6c 69 6e 65 20 63 6f of a pipeline co
2f40: 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 61 rresponding to a
2f50: 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 transformation
2f60: 66 72 6f 6d 20 3c 62 3e 45 50 53 47 3a 34 33 32 from <b>EPSG:432
2f70: 36 3c 2f 62 3e 20 3c 69 3e 57 47 53 20 38 34 3c 6</b> <i>WGS 84<
2f80: 2f 69 3e 20 74 6f 20 3c 62 3e 45 50 53 47 3a 33 /i> to <b>EPSG:3
2f90: 32 36 33 32 3c 2f 62 3e 20 3c 69 3e 57 47 53 20 2632</b> <i>WGS
2fa0: 38 34 20 2f 20 55 54 4d 20 7a 6f 6e 65 20 33 32 84 / UTM zone 32
2fb0: 4e 3c 2f 69 3e 3a 0d 0a 3c 76 65 72 62 61 74 69 N</i>:..<verbati
2fc0: 6d 3e 0d 0a 2b 70 72 6f 6a 3d 70 69 70 65 6c 69 m>..+proj=pipeli
2fd0: 6e 65 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a ne ..+step +proj
2fe0: 3d 61 78 69 73 73 77 61 70 20 2b 6f 72 64 65 72 =axisswap +order
2ff0: 3d 32 2c 31 20 0d 0a 2b 73 74 65 70 20 2b 70 72 =2,1 ..+step +pr
3000: 6f 6a 3d 75 6e 69 74 63 6f 6e 76 65 72 74 20 2b oj=unitconvert +
3010: 78 79 5f 69 6e 3d 64 65 67 20 2b 78 79 5f 6f 75 xy_in=deg +xy_ou
3020: 74 3d 72 61 64 20 0d 0a 2b 73 74 65 70 20 2b 70 t=rad ..+step +p
3030: 72 6f 6a 3d 75 74 6d 20 2b 7a 6f 6e 65 3d 33 32 roj=utm +zone=32
3040: 20 2b 65 6c 6c 70 73 3d 57 47 53 38 34 0d 0a 3c +ellps=WGS84..<
3050: 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 3c 74 61 62 /verbatim>..<tab
3060: 6c 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 le cellspacing="
3070: 38 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 8" cellpadding="
3080: 31 36 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 16" bgcolor="#ff
3090: 66 66 64 30 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e ffd0">..<tr><td>
30a0: 0d 0a 3c 62 3e 3c 75 3e 55 73 65 66 75 6c 20 68 ..<b><u>Useful h
30b0: 69 6e 74 3c 2f 75 3e 3c 2f 62 3e 3a 20 50 52 4f int</u></b>: PRO
30c0: 4a 2e 36 20 73 75 70 70 6f 72 74 73 20 61 20 6e J.6 supports a n
30d0: 65 77 20 43 4c 49 20 74 6f 6f 6c 20 28 3c 62 3e ew CLI tool (<b>
30e0: 70 72 6f 6a 69 6e 66 6f 3c 2f 62 3e 29 20 66 6f projinfo</b>) fo
30f0: 72 20 69 6e 73 70 65 63 74 69 6e 67 20 69 6e 20 r inspecting in
3100: 66 75 6c 6c 20 64 65 74 61 69 6c 20 74 68 65 20 full detail the
3110: 69 6e 74 65 72 6e 61 6c 20 64 65 66 69 6e 69 74 internal definit
3120: 69 6f 6e 73 20 6f 66 20 43 52 53 65 73 2c 20 54 ions of CRSes, T
3130: 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 73 20 65 ransformations e
3140: 74 63 2e 3c 62 72 3e 0d 0a 54 68 65 20 61 62 6f tc.<br>..The abo
3150: 76 65 20 70 69 70 65 6c 69 6e 65 20 69 73 20 73 ve pipeline is s
3160: 69 6d 70 6c 79 20 74 68 65 20 6f 75 74 70 75 74 imply the output
3170: 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
3180: 67 20 63 6f 6d 6d 61 6e 64 3a 0d 0a 3c 76 65 72 g command:..<ver
3190: 62 61 74 69 6d 3e 0d 0a 70 72 6f 6a 69 6e 66 6f batim>..projinfo
31a0: 20 2d 73 20 45 50 53 47 3a 34 33 32 36 20 2d 74 -s EPSG:4326 -t
31b0: 20 45 50 53 47 3a 33 32 36 33 32 20 2d 6f 20 70 EPSG:32632 -o p
31c0: 72 6f 6a 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e roj..</verbatim>
31d0: 0d 0a 3c 62 3e 70 72 6f 6a 69 6e 66 6f 3c 2f 62 ..<b>projinfo</b
31e0: 3e 20 69 73 20 61 20 76 65 72 79 20 70 72 65 63 > is a very prec
31f0: 69 6f 75 73 20 72 65 73 6f 75 72 63 65 3b 20 64 ious resource; d
3200: 6f 6e 27 74 20 65 73 69 74 61 74 65 20 74 6f 20 on't esitate to
3210: 66 72 65 71 75 65 6e 74 6c 79 20 75 73 65 20 69 frequently use i
3220: 74 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 64 69 t in order to di
3230: 73 63 6f 76 65 72 20 77 68 61 74 27 73 20 72 65 scover what's re
3240: 61 6c 6c 79 20 68 61 70 70 65 6e 69 6e 67 20 62 ally happening b
3250: 65 68 69 6e 64 20 74 68 65 20 73 63 65 6e 65 73 ehind the scenes
3260: 2e 3c 62 72 3e 0d 0a 49 74 27 73 20 74 68 65 20 .<br>..It's the
3270: 62 65 73 74 20 61 6e 64 20 65 61 73 69 65 73 74 best and easiest
3280: 20 77 61 79 20 66 6f 72 20 66 75 6c 6c 79 20 75 way for fully u
3290: 6e 64 65 72 73 74 61 6e 74 69 6e 67 20 68 6f 77 nderstanting how
32a0: 20 50 52 4f 4a 2e 36 20 64 6f 20 72 65 61 6c 6c PROJ.6 do reall
32b0: 79 20 77 6f 72 6b 73 2e 0d 0a 3c 2f 74 64 3e 3c y works...</td><
32c0: 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 /tr>..</table><b
32d0: 72 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 r><br>..<table c
32e0: 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 ellspacing="8" c
32f0: 65 6c 6c 70 61 64 64 69 6e 67 3d 22 38 22 20 62 ellpadding="8" b
3300: 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 39 22 gcolor="#ffffe9"
3310: 3e 0d 0a 3c 74 72 3e 3c 74 68 3e 0d 0a 49 6e 20 >..<tr><th>..In
3320: 6f 72 64 65 72 20 74 6f 20 6c 65 61 72 6e 20 6d order to learn m
3330: 6f 72 65 20 61 62 6f 75 74 20 74 68 65 20 6d 61 ore about the ma
3340: 6e 79 20 69 6e 74 65 72 65 73 74 69 6e 67 20 63 ny interesting c
3350: 6f 6f 6c 20 6e 65 77 20 66 65 61 74 75 72 65 73 ool new features
3360: 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 50 52 supported by PR
3370: 4f 4a 2e 36 20 70 6c 65 61 73 65 20 63 6f 6e 73 OJ.6 please cons
3380: 75 6c 74 20 74 68 65 20 3c 61 20 68 72 65 66 3d ult the <a href=
3390: 22 68 74 74 70 73 3a 2f 2f 70 72 6f 6a 34 2e 6f "https://proj4.o
33a0: 72 67 2f 22 3e 6f 72 69 67 69 6e 61 6c 20 64 6f rg/">original do
33b0: 63 75 6d 65 6e 74 61 74 69 6f 6e 3c 2f 61 3e 0d cumentation</a>.
33c0: 0a 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 .</th></tr>..</t
33d0: 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 68 72 3e 0d able><br>..<hr>.
33e0: 0a 3c 68 31 3e 53 70 61 74 69 61 4c 69 74 65 2d .<h1>SpatiaLite-
33f0: 35 2e 30 2e 30 20 73 75 70 70 6f 72 74 69 6e 67 5.0.0 supporting
3400: 20 50 52 4f 4a 2e 36 3c 2f 68 31 3e 0d 0a 3c 68 PROJ.6</h1>..<h
3410: 33 3e 43 72 65 61 74 69 6e 67 20 61 6e 64 20 70 3>Creating and p
3420: 6f 70 75 6c 61 74 69 6e 67 20 74 68 65 20 73 70 opulating the sp
3430: 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 20 6d 65 atial_ref_sys me
3440: 74 61 74 61 62 6c 65 3c 2f 68 33 3e 0d 0a 3c 68 tatable</h3>..<h
3450: 33 3e 45 78 69 73 74 69 6e 67 20 53 51 4c 20 66 3>Existing SQL f
3460: 75 6e 63 74 69 6f 6e 73 20 61 66 66 65 63 74 65 unctions affecte
3470: 64 20 62 79 20 50 52 4f 4a 2e 36 3c 2f 68 33 3e d by PROJ.6</h3>
3480: 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 ..<table cellspa
3490: 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 cing="8" cellpad
34a0: 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 ding="8" bgcolor
34b0: 3d 22 23 65 38 66 66 65 38 22 20 62 6f 72 64 65 ="#e8ffe8" borde
34c0: 72 3d 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 r="1">..<tr><th
34d0: 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 bgcolor="#ffb03e
34e0: 22 3e 53 51 4c 20 46 75 6e 63 74 69 6f 6e 3c 2f ">SQL Function</
34f0: 74 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 th><th bgcolor="
3500: 23 66 66 62 30 33 65 22 3e 45 78 74 65 6e 64 65 #ffb03e">Extende
3510: 64 20 73 69 67 6e 61 74 75 72 65 3c 2f 74 68 3e d signature</th>
3520: 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 <th bgcolor="#ff
3530: 62 30 33 65 22 3e 42 65 68 61 76 69 6f 72 20 75 b03e">Behavior u
3540: 6e 64 65 72 20 50 52 4f 4a 2e 36 3c 2f 74 68 3e nder PROJ.6</th>
3550: 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c </tr>..<tr><td><
3560: 62 3e 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 29 b>ST_Transform()
3570: 3c 2f 62 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 0d </b></td>..<td>.
3580: 0a 3c 62 3e 53 54 5f 54 72 61 6e 73 66 6f 72 6d .<b>ST_Transform
3590: 3c 2f 62 3e 20 28 20 67 65 6f 6d 20 3c 69 3e 47 </b> ( geom <i>G
35a0: 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 6e 65 eometry</i> , ne
35b0: 77 53 72 69 64 20 3c 69 3e 49 6e 74 65 67 65 72 wSrid <i>Integer
35c0: 3c 2f 69 3e 20 2c 20 61 72 65 61 20 3c 69 3e 47 </i> , area <i>G
35d0: 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 29 20 3a 20 eometry</i> ) :
35e0: 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 3c <i>Geometry</i><
35f0: 68 72 3e 0d 0a 3c 62 3e 53 54 5f 54 72 61 6e 73 hr>..<b>ST_Trans
3600: 66 6f 72 6d 3c 2f 62 3e 20 28 20 67 65 6f 6d 20 form</b> ( geom
3610: 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 <i>Geometry</i>
3620: 2c 20 6e 65 77 53 72 69 64 20 3c 69 3e 49 6e 74 , newSrid <i>Int
3630: 65 67 65 72 3c 2f 69 3e 20 2c 20 61 72 65 61 20 eger</i> , area
3640: 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 <i>Geometry</i>
3650: 2c 20 6d 65 74 68 6f 64 20 3c 69 3e 54 65 78 74 , method <i>Text
3660: 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 47 65 6f 6d </i> ) : <i>Geom
3670: 65 74 72 79 3c 2f 69 3e 3c 68 72 3e 0d 0a 3c 62 etry</i><hr>..<b
3680: 3e 53 54 5f 54 72 61 6e 73 66 6f 72 6d 3c 2f 62 >ST_Transform</b
3690: 3e 20 28 20 67 65 6f 6d 20 3c 69 3e 47 65 6f 6d > ( geom <i>Geom
36a0: 65 74 72 79 3c 2f 69 3e 20 2c 20 6e 65 77 53 72 etry</i> , newSr
36b0: 69 64 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 id <i>Integer</i
36c0: 3e 20 2c 20 61 72 65 61 20 3c 69 3e 47 65 6f 6d > , area <i>Geom
36d0: 65 74 72 79 3c 2f 69 3e 20 2c 20 6d 65 74 68 6f etry</i> , metho
36e0: 64 20 3c 69 3e 54 65 78 74 3c 2f 69 3e 20 2c 20 d <i>Text</i> ,
36f0: 70 72 6f 6a 5f 73 74 72 69 6e 67 20 3c 69 3e 54 proj_string <i>T
3700: 65 78 74 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 47 ext</i> ) : <i>G
3710: 65 6f 6d 65 74 72 79 3c 2f 69 3e 0d 0a 3c 2f 74 eometry</i>..</t
3720: 64 3e 0d 0a 3c 74 64 3e 0d 0a 3c 74 61 62 6c 65 d>..<td>..<table
3730: 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 34 22 cellspacing="4"
3740: 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 34 22 cellpadding="4"
3750: 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 64 bgcolor="#ffffd
3760: 30 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 0">..<tr><td>..<
3770: 62 3e 3c 75 3e 3c 69 3e 4e 6f 74 65 3c 2f 69 3e b><u><i>Note</i>
3780: 3c 2f 75 3e 3c 2f 62 3e 3a 20 61 6c 6c 20 74 68 </u></b>: all th
3790: 65 73 65 20 3c 62 3e 3c 69 3e 65 78 74 65 6e 64 ese <b><i>extend
37a0: 65 64 20 73 69 67 6e 61 74 75 72 65 73 3c 2f 69 ed signatures</i
37b0: 3e 3c 2f 62 3e 20 61 72 65 20 73 75 70 70 6f 72 ></b> are suppor
37c0: 74 65 64 20 6f 6e 6c 79 20 77 68 65 6e 20 3c 62 ted only when <b
37d0: 3e 6c 69 62 73 70 61 74 69 61 6c 69 74 65 2d 35 >libspatialite-5
37e0: 2e 30 3c 2f 62 3e 20 68 61 73 20 62 65 65 6e 20 .0</b> has been
37f0: 62 75 69 6c 74 20 6f 6e 20 74 68 65 20 74 6f 70 built on the top
3800: 20 6f 66 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 of <b>PROJ.6</b
3810: 3e 3c 62 72 3e 0d 0a 49 66 20 74 68 65 20 6c 69 ><br>..If the li
3820: 62 72 61 72 79 20 68 61 73 20 62 65 65 6e 20 62 brary has been b
3830: 75 69 6c 74 20 69 6e 73 74 65 61 64 20 6f 6e 20 uilt instead on
3840: 65 61 72 6c 69 65 72 20 76 65 72 73 69 6f 6e 73 earlier versions
3850: 20 6f 66 20 50 52 4f 4a 20 61 6e 79 20 61 74 74 of PROJ any att
3860: 65 6d 70 74 20 74 6f 20 63 61 6c 6c 20 74 68 65 empt to call the
3870: 73 65 20 65 78 74 65 6e 64 65 64 20 73 69 67 6e se extended sign
3880: 61 74 75 72 65 73 20 77 69 6c 6c 20 6a 75 73 74 atures will just
3890: 20 72 65 74 75 72 6e 20 61 20 3c 62 3e 3c 69 3e return a <b><i>
38a0: 77 72 6f 6e 67 20 6e 75 6d 62 65 72 20 6f 66 20 wrong number of
38b0: 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 66 75 6e arguments to fun
38c0: 63 74 69 6f 6e 20 53 54 5f 54 72 61 6e 73 66 6f ction ST_Transfo
38d0: 72 6d 28 29 3c 2f 69 3e 3c 2f 62 3e 20 65 72 72 rm()</i></b> err
38e0: 6f 72 2e 0d 0a 3c 2f 74 64 3e 3c 74 72 3e 0d 0a or...</td><tr>..
38f0: 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 74 </table><br>..<t
3900: 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 able cellspacing
3910: 3d 22 34 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 ="4" cellpadding
3920: 3d 22 34 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 ="4" bgcolor="#f
3930: 66 64 66 64 30 22 3e 0d 0a 3c 74 72 3e 3c 74 64 fdfd0">..<tr><td
3940: 3e 0d 0a 41 6e 79 20 69 6e 76 61 6c 69 64 20 61 >..Any invalid a
3950: 72 67 75 6d 65 6e 74 20 70 61 73 73 65 64 20 74 rgument passed t
3960: 6f 20 3c 62 3e 53 54 5f 54 72 61 6e 73 66 6f 72 o <b>ST_Transfor
3970: 6d 28 29 3c 2f 62 3e 20 28 3c 62 3e 3c 69 3e 65 m()</b> (<b><i>e
3980: 78 74 65 6e 64 65 64 20 73 69 67 6e 61 74 75 72 xtended signatur
3990: 65 73 3c 2f 69 3e 3c 2f 62 3e 29 20 77 69 6c 6c es</i></b>) will
39a0: 20 72 61 69 73 65 20 61 6e 20 3c 62 3e 53 51 4c raise an <b>SQL
39b0: 20 45 78 63 65 70 74 69 6f 6e 3c 2f 62 3e 2e 0d Exception</b>..
39c0: 0a 3c 2f 74 64 3e 3c 74 72 3e 0d 0a 3c 2f 74 61 .</td><tr>..</ta
39d0: 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 75 6c 3e 0d 0a ble><br>..<ul>..
39e0: 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c <li>the optional
39f0: 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e 61 72 65 argument <b>are
3a00: 61 3c 2f 62 3e 20 6d 61 79 20 62 65 20 3c 62 3e a</b> may be <b>
3a10: 4e 55 4c 4c 3c 2f 62 3e 20 28 3c 69 3e 64 65 66 NULL</b> (<i>def
3a20: 61 75 6c 74 20 73 65 74 74 69 6e 67 3c 2f 69 3e ault setting</i>
3a30: 29 2e 3c 62 72 3e 0d 0a 4f 74 68 65 72 77 69 73 ).<br>..Otherwis
3a40: 65 20 69 74 27 73 20 65 78 70 65 63 74 65 64 20 e it's expected
3a50: 74 6f 20 63 6f 6e 74 61 69 6e 20 61 20 76 61 6c to contain a val
3a60: 69 64 20 47 65 6f 6d 65 74 72 79 20 69 6e 20 3c id Geometry in <
3a70: 62 3e 53 52 49 44 3d 34 33 32 36 20 28 6c 6f 6e b>SRID=4326 (lon
3a80: 67 2f 6c 61 74 29 3c 2f 62 3e 2e 0d 0a 57 68 65 g/lat)</b>...Whe
3a90: 6e 20 61 6e 20 3c 62 3e 3c 69 3e 61 72 65 61 20 n an <b><i>area
3aa0: 6f 66 20 75 73 65 3c 2f 69 3e 3c 2f 62 3e 20 69 of use</i></b> i
3ab0: 73 20 65 78 70 6c 69 63 69 74 6c 79 20 73 75 70 s explicitly sup
3ac0: 70 6c 69 65 64 2c 20 74 68 65 6e 20 3c 62 3e 50 plied, then <b>P
3ad0: 52 4f 4a 2e 36 3c 2f 62 3e 20 6d 61 79 20 65 76 ROJ.6</b> may ev
3ae0: 65 6e 74 75 61 6c 6c 79 20 75 73 65 20 74 68 65 entually use the
3af0: 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 3c corresponding <
3b00: 62 3e 42 42 4f 58 3c 2f 62 3e 20 66 6f 72 20 66 b>BBOX</b> for f
3b10: 69 6e 65 6c 79 20 74 75 6e 69 6e 67 20 74 68 65 inely tuning the
3b20: 20 6d 6f 72 65 20 61 63 63 75 72 61 74 65 20 74 more accurate t
3b30: 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 2e 3c 2f ransformation.</
3b40: 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 li>..<li>the opt
3b50: 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c ional argument <
3b60: 62 3e 6d 65 74 68 6f 64 3c 2f 62 3e 20 69 73 20 b>method</b> is
3b70: 65 78 70 65 63 74 65 64 20 74 6f 20 63 6f 6e 74 expected to cont
3b80: 61 69 6e 20 6f 6e 65 20 74 68 65 20 66 6f 6c 6c ain one the foll
3b90: 6f 77 69 6e 67 20 76 61 6c 75 65 73 20 28 3c 62 owing values (<b
3ba0: 3e 61 75 74 68 5f 6e 61 6d 65 3a 61 75 74 68 5f >auth_name:auth_
3bb0: 73 74 72 69 64 3c 2f 62 3e 20 77 69 6c 6c 20 62 strid</b> will b
3bc0: 65 20 61 6c 77 61 79 73 20 61 73 73 75 6d 65 64 e always assumed
3bd0: 20 61 73 20 74 68 65 20 3c 69 3e 64 65 66 61 75 as the <i>defau
3be0: 6c 74 20 73 65 74 74 69 6e 67 3c 2f 69 3e 29 3a lt setting</i>):
3bf0: 3c 2f 6c 69 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 </li>..<ul>..<li
3c00: 3e 3c 62 3e 70 72 6f 6a 34 74 65 78 74 3c 2f 62 ><b>proj4text</b
3c10: 3e 3a 20 62 6f 74 68 20 43 52 53 65 73 20 28 6f >: both CRSes (o
3c20: 72 69 67 69 6e 20 61 6e 64 20 64 65 73 74 69 6e rigin and destin
3c30: 61 74 69 6f 6e 29 20 77 69 6c 6c 20 62 65 20 64 ation) will be d
3c40: 65 66 69 6e 65 64 20 62 79 20 70 61 73 73 69 6e efined by passin
3c50: 67 20 74 6f 20 50 52 4f 4a 2e 36 20 74 68 65 20 g to PROJ.6 the
3c60: 74 72 61 64 69 74 69 6f 6e 61 6c 73 20 3c 62 3e traditionals <b>
3c70: 70 72 6f 6a 2d 73 74 72 69 6e 67 3c 2f 62 3e 20 proj-string</b>
3c80: 64 65 66 69 6e 69 74 69 6f 6e 73 20 66 6f 72 20 definitions for
3c90: 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e the correspondin
3ca0: 67 20 53 52 49 44 73 20 72 65 74 72 69 65 76 65 g SRIDs retrieve
3cb0: 64 20 66 72 6f 6d 20 63 6f 6c 75 6d 6e 20 3c 62 d from column <b
3cc0: 3e 70 72 6f 6a 34 74 65 78 74 3c 2f 62 3e 20 69 >proj4text</b> i
3cd0: 6e 20 54 61 62 6c 65 20 3c 62 3e 73 70 61 74 69 n Table <b>spati
3ce0: 61 6c 5f 72 65 66 5f 73 79 73 3c 2f 62 3e 3c 62 al_ref_sys</b><b
3cf0: 72 3e 0d 0a 54 68 69 73 20 65 78 61 63 74 6c 79 r>..This exactly
3d00: 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 corresponds to
3d10: 74 68 65 20 77 65 6c 6c 20 65 78 74 61 62 6c 69 the well extabli
3d20: 73 68 65 64 20 74 72 61 64 69 74 69 6f 6e 61 6c shed traditional
3d30: 20 62 65 68 61 76 69 6f 72 20 6f 66 20 61 6c 6c behavior of all
3d40: 20 70 72 65 76 69 6f 75 73 20 76 65 72 73 69 6f previous versio
3d50: 6e 73 20 6f 66 20 3c 62 3e 6c 69 62 73 70 61 74 ns of <b>libspat
3d60: 69 61 6c 69 74 65 3c 2f 62 3e 20 61 6e 64 20 73 ialite</b> and s
3d70: 74 69 6c 6c 20 63 6f 6e 74 69 6e 75 65 73 20 74 till continues t
3d80: 6f 20 62 65 20 73 75 70 70 6f 72 74 65 64 2c 20 o be supported,
3d90: 62 75 74 20 3c 62 3e 3c 75 3e 3c 69 3e 69 73 6e but <b><u><i>isn
3da0: 27 74 20 61 6e 79 20 6c 6f 6e 67 65 72 20 74 68 't any longer th
3db0: 65 20 62 65 73 74 20 77 61 79 20 66 6f 72 20 74 e best way for t
3dc0: 61 6b 69 6e 67 20 66 75 6c 6c 20 70 72 6f 66 69 aking full profi
3dd0: 74 20 6f 66 20 74 68 65 20 6d 6f 72 65 20 61 64 t of the more ad
3de0: 76 61 6e 63 65 64 20 63 61 70 61 62 69 6c 69 74 vanced capabilit
3df0: 69 65 73 20 6f 66 20 50 52 4f 4a 2e 36 3c 2f 69 ies of PROJ.6</i
3e00: 3e 3c 2f 75 3e 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a ></u></b></li>..
3e10: 3c 6c 69 3e 3c 62 3e 73 72 74 65 78 74 3c 2f 62 <li><b>srtext</b
3e20: 3e 3a 20 62 6f 74 68 20 43 52 53 65 73 20 28 6f >: both CRSes (o
3e30: 72 69 67 69 6e 20 61 6e 64 20 64 65 73 74 69 6e rigin and destin
3e40: 61 74 69 6f 6e 29 20 77 69 6c 6c 20 62 65 20 64 ation) will be d
3e50: 65 66 69 6e 65 64 20 62 79 20 70 61 73 73 69 6e efined by passin
3e60: 67 20 74 6f 20 50 52 4f 4a 2e 36 20 74 68 65 20 g to PROJ.6 the
3e70: 3c 62 3e 57 4b 54 3c 2f 62 3e 20 64 65 66 69 6e <b>WKT</b> defin
3e80: 69 74 69 6f 6e 73 20 66 6f 72 20 74 68 65 20 63 itions for the c
3e90: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 53 52 49 orresponding SRI
3ea0: 44 73 20 72 65 74 72 69 65 76 65 64 20 66 72 6f Ds retrieved fro
3eb0: 6d 20 63 6f 6c 75 6d 6e 20 3c 62 3e 73 72 74 65 m column <b>srte
3ec0: 78 74 3c 2f 62 3e 20 69 6e 20 54 61 62 6c 65 20 xt</b> in Table
3ed0: 3c 62 3e 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 <b>spatial_ref_s
3ee0: 79 73 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 ys</b></li>..<li
3ef0: 3e 3c 62 3e 61 75 74 68 5f 6e 61 6d 65 3a 61 75 ><b>auth_name:au
3f00: 74 68 5f 73 72 69 64 3c 2f 62 3e 3a 20 62 6f 74 th_srid</b>: bot
3f10: 68 20 43 52 53 65 73 20 28 6f 72 69 67 69 6e 20 h CRSes (origin
3f20: 61 6e 64 20 64 65 73 74 69 6e 61 74 69 6f 6e 29 and destination)
3f30: 20 77 69 6c 6c 20 62 65 20 64 65 66 69 6e 65 64 will be defined
3f40: 20 62 79 20 69 67 6e 6f 72 69 6e 67 20 74 68 65 by ignoring the
3f50: 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 73 74 6f definitions sto
3f60: 72 65 64 20 69 6e 20 3c 62 3e 73 70 61 74 69 61 red in <b>spatia
3f70: 6c 5f 72 65 66 5f 73 79 73 3c 2f 62 3e 20 61 6e l_ref_sys</b> an
3f80: 64 20 6c 65 61 76 69 6e 67 20 50 52 4f 4a 2e 36 d leaving PROJ.6
3f90: 20 66 72 65 65 20 74 6f 20 72 65 74 72 69 65 76 free to retriev
3fa0: 65 20 74 68 65 69 72 20 63 6f 72 72 65 73 70 6f e their correspo
3fb0: 6e 64 69 6e 67 20 64 65 66 69 6e 69 74 69 6f 6e nding definition
3fc0: 73 20 66 72 6f 6d 20 69 74 73 20 6f 77 6e 20 70 s from its own p
3fd0: 72 69 76 61 74 65 20 53 51 4c 69 74 65 20 64 61 rivate SQLite da
3fe0: 74 61 62 61 73 65 2e 3c 62 72 3e 0d 0a 3c 62 3e tabase.<br>..<b>
3ff0: 3c 75 3e 3c 69 3e 4e 6f 74 65 3c 2f 69 3e 3c 2f <u><i>Note</i></
4000: 75 3e 3c 2f 62 3e 3a 20 74 68 69 73 20 6d 65 74 u></b>: this met
4010: 68 6f 64 20 77 69 6c 6c 20 61 6c 77 61 79 73 20 hod will always
4020: 74 61 6b 65 20 66 75 6c 6c 20 70 72 6f 66 69 74 take full profit
4030: 20 6f 66 20 74 68 65 20 6d 6f 72 65 20 61 64 76 of the more adv
4040: 61 6e 63 65 64 20 63 61 70 61 62 69 6c 69 74 69 anced capabiliti
4050: 65 73 20 6f 66 20 50 52 4f 4a 2e 36 2c 20 65 76 es of PROJ.6, ev
4060: 65 6e 20 77 68 65 6e 20 75 73 69 6e 67 20 73 6f en when using so
4070: 6d 65 20 53 70 61 74 69 61 4c 69 74 65 20 64 61 me SpatiaLite da
4080: 74 61 62 61 73 65 20 63 72 65 61 74 65 64 20 62 tabase created b
4090: 79 20 65 61 72 6c 69 65 72 20 76 65 72 73 69 6f y earlier versio
40a0: 6e 73 20 6e 6f 74 20 79 65 74 20 73 75 70 70 6f ns not yet suppo
40b0: 72 74 69 6e 67 20 50 52 4f 4a 2e 36 3c 2f 6c 69 rting PROJ.6</li
40c0: 3e 0d 0a 3c 6c 69 3e 3c 62 3e 70 72 6f 6a 5f 73 >..<li><b>proj_s
40d0: 74 72 69 6e 67 3c 2f 62 3e 3a 20 61 6e 20 3c 62 tring</b>: an <b
40e0: 3e 3c 69 3e 75 73 65 72 2d 64 65 66 69 6e 65 64 ><i>user-defined
40f0: 20 70 72 6f 6a 2d 73 74 72 69 6e 67 3c 2f 69 3e proj-string</i>
4100: 3c 2f 62 3e 20 28 6d 61 79 20 62 65 20 6f 6e 65 </b> (may be one
4110: 20 64 65 66 69 6e 69 6e 69 6e 67 20 61 20 3c 62 definining a <b
4120: 3e 3c 69 3e 74 72 61 6e 73 66 6f 72 6d 61 74 69 ><i>transformati
4130: 6f 6e 20 70 69 70 65 6c 69 6e 65 3c 2f 69 3e 3c on pipeline</i><
4140: 2f 62 3e 29 20 77 69 6c 6c 20 62 65 20 70 61 73 /b>) will be pas
4150: 73 65 64 20 74 6f 20 50 52 4f 4a 2e 36 3b 20 74 sed to PROJ.6; t
4160: 68 69 73 20 69 73 20 61 6e 20 61 64 76 61 6e 63 his is an advanc
4170: 65 64 20 6f 70 74 69 6f 6e 20 72 65 73 65 72 76 ed option reserv
4180: 65 64 20 74 6f 20 73 6b 69 6c 6c 65 64 20 70 6f ed to skilled po
4190: 77 65 72 20 75 73 65 72 73 2e 3c 2f 6c 69 3e 0d wer users.</li>.
41a0: 0a 3c 2f 75 6c 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 .</ul></li>..<li
41b0: 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72 >the optional ar
41c0: 67 75 6d 65 6e 74 20 3c 62 3e 70 72 6f 6a 5f 73 gument <b>proj_s
41d0: 74 72 69 6e 67 3c 2f 62 3e 20 6d 61 79 20 62 65 tring</b> may be
41e0: 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 28 3c 69 <b>NULL</b> (<i
41f0: 3e 64 65 66 61 75 6c 74 20 73 65 74 74 69 6e 67 >default setting
4200: 3c 2f 69 3e 29 2e 3c 62 72 3e 0d 0a 4f 74 68 65 </i>).<br>..Othe
4210: 72 77 69 73 65 20 69 74 27 73 20 65 78 70 65 63 rwise it's expec
4220: 74 65 64 20 74 6f 20 63 6f 6e 74 61 69 6e 20 61 ted to contain a
4230: 20 76 61 6c 69 64 20 3c 62 3e 50 52 4f 4a 2e 36 valid <b>PROJ.6
4240: 20 3c 69 3e 74 72 61 6e 73 66 6f 72 6d 61 74 69 <i>transformati
4250: 6f 6e 20 73 74 72 69 6e 67 3c 2f 69 3e 3c 2f 62 on string</i></b
4260: 3e 2c 20 6d 61 79 20 77 65 6c 6c 20 62 65 20 63 >, may well be c
4270: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 orresponding to
4280: 61 6e 20 3c 62 3e 3c 69 3e 75 73 65 72 2d 64 65 an <b><i>user-de
4290: 66 69 6e 65 64 20 74 72 61 6e 73 66 6f 72 6d 61 fined transforma
42a0: 74 69 6f 6e 20 70 69 70 65 6c 69 6e 65 3c 2f 69 tion pipeline</i
42b0: 3e 3c 2f 62 3e 2e 0d 0a 4d 65 61 6e 69 6e 67 66 ></b>...Meaningf
42c0: 75 6c 20 6f 6e 6c 79 20 69 6e 20 74 68 65 20 63 ul only in the c
42d0: 61 73 65 20 6f 66 20 3c 62 3e 6d 65 74 68 6f 64 ase of <b>method
42e0: 3d 70 72 6f 6a 5f 73 74 72 69 6e 67 3c 2f 62 3e =proj_string</b>
42f0: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 2f </li>..</ul>..</
4300: 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 td></tr>..<tr><t
4310: 64 20 63 6f 6c 73 70 61 6e 3d 22 33 22 3e 0d 0a d colspan="3">..
4320: 3c 68 33 3e 4e 6f 74 65 73 3c 2f 68 33 3e 0d 0a <h3>Notes</h3>..
4330: 3c 75 6c 3e 0d 0a 3c 6c 69 3e 53 70 61 74 69 61 <ul>..<li>Spatia
4340: 4c 69 74 65 20 64 6f 65 73 20 6e 6f 74 20 63 6f Lite does not co
4350: 6e 73 74 72 61 69 6e 74 73 20 79 6f 75 20 69 6e nstraints you in
4360: 20 61 6e 79 20 77 61 79 20 61 6e 64 20 66 75 6c any way and ful
4370: 6c 79 20 72 65 73 70 65 63 74 73 20 75 73 65 72 ly respects user
4380: 73 20 66 72 65 65 64 6f 6d 20 63 61 72 65 66 75 s freedom carefu
4390: 6c 6c 79 20 61 76 6f 69 64 69 6e 67 20 3c 69 3e lly avoiding <i>
43a0: 61 75 74 6f 2d 6d 61 67 69 63 61 6c 3c 2f 69 3e auto-magical</i>
43b0: 20 61 73 73 75 6d 70 74 69 6f 6e 73 2e 0d 0a 3c assumptions...<
43c0: 75 6c 3e 0d 0a 3c 6c 69 3e 54 68 65 20 6e 65 77 ul>..<li>The new
43d0: 20 3c 62 3e 3c 69 3e 65 78 74 65 6e 64 65 64 20 <b><i>extended
43e0: 73 69 67 6e 61 74 75 72 65 73 3c 2f 69 3e 3c 2f signatures</i></
43f0: 62 3e 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 b> supported by
4400: 3c 62 3e 53 54 5f 54 72 61 6e 73 66 6f 72 6d 3c <b>ST_Transform<
4410: 2f 62 3e 20 63 6c 6f 73 65 6c 79 20 6d 69 6d 69 /b> closely mimi
4420: 63 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e c the most recen
4430: 74 20 50 52 4f 4a 2e 36 20 41 50 49 2c 20 73 6f t PROJ.6 API, so
4440: 20 79 6f 75 20 61 72 65 20 66 72 65 65 20 74 6f you are free to
4450: 20 64 65 66 69 6e 65 20 79 6f 75 72 20 63 6f 6f define your coo
4460: 72 64 69 6e 61 74 65 73 20 74 72 61 6e 73 66 6f rdinates transfo
4470: 72 6d 61 74 69 6f 6e 73 20 69 6e 20 73 65 76 65 rmations in seve
4480: 72 61 6c 20 64 69 66 66 65 72 65 6e 74 20 77 61 ral different wa
4490: 79 73 2e 3c 2f 6c 69 3e 20 0d 0a 3c 6c 69 3e 54 ys.</li> ..<li>T
44a0: 68 65 20 64 65 66 61 75 6c 74 20 62 65 68 61 76 he default behav
44b0: 69 6f 72 20 6f 66 20 53 70 61 74 69 61 4c 69 74 ior of SpatiaLit
44c0: 65 20 77 68 65 6e 20 75 73 69 6e 67 20 50 52 4f e when using PRO
44d0: 4a 2e 36 20 69 73 20 74 6f 20 63 6f 6d 70 6c 65 J.6 is to comple
44e0: 74 65 6c 79 20 69 67 6e 6f 72 65 20 74 68 65 20 tely ignore the
44f0: 43 52 53 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 CRS definitions
4500: 73 74 6f 72 65 64 20 77 69 74 68 69 6e 20 74 68 stored within th
4510: 65 20 69 6e 74 65 72 6e 61 6c 20 74 61 62 6c 65 e internal table
4520: 20 3c 62 3e 73 70 61 74 69 61 6c 5f 72 65 66 5f <b>spatial_ref_
4530: 73 79 73 3c 2f 62 3e 3c 62 72 3e 0d 0a 41 6e 79 sys</b><br>..Any
4540: 20 72 65 71 75 69 72 65 64 20 43 52 53 20 64 65 required CRS de
4550: 66 69 6e 69 74 69 6f 6e 20 77 69 6c 6c 20 62 65 finition will be
4560: 20 61 6c 77 61 79 73 20 72 65 74 72 69 65 76 65 always retrieve
4570: 64 20 66 6f 72 6d 20 74 68 65 20 70 72 69 76 61 d form the priva
4580: 74 65 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 te SQLite databa
4590: 73 65 20 73 75 70 70 6f 72 74 69 6e 67 20 50 52 se supporting PR
45a0: 4f 4a 2e 36 20 28 3c 69 3e 6d 65 74 68 6f 64 3c OJ.6 (<i>method<
45b0: 2f 69 3e 3d 3c 62 3e 61 75 74 68 5f 6e 61 6d 65 /i>=<b>auth_name
45c0: 3a 61 75 74 68 5f 73 72 69 64 3c 2f 62 3e 29 2e :auth_srid</b>).
45d0: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 49 66 20 79 6f </li>..<li>If yo
45e0: 75 20 68 61 76 65 20 61 6e 79 20 67 6f 6f 64 20 u have any good
45f0: 72 65 61 73 6f 6e 20 73 75 67 67 65 73 74 69 6e reason suggestin
4600: 67 20 74 6f 20 64 6f 20 73 75 63 68 20 61 20 74 g to do such a t
4610: 68 69 6e 67 2c 20 79 6f 75 20 61 72 65 20 61 6e hing, you are an
4620: 79 77 61 79 20 66 72 65 65 20 74 6f 20 75 73 65 yway free to use
4630: 20 74 68 65 20 70 72 6f 6a 2d 73 74 72 69 6e 67 the proj-string
4640: 73 20 28 3c 69 3e 6d 65 74 68 6f 64 3c 2f 69 3e s (<i>method</i>
4650: 3d 3c 62 3e 70 72 6f 6a 34 74 65 78 74 3c 2f 62 =<b>proj4text</b
4660: 3e 29 20 6f 72 20 74 68 65 20 57 4b 54 20 64 65 >) or the WKT de
4670: 66 69 6e 69 74 69 6f 6e 73 20 28 3c 69 3e 6d 65 finitions (<i>me
4680: 74 68 6f 64 3c 2f 69 3e 3d 3c 62 3e 73 72 74 65 thod</i>=<b>srte
4690: 78 3c 2f 62 3e 74 29 20 73 74 6f 72 65 64 20 69 x</b>t) stored i
46a0: 6e 74 6f 20 74 68 65 20 69 6e 74 65 72 6e 61 6c nto the internal
46b0: 20 74 61 62 6c 65 20 3c 62 3e 73 70 61 74 69 61 table <b>spatia
46c0: 6c 5f 72 65 66 5f 73 79 73 20 74 61 62 6c 65 3c l_ref_sys table<
46d0: 2f 62 3e 2e 3c 62 72 3e 0d 0a 42 75 74 20 74 68 /b>.<br>..But th
46e0: 69 73 20 69 73 20 75 6e 64 65 72 20 79 6f 75 72 is is under your
46f0: 20 66 75 6c 6c 20 72 65 73 70 6f 6e 73 69 62 69 full responsibi
4700: 6c 69 74 79 2c 20 61 6e 64 20 79 6f 75 20 6d 75 lity, and you mu
4710: 73 74 20 62 65 20 77 65 6c 6c 20 73 65 6c 66 2d st be well self-
4720: 63 6f 6e 73 63 69 6f 75 73 20 6f 66 20 77 68 61 conscious of wha
4730: 74 20 61 72 65 20 79 6f 75 20 64 6f 69 6e 67 2e t are you doing.
4740: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c 69 </li>..</ul></li
4750: 3e 0d 0a 3c 6c 69 3e 53 70 61 74 69 61 4c 69 74 >..<li>SpatiaLit
4760: 65 20 65 6e 63 6f 75 72 61 67 65 73 20 61 6e 64 e encourages and
4770: 20 70 72 6f 6d 6f 74 65 73 20 74 68 65 20 6d 6f promotes the mo
4780: 73 74 20 63 72 65 61 74 69 76 65 20 75 73 65 73 st creative uses
4790: 20 6f 66 20 50 52 4f 4a 2e 36 2c 20 74 68 69 73 of PROJ.6, this
47a0: 20 69 6e 63 6c 75 64 69 6e 67 20 3c 62 3e 74 72 including <b>tr
47b0: 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 ansformation pip
47c0: 65 6c 69 6e 65 73 3c 2f 62 3e 2e 3c 62 72 3e 0d elines</b>.<br>.
47d0: 0a 43 6f 72 72 65 63 74 6c 79 20 75 73 69 6e 67 .Correctly using
47e0: 20 3c 69 3e 6d 65 74 68 6f 64 3c 2f 69 3e 3d 3c <i>method</i>=<
47f0: 62 3e 70 72 6f 6a 5f 73 74 72 69 6e 67 3c 2f 62 b>proj_string</b
4800: 3e 20 66 6f 72 20 63 6f 6d 70 75 74 69 6e 67 20 > for computing
4810: 63 75 73 74 6f 6d 20 74 72 61 6e 73 66 6f 72 6d custom transform
4820: 61 74 69 6f 6e 73 20 69 73 6e 27 74 20 6e 65 63 ations isn't nec
4830: 65 73 73 61 72 69 6c 79 20 73 69 6d 70 6c 65 20 essarily simple
4840: 61 6e 64 20 65 61 73 79 2c 20 62 75 74 20 69 74 and easy, but it
4850: 27 73 20 61 20 62 69 67 20 6f 70 70 6f 72 74 75 's a big opportu
4860: 6e 69 74 79 20 66 6f 72 20 61 6c 6c 20 73 6b 69 nity for all ski
4870: 6c 6c 65 64 20 61 6e 64 20 74 61 6c 65 6e 74 65 lled and talente
4880: 64 20 70 6f 77 65 72 20 75 73 65 72 73 2e 3c 2f d power users.</
4890: 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 3c 62 li>..</ul><br><b
48a0: 72 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a r>..</td></tr>..
48b0: 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 46 65 </table><br>..Fe
48c0: 77 20 70 72 61 63 74 69 63 61 6c 20 53 51 4c 20 w practical SQL
48d0: 65 78 61 6d 70 6c 65 73 3a 0d 0a 3c 76 65 72 62 examples:..<verb
48e0: 61 74 69 6d 3e 0d 0a 2d 2d 20 74 6f 20 45 50 53 atim>..-- to EPS
48f0: 47 3a 33 30 30 33 20 2d 20 64 65 66 61 75 6c 74 G:3003 - default
4900: 20 73 65 74 74 69 6e 67 73 3b 20 69 67 6e 6f 72 settings; ignor
4910: 69 6e 67 20 73 70 61 74 69 61 6c 69 74 65 5f 72 ing spatialite_r
4920: 65 66 5f 73 79 73 20 61 6e 64 20 75 73 69 6e 67 ef_sys and using
4930: 20 74 68 65 20 50 52 4f 4a 2e 36 20 6f 77 6e 20 the PROJ.6 own
4940: 70 72 69 76 61 74 65 20 64 61 74 61 62 61 73 65 private database
4950: 0d 0a 53 45 4c 45 43 54 20 41 73 45 57 4b 54 20 ..SELECT AsEWKT
4960: 28 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 ( ST_Transform(
4970: 4d 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 MakePoint( 11.87
4980: 38 30 35 36 20 2c 20 34 33 2e 34 36 33 30 35 36 8056 , 43.463056
4990: 20 2c 20 34 33 32 36 20 29 20 2c 20 33 30 30 33 , 4326 ) , 3003
49a0: 20 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ));..----------
49b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
49c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 -----------..SRI
49d0: 44 3d 33 30 30 33 3b 50 4f 49 4e 54 28 31 37 33 D=3003;POINT(173
49e0: 32 38 35 32 2e 39 34 32 37 31 36 37 36 39 20 34 2852.942716769 4
49f0: 38 31 36 32 37 37 2e 36 31 37 36 39 30 36 37 34 816277.617690674
4a00: 29 0d 0a 0d 0a 2d 2d 20 74 6f 20 45 50 53 47 3a )....-- to EPSG:
4a10: 33 30 30 33 20 2d 20 4e 55 4c 4c 20 61 72 65 61 3003 - NULL area
4a20: 20 6f 66 20 75 73 65 2c 20 75 73 69 6e 67 20 57 of use, using W
4a30: 4b 54 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 66 KT definitions f
4a40: 72 6f 6d 20 73 70 61 74 69 61 6c 5f 72 65 66 5f rom spatial_ref_
4a50: 73 79 73 2e 73 72 74 65 78 74 0d 0a 53 45 4c 45 sys.srtext..SELE
4a60: 43 54 20 41 73 45 57 4b 54 20 28 20 53 54 5f 54 CT AsEWKT ( ST_T
4a70: 72 61 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f ransform( MakePo
4a80: 69 6e 74 28 20 31 31 2e 38 37 38 30 35 36 20 2c int( 11.878056 ,
4a90: 20 34 33 2e 34 36 33 30 35 36 2c 20 34 33 32 36 43.463056, 4326
4aa0: 20 29 20 2c 20 33 30 30 33 20 2c 20 4e 55 4c 4c ) , 3003 , NULL
4ab0: 20 2c 20 27 73 72 74 65 78 74 27 20 29 29 3b 0d , 'srtext' ));.
4ac0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
4ad0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4ae0: 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d 33 30 30 ------..SRID=300
4af0: 33 3b 50 4f 49 4e 54 28 31 37 33 32 38 35 32 2e 3;POINT(1732852.
4b00: 39 34 32 37 31 36 37 36 39 20 34 38 31 36 32 37 942716769 481627
4b10: 37 2e 36 31 37 36 39 30 36 37 34 29 0d 0a 0d 0a 7.617690674)....
4b20: 2d 2d 20 74 6f 20 45 50 53 47 3a 33 30 30 33 20 -- to EPSG:3003
4b30: 2d 20 4e 55 4c 4c 20 61 72 65 61 20 6f 66 20 75 - NULL area of u
4b40: 73 65 2c 20 75 73 69 6e 67 20 70 72 6f 6a 2d 73 se, using proj-s
4b50: 74 72 69 6e 67 20 64 65 66 69 6e 69 74 69 6f 6e tring definition
4b60: 73 20 66 72 6f 6d 20 73 70 61 74 69 61 6c 5f 72 s from spatial_r
4b70: 65 66 5f 73 79 73 2e 70 72 6f 6a 34 74 65 78 74 ef_sys.proj4text
4b80: 0d 0a 53 45 4c 45 43 54 20 41 73 45 57 4b 54 20 ..SELECT AsEWKT
4b90: 28 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 ( ST_Transform(
4ba0: 4d 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 MakePoint( 11.87
4bb0: 38 30 35 36 20 2c 20 34 33 2e 34 36 33 30 35 36 8056 , 43.463056
4bc0: 2c 20 34 33 32 36 20 29 20 2c 20 33 30 30 33 20 , 4326 ) , 3003
4bd0: 2c 20 4e 55 4c 4c 20 2c 20 27 70 72 6f 6a 34 74 , NULL , 'proj4t
4be0: 65 78 74 27 20 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d ext' ));..------
4bf0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4c00: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d ---------------.
4c10: 0a 53 52 49 44 3d 33 30 30 33 3b 50 4f 49 4e 54 .SRID=3003;POINT
4c20: 28 31 37 33 32 38 35 32 2e 39 34 32 37 31 36 37 (1732852.9427167
4c30: 36 39 20 34 38 31 36 32 37 37 2e 36 31 37 36 39 69 4816277.61769
4c40: 30 36 37 34 29 0d 0a 3c 2f 76 65 72 62 61 74 69 0674)..</verbati
4c50: 6d 3e 0d 0a 54 68 69 73 20 66 69 72 73 74 20 74 m>..This first t
4c60: 65 73 74 20 69 73 20 62 61 73 65 64 20 6f 6e 20 est is based on
4c70: 61 20 6e 65 77 20 53 70 61 74 69 61 4c 69 74 65 a new SpatiaLite
4c80: 20 64 61 74 61 62 61 73 65 20 63 72 65 61 74 65 database create
4c90: 64 20 77 69 74 68 20 66 75 6c 6c 20 50 52 4f 4a d with full PROJ
4ca0: 2e 36 20 73 75 70 70 6f 72 74 2e 20 54 68 65 72 .6 support. Ther
4cb0: 65 20 69 73 6e 27 74 20 61 6e 79 74 68 69 6e 67 e isn't anything
4cc0: 20 77 6f 72 74 68 20 74 6f 20 62 65 20 6e 6f 74 worth to be not
4cd0: 65 64 2c 20 65 78 63 65 70 74 20 74 68 61 74 20 ed, except that
4ce0: 61 6c 6c 20 6d 65 74 68 6f 64 73 20 72 65 74 75 all methods retu
4cf0: 72 6e 20 74 68 65 20 73 61 6d 65 20 72 65 73 75 rn the same resu
4d00: 6c 74 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 76 65 lt.<br><br>..<ve
4d10: 72 62 61 74 69 6d 3e 0d 0a 2d 2d 20 74 6f 20 45 rbatim>..-- to E
4d20: 50 53 47 3a 33 30 30 33 20 2d 20 75 73 69 6e 67 PSG:3003 - using
4d30: 20 61 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f a transformatio
4d40: 6e 20 70 69 70 65 6c 69 6e 65 0d 0a 53 45 4c 45 n pipeline..SELE
4d50: 43 54 20 41 73 45 57 4b 54 20 28 20 53 54 5f 54 CT AsEWKT ( ST_T
4d60: 72 61 6e 73 66 6f 72 6d 28 20 53 77 61 70 43 6f ransform( SwapCo
4d70: 6f 72 64 73 20 28 20 4d 61 6b 65 50 6f 69 6e 74 ords ( MakePoint
4d80: 28 20 31 31 2e 38 37 38 30 35 36 20 2c 20 34 33 ( 11.878056 , 43
4d90: 2e 34 36 33 30 35 36 2c 20 34 33 32 36 20 29 20 .463056, 4326 )
4da0: 29 20 2c 20 33 30 30 33 20 2c 20 4e 55 4c 4c 20 ) , 3003 , NULL
4db0: 2c 20 27 70 72 6f 6a 5f 73 74 72 69 6e 67 27 20 , 'proj_string'
4dc0: 2c 0d 0a 27 2b 70 72 6f 6a 3d 70 69 70 65 6c 69 ,..'+proj=pipeli
4dd0: 6e 65 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a ne ..+step +proj
4de0: 3d 61 78 69 73 73 77 61 70 20 2b 6f 72 64 65 72 =axisswap +order
4df0: 3d 32 2c 31 20 0d 0a 2b 73 74 65 70 20 2b 70 72 =2,1 ..+step +pr
4e00: 6f 6a 3d 75 6e 69 74 63 6f 6e 76 65 72 74 20 2b oj=unitconvert +
4e10: 78 79 5f 69 6e 3d 64 65 67 20 2b 78 79 5f 6f 75 xy_in=deg +xy_ou
4e20: 74 3d 72 61 64 20 0d 0a 2b 73 74 65 70 20 2b 70 t=rad ..+step +p
4e30: 72 6f 6a 3d 70 75 73 68 20 2b 76 5f 33 20 0d 0a roj=push +v_3 ..
4e40: 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 63 61 72 74 +step +proj=cart
4e50: 20 2b 65 6c 6c 70 73 3d 57 47 53 38 34 20 0d 0a +ellps=WGS84 ..
4e60: 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a +step +inv +proj
4e70: 3d 68 65 6c 6d 65 72 74 20 2b 78 3d 2d 31 30 34 =helmert +x=-104
4e80: 2e 31 20 2b 79 3d 2d 34 39 2e 31 20 2b 7a 3d 2d .1 +y=-49.1 +z=-
4e90: 39 2e 39 20 2b 72 78 3d 30 2e 39 37 31 20 2b 72 9.9 +rx=0.971 +r
4ea0: 79 3d 2d 32 2e 39 31 37 20 2b 72 7a 3d 30 2e 37 y=-2.917 +rz=0.7
4eb0: 31 34 20 2b 73 3d 2d 31 31 2e 36 38 20 2b 63 6f 14 +s=-11.68 +co
4ec0: 6e 76 65 6e 74 69 6f 6e 3d 70 6f 73 69 74 69 6f nvention=positio
4ed0: 6e 5f 76 65 63 74 6f 72 20 0d 0a 2b 73 74 65 70 n_vector ..+step
4ee0: 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d 63 61 72 74 +inv +proj=cart
4ef0: 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20 0d 0a 2b +ellps=intl ..+
4f00: 73 74 65 70 20 2b 70 72 6f 6a 3d 70 6f 70 20 2b step +proj=pop +
4f10: 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f v_3 ..+step +pro
4f20: 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 5f 30 3d 30 j=tmerc +lat_0=0
4f30: 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 2e 39 +lon_0=9 +k=0.9
4f40: 39 39 36 20 2b 78 5f 30 3d 31 35 30 30 30 30 30 996 +x_0=1500000
4f50: 20 2b 79 5f 30 3d 30 20 2b 65 6c 6c 70 73 3d 69 +y_0=0 +ellps=i
4f60: 6e 74 6c 27 20 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d ntl' ));..------
4f70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4f80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d ---------------.
4f90: 0a 53 52 49 44 3d 33 30 30 33 3b 50 4f 49 4e 54 .SRID=3003;POINT
4fa0: 28 31 37 33 32 38 35 32 2e 39 34 32 37 31 36 37 (1732852.9427167
4fb0: 36 39 20 34 38 31 36 32 37 37 2e 36 31 37 36 39 69 4816277.61769
4fc0: 30 36 37 34 29 0d 0a 0d 0a 2d 2d 20 74 6f 20 45 0674)....-- to E
4fd0: 50 53 47 3a 33 30 30 33 20 2d 20 75 73 69 6e 67 PSG:3003 - using
4fe0: 20 61 20 63 75 73 74 6f 6d 69 7a 65 64 20 74 72 a customized tr
4ff0: 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 ansformation pip
5000: 65 6c 69 6e 65 0d 0a 53 45 4c 45 43 54 20 41 73 eline..SELECT As
5010: 45 57 4b 54 20 28 20 53 54 5f 54 72 61 6e 73 66 EWKT ( ST_Transf
5020: 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 6e 74 28 20 orm( MakePoint(
5030: 31 31 2e 38 37 38 30 35 36 20 2c 20 34 33 2e 34 11.878056 , 43.4
5040: 36 33 30 35 36 2c 20 34 33 32 36 20 29 20 2c 20 63056, 4326 ) ,
5050: 33 30 30 33 20 2c 20 4e 55 4c 4c 20 2c 20 27 70 3003 , NULL , 'p
5060: 72 6f 6a 5f 73 74 72 69 6e 67 27 20 2c 0d 0a 27 roj_string' ,..'
5070: 2b 70 72 6f 6a 3d 70 69 70 65 6c 69 6e 65 20 20 +proj=pipeline
5080: 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 75 6e ..+step +proj=un
5090: 69 74 63 6f 6e 76 65 72 74 20 2b 78 79 5f 69 6e itconvert +xy_in
50a0: 3d 64 65 67 20 2b 78 79 5f 6f 75 74 3d 72 61 64 =deg +xy_out=rad
50b0: 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 ..+step +proj=p
50c0: 75 73 68 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 ush +v_3 ..+step
50d0: 20 2b 70 72 6f 6a 3d 63 61 72 74 20 2b 65 6c 6c +proj=cart +ell
50e0: 70 73 3d 57 47 53 38 34 20 0d 0a 2b 73 74 65 70 ps=WGS84 ..+step
50f0: 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d 68 65 6c 6d +inv +proj=helm
5100: 65 72 74 20 2b 78 3d 2d 31 30 34 2e 31 20 2b 79 ert +x=-104.1 +y
5110: 3d 2d 34 39 2e 31 20 2b 7a 3d 2d 39 2e 39 20 2b =-49.1 +z=-9.9 +
5120: 72 78 3d 30 2e 39 37 31 20 2b 72 79 3d 2d 32 2e rx=0.971 +ry=-2.
5130: 39 31 37 20 2b 72 7a 3d 30 2e 37 31 34 20 2b 73 917 +rz=0.714 +s
5140: 3d 2d 31 31 2e 36 38 20 2b 63 6f 6e 76 65 6e 74 =-11.68 +convent
5150: 69 6f 6e 3d 70 6f 73 69 74 69 6f 6e 5f 76 65 63 ion=position_vec
5160: 74 6f 72 20 0d 0a 2b 73 74 65 70 20 2b 69 6e 76 tor ..+step +inv
5170: 20 2b 70 72 6f 6a 3d 63 61 72 74 20 2b 65 6c 6c +proj=cart +ell
5180: 70 73 3d 69 6e 74 6c 20 0d 0a 2b 73 74 65 70 20 ps=intl ..+step
5190: 2b 70 72 6f 6a 3d 70 6f 70 20 2b 76 5f 33 20 0d +proj=pop +v_3 .
51a0: 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 74 6d 65 .+step +proj=tme
51b0: 72 63 20 2b 6c 61 74 5f 30 3d 30 20 2b 6c 6f 6e rc +lat_0=0 +lon
51c0: 5f 30 3d 39 20 2b 6b 3d 30 2e 39 39 39 36 20 2b _0=9 +k=0.9996 +
51d0: 78 5f 30 3d 31 35 30 30 30 30 30 20 2b 79 5f 30 x_0=1500000 +y_0
51e0: 3d 30 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c 27 20 =0 +ellps=intl'
51f0: 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ));..-----------
5200: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5210: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 ----------..SRID
5220: 3d 33 30 30 33 3b 50 4f 49 4e 54 28 31 37 33 32 =3003;POINT(1732
5230: 38 35 32 2e 39 34 32 37 31 36 37 36 39 20 34 38 852.942716769 48
5240: 31 36 32 37 37 2e 36 31 37 36 39 30 36 37 34 29 16277.617690674)
5250: 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 54 ..</verbatim>..T
5260: 68 69 73 20 73 65 63 6f 6e 64 20 74 65 73 74 20 his second test
5270: 69 73 20 62 61 73 65 64 20 6f 6e 20 75 73 69 6e is based on usin
5280: 67 20 3c 62 3e 3c 69 3e 74 72 61 6e 73 66 6f 72 g <b><i>transfor
5290: 6d 61 74 69 6f 6e 20 70 69 70 65 6c 69 6e 65 73 mation pipelines
52a0: 3c 2f 69 3e 3c 2f 62 3e 3a 0d 0a 3c 75 6c 3e 0d </i></b>:..<ul>.
52b0: 0a 3c 6c 69 3e 74 68 65 20 66 69 72 73 74 20 71 .<li>the first q
52c0: 75 65 72 79 20 64 69 72 65 63 74 6c 79 20 75 73 uery directly us
52d0: 65 73 20 61 20 70 72 6f 6a 2d 73 74 72 69 6e 67 es a proj-string
52e0: 20 72 65 70 72 65 73 65 6e 74 69 6e 67 20 74 68 representing th
52f0: 65 20 70 69 70 65 6c 69 6e 65 20 61 73 20 64 65 e pipeline as de
5300: 66 69 6e 65 64 20 62 79 20 65 78 65 63 75 74 69 fined by executi
5310: 6e 67 3c 62 72 3e 0d 0a 3c 62 3e 70 72 6f 6a 69 ng<br>..<b>proji
5320: 6e 66 6f 20 20 2d 73 20 45 50 53 47 3a 34 33 32 nfo -s EPSG:432
5330: 36 20 2d 74 20 45 50 53 47 3a 33 30 30 33 20 2d 6 -t EPSG:3003 -
5340: 2d 61 72 65 61 20 20 22 49 74 61 6c 79 20 2d 20 -area "Italy -
5350: 6d 61 69 6e 6c 61 6e 64 22 20 2d 6f 20 70 72 6f mainland" -o pro
5360: 6a 3c 2f 62 3e 3c 62 72 3e 0d 0a 28 77 65 27 6c j</b><br>..(we'l
5370: 6c 20 73 65 65 20 74 68 69 73 20 74 6f 70 69 63 l see this topic
5380: 20 69 6e 20 6d 6f 72 65 20 64 65 70 74 68 20 6f in more depth o
5390: 6e 20 74 68 65 20 6e 65 78 74 20 70 61 72 61 67 n the next parag
53a0: 72 61 70 68 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 raph).</li>..<li
53b0: 3e 74 68 65 20 73 65 63 6f 6e 64 20 71 75 65 72 >the second quer
53c0: 79 20 69 73 20 6a 75 73 74 20 61 20 73 6d 61 6c y is just a smal
53d0: 6c 20 61 64 61 70 74 61 74 69 6f 6e 20 6f 66 20 l adaptation of
53e0: 74 68 65 20 66 69 72 73 74 20 6f 6e 65 3a 0d 0a the first one:..
53f0: 3c 75 6c 3e 0d 0a 3c 6c 69 3e 41 73 20 79 6f 75 <ul>..<li>As you
5400: 20 63 61 6e 20 6e 6f 74 69 63 65 20 74 68 65 20 can notice the
5410: 66 69 72 73 74 20 71 75 65 72 79 20 72 65 71 75 first query requ
5420: 69 72 65 73 20 63 61 6c 6c 69 6e 67 20 3c 62 3e ires calling <b>
5430: 53 77 61 70 43 6f 6f 64 69 6e 61 74 65 73 28 29 SwapCoodinates()
5440: 3c 2f 62 3e 20 62 65 63 61 75 73 65 20 74 68 65 </b> because the
5450: 20 66 69 72 73 74 20 73 74 65 70 20 6f 66 20 74 first step of t
5460: 68 65 20 70 69 70 65 6c 69 6e 65 20 68 61 73 20 he pipeline has
5470: 61 6e 20 3c 62 3e 61 78 69 73 73 77 61 70 3c 2f an <b>axisswap</
5480: 62 3e 20 64 69 72 65 63 74 69 76 65 2e 3c 2f 6c b> directive.</l
5490: 69 3e 0d 0a 3c 6c 69 3e 54 68 65 20 73 65 63 6f i>..<li>The seco
54a0: 6e 64 20 71 75 65 72 79 20 6a 75 73 74 20 61 76 nd query just av
54b0: 6f 69 64 73 20 74 6f 20 63 61 6c 6c 20 3c 62 3e oids to call <b>
54c0: 53 77 61 70 43 6f 6f 72 64 73 28 29 3c 2f 62 3e SwapCoords()</b>
54d0: 20 61 6e 64 20 63 6f 6e 73 65 71 75 65 6e 74 6c and consequentl
54e0: 79 20 74 68 65 20 74 72 61 73 66 6f 72 6d 61 74 y the trasformat
54f0: 69 6f 6e 20 70 69 70 65 6c 69 6e 65 20 73 74 65 ion pipeline ste
5500: 70 20 72 65 6d 6f 76 65 73 20 74 68 69 73 20 66 p removes this f
5510: 69 72 73 74 20 73 74 65 70 20 73 6f 20 74 6f 20 irst step so to
5520: 67 65 74 20 74 68 65 20 73 61 6d 65 20 69 64 65 get the same ide
5530: 6e 74 69 63 61 6c 20 6f 76 65 72 61 6c 6c 20 65 ntical overall e
5540: 66 66 65 63 74 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 ffect.</li>..</u
5550: 6c 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e l></li>..<li><b>
5560: 3c 75 3e 4e 6f 74 65 3c 2f 75 3e 3c 2f 62 3e 3a <u>Note</u></b>:
5570: 20 53 70 61 74 69 61 4c 69 74 65 20 77 69 6c 6c SpatiaLite will
5580: 20 61 6c 77 61 79 73 20 64 6f 20 61 20 62 65 73 always do a bes
5590: 74 20 65 66 66 6f 72 74 20 69 6e 20 6f 72 64 65 t effort in orde
55a0: 72 20 74 6f 20 67 75 65 73 73 20 69 66 20 73 77 r to guess if sw
55b0: 61 70 70 69 6e 67 20 74 68 65 20 63 6f 6f 72 64 apping the coord
55c0: 69 6e 61 74 65 73 20 62 65 66 6f 72 65 20 70 61 inates before pa
55d0: 73 73 69 6e 67 20 74 68 65 6d 20 74 6f 20 50 52 ssing them to PR
55e0: 4f 4a 2e 36 20 69 73 20 72 65 71 75 69 72 65 64 OJ.6 is required
55f0: 20 6f 72 20 6e 6f 74 2e 3c 62 72 3e 0d 0a 42 75 or not.<br>..Bu
5600: 74 20 69 6e 20 74 68 65 20 73 70 65 63 69 66 69 t in the specifi
5610: 63 20 63 61 73 65 20 6f 66 20 61 20 74 72 61 6e c case of a tran
5620: 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 6c sformation pipel
5630: 69 6e 65 20 74 68 69 73 20 74 65 73 74 20 6d 61 ine this test ma
5640: 79 20 65 61 73 69 6c 79 20 66 61 69 6c 2c 20 74 y easily fail, t
5650: 68 75 73 20 72 65 71 75 69 72 69 6e 67 20 74 6f hus requiring to
5660: 20 65 78 70 6c 69 63 69 74 6c 79 20 63 61 6c 6c explicitly call
5670: 20 3c 62 3e 53 77 61 70 43 6f 6f 72 64 73 28 29 <b>SwapCoords()
5680: 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e </b></li>..</ul>
5690: 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c <br>..<table cel
56a0: 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65 6c lspacing="8" cel
56b0: 6c 70 61 64 64 69 6e 67 3d 22 31 36 22 20 62 67 lpadding="16" bg
56c0: 63 6f 6c 6f 72 3d 22 23 63 39 66 66 66 30 22 3e color="#c9fff0">
56d0: 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 68 33 3e ..<tr><td>..<h3>
56e0: 75 73 69 6e 67 20 70 72 6f 6a 69 6e 66 6f 20 66 using projinfo f
56f0: 6f 72 20 64 65 74 65 63 74 69 6e 67 20 74 72 61 or detecting tra
5700: 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 nsformation pipe
5710: 6c 69 6e 65 73 20 61 6e 64 20 73 75 70 70 6f 72 lines and suppor
5720: 74 65 64 20 61 72 65 61 73 20 6f 66 20 75 73 65 ted areas of use
5730: 3c 2f 68 33 3e 0d 0a 3c 76 65 72 62 61 74 69 6d </h3>..<verbatim
5740: 3e 0d 0a 70 72 6f 6a 69 6e 66 6f 20 2d 73 20 45 >..projinfo -s E
5750: 50 53 47 3a 34 33 32 36 20 2d 74 20 45 50 53 47 PSG:4326 -t EPSG
5760: 3a 33 30 30 33 20 2d 6f 20 70 72 6f 6a 20 2d 2d :3003 -o proj --
5770: 73 70 61 74 69 61 6c 2d 74 65 73 74 20 69 6e 74 spatial-test int
5780: 65 72 73 65 63 74 0d 0a 43 61 6e 64 69 64 61 74 ersect..Candidat
5790: 65 20 6f 70 65 72 61 74 69 6f 6e 73 20 66 6f 75 e operations fou
57a0: 6e 64 3a 20 33 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d nd: 3..---------
57b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
57c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 4f 70 ------------..Op
57d0: 65 72 61 74 69 6f 6e 20 6e c2 b0 31 3a 0d 0a 0d eration n..1:...
57e0: 0a 75 6e 6b 6e 6f 77 6e 20 69 64 2c 20 49 6e 76 .unknown id, Inv
57f0: 65 72 73 65 20 6f 66 20 4d 6f 6e 74 65 20 4d 61 erse of Monte Ma
5800: 72 69 6f 20 74 6f 20 57 47 53 20 38 34 20 28 34 rio to WGS 84 (4
5810: 29 20 2b 20 49 74 61 6c 79 20 7a 6f 6e 65 20 31 ) + Italy zone 1
5820: 2c 20 34 20 6d 2c 20 49 74 61 6c 79 20 2d 20 6d , 4 m, Italy - m
5830: 61 69 6e 6c 61 6e 64 0d 0a 0d 0a 50 52 4f 4a 20 ainland....PROJ
5840: 73 74 72 69 6e 67 3a 0d 0a 2b 70 72 6f 6a 3d 70 string:..+proj=p
5850: 69 70 65 6c 69 6e 65 20 0d 0a 2b 73 74 65 70 20 ipeline ..+step
5860: 2b 70 72 6f 6a 3d 61 78 69 73 73 77 61 70 20 2b +proj=axisswap +
5870: 6f 72 64 65 72 3d 32 2c 31 20 0d 0a 2b 73 74 65 order=2,1 ..+ste
5880: 70 20 2b 70 72 6f 6a 3d 75 6e 69 74 63 6f 6e 76 p +proj=unitconv
5890: 65 72 74 20 2b 78 79 5f 69 6e 3d 64 65 67 20 2b ert +xy_in=deg +
58a0: 78 79 5f 6f 75 74 3d 72 61 64 20 0d 0a 2b 73 74 xy_out=rad ..+st
58b0: 65 70 20 2b 70 72 6f 6a 3d 70 75 73 68 20 2b 76 ep +proj=push +v
58c0: 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a _3 ..+step +proj
58d0: 3d 63 61 72 74 20 2b 65 6c 6c 70 73 3d 57 47 53 =cart +ellps=WGS
58e0: 38 34 20 0d 0a 2b 73 74 65 70 20 2b 69 6e 76 20 84 ..+step +inv
58f0: 2b 70 72 6f 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 +proj=helmert +x
5900: 3d 2d 31 30 34 2e 31 20 2b 79 3d 2d 34 39 2e 31 =-104.1 +y=-49.1
5910: 20 2b 7a 3d 2d 39 2e 39 20 2b 72 78 3d 30 2e 39 +z=-9.9 +rx=0.9
5920: 37 31 20 2b 72 79 3d 2d 32 2e 39 31 37 20 2b 72 71 +ry=-2.917 +r
5930: 7a 3d 30 2e 37 31 34 20 2b 73 3d 2d 31 31 2e 36 z=0.714 +s=-11.6
5940: 38 20 2b 63 6f 6e 76 65 6e 74 69 6f 6e 3d 70 6f 8 +convention=po
5950: 73 69 74 69 6f 6e 5f 76 65 63 74 6f 72 20 0d 0a sition_vector ..
5960: 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a +step +inv +proj
5970: 3d 63 61 72 74 20 2b 65 6c 6c 70 73 3d 69 6e 74 =cart +ellps=int
5980: 6c 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d l ..+step +proj=
5990: 70 6f 70 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 pop +v_3 ..+step
59a0: 20 2b 70 72 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61 +proj=tmerc +la
59b0: 74 5f 30 3d 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b t_0=0 +lon_0=9 +
59c0: 6b 3d 30 2e 39 39 39 36 20 2b 78 5f 30 3d 31 35 k=0.9996 +x_0=15
59d0: 30 30 30 30 30 20 2b 79 5f 30 3d 30 20 2b 65 6c 00000 +y_0=0 +el
59e0: 6c 70 73 3d 69 6e 74 6c 0d 0a 0d 0a 2d 2d 2d 2d lps=intl....----
59f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5a00: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5a10: 2d 0d 0a 4f 70 65 72 61 74 69 6f 6e 20 6e c2 b0 -..Operation n..
5a20: 32 3a 0d 0a 0d 0a 75 6e 6b 6e 6f 77 6e 20 69 64 2:....unknown id
5a30: 2c 20 49 6e 76 65 72 73 65 20 6f 66 20 4d 6f 6e , Inverse of Mon
5a40: 74 65 20 4d 61 72 69 6f 20 74 6f 20 57 47 53 20 te Mario to WGS
5a50: 38 34 20 28 32 29 20 2b 20 49 74 61 6c 79 20 7a 84 (2) + Italy z
5a60: 6f 6e 65 20 31 2c 20 34 20 6d 2c 20 49 74 61 6c one 1, 4 m, Ital
5a70: 79 20 2d 20 53 61 72 64 69 6e 69 61 20 6f 6e 73 y - Sardinia ons
5a80: 68 6f 72 65 0d 0a 0d 0a 50 52 4f 4a 20 73 74 72 hore....PROJ str
5a90: 69 6e 67 3a 0d 0a 2b 70 72 6f 6a 3d 70 69 70 65 ing:..+proj=pipe
5aa0: 6c 69 6e 65 20 0d 0a 2b 73 74 65 70 20 2b 70 72 line ..+step +pr
5ab0: 6f 6a 3d 61 78 69 73 73 77 61 70 20 2b 6f 72 64 oj=axisswap +ord
5ac0: 65 72 3d 32 2c 31 20 0d 0a 2b 73 74 65 70 20 2b er=2,1 ..+step +
5ad0: 70 72 6f 6a 3d 75 6e 69 74 63 6f 6e 76 65 72 74 proj=unitconvert
5ae0: 20 2b 78 79 5f 69 6e 3d 64 65 67 20 2b 78 79 5f +xy_in=deg +xy_
5af0: 6f 75 74 3d 72 61 64 20 0d 0a 2b 73 74 65 70 20 out=rad ..+step
5b00: 2b 70 72 6f 6a 3d 70 75 73 68 20 2b 76 5f 33 20 +proj=push +v_3
5b10: 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 63 61 ..+step +proj=ca
5b20: 72 74 20 2b 65 6c 6c 70 73 3d 57 47 53 38 34 20 rt +ellps=WGS84
5b30: 0d 0a 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 ..+step +inv +pr
5b40: 6f 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 3d 2d 31 oj=helmert +x=-1
5b50: 36 38 2e 36 20 2b 79 3d 2d 33 34 20 2b 7a 3d 33 68.6 +y=-34 +z=3
5b60: 38 2e 36 20 2b 72 78 3d 2d 30 2e 33 37 34 20 2b 8.6 +rx=-0.374 +
5b70: 72 79 3d 2d 30 2e 36 37 39 20 2b 72 7a 3d 2d 31 ry=-0.679 +rz=-1
5b80: 2e 33 37 39 20 2b 73 3d 2d 39 2e 34 38 20 2b 63 .379 +s=-9.48 +c
5b90: 6f 6e 76 65 6e 74 69 6f 6e 3d 70 6f 73 69 74 69 onvention=positi
5ba0: 6f 6e 5f 76 65 63 74 6f 72 20 0d 0a 2b 73 74 65 on_vector ..+ste
5bb0: 70 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d 63 61 72 p +inv +proj=car
5bc0: 74 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20 0d 0a t +ellps=intl ..
5bd0: 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 6f 70 20 +step +proj=pop
5be0: 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 +v_3 ..+step +pr
5bf0: 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 5f 30 3d oj=tmerc +lat_0=
5c00: 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 2e 0 +lon_0=9 +k=0.
5c10: 39 39 39 36 20 2b 78 5f 30 3d 31 35 30 30 30 30 9996 +x_0=150000
5c20: 30 20 2b 79 5f 30 3d 30 20 2b 65 6c 6c 70 73 3d 0 +y_0=0 +ellps=
5c30: 69 6e 74 6c 0d 0a 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d intl....--------
5c40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5c50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 4f -------------..O
5c60: 70 65 72 61 74 69 6f 6e 20 6e c2 b0 33 3a 0d 0a peration n..3:..
5c70: 0d 0a 75 6e 6b 6e 6f 77 6e 20 69 64 2c 20 49 6e ..unknown id, In
5c80: 76 65 72 73 65 20 6f 66 20 4d 6f 6e 74 65 20 4d verse of Monte M
5c90: 61 72 69 6f 20 74 6f 20 57 47 53 20 38 34 20 28 ario to WGS 84 (
5ca0: 31 31 29 20 2b 20 49 74 61 6c 79 20 7a 6f 6e 65 11) + Italy zone
5cb0: 20 31 2c 20 31 30 20 6d 2c 20 49 74 61 6c 79 20 1, 10 m, Italy
5cc0: 2d 20 53 69 63 69 6c 79 20 53 74 72 61 69 74 20 - Sicily Strait
5cd0: 77 65 73 74 20 6f 66 20 31 33 c2 b0 45 0d 0a 0d west of 13..E...
5ce0: 0a 50 52 4f 4a 20 73 74 72 69 6e 67 3a 0d 0a 2b .PROJ string:..+
5cf0: 70 72 6f 6a 3d 70 69 70 65 6c 69 6e 65 20 0d 0a proj=pipeline ..
5d00: 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 61 78 69 73 +step +proj=axis
5d10: 73 77 61 70 20 2b 6f 72 64 65 72 3d 32 2c 31 20 swap +order=2,1
5d20: 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 75 6e ..+step +proj=un
5d30: 69 74 63 6f 6e 76 65 72 74 20 2b 78 79 5f 69 6e itconvert +xy_in
5d40: 3d 64 65 67 20 2b 78 79 5f 6f 75 74 3d 72 61 64 =deg +xy_out=rad
5d50: 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 ..+step +proj=p
5d60: 75 73 68 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 ush +v_3 ..+step
5d70: 20 2b 70 72 6f 6a 3d 63 61 72 74 20 2b 65 6c 6c +proj=cart +ell
5d80: 70 73 3d 57 47 53 38 34 20 0d 0a 2b 73 74 65 70 ps=WGS84 ..+step
5d90: 20 2b 70 72 6f 6a 3d 68 65 6c 6d 65 72 74 20 2b +proj=helmert +
5da0: 78 3d 32 33 30 2e 34 37 20 2b 79 3d 35 36 2e 30 x=230.47 +y=56.0
5db0: 38 20 2b 7a 3d 2d 32 32 2e 34 33 20 0d 0a 2b 73 8 +z=-22.43 ..+s
5dc0: 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d 63 tep +inv +proj=c
5dd0: 61 72 74 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20 art +ellps=intl
5de0: 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 6f ..+step +proj=po
5df0: 70 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b p +v_3 ..+step +
5e00: 70 72 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 5f proj=tmerc +lat_
5e10: 30 3d 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 0=0 +lon_0=9 +k=
5e20: 30 2e 39 39 39 36 20 2b 78 5f 30 3d 31 35 30 30 0.9996 +x_0=1500
5e30: 30 30 30 20 2b 79 5f 30 3d 30 20 2b 65 6c 6c 70 000 +y_0=0 +ellp
5e40: 73 3d 69 6e 74 6c 0d 0a 3c 2f 76 65 72 62 61 74 s=intl..</verbat
5e50: 69 6d 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d im>..</td></tr>.
5e60: 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c .</table><br>..<
5e70: 76 65 72 62 61 74 69 6d 3e 0d 0a 2d 2d 20 74 6f verbatim>..-- to
5e80: 20 45 50 53 47 3a 33 30 30 33 20 2d 20 64 65 66 EPSG:3003 - def
5e90: 61 75 6c 74 20 73 65 74 74 69 6e 67 73 2c 20 4e ault settings, N
5ea0: 55 4c 4c 20 61 72 65 61 20 6f 66 20 75 73 65 2c ULL area of use,
5eb0: 20 2d 20 69 67 6e 6f 72 69 6e 67 20 73 70 61 74 - ignoring spat
5ec0: 69 61 6c 69 74 65 5f 72 65 66 5f 73 79 73 20 61 ialite_ref_sys a
5ed0: 6e 64 20 75 73 69 6e 67 20 74 68 65 20 50 52 4f nd using the PRO
5ee0: 4a 2e 36 20 6f 77 6e 20 70 72 69 76 61 74 65 20 J.6 own private
5ef0: 64 61 74 61 62 61 73 65 0d 0a 53 45 4c 45 43 54 database..SELECT
5f00: 20 41 73 45 57 4b 54 20 28 20 53 54 5f 54 72 61 AsEWKT ( ST_Tra
5f10: 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 6e nsform( MakePoin
5f20: 74 28 20 39 2e 31 36 39 34 36 34 2c 20 33 39 2e t( 9.169464, 39.
5f30: 34 37 38 32 37 35 2c 20 34 33 32 36 20 29 2c 20 478275, 4326 ),
5f40: 33 30 30 33 20 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 3003 ));..------
5f50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5f60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d ---------------.
5f70: 0a 53 52 49 44 3d 33 30 30 33 3b 50 4f 49 4e 54 .SRID=3003;POINT
5f80: 28 31 35 31 34 36 30 30 2e 31 33 34 33 32 31 38 (1514600.1343218
5f90: 36 32 20 34 33 36 39 38 37 34 2e 34 38 39 32 36 62 4369874.48926
5fa0: 39 39 35 37 29 0d 0a 0d 0a 2d 2d 20 74 6f 20 45 9957)....-- to E
5fb0: 50 53 47 3a 33 30 30 33 20 2d 20 73 61 6d 65 20 PSG:3003 - same
5fc0: 61 73 20 61 62 6f 76 65 2c 20 62 75 74 20 65 78 as above, but ex
5fd0: 70 6c 69 63 69 74 6c 79 20 64 65 66 69 6e 69 6e plicitly definin
5fe0: 67 20 61 20 73 70 65 63 69 66 69 63 20 61 72 65 g a specific are
5ff0: 61 20 6f 66 20 75 73 65 0d 0a 53 45 4c 45 43 54 a of use..SELECT
6000: 20 41 73 45 57 4b 54 20 28 20 53 54 5f 54 72 61 AsEWKT ( ST_Tra
6010: 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 6e nsform( MakePoin
6020: 74 28 20 39 2e 31 36 39 34 36 34 2c 20 33 39 2e t( 9.169464, 39.
6030: 34 37 38 32 37 35 2c 20 34 33 32 36 20 29 2c 20 478275, 4326 ),
6040: 33 30 30 33 20 2c 20 42 75 69 6c 64 4d 42 52 28 3003 , BuildMBR(
6050: 39 2e 31 20 2c 20 33 39 2e 34 20 2c 20 39 2e 32 9.1 , 39.4 , 9.2
6060: 20 2c 20 33 39 2e 35 20 2c 20 34 33 32 36 20 29 , 39.5 , 4326 )
6070: 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ));..-----------
6080: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6090: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 ----------..SRID
60a0: 3d 33 30 30 33 3b 50 4f 49 4e 54 28 31 35 31 34 =3003;POINT(1514
60b0: 36 30 35 2e 39 38 32 37 36 32 32 34 38 20 34 33 605.982762248 43
60c0: 36 39 38 37 33 2e 30 30 34 32 32 36 39 34 33 29 69873.004226943)
60d0: 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 54 ..</verbatim>..T
60e0: 68 69 72 64 20 61 6e 64 20 6c 61 73 74 20 65 78 hird and last ex
60f0: 61 6d 70 6c 65 2e 20 49 6e 20 73 6f 6d 65 20 63 ample. In some c
6100: 61 73 65 73 20 65 78 70 6c 69 63 69 74 6c 79 20 ases explicitly
6110: 64 65 66 69 6e 69 6e 67 20 61 20 73 70 65 63 69 defining a speci
6120: 66 69 63 20 3c 62 3e 3c 69 3e 61 72 65 61 20 6f fic <b><i>area o
6130: 66 20 75 73 65 3c 2f 69 3e 3c 2f 62 3e 20 6d 61 f use</i></b> ma
6140: 79 20 65 6e 61 62 6c 65 20 50 52 4f 4a 2e 36 20 y enable PROJ.6
6150: 74 6f 20 73 65 6c 65 63 74 20 61 6e 20 6f 70 74 to select an opt
6160: 69 6d 69 7a 65 64 20 74 72 61 6e 73 66 6f 72 6d imized transform
6170: 61 74 69 6f 6e 20 6c 65 61 64 69 6e 67 20 74 6f ation leading to
6180: 20 6d 6f 72 65 20 70 72 65 63 69 73 65 20 72 65 more precise re
6190: 73 75 6c 74 73 2e 3c 62 72 3e 0d 0a 49 6e 20 74 sults.<br>..In t
61a0: 68 69 73 20 65 78 61 6d 70 6c 65 20 77 65 27 76 his example we'v
61b0: 65 20 75 73 65 64 20 61 20 50 6f 69 6e 74 20 6c e used a Point l
61c0: 6f 63 61 74 65 64 20 69 6e 20 53 61 72 64 69 6e ocated in Sardin
61d0: 69 61 2c 20 61 6e 64 20 50 52 4f 4a 2e 36 20 73 ia, and PROJ.6 s
61e0: 75 70 70 6f 72 74 73 20 73 65 76 65 72 61 6c 20 upports several
61f0: 66 6c 61 76 6f 72 73 20 6f 66 20 3c 62 3e 45 50 flavors of <b>EP
6200: 53 47 3a 33 30 30 33 3c 2f 62 3e 20 64 65 70 65 SG:3003</b> depe
6210: 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 73 70 65 nding on the spe
6220: 63 69 66 69 63 20 61 72 65 61 20 6f 66 20 75 73 cific area of us
6230: 65 2e 3c 62 72 3e 0d 0a 3c 62 3e 49 74 61 6c 79 e.<br>..<b>Italy
6240: 20 2d 20 53 61 72 64 69 6e 69 61 20 6f 6e 73 68 - Sardinia onsh
6250: 6f 72 65 3c 2f 62 3e 20 69 73 20 6f 6e 65 20 62 ore</b> is one b
6260: 65 74 77 65 65 6e 20 74 68 65 6d 2c 20 73 6f 20 etween them, so
6270: 61 66 74 65 72 20 73 70 65 63 69 66 79 69 6e 67 after specifying
6280: 20 61 6e 20 65 78 70 6c 69 63 69 74 20 3c 62 3e an explicit <b>
6290: 61 72 65 61 20 6f 66 20 75 73 65 3c 2f 62 3e 20 area of use</b>
62a0: 61 20 6d 6f 72 65 20 70 72 65 63 69 73 65 20 74 a more precise t
62b0: 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 ransformation pi
62c0: 70 65 6c 69 6e 65 20 77 61 73 20 73 65 6c 65 63 peline was selec
62d0: 74 65 64 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 74 ted.<br><br>..<t
62e0: 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 able cellspacing
62f0: 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 ="8" cellpadding
6300: 3d 22 31 36 22 20 62 67 63 6f 6c 6f 72 3d 22 23 ="16" bgcolor="#
6310: 66 66 66 66 64 30 22 3e 0d 0a 3c 74 72 3e 3c 74 ffffd0">..<tr><t
6320: 64 3e 0d 0a 3c 62 3e 3c 75 3e 4c 65 73 73 6f 6e d>..<b><u>Lesson
6330: 20 6c 65 61 72 6e 65 64 3c 2f 75 3e 3c 2f 62 3e learned</u></b>
6340: 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 54 68 65 :..<ul>..<li>The
6350: 20 62 65 73 74 20 6d 6f 64 65 20 66 6f 72 20 74 best mode for t
6360: 61 6b 69 6e 67 20 66 75 6c 6c 20 70 72 6f 66 69 aking full profi
6370: 74 20 66 72 6f 6d 20 50 52 4f 4a 2e 36 20 69 73 t from PROJ.6 is
6380: 20 62 79 20 75 73 69 6e 67 20 3c 69 3e 6d 65 74 by using <i>met
6390: 68 6f 64 3c 2f 69 3e 3d 3c 62 3e 61 75 74 68 5f hod</i>=<b>auth_
63a0: 6e 61 6d 65 3a 61 75 74 68 5f 73 72 69 64 3c 2f name:auth_srid</
63b0: 62 3e 20 28 74 68 61 74 20 69 73 20 74 68 65 20 b> (that is the
63c0: 3c 62 3e 3c 69 3e 64 65 66 61 75 6c 74 20 73 65 <b><i>default se
63d0: 74 74 69 6e 67 3c 2f 69 3e 3c 2f 62 3e 29 2e 3c tting</i></b>).<
63e0: 62 72 3e 0d 0a 54 68 69 73 20 77 61 79 20 79 6f br>..This way yo
63f0: 75 27 6c 6c 20 62 65 20 61 62 73 6f 6c 75 74 65 u'll be absolute
6400: 6c 79 20 73 75 72 65 20 74 68 61 74 20 74 68 65 ly sure that the
6410: 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 61 6e 64 most recent and
6420: 20 66 75 6c 6c 79 20 64 65 74 61 69 6c 65 64 20 fully detailed
6430: 64 65 66 69 6e 69 74 69 6f 6e 73 20 77 69 6c 6c definitions will
6440: 20 62 65 20 61 6c 77 61 79 73 20 72 65 74 72 69 be always retri
6450: 65 76 65 64 20 66 72 6f 6d 20 74 68 65 20 50 52 eved from the PR
6460: 4f 4a 2e 36 20 6f 77 6e 20 64 61 74 61 62 61 73 OJ.6 own databas
6470: 65 20 63 6f 6d 70 6c 65 74 65 6c 79 20 69 67 6e e completely ign
6480: 6f 72 69 6e 67 20 61 6e 79 20 64 65 66 69 6e 69 oring any defini
6490: 74 69 6f 6e 20 28 6d 61 79 20 62 65 20 69 6e 63 tion (may be inc
64a0: 6f 6d 70 6c 65 74 65 20 6f 72 20 6f 62 73 6f 6c omplete or obsol
64b0: 65 74 65 29 20 65 76 65 6e 74 75 61 6c 6c 79 20 ete) eventually
64c0: 73 74 6f 72 65 64 20 69 6e 74 6f 20 74 68 65 20 stored into the
64d0: 3c 62 3e 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 <b>spatial_ref_s
64e0: 79 73 3c 2f 62 3e 20 74 61 62 6c 65 2e 0d 0a 54 ys</b> table...T
64f0: 68 69 73 20 69 73 20 61 20 70 61 72 74 69 63 75 his is a particu
6500: 6c 61 72 79 20 75 73 65 66 75 6c 20 6f 70 74 69 lary useful opti
6510: 6f 6e 20 77 68 65 6e 20 70 72 6f 63 65 73 73 69 on when processi
6520: 6e 67 20 6f 6c 64 65 72 20 64 61 74 61 62 61 73 ng older databas
6530: 65 73 20 62 65 69 6e 67 20 63 72 65 61 74 65 64 es being created
6540: 20 62 79 20 65 61 72 6c 69 65 72 20 76 65 72 73 by earlier vers
6550: 69 6f 6e 73 20 6f 66 20 53 70 61 74 69 61 4c 69 ions of SpatiaLi
6560: 74 65 20 6e 6f 74 20 79 65 74 20 73 75 70 70 6f te not yet suppo
6570: 72 74 69 6e 67 20 50 52 4f 4a 2e 36 3c 2f 6c 69 rting PROJ.6</li
6580: 3e 0d 0a 3c 6c 69 3e 53 70 61 74 69 61 4c 69 74 >..<li>SpatiaLit
6590: 65 20 64 6f 65 73 20 6e 6f 74 20 63 6f 6e 73 74 e does not const
65a0: 72 61 69 6e 74 73 20 79 6f 75 20 69 6e 20 61 6e raints you in an
65b0: 79 20 77 61 79 20 61 6e 64 20 66 75 6c 6c 79 20 y way and fully
65c0: 72 65 73 70 65 63 74 73 20 75 73 65 72 73 20 66 respects users f
65d0: 72 65 65 64 6f 6d 20 63 61 72 65 66 75 6c 6c 79 reedom carefully
65e0: 20 61 76 6f 69 64 69 6e 67 20 3c 69 3e 61 75 74 avoiding <i>aut
65f0: 6f 2d 6d 61 67 69 63 61 6c 3c 2f 69 3e 20 61 73 o-magical</i> as
6600: 73 75 6d 70 74 69 6f 6e 73 2e 3c 62 72 3e 0d 0a sumptions.<br>..
6610: 49 66 20 79 6f 75 20 68 61 76 65 20 61 6e 79 20 If you have any
6620: 67 6f 6f 64 20 72 65 61 73 6f 6e 20 73 75 67 67 good reason sugg
6630: 65 73 74 69 6e 67 20 74 6f 20 64 6f 20 73 75 63 esting to do suc
6640: 68 20 61 20 74 68 69 6e 67 20 79 6f 75 20 61 72 h a thing you ar
6650: 65 20 61 6e 79 77 61 79 20 66 72 65 65 20 74 6f e anyway free to
6660: 20 75 73 65 20 74 68 65 20 70 72 6f 6a 2d 73 74 use the proj-st
6670: 72 69 6e 67 73 20 28 3c 69 3e 6d 65 74 68 6f 64 rings (<i>method
6680: 3c 2f 69 3e 3d 3c 62 3e 70 72 6f 6a 34 74 65 78 </i>=<b>proj4tex
6690: 74 3c 2f 62 3e 29 20 6f 72 20 74 68 65 20 57 4b t</b>) or the WK
66a0: 54 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 28 3c T definitions (<
66b0: 69 3e 6d 65 74 68 6f 64 3c 2f 69 3e 3d 3c 62 3e i>method</i>=<b>
66c0: 73 72 74 65 78 74 3c 2f 62 3e 29 20 73 74 6f 72 srtext</b>) stor
66d0: 65 64 20 69 6e 74 6f 20 74 68 65 20 3c 62 3e 73 ed into the <b>s
66e0: 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 3c 2f patial_ref_sys</
66f0: 62 3e 20 74 61 62 6c 65 2e 3c 62 72 3e 0d 0a 42 b> table.<br>..B
6700: 75 74 20 74 68 69 73 20 69 73 20 75 6e 64 65 72 ut this is under
6710: 20 79 6f 75 72 20 66 75 6c 6c 20 72 65 73 70 6f your full respo
6720: 6e 73 69 62 69 6c 69 74 79 2c 20 61 6e 64 20 79 nsibility, and y
6730: 6f 75 20 6d 75 73 74 20 62 65 20 77 65 6c 6c 20 ou must be well
6740: 73 75 72 65 20 6f 66 20 77 68 61 74 20 61 72 65 sure of what are
6750: 20 79 6f 75 20 64 6f 69 6e 67 2e 3c 2f 6c 69 3e you doing.</li>
6760: 0d 0a 3c 6c 69 3e 53 70 61 74 69 61 4c 69 74 65 ..<li>SpatiaLite
6770: 20 65 6e 63 6f 75 72 61 67 65 73 20 61 6e 64 20 encourages and
6780: 70 72 6f 6d 6f 74 65 73 20 74 68 65 20 6d 6f 73 promotes the mos
6790: 74 20 63 72 65 61 74 69 76 65 20 75 73 65 73 20 t creative uses
67a0: 6f 66 20 50 52 4f 4a 2e 36 2c 20 74 68 69 73 20 of PROJ.6, this
67b0: 69 6e 63 6c 75 64 69 6e 67 20 3c 62 3e 3c 69 3e including <b><i>
67c0: 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 transformation p
67d0: 69 70 65 6c 69 6e 65 73 3c 2f 69 3e 3c 2f 62 3e ipelines</i></b>
67e0: 2e 3c 62 72 3e 0d 0a 43 6f 72 72 65 63 74 6c 79 .<br>..Correctly
67f0: 20 75 73 69 6e 67 20 3c 69 3e 6d 65 74 68 6f 64 using <i>method
6800: 3c 2f 69 3e 3d 3c 62 3e 70 72 6f 6a 5f 73 74 72 </i>=<b>proj_str
6810: 69 6e 67 3c 2f 62 3e 20 66 6f 72 20 63 6f 6d 70 ing</b> for comp
6820: 75 74 69 6e 67 20 63 75 73 74 6f 6d 20 74 72 61 uting custom tra
6830: 6e 73 66 6f 72 6d 61 74 69 6f 6e 73 20 69 73 6e nsformations isn
6840: 27 74 20 6e 65 63 65 73 73 61 72 69 6c 79 20 73 't necessarily s
6850: 69 6d 70 6c 65 20 61 6e 64 20 65 61 73 79 2c 20 imple and easy,
6860: 62 75 74 20 69 74 27 73 20 61 20 62 69 67 20 6f but it's a big o
6870: 70 70 6f 72 74 75 6e 69 74 79 20 66 6f 72 20 61 pportunity for a
6880: 6c 6c 20 73 6b 69 6c 6c 65 64 20 61 6e 64 20 74 ll skilled and t
6890: 61 6c 65 6e 74 65 64 20 70 6f 77 65 72 20 75 73 alented power us
68a0: 65 72 73 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e ers.</li>..</ul>
68b0: 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f ..</td></tr>..</
68c0: 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 68 33 3e table><br>..<h3>
68d0: 4e 65 77 20 61 75 78 69 6c 69 61 72 79 20 53 51 New auxiliary SQ
68e0: 4c 20 66 75 6e 63 74 69 6f 6e 73 20 73 70 65 63 L functions spec
68f0: 69 66 69 63 61 6c 6c 79 20 73 75 70 70 6f 72 74 ifically support
6900: 69 6e 67 20 50 52 4f 4a 2e 36 3c 2f 68 33 3e 0d ing PROJ.6</h3>.
6910: 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 .<table cellspac
6920: 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 ing="8" cellpadd
6930: 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 3d ing="8" bgcolor=
6940: 22 23 65 38 66 66 65 38 22 20 62 6f 72 64 65 72 "#e8ffe8" border
6950: 3d 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 ="1">..<tr><th b
6960: 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 gcolor="#ffb03e"
6970: 3e 53 51 4c 20 46 75 6e 63 74 69 6f 6e 3c 2f 74 >SQL Function</t
6980: 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 h><th bgcolor="#
6990: 66 66 62 30 33 65 22 3e 53 75 70 70 6f 72 74 65 ffb03e">Supporte
69a0: 64 20 61 72 67 75 6d 65 6e 74 73 3c 2f 74 68 3e d arguments</th>
69b0: 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 <th bgcolor="#ff
69c0: 62 30 33 65 22 3e 44 65 73 63 72 69 70 74 69 6f b03e">Descriptio
69d0: 6e 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 n</th></tr>..<tr
69e0: 3e 3c 74 64 3e 3c 62 3e 48 61 73 50 72 6f 6a 36 ><td><b>HasProj6
69f0: 3c 2f 62 3e 28 20 3c 69 3e 76 6f 69 64 3c 2f 69 </b>( <i>void</i
6a00: 3e 20 29 20 3a 20 3c 69 3e 42 6f 6f 6c 65 61 6e > ) : <i>Boolean
6a10: 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4e </i></td>..<td>N
6a20: 6f 6e 65 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 one</td>..<td>Wi
6a30: 6c 6c 20 72 65 74 75 72 6e 20 3c 62 3e 31 3c 2f ll return <b>1</
6a40: 62 3e 20 28 3c 62 3e 54 52 55 45 3c 2f 62 3e 29 b> (<b>TRUE</b>)
6a50: 20 69 66 20 74 68 65 20 6c 69 62 72 61 72 79 20 if the library
6a60: 68 61 73 20 62 65 65 6e 20 62 75 69 6c 74 20 6f has been built o
6a70: 6e 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 20 n <b>PROJ.6</b>
6a80: 28 6f 72 20 61 6e 79 20 6c 61 74 65 72 20 76 65 (or any later ve
6a90: 72 73 69 6f 6e 29 2c 20 6f 74 68 65 72 77 69 73 rsion), otherwis
6aa0: 65 20 3c 62 3e 30 3c 2f 62 3e 20 28 3c 62 3e 46 e <b>0</b> (<b>F
6ab0: 41 4c 53 45 3c 2f 62 3e 29 2e 3c 2f 74 64 3e 3c ALSE</b>).</td><
6ac0: 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 /tr>..<tr><td><b
6ad0: 3e 50 52 4f 4a 5f 47 65 74 4c 61 73 74 45 72 72 >PROJ_GetLastErr
6ae0: 6f 72 4d 73 67 3c 2f 62 3e 28 20 3c 69 3e 76 6f orMsg</b>( <i>vo
6af0: 69 64 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 53 74 id</i> ) : <i>St
6b00: 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c ring</i></td>..<
6b10: 74 64 3e 4e 6f 6e 65 3c 2f 74 64 3e 0d 0a 3c 74 td>None</td>..<t
6b20: 64 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 d>Will return th
6b30: 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 65 72 e most recent er
6b40: 72 6f 72 20 6d 65 73 73 61 67 65 20 72 65 74 75 ror message retu
6b50: 72 6e 65 64 20 62 79 20 50 52 4f 4a 20 28 69 66 rned by PROJ (if
6b60: 20 61 6e 79 29 2e 3c 62 72 3e 0d 0a 3c 62 3e 4e any).<br>..<b>N
6b70: 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 ULL</b> will be
6b80: 72 65 74 75 72 6e 65 64 20 69 66 20 74 68 65 72 returned if ther
6b90: 65 20 69 73 20 6e 6f 20 63 75 72 65 6e 74 6c 79 e is no curently
6ba0: 20 70 65 6e 64 69 6e 67 20 50 52 4f 4a 20 65 72 pending PROJ er
6bb0: 72 6f 72 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a ror.</td></tr>..
6bc0: 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f <tr><td><b>PROJ_
6bd0: 47 65 74 44 61 74 61 62 61 73 65 50 61 74 68 3c GetDatabasePath<
6be0: 2f 62 3e 28 20 3c 69 3e 76 6f 69 64 3c 2f 69 3e /b>( <i>void</i>
6bf0: 20 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e : <i>String</i>
6c00: 29 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4e 6f 6e 65 )</td>..<td>None
6c10: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 </td>..<td>Will
6c20: 72 65 74 75 72 6e 20 74 68 65 20 63 75 72 72 65 return the curre
6c30: 6e 74 6c 79 20 73 65 74 20 70 61 74 68 6e 61 6d ntly set pathnam
6c40: 65 20 6c 65 61 64 69 6e 67 20 74 6f 20 74 68 65 e leading to the
6c50: 20 70 72 69 76 61 74 65 20 50 52 4f 4a 27 73 20 private PROJ's
6c60: 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 2e SQLite database.
6c70: 3c 62 72 3e 0d 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 <br>..<b>NULL</b
6c80: 3e 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e > will be return
6c90: 65 64 20 69 66 20 74 68 65 72 65 20 69 73 20 6e ed if there is n
6ca0: 6f 20 70 72 69 76 61 74 65 20 50 52 4f 4a 27 73 o private PROJ's
6cb0: 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 SQLite database
6cc0: 20 63 75 72 72 65 6e 74 6c 79 20 63 6f 6e 6e 65 currently conne
6cd0: 63 74 65 64 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d cted.</td></tr>.
6ce0: 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a .<tr><td><b>PROJ
6cf0: 5f 53 65 74 44 61 74 61 62 61 73 65 50 61 74 68 _SetDatabasePath
6d00: 3c 2f 62 3e 20 28 20 6e 65 77 5f 70 61 74 68 20 </b> ( new_path
6d10: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 <i>String</i> )
6d20: 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c : <i>String</i><
6d30: 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a 3c 75 6c 3e /td>..<td>..<ul>
6d40: 0d 0a 3c 6c 69 3e 3c 62 3e 6e 65 77 5f 70 61 74 ..<li><b>new_pat
6d50: 68 3c 2f 62 3e 3a 20 61 20 72 65 6c 61 74 69 76 h</b>: a relativ
6d60: 65 20 6f 72 20 61 62 73 6f 6c 75 74 65 20 70 61 e or absolute pa
6d70: 74 68 6e 61 6d 65 20 6c 65 61 64 69 6e 67 20 74 thname leading t
6d80: 6f 20 61 20 76 61 6c 69 64 20 50 52 4f 4a 27 73 o a valid PROJ's
6d90: 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 SQLite database
6da0: 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 74 .</li>..</ul></t
6db0: 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 63 68 61 d>..<td>Will cha
6dc0: 6e 67 65 20 74 68 65 20 63 75 72 72 65 6e 74 6c nge the currentl
6dd0: 79 20 73 65 74 20 70 61 74 68 6e 61 6d 65 20 6c y set pathname l
6de0: 65 61 64 69 6e 67 20 74 6f 20 74 68 65 20 70 72 eading to the pr
6df0: 69 76 61 74 65 20 50 52 4f 4a 27 73 20 53 51 4c ivate PROJ's SQL
6e00: 69 74 65 20 64 61 74 61 62 61 73 65 2e 3c 62 72 ite database.<br
6e10: 3e 0d 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 >..<b>NULL</b> w
6e20: 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 ill be returned
6e30: 69 66 20 74 68 65 20 70 61 73 73 65 64 20 70 61 if the passed pa
6e40: 74 68 20 69 73 20 69 6e 76 61 6c 69 64 2c 20 6f th is invalid, o
6e50: 74 68 65 72 77 69 73 65 20 74 68 65 20 70 61 74 therwise the pat
6e60: 68 20 6f 66 20 74 68 65 20 63 75 72 72 65 6e 74 h of the current
6e70: 6c 79 20 73 65 74 20 70 72 69 76 61 74 65 20 50 ly set private P
6e80: 52 4f 4a 27 73 20 53 51 4c 69 74 65 20 64 61 74 ROJ's SQLite dat
6e90: 61 62 61 73 65 20 77 69 6c 6c 20 62 65 20 72 65 abase will be re
6ea0: 74 75 72 6e 65 64 2e 3c 2f 74 64 3e 3c 2f 74 72 turned.</td></tr
6eb0: 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 >..<tr><td><b>PR
6ec0: 4f 4a 5f 41 73 57 4b 54 3c 2f 62 3e 20 28 20 61 OJ_AsWKT</b> ( a
6ed0: 75 74 68 5f 6e 61 6d 65 20 3c 69 3e 53 74 72 69 uth_name <i>Stri
6ee0: 6e 67 3c 2f 69 3e 20 2c 20 61 75 74 68 5f 73 72 ng</i> , auth_sr
6ef0: 69 64 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 id <i>Integer</i
6f00: 3e 20 29 20 3a 20 3c 69 3e 53 74 72 69 6e 67 3c > ) : <i>String<
6f10: 2f 69 3e 3c 68 72 3e 0d 0a 3c 62 3e 50 52 4f 4a /i><hr>..<b>PROJ
6f20: 5f 41 73 57 4b 54 3c 2f 62 3e 20 28 20 61 75 74 _AsWKT</b> ( aut
6f30: 68 5f 6e 61 6d 65 20 3c 69 3e 53 74 72 69 6e 67 h_name <i>String
6f40: 3c 2f 69 3e 20 2c 20 61 75 74 68 5f 73 72 69 64 </i> , auth_srid
6f50: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 <i>Integer</i>
6f60: 2c 20 77 6b 74 5f 73 74 79 6c 65 20 3c 69 3e 53 , wkt_style <i>S
6f70: 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 tring</i> ) : <i
6f80: 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 68 72 3e 0d >String</i><hr>.
6f90: 0a 3c 62 3e 50 52 4f 4a 5f 41 73 57 4b 54 3c 2f .<b>PROJ_AsWKT</
6fa0: 62 3e 20 28 20 61 75 74 68 5f 6e 61 6d 65 20 3c b> ( auth_name <
6fb0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 61 i>String</i> , a
6fc0: 75 74 68 5f 73 72 69 64 20 3c 69 3e 49 6e 74 65 uth_srid <i>Inte
6fd0: 67 65 72 3c 2f 69 3e 20 2c 20 77 6b 74 5f 73 74 ger</i> , wkt_st
6fe0: 79 6c 65 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 yle <i>String</i
6ff0: 3e 20 2c 20 69 6e 64 65 6e 74 65 64 20 3c 69 3e > , indented <i>
7000: 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 20 29 20 3a 20 Boolean</i> ) :
7010: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 68 72 <i>String</i><hr
7020: 3e 0d 0a 3c 62 3e 50 52 4f 4a 5f 41 73 57 4b 54 >..<b>PROJ_AsWKT
7030: 3c 2f 62 3e 20 28 20 61 75 74 68 5f 6e 61 6d 65 </b> ( auth_name
7040: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c <i>String</i> ,
7050: 20 61 75 74 68 5f 73 72 69 64 20 3c 69 3e 49 6e auth_srid <i>In
7060: 74 65 67 65 72 3c 2f 69 3e 20 2c 20 77 6b 74 5f teger</i> , wkt_
7070: 73 74 79 6c 65 20 3c 69 3e 53 74 72 69 6e 67 3c style <i>String<
7080: 2f 69 3e 20 2c 20 69 6e 64 65 6e 74 65 64 20 3c /i> , indented <
7090: 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 20 2c 20 i>Boolean</i> ,
70a0: 69 6e 64 65 6e 74 61 74 69 6f 6e 20 3c 69 3e 49 indentation <i>I
70b0: 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c nteger</i> ) : <
70c0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 i>String</i></td
70d0: 3e 0d 0a 3c 74 64 3e 3c 75 6c 3e 0d 0a 3c 6c 69 >..<td><ul>..<li
70e0: 3e 3c 62 3e 61 75 74 68 5f 6e 61 6d 65 3c 2f 62 ><b>auth_name</b
70f0: 3e 20 61 6e 64 20 3c 62 3e 61 75 74 68 5f 73 72 > and <b>auth_sr
7100: 69 64 3c 2f 62 3e 20 69 64 65 6e 74 69 66 79 20 id</b> identify
7110: 74 68 65 20 69 6e 74 65 6e 64 65 64 20 43 52 53 the intended CRS
7120: 2e 3c 62 72 3e 0d 0a 3c 62 3e 61 75 74 68 5f 6e .<br>..<b>auth_n
7130: 61 6d 65 3c 2f 62 3e 20 63 61 6e 20 62 65 20 3c ame</b> can be <
7140: 62 3e 4e 55 4c 4c 3c 2f 62 3e 2c 20 61 6e 64 20 b>NULL</b>, and
7150: 69 6e 20 74 68 69 73 20 63 61 73 65 20 3c 62 3e in this case <b>
7160: 45 50 53 47 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 EPSG</b> will be
7170: 20 61 73 73 75 6d 65 64 2e 3c 2f 6c 69 3e 0d 0a assumed.</li>..
7180: 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c <li>the optional
7190: 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e 73 74 79 argument <b>sty
71a0: 6c 65 3c 2f 62 3e 20 64 65 74 65 72 6d 69 6e 65 le</b> determine
71b0: 73 20 77 68 69 63 68 20 73 70 65 63 69 66 69 63 s which specific
71c0: 20 57 4b 54 20 66 6f 72 6d 61 74 20 73 68 6f 75 WKT format shou
71d0: 6c 64 20 62 65 20 61 64 6f 70 74 65 64 2c 20 61 ld be adopted, a
71e0: 6e 64 20 6d 75 73 74 20 62 65 20 6f 6e 65 20 62 nd must be one b
71f0: 65 74 77 65 65 6e 20 3c 62 3e 47 44 41 4c 3c 2f etween <b>GDAL</
7200: 62 3e 2c 20 3c 62 3e 45 53 52 49 3c 2f 62 3e 2c b>, <b>ESRI</b>,
7210: 20 3c 62 3e 49 53 4f 2d 32 30 31 35 3c 2f 62 3e <b>ISO-2015</b>
7220: 20 6f 72 20 3c 62 3e 49 53 4f 2d 32 30 31 38 3c or <b>ISO-2018<
7230: 2f 62 3e 20 28 74 68 69 73 20 6c 61 74 74 65 72 /b> (this latter
7240: 20 62 65 69 6e 67 20 74 68 65 20 64 65 66 61 75 being the defau
7250: 6c 74 20 73 65 74 74 69 6e 67 29 2e 3c 2f 6c 69 lt setting).</li
7260: 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f >..<li>the optio
7270: 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e nal argument <b>
7280: 69 6e 64 65 6e 74 65 64 3c 2f 62 3e 20 69 66 20 indented</b> if
7290: 73 65 74 20 74 6f 20 3c 62 3e 54 52 55 45 3c 2f set to <b>TRUE</
72a0: 62 3e 20 77 69 6c 6c 20 6e 69 63 65 6c 79 20 66 b> will nicely f
72b0: 6f 72 6d 61 74 20 61 20 6d 75 6c 74 69 6c 69 6e ormat a multilin
72c0: 65 20 57 4b 54 20 65 78 70 72 65 73 73 69 6f 6e e WKT expression
72d0: 2c 20 6f 74 68 65 72 77 69 73 65 20 61 20 73 69 , otherwise a si
72e0: 6e 67 6c 65 20 6d 6f 6e 6f 6c 69 74 68 69 63 20 ngle monolithic
72f0: 6c 69 6e 65 20 6c 61 63 6b 69 6e 67 20 61 6e 79 line lacking any
7300: 20 77 68 69 74 65 2d 73 70 61 63 65 20 6f 72 20 white-space or
7310: 6e 65 77 2d 6c 69 6e 65 20 77 69 6c 6c 20 62 65 new-line will be
7320: 20 70 72 69 6e 74 65 64 20 28 74 68 65 20 64 65 printed (the de
7330: 66 61 75 6c 74 20 69 73 20 3c 62 3e 54 52 55 45 fault is <b>TRUE
7340: 3c 2f 62 3e 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 </b>).</li>..<li
7350: 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72 >the optional ar
7360: 67 75 6d 65 6e 74 20 3c 62 3e 69 6e 64 65 6e 74 gument <b>indent
7370: 61 74 69 6f 6e 3c 2f 62 3e 20 64 65 74 65 72 6d ation</b> determ
7380: 69 6e 65 73 20 68 6f 77 20 6d 61 6e 79 20 77 68 ines how many wh
7390: 69 74 65 2d 73 70 61 63 65 73 20 61 72 65 20 74 ite-spaces are t
73a0: 6f 20 62 65 20 75 73 65 64 20 66 6f 72 20 69 6e o be used for in
73b0: 64 65 6e 74 69 6e 67 20 28 6f 6e 6c 79 20 6d 65 denting (only me
73c0: 61 6e 69 6e 67 66 75 6c 20 69 66 20 3c 62 3e 3c aningful if <b><
73d0: 69 3e 69 6e 64 65 6e 74 65 64 3d 54 52 55 45 3c i>indented=TRUE<
73e0: 2f 69 3e 3c 2f 62 3e 3b 20 74 68 65 20 64 65 66 /i></b>; the def
73f0: 61 75 6c 74 20 76 61 6c 75 65 73 20 69 73 20 3c ault values is <
7400: 62 3e 34 3c 2f 62 3e 29 2e 3c 2f 6c 69 3e 0d 0a b>4</b>).</li>..
7410: 3c 2f 75 6c 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e </ul></td>..<td>
7420: 57 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 65 20 Will return the
7430: 57 4b 54 20 65 78 70 72 65 73 73 69 6f 6e 20 63 WKT expression c
7440: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 orresponding to
7450: 61 20 67 69 76 65 6e 20 43 52 53 3b 20 74 68 65 a given CRS; the
7460: 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 77 69 6c definitions wil
7470: 6c 20 62 65 20 74 61 6b 65 6e 20 64 69 72 65 63 l be taken direc
7480: 74 6c 79 20 66 72 6f 6d 20 74 68 65 20 70 72 69 tly from the pri
7490: 76 61 74 65 20 50 52 4f 4a 27 73 20 6f 77 6e 20 vate PROJ's own
74a0: 64 61 74 61 62 61 73 65 2e 3c 62 72 3e 0d 0a 3c database.<br>..<
74b0: 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 b>NULL</b> will
74c0: 62 65 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 66 be returned on f
74d0: 61 69 6c 75 72 65 20 6f 72 20 6f 6e 20 69 6e 76 ailure or on inv
74e0: 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 73 2e 3c alid arguments.<
74f0: 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c /td></tr>..<tr><
7500: 74 64 3e 3c 62 3e 50 52 4f 4a 5f 47 75 65 73 73 td><b>PROJ_Guess
7510: 53 72 69 64 46 72 6f 6d 57 4b 54 3c 2f 62 3e 20 SridFromWKT</b>
7520: 28 20 77 6b 74 5f 65 78 70 72 20 3c 69 3e 53 74 ( wkt_expr <i>St
7530: 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e ring</i> ) : <i>
7540: 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 64 3e Integer</i></td>
7550: 0d 0a 3c 74 64 3e 3c 75 6c 3e 0d 0a 3c 6c 69 3e ..<td><ul>..<li>
7560: 3c 62 3e 77 6b 74 5f 65 78 70 72 3c 2f 62 3e 3a <b>wkt_expr</b>:
7570: 20 74 68 65 20 57 4b 54 20 65 78 70 72 65 73 73 the WKT express
7580: 69 6f 6e 20 74 6f 20 62 65 20 65 76 61 6c 75 61 ion to be evalua
7590: 74 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e ted.</li>..</ul>
75a0: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a 57 69 6c </td>..<td>..Wil
75b0: 6c 20 70 6f 73 73 69 62 6c 79 20 72 65 74 75 72 l possibly retur
75c0: 6e 20 74 68 65 20 3c 62 3e 53 52 49 44 20 76 61 n the <b>SRID va
75d0: 6c 75 65 3c 2f 62 3e 20 63 6f 72 72 65 73 70 6f lue</b> correspo
75e0: 6e 64 69 6e 67 20 74 6f 20 61 20 67 69 76 65 6e nding to a given
75f0: 20 57 4b 54 20 65 78 70 72 65 73 73 69 6f 6e 20 WKT expression
7600: 64 65 66 69 6e 69 6e 67 20 61 20 43 52 53 2e 3c defining a CRS.<
7610: 62 72 3e 0d 0a 3c 62 3e 2d 31 3c 2f 62 3e 20 77 br>..<b>-1</b> w
7620: 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 ill be returned
7630: 69 66 20 6e 6f 20 43 52 53 20 73 75 70 70 6f 72 if no CRS suppor
7640: 74 65 64 20 62 79 20 50 52 4f 4a 2e 36 20 6d 61 ted by PROJ.6 ma
7650: 74 63 68 65 73 20 74 68 65 20 57 4b 54 20 65 78 tches the WKT ex
7660: 70 72 65 73 73 69 6f 6e 2e 3c 62 72 3e 0d 0a 3c pression.<br>..<
7670: 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 b>NULL</b> will
7680: 62 65 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 69 be returned on i
7690: 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 2e nvalid argument.
76a0: 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 ..</td></tr>..<t
76b0: 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f 47 75 r><td><b>PROJ_Gu
76c0: 65 73 73 53 72 69 64 46 72 6f 6d 53 48 50 3c 2f essSridFromSHP</
76d0: 62 3e 20 28 20 66 69 6c 65 6e 61 6d 65 20 3c 69 b> ( filename <i
76e0: 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 >String</i> ) :
76f0: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f <i>Integer</i></
7700: 74 64 3e 0d 0a 3c 74 64 3e 3c 75 6c 3e 0d 0a 3c td>..<td><ul>..<
7710: 6c 69 3e 3c 62 3e 66 69 6c 65 6e 61 6d 65 3c 2f li><b>filename</
7720: 62 3e 3a 20 74 68 65 20 61 62 73 6f 6c 75 74 65 b>: the absolute
7730: 20 6f 72 20 72 65 6c 61 74 69 76 65 20 70 61 74 or relative pat
7740: 68 20 6c 65 61 64 69 6e 67 20 74 6f 20 73 6f 6d h leading to som
7750: 65 20 53 68 61 70 65 66 69 6c 65 2e 3c 62 72 3e e Shapefile.<br>
7760: 0d 0a 4e 6f 74 65 3a 20 65 78 61 63 74 6c 65 79 ..Note: exactley
7770: 20 61 73 20 72 65 71 75 69 72 65 64 20 62 79 20 as required by
7780: 3c 62 3e 3c 69 3e 49 6d 70 6f 72 74 53 48 50 3c <b><i>ImportSHP<
7790: 2f 69 3e 3c 2f 62 3e 28 29 20 3c 62 3e 3c 69 3e /i></b>() <b><i>
77a0: 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 3c 2f 62 3e filename</i></b>
77b0: 20 6d 75 73 74 20 6f 6d 69 74 20 61 6e 79 20 3c must omit any <
77c0: 62 3e 2e 73 68 70 3c 2f 62 3e 2c 20 3c 62 3e 2e b>.shp</b>, <b>.
77d0: 73 68 78 3c 2f 62 3e 2c 20 3c 62 3e 2e 64 62 66 shx</b>, <b>.dbf
77e0: 3c 2f 62 3e 20 6f 72 20 3c 62 3e 2e 70 72 6a 3c </b> or <b>.prj<
77f0: 2f 62 3e 20 73 75 66 66 69 78 2e 3c 2f 6c 69 3e /b> suffix.</li>
7800: 0d 0a 3c 2f 75 6c 3e 3c 2f 74 64 3e 0d 0a 3c 74 ..</ul></td>..<t
7810: 64 3e 0d 0a 57 69 6c 6c 20 70 6f 73 73 69 62 6c d>..Will possibl
7820: 79 20 72 65 74 75 72 6e 20 74 68 65 20 3c 62 3e y return the <b>
7830: 53 52 49 44 20 76 61 6c 75 65 3c 2f 62 3e 20 63 SRID value</b> c
7840: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 orresponding to
7850: 74 68 65 20 43 52 53 20 64 65 66 69 6e 65 64 20 the CRS defined
7860: 62 79 20 74 68 65 20 2e 50 52 4a 20 6d 65 6d 62 by the .PRJ memb
7870: 65 72 20 6f 66 20 74 68 65 20 53 68 61 70 65 66 er of the Shapef
7880: 69 6c 65 2e 3c 62 72 3e 0d 0a 3c 62 3e 2d 31 3c ile.<br>..<b>-1<
7890: 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72 65 74 75 /b> will be retu
78a0: 72 6e 65 64 20 69 66 20 6e 6f 20 43 52 53 20 73 rned if no CRS s
78b0: 75 70 70 6f 72 74 65 64 20 62 79 20 50 52 4f 4a upported by PROJ
78c0: 2e 36 20 6d 61 74 63 68 65 73 20 50 52 4a 20 6d .6 matches PRJ m
78d0: 65 6d 62 65 72 20 6f 66 20 74 68 65 20 53 68 61 ember of the Sha
78e0: 70 65 66 69 6c 65 2e 3c 62 72 3e 0d 0a 3c 62 3e pefile.<br>..<b>
78f0: 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 NULL</b> will be
7900: 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 69 6e 76 returned on inv
7910: 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 2e 3c 68 alid argument.<h
7920: 72 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f r>..<u>Please no
7930: 74 65 20 77 65 6c 6c 3c 2f 75 3e 3a 20 74 68 69 te well</u>: thi
7940: 73 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 6f s SQL function o
7950: 70 65 6e 64 20 74 68 65 20 64 6f 6f 72 20 74 6f pend the door to
7960: 20 6d 61 6e 79 20 70 6f 74 65 6e 74 69 61 6c 20 many potential
7970: 73 65 63 75 72 69 74 79 20 69 73 73 75 65 73 2c security issues,
7980: 20 61 6e 64 20 74 68 75 73 20 69 73 20 61 6c 77 and thus is alw
7990: 61 79 73 20 3c 69 3e 64 69 73 61 62 6c 65 64 20 ays <i>disabled
79a0: 62 79 20 64 65 66 61 75 6c 74 3c 2f 69 3e 2e 3c by default</i>.<
79b0: 62 72 3e 0d 0a 45 78 70 6c 69 63 69 74 6c 79 20 br>..Explicitly
79c0: 73 65 74 74 69 6e 67 20 74 68 65 20 65 6e 76 69 setting the envi
79d0: 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 ronment variable
79e0: 20 3c 62 3e 53 50 41 54 49 41 4c 49 54 45 5f 53 <b>SPATIALITE_S
79f0: 45 43 55 52 49 54 59 3d 72 65 6c 61 78 65 64 3c ECURITY=relaxed<
7a00: 2f 62 3e 20 69 73 20 61 62 73 6f 6c 75 74 65 6c /b> is absolutel
7a10: 79 20 72 65 71 75 69 72 65 64 20 69 6e 20 6f 72 y required in or
7a20: 64 65 72 20 74 6f 20 65 6e 61 62 6c 65 20 74 68 der to enable th
7a30: 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0d 0a 3c 2f is function...</
7a40: 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c td></tr>..</tabl
7a50: 65 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 e><br>..<table c
7a60: 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 ellspacing="8" c
7a70: 65 6c 6c 70 61 64 64 69 6e 67 3d 22 31 36 22 20 ellpadding="16"
7a80: 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 39 bgcolor="#ffffe9
7a90: 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 62 ">..<tr><td>..<b
7aa0: 3e 3c 75 3e 4e 6f 74 65 3c 2f 75 3e 3c 2f 62 3e ><u>Note</u></b>
7ab0: 3a 20 61 6c 6c 20 74 68 65 20 61 62 6f 76 65 20 : all the above
7ac0: 53 51 4c 20 46 75 6e 63 74 69 6f 6e 73 20 77 69 SQL Functions wi
7ad0: 6c 6c 20 62 65 20 61 76 61 69 6c 61 62 6c 65 20 ll be available
7ae0: 6f 6e 6c 79 20 77 68 65 6e 20 53 70 61 74 69 61 only when Spatia
7af0: 6c 69 74 65 2d 35 2e 30 2e 30 20 68 61 73 20 62 lite-5.0.0 has b
7b00: 65 65 6e 20 62 75 69 6c 74 20 61 67 61 69 6e 73 een built agains
7b10: 74 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 20 t <b>PROJ.6</b>
7b20: 28 6f 72 20 61 6e 79 20 73 75 62 73 65 71 75 65 (or any subseque
7b30: 6e 74 20 76 65 72 73 69 6f 6e 29 2e 3c 62 72 3e nt version).<br>
7b40: 0d 0a 49 66 20 53 70 61 74 69 61 4c 69 74 65 2d ..If SpatiaLite-
7b50: 35 2e 30 2e 30 20 68 61 73 20 62 65 65 6e 20 62 5.0.0 has been b
7b60: 75 69 6c 74 20 69 6e 73 74 65 61 64 20 61 67 61 uilt instead aga
7b70: 69 6e 73 74 20 61 6e 79 20 70 72 65 76 69 6f 73 inst any previos
7b80: 75 73 20 76 65 72 73 69 6f 6e 20 28 61 73 20 65 us version (as e
7b90: 2e 67 2e 20 3c 62 3e 50 52 4f 4a 2e 34 3c 2f 62 .g. <b>PROJ.4</b
7ba0: 3e 29 20 61 6e 79 20 61 74 74 65 6d 70 74 20 74 >) any attempt t
7bb0: 6f 20 63 61 6c 6c 20 6f 6e 65 20 6f 66 20 74 68 o call one of th
7bc0: 65 73 65 20 53 51 4c 20 46 75 6e 63 74 69 6f 6e ese SQL Function
7bd0: 73 20 77 69 6c 6c 20 73 69 6d 70 6c 79 20 72 65 s will simply re
7be0: 74 75 72 6e 20 61 20 3c 62 3e 3c 69 3e 3c 75 3e turn a <b><i><u>
7bf0: 6e 6f 20 73 75 63 68 20 66 75 6e 63 74 69 6f 6e no such function
7c00: 3c 2f 75 3e 3c 2f 69 3e 3c 2f 62 3e 20 53 51 4c </u></i></b> SQL
7c10: 20 65 72 72 6f 72 2e 0d 0a 3c 2f 74 64 3e 3c 2f error...</td></
7c20: 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 tr>..</table><br
7c30: 3e 0d 0a 3c 62 3e 50 72 61 63 74 69 63 61 6c 20 >..<b>Practical
7c40: 65 78 61 6d 70 6c 65 73 3a 3c 2f 62 3e 0d 0a 3c examples:</b>..<
7c50: 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 verbatim>..SELEC
7c60: 54 20 50 52 4f 4a 5f 47 65 74 44 61 74 61 62 61 T PROJ_GetDataba
7c70: 73 65 50 61 74 68 28 29 3b 20 20 2d 2d 20 72 65 sePath(); -- re
7c80: 74 72 69 65 76 69 6e 67 20 74 68 65 20 63 75 72 trieving the cur
7c90: 72 65 6e 74 6c 79 20 73 65 74 20 50 52 4f 4a 27 rently set PROJ'
7ca0: 73 20 6f 77 6e 20 64 61 74 61 62 61 73 65 0d 0a s own database..
7cb0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
7cc0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a --------------..
7cd0: 2f 75 73 72 2f 6c 6f 63 61 6c 2f 73 68 61 72 65 /usr/local/share
7ce0: 2f 70 72 6f 6a 2f 70 72 6f 6a 2e 64 62 0d 0a 0d /proj/proj.db...
7cf0: 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f 53 65 74 .SELECT PROJ_Set
7d00: 44 61 74 61 62 61 73 65 50 61 74 68 28 27 2f 68 DatabasePath('/h
7d10: 6f 6d 65 2f 73 61 6e 64 72 6f 2f 6e 6f 74 5f 65 ome/sandro/not_e
7d20: 78 69 73 74 69 6e 67 5f 70 72 6f 6a 2e 64 62 27 xisting_proj.db'
7d30: 29 3b 20 2d 2d 20 6e 6f 6e 20 65 78 69 73 74 69 ); -- non existi
7d40: 6e 67 20 64 61 74 61 62 61 73 65 0d 0a 2d 2d 2d ng database..---
7d50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
7d60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 4e 55 4c -----------..NUL
7d70: 4c 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a L....SELECT PROJ
7d80: 5f 47 65 74 4c 61 73 74 45 72 72 6f 72 4d 73 67 _GetLastErrorMsg
7d90: 28 29 3b 20 2d 2d 20 72 65 74 72 69 65 76 69 6e (); -- retrievin
7da0: 67 20 74 68 65 20 66 61 69 6c 75 72 65 20 63 61 g the failure ca
7db0: 75 73 65 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d use..-----------
7dc0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
7dd0: 2d 2d 2d 0d 0a 70 72 6f 6a 5f 63 6f 6e 74 65 78 ---..proj_contex
7de0: 74 5f 73 65 74 5f 64 61 74 61 62 61 73 65 5f 70 t_set_database_p
7df0: 61 74 68 3a 20 4f 70 65 6e 20 6f 66 20 2f 68 6f ath: Open of /ho
7e00: 6d 65 2f 73 61 6e 64 72 6f 2f 6e 6f 74 5f 65 78 me/sandro/not_ex
7e10: 69 73 74 69 6e 67 5f 70 72 6f 6a 2e 64 62 20 66 isting_proj.db f
7e20: 61 69 6c 65 64 0d 0a 0d 0a 53 45 4c 45 43 54 20 ailed....SELECT
7e30: 50 52 4f 4a 5f 53 65 74 44 61 74 61 62 61 73 65 PROJ_SetDatabase
7e40: 50 61 74 68 28 27 2f 68 6f 6d 65 2f 73 61 6e 64 Path('/home/sand
7e50: 72 6f 2f 76 61 6c 69 64 5f 70 72 6f 6a 2e 64 62 ro/valid_proj.db
7e60: 27 29 3b 20 2d 2d 20 76 61 6c 69 64 20 64 61 74 '); -- valid dat
7e70: 61 62 61 73 65 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d abase..---------
7e80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
7e90: 2d 2d 2d 2d 2d 0d 0a 2f 68 6f 6d 65 2f 73 61 6e -----../home/san
7ea0: 64 72 6f 2f 76 61 6c 69 64 5f 70 72 6f 6a 2e 64 dro/valid_proj.d
7eb0: 62 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a b....SELECT PROJ
7ec0: 5f 41 73 57 4b 54 28 27 45 50 53 47 27 2c 20 34 _AsWKT('EPSG', 4
7ed0: 33 32 36 29 3b 20 2d 2d 20 64 65 66 61 75 6c 74 326); -- default
7ee0: 20 73 65 74 74 69 6e 67 73 3a 20 49 53 4f 2d 32 settings: ISO-2
7ef0: 30 31 38 20 73 74 79 6c 65 2c 20 69 6e 64 65 6e 018 style, inden
7f00: 74 65 64 20 77 69 74 68 20 69 6e 64 65 6e 74 61 ted with indenta
7f10: 74 69 6f 6e 20 34 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d tion 4..--------
7f20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
7f30: 2d 2d 2d 2d 2d 2d 0d 0a 47 45 4f 44 43 52 53 5b ------..GEODCRS[
7f40: 22 57 47 53 20 38 34 22 2c 0d 0a 20 20 20 20 44 "WGS 84",.. D
7f50: 41 54 55 4d 5b 22 57 6f 72 6c 64 20 47 65 6f 64 ATUM["World Geod
7f60: 65 74 69 63 20 53 79 73 74 65 6d 20 31 39 38 34 etic System 1984
7f70: 22 2c 0d 0a 20 20 20 20 20 20 20 20 45 4c 4c 49 ",.. ELLI
7f80: 50 53 4f 49 44 5b 22 57 47 53 20 38 34 22 2c 36 PSOID["WGS 84",6
7f90: 33 37 38 31 33 37 2c 32 39 38 2e 32 35 37 32 32 378137,298.25722
7fa0: 33 35 36 33 2c 0d 0a 20 20 20 20 20 20 20 20 20 3563,..
7fb0: 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d LENGTHUNIT["m
7fc0: 65 74 72 65 22 2c 31 5d 5d 5d 2c 0d 0a 20 20 20 etre",1]]],..
7fd0: 20 50 52 49 4d 45 4d 5b 22 47 72 65 65 6e 77 69 PRIMEM["Greenwi
7fe0: 63 68 22 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 ch",0,..
7ff0: 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 ANGLEUNIT["degre
8000: 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 e",0.01745329251
8010: 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20 43 53 99433]],.. CS
8020: 5b 65 6c 6c 69 70 73 6f 69 64 61 6c 2c 32 5d 2c [ellipsoidal,2],
8030: 0d 0a 20 20 20 20 20 20 20 20 41 58 49 53 5b 22 .. AXIS["
8040: 67 65 6f 64 65 74 69 63 20 6c 61 74 69 74 75 64 geodetic latitud
8050: 65 20 28 4c 61 74 29 22 2c 6e 6f 72 74 68 2c 0d e (Lat)",north,.
8060: 0a 20 20 20 20 20 20 20 20 20 20 20 20 4f 52 44 . ORD
8070: 45 52 5b 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 ER[1],..
8080: 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 ANGLEUNIT["d
8090: 65 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 egree",0.0174532
80a0: 39 32 35 31 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 925199433]],..
80b0: 20 20 20 20 20 20 41 58 49 53 5b 22 67 65 6f 64 AXIS["geod
80c0: 65 74 69 63 20 6c 6f 6e 67 69 74 75 64 65 20 28 etic longitude (
80d0: 4c 6f 6e 29 22 2c 65 61 73 74 2c 0d 0a 20 20 20 Lon)",east,..
80e0: 20 20 20 20 20 20 20 20 20 4f 52 44 45 52 5b 32 ORDER[2
80f0: 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ],..
8100: 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 ANGLEUNIT["degre
8110: 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 e",0.01745329251
8120: 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20 41 52 99433]],.. AR
8130: 45 41 5b 22 57 6f 72 6c 64 22 5d 2c 0d 0a 20 20 EA["World"],..
8140: 20 20 42 42 4f 58 5b 2d 39 30 2c 2d 31 38 30 2c BBOX[-90,-180,
8150: 39 30 2c 31 38 30 5d 2c 0d 0a 20 20 20 20 49 44 90,180],.. ID
8160: 5b 22 45 50 53 47 22 2c 34 33 32 36 5d 5d 0d 0a ["EPSG",4326]]..
8170: 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f 41 73 ..SELECT PROJ_As
8180: 57 4b 54 28 27 45 50 53 47 27 2c 20 34 33 32 36 WKT('EPSG', 4326
8190: 2c 20 27 45 53 52 49 27 2c 20 30 2c 20 30 29 3b , 'ESRI', 0, 0);
81a0: 20 2d 2d 20 45 53 52 49 20 73 74 79 6c 65 2c 20 -- ESRI style,
81b0: 6d 6f 6e 6f 6c 69 74 68 69 63 20 6c 69 6e 65 0d monolithic line.
81c0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
81d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d ---------------.
81e0: 0a 47 45 4f 47 43 53 5b 22 47 43 53 5f 57 47 53 .GEOGCS["GCS_WGS
81f0: 5f 31 39 38 34 22 2c 44 41 54 55 4d 5b 22 44 5f _1984",DATUM["D_
8200: 57 47 53 5f 31 39 38 34 22 2c 53 50 48 45 52 4f WGS_1984",SPHERO
8210: 49 44 5b 22 57 47 53 5f 31 39 38 34 22 2c 36 33 ID["WGS_1984",63
8220: 37 38 31 33 37 2e 30 2c 32 39 38 2e 32 35 37 32 78137.0,298.2572
8230: 32 33 35 36 33 5d 5d 2c 50 52 49 4d 45 4d 5b 22 23563]],PRIMEM["
8240: 47 72 65 65 6e 77 69 63 68 22 2c 30 2e 30 5d 2c Greenwich",0.0],
8250: 55 4e 49 54 5b 22 44 65 67 72 65 65 22 2c 30 2e UNIT["Degree",0.
8260: 30 31 37 34 35 33 32 39 32 35 31 39 39 34 33 33 0174532925199433
8270: 5d 5d 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f ]]....SELECT PRO
8280: 4a 5f 47 75 65 73 73 53 72 69 64 46 72 6f 6d 57 J_GuessSridFromW
8290: 4b 54 28 27 47 45 4f 47 43 53 5b 22 47 43 53 5f KT('GEOGCS["GCS_
82a0: 4d 6f 6e 74 65 5f 4d 61 72 69 6f 5f 52 6f 6d 65 Monte_Mario_Rome
82b0: 22 2c 44 41 54 55 4d 5b 22 44 5f 4d 6f 6e 74 65 ",DATUM["D_Monte
82c0: 5f 4d 61 72 69 6f 22 2c 53 50 48 45 52 4f 49 44 _Mario",SPHEROID
82d0: 5b 22 49 6e 74 65 72 6e 61 74 69 6f 6e 61 6c 5f ["International_
82e0: 31 39 32 34 22 2c 36 33 37 38 33 38 38 2e 30 2c 1924",6378388.0,
82f0: 32 39 37 2e 30 5d 5d 2c 50 52 49 4d 45 4d 5b 22 297.0]],PRIMEM["
8300: 52 6f 6d 65 22 2c 31 32 2e 34 35 32 33 33 33 33 Rome",12.4523333
8310: 33 33 33 33 33 33 5d 2c 55 4e 49 54 5b 22 44 65 333333],UNIT["De
8320: 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 gree",0.01745329
8330: 32 35 31 39 39 34 33 33 5d 5d 27 29 3b 20 0d 0a 25199433]]'); ..
8340: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
8350: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a --------------..
8360: 34 38 30 36 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 4806....SELECT P
8370: 52 4f 4a 5f 47 75 65 73 73 53 72 69 64 46 72 6f ROJ_GuessSridFro
8380: 6d 53 48 50 28 27 2f 68 6f 6d 65 2f 73 61 6e 64 mSHP('/home/sand
8390: 72 6f 2f 74 75 73 63 61 6e 79 5f 73 68 70 2f 70 ro/tuscany_shp/p
83a0: 72 6f 76 32 30 31 31 27 29 3b 20 2d 2d 20 72 65 rov2011'); -- re
83b0: 6d 65 6d 62 65 72 3a 20 72 65 71 75 69 72 65 73 member: requires
83c0: 20 74 6f 20 65 78 70 6c 69 63 69 74 6c 79 20 73 to explicitly s
83d0: 65 74 20 53 50 41 54 49 41 4c 49 54 45 5f 53 45 et SPATIALITE_SE
83e0: 43 55 52 49 54 59 3d 72 65 6c 61 78 65 64 0d 0a CURITY=relaxed..
83f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
8400: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a --------------..
8410: 33 30 30 33 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3003..</verbatim
8420: 3e 0d 0a 3c 62 72 3e 0d 0a 3c 68 72 3e 3c 62 72 >..<br>..<hr><br
8430: 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 >..<table cellsp
8440: 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 acing="8" cellpa
8450: 64 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f dding="8" bgcolo
8460: 72 3d 22 23 66 66 65 30 65 39 22 20 77 69 64 74 r="#ffe0e9" widt
8470: 68 3d 22 31 30 30 25 22 3e 0d 0a 3c 74 72 3e 3c h="100%">..<tr><
8480: 74 68 3e 0d 0a 3c 68 31 3e 49 6d 70 6f 72 74 61 th>..<h1>Importa
8490: 6e 74 20 6e 6f 74 69 63 65 20 66 6f 72 20 57 69 nt notice for Wi
84a0: 6e 64 6f 77 73 20 75 73 65 72 73 3c 2f 68 31 3e ndows users</h1>
84b0: 0d 0a 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 ..</th></tr>..<t
84c0: 72 3e 3c 74 64 3e 0d 0a 3c 62 3e 50 52 4f 4a 2e r><td>..<b>PROJ.
84d0: 36 3c 2f 62 3e 20 63 72 69 74 69 63 61 6c 6c 79 6</b> critically
84e0: 20 64 65 70 65 6e 64 73 20 6f 6e 20 69 74 73 20 depends on its
84f0: 6f 77 6e 20 70 72 69 76 61 74 65 20 53 51 4c 69 own private SQLi
8500: 74 65 20 64 61 74 61 62 61 73 65 20 28 3c 62 3e te database (<b>
8510: 70 72 6f 6a 2e 64 62 3c 2f 62 3e 29 20 63 6f 6e proj.db</b>) con
8520: 74 61 69 6e 69 6e 67 20 61 6c 6c 20 72 65 6c 65 taining all rele
8530: 76 61 6e 74 20 64 65 66 69 6e 69 74 69 6f 6e 73 vant definitions
8540: 20 61 62 6f 75 74 20 45 6c 6c 69 70 73 6f 69 64 about Ellipsoid
8550: 73 2c 20 50 72 69 6d 65 20 4d 65 72 69 64 69 61 s, Prime Meridia
8560: 6e 73 2c 20 43 52 53 65 73 2c 20 54 72 61 6e 73 ns, CRSes, Trans
8570: 66 6f 72 6d 61 74 69 6f 6e 73 20 61 6e 64 20 61 formations and a
8580: 6c 69 6b 65 2e 3c 62 72 3e 0d 0a 49 66 20 50 52 like.<br>..If PR
8590: 4f 4a 2e 36 20 69 73 20 75 6e 61 62 6c 65 20 74 OJ.6 is unable t
85a0: 6f 20 63 6f 72 72 65 63 74 6c 79 20 65 73 74 61 o correctly esta
85b0: 62 6c 69 73 68 20 61 20 63 6f 6e 6e 65 63 74 69 blish a connecti
85c0: 6f 6e 20 74 6f 20 74 68 69 73 20 64 61 74 61 62 on to this datab
85d0: 61 73 65 20 69 74 20 77 69 6c 6c 20 62 65 20 73 ase it will be s
85e0: 65 76 65 72 65 6c 79 20 6c 69 6d 69 74 65 64 20 everely limited
85f0: 61 6e 64 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 and will not be
8600: 61 62 6c 65 20 74 6f 20 63 6f 72 72 65 63 74 6c able to correctl
8610: 79 20 62 65 68 61 76 65 20 61 73 20 65 78 70 65 y behave as expe
8620: 63 74 65 64 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c cted.<br><br>..<
8630: 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 3c 75 3e 3c ul>..<li><b><u><
8640: 69 3e 53 68 6f 72 74 20 63 6f 6e 63 6c 75 73 69 i>Short conclusi
8650: 6f 6e 3c 2f 69 3e 3c 2f 75 3e 3c 2f 62 3e 3a 20 on</i></u></b>:
8660: 69 6e 73 74 61 6c 6c 69 6e 67 20 74 68 65 20 73 installing the s
8670: 6f 66 74 77 61 72 65 20 61 6c 6f 6e 65 20 69 73 oftware alone is
8680: 20 6e 6f 74 20 65 6e 6f 75 67 68 2e 3c 62 72 3e not enough.<br>
8690: 0d 0a 54 68 65 20 50 52 4f 4a 2e 36 20 70 72 69 ..The PROJ.6 pri
86a0: 76 61 74 65 20 64 61 74 61 62 61 73 65 20 3c 62 vate database <b
86b0: 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20 6d 75 73 >proj.db</b> mus
86c0: 74 20 62 65 20 70 72 6f 70 65 72 6c 79 20 69 6e t be properly in
86d0: 73 74 61 6c 6c 65 64 20 61 73 20 77 65 6c 6c 2c stalled as well,
86e0: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 65 6e 73 in order to ens
86f0: 75 72 65 20 74 68 61 74 20 61 6e 79 74 68 69 6e ure that anythin
8700: 67 20 72 75 6e 73 20 73 6d 6f 6f 74 68 6c 79 2e g runs smoothly.
8710: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e </li>..</ul><br>
8720: 0d 0a 54 68 69 73 20 69 73 6e 27 74 20 75 73 75 ..This isn't usu
8730: 61 6c 6c 79 20 61 20 62 69 67 20 69 73 73 75 65 ally a big issue
8740: 20 6f 6e 20 4c 69 6e 75 78 20 61 6e 64 20 55 6e on Linux and Un
8750: 69 78 2d 6c 69 6b 65 20 70 6c 61 74 66 6f 72 6d ix-like platform
8760: 73 2c 20 77 68 65 72 65 20 61 20 72 61 74 69 6f s, where a ratio
8770: 6e 61 6c 20 61 6e 64 20 76 65 72 79 20 63 6c 65 nal and very cle
8780: 61 72 20 66 69 6c 65 73 79 73 74 65 6d 20 6c 61 ar filesystem la
8790: 79 6f 75 74 20 65 78 69 73 74 73 2e 3c 62 72 3e yout exists.<br>
87a0: 0d 0a 4f 6e 20 74 68 65 73 65 20 6f 70 65 72 61 ..On these opera
87b0: 74 69 6e 67 20 73 79 73 74 65 6d 73 20 74 68 65 ting systems the
87c0: 20 70 61 63 6b 61 67 65 20 6d 61 6e 61 67 65 72 package manager
87d0: 20 28 6f 72 20 3c 62 3e 6d 61 6b 65 20 69 6e 73 (or <b>make ins
87e0: 74 61 6c 6c 3c 2f 62 3e 29 20 77 69 6c 6c 20 61 tall</b>) will a
87f0: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 74 61 6b utomatically tak
8800: 65 20 63 61 72 65 20 74 6f 20 69 6e 73 74 61 6c e care to instal
8810: 6c 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e l <b>proj.db</b>
8820: 20 6f 6e 20 74 68 65 20 6d 6f 73 74 20 61 70 70 on the most app
8830: 72 6f 70 72 69 61 74 65 20 64 69 72 65 63 74 6f ropriate directo
8840: 72 79 20 28 75 73 75 61 6c 6c 79 20 61 73 20 3c ry (usually as <
8850: 62 3e 2f 75 73 72 2f 73 68 61 72 65 2f 70 72 6f b>/usr/share/pro
8860: 6a 2f 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20 6f 72 j/proj.db</b> or
8870: 20 61 73 20 3c 62 3e 2f 75 73 72 2f 6c 6f 63 61 as <b>/usr/loca
8880: 6c 2f 73 68 61 72 65 2f 70 72 6f 6a 2f 70 72 6f l/share/proj/pro
8890: 6a 2e 64 62 3c 2f 62 3e 29 20 61 6e 64 20 74 68 j.db</b>) and th
88a0: 61 74 27 73 20 61 6c 6c 2e 3c 62 72 3e 3c 62 72 at's all.<br><br
88b0: 3e 0d 0a 54 68 69 6e 67 73 20 61 72 65 20 75 6e >..Things are un
88c0: 68 61 70 70 69 6c 79 20 61 20 6c 69 74 74 6c 65 happily a little
88d0: 20 62 69 74 20 6d 6f 72 65 20 64 69 66 66 69 63 bit more diffic
88e0: 75 6c 74 73 20 6f 6e 20 57 69 6e 64 6f 77 73 20 ults on Windows
88f0: 70 6c 61 74 66 6f 72 6d 73 2e 0d 0a 54 68 65 20 platforms...The
8900: 75 73 65 72 20 69 74 73 65 6c 66 20 69 73 20 72 user itself is r
8910: 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 70 esponsible for p
8920: 72 6f 70 65 72 6c 79 20 69 6e 73 74 61 6c 6c 69 roperly installi
8930: 6e 67 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 ng <b>proj.db</b
8940: 3e 0d 0a 53 6f 20 69 74 20 62 65 63 6f 6d 65 73 >..So it becomes
8950: 20 63 72 69 74 69 63 61 6c 20 75 6e 64 65 72 73 critical unders
8960: 74 61 6e 64 69 6e 67 20 74 68 65 20 62 61 73 69 tanding the basi
8970: 63 20 72 75 6c 65 73 20 61 64 6f 70 74 65 64 20 c rules adopted
8980: 62 79 20 3c 62 3e 6c 69 62 73 70 61 74 69 61 6c by <b>libspatial
8990: 69 74 65 3c 2f 62 3e 20 69 6e 20 6f 72 64 65 72 ite</b> in order
89a0: 20 74 6f 20 70 72 6f 70 65 72 6c 79 20 6c 6f 63 to properly loc
89b0: 61 74 65 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f ate <b>proj.db</
89c0: 62 3e 20 6f 6e 20 57 69 6e 64 6f 77 73 2e 0d 0a b> on Windows...
89d0: 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e </td></tr>..<tr>
89e0: 3c 74 68 3e 0d 0a 3c 68 32 3e 57 68 65 72 65 20 <th>..<h2>Where
89f0: 70 72 6f 6a 2e 64 62 20 69 73 20 65 78 70 65 63 proj.db is expec
8a00: 74 65 64 20 74 6f 20 62 65 20 66 6f 75 6e 64 20 ted to be found
8a10: 6f 6e 20 57 69 6e 64 6f 77 73 3c 2f 68 32 3e 0d on Windows</h2>.
8a20: 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 .</td></tr>..<tr
8a30: 3e 3c 74 64 3e 0d 0a 3c 6f 6c 3e 0d 0a 3c 6c 69 ><td>..<ol>..<li
8a40: 3e 74 68 65 20 66 69 72 73 74 20 70 6c 61 63 65 >the first place
8a50: 20 77 68 65 72 65 20 3c 62 3e 70 72 6f 6a 2e 64 where <b>proj.d
8a60: 62 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 73 65 b</b> will be se
8a70: 61 72 63 68 65 64 20 69 73 20 74 68 65 20 73 61 arched is the sa
8a80: 6d 65 20 66 6f 6c 64 65 72 20 66 6f 72 6d 20 77 me folder form w
8a90: 68 65 72 65 20 74 68 65 20 3c 62 3e 45 58 45 3c here the <b>EXE<
8aa0: 2f 62 3e 20 62 69 6e 61 72 79 20 77 61 73 20 69 /b> binary was i
8ab0: 6e 69 74 69 61 6c 6c 79 20 6c 6f 61 64 65 64 2e nitially loaded.
8ac0: 3c 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 45 78 61 6d <br>..<i><u>Exam
8ad0: 70 6c 65 3c 2f 69 3e 3c 2f 75 3e 3a 20 61 73 73 ple</i></u>: ass
8ae0: 75 6d 69 6e 67 20 74 68 61 74 20 79 6f 75 20 61 uming that you a
8af0: 72 65 20 63 75 72 72 65 6e 74 6c 79 20 65 78 65 re currently exe
8b00: 63 75 74 69 6e 67 20 3c 62 3e 43 3a 5c 6d 79 70 cuting <b>C:\myp
8b10: 72 6f 67 73 5c 73 70 61 74 69 61 6c 69 74 65 5c rogs\spatialite\
8b20: 62 69 6e 5c 73 70 61 74 69 61 6c 69 74 65 2e 65 bin\spatialite.e
8b30: 78 65 3c 2f 62 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c xe</b>..<ul>..<l
8b40: 69 3e 74 68 65 6e 20 61 6e 20 61 74 74 65 6d 70 i>then an attemp
8b50: 74 20 77 69 6c 6c 20 62 65 20 6d 61 64 65 20 74 t will be made t
8b60: 6f 20 63 6f 6e 6e 65 63 74 20 3c 62 3e 43 3a 5c o connect <b>C:\
8b70: 6d 79 70 72 6f 67 73 5c 73 70 61 74 69 61 6c 69 myprogs\spatiali
8b80: 74 65 5c 62 69 6e 5c 70 72 6f 6a 2e 64 62 3c 2f te\bin\proj.db</
8b90: 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f b></li>..</ul></
8ba0: 6c 69 3e 0d 0a 3c 6c 69 3e 61 20 73 65 63 6f 6e li>..<li>a secon
8bb0: 64 20 61 74 74 65 6d 70 74 20 77 69 6c 6c 20 62 d attempt will b
8bc0: 65 20 6d 61 64 65 20 6f 6e 20 62 65 68 61 6c 66 e made on behalf
8bd0: 20 6f 66 20 74 68 65 20 3c 62 3e 50 75 62 6c 69 of the <b>Publi
8be0: 63 3c 2f 62 3e 20 66 6f 6c 64 65 72 2e 3c 62 72 c</b> folder.<br
8bf0: 3e 0d 0a 3c 69 3e 3c 75 3e 45 78 61 6d 70 6c 65 >..<i><u>Example
8c00: 3c 2f 75 3e 3c 2f 69 3e 3a 20 61 6e 20 61 74 74 </u></i>: an att
8c10: 65 6d 70 74 20 77 69 6c 6c 20 62 65 20 6d 61 64 empt will be mad
8c20: 65 20 74 6f 20 63 6f 6e 6e 65 63 74 20 3c 62 3e e to connect <b>
8c30: 43 3a 5c 55 73 65 72 73 5c 50 75 62 6c 69 63 5c C:\Users\Public\
8c40: 73 70 61 74 69 61 6c 69 74 65 5c 70 72 6f 6a 5c spatialite\proj\
8c50: 70 72 6f 6a 2e 64 62 3c 2f 62 3e 3c 2f 6c 69 3e proj.db</b></li>
8c60: 0d 0a 3c 6c 69 3e 61 20 74 68 69 72 64 20 28 61 ..<li>a third (a
8c70: 6e 64 20 6c 61 73 74 29 20 61 74 74 65 6d 70 74 nd last) attempt
8c80: 20 77 69 6c 6c 20 62 65 20 6d 61 64 65 20 6f 6e will be made on
8c90: 20 62 65 68 61 6c 66 20 6f 66 20 74 68 65 20 3c behalf of the <
8ca0: 62 3e 55 73 65 72 3c 2f 62 3e 20 66 6f 6c 64 65 b>User</b> folde
8cb0: 72 2e 3c 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 45 78 r.<br>..<i><u>Ex
8cc0: 61 6d 70 6c 65 3c 2f 69 3e 3c 2f 75 3e 3a 20 61 ample</i></u>: a
8cd0: 6e 20 61 74 74 65 6d 70 74 20 77 69 6c 6c 20 62 n attempt will b
8ce0: 65 20 6d 61 64 65 20 74 6f 20 63 6f 6e 6e 65 63 e made to connec
8cf0: 74 20 3c 62 3e 43 3a 5c 55 73 65 72 73 5c 73 61 t <b>C:\Users\sa
8d00: 6e 64 72 6f 5c 73 70 61 74 69 61 6c 69 74 65 5c ndro\spatialite\
8d10: 70 72 6f 6a 5c 70 72 6f 6a 2e 64 62 3c 2f 62 3e proj\proj.db</b>
8d20: 3c 2f 6c 69 3e 0d 0a 3c 2f 6f 6c 3e 0d 0a 3c 68 </li>..</ol>..<h
8d30: 33 3e 41 6e 20 75 73 65 66 75 6c 20 64 69 61 67 3>An useful diag
8d40: 6e 6f 73 74 69 63 20 63 68 65 63 6b 3c 2f 68 33 nostic check</h3
8d50: 3e 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 >..<verbatim>..S
8d60: 45 4c 45 43 54 20 50 52 4f 4a 5f 47 65 74 44 61 ELECT PROJ_GetDa
8d70: 74 61 62 61 73 65 50 61 74 68 28 29 3b 0d 0a 3c tabasePath();..<
8d80: 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 3c 75 6c 3e /verbatim>..<ul>
8d90: 0d 0a 3c 6c 69 3e 69 66 20 3c 62 3e 4e 55 4c 4c ..<li>if <b>NULL
8da0: 3c 2f 62 3e 20 69 73 20 72 65 74 75 72 6e 65 64 </b> is returned
8db0: 2c 20 74 68 65 6e 20 50 52 4f 4a 2e 36 20 69 73 , then PROJ.6 is
8dc0: 20 64 65 66 69 6e 69 74 65 6c 79 20 75 6e 61 62 definitely unab
8dd0: 6c 65 20 74 6f 20 63 6f 6e 6e 65 63 74 20 74 6f le to connect to
8de0: 20 69 74 73 20 6f 77 6e 20 70 72 69 76 61 74 65 its own private
8df0: 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 SQLite database
8e00: 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e 3c <b>proj.db</b><
8e10: 62 72 3e 0d 0a 59 6f 75 20 68 61 76 65 20 74 6f br>..You have to
8e20: 20 63 61 72 65 66 75 6c 6c 79 20 76 65 72 69 66 carefully verif
8e30: 69 79 20 74 68 61 74 20 69 74 27 73 20 72 65 61 iy that it's rea
8e40: 6c 6c 79 20 69 6e 73 74 61 6c 6c 65 64 20 6f 6e lly installed on
8e50: 20 6f 6e 65 20 6f 66 20 74 68 65 20 65 78 70 65 one of the expe
8e60: 63 74 65 64 20 73 74 61 6e 64 61 72 64 20 6c 6f cted standard lo
8e70: 63 61 74 69 6f 6e 73 2e 3c 2f 6c 69 3e 0d 0a 3c cations.</li>..<
8e80: 6c 69 3e 6f 74 68 65 72 77 69 73 65 20 74 68 65 li>otherwise the
8e90: 20 70 61 74 68 20 6c 65 61 64 69 6e 67 20 74 6f path leading to
8ea0: 20 74 68 65 20 63 75 72 72 65 6e 74 6c 79 20 63 the currently c
8eb0: 6f 6e 6e 65 63 74 65 64 20 3c 62 3e 70 72 6f 6a onnected <b>proj
8ec0: 2e 64 62 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 .db</b> will be
8ed0: 72 65 74 75 72 6e 65 64 2e 3c 2f 6c 69 3e 0d 0a returned.</li>..
8ee0: 3c 2f 75 6c 3e 3c 62 72 3e 0d 0a 3c 2f 74 64 3e </ul><br>..</td>
8ef0: 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c </tr>..</table><
8f00: 62 72 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 br><br>..<table
8f10: 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 cellspacing="8"
8f20: 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 38 22 20 cellpadding="8"
8f30: 62 67 63 6f 6c 6f 72 3d 22 23 63 39 66 66 66 30 bgcolor="#c9fff0
8f40: 22 20 77 69 64 74 68 3d 22 31 30 30 25 22 3e 0d " width="100%">.
8f50: 0a 3c 74 72 3e 3c 74 68 3e 0d 0a 3c 68 32 3e 55 .<tr><th>..<h2>U
8f60: 73 69 6e 67 20 74 68 65 20 65 6e 76 69 72 6f 6e sing the environ
8f70: 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 53 50 ment variable SP
8f80: 41 54 49 41 4c 49 54 45 5f 50 52 4f 4a 5f 44 42 ATIALITE_PROJ_DB
8f90: 5f 50 41 54 48 3c 2f 68 32 3e 0d 0a 3c 2f 74 68 _PATH</h2>..</th
8fa0: 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e ></tr>..<tr><td>
8fb0: 0d 0a 49 66 20 74 68 65 20 65 6e 76 69 72 6f 6e ..If the environ
8fc0: 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 3c 62 ment variable <b
8fd0: 3e 53 50 41 54 49 41 4c 49 54 45 5f 50 52 4f 4a >SPATIALITE_PROJ
8fe0: 5f 44 42 5f 50 41 54 48 3c 2f 62 3e 20 69 73 20 _DB_PATH</b> is
8ff0: 73 65 74 2c 20 74 68 65 6e 20 3c 62 3e 6c 69 62 set, then <b>lib
9000: 73 70 61 74 69 61 6c 69 74 65 3c 2f 62 3e 20 77 spatialite</b> w
9010: 69 6c 6c 20 73 69 6d 70 6c 79 20 61 74 74 65 6d ill simply attem
9020: 70 74 20 74 6f 20 63 6f 6e 6e 65 63 74 20 74 68 pt to connect th
9030: 65 20 64 61 74 61 62 61 73 65 20 70 6f 69 6e 74 e database point
9040: 65 64 20 62 79 20 74 68 69 73 20 76 61 72 69 61 ed by this varia
9050: 62 6c 65 2e 3c 62 72 3e 0d 0a 53 75 63 68 20 61 ble.<br>..Such a
9060: 20 63 61 70 61 62 69 6c 69 74 79 20 69 73 20 73 capability is s
9070: 75 70 70 6f 72 74 65 64 20 6e 6f 74 20 6f 6e 6c upported not onl
9080: 79 20 6f 6e 20 57 69 6e 64 6f 77 73 20 62 75 74 y on Windows but
9090: 20 61 6c 73 6f 20 6f 6e 20 4c 69 6e 75 78 20 28 also on Linux (
90a0: 61 6e 64 20 6f 6e 20 61 6e 79 20 6f 74 68 65 72 and on any other
90b0: 20 70 6c 61 74 66 6f 72 6d 29 2e 3c 62 72 3e 3c platform).<br><
90c0: 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 4c 69 6e 75 78 br>..<i><u>Linux
90d0: 20 65 78 61 6d 70 6c 65 3c 2f 75 3e 3c 2f 69 3e example</u></i>
90e0: 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e :..<ul>..<li><b>
90f0: 65 78 70 6f 72 74 20 22 53 50 41 54 49 41 4c 49 export "SPATIALI
9100: 54 45 5f 50 52 4f 4a 5f 44 42 5f 50 41 54 48 3d TE_PROJ_DB_PATH=
9110: 2f 68 6f 6d 65 2f 73 61 6e 64 72 6f 2f 61 75 78 /home/sandro/aux
9120: 2f 70 72 6f 6a 2e 64 62 22 3c 62 72 3e 0d 0a 65 /proj.db"<br>..e
9130: 63 68 6f 20 24 53 50 41 54 49 41 4c 49 54 45 5f cho $SPATIALITE_
9140: 50 52 4f 4a 5f 44 42 5f 50 41 54 48 3c 62 72 3e PROJ_DB_PATH<br>
9150: 0d 0a 73 70 61 74 69 61 6c 69 74 65 3c 62 3e 3c ..spatialite<b><
9160: 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 3c /li>..</ul><br><
9170: 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 57 69 6e 64 6f br>..<i><u>Windo
9180: 77 73 20 65 78 61 6d 70 6c 65 3c 2f 75 3e 3c 2f ws example</u></
9190: 69 3e 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c i>:..<ul>..<li><
91a0: 62 3e 53 45 54 20 53 50 41 54 49 41 4c 49 54 45 b>SET SPATIALITE
91b0: 5f 50 52 4f 4a 5f 44 42 5f 50 41 54 48 3d 43 3a _PROJ_DB_PATH=C:
91c0: 5c 55 73 65 72 73 5c 73 61 6e 64 72 6f 5c 61 75 \Users\sandro\au
91d0: 78 5c 70 72 6f 6a 2e 64 62 3c 62 72 3e 0d 0a 65 x\proj.db<br>..e
91e0: 63 68 6f 20 25 53 50 41 54 49 41 4c 49 54 45 5f cho %SPATIALITE_
91f0: 50 52 4f 4a 5f 44 42 5f 50 41 54 48 25 3c 62 72 PROJ_DB_PATH%<br
9200: 3e 0d 0a 73 70 61 74 69 61 6c 69 74 65 5f 67 75 >..spatialite_gu
9210: 69 3c 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e i<b></li>..</ul>
9220: 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 2f 74 68 3e 3c <br><br>..</th><
9230: 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 /tr>..</table><b
9240: 72 3e 0d 0a 3c 68 72 3e 3c 62 72 3e 0d 0a 3c 61 r>..<hr><br>..<a
9250: 20 68 72 65 66 3d 22 68 74 74 70 73 3a 2f 2f 77 href="https://w
9260: 77 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 2f 66 ww.gaia-gis.it/f
9270: 6f 73 73 69 6c 2f 6c 69 62 73 70 61 74 69 61 6c ossil/libspatial
9280: 69 74 65 2f 77 69 6b 69 3f 6e 61 6d 65 3d 34 2e ite/wiki?name=4.
9290: 33 2e 30 2d 64 6f 63 22 3e 62 61 63 6b 3c 2f 61 3.0-doc">back</a
92a0: 3e 0a 5a 20 66 35 35 65 37 65 62 36 37 37 32 35 >.Z f55e7eb67725
92b0: 38 31 66 66 64 38 33 38 61 36 62 33 35 35 32 32 81ffd838a6b35522
92c0: 34 36 61 34 0a 46a4.