0000: 44 20 32 30 31 39 2d 30 34 2d 32 34 54 31 32 3a D 2019-04-24T12:
0010: 32 35 3a 30 35 2e 39 33 36 0a 4c 20 50 52 4f 4a 25:05.936.L PROJ
0020: 2e 36 0a 50 20 34 36 31 62 31 37 33 65 63 33 36 .6.P 461b173ec36
0030: 31 38 65 62 35 63 34 36 65 33 64 65 65 39 65 37 18eb5c46e3dee9e7
0040: 33 30 39 63 31 36 32 32 33 33 62 38 38 0a 55 20 309c162233b88.U
0050: 73 61 6e 64 72 6f 0a 57 20 32 37 35 30 36 0a 3c sandro.W 27506.<
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 2d 6f 66 2d 74 68 65 ent state-of-the
0220: 2d 61 72 74 3a 3c 62 72 3e 3c 62 72 3e 0d 0a 54 -art:<br><br>..T
0230: 69 6d 65 6c 69 6e 65 3a 0d 0a 3c 75 6c 3e 0d 0a imeline:..<ul>..
0240: 3c 6c 69 3e 56 65 72 79 20 66 65 77 20 75 73 65 <li>Very few use
0250: 72 73 20 61 6e 64 20 64 65 76 65 6c 6f 70 65 72 rs and developer
0260: 73 20 64 6f 20 72 65 61 6c 6c 79 20 72 65 61 6c s do really real
0270: 69 7a 65 20 68 6f 77 20 61 6e 63 69 65 6e 74 20 ize how ancient
0280: 69 73 20 50 52 4f 4a 2c 20 61 6e 64 20 68 6f 77 is PROJ, and how
0290: 20 66 61 72 20 69 6e 20 74 69 6d 65 20 69 74 20 far in time it
02a0: 73 74 61 72 74 65 64 20 6d 6f 76 69 6e 67 20 69 started moving i
02b0: 74 73 20 66 69 72 73 74 20 73 74 65 70 73 2e 3c ts first steps.<
02c0: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 69 6e 20 3c 62 3e /li>..<li>in <b>
02d0: 31 39 38 30 3c 2f 62 3e 20 28 61 62 6f 75 74 20 1980</b> (about
02e0: 34 30 20 79 65 61 72 73 20 61 67 6f 29 20 47 65 40 years ago) Ge
02f0: 72 61 6c 64 20 45 76 65 6e 64 65 6e 20 73 74 61 rald Evenden sta
0300: 72 74 65 64 20 77 6f 72 6b 69 6e 67 20 6f 6e 20 rted working on
0310: 74 68 65 20 76 65 72 79 20 66 69 72 73 74 20 50 the very first P
0320: 52 4f 4a 20 76 65 72 73 69 6f 6e 2c 20 61 6e 64 ROJ version, and
0330: 20 61 74 20 74 68 65 20 74 69 6d 65 20 69 74 20 at the time it
0340: 77 61 73 20 61 20 52 61 74 66 6f 72 20 70 72 6f was a Ratfor pro
0350: 67 72 61 6d 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e gram.</li>..<li>
0360: 69 6e 20 3c 62 3e 31 39 38 35 3c 2f 62 3e 20 74 in <b>1985</b> t
0370: 68 65 20 63 6f 64 65 20 77 61 73 20 63 6f 6d 70 he code was comp
0380: 6c 65 74 65 6c 79 20 72 65 77 72 69 74 74 65 6e letely rewritten
0390: 20 69 6e 20 43 20 74 6f 20 72 75 6e 20 6f 6e 20 in C to run on
03a0: 55 4e 49 58 20 73 79 73 74 65 6d 73 2c 20 61 6e UNIX systems, an
03b0: 64 20 69 74 20 77 61 73 20 6e 61 6d 65 64 20 3c d it was named <
03c0: 62 3e 50 52 4f 4a 2e 32 3c 2f 62 3e 2e 3c 2f 6c b>PROJ.2</b>.</l
03d0: 69 3e 0d 0a 3c 6c 69 3e 69 6e 20 3c 62 3e 31 39 i>..<li>in <b>19
03e0: 39 30 3c 2f 62 3e 20 77 61 73 20 72 65 6c 65 61 90</b> was relea
03f0: 73 65 64 20 61 6e 20 75 70 64 61 74 65 64 20 76 sed an updated v
0400: 65 72 73 69 6f 6e 20 6e 61 6d 65 64 20 3c 62 3e ersion named <b>
0410: 50 52 4f 4a 2e 33 3c 2f 6c 69 3e 0d 0a 3c 6c 69 PROJ.3</li>..<li
0420: 3e 69 6e 20 3c 62 3e 31 39 39 34 3c 2f 62 3e 20 >in <b>1994</b>
0430: 61 20 6d 6f 72 65 20 61 64 76 61 6e 63 65 64 20 a more advanced
0440: 76 65 72 73 69 6f 6e 20 77 61 73 20 72 65 6c 65 version was rele
0450: 61 73 65 64 2c 20 61 6e 64 20 69 74 20 77 61 73 ased, and it was
0460: 20 6f 62 76 69 6f 75 73 6c 79 20 6e 61 6d 65 64 obviously named
0470: 20 3c 62 3e 50 52 4f 4a 2e 34 3c 2f 62 3e 3c 2f <b>PROJ.4</b></
0480: 6c 69 3e 0d 0a 3c 6c 69 3e 69 6e 20 3c 62 3e 31 li>..<li>in <b>1
0490: 39 39 35 3c 2f 62 3e 20 45 76 65 6e 64 65 6e 20 995</b> Evenden
04a0: 73 74 6f 70 70 65 64 20 61 6e 79 20 66 75 72 74 stopped any furt
04b0: 68 65 72 20 64 65 76 65 6c 6f 70 6d 65 6e 74 20 her development
04c0: 61 63 74 69 76 69 74 79 20 61 6e 64 20 74 68 65 activity and the
04d0: 20 70 72 6f 6a 65 63 74 20 62 65 63 6f 6d 65 20 project become
04e0: 69 6e 61 63 74 69 76 65 20 66 6f 72 20 73 65 76 inactive for sev
04f0: 65 72 61 6c 20 79 65 61 72 73 2e 3c 2f 6c 69 3e eral years.</li>
0500: 0d 0a 3c 6c 69 3e 69 6e 20 3c 62 3e 32 30 30 30 ..<li>in <b>2000
0510: 3c 2f 62 3e 20 46 72 61 6e 6b 20 57 61 72 6d 65 </b> Frank Warme
0520: 72 64 61 6d 20 62 61 63 61 6d 65 20 74 68 65 20 rdam bacame the
0530: 6e 65 77 20 6d 61 69 6e 74 61 69 6e 65 72 20 61 new maintainer a
0540: 6e 64 20 72 65 6c 65 61 73 65 64 20 76 65 72 73 nd released vers
0550: 69 6f 6e 20 3c 62 3e 34 2e 34 3c 2f 62 3e 3c 2f ion <b>4.4</b></
0560: 6c 69 3e 0d 0a 3c 6c 69 3e 41 66 74 65 72 20 74 li>..<li>After t
0570: 68 69 73 20 72 65 62 6f 72 6e 20 74 68 65 20 72 his reborn the r
0580: 65 76 69 74 61 6c 69 7a 65 64 20 70 72 6f 6a 65 evitalized proje
0590: 63 74 20 63 6f 6e 74 69 6e 75 65 64 20 74 6f 20 ct continued to
05a0: 62 65 20 72 65 67 75 6c 61 72 6c 79 20 6d 61 69 be regularly mai
05b0: 6e 74 61 69 6e 65 64 2c 20 62 75 74 20 6e 6f 20 ntained, but no
05c0: 66 75 72 74 68 65 72 20 72 65 6c 65 76 61 6e 74 further relevant
05d0: 20 69 6d 70 72 6f 76 65 6d 65 6e 74 73 20 77 65 improvements we
05e0: 72 65 20 69 6e 74 72 6f 64 75 63 65 64 2e 3c 62 re introduced.<b
05f0: 72 3e 0d 0a 50 52 4f 4a 2e 34 20 6a 75 73 74 20 r>..PROJ.4 just
0600: 63 6f 6e 74 69 6e 75 65 64 20 69 74 73 20 76 65 continued its ve
0610: 72 79 20 70 6c 61 63 69 64 20 65 76 6f 6c 75 74 ry placid evolut
0620: 69 6f 6e 20 69 6e 20 61 20 73 75 62 73 74 61 6e ion in a substan
0630: 74 69 61 6c 6c 79 20 63 6f 6e 73 65 72 76 61 74 tially conservat
0640: 69 76 65 20 77 61 79 2e 3c 2f 6c 69 3e 0d 0a 3c ive way.</li>..<
0650: 2f 75 6c 3e 3c 62 72 3e 0d 0a 3c 62 3e 3c 75 3e /ul><br>..<b><u>
0660: 53 68 6f 72 74 20 63 6f 6e 63 6c 75 73 69 6f 6e Short conclusion
0670: 3c 2f 75 3e 3c 2f 62 3e 3a 20 74 68 65 20 66 6f </u></b>: the fo
0680: 75 72 74 68 20 76 65 72 73 69 6f 6e 20 6f 66 20 urth version of
0690: 50 52 4f 4a 20 28 61 6b 61 20 3c 62 3e 50 52 4f PROJ (aka <b>PRO
06a0: 4a 2e 34 3c 2f 62 3e 29 20 6c 61 73 74 65 64 20 J.4</b>) lasted
06b0: 66 6f 72 20 61 62 6f 75 74 20 74 77 6f 20 64 65 for about two de
06c0: 63 61 64 65 73 2c 20 61 20 76 65 72 79 20 75 6e cades, a very un
06d0: 63 6f 6d 6d 6f 6e 20 73 69 74 75 61 74 69 6f 6e common situation
06e0: 2e 3c 62 72 3e 0d 0a 41 6e 64 20 61 20 66 75 6c .<br>..And a ful
06f0: 6c 20 67 65 6e 65 72 61 74 69 6f 6e 20 6f 66 20 l generation of
0700: 64 65 76 65 6c 6f 70 65 72 73 20 61 6e 64 20 75 developers and u
0710: 73 65 72 73 20 62 65 63 6f 6d 65 20 73 69 6e 63 sers become sinc
0720: 65 72 6c 79 20 63 6f 6e 76 69 6e 63 65 64 20 74 erly convinced t
0730: 68 61 74 20 50 52 4f 4a 2e 34 20 77 61 73 20 74 hat PROJ.4 was t
0740: 68 65 20 72 65 61 6c 20 6e 61 6d 65 20 6f 66 20 he real name of
0750: 74 68 65 20 6c 69 62 72 61 72 79 2e 0d 0a 3c 68 the library...<h
0760: 33 3e 54 68 65 20 72 65 76 6f 6c 75 74 69 6f 6e 3>The revolution
0770: 20 63 6f 6d 65 73 3c 2f 68 33 3e 0d 0a 54 69 6d comes</h3>..Tim
0780: 65 6c 69 6e 65 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c eline:..<ul>..<l
0790: 69 3e 69 6e 20 3c 62 3e 32 30 31 38 3c 2f 62 3e i>in <b>2018</b>
07a0: 20 45 76 65 6e 20 52 6f 75 61 75 6c 74 2c 20 4b Even Rouault, K
07b0: 72 69 73 74 69 61 6e 20 45 76 65 72 73 20 61 6e ristian Evers an
07c0: 64 20 6f 74 68 65 72 73 20 73 74 61 72 74 20 64 d others start d
07d0: 65 76 65 6c 6f 70 69 6e 67 20 61 20 72 65 76 6f eveloping a revo
07e0: 6c 75 74 69 6f 6e 69 7a 65 64 20 50 52 4f 4a 20 lutionized PROJ
07f0: 73 75 70 70 6f 72 74 69 6e 67 20 6d 61 6e 79 20 supporting many
0800: 72 65 6c 65 76 61 6e 74 20 69 6e 6e 6f 76 61 74 relevant innovat
0810: 69 6f 6e 73 2e 3c 62 72 3e 0d 0a 3c 62 3e 50 52 ions.<br>..<b>PR
0820: 4f 4a 2e 35 3c 2f 62 3e 20 69 73 20 69 6e 74 65 OJ.5</b> is inte
0830: 6e 64 65 64 20 74 6f 20 62 65 20 74 68 65 20 66 nded to be the f
0840: 69 72 73 74 20 70 72 65 6c 69 6d 69 6e 61 72 79 irst preliminary
0850: 20 73 74 65 70 20 6f 66 20 61 20 6d 6f 72 65 20 step of a more
0860: 63 6f 6d 70 6c 65 78 20 65 76 6f 6c 75 74 69 6f complex evolutio
0870: 6e 20 73 63 68 65 6d 61 2e 3c 2f 6c 69 3e 0d 0a n schema.</li>..
0880: 3c 6c 69 3e 6f 6e 20 3c 62 3e 4d 61 72 63 68 20 <li>on <b>March
0890: 32 30 31 39 3c 2f 62 3e 20 61 20 6d 6f 72 65 20 2019</b> a more
08a0: 6d 61 74 75 72 65 20 76 65 72 73 69 6f 6e 20 69 mature version i
08b0: 73 20 72 65 6c 65 61 73 65 64 2c 20 61 6e 64 20 s released, and
08c0: 69 74 27 73 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f it's <b>PROJ.6</
08d0: 62 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 4e 65 78 b></li>..<li>Nex
08e0: 74 20 79 65 61 72 20 28 32 30 32 30 29 20 3c 62 t year (2020) <b
08f0: 3e 50 52 4f 4a 2e 37 3c 2f 62 3e 20 69 73 20 65 >PROJ.7</b> is e
0900: 78 70 65 63 74 65 64 20 74 6f 20 62 65 20 72 65 xpected to be re
0910: 6c 65 61 73 65 64 2c 20 61 6e 64 20 69 74 20 77 leased, and it w
0920: 69 6c 6c 20 66 75 6c 6c 79 20 63 6f 6d 70 6c 65 ill fully comple
0930: 74 65 20 74 68 65 20 74 72 61 6e 73 69 74 69 6f te the transitio
0940: 6e 20 62 65 74 77 65 65 6e 20 74 68 65 20 6f 6c n between the ol
0950: 64 20 61 6e 64 20 6e 65 77 20 61 72 63 68 69 74 d and new archit
0960: 65 63 74 75 72 65 73 2e 3c 2f 6c 69 3e 0d 0a 3c ectures.</li>..<
0970: 2f 75 6c 3e 0d 0a 3c 62 72 3e 0d 0a 3c 62 3e 3c /ul>..<br>..<b><
0980: 75 3e 4e 6f 74 65 3c 2f 75 3e 3c 2f 62 3e 3a 20 u>Note</u></b>:
0990: 74 68 65 20 77 68 6f 6c 65 20 74 72 61 6e 73 69 the whole transi
09a0: 74 69 6f 6e 20 69 6d 70 6c 69 65 73 20 6d 61 6e tion implies man
09b0: 79 20 72 65 6c 65 76 61 6e 74 20 63 68 61 6e 67 y relevant chang
09c0: 65 73 2c 20 73 6f 20 74 68 61 74 20 61 20 64 65 es, so that a de
09d0: 65 70 6c 79 20 72 65 76 69 73 65 64 20 41 50 49 eply revised API
09e0: 20 77 69 6c 6c 20 62 65 20 72 65 71 75 69 72 65 will be require
09f0: 64 2e 0d 0a 49 6e 20 6f 74 68 65 72 20 77 6f 72 d...In other wor
0a00: 64 73 2c 20 74 68 65 20 6f 6c 64 20 3c 62 3e 50 ds, the old <b>P
0a10: 52 4f 4a 2e 34 3c 2f 62 3e 20 61 6e 64 20 74 68 ROJ.4</b> and th
0a20: 65 20 6e 65 77 20 3c 62 3e 50 52 4f 4a 2e 37 3c e new <b>PROJ.7<
0a30: 2f 62 3e 20 77 69 6c 6c 20 73 75 70 70 6f 72 74 /b> will support
0a40: 20 74 77 6f 20 64 69 66 66 65 72 65 6e 74 20 41 two different A
0a50: 50 49 73 2c 20 74 68 75 73 20 61 62 72 75 70 74 PIs, thus abrupt
0a60: 6c 79 20 62 72 65 61 6b 69 6e 67 20 63 72 6f 73 ly breaking cros
0a70: 73 2d 76 65 72 73 69 6f 6e 20 63 6f 6d 70 61 74 s-version compat
0a80: 69 62 69 6c 69 74 79 2e 3c 62 72 3e 0d 0a 54 68 ibility.<br>..Th
0a90: 69 73 20 69 73 20 61 6e 20 75 6d 70 6c 65 61 73 is is an umpleas
0aa0: 61 6e 74 20 6e 65 77 2c 20 62 65 63 61 75 73 65 ant new, because
0ab0: 20 69 74 20 70 72 61 63 74 69 63 61 6c 6c 79 20 it practically
0ac0: 6d 65 61 6e 73 20 74 68 61 74 20 61 6c 6c 20 73 means that all s
0ad0: 6f 66 74 77 61 72 65 20 6d 6f 64 75 6c 65 73 20 oftware modules
0ae0: 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 50 52 4f depending on PRO
0af0: 4a 20 28 74 68 69 73 20 69 6e 63 6c 75 64 69 6e J (this includin
0b00: 67 20 53 70 61 74 69 61 4c 69 74 65 29 20 77 69 g SpatiaLite) wi
0b10: 6c 6c 20 72 65 71 75 69 72 65 20 61 20 6e 6f 74 ll require a not
0b20: 20 61 74 20 61 6c 6c 20 74 72 69 76 69 61 6c 20 at all trivial
0b30: 72 65 77 72 69 74 65 20 69 6e 20 6f 72 64 65 72 rewrite in order
0b40: 20 74 6f 20 66 75 6c 66 69 6c 6c 20 74 68 65 20 to fulfill the
0b50: 6e 65 77 20 41 50 49 20 72 65 71 75 69 72 65 6d new API requirem
0b60: 65 6e 74 73 2e 3c 62 72 3e 0d 0a 42 75 74 20 77 ents.<br>..But w
0b70: 68 65 6e 20 79 6f 75 20 63 6f 6e 73 69 64 65 72 hen you consider
0b80: 20 74 68 61 74 27 73 20 74 68 65 20 66 69 72 73 that's the firs
0b90: 74 20 74 69 6d 65 20 69 6e 20 69 74 73 20 76 65 t time in its ve
0ba0: 72 79 20 6c 6f 6e 67 20 6c 69 66 65 20 74 68 61 ry long life tha
0bb0: 74 20 50 52 4f 4a 20 72 65 71 75 69 72 65 73 20 t PROJ requires
0bc0: 61 6e 20 65 78 74 72 61 20 65 66 66 72 6f 74 20 an extra effrot
0bd0: 69 6e 20 6f 72 64 65 72 20 74 6f 20 69 6e 74 72 in order to intr
0be0: 6f 64 75 63 65 20 73 6f 20 6d 61 6e 79 20 75 73 oduce so many us
0bf0: 65 66 75 6c 20 69 6e 6e 6f 76 61 74 69 6f 6e 73 eful innovations
0c00: 2c 20 74 68 69 73 20 75 6e 65 78 70 65 63 74 65 , this unexpecte
0c10: 64 20 41 50 49 20 62 72 65 61 6b 61 67 65 20 6c d API breakage l
0c20: 6f 6f 6b 73 20 66 75 6c 6c 79 20 6a 75 73 74 69 ooks fully justi
0c30: 66 69 65 64 20 61 6e 64 20 61 62 73 6f 6c 75 74 fied and absolut
0c40: 65 6c 79 20 72 65 61 73 6f 6e 61 62 6c 65 2e 3c ely reasonable.<
0c50: 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 3c 75 3e 4d br><br>..<b><u>M
0c60: 6f 72 65 20 64 65 74 61 69 6c 73 20 61 62 6f 75 ore details abou
0c70: 74 20 74 68 65 20 41 50 49 20 62 72 65 61 6b 61 t the API breaka
0c80: 67 65 3c 2f 75 3e 3c 2f 62 3e 3a 0d 0a 3c 75 6c ge</u></b>:..<ul
0c90: 3e 0d 0a 3c 6c 69 3e 3c 62 3e 50 52 4f 4a 2e 35 >..<li><b>PROJ.5
0ca0: 3c 2f 62 3e 20 73 74 61 72 74 65 64 20 69 6e 74 </b> started int
0cb0: 72 6f 64 75 63 69 6e 67 20 74 68 65 20 6e 65 77 roducing the new
0cc0: 20 41 50 49 2c 20 62 75 74 20 77 61 73 20 73 74 API, but was st
0cd0: 69 6c 6c 20 61 62 6c 65 20 74 6f 20 73 75 70 70 ill able to supp
0ce0: 6f 72 74 20 74 68 65 20 6f 6c 64 20 74 72 61 64 ort the old trad
0cf0: 69 74 69 6f 6e 61 6c 20 41 50 49 20 77 69 74 68 itional API with
0d00: 6f 75 74 20 61 6e 79 20 63 6f 6d 70 6c 61 69 6e out any complain
0d10: 74 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e t.</li>..<li><b>
0d20: 50 52 4f 4a 2e 36 3c 2f 62 3e 20 68 61 76 65 20 PROJ.6</b> have
0d30: 64 65 70 72 65 63 65 74 65 64 20 74 68 65 20 6f depreceted the o
0d40: 6c 64 20 74 72 61 64 69 74 69 6f 6e 61 6c 20 41 ld traditional A
0d50: 50 49 2e 3c 62 72 3e 0d 0a 49 74 20 73 74 69 6c PI.<br>..It stil
0d60: 6c 20 63 6f 6e 74 69 6e 75 65 73 20 74 6f 20 62 l continues to b
0d70: 65 20 72 65 6c 75 63 74 61 6e 63 74 6c 79 20 73 e reluctanctly s
0d80: 75 70 70 6f 72 74 65 64 2c 20 62 75 74 20 74 68 upported, but th
0d90: 65 20 6c 69 62 72 61 72 79 20 72 65 71 75 69 72 e library requir
0da0: 65 73 20 74 6f 20 62 65 20 63 6f 6d 70 69 6c 65 es to be compile
0db0: 64 20 62 79 20 65 78 70 6c 69 63 69 74 6c 79 20 d by explicitly
0dc0: 64 65 66 69 6e 69 6e 67 20 61 20 3c 62 3e 2d 44 defining a <b>-D
0dd0: 41 43 43 45 50 54 5f 55 53 45 5f 4f 46 5f 44 45 ACCEPT_USE_OF_DE
0de0: 50 52 45 43 41 54 45 44 5f 50 52 4f 4a 5f 41 50 PRECATED_PROJ_AP
0df0: 49 5f 48 3d 31 3c 2f 62 3e 20 64 69 72 65 63 74 I_H=1</b> direct
0e00: 69 76 65 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 ive in order to
0e10: 65 66 66 65 63 74 69 76 65 6c 79 20 65 6e 61 62 effectively enab
0e20: 6c 65 20 74 68 69 73 20 6f 70 74 69 6f 6e 2e 3c le this option.<
0e30: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 61 6e 64 20 66 69 /li>..<li>and fi
0e40: 6e 61 6c 6c 79 20 74 68 65 20 6e 65 78 74 2d 74 nally the next-t
0e50: 6f 2d 63 6f 6d 65 20 3c 62 3e 50 52 4f 4a 2e 37 o-come <b>PROJ.7
0e60: 3c 2f 62 3e 20 77 69 6c 6c 20 63 6f 6d 70 6c 65 </b> will comple
0e70: 74 65 6c 79 20 67 65 74 20 72 69 64 20 6f 66 20 tely get rid of
0e80: 74 68 65 20 6f 6c 64 20 41 50 49 2e 3c 2f 6c 69 the old API.</li
0e90: 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 62 72 3e 0d 0a >..</ul>..<br>..
0ea0: 3c 68 72 3e 0d 0a 3c 68 31 3e 57 68 61 74 27 73 <hr>..<h1>What's
0eb0: 20 6e 65 77 20 69 6e 20 50 52 4f 4a 2e 36 3c 2f new in PROJ.6</
0ec0: 68 31 3e 0d 0a 3c 68 33 3e 46 75 6c 6c 79 20 73 h1>..<h3>Fully s
0ed0: 75 70 70 6f 72 74 69 6e 67 20 49 53 4f 2d 31 39 upporting ISO-19
0ee0: 31 31 31 3a 32 30 31 39 20 57 4b 54 3c 2f 68 33 111:2019 WKT</h3
0ef0: 3e 0d 0a 4f 6c 64 20 76 65 72 73 69 6f 6e 73 20 >..Old versions
0f00: 6f 66 20 50 52 4f 4a 20 28 69 6e 63 6c 75 64 69 of PROJ (includi
0f10: 6e 67 20 3c 62 3e 50 52 4f 4a 2e 34 3c 2f 62 3e ng <b>PROJ.4</b>
0f20: 29 20 72 65 71 75 69 72 65 64 20 74 6f 20 64 65 ) required to de
0f30: 66 69 6e 65 20 65 61 63 68 20 3c 62 3e 43 52 53 fine each <b>CRS
0f40: 3c 2f 62 3e 20 28 3c 69 3e 43 6f 6f 72 64 69 6e </b> (<i>Coordin
0f50: 61 74 65 20 52 65 66 65 72 65 6e 63 65 20 53 79 ate Reference Sy
0f60: 73 74 65 6d 3c 2f 69 3e 29 20 62 79 20 61 20 63 stem</i>) by a c
0f70: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 3c 62 3e orresponding <b>
0f80: 70 72 6f 6a 2d 73 74 72 69 6e 67 3c 2f 62 3e 2e proj-string</b>.
0f90: 0d 0a 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 ..The following
0fa0: 74 61 62 6c 65 20 65 78 65 6d 70 6c 69 66 69 65 table exemplifie
0fb0: 73 20 74 68 65 20 63 61 73 65 20 6f 66 20 66 65 s the case of fe
0fc0: 77 20 43 52 53 65 73 3a 3c 62 72 3e 3c 62 72 3e w CRSes:<br><br>
0fd0: 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 ..<table cellspa
0fe0: 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 cing="8" cellpad
0ff0: 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 ding="8" bgcolor
1000: 3d 22 23 65 38 66 66 65 38 22 20 62 6f 72 64 65 ="#e8ffe8" borde
1010: 72 3d 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 r="1">..<tr><th
1020: 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 bgcolor="#ffb03e
1030: 22 3e 53 52 49 44 3c 2f 74 68 3e 3c 74 68 20 62 ">SRID</th><th b
1040: 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 gcolor="#ffb03e"
1050: 3e 43 52 53 20 4e 61 6d 65 3c 2f 74 68 3e 3c 74 >CRS Name</th><t
1060: 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 h bgcolor="#ffb0
1070: 33 65 22 3e 70 72 6f 6a 2d 73 74 72 69 6e 67 3c 3e">proj-string<
1080: 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c /th></tr>..<tr><
1090: 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 td align="right"
10a0: 3e 33 30 30 33 3c 2f 74 64 3e 3c 74 64 3e 4d 6f >3003</td><td>Mo
10b0: 6e 74 65 20 4d 61 72 69 6f 20 2f 20 49 74 61 6c nte Mario / Ital
10c0: 79 20 7a 6f 6e 65 20 31 3c 2f 74 64 3e 0d 0a 3c y zone 1</td>..<
10d0: 74 64 3e 2b 70 72 6f 6a 3d 74 6d 65 72 63 20 2b td>+proj=tmerc +
10e0: 6c 61 74 5f 30 3d 30 20 2b 6c 6f 6e 5f 30 3d 39 lat_0=0 +lon_0=9
10f0: 20 2b 6b 3d 30 2e 39 39 39 36 20 2b 78 5f 30 3d +k=0.9996 +x_0=
1100: 31 35 30 30 30 30 30 20 2b 79 5f 30 3d 30 20 2b 1500000 +y_0=0 +
1110: 65 6c 6c 70 73 3d 69 6e 74 6c 20 2b 74 6f 77 67 ellps=intl +towg
1120: 73 38 34 3d 2d 31 30 34 2e 31 2c 2d 34 39 2e 31 s84=-104.1,-49.1
1130: 2c 2d 39 2e 39 2c 30 2e 39 37 31 2c 2d 32 2e 39 ,-9.9,0.971,-2.9
1140: 31 37 2c 30 2e 37 31 34 2c 2d 31 31 2e 36 38 20 17,0.714,-11.68
1150: 2b 75 6e 69 74 73 3d 6d 20 2b 6e 6f 5f 64 65 66 +units=m +no_def
1160: 73 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 s</td></tr>..<tr
1170: 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 68 ><td align="righ
1180: 74 22 3e 34 33 32 36 3c 2f 74 64 3e 3c 74 64 3e t">4326</td><td>
1190: 57 47 53 20 38 34 3c 2f 74 64 3e 0d 0a 3c 74 64 WGS 84</td>..<td
11a0: 3e 2b 70 72 6f 6a 3d 6c 6f 6e 67 6c 61 74 20 2b >+proj=longlat +
11b0: 64 61 74 75 6d 3d 57 47 53 38 34 20 2b 6e 6f 5f datum=WGS84 +no_
11c0: 64 65 66 73 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a defs</td></tr>..
11d0: 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72 <tr><td align="r
11e0: 69 67 68 74 22 3e 33 32 36 33 32 3c 2f 74 64 3e ight">32632</td>
11f0: 3c 74 64 3e 57 47 53 20 38 34 20 2f 20 55 54 4d <td>WGS 84 / UTM
1200: 20 7a 6f 6e 65 20 33 32 4e 3c 2f 74 64 3e 0d 0a zone 32N</td>..
1210: 3c 74 64 3e 2b 70 72 6f 6a 3d 75 74 6d 20 2b 7a <td>+proj=utm +z
1220: 6f 6e 65 3d 33 32 20 2b 64 61 74 75 6d 3d 57 47 one=32 +datum=WG
1230: 53 38 34 20 2b 75 6e 69 74 73 3d 6d 20 2b 6e 6f S84 +units=m +no
1240: 5f 64 65 66 73 3c 2f 74 64 3e 0d 0a 3c 2f 74 61 _defs</td>..</ta
1250: 62 6c 65 3e 0d 0a 3c 62 72 3e 0d 0a 4e 65 77 20 ble>..<br>..New
1260: 76 65 72 73 69 6f 6e 73 20 6f 66 20 50 52 4f 4a versions of PROJ
1270: 20 28 73 74 61 72 74 69 6e 67 20 73 69 6e 63 65 (starting since
1280: 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 29 20 <b>PROJ.6</b>)
1290: 73 74 69 6c 6c 20 63 6f 6e 74 69 6e 75 65 20 74 still continue t
12a0: 6f 20 73 75 70 70 6f 72 74 20 74 68 65 20 6f 6c o support the ol
12b0: 64 20 3c 62 3e 70 72 6f 6a 2d 73 74 72 69 6e 67 d <b>proj-string
12c0: 73 3c 2f 62 3e 2c 20 62 75 74 20 74 68 65 20 70 s</b>, but the p
12d0: 72 65 66 65 72 72 65 64 20 6e 6f 74 61 74 69 6f referred notatio
12e0: 6e 20 66 6f 72 20 64 65 66 69 6e 69 6e 67 20 61 n for defining a
12f0: 6e 79 20 43 52 53 20 69 73 20 6e 6f 77 20 63 6f ny CRS is now co
1300: 6e 66 6f 72 6d 61 6e 74 20 74 6f 20 74 68 65 20 nformant to the
1310: 3c 62 3e 49 53 4f 2d 31 39 31 31 31 3a 32 30 31 <b>ISO-19111:201
1320: 39 3c 2f 62 3e 20 69 6e 74 65 72 6e 61 74 69 6f 9</b> internatio
1330: 6e 61 6c 20 73 74 61 6e 64 61 72 64 3c 62 72 3e nal standard<br>
1340: 0d 0a 28 3c 69 3e 4f 47 43 20 41 62 73 74 72 61 ..(<i>OGC Abstra
1350: 63 74 20 53 70 65 63 69 66 69 63 61 74 69 6f 6e ct Specification
1360: 20 54 6f 70 69 63 20 32 3a 20 e2 80 9c 52 65 66 Topic 2: ...Ref
1370: 65 72 65 6e 63 69 6e 67 20 42 79 20 43 6f 6f 72 erencing By Coor
1380: 64 69 6e 61 74 65 73 e2 80 9d 3c 2f 69 3e 29 2e dinates...</i>).
1390: 3c 62 72 3e 0d 0a 54 68 65 20 66 6f 6c 6c 6f 77 <br>..The follow
13a0: 69 6e 67 20 74 61 62 6c 65 20 65 78 65 6d 70 6c ing table exempl
13b0: 69 66 69 65 73 20 74 68 65 20 73 61 6d 65 20 43 ifies the same C
13c0: 52 53 65 73 20 61 73 20 61 62 6f 76 65 20 69 6e RSes as above in
13d0: 20 74 68 65 20 49 53 4f 20 57 4b 54 20 6e 6f 74 the ISO WKT not
13e0: 61 74 69 6f 6e 3a 0d 0a 3c 62 72 3e 3c 62 72 3e ation:..<br><br>
13f0: 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 ..<table cellspa
1400: 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 cing="8" cellpad
1410: 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 ding="8" bgcolor
1420: 3d 22 23 65 38 66 66 65 38 22 20 62 6f 72 64 65 ="#e8ffe8" borde
1430: 72 3d 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 r="1">..<tr><th
1440: 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 bgcolor="#ffb03e
1450: 22 3e 53 52 49 44 3c 2f 74 68 3e 3c 74 64 3e 33 ">SRID</th><td>3
1460: 30 30 33 3c 2f 74 64 3e 3c 74 64 3e 34 33 32 36 003</td><td>4326
1470: 3c 2f 74 64 3e 3c 74 64 3e 33 32 36 33 32 3c 2f </td><td>32632</
1480: 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 td></tr>..<tr><t
1490: 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 h bgcolor="#ffb0
14a0: 33 65 22 3e 43 52 53 20 4e 61 6d 65 3c 2f 74 68 3e">CRS Name</th
14b0: 3e 3c 74 64 3e 4d 6f 6e 74 65 20 4d 61 72 69 6f ><td>Monte Mario
14c0: 20 2f 20 49 74 61 6c 79 20 7a 6f 6e 65 20 31 3c / Italy zone 1<
14d0: 2f 74 64 3e 3c 2f 74 64 3e 3c 74 64 3e 57 47 53 /td></td><td>WGS
14e0: 20 38 34 3c 2f 74 64 3e 3c 74 64 3e 57 47 53 20 84</td><td>WGS
14f0: 38 34 20 2f 20 55 54 4d 20 7a 6f 6e 65 20 33 32 84 / UTM zone 32
1500: 4e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 N</td></tr>..<tr
1510: 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 ><th bgcolor="#f
1520: 66 62 30 33 65 22 3e 49 53 4f 2d 32 30 31 38 20 fb03e">ISO-2018
1530: 57 4b 54 3c 2f 74 68 3e 0d 0a 3c 74 64 20 76 61 WKT</th>..<td va
1540: 6c 69 67 6e 3d 22 74 6f 70 22 3e 3c 76 65 72 62 lign="top"><verb
1550: 61 74 69 6d 3e 0d 0a 50 52 4f 4a 43 52 53 5b 22 atim>..PROJCRS["
1560: 4d 6f 6e 74 65 20 4d 61 72 69 6f 20 2f 20 49 74 Monte Mario / It
1570: 61 6c 79 20 7a 6f 6e 65 20 31 22 2c 0d 0a 20 20 aly zone 1",..
1580: 20 20 42 41 53 45 47 45 4f 44 43 52 53 5b 22 4d BASEGEODCRS["M
1590: 6f 6e 74 65 20 4d 61 72 69 6f 22 2c 0d 0a 20 20 onte Mario",..
15a0: 20 20 20 20 20 20 44 41 54 55 4d 5b 22 4d 6f 6e DATUM["Mon
15b0: 74 65 20 4d 61 72 69 6f 22 2c 3c 62 72 3e 0d 0a te Mario",<br>..
15c0: 20 20 20 20 20 20 20 20 20 20 20 20 45 4c 4c 49 ELLI
15d0: 50 53 4f 49 44 5b 22 49 6e 74 65 72 6e 61 74 69 PSOID["Internati
15e0: 6f 6e 61 6c 20 31 39 32 34 22 2c 36 33 37 38 33 onal 1924",63783
15f0: 38 38 2c 32 39 37 2c 0d 0a 20 20 20 20 20 20 20 88,297,..
1600: 20 20 20 20 20 20 20 20 20 4c 45 4e 47 54 48 55 LENGTHU
1610: 4e 49 54 5b 22 6d 65 74 72 65 22 2c 31 5d 5d 5d NIT["metre",1]]]
1620: 2c 0d 0a 20 20 20 20 20 20 20 20 50 52 49 4d 45 ,.. PRIME
1630: 4d 5b 22 47 72 65 65 6e 77 69 63 68 22 2c 30 2c M["Greenwich",0,
1640: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 41 4e .. AN
1650: 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 65 22 GLEUNIT["degree"
1660: 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 39 39 ,0.0174532925199
1670: 34 33 33 5d 5d 5d 2c 0d 0a 20 20 20 20 43 4f 4e 433]]],.. CON
1680: 56 45 52 53 49 4f 4e 5b 22 49 74 61 6c 79 20 7a VERSION["Italy z
1690: 6f 6e 65 20 31 22 2c 0d 0a 20 20 20 20 20 20 20 one 1",..
16a0: 20 4d 45 54 48 4f 44 5b 22 54 72 61 6e 73 76 65 METHOD["Transve
16b0: 72 73 65 20 4d 65 72 63 61 74 6f 72 22 2c 0d 0a rse Mercator",..
16c0: 20 20 20 20 20 20 20 20 20 20 20 20 49 44 5b 22 ID["
16d0: 45 50 53 47 22 2c 39 38 30 37 5d 5d 2c 0d 0a 20 EPSG",9807]],..
16e0: 20 20 20 20 20 20 20 50 41 52 41 4d 45 54 45 52 PARAMETER
16f0: 5b 22 4c 61 74 69 74 75 64 65 20 6f 66 20 6e 61 ["Latitude of na
1700: 74 75 72 61 6c 20 6f 72 69 67 69 6e 22 2c 30 2c tural origin",0,
1710: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 41 4e .. AN
1720: 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 65 22 GLEUNIT["degree"
1730: 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 39 39 ,0.0174532925199
1740: 34 33 33 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 433],..
1750: 20 20 20 49 44 5b 22 45 50 53 47 22 2c 38 38 30 ID["EPSG",880
1760: 31 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 41 1]],.. PA
1770: 52 41 4d 45 54 45 52 5b 22 4c 6f 6e 67 69 74 75 RAMETER["Longitu
1780: 64 65 20 6f 66 20 6e 61 74 75 72 61 6c 20 6f 72 de of natural or
1790: 69 67 69 6e 22 2c 39 2c 0d 0a 20 20 20 20 20 20 igin",9,..
17a0: 20 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b ANGLEUNIT[
17b0: 22 64 65 67 72 65 65 22 2c 30 2e 30 31 37 34 35 "degree",0.01745
17c0: 33 32 39 32 35 31 39 39 34 33 33 5d 2c 0d 0a 20 32925199433],..
17d0: 20 20 20 20 20 20 20 20 20 20 20 49 44 5b 22 45 ID["E
17e0: 50 53 47 22 2c 38 38 30 32 5d 5d 2c 0d 0a 20 20 PSG",8802]],..
17f0: 20 20 20 20 20 20 50 41 52 41 4d 45 54 45 52 5b PARAMETER[
1800: 22 53 63 61 6c 65 20 66 61 63 74 6f 72 20 61 74 "Scale factor at
1810: 20 6e 61 74 75 72 61 6c 20 6f 72 69 67 69 6e 22 natural origin"
1820: 2c 30 2e 39 39 39 36 2c 0d 0a 20 20 20 20 20 20 ,0.9996,..
1830: 20 20 20 20 20 20 53 43 41 4c 45 55 4e 49 54 5b SCALEUNIT[
1840: 22 75 6e 69 74 79 22 2c 31 5d 2c 0d 0a 20 20 20 "unity",1],..
1850: 20 20 20 20 20 20 20 20 20 49 44 5b 22 45 50 53 ID["EPS
1860: 47 22 2c 38 38 30 35 5d 5d 2c 0d 0a 20 20 20 20 G",8805]],..
1870: 20 20 20 20 50 41 52 41 4d 45 54 45 52 5b 22 46 PARAMETER["F
1880: 61 6c 73 65 20 65 61 73 74 69 6e 67 22 2c 31 35 alse easting",15
1890: 30 30 30 30 30 2c 0d 0a 20 20 20 20 20 20 20 20 00000,..
18a0: 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 LENGTHUNIT["
18b0: 6d 65 74 72 65 22 2c 31 5d 2c 0d 0a 20 20 20 20 metre",1],..
18c0: 20 20 20 20 20 20 20 20 49 44 5b 22 45 50 53 47 ID["EPSG
18d0: 22 2c 38 38 30 36 5d 5d 2c 0d 0a 20 20 20 20 20 ",8806]],..
18e0: 20 20 20 50 41 52 41 4d 45 54 45 52 5b 22 46 61 PARAMETER["Fa
18f0: 6c 73 65 20 6e 6f 72 74 68 69 6e 67 22 2c 30 2c lse northing",0,
1900: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4c 45 .. LE
1910: 4e 47 54 48 55 4e 49 54 5b 22 6d 65 74 72 65 22 NGTHUNIT["metre"
1920: 2c 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 ,1],..
1930: 20 20 49 44 5b 22 45 50 53 47 22 2c 38 38 30 37 ID["EPSG",8807
1940: 5d 5d 5d 2c 0d 0a 20 20 20 20 43 53 5b 43 61 72 ]]],.. CS[Car
1950: 74 65 73 69 61 6e 2c 32 5d 2c 0d 0a 20 20 20 20 tesian,2],..
1960: 20 20 20 20 41 58 49 53 5b 22 65 61 73 74 69 6e AXIS["eastin
1970: 67 20 28 58 29 22 2c 65 61 73 74 2c 0d 0a 20 20 g (X)",east,..
1980: 20 20 20 20 20 20 20 20 20 20 4f 52 44 45 52 5b ORDER[
1990: 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 1],..
19a0: 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 74 LENGTHUNIT["met
19b0: 72 65 22 2c 31 5d 5d 2c 0d 0a 20 20 20 20 20 20 re",1]],..
19c0: 20 20 41 58 49 53 5b 22 6e 6f 72 74 68 69 6e 67 AXIS["northing
19d0: 20 28 59 29 22 2c 6e 6f 72 74 68 2c 0d 0a 20 20 (Y)",north,..
19e0: 20 20 20 20 20 20 20 20 20 20 4f 52 44 45 52 5b ORDER[
19f0: 32 5d 2c 3c 62 72 3e 0d 0a 20 20 20 20 20 20 20 2],<br>..
1a00: 20 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b LENGTHUNIT[
1a10: 22 6d 65 74 72 65 22 2c 31 5d 5d 2c 0d 0a 20 20 "metre",1]],..
1a20: 20 20 41 52 45 41 5b 22 49 74 61 6c 79 20 2d 20 AREA["Italy -
1a30: 77 65 73 74 20 6f 66 20 31 32 c2 b0 45 22 5d 2c west of 12..E"],
1a40: 0d 0a 20 20 20 20 42 42 4f 58 5b 33 36 2e 35 33 .. BBOX[36.53
1a50: 2c 35 2e 39 34 2c 34 37 2e 30 34 2c 31 32 5d 2c ,5.94,47.04,12],
1a60: 0d 0a 20 20 20 20 49 44 5b 22 45 50 53 47 22 2c .. ID["EPSG",
1a70: 33 30 30 33 5d 5d 0d 0a 3c 2f 76 65 72 62 61 74 3003]]..</verbat
1a80: 69 6d 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 20 76 61 im></td>..<td va
1a90: 6c 69 67 6e 3d 22 74 6f 70 22 3e 3c 76 65 72 62 lign="top"><verb
1aa0: 61 74 69 6d 3e 0d 0a 47 45 4f 44 43 52 53 5b 22 atim>..GEODCRS["
1ab0: 57 47 53 20 38 34 22 2c 0d 0a 20 20 20 20 44 41 WGS 84",.. DA
1ac0: 54 55 4d 5b 22 57 6f 72 6c 64 20 47 65 6f 64 65 TUM["World Geode
1ad0: 74 69 63 20 53 79 73 74 65 6d 20 31 39 38 34 22 tic System 1984"
1ae0: 2c 0d 0a 20 20 20 20 20 20 20 20 45 4c 4c 49 50 ,.. ELLIP
1af0: 53 4f 49 44 5b 22 57 47 53 20 38 34 22 2c 36 33 SOID["WGS 84",63
1b00: 37 38 31 33 37 2c 32 39 38 2e 32 35 37 32 32 33 78137,298.257223
1b10: 35 36 33 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 563,..
1b20: 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 LENGTHUNIT["me
1b30: 74 72 65 22 2c 31 5d 5d 5d 2c 0d 0a 20 20 20 20 tre",1]]],..
1b40: 50 52 49 4d 45 4d 5b 22 47 72 65 65 6e 77 69 63 PRIMEM["Greenwic
1b50: 68 22 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 41 h",0,.. A
1b60: 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 65 NGLEUNIT["degree
1b70: 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 39 ",0.017453292519
1b80: 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20 43 53 5b 9433]],.. CS[
1b90: 65 6c 6c 69 70 73 6f 69 64 61 6c 2c 32 5d 2c 0d ellipsoidal,2],.
1ba0: 0a 20 20 20 20 20 20 20 20 41 58 49 53 5b 22 67 . AXIS["g
1bb0: 65 6f 64 65 74 69 63 20 6c 61 74 69 74 75 64 65 eodetic latitude
1bc0: 20 28 4c 61 74 29 22 2c 6e 6f 72 74 68 2c 0d 0a (Lat)",north,..
1bd0: 20 20 20 20 20 20 20 20 20 20 20 20 4f 52 44 45 ORDE
1be0: 52 5b 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 R[1],..
1bf0: 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 ANGLEUNIT["de
1c00: 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 gree",0.01745329
1c10: 32 35 31 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 25199433]],..
1c20: 20 20 20 20 20 41 58 49 53 5b 22 67 65 6f 64 65 AXIS["geode
1c30: 74 69 63 20 6c 6f 6e 67 69 74 75 64 65 20 28 4c tic longitude (L
1c40: 6f 6e 29 22 2c 65 61 73 74 2c 0d 0a 20 20 20 20 on)",east,..
1c50: 20 20 20 20 20 20 20 20 4f 52 44 45 52 5b 32 5d ORDER[2]
1c60: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 41 ,.. A
1c70: 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 65 NGLEUNIT["degree
1c80: 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 39 ",0.017453292519
1c90: 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20 41 52 45 9433]],.. ARE
1ca0: 41 5b 22 57 6f 72 6c 64 22 5d 2c 0d 0a 20 20 20 A["World"],..
1cb0: 20 42 42 4f 58 5b 2d 39 30 2c 2d 31 38 30 2c 39 BBOX[-90,-180,9
1cc0: 30 2c 31 38 30 5d 2c 0d 0a 20 20 20 20 49 44 5b 0,180],.. ID[
1cd0: 22 45 50 53 47 22 2c 34 33 32 36 5d 5d 0d 0a 3c "EPSG",4326]]..<
1ce0: 2f 76 65 72 62 61 74 69 6d 3e 3c 2f 74 64 3e 0d /verbatim></td>.
1cf0: 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 .<td valign="top
1d00: 22 3e 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 50 52 "><verbatim>..PR
1d10: 4f 4a 43 52 53 5b 22 57 47 53 20 38 34 20 2f 20 OJCRS["WGS 84 /
1d20: 55 54 4d 20 7a 6f 6e 65 20 33 32 4e 22 2c 0d 0a UTM zone 32N",..
1d30: 20 20 20 20 42 41 53 45 47 45 4f 44 43 52 53 5b BASEGEODCRS[
1d40: 22 57 47 53 20 38 34 22 2c 0d 0a 20 20 20 20 20 "WGS 84",..
1d50: 20 20 20 44 41 54 55 4d 5b 22 57 6f 72 6c 64 20 DATUM["World
1d60: 47 65 6f 64 65 74 69 63 20 53 79 73 74 65 6d 20 Geodetic System
1d70: 31 39 38 34 22 2c 0d 0a 20 20 20 20 20 20 20 20 1984",..
1d80: 20 20 20 20 45 4c 4c 49 50 53 4f 49 44 5b 22 57 ELLIPSOID["W
1d90: 47 53 20 38 34 22 2c 36 33 37 38 31 33 37 2c 32 GS 84",6378137,2
1da0: 39 38 2e 32 35 37 32 32 33 35 36 33 2c 0d 0a 20 98.257223563,..
1db0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 4c L
1dc0: 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 74 72 65 ENGTHUNIT["metre
1dd0: 22 2c 31 5d 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 ",1]]],..
1de0: 20 50 52 49 4d 45 4d 5b 22 47 72 65 65 6e 77 69 PRIMEM["Greenwi
1df0: 63 68 22 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 ch",0,..
1e00: 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 ANGLEUNIT["d
1e10: 65 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 egree",0.0174532
1e20: 39 32 35 31 39 39 34 33 33 5d 5d 5d 2c 0d 0a 20 925199433]]],..
1e30: 20 20 20 43 4f 4e 56 45 52 53 49 4f 4e 5b 22 55 CONVERSION["U
1e40: 54 4d 20 7a 6f 6e 65 20 33 32 4e 22 2c 0d 0a 20 TM zone 32N",..
1e50: 20 20 20 20 20 20 20 4d 45 54 48 4f 44 5b 22 54 METHOD["T
1e60: 72 61 6e 73 76 65 72 73 65 20 4d 65 72 63 61 74 ransverse Mercat
1e70: 6f 72 22 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 or",..
1e80: 20 20 49 44 5b 22 45 50 53 47 22 2c 39 38 30 37 ID["EPSG",9807
1e90: 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 41 52 ]],.. PAR
1ea0: 41 4d 45 54 45 52 5b 22 4c 61 74 69 74 75 64 65 AMETER["Latitude
1eb0: 20 6f 66 20 6e 61 74 75 72 61 6c 20 6f 72 69 67 of natural orig
1ec0: 69 6e 22 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 in",0,..
1ed0: 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 ANGLEUNIT["d
1ee0: 65 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 egree",0.0174532
1ef0: 39 32 35 31 39 39 34 33 33 5d 2c 0d 0a 20 20 20 925199433],..
1f00: 20 20 20 20 20 20 20 20 20 49 44 5b 22 45 50 53 ID["EPS
1f10: 47 22 2c 38 38 30 31 5d 5d 2c 0d 0a 20 20 20 20 G",8801]],..
1f20: 20 20 20 20 50 41 52 41 4d 45 54 45 52 5b 22 4c PARAMETER["L
1f30: 6f 6e 67 69 74 75 64 65 20 6f 66 20 6e 61 74 75 ongitude of natu
1f40: 72 61 6c 20 6f 72 69 67 69 6e 22 2c 39 2c 0d 0a ral origin",9,..
1f50: 20 20 20 20 20 20 20 20 20 20 20 20 41 4e 47 4c ANGL
1f60: 45 55 4e 49 54 5b 22 64 65 67 72 65 65 22 2c 30 EUNIT["degree",0
1f70: 2e 30 31 37 34 35 33 32 39 32 35 31 39 39 34 33 .017453292519943
1f80: 33 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 3],..
1f90: 20 49 44 5b 22 45 50 53 47 22 2c 38 38 30 32 5d ID["EPSG",8802]
1fa0: 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 41 52 41 ],.. PARA
1fb0: 4d 45 54 45 52 5b 22 53 63 61 6c 65 20 66 61 63 METER["Scale fac
1fc0: 74 6f 72 20 61 74 20 6e 61 74 75 72 61 6c 20 6f tor at natural o
1fd0: 72 69 67 69 6e 22 2c 30 2e 39 39 39 36 2c 0d 0a rigin",0.9996,..
1fe0: 20 20 20 20 20 20 20 20 20 20 20 20 53 43 41 4c SCAL
1ff0: 45 55 4e 49 54 5b 22 75 6e 69 74 79 22 2c 31 5d EUNIT["unity",1]
2000: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 ,.. I
2010: 44 5b 22 45 50 53 47 22 2c 38 38 30 35 5d 5d 2c D["EPSG",8805]],
2020: 0d 0a 20 20 20 20 20 20 20 20 50 41 52 41 4d 45 .. PARAME
2030: 54 45 52 5b 22 46 61 6c 73 65 20 65 61 73 74 69 TER["False easti
2040: 6e 67 22 2c 35 30 30 30 30 30 2c 0d 0a 20 20 20 ng",500000,..
2050: 20 20 20 20 20 20 20 20 20 4c 45 4e 47 54 48 55 LENGTHU
2060: 4e 49 54 5b 22 6d 65 74 72 65 22 2c 31 5d 2c 0d NIT["metre",1],.
2070: 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 44 5b . ID[
2080: 22 45 50 53 47 22 2c 38 38 30 36 5d 5d 2c 0d 0a "EPSG",8806]],..
2090: 20 20 20 20 20 20 20 20 50 41 52 41 4d 45 54 45 PARAMETE
20a0: 52 5b 22 46 61 6c 73 65 20 6e 6f 72 74 68 69 6e R["False northin
20b0: 67 22 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 20 g",0,..
20c0: 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d LENGTHUNIT["m
20d0: 65 74 72 65 22 2c 31 5d 2c 0d 0a 20 20 20 20 20 etre",1],..
20e0: 20 20 20 20 20 20 20 49 44 5b 22 45 50 53 47 22 ID["EPSG"
20f0: 2c 38 38 30 37 5d 5d 5d 2c 0d 0a 20 20 20 20 43 ,8807]]],.. C
2100: 53 5b 43 61 72 74 65 73 69 61 6e 2c 32 5d 2c 0d S[Cartesian,2],.
2110: 0a 20 20 20 20 20 20 20 20 41 58 49 53 5b 22 28 . AXIS["(
2120: 45 29 22 2c 65 61 73 74 2c 0d 0a 20 20 20 20 20 E)",east,..
2130: 20 20 20 20 20 20 20 4f 52 44 45 52 5b 31 5d 2c ORDER[1],
2140: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4c 45 .. LE
2150: 4e 47 54 48 55 4e 49 54 5b 22 6d 65 74 72 65 22 NGTHUNIT["metre"
2160: 2c 31 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 41 ,1]],.. A
2170: 58 49 53 5b 22 28 4e 29 22 2c 6e 6f 72 74 68 2c XIS["(N)",north,
2180: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4f 52 .. OR
2190: 44 45 52 5b 32 5d 2c 0d 0a 20 20 20 20 20 20 20 DER[2],..
21a0: 20 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b LENGTHUNIT[
21b0: 22 6d 65 74 72 65 22 2c 31 5d 5d 2c 0d 0a 20 20 "metre",1]],..
21c0: 20 20 41 52 45 41 5b 22 57 6f 72 6c 64 20 2d 20 AREA["World -
21d0: 4e 20 68 65 6d 69 73 70 68 65 72 65 20 2d 20 36 N hemisphere - 6
21e0: c2 b0 45 20 74 6f 20 31 32 c2 b0 45 20 2d 20 62 ..E to 12..E - b
21f0: 79 20 63 6f 75 6e 74 72 79 22 5d 2c 0d 0a 20 20 y country"],..
2200: 20 20 42 42 4f 58 5b 30 2c 36 2c 38 34 2c 31 32 BBOX[0,6,84,12
2210: 5d 2c 0d 0a 20 20 20 20 49 44 5b 22 45 50 53 47 ],.. ID["EPSG
2220: 22 2c 33 32 36 33 32 5d 5d 0d 0a 3c 2f 76 65 72 ",32632]]..</ver
2230: 62 61 74 69 6d 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 batim></td>..</t
2240: 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 0d 0a 3c 62 r>..</table>..<b
2250: 72 3e 0d 0a 41 73 20 79 6f 75 20 63 61 6e 20 65 r>..As you can e
2260: 61 73 69 6c 79 20 6e 6f 74 69 63 65 2c 20 74 68 asily notice, th
2270: 65 20 74 77 6f 20 6e 6f 74 61 74 69 6f 6e 73 20 e two notations
2280: 61 72 65 20 70 72 6f 66 6f 75 6e 64 6c 79 20 64 are profoundly d
2290: 69 66 66 65 72 65 6e 74 2e 0d 0a 54 68 65 20 6f ifferent...The o
22a0: 6c 64 20 3c 62 3e 70 72 6f 6a 2d 73 74 72 69 6e ld <b>proj-strin
22b0: 67 3c 2f 62 3e 20 6e 6f 74 61 74 69 6f 6e 20 69 g</b> notation i
22c0: 73 20 65 78 74 72 65 6d 65 6c 79 20 63 6f 6e 63 s extremely conc
22d0: 69 73 65 20 61 6e 64 20 72 6f 75 67 68 2c 20 77 ise and rough, w
22e0: 68 69 6c 73 74 20 74 68 65 20 6e 65 77 20 3c 62 hilst the new <b
22f0: 3e 49 53 4f 2d 57 4b 54 3c 2f 62 3e 20 69 73 20 >ISO-WKT</b> is
2300: 76 65 72 62 6f 73 65 20 62 75 74 20 65 78 68 61 verbose but exha
2310: 75 73 74 69 76 65 2c 20 64 65 74 61 69 6c 65 64 ustive, detailed
2320: 20 61 6e 64 20 70 72 65 63 69 73 65 2e 3c 62 72 and precise.<br
2330: 3e 0d 0a 54 68 65 72 65 20 69 73 20 6e 6f 20 70 >..There is no p
2340: 6f 73 73 69 62 6c 65 20 6d 61 74 63 68 3a 20 49 ossible match: I
2350: 53 4f 2d 4b 57 54 20 69 73 20 63 6c 65 61 72 6c SO-KWT is clearl
2360: 79 20 73 75 70 65 72 69 6f 72 20 61 6e 64 20 6d y superior and m
2370: 6f 72 65 20 73 6f 70 68 69 73 74 69 63 61 74 65 ore sophisticate
2380: 64 20 75 6e 64 65 72 20 61 6e 79 20 70 6f 73 73 d under any poss
2390: 69 62 6c 65 20 61 73 70 65 63 74 2e 3c 62 72 3e ible aspect.<br>
23a0: 0d 0a 4e 6f 74 20 61 74 20 61 6c 6c 20 73 75 72 ..Not at all sur
23b0: 70 72 69 73 69 6e 67 6c 79 2c 20 63 6f 6f 72 64 prisingly, coord
23c0: 69 6e 61 74 65 20 74 72 61 6e 73 66 6f 72 6d 61 inate transforma
23d0: 74 69 6f 6e 73 20 62 61 73 65 64 20 6f 6e 20 49 tions based on I
23e0: 53 4f 2d 57 4b 54 20 64 65 66 69 6e 69 74 69 6f SO-WKT definitio
23f0: 6e 73 20 28 69 6e 73 74 65 61 64 20 6f 66 20 70 ns (instead of p
2400: 72 6f 6a 2d 73 74 72 69 6e 67 73 29 20 61 72 65 roj-strings) are
2410: 20 75 73 75 61 6c 6c 79 20 65 78 70 65 63 74 65 usually expecte
2420: 64 20 74 6f 20 62 65 20 6d 6f 72 65 20 61 63 63 d to be more acc
2430: 75 72 61 74 65 2e 3c 62 72 3e 3c 62 72 3e 0d 0a urate.<br><br>..
2440: 41 6e 64 20 74 68 61 74 27 73 20 6e 6f 74 20 61 And that's not a
2450: 6c 6c 3b 20 74 68 65 20 6f 6c 64 20 3c 62 3e 70 ll; the old <b>p
2460: 72 6f 6a 2d 73 74 72 69 6e 67 73 3c 2f 62 3e 20 roj-strings</b>
2470: 77 65 72 65 6e 27 74 20 66 6f 72 6d 61 6c 6c 79 weren't formally
2480: 20 64 65 66 69 6e 65 64 20 62 79 20 61 6e 79 20 defined by any
2490: 73 74 61 6e 64 61 72 64 2c 20 61 6e 64 20 6f 6e standard, and on
24a0: 6c 79 20 50 52 4f 4a 2c 20 47 44 41 4c 20 61 6e ly PROJ, GDAL an
24b0: 64 20 66 65 77 20 6f 74 68 65 72 20 46 4c 4f 53 d few other FLOS
24c0: 53 20 2f 20 47 46 4f 53 53 20 69 6d 70 6c 65 6d S / GFOSS implem
24d0: 65 6e 74 61 74 69 6f 6e 73 20 63 61 6e 20 75 6e entations can un
24e0: 64 65 72 73 74 61 6e 64 20 74 68 65 6d 2e 3c 62 derstand them.<b
24f0: 72 3e 0d 0a 41 74 20 74 68 65 20 6f 70 70 6f 73 r>..At the oppos
2500: 69 74 65 2c 20 74 68 65 20 6e 65 77 20 3c 62 3e ite, the new <b>
2510: 49 53 4f 2d 57 4b 54 3c 2f 62 3e 20 69 73 20 66 ISO-WKT</b> is f
2520: 6f 72 6d 61 6c 6c 79 20 64 65 66 69 6e 65 64 20 ormally defined
2530: 62 79 20 61 6e 20 69 6e 74 65 72 6e 61 74 69 6f by an internatio
2540: 6e 61 6c 20 73 74 61 6e 64 61 72 64 2c 20 61 6e nal standard, an
2550: 64 20 6d 61 6e 79 20 66 72 65 65 20 61 6e 64 20 d many free and
2560: 70 72 6f 70 72 69 65 74 61 72 79 20 69 6d 70 6c proprietary impl
2570: 65 6d 65 6e 74 61 74 69 6f 6e 73 20 63 61 6e 20 ementations can
2580: 75 6e 64 65 72 73 74 61 6e 64 20 69 74 2e 3c 62 understand it.<b
2590: 72 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 r><br>..<table c
25a0: 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 ellspacing="8" c
25b0: 65 6c 6c 70 61 64 64 69 6e 67 3d 22 31 36 22 20 ellpadding="16"
25c0: 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 39 bgcolor="#ffffe9
25d0: 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 62 ">..<tr><td>..<b
25e0: 3e 3c 75 3e 49 6d 70 6f 72 74 61 6e 74 20 6e 6f ><u>Important no
25f0: 74 69 63 65 3c 2f 75 3e 3c 2f 62 3e 3a 20 74 68 tice</u></b>: th
2600: 65 72 65 20 61 72 65 20 73 65 76 65 72 61 6c 20 ere are several
2610: 64 69 61 6c 65 63 74 73 20 69 6e 20 74 68 65 20 dialects in the
2620: 57 4b 54 20 6e 6f 74 61 74 69 6f 6e 20 64 65 73 WKT notation des
2630: 63 72 69 62 69 6e 67 20 43 52 53 65 73 2e 3c 62 cribing CRSes.<b
2640: 72 3e 0d 0a 41 6c 6c 20 74 68 65 6d 20 73 68 61 r>..All them sha
2650: 72 65 20 74 68 65 20 73 61 6d 65 20 63 6f 72 65 re the same core
2660: 20 61 6e 64 20 6d 61 69 6e 6c 79 20 64 69 66 66 and mainly diff
2670: 65 72 20 69 6e 20 66 65 77 20 6d 69 6e 6f 72 20 er in few minor
2680: 64 65 74 61 69 6c 73 2e 3c 62 72 3e 0d 0a 50 52 details.<br>..PR
2690: 4f 4a 2e 36 20 63 61 6e 20 75 6e 64 65 72 73 74 OJ.6 can underst
26a0: 61 6e 64 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e and the followin
26b0: 67 20 64 69 61 6c 65 63 74 73 3a 0d 0a 3c 6f 6c g dialects:..<ol
26c0: 3e 0d 0a 3c 6c 69 3e 3c 62 3e 45 53 52 49 20 57 >..<li><b>ESRI W
26d0: 4b 54 3c 2f 62 3e 3a 20 61 20 64 69 61 6c 65 63 KT</b>: a dialec
26e0: 74 20 77 69 64 65 6c 79 20 61 64 6f 70 74 65 64 t widely adopted
26f0: 20 62 79 20 45 53 52 49 20 70 72 6f 70 72 69 65 by ESRI proprie
2700: 74 61 72 79 20 73 6f 66 74 77 61 72 65 2e 3c 2f tary software.</
2710: 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 47 44 41 4c li>..<li><b>GDAL
2720: 20 57 4b 54 31 3c 2f 62 3e 3a 20 61 20 64 69 61 WKT1</b>: a dia
2730: 6c 65 63 74 20 68 69 73 74 6f 72 69 63 61 6c 6c lect historicall
2740: 79 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 74 y supported by t
2750: 68 65 20 6f 70 65 6e 20 73 6f 75 72 63 65 20 47 he open source G
2760: 44 41 4c 20 6c 69 62 72 61 72 79 2e 3c 2f 6c 69 DAL library.</li
2770: 3e 0d 0a 3c 6c 69 3e 3c 62 3e 57 4b 54 32 3a 32 >..<li><b>WKT2:2
2780: 30 31 35 3c 2f 62 3e 3a 20 61 73 20 64 65 66 69 015</b>: as defi
2790: 6e 65 64 20 62 79 20 3c 62 3e 49 53 4f 20 31 39 ned by <b>ISO 19
27a0: 31 36 32 3a 32 30 31 35 3c 2f 62 3e 20 73 74 61 162:2015</b> sta
27b0: 6e 64 61 72 64 20 73 70 65 63 69 66 69 63 61 74 ndard specificat
27c0: 69 6f 6e 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e ions.</li>..<li>
27d0: 3c 62 3e 57 4b 54 32 3a 32 30 31 38 3c 2f 62 3e <b>WKT2:2018</b>
27e0: 3a 20 61 73 20 64 65 66 69 6e 65 64 20 62 79 20 : as defined by
27f0: 3c 62 3e 49 53 4f 20 31 39 31 36 32 3a 32 30 31 <b>ISO 19162:201
2800: 38 3c 2f 62 3e 20 73 74 61 6e 64 61 72 64 20 73 8</b> standard s
2810: 70 65 63 69 66 69 63 61 74 69 6f 6e 73 2e 3c 2f pecifications.</
2820: 6c 69 3e 0d 0a 3c 2f 6f 6c 3e 0d 0a 3c 2f 74 64 li>..</ol>..</td
2830: 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e ></tr>..</table>
2840: 3c 62 72 3e 0d 0a 3c 68 33 3e 54 72 61 6e 73 66 <br>..<h3>Transf
2850: 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 6c 69 6e ormation pipelin
2860: 65 73 3c 2f 68 33 3e 0d 0a 54 68 65 72 65 20 69 es</h3>..There i
2870: 73 20 61 20 73 65 63 6f 6e 64 20 61 73 74 6f 6e s a second aston
2880: 69 73 68 69 6e 67 20 69 6d 70 72 6f 76 65 6d 65 ishing improveme
2890: 6e 74 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 nt supported by
28a0: 50 52 4f 4a 2e 36 2c 20 74 68 61 74 20 61 72 65 PROJ.6, that are
28b0: 20 3c 62 3e 74 72 61 6e 73 66 6f 72 6d 61 74 69 <b>transformati
28c0: 6f 6e 20 70 69 70 65 6c 69 6e 65 73 3c 2f 62 3e on pipelines</b>
28d0: 2e 3c 62 72 3e 0d 0a 57 68 65 6e 20 75 73 69 6e .<br>..When usin
28e0: 67 20 61 20 3c 62 3e 70 69 70 65 6c 69 6e 65 3c g a <b>pipeline<
28f0: 2f 62 3e 20 79 6f 75 20 63 61 6e 20 66 72 65 65 /b> you can free
2900: 6c 79 20 64 65 66 69 6e 65 20 61 6e 79 20 63 6f ly define any co
2910: 6d 70 6c 65 78 20 67 65 6f 64 65 74 69 63 20 74 mplex geodetic t
2920: 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 62 79 ransformation by
2930: 20 63 68 61 69 6e 69 6e 67 20 74 6f 67 65 74 68 chaining togeth
2940: 65 72 20 6d 61 6e 79 20 65 6c 65 6d 65 6e 74 61 er many elementa
2950: 72 79 20 73 74 65 70 73 20 73 75 63 68 20 61 73 ry steps such as
2960: 20 63 6f 6e 76 65 72 73 69 6f 6e 2c 20 74 72 61 conversion, tra
2970: 6e 73 66 6f 72 6d 61 74 69 6f 6e 2c 20 70 72 6f nsformation, pro
2980: 6a 65 63 74 69 6f 6e 2c 20 61 78 69 73 20 73 77 jection, axis sw
2990: 61 70 20 61 6e 64 20 73 6f 20 6f 6e 2e 3c 62 72 ap and so on.<br
29a0: 3e 0d 0a 41 20 70 69 70 65 6c 69 6e 65 20 69 73 >..A pipeline is
29b0: 20 63 6f 6e 63 65 70 74 75 61 6c 6c 79 20 73 69 conceptually si
29c0: 6d 69 6c 61 72 20 74 6f 20 61 20 55 4e 49 58 20 milar to a UNIX
29d0: 73 68 65 6c 6c 20 73 63 72 69 70 74 2c 20 77 69 shell script, wi
29e0: 74 68 20 61 20 64 61 74 61 66 6c 6f 77 20 72 65 th a dataflow re
29f0: 67 75 6c 61 72 6c 79 20 70 72 6f 63 65 64 69 6e gularly procedin
2a00: 67 20 66 6f 72 77 61 72 64 20 66 72 6f 6d 20 73 g forward from s
2a10: 74 65 70 20 74 6f 20 73 74 65 70 20 75 6e 74 69 tep to step unti
2a20: 6c 20 70 72 6f 64 75 63 69 6e 67 20 74 68 65 20 l producing the
2a30: 66 69 6e 61 6c 20 72 65 73 75 6c 74 2e 3c 62 72 final result.<br
2a40: 3e 0d 0a 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 >..The following
2a50: 20 69 73 20 61 20 70 72 61 63 74 69 61 6c 20 65 is a practial e
2a60: 78 61 6d 70 6c 65 20 6f 66 20 61 20 70 69 70 65 xample of a pipe
2a70: 6c 69 6e 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 line correspondi
2a80: 6e 67 20 74 6f 20 61 20 74 72 61 6e 73 66 6f 72 ng to a transfor
2a90: 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 3c 62 3e 4e mation from <b>N
2aa0: 41 44 32 37 3c 2f 62 3e 20 74 6f 20 3c 62 3e 4e AD27</b> to <b>N
2ab0: 41 44 38 33 3c 2f 62 3e 2c 0d 0a 3c 76 65 72 62 AD83</b>,..<verb
2ac0: 61 74 69 6d 3e 0d 0a 2b 70 72 6f 6a 3d 70 69 70 atim>..+proj=pip
2ad0: 65 6c 69 6e 65 20 0d 0a 2b 73 74 65 70 20 2b 70 eline ..+step +p
2ae0: 72 6f 6a 3d 61 78 69 73 73 77 61 70 20 2b 6f 72 roj=axisswap +or
2af0: 64 65 72 3d 32 2c 31 20 0d 0a 2b 73 74 65 70 20 der=2,1 ..+step
2b00: 2b 70 72 6f 6a 3d 75 6e 69 74 63 6f 6e 76 65 72 +proj=unitconver
2b10: 74 20 2b 78 79 5f 69 6e 3d 64 65 67 20 2b 78 79 t +xy_in=deg +xy
2b20: 5f 6f 75 74 3d 72 61 64 20 0d 0a 2b 73 74 65 70 _out=rad ..+step
2b30: 20 2b 70 72 6f 6a 3d 68 67 72 69 64 73 68 69 66 +proj=hgridshif
2b40: 74 20 2b 67 72 69 64 73 3d 63 6f 6e 75 73 20 0d t +grids=conus .
2b50: 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 75 6e 69 .+step +proj=uni
2b60: 74 63 6f 6e 76 65 72 74 20 2b 78 79 5f 69 6e 3d tconvert +xy_in=
2b70: 72 61 64 20 2b 78 79 5f 6f 75 74 3d 64 65 67 20 rad +xy_out=deg
2b80: 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 61 78 ..+step +proj=ax
2b90: 69 73 73 77 61 70 20 2b 6f 72 64 65 72 3d 32 2c isswap +order=2,
2ba0: 31 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 1..</verbatim>..
2bb0: 3c 68 33 3e 54 68 65 20 70 72 69 76 61 74 65 20 <h3>The private
2bc0: 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 20 SQLite database
2bd0: 73 75 70 70 6f 72 74 69 6e 67 20 50 52 4f 4a 2e supporting PROJ.
2be0: 36 3c 2f 68 33 3e 0d 0a 53 74 61 72 74 69 6e 67 6</h3>..Starting
2bf0: 20 73 69 6e 63 65 20 3c 62 3e 50 52 4f 4a 2e 36 since <b>PROJ.6
2c00: 3c 2f 62 3e 20 74 68 65 20 50 52 4f 4a 20 6c 69 </b> the PROJ li
2c10: 62 72 61 72 79 20 72 65 71 75 69 72 65 73 20 61 brary requires a
2c20: 6e 20 65 78 74 65 72 6e 61 6c 20 53 51 4c 69 74 n external SQLit
2c30: 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 74 61 e database conta
2c40: 69 6e 69 6e 67 20 61 6c 6c 20 64 65 66 69 6e 69 ining all defini
2c50: 74 69 6f 6e 73 20 61 62 6f 75 74 20 73 75 70 70 tions about supp
2c60: 6f 72 74 65 64 20 43 52 53 65 73 2c 20 45 6c 6c orted CRSes, Ell
2c70: 69 70 73 6f 69 64 73 2c 20 50 72 69 6d 65 20 4d ipsoids, Prime M
2c80: 65 72 69 64 69 61 6e 73 2c 20 55 6e 69 74 20 6f eridians, Unit o
2c90: 66 20 4d 65 61 73 75 72 65 2c 20 54 72 61 6e 73 f Measure, Trans
2ca0: 66 6f 72 6d 61 74 69 6f 6e 73 20 61 6e 64 20 73 formations and s
2cb0: 6f 20 6f 6e 2e 3c 62 72 3e 0d 0a 4d 61 6e 79 20 o on.<br>..Many
2cc0: 6f 66 20 74 68 65 20 6e 65 77 20 61 64 76 61 6e of the new advan
2cd0: 63 65 64 20 50 52 4f 4a 27 73 20 41 50 49 20 77 ced PROJ's API w
2ce0: 69 6c 6c 20 66 61 69 6c 20 69 66 20 73 75 63 68 ill fail if such
2cf0: 20 64 61 74 61 62 61 73 65 20 69 73 20 6e 6f 74 database is not
2d00: 20 61 76 61 69 6c 61 62 6c 65 2e 0d 0a 3c 62 72 available...<br
2d10: 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 ><br>..<table ce
2d20: 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65 llspacing="8" ce
2d30: 6c 6c 70 61 64 64 69 6e 67 3d 22 38 22 20 62 67 llpadding="8" bg
2d40: 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 39 22 3e color="#ffffe9">
2d50: 0d 0a 3c 74 72 3e 3c 74 68 3e 0d 0a 49 6e 20 6f ..<tr><th>..In o
2d60: 72 64 65 72 20 74 6f 20 6c 65 61 72 6e 20 6d 6f rder to learn mo
2d70: 72 65 20 61 62 6f 75 74 20 74 68 65 20 6d 61 6e re about the man
2d80: 79 20 69 6e 74 65 72 65 73 74 69 6e 67 20 63 6f y interesting co
2d90: 6f 6c 20 6e 65 77 20 66 65 61 74 75 72 65 73 20 ol new features
2da0: 73 75 70 70 6f 72 74 65 64 20 62 79 20 50 52 4f supported by PRO
2db0: 4a 2e 36 20 70 6c 65 61 73 65 20 63 6f 6e 73 75 J.6 please consu
2dc0: 6c 74 20 74 68 65 20 3c 61 20 68 72 65 66 3d 22 lt the <a href="
2dd0: 68 74 74 70 73 3a 2f 2f 70 72 6f 6a 34 2e 6f 72 https://proj4.or
2de0: 67 2f 22 3e 6f 72 69 67 69 6e 61 6c 20 64 6f 63 g/">original doc
2df0: 75 6d 65 6e 74 61 74 69 6f 6e 3c 2f 61 3e 0d 0a umentation</a>..
2e00: 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 </th></tr>..</ta
2e10: 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 68 72 3e 0d 0a ble><br>..<hr>..
2e20: 3c 68 31 3e 53 70 61 74 69 61 4c 69 74 65 2d 35 <h1>SpatiaLite-5
2e30: 2e 30 2e 30 20 73 75 70 70 6f 72 74 69 6e 67 20 .0.0 supporting
2e40: 50 52 4f 4a 2e 36 3c 2f 68 31 3e 0d 0a 3c 68 33 PROJ.6</h1>..<h3
2e50: 3e 45 78 69 73 74 69 6e 67 20 53 51 4c 20 66 75 >Existing SQL fu
2e60: 6e 63 74 69 6f 6e 73 20 61 66 66 65 63 74 65 64 nctions affected
2e70: 20 62 79 20 50 52 4f 4a 2e 36 3c 2f 68 33 3e 0d by PROJ.6</h3>.
2e80: 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 .<table cellspac
2e90: 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 ing="8" cellpadd
2ea0: 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 3d ing="8" bgcolor=
2eb0: 22 23 65 38 66 66 65 38 22 20 62 6f 72 64 65 72 "#e8ffe8" border
2ec0: 3d 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 ="1">..<tr><th b
2ed0: 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 gcolor="#ffb03e"
2ee0: 3e 53 51 4c 20 46 75 6e 63 74 69 6f 6e 3c 2f 74 >SQL Function</t
2ef0: 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 h><th bgcolor="#
2f00: 66 66 62 30 33 65 22 3e 45 78 74 65 6e 64 65 64 ffb03e">Extended
2f10: 20 73 69 67 6e 61 74 75 72 65 3c 2f 74 68 3e 3c signature</th><
2f20: 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 th bgcolor="#ffb
2f30: 30 33 65 22 3e 42 65 68 61 76 69 6f 72 20 75 6e 03e">Behavior un
2f40: 64 65 72 20 50 52 4f 4a 2e 36 3c 2f 74 68 3e 3c der PROJ.6</th><
2f50: 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 /tr>..<tr><td><b
2f60: 3e 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 29 3c >ST_Transform()<
2f70: 2f 62 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a /b></td>..<td>..
2f80: 3c 62 3e 53 54 5f 54 72 61 6e 73 66 6f 72 6d 3c <b>ST_Transform<
2f90: 2f 62 3e 20 28 20 67 65 6f 6d 20 3c 69 3e 47 65 /b> ( geom <i>Ge
2fa0: 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 6e 65 77 ometry</i> , new
2fb0: 53 72 69 64 20 3c 69 3e 49 6e 74 65 67 65 72 3c Srid <i>Integer<
2fc0: 2f 69 3e 20 2c 20 61 72 65 61 20 3c 69 3e 47 65 /i> , area <i>Ge
2fd0: 6f 6d 65 74 72 79 3c 2f 69 3e 20 29 20 3a 20 3c ometry</i> ) : <
2fe0: 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 3c 68 i>Geometry</i><h
2ff0: 72 3e 0d 0a 3c 62 3e 53 54 5f 54 72 61 6e 73 66 r>..<b>ST_Transf
3000: 6f 72 6d 3c 2f 62 3e 20 28 20 67 65 6f 6d 20 3c orm</b> ( geom <
3010: 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c i>Geometry</i> ,
3020: 20 6e 65 77 53 72 69 64 20 3c 69 3e 49 6e 74 65 newSrid <i>Inte
3030: 67 65 72 3c 2f 69 3e 20 2c 20 61 72 65 61 20 3c ger</i> , area <
3040: 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c i>Geometry</i> ,
3050: 20 6d 65 74 68 6f 64 20 3c 69 3e 54 65 78 74 3c method <i>Text<
3060: 2f 69 3e 20 29 20 3a 20 3c 69 3e 47 65 6f 6d 65 /i> ) : <i>Geome
3070: 74 72 79 3c 2f 69 3e 3c 68 72 3e 0d 0a 3c 62 3e try</i><hr>..<b>
3080: 53 54 5f 54 72 61 6e 73 66 6f 72 6d 3c 2f 62 3e ST_Transform</b>
3090: 20 28 20 67 65 6f 6d 20 3c 69 3e 47 65 6f 6d 65 ( geom <i>Geome
30a0: 74 72 79 3c 2f 69 3e 20 2c 20 6e 65 77 53 72 69 try</i> , newSri
30b0: 64 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e d <i>Integer</i>
30c0: 20 2c 20 61 72 65 61 20 3c 69 3e 47 65 6f 6d 65 , area <i>Geome
30d0: 74 72 79 3c 2f 69 3e 20 2c 20 6d 65 74 68 6f 64 try</i> , method
30e0: 20 3c 69 3e 54 65 78 74 3c 2f 69 3e 20 2c 20 70 <i>Text</i> , p
30f0: 72 6f 6a 5f 73 74 72 69 6e 67 20 3c 69 3e 54 65 roj_string <i>Te
3100: 78 74 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 47 65 xt</i> ) : <i>Ge
3110: 6f 6d 65 74 72 79 3c 2f 69 3e 0d 0a 3c 2f 74 64 ometry</i>..</td
3120: 3e 0d 0a 3c 74 64 3e 0d 0a 3c 74 61 62 6c 65 20 >..<td>..<table
3130: 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 34 22 20 cellspacing="4"
3140: 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 34 22 20 cellpadding="4"
3150: 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 64 30 bgcolor="#ffffd0
3160: 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 62 ">..<tr><td>..<b
3170: 3e 3c 75 3e 3c 69 3e 4e 6f 74 65 3c 2f 69 3e 3c ><u><i>Note</i><
3180: 2f 75 3e 3c 2f 62 3e 3a 20 61 6c 6c 20 74 68 65 /u></b>: all the
3190: 73 65 20 3c 62 3e 3c 69 3e 65 78 74 65 6e 64 65 se <b><i>extende
31a0: 64 20 73 69 67 6e 61 74 75 72 65 73 3c 2f 69 3e d signatures</i>
31b0: 3c 2f 62 3e 20 61 72 65 20 73 75 70 70 6f 72 74 </b> are support
31c0: 65 64 20 6f 6e 6c 79 20 77 68 65 6e 20 3c 62 3e ed only when <b>
31d0: 6c 69 62 73 70 61 74 69 61 6c 69 74 65 2d 35 2e libspatialite-5.
31e0: 30 3c 2f 62 3e 20 68 61 73 20 62 65 65 6e 20 62 0</b> has been b
31f0: 75 69 6c 74 20 6f 6e 20 74 68 65 20 74 6f 70 20 uilt on the top
3200: 6f 66 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e of <b>PROJ.6</b>
3210: 3c 62 72 3e 0d 0a 49 66 20 74 68 65 20 6c 69 62 <br>..If the lib
3220: 72 61 72 79 20 68 61 73 20 62 65 65 6e 20 62 75 rary has been bu
3230: 69 6c 74 20 69 6e 73 74 65 61 64 20 6f 6e 20 65 ilt instead on e
3240: 61 72 6c 69 65 72 20 76 65 72 73 69 6f 6e 73 20 arlier versions
3250: 6f 66 20 50 52 4f 4a 20 61 6e 79 20 61 74 74 65 of PROJ any atte
3260: 6d 70 74 20 74 6f 20 63 61 6c 6c 20 74 68 65 73 mpt to call thes
3270: 65 20 65 78 74 65 6e 64 65 64 20 73 69 67 6e 61 e extended signa
3280: 74 75 72 65 73 20 77 69 6c 6c 20 6a 75 73 74 20 tures will just
3290: 72 65 74 75 72 6e 20 61 20 3c 62 3e 77 72 6f 6e return a <b>wron
32a0: 67 20 6e 75 6d 62 65 72 20 6f 66 20 61 72 67 75 g number of argu
32b0: 6d 65 6e 74 73 20 74 6f 20 66 75 6e 63 74 69 6f ments to functio
32c0: 6e 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 29 n ST_Transform()
32d0: 3c 2f 62 3e 20 65 72 72 6f 72 2e 0d 0a 3c 2f 74 </b> error...</t
32e0: 64 3e 3c 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e d><tr>..</table>
32f0: 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c <br>..<table cel
3300: 6c 73 70 61 63 69 6e 67 3d 22 34 22 20 63 65 6c lspacing="4" cel
3310: 6c 70 61 64 64 69 6e 67 3d 22 34 22 20 62 67 63 lpadding="4" bgc
3320: 6f 6c 6f 72 3d 22 23 66 66 64 66 64 30 22 3e 0d olor="#ffdfd0">.
3330: 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 41 6e 79 20 69 .<tr><td>..Any i
3340: 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 20 nvalid argument
3350: 70 61 73 73 65 64 20 74 6f 20 3c 62 3e 53 54 5f passed to <b>ST_
3360: 54 72 61 6e 73 66 6f 72 6d 28 29 3c 2f 62 3e 20 Transform()</b>
3370: 28 3c 62 3e 3c 69 3e 65 78 74 65 6e 64 65 64 20 (<b><i>extended
3380: 73 69 67 6e 61 74 75 72 65 73 3c 2f 69 3e 3c 2f signatures</i></
3390: 62 3e 29 20 77 69 6c 6c 20 72 61 69 73 65 20 61 b>) will raise a
33a0: 6e 20 3c 62 3e 53 51 4c 20 45 78 63 65 70 74 69 n <b>SQL Excepti
33b0: 6f 6e 3c 2f 62 3e 2e 0d 0a 3c 2f 74 64 3e 3c 74 on</b>...</td><t
33c0: 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e r>..</table><br>
33d0: 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 74 68 65 20 ..<ul>..<li>the
33e0: 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e optional argumen
33f0: 74 20 3c 62 3e 61 72 65 61 3c 2f 62 3e 20 6d 61 t <b>area</b> ma
3400: 79 20 62 65 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e y be <b>NULL</b>
3410: 20 28 3c 69 3e 64 65 66 61 75 6c 74 20 73 65 74 (<i>default set
3420: 74 69 6e 67 3c 2f 69 3e 29 2e 3c 62 72 3e 0d 0a ting</i>).<br>..
3430: 4f 74 68 65 72 77 69 73 65 20 69 74 27 73 20 65 Otherwise it's e
3440: 78 70 65 63 74 65 64 20 74 6f 20 63 6f 6e 74 61 xpected to conta
3450: 69 6e 20 61 20 76 61 6c 69 64 20 47 65 6f 6d 65 in a valid Geome
3460: 74 72 79 20 69 6e 20 3c 62 3e 53 52 49 44 3d 34 try in <b>SRID=4
3470: 33 32 36 20 28 6c 6f 6e 67 2f 6c 61 74 29 3c 2f 326 (long/lat)</
3480: 62 3e 2e 0d 0a 57 68 65 6e 20 61 6e 20 3c 62 3e b>...When an <b>
3490: 3c 69 3e 61 72 65 61 20 6f 66 20 75 73 65 3c 2f <i>area of use</
34a0: 69 3e 3c 2f 62 3e 20 69 73 20 65 78 70 6c 69 63 i></b> is explic
34b0: 69 74 6c 79 20 73 75 70 70 6c 69 65 64 2c 20 74 itly supplied, t
34c0: 68 65 6e 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 hen <b>PROJ.6</b
34d0: 3e 20 6d 61 79 20 65 76 65 6e 74 75 61 6c 6c 79 > may eventually
34e0: 20 75 73 65 20 74 68 65 20 63 6f 72 72 65 73 70 use the corresp
34f0: 6f 6e 64 69 6e 67 20 3c 62 3e 42 42 4f 58 3c 2f onding <b>BBOX</
3500: 62 3e 20 66 6f 72 20 66 69 6e 65 6c 79 20 74 75 b> for finely tu
3510: 6e 69 6e 67 20 74 68 65 20 6d 6f 72 65 20 61 63 ning the more ac
3520: 63 75 72 61 74 65 20 74 72 61 6e 73 66 6f 72 6d curate transform
3530: 61 74 69 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 ation.</li>..<li
3540: 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72 >the optional ar
3550: 67 75 6d 65 6e 74 20 3c 62 3e 6d 65 74 68 6f 64 gument <b>method
3560: 3c 2f 62 3e 20 69 73 20 65 78 70 65 63 74 65 64 </b> is expected
3570: 20 74 6f 20 63 6f 6e 74 61 69 6e 20 6f 6e 65 20 to contain one
3580: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 61 the following va
3590: 6c 75 65 73 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 lues:..<ul>..<li
35a0: 3e 3c 62 3e 70 72 6f 6a 34 74 65 78 74 3c 2f 62 ><b>proj4text</b
35b0: 3e 3a 20 62 6f 74 68 20 43 52 53 65 73 20 28 6f >: both CRSes (o
35c0: 72 69 67 69 6e 20 61 6e 64 20 64 65 73 74 69 6e rigin and destin
35d0: 61 74 69 6f 6e 29 20 77 69 6c 6c 20 62 65 20 64 ation) will be d
35e0: 65 66 69 6e 65 64 20 62 79 20 70 61 73 73 69 6e efined by passin
35f0: 67 20 74 6f 20 50 52 4f 4a 2e 36 20 74 68 65 20 g to PROJ.6 the
3600: 74 72 61 64 69 74 69 6f 6e 61 6c 73 20 3c 62 3e traditionals <b>
3610: 70 72 6f 6a 2d 73 74 72 69 6e 67 3c 2f 62 3e 20 proj-string</b>
3620: 64 65 66 69 6e 69 74 69 6f 6e 73 20 66 6f 72 20 definitions for
3630: 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e the correspondin
3640: 67 20 53 52 49 44 73 20 72 65 74 72 69 65 76 65 g SRIDs retrieve
3650: 64 20 66 72 6f 6d 20 63 6f 6c 75 6d 6e 20 3c 62 d from column <b
3660: 3e 70 72 6f 6a 34 74 65 78 74 3c 2f 62 3e 20 69 >proj4text</b> i
3670: 6e 20 54 61 62 6c 65 20 3c 62 3e 73 70 61 74 69 n Table <b>spati
3680: 61 6c 5f 72 65 66 5f 73 79 73 3c 2f 62 3e 3c 62 al_ref_sys</b><b
3690: 72 3e 0d 0a 54 68 69 73 20 65 78 61 63 74 6c 79 r>..This exactly
36a0: 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 corresponds to
36b0: 74 68 65 20 77 65 6c 6c 20 65 78 74 61 62 6c 69 the well extabli
36c0: 73 68 65 64 20 74 72 61 64 69 74 69 6f 6e 61 6c shed traditional
36d0: 20 62 65 68 61 76 69 6f 72 20 6f 66 20 61 6c 6c behavior of all
36e0: 20 70 72 65 76 69 6f 75 73 20 76 65 72 73 69 6f previous versio
36f0: 6e 73 20 6f 66 20 3c 62 3e 6c 69 62 73 70 61 74 ns of <b>libspat
3700: 69 61 6c 69 74 65 3c 2f 62 3e 20 61 6e 64 20 73 ialite</b> and s
3710: 74 69 6c 6c 20 63 6f 6e 74 69 6e 75 65 73 20 74 till continues t
3720: 6f 20 62 65 20 73 75 70 70 6f 72 74 65 64 20 6d o be supported m
3730: 61 69 6e 6c 79 20 66 6f 72 20 68 69 73 74 6f 72 ainly for histor
3740: 69 63 61 6c 20 63 6f 6d 70 61 74 69 62 69 6c 69 ical compatibili
3750: 74 79 2c 20 62 75 74 20 3c 62 3e 3c 75 3e 3c 69 ty, but <b><u><i
3760: 3e 69 73 6e 27 74 20 61 6e 79 20 6c 6f 6e 67 65 >isn't any longe
3770: 72 20 74 68 65 20 62 65 73 74 20 77 61 79 20 66 r the best way f
3780: 6f 72 20 74 61 6b 69 6e 67 20 66 75 6c 6c 20 70 or taking full p
3790: 72 6f 66 69 74 20 6f 66 20 74 68 65 20 6d 6f 72 rofit of the mor
37a0: 65 20 61 64 76 61 6e 63 65 64 20 63 61 70 61 62 e advanced capab
37b0: 69 6c 69 74 69 65 73 20 6f 66 20 50 52 4f 4a 2e ilities of PROJ.
37c0: 36 3c 2f 69 3e 3c 2f 75 3e 3c 2f 62 3e 3c 2f 6c 6</i></u></b></l
37d0: 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 73 72 74 65 78 i>..<li><b>srtex
37e0: 74 3c 2f 62 3e 3a 20 62 6f 74 68 20 43 52 53 65 t</b>: both CRSe
37f0: 73 20 28 6f 72 69 67 69 6e 20 61 6e 64 20 64 65 s (origin and de
3800: 73 74 69 6e 61 74 69 6f 6e 29 20 77 69 6c 6c 20 stination) will
3810: 62 65 20 64 65 66 69 6e 65 64 20 62 79 20 70 61 be defined by pa
3820: 73 73 69 6e 67 20 74 6f 20 50 52 4f 4a 2e 36 20 ssing to PROJ.6
3830: 74 68 65 20 3c 62 3e 57 4b 54 3c 2f 62 3e 20 64 the <b>WKT</b> d
3840: 65 66 69 6e 69 74 69 6f 6e 73 20 66 6f 72 20 74 efinitions for t
3850: 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 he corresponding
3860: 20 53 52 49 44 73 20 72 65 74 72 69 65 76 65 64 SRIDs retrieved
3870: 20 66 72 6f 6d 20 63 6f 6c 75 6d 6e 20 3c 62 3e from column <b>
3880: 73 72 74 65 78 74 3c 2f 62 3e 20 69 6e 20 54 61 srtext</b> in Ta
3890: 62 6c 65 20 3c 62 3e 73 70 61 74 69 61 6c 5f 72 ble <b>spatial_r
38a0: 65 66 5f 73 79 73 3c 2f 62 3e 3c 62 72 3e 0d 0a ef_sys</b><br>..
38b0: 3c 62 3e 3c 75 3e 3c 69 3e 4e 6f 74 65 3c 2f 69 <b><u><i>Note</i
38c0: 3e 3c 2f 75 3e 3c 2f 62 3e 3a 20 74 68 69 73 20 ></u></b>: this
38d0: 6d 65 74 68 6f 64 20 63 6f 75 6c 64 20 65 66 66 method could eff
38e0: 65 63 74 69 76 65 6c 79 20 74 61 6b 65 20 66 75 ectively take fu
38f0: 6c 6c 20 70 72 6f 66 69 74 20 6f 66 20 74 68 65 ll profit of the
3900: 20 6d 6f 72 65 20 61 64 76 61 6e 63 65 64 20 63 more advanced c
3910: 61 70 61 62 69 6c 69 74 69 65 73 20 6f 66 20 50 apabilities of P
3920: 52 4f 4a 2e 36 2c 20 62 75 74 20 6f 6e 6c 79 20 ROJ.6, but only
3930: 69 66 20 74 68 65 20 75 6e 64 65 72 6c 61 79 69 if the underlayi
3940: 6e 67 20 73 70 61 74 69 61 6c 69 74 65 20 64 61 ng spatialite da
3950: 74 61 62 61 73 65 20 68 61 73 20 62 65 65 6e 20 tabase has been
3960: 63 72 65 61 74 65 64 20 77 69 74 68 20 50 52 4f created with PRO
3970: 4a 2e 36 20 73 75 70 70 6f 72 74 2e 3c 62 72 3e J.6 support.<br>
3980: 0d 0a 42 75 74 20 69 74 20 63 6f 75 6c 64 20 65 ..But it could e
3990: 61 73 69 6c 79 20 62 65 20 69 6e 61 64 65 71 75 asily be inadequ
39a0: 61 74 65 20 77 68 65 6e 20 74 68 65 20 75 6e 64 ate when the und
39b0: 65 72 6c 61 79 69 6e 67 20 73 70 61 74 69 61 6c erlaying spatial
39c0: 69 74 65 20 64 61 74 61 62 61 73 65 20 77 61 73 ite database was
39d0: 20 63 72 65 61 74 65 64 20 62 79 20 73 6f 6d 65 created by some
39e0: 20 65 61 72 6c 69 65 72 20 76 65 72 73 69 6f 6e earlier version
39f0: 20 6f 66 20 73 70 61 74 69 61 6c 69 74 65 20 6c of spatialite l
3a00: 61 63 6b 69 6e 67 20 50 52 4f 4a 2e 36 20 73 75 acking PROJ.6 su
3a10: 70 70 6f 72 74 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 pport.</li>..<li
3a20: 3e 3c 62 3e 61 75 74 68 5f 6e 61 6d 65 3a 61 75 ><b>auth_name:au
3a30: 74 68 5f 73 72 69 64 3c 2f 62 3e 3a 20 62 6f 74 th_srid</b>: bot
3a40: 68 20 43 52 53 65 73 20 28 6f 72 69 67 69 6e 20 h CRSes (origin
3a50: 61 6e 64 20 64 65 73 74 69 6e 61 74 69 6f 6e 29 and destination)
3a60: 20 77 69 6c 6c 20 62 65 20 64 65 66 69 6e 65 64 will be defined
3a70: 20 62 79 20 69 67 6e 6f 72 69 6e 67 20 74 68 65 by ignoring the
3a80: 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 73 74 6f definitions sto
3a90: 72 65 64 20 69 6e 20 3c 62 3e 73 70 61 74 69 61 red in <b>spatia
3aa0: 6c 5f 72 65 66 5f 73 79 73 3c 2f 62 3e 20 61 6e l_ref_sys</b> an
3ab0: 64 20 6c 65 61 76 69 6e 67 20 50 52 4f 4a 2e 36 d leaving PROJ.6
3ac0: 20 66 72 65 65 20 74 6f 20 72 65 74 72 69 65 76 free to retriev
3ad0: 65 20 74 68 65 69 72 20 63 6f 72 72 65 73 70 6f e their correspo
3ae0: 6e 64 69 6e 67 20 64 65 66 69 6e 69 74 69 6f 6e nding definition
3af0: 73 20 66 72 6f 6d 20 69 74 73 20 6f 77 6e 20 70 s from its own p
3b00: 72 69 76 61 74 65 20 53 51 4c 69 74 65 20 64 61 rivate SQLite da
3b10: 74 61 62 61 73 65 2e 3c 62 72 3e 0d 0a 3c 62 3e tabase.<br>..<b>
3b20: 3c 75 3e 3c 69 3e 4e 6f 74 65 3c 2f 69 3e 3c 2f <u><i>Note</i></
3b30: 75 3e 3c 2f 62 3e 3a 20 74 68 69 73 20 6d 65 74 u></b>: this met
3b40: 68 6f 64 20 77 69 6c 6c 20 61 6c 77 61 79 73 20 hod will always
3b50: 74 61 6b 65 20 66 75 6c 6c 20 70 72 6f 66 69 74 take full profit
3b60: 20 6f 66 20 74 68 65 20 6d 6f 72 65 20 61 64 76 of the more adv
3b70: 61 6e 63 65 64 20 63 61 70 61 62 69 6c 69 74 69 anced capabiliti
3b80: 65 73 20 6f 66 20 50 52 4f 4a 2e 36 3c 2f 6c 69 es of PROJ.6</li
3b90: 3e 0d 0a 3c 6c 69 3e 3c 62 3e 70 72 6f 6a 5f 73 >..<li><b>proj_s
3ba0: 74 72 69 6e 67 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a tring</b></li>..
3bb0: 3c 6c 69 3e 3c 62 3e 3c 75 3e 3c 69 3e 4e 6f 74 <li><b><u><i>Not
3bc0: 65 3c 2f 69 3e 3c 75 3e 3c 2f 62 3e 3a 20 3c 62 e</i><u></b>: <b
3bd0: 3e 70 72 6f 6a 34 74 65 78 74 3c 2f 62 3e 20 77 >proj4text</b> w
3be0: 69 6c 6c 20 62 65 20 61 6c 77 61 79 73 20 61 73 ill be always as
3bf0: 73 75 6d 65 64 20 6f 6e 20 3c 62 3e 4e 55 4c 4c sumed on <b>NULL
3c00: 3c 2f 62 3e 20 28 3c 69 3e 64 65 66 61 75 6c 74 </b> (<i>default
3c10: 20 73 65 74 74 69 6e 67 3c 2f 69 3e 29 2e 3c 2f setting</i>).</
3c20: 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c 69 3e 0d li>..</ul></li>.
3c30: 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e 61 .<li>the optiona
3c40: 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e 70 72 l argument <b>pr
3c50: 6f 6a 5f 73 74 72 69 6e 67 3c 2f 62 3e 20 6d 61 oj_string</b> ma
3c60: 79 20 62 65 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e y be <b>NULL</b>
3c70: 20 28 3c 69 3e 64 65 66 61 75 6c 74 20 73 65 74 (<i>default set
3c80: 74 69 6e 67 3c 2f 69 3e 29 2e 3c 62 72 3e 0d 0a ting</i>).<br>..
3c90: 4f 74 68 65 72 77 69 73 65 20 69 74 27 73 20 65 Otherwise it's e
3ca0: 78 70 65 63 74 65 64 20 74 6f 20 63 6f 6e 74 61 xpected to conta
3cb0: 69 6e 20 61 20 76 61 6c 69 64 20 3c 62 3e 50 52 in a valid <b>PR
3cc0: 4f 4a 2e 36 20 74 72 61 6e 73 66 6f 72 6d 61 74 OJ.6 transformat
3cd0: 69 6f 6e 20 73 74 72 69 6e 67 3c 2f 62 3e 2c 20 ion string</b>,
3ce0: 6d 61 79 20 77 65 6c 6c 20 62 65 20 64 65 66 69 may well be defi
3cf0: 6e 69 6e 67 20 61 6e 20 3c 62 3e 75 73 65 72 2d ning an <b>user-
3d00: 64 65 66 69 6e 65 64 20 74 72 61 6e 73 66 6f 72 defined transfor
3d10: 6d 61 74 69 6f 6e 20 70 69 70 65 6c 69 6e 65 3c mation pipeline<
3d20: 2f 62 3e 2e 3c 62 72 3e 0d 0a 4d 65 61 6e 69 6e /b>.<br>..Meanin
3d30: 67 66 75 6c 20 6f 6e 6c 79 20 69 6e 20 74 68 65 gful only in the
3d40: 20 63 61 73 65 20 6f 66 20 3c 62 3e 6d 65 74 68 case of <b>meth
3d50: 6f 64 3d 70 72 6f 6a 5f 73 74 72 69 6e 67 3c 2f od=proj_string</
3d60: 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a b></li>..</ul>..
3d70: 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e </td></tr>..<tr>
3d80: 3c 74 64 3e 3c 62 3e 49 6e 69 74 53 70 61 74 69 <td><b>InitSpati
3d90: 61 6c 4d 65 74 61 44 61 74 61 28 29 3c 2f 62 3e alMetaData()</b>
3da0: 3c 68 72 3e 0d 0a 3c 62 3e 49 6e 69 74 53 70 61 <hr>..<b>InitSpa
3db0: 74 69 61 6c 4d 65 74 61 44 61 74 61 46 75 6c 6c tialMetaDataFull
3dc0: 28 29 3c 2f 62 3e 3c 68 72 3e 0d 0a 3c 62 3e 49 ()</b><hr>..<b>I
3dd0: 6e 73 65 72 74 45 70 73 67 53 52 49 44 28 29 3c nsertEpsgSRID()<
3de0: 2f 74 64 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 63 /td><td align="c
3df0: 65 6e 74 65 72 22 3e 3c 62 3e 75 6e 63 68 61 6e enter"><b>unchan
3e00: 67 65 64 3c 2f 62 3e 3c 2f 74 64 3e 0d 0a 3c 74 ged</b></td>..<t
3e10: 64 3e 0d 0a 41 6c 6c 20 74 68 65 73 65 20 53 51 d>..All these SQ
3e20: 4c 20 46 75 6e 63 74 69 6f 6e 73 20 64 6f 65 73 L Functions does
3e30: 6e 27 74 20 63 68 61 6e 67 65 20 74 68 65 69 72 n't change their
3e40: 20 73 69 67 6e 61 74 75 72 65 73 2c 20 62 75 74 signatures, but
3e50: 20 62 65 68 61 76 65 20 69 6e 20 61 20 73 69 67 behave in a sig
3e60: 6e 69 66 69 63 61 6e 74 6c 79 20 64 69 66 66 65 nificantly diffe
3e70: 72 65 6e 74 20 77 61 79 20 77 68 65 6e 20 3c 62 rent way when <b
3e80: 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 20 73 75 70 70 >PROJ.6</b> supp
3e90: 6f 72 74 20 69 73 20 61 76 61 69 6c 61 62 6c 65 ort is available
3ea0: 2e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 74 72 61 ...<ul>..<li>tra
3eb0: 64 69 74 69 6f 6e 61 6c 20 62 65 68 61 76 69 6f ditional behavio
3ec0: 72 20 6f 6e 20 6f 6c 64 20 3c 62 3e 50 52 4f 4a r on old <b>PROJ
3ed0: 2e 34 3c 2f 62 3e 3a 20 74 68 65 20 3c 62 3e 73 .4</b>: the <b>s
3ee0: 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 3c 2f patial_ref_sys</
3ef0: 62 3e 20 6d 65 74 61 64 61 74 61 20 54 61 62 6c b> metadata Tabl
3f00: 65 20 77 69 6c 6c 20 62 65 20 70 6f 70 75 6c 61 e will be popula
3f10: 74 65 64 20 62 79 20 75 73 69 6e 67 20 74 68 65 ted by using the
3f20: 20 43 52 53 65 73 20 64 65 66 69 6e 69 74 69 6f CRSes definitio
3f30: 6e 73 20 69 6e 74 65 72 6e 61 6c 6c 79 20 69 6e ns internally in
3f40: 6c 69 6e 65 64 20 77 69 74 68 69 6e 20 74 68 65 lined within the
3f50: 20 63 6f 64 65 20 6f 66 20 3c 62 3e 6c 69 62 73 code of <b>libs
3f60: 70 61 74 69 61 6c 69 74 65 3c 2f 62 3e 2e 3c 2f patialite</b>.</
3f70: 6c 69 3e 0d 0a 3c 6c 69 3e 6e 65 77 20 62 65 68 li>..<li>new beh
3f80: 61 76 69 6f 72 20 6f 6e 20 3c 62 3e 50 52 4f 4a avior on <b>PROJ
3f90: 2e 36 3c 2f 62 3e 3a 20 74 68 65 20 3c 62 3e 73 .6</b>: the <b>s
3fa0: 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 3c 2f patial_ref_sys</
3fb0: 62 3e 20 6d 65 74 61 64 61 74 61 20 54 61 62 6c b> metadata Tabl
3fc0: 65 20 77 69 6c 6c 20 62 65 20 70 6f 70 75 6c 61 e will be popula
3fd0: 74 65 64 20 62 79 20 69 6e 73 65 72 74 69 6e 67 ted by inserting
3fe0: 20 74 68 65 20 43 52 53 65 73 20 64 65 66 69 6e the CRSes defin
3ff0: 69 74 69 6f 6e 73 20 65 78 74 72 61 63 74 65 64 itions extracted
4000: 20 66 72 6f 6d 20 74 68 65 20 53 51 4c 69 74 65 from the SQLite
4010: 20 70 72 69 76 61 74 65 20 64 61 74 61 62 61 73 private databas
4020: 65 20 63 75 72 72 65 6e 74 6c 79 20 63 6f 6e 6e e currently conn
4030: 65 63 74 65 64 20 74 6f 20 50 52 4f 4a 2e 36 3b ected to PROJ.6;
4040: 20 6d 6f 72 65 20 70 72 65 63 69 73 65 6c 79 2c more precisely,
4050: 20 63 6f 6c 75 6d 6e 20 3c 62 3e 70 72 6f 6a 34 column <b>proj4
4060: 74 65 78 74 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 text</b> will be
4070: 20 70 6f 70 75 6c 61 74 65 64 20 62 79 20 69 6e populated by in
4080: 73 65 72 74 69 6e 67 20 74 68 65 20 6e 65 77 20 serting the new
4090: 3c 62 3e 70 72 6f 6a 2d 73 74 72 69 6e 67 73 3c <b>proj-strings<
40a0: 2f 62 3e 20 61 73 20 73 75 70 70 6f 72 74 65 64 /b> as supported
40b0: 20 62 79 20 50 52 4f 4a 2e 36 2c 20 77 68 69 6c by PROJ.6, whil
40c0: 73 74 20 63 6f 6c 75 6d 6e 20 3c 62 3e 73 72 74 st column <b>srt
40d0: 65 78 74 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 ext</b> will be
40e0: 70 6f 70 75 6c 61 74 65 64 20 62 79 20 69 6e 73 populated by ins
40f0: 65 72 74 69 6e 67 20 74 68 65 20 3c 62 3e 49 53 erting the <b>IS
4100: 4f 2d 32 30 31 38 20 57 4b 54 3c 2f 62 3e 20 64 O-2018 WKT</b> d
4110: 65 66 69 6e 69 74 69 6f 6e 73 20 61 73 20 73 75 efinitions as su
4120: 70 70 6f 72 74 65 64 20 62 79 20 50 52 4f 4a 2e pported by PROJ.
4130: 36 3c 62 72 3e 0d 0a 3c 75 3e 3c 62 3e 3c 69 3e 6<br>..<u><b><i>
4140: 49 6d 70 6f 72 74 61 6e 74 20 63 6f 6e 73 65 71 Important conseq
4150: 75 65 6e 63 65 3c 2f 69 3e 3c 2f 62 3e 3c 2f 75 uence</i></b></u
4160: 3e 3a 20 69 66 20 74 68 65 72 65 20 69 73 20 6e >: if there is n
4170: 6f 20 64 61 74 61 62 61 73 65 20 63 75 72 72 65 o database curre
4180: 6e 74 6c 79 20 63 6f 6e 6e 65 63 74 65 64 20 74 ntly connected t
4190: 6f 20 50 52 4f 4a 2e 36 20 74 68 65 20 69 6e 69 o PROJ.6 the ini
41a0: 74 69 61 6c 69 7a 61 74 69 6f 6e 20 6f 66 20 3c tialization of <
41b0: 62 3e 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 b>spatial_ref_sy
41c0: 73 3c 2f 62 3e 20 77 69 6c 6c 20 66 61 69 6c 2e s</b> will fail.
41d0: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 2f </li>..</ul>..</
41e0: 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c td></tr>..</tabl
41f0: 65 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 68 33 3e e><br><br>..<h3>
4200: 4e 65 77 20 61 75 78 69 6c 69 61 72 79 20 53 51 New auxiliary SQ
4210: 4c 20 66 75 6e 63 74 69 6f 6e 73 20 73 70 65 63 L functions spec
4220: 69 66 69 63 61 6c 6c 79 20 73 75 70 70 6f 72 74 ifically support
4230: 69 6e 67 20 50 52 4f 4a 2e 36 3c 2f 68 33 3e 0d ing PROJ.6</h3>.
4240: 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 .<table cellspac
4250: 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 ing="8" cellpadd
4260: 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 3d ing="8" bgcolor=
4270: 22 23 65 38 66 66 65 38 22 20 62 6f 72 64 65 72 "#e8ffe8" border
4280: 3d 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 ="1">..<tr><th b
4290: 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 gcolor="#ffb03e"
42a0: 3e 53 51 4c 20 46 75 6e 63 74 69 6f 6e 3c 2f 74 >SQL Function</t
42b0: 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 h><th bgcolor="#
42c0: 66 66 62 30 33 65 22 3e 53 75 70 70 6f 72 74 65 ffb03e">Supporte
42d0: 64 20 61 72 67 75 6d 65 6e 74 73 3c 2f 74 68 3e d arguments</th>
42e0: 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 <th bgcolor="#ff
42f0: 62 30 33 65 22 3e 44 65 73 63 72 69 70 74 69 6f b03e">Descriptio
4300: 6e 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 n</th></tr>..<tr
4310: 3e 3c 74 64 3e 3c 62 3e 48 61 73 50 72 6f 6a 36 ><td><b>HasProj6
4320: 3c 2f 62 3e 28 20 3c 69 3e 76 6f 69 64 3c 2f 69 </b>( <i>void</i
4330: 3e 20 29 20 3a 20 3c 69 3e 42 6f 6f 6c 65 61 6e > ) : <i>Boolean
4340: 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4e </i></td>..<td>N
4350: 6f 6e 65 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 one</td>..<td>Wi
4360: 6c 6c 20 72 65 74 75 72 6e 20 3c 62 3e 31 3c 2f ll return <b>1</
4370: 62 3e 20 28 3c 62 3e 54 52 55 45 3c 2f 62 3e 29 b> (<b>TRUE</b>)
4380: 20 69 66 20 74 68 65 20 6c 69 62 72 61 72 79 20 if the library
4390: 68 61 73 20 62 65 65 6e 20 62 75 69 6c 74 20 6f has been built o
43a0: 6e 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 20 n <b>PROJ.6</b>
43b0: 28 6f 72 20 61 6e 79 20 6c 61 74 65 72 20 76 65 (or any later ve
43c0: 72 73 69 6f 6e 29 2c 20 6f 74 68 65 72 77 69 73 rsion), otherwis
43d0: 65 20 3c 62 3e 30 3c 2f 62 3e 20 28 3c 62 3e 46 e <b>0</b> (<b>F
43e0: 41 4c 53 45 3c 2f 62 3e 29 2e 3c 2f 74 64 3e 3c ALSE</b>).</td><
43f0: 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 /tr>..<tr><td><b
4400: 3e 50 52 4f 4a 5f 47 65 74 4c 61 73 74 45 72 72 >PROJ_GetLastErr
4410: 6f 72 4d 73 67 3c 2f 62 3e 28 20 3c 69 3e 76 6f orMsg</b>( <i>vo
4420: 69 64 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 53 74 id</i> ) : <i>St
4430: 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c ring</i></td>..<
4440: 74 64 3e 4e 6f 6e 65 3c 2f 74 64 3e 0d 0a 3c 74 td>None</td>..<t
4450: 64 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 d>Will return th
4460: 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 65 72 e most recent er
4470: 72 6f 72 20 6d 65 73 73 61 67 65 20 72 65 74 75 ror message retu
4480: 72 6e 65 64 20 62 79 20 50 52 4f 4a 20 28 69 66 rned by PROJ (if
4490: 20 61 6e 79 29 2e 3c 62 72 3e 0d 0a 3c 62 3e 4e any).<br>..<b>N
44a0: 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 ULL</b> will be
44b0: 72 65 74 75 72 6e 65 64 20 69 66 20 74 68 65 72 returned if ther
44c0: 65 20 69 73 20 6e 6f 20 63 75 72 65 6e 74 6c 79 e is no curently
44d0: 20 70 65 6e 64 69 6e 67 20 50 52 4f 4a 20 65 72 pending PROJ er
44e0: 72 6f 72 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a ror.</td></tr>..
44f0: 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f <tr><td><b>PROJ_
4500: 47 65 74 44 61 74 61 62 61 73 65 50 61 74 68 3c GetDatabasePath<
4510: 2f 62 3e 28 20 3c 69 3e 76 6f 69 64 3c 2f 69 3e /b>( <i>void</i>
4520: 20 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e : <i>String</i>
4530: 29 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4e 6f 6e 65 )</td>..<td>None
4540: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 </td>..<td>Will
4550: 72 65 74 75 72 6e 20 74 68 65 20 63 75 72 72 65 return the curre
4560: 6e 74 6c 79 20 73 65 74 20 70 61 74 68 6e 61 6d ntly set pathnam
4570: 65 20 6c 65 61 64 69 6e 67 20 74 6f 20 74 68 65 e leading to the
4580: 20 70 72 69 76 61 74 65 20 50 52 4f 4a 27 73 20 private PROJ's
4590: 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 2e SQLite database.
45a0: 3c 62 72 3e 0d 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 <br>..<b>NULL</b
45b0: 3e 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e > will be return
45c0: 65 64 20 69 66 20 74 68 65 72 65 20 69 73 20 6e ed if there is n
45d0: 6f 20 70 72 69 76 61 74 65 20 50 52 4f 4a 27 73 o private PROJ's
45e0: 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 SQLite database
45f0: 20 63 75 72 72 65 6e 74 6c 79 20 63 6f 6e 6e 65 currently conne
4600: 63 74 65 64 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d cted.</td></tr>.
4610: 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a .<tr><td><b>PROJ
4620: 5f 53 65 74 44 61 74 61 62 61 73 65 50 61 74 68 _SetDatabasePath
4630: 3c 2f 62 3e 20 28 20 6e 65 77 5f 70 61 74 68 20 </b> ( new_path
4640: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 <i>String</i> )
4650: 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c : <i>String</i><
4660: 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a 3c 75 6c 3e /td>..<td>..<ul>
4670: 0d 0a 3c 6c 69 3e 3c 62 3e 6e 65 77 5f 70 61 74 ..<li><b>new_pat
4680: 68 3c 2f 62 3e 3a 20 61 20 72 65 6c 61 74 69 76 h</b>: a relativ
4690: 65 20 6f 72 20 61 62 73 6f 6c 75 74 65 20 70 61 e or absolute pa
46a0: 74 68 6e 61 6d 65 20 6c 65 61 64 69 6e 67 20 74 thname leading t
46b0: 6f 20 61 20 76 61 6c 69 64 20 50 52 4f 4a 27 73 o a valid PROJ's
46c0: 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 SQLite database
46d0: 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 74 .</li>..</ul></t
46e0: 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 63 68 61 d>..<td>Will cha
46f0: 6e 67 65 20 74 68 65 20 63 75 72 72 65 6e 74 6c nge the currentl
4700: 79 20 73 65 74 20 70 61 74 68 6e 61 6d 65 20 6c y set pathname l
4710: 65 61 64 69 6e 67 20 74 6f 20 74 68 65 20 70 72 eading to the pr
4720: 69 76 61 74 65 20 50 52 4f 4a 27 73 20 53 51 4c ivate PROJ's SQL
4730: 69 74 65 20 64 61 74 61 62 61 73 65 2e 3c 62 72 ite database.<br
4740: 3e 0d 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 >..<b>NULL</b> w
4750: 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 ill be returned
4760: 69 66 20 74 68 65 20 70 61 73 73 65 64 20 70 61 if the passed pa
4770: 74 68 20 69 73 20 69 6e 76 61 6c 69 64 2c 20 6f th is invalid, o
4780: 74 68 65 72 77 69 73 65 20 74 68 65 20 70 61 74 therwise the pat
4790: 68 20 6f 66 20 74 68 65 20 63 75 72 72 65 6e 74 h of the current
47a0: 6c 79 20 73 65 74 20 70 72 69 76 61 74 65 20 50 ly set private P
47b0: 52 4f 4a 27 73 20 53 51 4c 69 74 65 20 64 61 74 ROJ's SQLite dat
47c0: 61 62 61 73 65 20 77 69 6c 6c 20 62 65 20 72 65 abase will be re
47d0: 74 75 72 6e 65 64 2e 3c 2f 74 64 3e 3c 2f 74 72 turned.</td></tr
47e0: 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 >..<tr><td><b>PR
47f0: 4f 4a 5f 41 73 57 4b 54 3c 2f 62 3e 20 28 20 61 OJ_AsWKT</b> ( a
4800: 75 74 68 5f 6e 61 6d 65 20 3c 69 3e 53 74 72 69 uth_name <i>Stri
4810: 6e 67 3c 2f 69 3e 20 2c 20 61 75 74 68 5f 73 72 ng</i> , auth_sr
4820: 69 64 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 id <i>Integer</i
4830: 3e 20 29 20 3a 20 3c 69 3e 53 74 72 69 6e 67 3c > ) : <i>String<
4840: 2f 69 3e 3c 68 72 3e 0d 0a 3c 62 3e 50 52 4f 4a /i><hr>..<b>PROJ
4850: 5f 41 73 57 4b 54 3c 2f 62 3e 20 28 20 61 75 74 _AsWKT</b> ( aut
4860: 68 5f 6e 61 6d 65 20 3c 69 3e 53 74 72 69 6e 67 h_name <i>String
4870: 3c 2f 69 3e 20 2c 20 61 75 74 68 5f 73 72 69 64 </i> , auth_srid
4880: 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 <i>Integer</i>
4890: 2c 20 77 6b 74 5f 73 74 79 6c 65 20 3c 69 3e 53 , wkt_style <i>S
48a0: 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 tring</i> ) : <i
48b0: 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 68 72 3e 0d >String</i><hr>.
48c0: 0a 3c 62 3e 50 52 4f 4a 5f 41 73 57 4b 54 3c 2f .<b>PROJ_AsWKT</
48d0: 62 3e 20 28 20 61 75 74 68 5f 6e 61 6d 65 20 3c b> ( auth_name <
48e0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 61 i>String</i> , a
48f0: 75 74 68 5f 73 72 69 64 20 3c 69 3e 49 6e 74 65 uth_srid <i>Inte
4900: 67 65 72 3c 2f 69 3e 20 2c 20 77 6b 74 5f 73 74 ger</i> , wkt_st
4910: 79 6c 65 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 yle <i>String</i
4920: 3e 20 2c 20 69 6e 64 65 6e 74 65 64 20 3c 69 3e > , indented <i>
4930: 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 20 29 20 3a 20 Boolean</i> ) :
4940: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 68 72 <i>String</i><hr
4950: 3e 0d 0a 3c 62 3e 50 52 4f 4a 5f 41 73 57 4b 54 >..<b>PROJ_AsWKT
4960: 3c 2f 62 3e 20 28 20 61 75 74 68 5f 6e 61 6d 65 </b> ( auth_name
4970: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c <i>String</i> ,
4980: 20 61 75 74 68 5f 73 72 69 64 20 3c 69 3e 49 6e auth_srid <i>In
4990: 74 65 67 65 72 3c 2f 69 3e 20 2c 20 77 6b 74 5f teger</i> , wkt_
49a0: 73 74 79 6c 65 20 3c 69 3e 53 74 72 69 6e 67 3c style <i>String<
49b0: 2f 69 3e 20 2c 20 69 6e 64 65 6e 74 65 64 20 3c /i> , indented <
49c0: 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 20 2c 20 i>Boolean</i> ,
49d0: 69 6e 64 65 6e 74 61 74 69 6f 6e 20 3c 69 3e 49 indentation <i>I
49e0: 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c nteger</i> ) : <
49f0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 i>String</i></td
4a00: 3e 0d 0a 3c 74 64 3e 3c 75 6c 3e 0d 0a 3c 6c 69 >..<td><ul>..<li
4a10: 3e 3c 62 3e 61 75 74 68 5f 6e 61 6d 65 3c 2f 62 ><b>auth_name</b
4a20: 3e 20 61 6e 64 20 3c 62 3e 61 75 74 68 5f 73 72 > and <b>auth_sr
4a30: 69 64 3c 2f 62 3e 20 69 64 65 6e 74 69 66 79 20 id</b> identify
4a40: 74 68 65 20 69 6e 74 65 6e 64 65 64 20 43 52 53 the intended CRS
4a50: 2e 3c 62 72 3e 0d 0a 3c 62 3e 61 75 74 68 5f 6e .<br>..<b>auth_n
4a60: 61 6d 65 3c 2f 62 3e 20 63 61 6e 20 62 65 20 3c ame</b> can be <
4a70: 62 3e 4e 55 4c 4c 3c 2f 62 3e 2c 20 61 6e 64 20 b>NULL</b>, and
4a80: 69 6e 20 74 68 69 73 20 63 61 73 65 20 3c 62 3e in this case <b>
4a90: 45 50 53 47 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 EPSG</b> will be
4aa0: 20 61 73 73 75 6d 65 64 2e 3c 2f 6c 69 3e 0d 0a assumed.</li>..
4ab0: 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c <li>the optional
4ac0: 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e 73 74 79 argument <b>sty
4ad0: 6c 65 3c 2f 62 3e 20 64 65 74 65 72 6d 69 6e 65 le</b> determine
4ae0: 73 20 77 68 69 63 68 20 73 70 65 63 69 66 69 63 s which specific
4af0: 20 57 4b 54 20 66 6f 72 6d 61 74 20 73 68 6f 75 WKT format shou
4b00: 6c 64 20 62 65 20 61 64 6f 70 74 65 64 2c 20 61 ld be adopted, a
4b10: 6e 64 20 6d 75 73 74 20 62 65 20 6f 6e 65 20 62 nd must be one b
4b20: 65 74 77 65 65 6e 20 3c 62 3e 47 44 41 4c 3c 2f etween <b>GDAL</
4b30: 62 3e 2c 20 3c 62 3e 45 53 52 49 3c 2f 62 3e 2c b>, <b>ESRI</b>,
4b40: 20 3c 62 3e 49 53 4f 2d 32 30 31 35 3c 2f 62 3e <b>ISO-2015</b>
4b50: 20 6f 72 20 3c 62 3e 49 53 4f 2d 32 30 31 38 3c or <b>ISO-2018<
4b60: 2f 62 3e 20 28 74 68 69 73 20 6c 61 74 74 65 72 /b> (this latter
4b70: 20 62 65 69 6e 67 20 74 68 65 20 64 65 66 61 75 being the defau
4b80: 6c 74 20 73 65 74 74 69 6e 67 29 2e 3c 2f 6c 69 lt setting).</li
4b90: 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f >..<li>the optio
4ba0: 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e nal argument <b>
4bb0: 69 6e 64 65 6e 74 65 64 3c 2f 62 3e 20 69 66 20 indented</b> if
4bc0: 73 65 74 20 74 6f 20 3c 62 3e 54 52 55 45 3c 2f set to <b>TRUE</
4bd0: 62 3e 20 77 69 6c 6c 20 6e 69 63 65 6c 79 20 66 b> will nicely f
4be0: 6f 72 6d 61 74 20 61 20 6d 75 6c 74 69 6c 69 6e ormat a multilin
4bf0: 65 20 57 4b 54 20 65 78 70 72 65 73 73 69 6f 6e e WKT expression
4c00: 2c 20 6f 74 68 65 72 77 69 73 65 20 61 20 73 69 , otherwise a si
4c10: 6e 67 6c 65 20 6d 6f 6e 6f 6c 69 74 68 69 63 20 ngle monolithic
4c20: 6c 69 6e 65 20 6c 61 63 6b 69 6e 67 20 61 6e 79 line lacking any
4c30: 20 77 68 69 74 65 2d 73 70 61 63 65 20 6f 72 20 white-space or
4c40: 6e 65 77 2d 6c 69 6e 65 20 77 69 6c 6c 20 62 65 new-line will be
4c50: 20 70 72 69 6e 74 65 64 20 28 74 68 65 20 64 65 printed (the de
4c60: 66 61 75 6c 74 20 69 73 20 3c 62 3e 54 52 55 45 fault is <b>TRUE
4c70: 3c 2f 62 3e 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 </b>).</li>..<li
4c80: 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72 >the optional ar
4c90: 67 75 6d 65 6e 74 20 3c 62 3e 69 6e 64 65 6e 74 gument <b>indent
4ca0: 61 74 69 6f 6e 3c 2f 62 3e 20 64 65 74 65 72 6d ation</b> determ
4cb0: 69 6e 65 73 20 68 6f 77 20 6d 61 6e 79 20 77 68 ines how many wh
4cc0: 69 74 65 2d 73 70 61 63 65 73 20 61 72 65 20 74 ite-spaces are t
4cd0: 6f 20 62 65 20 75 73 65 64 20 66 6f 72 20 69 6e o be used for in
4ce0: 64 65 6e 74 69 6e 67 20 28 6f 6e 6c 79 20 6d 65 denting (only me
4cf0: 61 6e 69 6e 67 66 75 6c 20 69 66 20 3c 62 3e 3c aningful if <b><
4d00: 69 3e 69 6e 64 65 6e 74 65 64 3d 54 52 55 45 3c i>indented=TRUE<
4d10: 2f 69 3e 3c 2f 62 3e 3b 20 74 68 65 20 64 65 66 /i></b>; the def
4d20: 61 75 6c 74 20 76 61 6c 75 65 73 20 69 73 20 3c ault values is <
4d30: 62 3e 34 3c 2f 62 3e 29 2e 3c 2f 6c 69 3e 0d 0a b>4</b>).</li>..
4d40: 3c 2f 75 6c 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e </ul></td>..<td>
4d50: 57 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 65 20 Will return the
4d60: 57 4b 54 20 65 78 70 72 65 73 73 69 6f 6e 20 63 WKT expression c
4d70: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 orresponding to
4d80: 61 20 67 69 76 65 6e 20 43 52 53 3b 20 74 68 65 a given CRS; the
4d90: 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 77 69 6c definitions wil
4da0: 6c 20 62 65 20 74 61 6b 65 6e 20 64 69 72 65 63 l be taken direc
4db0: 74 6c 79 20 66 72 6f 6d 20 74 68 65 20 70 72 69 tly from the pri
4dc0: 76 61 74 65 20 50 52 4f 4a 27 73 20 6f 77 6e 20 vate PROJ's own
4dd0: 64 61 74 61 62 61 73 65 2e 3c 62 72 3e 0d 0a 3c database.<br>..<
4de0: 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 b>NULL</b> will
4df0: 62 65 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 66 be returned on f
4e00: 61 69 6c 75 72 65 20 6f 72 20 6f 6e 20 69 6e 76 ailure or on inv
4e10: 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 73 2e 3c alid arguments.<
4e20: 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c /td></tr>..<tr><
4e30: 74 64 3e 3c 62 3e 50 52 4f 4a 5f 47 75 65 73 73 td><b>PROJ_Guess
4e40: 53 72 69 64 46 72 6f 6d 57 4b 54 3c 2f 62 3e 20 SridFromWKT</b>
4e50: 28 20 77 6b 74 5f 65 78 70 72 20 3c 69 3e 53 74 ( wkt_expr <i>St
4e60: 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e ring</i> ) : <i>
4e70: 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 64 3e Integer</i></td>
4e80: 0d 0a 3c 74 64 3e 3c 75 6c 3e 0d 0a 3c 6c 69 3e ..<td><ul>..<li>
4e90: 3c 62 3e 77 6b 74 5f 65 78 70 72 3c 2f 62 3e 3a <b>wkt_expr</b>:
4ea0: 20 74 68 65 20 57 4b 54 20 65 78 70 72 65 73 73 the WKT express
4eb0: 69 6f 6e 20 74 6f 20 62 65 20 65 76 61 6c 75 61 ion to be evalua
4ec0: 74 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e ted.</li>..</ul>
4ed0: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a 57 69 6c </td>..<td>..Wil
4ee0: 6c 20 70 6f 73 73 69 62 6c 79 20 72 65 74 75 72 l possibly retur
4ef0: 6e 20 74 68 65 20 3c 62 3e 53 52 49 44 20 76 61 n the <b>SRID va
4f00: 6c 75 65 3c 2f 62 3e 20 63 6f 72 72 65 73 70 6f lue</b> correspo
4f10: 6e 64 69 6e 67 20 74 6f 20 61 20 67 69 76 65 6e nding to a given
4f20: 20 57 4b 54 20 65 78 70 72 65 73 73 69 6f 6e 20 WKT expression
4f30: 64 65 66 69 6e 69 6e 67 20 61 20 43 52 53 2e 3c defining a CRS.<
4f40: 62 72 3e 0d 0a 3c 62 3e 2d 31 3c 2f 62 3e 20 77 br>..<b>-1</b> w
4f50: 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 ill be returned
4f60: 69 66 20 6e 6f 20 43 52 53 20 73 75 70 70 6f 72 if no CRS suppor
4f70: 74 65 64 20 62 79 20 50 52 4f 4a 2e 36 20 6d 61 ted by PROJ.6 ma
4f80: 74 63 68 65 73 20 74 68 65 20 57 4b 54 20 65 78 tches the WKT ex
4f90: 70 72 65 73 73 69 6f 6e 2e 3c 62 72 3e 0d 0a 3c pression.<br>..<
4fa0: 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 b>NULL</b> will
4fb0: 62 65 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 69 be returned on i
4fc0: 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 2e nvalid argument.
4fd0: 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 ..</td></tr>..<t
4fe0: 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f 47 75 r><td><b>PROJ_Gu
4ff0: 65 73 73 53 72 69 64 46 72 6f 6d 53 48 50 3c 2f essSridFromSHP</
5000: 62 3e 20 28 20 66 69 6c 65 6e 61 6d 65 20 3c 69 b> ( filename <i
5010: 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 >String</i> ) :
5020: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f <i>Integer</i></
5030: 74 64 3e 0d 0a 3c 74 64 3e 3c 75 6c 3e 0d 0a 3c td>..<td><ul>..<
5040: 6c 69 3e 3c 62 3e 66 69 6c 65 6e 61 6d 65 3c 2f li><b>filename</
5050: 62 3e 3a 20 74 68 65 20 61 62 73 6f 6c 75 74 65 b>: the absolute
5060: 20 6f 72 20 72 65 6c 61 74 69 76 65 20 70 61 74 or relative pat
5070: 68 20 6c 65 61 64 69 6e 67 20 74 6f 20 73 6f 6d h leading to som
5080: 65 20 53 68 61 70 65 66 69 6c 65 2e 3c 62 72 3e e Shapefile.<br>
5090: 0d 0a 4e 6f 74 65 3a 20 65 78 61 63 74 6c 65 79 ..Note: exactley
50a0: 20 61 73 20 72 65 71 75 69 72 65 64 20 62 79 20 as required by
50b0: 3c 62 3e 3c 69 3e 49 6d 70 6f 72 74 53 48 50 3c <b><i>ImportSHP<
50c0: 2f 69 3e 3c 2f 62 3e 28 29 20 3c 62 3e 3c 69 3e /i></b>() <b><i>
50d0: 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 3c 2f 62 3e filename</i></b>
50e0: 20 6d 75 73 74 20 6f 6d 69 74 20 61 6e 79 20 3c must omit any <
50f0: 62 3e 2e 73 68 70 3c 2f 62 3e 2c 20 3c 62 3e 2e b>.shp</b>, <b>.
5100: 73 68 78 3c 2f 62 3e 2c 20 3c 62 3e 2e 64 62 66 shx</b>, <b>.dbf
5110: 3c 2f 62 3e 20 6f 72 20 3c 62 3e 2e 70 72 6a 3c </b> or <b>.prj<
5120: 2f 62 3e 20 73 75 66 66 69 78 2e 3c 2f 6c 69 3e /b> suffix.</li>
5130: 0d 0a 3c 2f 75 6c 3e 3c 2f 74 64 3e 0d 0a 3c 74 ..</ul></td>..<t
5140: 64 3e 0d 0a 57 69 6c 6c 20 70 6f 73 73 69 62 6c d>..Will possibl
5150: 79 20 72 65 74 75 72 6e 20 74 68 65 20 3c 62 3e y return the <b>
5160: 53 52 49 44 20 76 61 6c 75 65 3c 2f 62 3e 20 63 SRID value</b> c
5170: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 orresponding to
5180: 74 68 65 20 43 52 53 20 64 65 66 69 6e 65 64 20 the CRS defined
5190: 62 79 20 74 68 65 20 2e 50 52 4a 20 6d 65 6d 62 by the .PRJ memb
51a0: 65 72 20 6f 66 20 74 68 65 20 53 68 61 70 65 66 er of the Shapef
51b0: 69 6c 65 2e 3c 62 72 3e 0d 0a 3c 62 3e 2d 31 3c ile.<br>..<b>-1<
51c0: 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72 65 74 75 /b> will be retu
51d0: 72 6e 65 64 20 69 66 20 6e 6f 20 43 52 53 20 73 rned if no CRS s
51e0: 75 70 70 6f 72 74 65 64 20 62 79 20 50 52 4f 4a upported by PROJ
51f0: 2e 36 20 6d 61 74 63 68 65 73 20 50 52 4a 20 6d .6 matches PRJ m
5200: 65 6d 62 65 72 20 6f 66 20 74 68 65 20 53 68 61 ember of the Sha
5210: 70 65 66 69 6c 65 2e 3c 62 72 3e 0d 0a 3c 62 3e pefile.<br>..<b>
5220: 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 NULL</b> will be
5230: 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 69 6e 76 returned on inv
5240: 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 2e 3c 68 alid argument.<h
5250: 72 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f r>..<u>Please no
5260: 74 65 20 77 65 6c 6c 3c 2f 75 3e 3a 20 74 68 69 te well</u>: thi
5270: 73 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 6f s SQL function o
5280: 70 65 6e 64 20 74 68 65 20 64 6f 6f 72 20 74 6f pend the door to
5290: 20 6d 61 6e 79 20 70 6f 74 65 6e 74 69 61 6c 20 many potential
52a0: 73 65 63 75 72 69 74 79 20 69 73 73 75 65 73 2c security issues,
52b0: 20 61 6e 64 20 74 68 75 73 20 69 73 20 61 6c 77 and thus is alw
52c0: 61 79 73 20 3c 69 3e 64 69 73 61 62 6c 65 64 20 ays <i>disabled
52d0: 62 79 20 64 65 66 61 75 6c 74 3c 2f 69 3e 2e 3c by default</i>.<
52e0: 62 72 3e 0d 0a 45 78 70 6c 69 63 69 74 6c 79 20 br>..Explicitly
52f0: 73 65 74 74 69 6e 67 20 74 68 65 20 65 6e 76 69 setting the envi
5300: 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 ronment variable
5310: 20 3c 62 3e 53 50 41 54 49 41 4c 49 54 45 5f 53 <b>SPATIALITE_S
5320: 45 43 55 52 49 54 59 3d 72 65 6c 61 78 65 64 3c ECURITY=relaxed<
5330: 2f 62 3e 20 69 73 20 61 62 73 6f 6c 75 74 65 6c /b> is absolutel
5340: 79 20 72 65 71 75 69 72 65 64 20 69 6e 20 6f 72 y required in or
5350: 64 65 72 20 74 6f 20 65 6e 61 62 6c 65 20 74 68 der to enable th
5360: 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0d 0a 3c 2f is function...</
5370: 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c td></tr>..</tabl
5380: 65 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 e><br>..<table c
5390: 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 ellspacing="8" c
53a0: 65 6c 6c 70 61 64 64 69 6e 67 3d 22 31 36 22 20 ellpadding="16"
53b0: 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 39 bgcolor="#ffffe9
53c0: 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 62 ">..<tr><td>..<b
53d0: 3e 3c 75 3e 4e 6f 74 65 3c 2f 75 3e 3c 2f 62 3e ><u>Note</u></b>
53e0: 3a 20 61 6c 6c 20 74 68 65 20 61 62 6f 76 65 20 : all the above
53f0: 53 51 4c 20 46 75 6e 63 74 69 6f 6e 73 20 77 69 SQL Functions wi
5400: 6c 6c 20 62 65 20 61 76 61 69 6c 61 62 6c 65 20 ll be available
5410: 6f 6e 6c 79 20 77 68 65 6e 20 53 70 61 74 69 61 only when Spatia
5420: 6c 69 74 65 2d 35 2e 30 2e 30 20 68 61 73 20 62 lite-5.0.0 has b
5430: 65 65 6e 20 62 75 69 6c 74 20 61 67 61 69 6e 73 een built agains
5440: 74 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 20 t <b>PROJ.6</b>
5450: 28 6f 72 20 61 6e 79 20 73 75 62 73 65 71 75 65 (or any subseque
5460: 6e 74 20 76 65 72 73 69 6f 6e 29 2e 3c 62 72 3e nt version).<br>
5470: 0d 0a 49 66 20 53 70 61 74 69 61 4c 69 74 65 2d ..If SpatiaLite-
5480: 35 2e 30 2e 30 20 68 61 73 20 62 65 65 6e 20 62 5.0.0 has been b
5490: 75 69 6c 74 20 69 6e 73 74 65 61 64 20 61 67 61 uilt instead aga
54a0: 69 6e 73 74 20 61 6e 79 20 70 72 65 76 69 6f 73 inst any previos
54b0: 75 73 20 76 65 72 73 69 6f 6e 20 28 61 73 20 65 us version (as e
54c0: 2e 67 2e 20 3c 62 3e 50 52 4f 4a 2e 34 3c 2f 62 .g. <b>PROJ.4</b
54d0: 3e 29 20 61 6e 79 20 61 74 74 65 6d 70 74 20 74 >) any attempt t
54e0: 6f 20 63 61 6c 6c 20 6f 6e 65 20 6f 66 20 74 68 o call one of th
54f0: 65 73 65 20 53 51 4c 20 46 75 6e 63 74 69 6f 6e ese SQL Function
5500: 73 20 77 69 6c 6c 20 73 69 6d 70 6c 79 20 72 65 s will simply re
5510: 74 75 72 6e 20 61 20 3c 62 3e 3c 69 3e 3c 75 3e turn a <b><i><u>
5520: 6e 6f 20 73 75 63 68 20 66 75 6e 63 74 69 6f 6e no such function
5530: 3c 2f 75 3e 3c 2f 69 3e 3c 2f 62 3e 20 53 51 4c </u></i></b> SQL
5540: 20 65 72 72 6f 72 2e 0d 0a 3c 2f 74 64 3e 3c 2f error...</td></
5550: 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 tr>..</table><br
5560: 3e 0d 0a 3c 62 3e 50 72 61 63 74 69 63 61 6c 20 >..<b>Practical
5570: 65 78 61 6d 70 6c 65 73 3a 3c 2f 62 3e 0d 0a 3c examples:</b>..<
5580: 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 verbatim>..SELEC
5590: 54 20 50 52 4f 4a 5f 47 65 74 44 61 74 61 62 61 T PROJ_GetDataba
55a0: 73 65 50 61 74 68 28 29 3b 20 20 2d 2d 20 72 65 sePath(); -- re
55b0: 74 72 69 65 76 69 6e 67 20 74 68 65 20 63 75 72 trieving the cur
55c0: 72 65 6e 74 6c 79 20 73 65 74 20 50 52 4f 4a 27 rently set PROJ'
55d0: 73 20 6f 77 6e 20 64 61 74 61 62 61 73 65 0d 0a s own database..
55e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
55f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a --------------..
5600: 2f 75 73 72 2f 6c 6f 63 61 6c 2f 73 68 61 72 65 /usr/local/share
5610: 2f 70 72 6f 6a 2f 70 72 6f 6a 2e 64 62 0d 0a 0d /proj/proj.db...
5620: 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f 53 65 74 .SELECT PROJ_Set
5630: 44 61 74 61 62 61 73 65 50 61 74 68 28 27 2f 68 DatabasePath('/h
5640: 6f 6d 65 2f 73 61 6e 64 72 6f 2f 6e 6f 74 5f 65 ome/sandro/not_e
5650: 78 69 73 74 69 6e 67 5f 70 72 6f 6a 2e 64 62 27 xisting_proj.db'
5660: 29 3b 20 2d 2d 20 6e 6f 6e 20 65 78 69 73 74 69 ); -- non existi
5670: 6e 67 20 64 61 74 61 62 61 73 65 0d 0a 2d 2d 2d ng database..---
5680: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5690: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 4e 55 4c -----------..NUL
56a0: 4c 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a L....SELECT PROJ
56b0: 5f 47 65 74 4c 61 73 74 45 72 72 6f 72 4d 73 67 _GetLastErrorMsg
56c0: 28 29 3b 20 2d 2d 20 72 65 74 72 69 65 76 69 6e (); -- retrievin
56d0: 67 20 74 68 65 20 66 61 69 6c 75 72 65 20 63 61 g the failure ca
56e0: 75 73 65 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d use..-----------
56f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5700: 2d 2d 2d 0d 0a 70 72 6f 6a 5f 63 6f 6e 74 65 78 ---..proj_contex
5710: 74 5f 73 65 74 5f 64 61 74 61 62 61 73 65 5f 70 t_set_database_p
5720: 61 74 68 3a 20 4f 70 65 6e 20 6f 66 20 2f 68 6f ath: Open of /ho
5730: 6d 65 2f 73 61 6e 64 72 6f 2f 6e 6f 74 5f 65 78 me/sandro/not_ex
5740: 69 73 74 69 6e 67 5f 70 72 6f 6a 2e 64 62 20 66 isting_proj.db f
5750: 61 69 6c 65 64 0d 0a 0d 0a 53 45 4c 45 43 54 20 ailed....SELECT
5760: 50 52 4f 4a 5f 53 65 74 44 61 74 61 62 61 73 65 PROJ_SetDatabase
5770: 50 61 74 68 28 27 2f 68 6f 6d 65 2f 73 61 6e 64 Path('/home/sand
5780: 72 6f 2f 76 61 6c 69 64 5f 70 72 6f 6a 2e 64 62 ro/valid_proj.db
5790: 27 29 3b 20 2d 2d 20 76 61 6c 69 64 20 64 61 74 '); -- valid dat
57a0: 61 62 61 73 65 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d abase..---------
57b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
57c0: 2d 2d 2d 2d 2d 0d 0a 2f 68 6f 6d 65 2f 73 61 6e -----../home/san
57d0: 64 72 6f 2f 76 61 6c 69 64 5f 70 72 6f 6a 2e 64 dro/valid_proj.d
57e0: 62 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a b....SELECT PROJ
57f0: 5f 41 73 57 4b 54 28 27 45 50 53 47 27 2c 20 34 _AsWKT('EPSG', 4
5800: 33 32 36 29 3b 20 2d 2d 20 64 65 66 61 75 6c 74 326); -- default
5810: 20 73 65 74 74 69 6e 67 73 3a 20 49 53 4f 2d 32 settings: ISO-2
5820: 30 31 38 20 73 74 79 6c 65 2c 20 69 6e 64 65 6e 018 style, inden
5830: 74 65 64 20 77 69 74 68 20 69 6e 64 65 6e 74 61 ted with indenta
5840: 74 69 6f 6e 20 34 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d tion 4..--------
5850: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5860: 2d 2d 2d 2d 2d 2d 0d 0a 47 45 4f 44 43 52 53 5b ------..GEODCRS[
5870: 22 57 47 53 20 38 34 22 2c 0d 0a 20 20 20 20 44 "WGS 84",.. D
5880: 41 54 55 4d 5b 22 57 6f 72 6c 64 20 47 65 6f 64 ATUM["World Geod
5890: 65 74 69 63 20 53 79 73 74 65 6d 20 31 39 38 34 etic System 1984
58a0: 22 2c 0d 0a 20 20 20 20 20 20 20 20 45 4c 4c 49 ",.. ELLI
58b0: 50 53 4f 49 44 5b 22 57 47 53 20 38 34 22 2c 36 PSOID["WGS 84",6
58c0: 33 37 38 31 33 37 2c 32 39 38 2e 32 35 37 32 32 378137,298.25722
58d0: 33 35 36 33 2c 0d 0a 20 20 20 20 20 20 20 20 20 3563,..
58e0: 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d LENGTHUNIT["m
58f0: 65 74 72 65 22 2c 31 5d 5d 5d 2c 0d 0a 20 20 20 etre",1]]],..
5900: 20 50 52 49 4d 45 4d 5b 22 47 72 65 65 6e 77 69 PRIMEM["Greenwi
5910: 63 68 22 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 ch",0,..
5920: 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 ANGLEUNIT["degre
5930: 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 e",0.01745329251
5940: 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20 43 53 99433]],.. CS
5950: 5b 65 6c 6c 69 70 73 6f 69 64 61 6c 2c 32 5d 2c [ellipsoidal,2],
5960: 0d 0a 20 20 20 20 20 20 20 20 41 58 49 53 5b 22 .. AXIS["
5970: 67 65 6f 64 65 74 69 63 20 6c 61 74 69 74 75 64 geodetic latitud
5980: 65 20 28 4c 61 74 29 22 2c 6e 6f 72 74 68 2c 0d e (Lat)",north,.
5990: 0a 20 20 20 20 20 20 20 20 20 20 20 20 4f 52 44 . ORD
59a0: 45 52 5b 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 ER[1],..
59b0: 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 ANGLEUNIT["d
59c0: 65 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 egree",0.0174532
59d0: 39 32 35 31 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 925199433]],..
59e0: 20 20 20 20 20 20 41 58 49 53 5b 22 67 65 6f 64 AXIS["geod
59f0: 65 74 69 63 20 6c 6f 6e 67 69 74 75 64 65 20 28 etic longitude (
5a00: 4c 6f 6e 29 22 2c 65 61 73 74 2c 0d 0a 20 20 20 Lon)",east,..
5a10: 20 20 20 20 20 20 20 20 20 4f 52 44 45 52 5b 32 ORDER[2
5a20: 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ],..
5a30: 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 ANGLEUNIT["degre
5a40: 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 e",0.01745329251
5a50: 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20 41 52 99433]],.. AR
5a60: 45 41 5b 22 57 6f 72 6c 64 22 5d 2c 0d 0a 20 20 EA["World"],..
5a70: 20 20 42 42 4f 58 5b 2d 39 30 2c 2d 31 38 30 2c BBOX[-90,-180,
5a80: 39 30 2c 31 38 30 5d 2c 0d 0a 20 20 20 20 49 44 90,180],.. ID
5a90: 5b 22 45 50 53 47 22 2c 34 33 32 36 5d 5d 0d 0a ["EPSG",4326]]..
5aa0: 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f 41 73 ..SELECT PROJ_As
5ab0: 57 4b 54 28 27 45 50 53 47 27 2c 20 34 33 32 36 WKT('EPSG', 4326
5ac0: 2c 20 27 45 53 52 49 27 2c 20 30 2c 20 30 29 3b , 'ESRI', 0, 0);
5ad0: 20 2d 2d 20 45 53 52 49 20 73 74 79 6c 65 2c 20 -- ESRI style,
5ae0: 6d 6f 6e 6f 6c 69 74 68 69 63 20 6c 69 6e 65 0d monolithic line.
5af0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
5b00: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d ---------------.
5b10: 0a 47 45 4f 47 43 53 5b 22 47 43 53 5f 57 47 53 .GEOGCS["GCS_WGS
5b20: 5f 31 39 38 34 22 2c 44 41 54 55 4d 5b 22 44 5f _1984",DATUM["D_
5b30: 57 47 53 5f 31 39 38 34 22 2c 53 50 48 45 52 4f WGS_1984",SPHERO
5b40: 49 44 5b 22 57 47 53 5f 31 39 38 34 22 2c 36 33 ID["WGS_1984",63
5b50: 37 38 31 33 37 2e 30 2c 32 39 38 2e 32 35 37 32 78137.0,298.2572
5b60: 32 33 35 36 33 5d 5d 2c 50 52 49 4d 45 4d 5b 22 23563]],PRIMEM["
5b70: 47 72 65 65 6e 77 69 63 68 22 2c 30 2e 30 5d 2c Greenwich",0.0],
5b80: 55 4e 49 54 5b 22 44 65 67 72 65 65 22 2c 30 2e UNIT["Degree",0.
5b90: 30 31 37 34 35 33 32 39 32 35 31 39 39 34 33 33 0174532925199433
5ba0: 5d 5d 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f ]]....SELECT PRO
5bb0: 4a 5f 47 75 65 73 73 53 72 69 64 46 72 6f 6d 57 J_GuessSridFromW
5bc0: 4b 54 28 27 47 45 4f 47 43 53 5b 22 47 43 53 5f KT('GEOGCS["GCS_
5bd0: 4d 6f 6e 74 65 5f 4d 61 72 69 6f 5f 52 6f 6d 65 Monte_Mario_Rome
5be0: 22 2c 44 41 54 55 4d 5b 22 44 5f 4d 6f 6e 74 65 ",DATUM["D_Monte
5bf0: 5f 4d 61 72 69 6f 22 2c 53 50 48 45 52 4f 49 44 _Mario",SPHEROID
5c00: 5b 22 49 6e 74 65 72 6e 61 74 69 6f 6e 61 6c 5f ["International_
5c10: 31 39 32 34 22 2c 36 33 37 38 33 38 38 2e 30 2c 1924",6378388.0,
5c20: 32 39 37 2e 30 5d 5d 2c 50 52 49 4d 45 4d 5b 22 297.0]],PRIMEM["
5c30: 52 6f 6d 65 22 2c 31 32 2e 34 35 32 33 33 33 33 Rome",12.4523333
5c40: 33 33 33 33 33 33 5d 2c 55 4e 49 54 5b 22 44 65 333333],UNIT["De
5c50: 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 gree",0.01745329
5c60: 32 35 31 39 39 34 33 33 5d 5d 27 29 3b 20 0d 0a 25199433]]'); ..
5c70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5c80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a --------------..
5c90: 34 38 30 36 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 4806....SELECT P
5ca0: 52 4f 4a 5f 47 75 65 73 73 53 72 69 64 46 72 6f ROJ_GuessSridFro
5cb0: 6d 53 48 50 28 27 2f 68 6f 6d 65 2f 73 61 6e 64 mSHP('/home/sand
5cc0: 72 6f 2f 74 75 73 63 61 6e 79 5f 73 68 70 2f 70 ro/tuscany_shp/p
5cd0: 72 6f 76 32 30 31 31 27 29 3b 20 2d 2d 20 72 65 rov2011'); -- re
5ce0: 6d 65 6d 62 65 72 3a 20 72 65 71 75 69 72 65 73 member: requires
5cf0: 20 74 6f 20 65 78 70 6c 69 63 69 74 6c 79 20 73 to explicitly s
5d00: 65 74 20 53 50 41 54 49 41 4c 49 54 45 5f 53 45 et SPATIALITE_SE
5d10: 43 55 52 49 54 59 3d 72 65 6c 61 78 65 64 0d 0a CURITY=relaxed..
5d20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5d30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a --------------..
5d40: 33 30 30 33 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3003..</verbatim
5d50: 3e 0d 0a 3c 62 72 3e 0d 0a 3c 68 72 3e 3c 62 72 >..<br>..<hr><br
5d60: 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 >..<table cellsp
5d70: 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 acing="8" cellpa
5d80: 64 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f dding="8" bgcolo
5d90: 72 3d 22 23 66 66 65 30 65 39 22 20 77 69 64 74 r="#ffe0e9" widt
5da0: 68 3d 22 31 30 30 25 22 3e 0d 0a 3c 74 72 3e 3c h="100%">..<tr><
5db0: 74 68 3e 0d 0a 3c 68 31 3e 49 6d 70 6f 72 74 61 th>..<h1>Importa
5dc0: 6e 74 20 6e 6f 74 69 63 65 20 66 6f 72 20 57 69 nt notice for Wi
5dd0: 6e 64 6f 77 73 20 75 73 65 72 73 3c 2f 68 31 3e ndows users</h1>
5de0: 0d 0a 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 ..</th></tr>..<t
5df0: 72 3e 3c 74 64 3e 0d 0a 3c 62 3e 50 52 4f 4a 2e r><td>..<b>PROJ.
5e00: 36 3c 2f 62 3e 20 63 72 69 74 69 63 61 6c 6c 79 6</b> critically
5e10: 20 64 65 70 65 6e 64 73 20 6f 6e 20 69 74 73 20 depends on its
5e20: 6f 77 6e 20 70 72 69 76 61 74 65 20 53 51 4c 69 own private SQLi
5e30: 74 65 20 64 61 74 61 62 61 73 65 20 28 3c 62 3e te database (<b>
5e40: 70 72 6f 6a 2e 64 62 3c 2f 62 3e 29 20 63 6f 6e proj.db</b>) con
5e50: 74 61 69 6e 69 6e 67 20 61 6c 6c 20 72 65 6c 65 taining all rele
5e60: 76 61 6e 74 20 64 65 66 69 6e 69 74 69 6f 6e 73 vant definitions
5e70: 20 61 62 6f 75 74 20 45 6c 6c 69 70 73 6f 69 64 about Ellipsoid
5e80: 73 2c 20 50 72 69 6d 65 20 4d 65 72 69 64 69 61 s, Prime Meridia
5e90: 6e 73 2c 20 43 52 53 65 73 2c 20 54 72 61 6e 73 ns, CRSes, Trans
5ea0: 66 6f 72 6d 61 74 69 6f 6e 73 20 61 6e 64 20 61 formations and a
5eb0: 6c 69 6b 65 2e 3c 62 72 3e 0d 0a 49 66 20 50 52 like.<br>..If PR
5ec0: 4f 4a 2e 36 20 69 73 20 75 6e 61 62 6c 65 20 74 OJ.6 is unable t
5ed0: 6f 20 63 6f 72 72 65 63 74 6c 79 20 65 73 74 61 o correctly esta
5ee0: 62 6c 69 73 68 20 61 20 63 6f 6e 6e 65 63 74 69 blish a connecti
5ef0: 6f 6e 20 74 6f 20 74 68 69 73 20 64 61 74 61 62 on to this datab
5f00: 61 73 65 20 69 74 20 77 69 6c 6c 20 62 65 20 73 ase it will be s
5f10: 65 76 65 72 65 6c 79 20 6c 69 6d 69 74 65 64 20 everely limited
5f20: 61 6e 64 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 and will not be
5f30: 61 62 6c 65 20 74 6f 20 63 6f 72 72 65 63 74 6c able to correctl
5f40: 79 20 62 65 68 61 76 65 20 61 73 20 65 78 70 65 y behave as expe
5f50: 63 74 65 64 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c cted.<br><br>..<
5f60: 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 3c 75 3e 3c ul>..<li><b><u><
5f70: 69 3e 53 68 6f 72 74 20 63 6f 6e 63 6c 75 73 69 i>Short conclusi
5f80: 6f 6e 3c 2f 69 3e 3c 2f 75 3e 3c 2f 62 3e 3a 20 on</i></u></b>:
5f90: 69 6e 73 74 61 6c 6c 69 6e 67 20 74 68 65 20 73 installing the s
5fa0: 6f 66 74 77 61 72 65 20 61 6c 6f 6e 65 20 69 73 oftware alone is
5fb0: 20 6e 6f 74 20 65 6e 6f 75 67 68 2e 3c 62 72 3e not enough.<br>
5fc0: 0d 0a 54 68 65 20 50 52 4f 4a 2e 36 20 70 72 69 ..The PROJ.6 pri
5fd0: 76 61 74 65 20 64 61 74 61 62 61 73 65 20 3c 62 vate database <b
5fe0: 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20 6d 75 73 >proj.db</b> mus
5ff0: 74 20 62 65 20 70 72 6f 70 65 72 6c 79 20 69 6e t be properly in
6000: 73 74 61 6c 6c 65 64 20 61 73 20 77 65 6c 6c 2c stalled as well,
6010: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 65 6e 73 in order to ens
6020: 75 72 65 20 74 68 61 74 20 61 6e 79 74 68 69 6e ure that anythin
6030: 67 20 72 75 6e 73 20 73 6d 6f 6f 74 68 6c 79 2e g runs smoothly.
6040: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e </li>..</ul><br>
6050: 0d 0a 54 68 69 73 20 69 73 6e 27 74 20 75 73 75 ..This isn't usu
6060: 61 6c 6c 79 20 61 20 62 69 67 20 69 73 73 75 65 ally a big issue
6070: 20 6f 6e 20 4c 69 6e 75 78 20 61 6e 64 20 55 6e on Linux and Un
6080: 69 78 2d 6c 69 6b 65 20 70 6c 61 74 66 6f 72 6d ix-like platform
6090: 73 2c 20 77 68 65 72 65 20 61 20 72 61 74 69 6f s, where a ratio
60a0: 6e 61 6c 20 61 6e 64 20 76 65 72 79 20 63 6c 65 nal and very cle
60b0: 61 72 20 66 69 6c 65 73 79 73 74 65 6d 20 6c 61 ar filesystem la
60c0: 79 6f 75 74 20 65 78 69 73 74 73 2e 3c 62 72 3e yout exists.<br>
60d0: 0d 0a 4f 6e 20 74 68 65 73 65 20 6f 70 65 72 61 ..On these opera
60e0: 74 69 6e 67 20 73 79 73 74 65 6d 73 20 74 68 65 ting systems the
60f0: 20 70 61 63 6b 61 67 65 20 6d 61 6e 61 67 65 72 package manager
6100: 20 28 6f 72 20 3c 62 3e 6d 61 6b 65 20 69 6e 73 (or <b>make ins
6110: 74 61 6c 6c 3c 2f 62 3e 29 20 77 69 6c 6c 20 61 tall</b>) will a
6120: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 74 61 6b utomatically tak
6130: 65 20 63 61 72 65 20 74 6f 20 69 6e 73 74 61 6c e care to instal
6140: 6c 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e l <b>proj.db</b>
6150: 20 6f 6e 20 74 68 65 20 6d 6f 73 74 20 61 70 70 on the most app
6160: 72 6f 70 72 69 61 74 65 20 64 69 72 65 63 74 6f ropriate directo
6170: 72 79 20 28 75 73 75 61 6c 6c 79 20 61 73 20 3c ry (usually as <
6180: 62 3e 2f 75 73 72 2f 73 68 61 72 65 2f 70 72 6f b>/usr/share/pro
6190: 6a 2f 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20 6f 72 j/proj.db</b> or
61a0: 20 61 73 20 3c 62 3e 2f 75 73 72 2f 6c 6f 63 61 as <b>/usr/loca
61b0: 6c 2f 73 68 61 72 65 2f 70 72 6f 6a 2f 70 72 6f l/share/proj/pro
61c0: 6a 2e 64 62 3c 2f 62 3e 29 20 61 6e 64 20 74 68 j.db</b>) and th
61d0: 61 74 27 73 20 61 6c 6c 2e 3c 62 72 3e 3c 62 72 at's all.<br><br
61e0: 3e 0d 0a 54 68 69 6e 67 73 20 61 72 65 20 75 6e >..Things are un
61f0: 68 61 70 70 69 6c 79 20 61 20 6c 69 74 74 6c 65 happily a little
6200: 20 62 69 74 20 6d 6f 72 65 20 64 69 66 66 69 63 bit more diffic
6210: 75 6c 74 73 20 6f 6e 20 57 69 6e 64 6f 77 73 20 ults on Windows
6220: 70 6c 61 74 66 6f 72 6d 73 2e 0d 0a 54 68 65 20 platforms...The
6230: 75 73 65 72 20 69 74 73 65 6c 66 20 69 73 20 72 user itself is r
6240: 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 70 esponsible for p
6250: 72 6f 70 65 72 6c 79 20 69 6e 73 74 61 6c 6c 69 roperly installi
6260: 6e 67 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 ng <b>proj.db</b
6270: 3e 0d 0a 53 6f 20 69 74 20 62 65 63 6f 6d 65 73 >..So it becomes
6280: 20 63 72 69 74 69 63 61 6c 20 75 6e 64 65 72 73 critical unders
6290: 74 61 6e 64 69 6e 67 20 74 68 65 20 62 61 73 69 tanding the basi
62a0: 63 20 72 75 6c 65 73 20 61 64 6f 70 74 65 64 20 c rules adopted
62b0: 62 79 20 3c 62 3e 6c 69 62 73 70 61 74 69 61 6c by <b>libspatial
62c0: 69 74 65 3c 2f 62 3e 20 69 6e 20 6f 72 64 65 72 ite</b> in order
62d0: 20 74 6f 20 70 72 6f 70 65 72 6c 79 20 6c 6f 63 to properly loc
62e0: 61 74 65 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f ate <b>proj.db</
62f0: 62 3e 20 6f 6e 20 57 69 6e 64 6f 77 73 2e 0d 0a b> on Windows...
6300: 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e </td></tr>..<tr>
6310: 3c 74 68 3e 0d 0a 3c 68 32 3e 57 68 65 72 65 20 <th>..<h2>Where
6320: 70 72 6f 6a 2e 64 62 20 69 73 20 65 78 70 65 63 proj.db is expec
6330: 74 65 64 20 74 6f 20 62 65 20 66 6f 75 6e 64 20 ted to be found
6340: 6f 6e 20 57 69 6e 64 6f 77 73 3c 2f 68 32 3e 0d on Windows</h2>.
6350: 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 .</td></tr>..<tr
6360: 3e 3c 74 64 3e 0d 0a 3c 6f 6c 3e 0d 0a 3c 6c 69 ><td>..<ol>..<li
6370: 3e 74 68 65 20 66 69 72 73 74 20 70 6c 61 63 65 >the first place
6380: 20 77 68 65 72 65 20 3c 62 3e 70 72 6f 6a 2e 64 where <b>proj.d
6390: 62 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 73 65 b</b> will be se
63a0: 61 72 63 68 65 64 20 69 73 20 74 68 65 20 73 61 arched is the sa
63b0: 6d 65 20 66 6f 6c 64 65 72 20 66 6f 72 6d 20 77 me folder form w
63c0: 68 65 72 65 20 74 68 65 20 3c 62 3e 45 58 45 3c here the <b>EXE<
63d0: 2f 62 3e 20 62 69 6e 61 72 79 20 77 61 73 20 69 /b> binary was i
63e0: 6e 69 74 69 61 6c 6c 79 20 6c 6f 61 64 65 64 2e nitially loaded.
63f0: 3c 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 45 78 61 6d <br>..<i><u>Exam
6400: 70 6c 65 3c 2f 69 3e 3c 2f 75 3e 3a 20 61 73 73 ple</i></u>: ass
6410: 75 6d 69 6e 67 20 74 68 61 74 20 79 6f 75 20 61 uming that you a
6420: 72 65 20 63 75 72 72 65 6e 74 6c 79 20 65 78 65 re currently exe
6430: 63 75 74 69 6e 67 20 3c 62 3e 43 3a 5c 6d 79 70 cuting <b>C:\myp
6440: 72 6f 67 73 5c 73 70 61 74 69 61 6c 69 74 65 5c rogs\spatialite\
6450: 62 69 6e 5c 73 70 61 74 69 61 6c 69 74 65 2e 65 bin\spatialite.e
6460: 78 65 3c 2f 62 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c xe</b>..<ul>..<l
6470: 69 3e 74 68 65 6e 20 61 6e 20 61 74 74 65 6d 70 i>then an attemp
6480: 74 20 77 69 6c 6c 20 62 65 20 6d 61 64 65 20 74 t will be made t
6490: 6f 20 63 6f 6e 6e 65 63 74 20 3c 62 3e 43 3a 5c o connect <b>C:\
64a0: 6d 79 70 72 6f 67 73 5c 73 70 61 74 69 61 6c 69 myprogs\spatiali
64b0: 74 65 5c 62 69 6e 5c 70 72 6f 6a 2e 64 62 3c 2f te\bin\proj.db</
64c0: 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f b></li>..</ul></
64d0: 6c 69 3e 0d 0a 3c 6c 69 3e 61 20 73 65 63 6f 6e li>..<li>a secon
64e0: 64 20 61 74 74 65 6d 70 74 20 77 69 6c 6c 20 62 d attempt will b
64f0: 65 20 6d 61 64 65 20 6f 6e 20 62 65 68 61 6c 66 e made on behalf
6500: 20 6f 66 20 74 68 65 20 3c 62 3e 50 75 62 6c 69 of the <b>Publi
6510: 63 3c 2f 62 3e 20 66 6f 6c 64 65 72 2e 3c 62 72 c</b> folder.<br
6520: 3e 0d 0a 3c 69 3e 3c 75 3e 45 78 61 6d 70 6c 65 >..<i><u>Example
6530: 3c 2f 75 3e 3c 2f 69 3e 3a 20 61 6e 20 61 74 74 </u></i>: an att
6540: 65 6d 70 74 20 77 69 6c 6c 20 62 65 20 6d 61 64 empt will be mad
6550: 65 20 74 6f 20 63 6f 6e 6e 65 63 74 20 3c 62 3e e to connect <b>
6560: 43 3a 5c 55 73 65 72 73 5c 50 75 62 6c 69 63 5c C:\Users\Public\
6570: 73 70 61 74 69 61 6c 69 74 65 5c 70 72 6f 6a 5c spatialite\proj\
6580: 70 72 6f 6a 2e 64 62 3c 2f 62 3e 3c 2f 6c 69 3e proj.db</b></li>
6590: 0d 0a 3c 6c 69 3e 61 20 74 68 69 72 64 20 28 61 ..<li>a third (a
65a0: 6e 64 20 6c 61 73 74 29 20 61 74 74 65 6d 70 74 nd last) attempt
65b0: 20 77 69 6c 6c 20 62 65 20 6d 61 64 65 20 6f 6e will be made on
65c0: 20 62 65 68 61 6c 66 20 6f 66 20 74 68 65 20 3c behalf of the <
65d0: 62 3e 55 73 65 72 3c 2f 62 3e 20 66 6f 6c 64 65 b>User</b> folde
65e0: 72 2e 3c 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 45 78 r.<br>..<i><u>Ex
65f0: 61 6d 70 6c 65 3c 2f 69 3e 3c 2f 75 3e 3a 20 61 ample</i></u>: a
6600: 6e 20 61 74 74 65 6d 70 74 20 77 69 6c 6c 20 62 n attempt will b
6610: 65 20 6d 61 64 65 20 74 6f 20 63 6f 6e 6e 65 63 e made to connec
6620: 74 20 3c 62 3e 43 3a 5c 55 73 65 72 73 5c 73 61 t <b>C:\Users\sa
6630: 6e 64 72 6f 5c 73 70 61 74 69 61 6c 69 74 65 5c ndro\spatialite\
6640: 70 72 6f 6a 5c 70 72 6f 6a 2e 64 62 3c 2f 62 3e proj\proj.db</b>
6650: 3c 2f 6c 69 3e 0d 0a 3c 2f 6f 6c 3e 0d 0a 3c 68 </li>..</ol>..<h
6660: 33 3e 41 6e 20 75 73 65 66 75 6c 20 64 69 61 67 3>An useful diag
6670: 6e 6f 73 74 69 63 20 63 68 65 63 6b 3c 2f 68 33 nostic check</h3
6680: 3e 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 >..<verbatim>..S
6690: 45 4c 45 43 54 20 50 52 4f 4a 5f 47 65 74 44 61 ELECT PROJ_GetDa
66a0: 74 61 62 61 73 65 50 61 74 68 28 29 3b 0d 0a 3c tabasePath();..<
66b0: 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 3c 75 6c 3e /verbatim>..<ul>
66c0: 0d 0a 3c 6c 69 3e 69 66 20 3c 62 3e 4e 55 4c 4c ..<li>if <b>NULL
66d0: 3c 2f 62 3e 20 69 73 20 72 65 74 75 72 6e 65 64 </b> is returned
66e0: 2c 20 74 68 65 6e 20 50 52 4f 4a 2e 36 20 69 73 , then PROJ.6 is
66f0: 20 64 65 66 69 6e 69 74 65 6c 79 20 75 6e 61 62 definitely unab
6700: 6c 65 20 74 6f 20 63 6f 6e 6e 65 63 74 20 74 6f le to connect to
6710: 20 69 74 73 20 6f 77 6e 20 70 72 69 76 61 74 65 its own private
6720: 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 SQLite database
6730: 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e 3c <b>proj.db</b><
6740: 62 72 3e 0d 0a 59 6f 75 20 68 61 76 65 20 74 6f br>..You have to
6750: 20 63 61 72 65 66 75 6c 6c 79 20 76 65 72 69 66 carefully verif
6760: 69 79 20 74 68 61 74 20 69 74 27 73 20 72 65 61 iy that it's rea
6770: 6c 6c 79 20 69 6e 73 74 61 6c 6c 65 64 20 6f 6e lly installed on
6780: 20 6f 6e 65 20 6f 66 20 74 68 65 20 65 78 70 65 one of the expe
6790: 63 74 65 64 20 73 74 61 6e 64 61 72 64 20 6c 6f cted standard lo
67a0: 63 61 74 69 6f 6e 73 2e 3c 2f 6c 69 3e 0d 0a 3c cations.</li>..<
67b0: 6c 69 3e 6f 74 68 65 72 77 69 73 65 20 74 68 65 li>otherwise the
67c0: 20 70 61 74 68 20 6c 65 61 64 69 6e 67 20 74 6f path leading to
67d0: 20 74 68 65 20 63 75 72 72 65 6e 74 6c 79 20 63 the currently c
67e0: 6f 6e 6e 65 63 74 65 64 20 3c 62 3e 70 72 6f 6a onnected <b>proj
67f0: 2e 64 62 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 .db</b> will be
6800: 72 65 74 75 72 6e 65 64 2e 3c 2f 6c 69 3e 0d 0a returned.</li>..
6810: 3c 2f 75 6c 3e 3c 62 72 3e 0d 0a 3c 2f 74 64 3e </ul><br>..</td>
6820: 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c </tr>..</table><
6830: 62 72 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 br><br>..<table
6840: 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 cellspacing="8"
6850: 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 38 22 20 cellpadding="8"
6860: 62 67 63 6f 6c 6f 72 3d 22 23 63 39 66 66 66 30 bgcolor="#c9fff0
6870: 22 20 77 69 64 74 68 3d 22 31 30 30 25 22 3e 0d " width="100%">.
6880: 0a 3c 74 72 3e 3c 74 68 3e 0d 0a 3c 68 32 3e 55 .<tr><th>..<h2>U
6890: 73 69 6e 67 20 74 68 65 20 65 6e 76 69 72 6f 6e sing the environ
68a0: 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 53 50 ment variable SP
68b0: 41 54 49 41 4c 49 54 45 5f 50 52 4f 4a 5f 44 42 ATIALITE_PROJ_DB
68c0: 5f 50 41 54 48 3c 2f 68 32 3e 0d 0a 3c 2f 74 68 _PATH</h2>..</th
68d0: 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e ></tr>..<tr><td>
68e0: 0d 0a 49 66 20 74 68 65 20 65 6e 76 69 72 6f 6e ..If the environ
68f0: 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 3c 62 ment variable <b
6900: 3e 53 50 41 54 49 41 4c 49 54 45 5f 50 52 4f 4a >SPATIALITE_PROJ
6910: 5f 44 42 5f 50 41 54 48 3c 2f 62 3e 20 69 73 20 _DB_PATH</b> is
6920: 73 65 74 2c 20 74 68 65 6e 20 3c 62 3e 6c 69 62 set, then <b>lib
6930: 73 70 61 74 69 61 6c 69 74 65 3c 2f 62 3e 20 77 spatialite</b> w
6940: 69 6c 6c 20 73 69 6d 70 6c 79 20 61 74 74 65 6d ill simply attem
6950: 70 74 20 74 6f 20 63 6f 6e 6e 65 63 74 20 74 68 pt to connect th
6960: 65 20 64 61 74 61 62 61 73 65 20 70 6f 69 6e 74 e database point
6970: 65 64 20 62 79 20 74 68 69 73 20 76 61 72 69 61 ed by this varia
6980: 62 6c 65 2e 3c 62 72 3e 0d 0a 53 75 63 68 20 61 ble.<br>..Such a
6990: 20 63 61 70 61 62 69 6c 69 74 79 20 69 73 20 73 capability is s
69a0: 75 70 70 6f 72 74 65 64 20 6e 6f 74 20 6f 6e 6c upported not onl
69b0: 79 20 6f 6e 20 57 69 6e 64 6f 77 73 20 62 75 74 y on Windows but
69c0: 20 61 6c 73 6f 20 6f 6e 20 4c 69 6e 75 78 20 28 also on Linux (
69d0: 61 6e 64 20 6f 6e 20 61 6e 79 20 6f 74 68 65 72 and on any other
69e0: 20 70 6c 61 74 66 6f 72 6d 29 2e 3c 62 72 3e 3c platform).<br><
69f0: 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 4c 69 6e 75 78 br>..<i><u>Linux
6a00: 20 65 78 61 6d 70 6c 65 3c 2f 75 3e 3c 2f 69 3e example</u></i>
6a10: 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e :..<ul>..<li><b>
6a20: 65 78 70 6f 72 74 20 22 53 50 41 54 49 41 4c 49 export "SPATIALI
6a30: 54 45 5f 50 52 4f 4a 5f 44 42 5f 50 41 54 48 3d TE_PROJ_DB_PATH=
6a40: 2f 68 6f 6d 65 2f 73 61 6e 64 72 6f 2f 61 75 78 /home/sandro/aux
6a50: 2f 70 72 6f 6a 2e 64 62 22 3c 62 72 3e 0d 0a 65 /proj.db"<br>..e
6a60: 63 68 6f 20 24 53 50 41 54 49 41 4c 49 54 45 5f cho $SPATIALITE_
6a70: 50 52 4f 4a 5f 44 42 5f 50 41 54 48 3c 62 72 3e PROJ_DB_PATH<br>
6a80: 0d 0a 73 70 61 74 69 61 6c 69 74 65 3c 62 3e 3c ..spatialite<b><
6a90: 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 3c /li>..</ul><br><
6aa0: 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 57 69 6e 64 6f br>..<i><u>Windo
6ab0: 77 73 20 65 78 61 6d 70 6c 65 3c 2f 75 3e 3c 2f ws example</u></
6ac0: 69 3e 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c i>:..<ul>..<li><
6ad0: 62 3e 53 45 54 20 53 50 41 54 49 41 4c 49 54 45 b>SET SPATIALITE
6ae0: 5f 50 52 4f 4a 5f 44 42 5f 50 41 54 48 3d 43 3a _PROJ_DB_PATH=C:
6af0: 5c 55 73 65 72 73 5c 73 61 6e 64 72 6f 5c 61 75 \Users\sandro\au
6b00: 78 5c 70 72 6f 6a 2e 64 62 3c 62 72 3e 0d 0a 65 x\proj.db<br>..e
6b10: 63 68 6f 20 25 53 50 41 54 49 41 4c 49 54 45 5f cho %SPATIALITE_
6b20: 50 52 4f 4a 5f 44 42 5f 50 41 54 48 25 3c 62 72 PROJ_DB_PATH%<br
6b30: 3e 0d 0a 73 70 61 74 69 61 6c 69 74 65 5f 67 75 >..spatialite_gu
6b40: 69 3c 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e i<b></li>..</ul>
6b50: 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 2f 74 68 3e 3c <br><br>..</th><
6b60: 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 /tr>..</table><b
6b70: 72 3e 0d 0a 3c 68 72 3e 3c 62 72 3e 0d 0a 3c 61 r>..<hr><br>..<a
6b80: 20 68 72 65 66 3d 22 68 74 74 70 73 3a 2f 2f 77 href="https://w
6b90: 77 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 2f 66 ww.gaia-gis.it/f
6ba0: 6f 73 73 69 6c 2f 6c 69 62 73 70 61 74 69 61 6c ossil/libspatial
6bb0: 69 74 65 2f 77 69 6b 69 3f 6e 61 6d 65 3d 34 2e ite/wiki?name=4.
6bc0: 33 2e 30 2d 64 6f 63 22 3e 62 61 63 6b 3c 2f 61 3.0-doc">back</a
6bd0: 3e 0a 5a 20 38 65 61 61 35 34 38 30 34 66 37 63 >.Z 8eaa54804f7c
6be0: 66 33 65 61 39 65 63 63 30 66 34 37 35 37 66 31 f3ea9ecc0f4757f1
6bf0: 37 39 64 63 0a 79dc.