0000: 44 20 32 30 31 39 2d 30 35 2d 31 34 54 31 34 3a D 2019-05-14T14:
0010: 34 37 3a 33 33 2e 33 32 36 0a 4c 20 50 52 4f 4a 47:33.326.L PROJ
0020: 2e 36 0a 50 20 37 30 30 39 63 36 33 65 31 61 32 .6.P 7009c63e1a2
0030: 64 37 63 62 36 35 35 64 64 32 65 33 31 31 37 33 d7cb655dd2e31173
0040: 32 35 34 66 32 30 64 61 35 37 38 37 35 0a 55 20 254f20da57875.U
0050: 73 61 6e 64 72 6f 0a 57 20 34 34 37 39 38 0a 3c sandro.W 44798.<
0060: 61 20 68 72 65 66 3d 22 68 74 74 70 73 3a 2f 2f a href="https://
0070: 77 77 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 2f www.gaia-gis.it/
0080: 66 6f 73 73 69 6c 2f 6c 69 62 73 70 61 74 69 61 fossil/libspatia
0090: 6c 69 74 65 2f 77 69 6b 69 3f 6e 61 6d 65 3d 34 lite/wiki?name=4
00a0: 2e 33 2e 30 2d 64 6f 63 22 3e 62 61 63 6b 3c 2f .3.0-doc">back</
00b0: 61 3e 3c 68 72 3e 3c 62 72 3e 0d 0a 3c 68 31 3e a><hr><br>..<h1>
00c0: 49 6e 74 72 6f 64 75 63 74 69 6f 6e 3c 2f 68 31 Introduction</h1
00d0: 3e 0d 0a 3c 62 3e 50 52 4f 4a 3c 2f 62 3e 20 69 >..<b>PROJ</b> i
00e0: 73 20 61 20 77 65 6c 6c 2d 6b 6e 6f 77 6e 20 6c s a well-known l
00f0: 69 62 72 61 72 79 20 66 6f 72 20 70 65 72 66 6f ibrary for perfo
0100: 72 6d 69 6e 67 20 63 6f 6e 76 65 72 73 69 6f 6e rming conversion
0110: 73 20 62 65 74 77 65 65 6e 20 63 61 72 74 6f 67 s between cartog
0120: 72 61 70 68 69 63 20 70 72 6f 6a 65 63 74 69 6f raphic projectio
0130: 6e 73 2e 3c 62 72 3e 0d 0a 49 74 27 73 20 75 6e ns.<br>..It's un
0140: 69 76 65 72 73 61 6c 6c 79 20 73 75 70 70 6f 72 iversally suppor
0150: 74 65 64 20 62 79 20 61 6c 6d 6f 73 74 20 61 6c ted by almost al
0160: 6c 20 6f 70 65 6e 20 73 6f 75 72 63 65 20 47 49 l open source GI
0170: 53 2d 6f 72 69 65 6e 74 65 64 20 61 70 70 6c 69 S-oriented appli
0180: 63 61 74 69 6f 6e 73 20 61 6e 64 20 70 61 63 6b cations and pack
0190: 61 67 65 73 2c 20 73 6f 20 74 68 65 72 65 20 69 ages, so there i
01a0: 73 20 6e 6f 20 6e 65 65 64 20 74 6f 20 77 61 73 s no need to was
01b0: 74 65 20 74 69 6d 65 20 69 6e 20 66 75 74 68 65 te time in futhe
01c0: 72 20 70 72 65 73 65 6e 74 61 74 69 6f 6e 73 2e r presentations.
01d0: 3c 62 72 3e 0d 0a 57 65 20 6a 75 73 74 20 6e 65 <br>..We just ne
01e0: 65 64 20 61 20 62 69 74 20 6f 66 20 68 69 73 74 ed a bit of hist
01f0: 6f 72 79 20 74 6f 20 66 75 6c 6c 79 20 75 6e 64 ory to fully und
0200: 65 72 73 74 61 6e 64 20 74 68 65 20 63 75 72 72 erstand the curr
0210: 65 6e 74 20 73 74 61 74 65 20 6f 66 20 74 68 65 ent state of the
0220: 20 61 72 74 20 6f 66 20 74 68 69 73 20 6c 69 62 art of this lib
0230: 72 61 72 79 3a 3c 62 72 3e 0d 0a 3c 68 33 3e 50 rary:<br>..<h3>P
0240: 61 73 74 20 48 69 73 74 6f 72 79 3c 2f 68 33 3e ast History</h3>
0250: 0d 0a 3c 62 3e 3c 75 3e 54 69 6d 65 6c 69 6e 65 ..<b><u>Timeline
0260: 3c 2f 75 3e 3c 2f 62 3e 3c 62 72 3e 0d 0a 56 65 </u></b><br>..Ve
0270: 72 79 20 66 65 77 20 75 73 65 72 73 20 61 6e 64 ry few users and
0280: 20 64 65 76 65 6c 6f 70 65 72 73 20 64 6f 20 72 developers do r
0290: 65 61 6c 6c 79 20 72 65 61 6c 69 7a 65 20 68 6f eally realize ho
02a0: 77 20 61 6e 63 69 65 6e 74 20 69 73 20 50 52 4f w ancient is PRO
02b0: 4a 2c 20 61 6e 64 20 68 6f 77 20 66 61 72 20 69 J, and how far i
02c0: 6e 20 74 69 6d 65 20 69 74 20 73 74 61 72 74 65 n time it starte
02d0: 64 20 6d 6f 76 69 6e 67 20 69 74 73 20 66 69 72 d moving its fir
02e0: 73 74 20 73 74 65 70 73 3a 0d 0a 3c 75 6c 3e 0d st steps:..<ul>.
02f0: 0a 3c 6c 69 3e 69 6e 20 3c 62 3e 31 39 38 30 3c .<li>in <b>1980<
0300: 2f 62 3e 20 28 61 62 6f 75 74 20 34 30 20 79 65 /b> (about 40 ye
0310: 61 72 73 20 61 67 6f 29 20 47 65 72 61 6c 64 20 ars ago) Gerald
0320: 45 76 65 6e 64 65 6e 20 73 74 61 72 74 65 64 20 Evenden started
0330: 77 6f 72 6b 69 6e 67 20 6f 6e 20 74 68 65 20 76 working on the v
0340: 65 72 79 20 66 69 72 73 74 20 50 52 4f 4a 20 76 ery first PROJ v
0350: 65 72 73 69 6f 6e 2c 20 61 6e 64 20 61 74 20 74 ersion, and at t
0360: 68 65 20 74 69 6d 65 20 69 74 20 77 61 73 20 61 he time it was a
0370: 20 52 61 74 66 6f 72 20 70 72 6f 67 72 61 6d 2e Ratfor program.
0380: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 69 6e 20 3c 62 </li>..<li>in <b
0390: 3e 31 39 38 35 3c 2f 62 3e 20 74 68 65 20 63 6f >1985</b> the co
03a0: 64 65 20 77 61 73 20 63 6f 6d 70 6c 65 74 65 6c de was completel
03b0: 79 20 72 65 77 72 69 74 74 65 6e 20 69 6e 20 43 y rewritten in C
03c0: 20 74 6f 20 72 75 6e 20 6f 6e 20 55 4e 49 58 20 to run on UNIX
03d0: 73 79 73 74 65 6d 73 2c 20 61 6e 64 20 69 74 20 systems, and it
03e0: 77 61 73 20 6e 61 6d 65 64 20 3c 62 3e 50 52 4f was named <b>PRO
03f0: 4a 2e 32 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c J.2</b>.</li>..<
0400: 6c 69 3e 69 6e 20 3c 62 3e 31 39 39 30 3c 2f 62 li>in <b>1990</b
0410: 3e 20 77 61 73 20 72 65 6c 65 61 73 65 64 20 61 > was released a
0420: 6e 20 75 70 64 61 74 65 64 20 76 65 72 73 69 6f n updated versio
0430: 6e 20 6e 61 6d 65 64 20 3c 62 3e 50 52 4f 4a 2e n named <b>PROJ.
0440: 33 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 69 6e 20 3c 3</li>..<li>in <
0450: 62 3e 31 39 39 34 3c 2f 62 3e 20 61 20 6d 6f 72 b>1994</b> a mor
0460: 65 20 61 64 76 61 6e 63 65 64 20 76 65 72 73 69 e advanced versi
0470: 6f 6e 20 77 61 73 20 72 65 6c 65 61 73 65 64 2c on was released,
0480: 20 61 6e 64 20 69 74 20 77 61 73 20 6f 62 76 69 and it was obvi
0490: 6f 75 73 6c 79 20 6e 61 6d 65 64 20 3c 62 3e 50 ously named <b>P
04a0: 52 4f 4a 2e 34 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a ROJ.4</b></li>..
04b0: 3c 6c 69 3e 69 6e 20 3c 62 3e 31 39 39 35 3c 2f <li>in <b>1995</
04c0: 62 3e 20 45 76 65 6e 64 65 6e 20 73 74 6f 70 70 b> Evenden stopp
04d0: 65 64 20 61 6e 79 20 66 75 72 74 68 65 72 20 64 ed any further d
04e0: 65 76 65 6c 6f 70 6d 65 6e 74 20 61 63 74 69 76 evelopment activ
04f0: 69 74 79 20 61 6e 64 20 74 68 65 20 70 72 6f 6a ity and the proj
0500: 65 63 74 20 62 65 63 6f 6d 65 20 69 6e 61 63 74 ect become inact
0510: 69 76 65 20 66 6f 72 20 73 65 76 65 72 61 6c 20 ive for several
0520: 79 65 61 72 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 years.</li>..<li
0530: 3e 69 6e 20 3c 62 3e 32 30 30 30 3c 2f 62 3e 20 >in <b>2000</b>
0540: 46 72 61 6e 6b 20 57 61 72 6d 65 72 64 61 6d 20 Frank Warmerdam
0550: 62 65 63 61 6d 65 20 74 68 65 20 6e 65 77 20 6d became the new m
0560: 61 69 6e 74 61 69 6e 65 72 20 61 6e 64 20 72 65 aintainer and re
0570: 6c 65 61 73 65 64 20 76 65 72 73 69 6f 6e 20 3c leased version <
0580: 62 3e 34 2e 34 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a b>4.4</b></li>..
0590: 3c 6c 69 3e 41 66 74 65 72 20 74 68 69 73 20 72 <li>After this r
05a0: 65 62 6f 72 6e 20 74 68 65 20 72 65 76 69 74 61 eborn the revita
05b0: 6c 69 7a 65 64 20 70 72 6f 6a 65 63 74 20 63 6f lized project co
05c0: 6e 74 69 6e 75 65 64 20 74 6f 20 62 65 20 72 65 ntinued to be re
05d0: 67 75 6c 61 72 6c 79 20 6d 61 69 6e 74 61 69 6e gularly maintain
05e0: 65 64 2c 20 62 75 74 20 6e 6f 20 66 75 72 74 68 ed, but no furth
05f0: 65 72 20 72 65 6c 65 76 61 6e 74 20 69 6d 70 72 er relevant impr
0600: 6f 76 65 6d 65 6e 74 73 20 77 65 72 65 20 69 6e ovements were in
0610: 74 72 6f 64 75 63 65 64 2e 3c 62 72 3e 0d 0a 50 troduced.<br>..P
0620: 52 4f 4a 2e 34 20 6a 75 73 74 20 63 6f 6e 74 69 ROJ.4 just conti
0630: 6e 75 65 64 20 69 74 73 20 76 65 72 79 20 70 6c nued its very pl
0640: 61 63 69 64 20 65 76 6f 6c 75 74 69 6f 6e 20 69 acid evolution i
0650: 6e 20 61 20 73 75 62 73 74 61 6e 74 69 61 6c 6c n a substantiall
0660: 79 20 63 6f 6e 73 65 72 76 61 74 69 76 65 20 77 y conservative w
0670: 61 79 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c ay.</li>..</ul><
0680: 62 72 3e 0d 0a 3c 62 3e 3c 75 3e 53 68 6f 72 74 br>..<b><u>Short
0690: 20 63 6f 6e 63 6c 75 73 69 6f 6e 3c 2f 75 3e 3c conclusion</u><
06a0: 2f 62 3e 3a 20 74 68 65 20 66 6f 75 72 74 68 20 /b>: the fourth
06b0: 76 65 72 73 69 6f 6e 20 6f 66 20 50 52 4f 4a 20 version of PROJ
06c0: 28 61 6b 61 20 3c 62 3e 50 52 4f 4a 2e 34 3c 2f (aka <b>PROJ.4</
06d0: 62 3e 29 20 6c 61 73 74 65 64 20 66 6f 72 20 61 b>) lasted for a
06e0: 62 6f 75 74 20 74 77 6f 20 64 65 63 61 64 65 73 bout two decades
06f0: 2c 20 61 20 76 65 72 79 20 75 6e 63 6f 6d 6d 6f , a very uncommo
0700: 6e 20 73 69 74 75 61 74 69 6f 6e 2e 3c 62 72 3e n situation.<br>
0710: 0d 0a 41 6e 64 20 63 6f 6e 73 65 71 75 65 6e 74 ..And consequent
0720: 6c 79 20 61 20 66 75 6c 6c 20 67 65 6e 65 72 61 ly a full genera
0730: 74 69 6f 6e 20 6f 66 20 64 65 76 65 6c 6f 70 65 tion of develope
0740: 72 73 20 61 6e 64 20 75 73 65 72 73 20 62 65 63 rs and users bec
0750: 61 6d 65 20 73 69 6e 63 65 72 65 6c 79 20 63 6f ame sincerely co
0760: 6e 76 69 6e 63 65 64 20 74 68 61 74 20 50 52 4f nvinced that PRO
0770: 4a 2e 34 20 77 61 73 20 74 68 65 20 72 65 61 6c J.4 was the real
0780: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 6c 69 62 name of the lib
0790: 72 61 72 79 2e 0d 0a 3c 68 33 3e 54 68 65 20 72 rary...<h3>The r
07a0: 65 76 6f 6c 75 74 69 6f 6e 20 63 6f 6d 65 73 3c evolution comes<
07b0: 2f 68 33 3e 0d 0a 3c 62 3e 3c 75 3e 54 69 6d 65 /h3>..<b><u>Time
07c0: 6c 69 6e 65 3c 2f 75 3e 3c 2f 62 3e 3a 0d 0a 3c line</u></b>:..<
07d0: 75 6c 3e 0d 0a 3c 6c 69 3e 69 6e 20 3c 62 3e 32 ul>..<li>in <b>2
07e0: 30 31 38 3c 2f 62 3e 20 45 76 65 6e 20 52 6f 75 018</b> Even Rou
07f0: 61 75 6c 74 2c 20 4b 72 69 73 74 69 61 6e 20 45 ault, Kristian E
0800: 76 65 72 73 20 61 6e 64 20 6f 74 68 65 72 73 20 vers and others
0810: 73 74 61 72 74 20 64 65 76 65 6c 6f 70 69 6e 67 start developing
0820: 20 61 20 72 65 76 6f 6c 75 74 69 6f 6e 69 7a 65 a revolutionize
0830: 64 20 50 52 4f 4a 20 73 75 70 70 6f 72 74 69 6e d PROJ supportin
0840: 67 20 6d 61 6e 79 20 72 65 6c 65 76 61 6e 74 20 g many relevant
0850: 69 6e 6e 6f 76 61 74 69 6f 6e 73 2e 3c 62 72 3e innovations.<br>
0860: 0d 0a 3c 62 3e 50 52 4f 4a 2e 35 3c 2f 62 3e 20 ..<b>PROJ.5</b>
0870: 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 is intended to b
0880: 65 20 74 68 65 20 66 69 72 73 74 20 70 72 65 6c e the first prel
0890: 69 6d 69 6e 61 72 79 20 73 74 65 70 20 6f 66 20 iminary step of
08a0: 61 20 6d 6f 72 65 20 63 6f 6d 70 6c 65 78 20 65 a more complex e
08b0: 76 6f 6c 75 74 69 6f 6e 20 73 63 68 65 6d 61 2e volution schema.
08c0: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 6f 6e 20 3c 62 </li>..<li>on <b
08d0: 3e 4d 61 72 63 68 20 32 30 31 39 3c 2f 62 3e 20 >March 2019</b>
08e0: 61 20 6d 6f 72 65 20 6d 61 74 75 72 65 20 76 65 a more mature ve
08f0: 72 73 69 6f 6e 20 69 73 20 72 65 6c 65 61 73 65 rsion is release
0900: 64 2c 20 61 6e 64 20 69 74 27 73 20 3c 62 3e 50 d, and it's <b>P
0910: 52 4f 4a 2e 36 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a ROJ.6</b></li>..
0920: 3c 6c 69 3e 4e 65 78 74 20 79 65 61 72 20 28 32 <li>Next year (2
0930: 30 32 30 29 20 3c 62 3e 50 52 4f 4a 2e 37 3c 2f 020) <b>PROJ.7</
0940: 62 3e 20 69 73 20 65 78 70 65 63 74 65 64 20 74 b> is expected t
0950: 6f 20 62 65 20 72 65 6c 65 61 73 65 64 2c 20 61 o be released, a
0960: 6e 64 20 69 74 20 77 69 6c 6c 20 66 75 6c 6c 79 nd it will fully
0970: 20 63 6f 6d 70 6c 65 74 65 20 74 68 65 20 74 72 complete the tr
0980: 61 6e 73 69 74 69 6f 6e 20 62 65 74 77 65 65 6e ansition between
0990: 20 74 68 65 20 6f 6c 64 20 61 6e 64 20 6e 65 77 the old and new
09a0: 20 61 72 63 68 69 74 65 63 74 75 72 65 73 2e 3c architectures.<
09b0: 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 62 72 /li>..</ul>..<br
09c0: 3e 0d 0a 3c 62 3e 3c 75 3e 4e 6f 74 65 3c 2f 75 >..<b><u>Note</u
09d0: 3e 3c 2f 62 3e 3a 20 74 68 65 20 77 68 6f 6c 65 ></b>: the whole
09e0: 20 74 72 61 6e 73 69 74 69 6f 6e 20 69 6d 70 6c transition impl
09f0: 69 65 73 20 6d 61 6e 79 20 72 65 6c 65 76 61 6e ies many relevan
0a00: 74 20 63 68 61 6e 67 65 73 2c 20 73 6f 20 74 68 t changes, so th
0a10: 61 74 20 61 20 64 65 65 70 6c 79 20 72 65 76 69 at a deeply revi
0a20: 73 65 64 20 41 50 49 20 77 69 6c 6c 20 62 65 20 sed API will be
0a30: 72 65 71 75 69 72 65 64 2e 0d 0a 49 6e 20 6f 74 required...In ot
0a40: 68 65 72 20 77 6f 72 64 73 2c 20 74 68 65 20 6f her words, the o
0a50: 6c 64 20 3c 62 3e 50 52 4f 4a 2e 34 3c 2f 62 3e ld <b>PROJ.4</b>
0a60: 20 61 6e 64 20 74 68 65 20 6e 65 77 20 3c 62 3e and the new <b>
0a70: 50 52 4f 4a 2e 37 3c 2f 62 3e 20 77 69 6c 6c 20 PROJ.7</b> will
0a80: 73 75 70 70 6f 72 74 20 74 77 6f 20 64 69 66 66 support two diff
0a90: 65 72 65 6e 74 20 41 50 49 73 2c 20 74 68 75 73 erent APIs, thus
0aa0: 20 61 62 72 75 70 74 6c 79 20 62 72 65 61 6b 69 abruptly breaki
0ab0: 6e 67 20 63 72 6f 73 73 2d 76 65 72 73 69 6f 6e ng cross-version
0ac0: 20 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 2e 3c compatibility.<
0ad0: 62 72 3e 0d 0a 54 68 69 73 20 69 73 20 61 6e 20 br>..This is an
0ae0: 75 6d 70 6c 65 61 73 61 6e 74 20 6e 65 77 2c 20 umpleasant new,
0af0: 62 65 63 61 75 73 65 20 69 74 20 70 72 61 63 74 because it pract
0b00: 69 63 61 6c 6c 79 20 6d 65 61 6e 73 20 74 68 61 ically means tha
0b10: 74 20 61 6c 6c 20 73 6f 66 74 77 61 72 65 20 6d t all software m
0b20: 6f 64 75 6c 65 73 20 64 65 70 65 6e 64 69 6e 67 odules depending
0b30: 20 6f 6e 20 50 52 4f 4a 20 28 74 68 69 73 20 69 on PROJ (this i
0b40: 6e 63 6c 75 64 69 6e 67 20 53 70 61 74 69 61 4c ncluding SpatiaL
0b50: 69 74 65 29 20 77 69 6c 6c 20 72 65 71 75 69 72 ite) will requir
0b60: 65 20 61 20 6e 6f 74 20 61 74 20 61 6c 6c 20 74 e a not at all t
0b70: 72 69 76 69 61 6c 20 72 65 77 72 69 74 65 20 69 rivial rewrite i
0b80: 6e 20 6f 72 64 65 72 20 74 6f 20 66 75 6c 66 69 n order to fulfi
0b90: 6c 6c 20 74 68 65 20 6e 65 77 20 41 50 49 20 72 ll the new API r
0ba0: 65 71 75 69 72 65 6d 65 6e 74 73 2e 3c 62 72 3e equirements.<br>
0bb0: 0d 0a 42 75 74 20 77 68 65 6e 20 79 6f 75 20 63 ..But when you c
0bc0: 6f 6e 73 69 64 65 72 20 74 68 61 74 27 73 20 74 onsider that's t
0bd0: 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 69 6e he first time in
0be0: 20 69 74 73 20 76 65 72 79 20 6c 6f 6e 67 20 6c its very long l
0bf0: 69 66 65 20 74 68 61 74 20 50 52 4f 4a 20 72 65 ife that PROJ re
0c00: 71 75 69 72 65 73 20 61 6e 20 65 78 74 72 61 20 quires an extra
0c10: 65 66 66 6f 72 74 20 69 6e 20 6f 72 64 65 72 20 effort in order
0c20: 74 6f 20 69 6e 74 72 6f 64 75 63 65 20 73 6f 20 to introduce so
0c30: 6d 61 6e 79 20 75 73 65 66 75 6c 20 69 6e 6e 6f many useful inno
0c40: 76 61 74 69 6f 6e 73 2c 20 74 68 69 73 20 75 6e vations, this un
0c50: 65 78 70 65 63 74 65 64 20 41 50 49 20 62 72 65 expected API bre
0c60: 61 6b 61 67 65 20 6c 6f 6f 6b 73 20 66 75 6c 6c akage looks full
0c70: 79 20 6a 75 73 74 69 66 69 65 64 20 61 6e 64 20 y justified and
0c80: 61 62 73 6f 6c 75 74 65 6c 79 20 72 65 61 73 6f absolutely reaso
0c90: 6e 61 62 6c 65 2e 3c 62 72 3e 3c 62 72 3e 0d 0a nable.<br><br>..
0ca0: 3c 62 3e 3c 75 3e 4d 6f 72 65 20 64 65 74 61 69 <b><u>More detai
0cb0: 6c 73 20 61 62 6f 75 74 20 74 68 65 20 41 50 49 ls about the API
0cc0: 20 62 72 65 61 6b 61 67 65 3c 2f 75 3e 3c 2f 62 breakage</u></b
0cd0: 3e 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 >:..<ul>..<li><b
0ce0: 3e 50 52 4f 4a 2e 35 3c 2f 62 3e 20 73 74 61 72 >PROJ.5</b> star
0cf0: 74 65 64 20 69 6e 74 72 6f 64 75 63 69 6e 67 20 ted introducing
0d00: 74 68 65 20 6e 65 77 20 41 50 49 2c 20 62 75 74 the new API, but
0d10: 20 77 61 73 20 73 74 69 6c 6c 20 61 62 6c 65 20 was still able
0d20: 74 6f 20 73 75 70 70 6f 72 74 20 74 68 65 20 6f to support the o
0d30: 6c 64 20 74 72 61 64 69 74 69 6f 6e 61 6c 20 41 ld traditional A
0d40: 50 49 20 77 69 74 68 6f 75 74 20 61 6e 79 20 63 PI without any c
0d50: 6f 6d 70 6c 61 69 6e 74 2e 3c 2f 6c 69 3e 0d 0a omplaint.</li>..
0d60: 3c 6c 69 3e 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 <li><b>PROJ.6</b
0d70: 3e 20 68 61 76 65 20 64 65 70 72 65 63 65 74 65 > have deprecete
0d80: 64 20 74 68 65 20 6f 6c 64 20 74 72 61 64 69 74 d the old tradit
0d90: 69 6f 6e 61 6c 20 41 50 49 2e 3c 62 72 3e 0d 0a ional API.<br>..
0da0: 49 74 20 73 74 69 6c 6c 20 63 6f 6e 74 69 6e 75 It still continu
0db0: 65 73 20 74 6f 20 62 65 20 72 65 6c 75 63 74 61 es to be relucta
0dc0: 6e 63 74 6c 79 20 73 75 70 70 6f 72 74 65 64 2c nctly supported,
0dd0: 20 62 75 74 20 74 68 65 20 6c 69 62 72 61 72 79 but the library
0de0: 20 72 65 71 75 69 72 65 73 20 74 6f 20 62 65 20 requires to be
0df0: 63 6f 6d 70 69 6c 65 64 20 62 79 20 65 78 70 6c compiled by expl
0e00: 69 63 69 74 6c 79 20 64 65 66 69 6e 69 6e 67 20 icitly defining
0e10: 61 20 3c 62 3e 2d 44 41 43 43 45 50 54 5f 55 53 a <b>-DACCEPT_US
0e20: 45 5f 4f 46 5f 44 45 50 52 45 43 41 54 45 44 5f E_OF_DEPRECATED_
0e30: 50 52 4f 4a 5f 41 50 49 5f 48 3d 31 3c 2f 62 3e PROJ_API_H=1</b>
0e40: 20 64 69 72 65 63 74 69 76 65 20 69 6e 20 6f 72 directive in or
0e50: 64 65 72 20 74 6f 20 65 66 66 65 63 74 69 76 65 der to effective
0e60: 6c 79 20 65 6e 61 62 6c 65 20 74 68 69 73 20 6f ly enable this o
0e70: 70 74 69 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 ption.</li>..<li
0e80: 3e 61 6e 64 20 66 69 6e 61 6c 6c 79 20 74 68 65 >and finally the
0e90: 20 6e 65 78 74 2d 74 6f 2d 63 6f 6d 65 20 3c 62 next-to-come <b
0ea0: 3e 50 52 4f 4a 2e 37 3c 2f 62 3e 20 77 69 6c 6c >PROJ.7</b> will
0eb0: 20 63 6f 6d 70 6c 65 74 65 6c 79 20 67 65 74 20 completely get
0ec0: 72 69 64 20 6f 66 20 74 68 65 20 6f 6c 64 20 41 rid of the old A
0ed0: 50 49 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d PI.</li>..</ul>.
0ee0: 0a 3c 62 72 3e 0d 0a 3c 68 72 3e 0d 0a 3c 68 31 .<br>..<hr>..<h1
0ef0: 3e 57 68 61 74 27 73 20 6e 65 77 20 69 6e 20 50 >What's new in P
0f00: 52 4f 4a 2e 36 3c 2f 68 31 3e 0d 0a 3c 68 33 3e ROJ.6</h1>..<h3>
0f10: 46 75 6c 6c 79 20 73 75 70 70 6f 72 74 69 6e 67 Fully supporting
0f20: 20 49 53 4f 20 31 39 31 36 32 3a 32 30 31 38 20 ISO 19162:2018
0f30: 57 4b 54 3c 2f 68 33 3e 0d 0a 4f 6c 64 20 76 65 WKT</h3>..Old ve
0f40: 72 73 69 6f 6e 73 20 6f 66 20 50 52 4f 4a 20 28 rsions of PROJ (
0f50: 69 6e 63 6c 75 64 69 6e 67 20 3c 62 3e 50 52 4f including <b>PRO
0f60: 4a 2e 34 3c 2f 62 3e 29 20 72 65 71 75 69 72 65 J.4</b>) require
0f70: 64 20 74 6f 20 64 65 66 69 6e 65 20 65 61 63 68 d to define each
0f80: 20 3c 62 3e 43 52 53 3c 2f 62 3e 20 28 3c 69 3e <b>CRS</b> (<i>
0f90: 43 6f 6f 72 64 69 6e 61 74 65 20 52 65 66 65 72 Coordinate Refer
0fa0: 65 6e 63 65 20 53 79 73 74 65 6d 3c 2f 69 3e 29 ence System</i>)
0fb0: 20 62 79 20 61 20 63 6f 72 72 65 73 70 6f 6e 64 by a correspond
0fc0: 69 6e 67 20 3c 62 3e 70 72 6f 6a 2d 73 74 72 69 ing <b>proj-stri
0fd0: 6e 67 3c 2f 62 3e 2e 0d 0a 54 68 65 20 66 6f 6c ng</b>...The fol
0fe0: 6c 6f 77 69 6e 67 20 74 61 62 6c 65 20 65 78 65 lowing table exe
0ff0: 6d 70 6c 69 66 69 65 73 20 74 68 65 20 63 61 73 mplifies the cas
1000: 65 20 6f 66 20 66 65 77 20 43 52 53 65 73 3a 3c e of few CRSes:<
1010: 62 72 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 br><br>..<table
1020: 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 cellspacing="8"
1030: 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 38 22 20 cellpadding="8"
1040: 62 67 63 6f 6c 6f 72 3d 22 23 65 38 66 66 65 38 bgcolor="#e8ffe8
1050: 22 20 62 6f 72 64 65 72 3d 22 31 22 3e 0d 0a 3c " border="1">..<
1060: 74 72 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 tr><th bgcolor="
1070: 23 66 66 62 30 33 65 22 3e 53 52 49 44 3c 2f 74 #ffb03e">SRID</t
1080: 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 h><th bgcolor="#
1090: 66 66 62 30 33 65 22 3e 43 52 53 20 4e 61 6d 65 ffb03e">CRS Name
10a0: 3c 2f 74 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 </th><th bgcolor
10b0: 3d 22 23 66 66 62 30 33 65 22 3e 70 72 6f 6a 2d ="#ffb03e">proj-
10c0: 73 74 72 69 6e 67 20 28 50 52 4f 4a 2e 34 20 73 string (PROJ.4 s
10d0: 74 79 6c 65 29 3c 2f 74 68 3e 3c 74 68 20 62 67 tyle)</th><th bg
10e0: 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 3e color="#ffb03e">
10f0: 70 72 6f 6a 2d 73 74 72 69 6e 67 20 28 50 52 4f proj-string (PRO
1100: 4a 2e 36 20 73 74 79 6c 65 29 3c 2f 74 68 3e 3c J.6 style)</th><
1110: 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 20 61 6c /tr>..<tr><td al
1120: 69 67 6e 3d 22 72 69 67 68 74 22 3e 33 30 30 33 ign="right">3003
1130: 3c 2f 74 64 3e 3c 74 64 3e 4d 6f 6e 74 65 20 4d </td><td>Monte M
1140: 61 72 69 6f 20 2f 20 49 74 61 6c 79 20 7a 6f 6e ario / Italy zon
1150: 65 20 31 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 2b 70 e 1</td>..<td>+p
1160: 72 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 5f 30 roj=tmerc +lat_0
1170: 3d 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 =0 +lon_0=9 +k=0
1180: 2e 39 39 39 36 20 2b 78 5f 30 3d 31 35 30 30 30 .9996 +x_0=15000
1190: 30 30 20 2b 79 5f 30 3d 30 20 5c 3c 62 72 3e 0d 00 +y_0=0 \<br>.
11a0: 0a 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20 2b 74 6f .+ellps=intl +to
11b0: 77 67 73 38 34 3d 2d 31 30 34 2e 31 2c 2d 34 39 wgs84=-104.1,-49
11c0: 2e 31 2c 2d 39 2e 39 2c 30 2e 39 37 31 2c 2d 32 .1,-9.9,0.971,-2
11d0: 2e 39 31 37 2c 30 2e 37 31 34 2c 2d 31 31 2e 36 .917,0.714,-11.6
11e0: 38 20 2b 75 6e 69 74 73 3d 6d 20 2b 6e 6f 5f 64 8 +units=m +no_d
11f0: 65 66 73 3c 2f 74 64 3e 3c 74 64 3e 2b 70 72 6f efs</td><td>+pro
1200: 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 5f 30 3d 30 j=tmerc +lat_0=0
1210: 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 2e 39 +lon_0=9 +k=0.9
1220: 39 39 36 20 2b 78 5f 30 3d 31 35 30 30 30 30 30 996 +x_0=1500000
1230: 20 2b 79 5f 30 3d 30 20 5c 3c 62 72 3e 0d 0a 2b +y_0=0 \<br>..+
1240: 65 6c 6c 70 73 3d 69 6e 74 6c 20 2b 75 6e 69 74 ellps=intl +unit
1250: 73 3d 6d 20 2b 6e 6f 5f 64 65 66 73 20 2b 74 79 s=m +no_defs +ty
1260: 70 65 3d 63 72 73 3c 2f 74 64 3e 3c 2f 74 72 3e pe=crs</td></tr>
1270: 0d 0a 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e 3d ..<tr><td align=
1280: 22 72 69 67 68 74 22 3e 34 33 32 36 3c 2f 74 64 "right">4326</td
1290: 3e 3c 74 64 3e 57 47 53 20 38 34 3c 2f 74 64 3e ><td>WGS 84</td>
12a0: 0d 0a 3c 74 64 3e 2b 70 72 6f 6a 3d 6c 6f 6e 67 ..<td>+proj=long
12b0: 6c 61 74 20 2b 64 61 74 75 6d 3d 57 47 53 38 34 lat +datum=WGS84
12c0: 20 2b 6e 6f 5f 64 65 66 73 3c 2f 74 64 3e 3c 74 +no_defs</td><t
12d0: 64 3e 2b 70 72 6f 6a 3d 6c 6f 6e 67 6c 61 74 20 d>+proj=longlat
12e0: 2b 64 61 74 75 6d 3d 57 47 53 38 34 20 2b 6e 6f +datum=WGS84 +no
12f0: 5f 64 65 66 73 20 2b 74 79 70 65 3d 63 72 73 3c _defs +type=crs<
1300: 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c /td></tr>..<tr><
1310: 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 td align="right"
1320: 3e 33 32 36 33 32 3c 2f 74 64 3e 3c 74 64 3e 57 >32632</td><td>W
1330: 47 53 20 38 34 20 2f 20 55 54 4d 20 7a 6f 6e 65 GS 84 / UTM zone
1340: 20 33 32 4e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 2b 32N</td>..<td>+
1350: 70 72 6f 6a 3d 75 74 6d 20 2b 7a 6f 6e 65 3d 33 proj=utm +zone=3
1360: 32 20 2b 64 61 74 75 6d 3d 57 47 53 38 34 20 2b 2 +datum=WGS84 +
1370: 75 6e 69 74 73 3d 6d 20 2b 6e 6f 5f 64 65 66 73 units=m +no_defs
1380: 3c 2f 74 64 3e 3c 74 64 3e 2b 70 72 6f 6a 3d 75 </td><td>+proj=u
1390: 74 6d 20 2b 7a 6f 6e 65 3d 33 32 20 2b 64 61 74 tm +zone=32 +dat
13a0: 75 6d 3d 57 47 53 38 34 20 2b 75 6e 69 74 73 3d um=WGS84 +units=
13b0: 6d 20 2b 6e 6f 5f 64 65 66 73 20 2b 74 79 70 65 m +no_defs +type
13c0: 3d 63 72 73 3c 2f 74 64 3e 0d 0a 3c 2f 74 61 62 =crs</td>..</tab
13d0: 6c 65 3e 0d 0a 3c 62 72 3e 0d 0a 50 52 4f 4a 2e le>..<br>..PROJ.
13e0: 36 20 73 74 69 6c 6c 20 63 6f 6e 74 69 6e 75 65 6 still continue
13f0: 73 20 74 6f 20 73 75 70 70 6f 72 74 20 74 68 65 s to support the
1400: 20 6f 6c 64 20 70 72 6f 6a 2d 73 74 72 69 6e 67 old proj-string
1410: 73 2c 20 62 75 74 20 69 74 20 6e 6f 77 20 61 64 s, but it now ad
1420: 6f 70 74 73 20 61 20 73 6c 69 67 68 74 6c 79 20 opts a slightly
1430: 63 68 61 6e 67 65 64 20 6e 6f 74 61 74 69 6f 6e changed notation
1440: 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 74 68 65 :..<ul>..<li>the
1450: 72 65 20 69 73 20 61 20 6e 65 77 20 3c 62 3e 2b re is a new <b>+
1460: 74 79 70 65 3d 63 72 73 3c 2f 62 3e 20 6d 65 6d type=crs</b> mem
1470: 62 65 72 20 65 78 70 6c 69 63 69 74 6c 79 20 73 ber explicitly s
1480: 74 61 74 69 6e 67 20 74 68 61 74 20 74 68 65 20 tating that the
1490: 73 74 72 69 6e 67 20 69 73 20 69 6e 74 65 6e 64 string is intend
14a0: 65 64 20 74 6f 20 62 65 20 43 52 53 20 64 65 66 ed to be CRS def
14b0: 69 6e 69 74 69 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c inition.</li>..<
14c0: 6c 69 3e 61 73 20 61 20 67 65 6e 65 72 61 6c 20 li>as a general
14d0: 72 75 6c 65 20 74 68 65 20 3c 62 3e 2b 74 6f 77 rule the <b>+tow
14e0: 67 73 38 34 3d 3c 2f 62 3e 20 6d 65 6d 62 65 72 gs84=</b> member
14f0: 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 73 75 is no longer su
1500: 70 70 6f 72 74 65 64 2e 3c 62 72 3e 0d 0a 3c 62 pported.<br>..<b
1510: 3e 4e 6f 74 65 3c 2f 62 3e 3a 20 74 68 69 73 20 >Note</b>: this
1520: 69 73 20 61 20 76 65 72 79 20 63 72 69 74 69 63 is a very critic
1530: 61 6c 20 63 68 61 6e 67 65 2c 20 74 68 61 74 20 al change, that
1540: 63 61 6e 20 65 61 73 69 6c 79 20 6c 65 61 64 20 can easily lead
1550: 74 6f 20 75 6e 65 78 70 65 63 74 65 64 20 72 65 to unexpected re
1560: 73 75 6c 74 2e 3c 62 72 3e 0d 0a 4a 75 73 74 20 sult.<br>..Just
1570: 61 73 20 61 6e 20 65 78 61 6d 70 6c 65 2c 20 69 as an example, i
1580: 6e 20 74 68 65 20 63 61 73 65 20 6f 66 20 3c 62 n the case of <b
1590: 3e 45 50 53 47 3a 33 30 30 33 20 3c 69 3e 28 49 >EPSG:3003 <i>(I
15a0: 74 61 6c 79 20 6d 61 69 6e 6c 61 6e 64 29 3c 2f taly mainland)</
15b0: 69 3e 3c 2f 62 3e 20 73 75 70 70 72 65 73 73 69 i></b> suppressi
15c0: 6e 67 20 74 68 65 20 3c 62 3e 2b 74 6f 77 67 73 ng the <b>+towgs
15d0: 38 34 3c 2f 62 3e 20 6d 65 6d 62 65 72 20 63 61 84</b> member ca
15e0: 75 73 65 73 20 61 20 73 68 69 66 74 20 6f 66 20 uses a shift of
15f0: 61 62 6f 75 74 20 3c 62 3e 31 30 30 6d 3c 2f 62 about <b>100m</b
1600: 3e 20 69 6e 20 63 6f 6f 72 64 69 6e 61 74 65 20 > in coordinate
1610: 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 73 2e transformations.
1620: 20 42 65 20 77 61 72 6e 65 64 2e 3c 2f 6c 69 3e Be warned.</li>
1630: 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 62 72 3e 0d 0a 41 ..</ul>..<br>..A
1640: 6c 74 68 6f 75 67 68 74 20 6e 65 77 20 76 65 72 lthought new ver
1650: 73 69 6f 6e 73 20 6f 66 20 50 52 4f 4a 20 28 73 sions of PROJ (s
1660: 74 61 72 74 69 6e 67 20 73 69 6e 63 65 20 3c 62 tarting since <b
1670: 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 29 20 73 74 69 >PROJ.6</b>) sti
1680: 6c 6c 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20 73 ll continue to s
1690: 75 70 70 6f 72 74 20 74 68 65 20 6f 6c 64 20 3c upport the old <
16a0: 62 3e 70 72 6f 6a 2d 73 74 72 69 6e 67 73 3c 2f b>proj-strings</
16b0: 62 3e 2c 20 74 68 69 73 20 69 73 20 6e 6f 20 6c b>, this is no l
16c0: 6f 6e 67 65 72 20 74 68 65 20 70 72 65 66 65 72 onger the prefer
16d0: 72 65 64 20 6e 6f 74 61 74 69 6f 6e 20 66 6f 72 red notation for
16e0: 20 64 65 66 69 6e 69 6e 67 20 61 20 43 52 53 2e defining a CRS.
16f0: 3c 62 72 3e 0d 0a 4e 6f 77 20 74 68 65 20 70 72 <br>..Now the pr
1700: 65 66 65 72 72 65 64 20 6e 6f 74 61 74 69 6f 6e eferred notation
1710: 20 69 73 20 66 75 6c 6c 79 20 63 6f 6e 66 6f 72 is fully confor
1720: 6d 61 6e 74 20 74 6f 20 74 68 65 20 3c 62 3e 49 mant to the <b>I
1730: 53 4f 20 31 39 31 36 32 3a 32 30 31 38 3c 2f 62 SO 19162:2018</b
1740: 3e 20 69 6e 74 65 72 6e 61 74 69 6f 6e 61 6c 20 > international
1750: 73 74 61 6e 64 61 72 64 0d 0a 28 3c 69 3e 4f 47 standard..(<i>OG
1760: 43 20 41 62 73 74 72 61 63 74 20 53 70 65 63 69 C Abstract Speci
1770: 66 69 63 61 74 69 6f 6e 20 54 6f 70 69 63 20 32 fication Topic 2
1780: 3a 20 e2 80 9c 52 65 66 65 72 65 6e 63 69 6e 67 : ...Referencing
1790: 20 42 79 20 43 6f 6f 72 64 69 6e 61 74 65 73 e2 By Coordinates.
17a0: 80 9d 3c 2f 69 3e 29 2e 3c 62 72 3e 0d 0a 54 68 ..</i>).<br>..Th
17b0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 61 62 6c e following tabl
17c0: 65 20 65 78 65 6d 70 6c 69 66 69 65 73 20 74 68 e exemplifies th
17d0: 65 20 73 61 6d 65 20 43 52 53 65 73 20 61 73 20 e same CRSes as
17e0: 61 62 6f 76 65 20 69 6e 20 74 68 65 20 6d 6f 72 above in the mor
17f0: 65 20 72 65 63 65 6e 74 20 49 53 4f 20 57 4b 54 e recent ISO WKT
1800: 20 6e 6f 74 61 74 69 6f 6e 3a 0d 0a 3c 62 72 3e notation:..<br>
1810: 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c <br>..<table cel
1820: 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65 6c lspacing="8" cel
1830: 6c 70 61 64 64 69 6e 67 3d 22 38 22 20 62 67 63 lpadding="8" bgc
1840: 6f 6c 6f 72 3d 22 23 65 38 66 66 65 38 22 20 62 olor="#e8ffe8" b
1850: 6f 72 64 65 72 3d 22 31 22 3e 0d 0a 3c 74 72 3e order="1">..<tr>
1860: 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 <th bgcolor="#ff
1870: 62 30 33 65 22 3e 53 52 49 44 3c 2f 74 68 3e 3c b03e">SRID</th><
1880: 74 64 3e 33 30 30 33 3c 2f 74 64 3e 3c 74 64 3e td>3003</td><td>
1890: 34 33 32 36 3c 2f 74 64 3e 3c 74 64 3e 33 32 36 4326</td><td>326
18a0: 33 32 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 32</td></tr>..<t
18b0: 72 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 r><th bgcolor="#
18c0: 66 66 62 30 33 65 22 3e 43 52 53 20 4e 61 6d 65 ffb03e">CRS Name
18d0: 3c 2f 74 68 3e 3c 74 64 3e 4d 6f 6e 74 65 20 4d </th><td>Monte M
18e0: 61 72 69 6f 20 2f 20 49 74 61 6c 79 20 7a 6f 6e ario / Italy zon
18f0: 65 20 31 3c 2f 74 64 3e 3c 2f 74 64 3e 3c 74 64 e 1</td></td><td
1900: 3e 57 47 53 20 38 34 3c 2f 74 64 3e 3c 74 64 3e >WGS 84</td><td>
1910: 57 47 53 20 38 34 20 2f 20 55 54 4d 20 7a 6f 6e WGS 84 / UTM zon
1920: 65 20 33 32 4e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d e 32N</td></tr>.
1930: 0a 3c 74 72 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 .<tr><th bgcolor
1940: 3d 22 23 66 66 62 30 33 65 22 3e 49 53 4f 2d 32 ="#ffb03e">ISO-2
1950: 30 31 38 20 57 4b 54 3c 2f 74 68 3e 0d 0a 3c 74 018 WKT</th>..<t
1960: 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 3c d valign="top"><
1970: 76 65 72 62 61 74 69 6d 3e 0d 0a 50 52 4f 4a 43 verbatim>..PROJC
1980: 52 53 5b 22 4d 6f 6e 74 65 20 4d 61 72 69 6f 20 RS["Monte Mario
1990: 2f 20 49 74 61 6c 79 20 7a 6f 6e 65 20 31 22 2c / Italy zone 1",
19a0: 0d 0a 20 20 20 20 42 41 53 45 47 45 4f 44 43 52 .. BASEGEODCR
19b0: 53 5b 22 4d 6f 6e 74 65 20 4d 61 72 69 6f 22 2c S["Monte Mario",
19c0: 0d 0a 20 20 20 20 20 20 20 20 44 41 54 55 4d 5b .. DATUM[
19d0: 22 4d 6f 6e 74 65 20 4d 61 72 69 6f 22 2c 3c 62 "Monte Mario",<b
19e0: 72 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 r>..
19f0: 45 4c 4c 49 50 53 4f 49 44 5b 22 49 6e 74 65 72 ELLIPSOID["Inter
1a00: 6e 61 74 69 6f 6e 61 6c 20 31 39 32 34 22 2c 36 national 1924",6
1a10: 33 37 38 33 38 38 2c 32 39 37 2c 0d 0a 20 20 20 378388,297,..
1a20: 20 20 20 20 20 20 20 20 20 20 20 20 20 4c 45 4e LEN
1a30: 47 54 48 55 4e 49 54 5b 22 6d 65 74 72 65 22 2c GTHUNIT["metre",
1a40: 31 5d 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 1]]],.. P
1a50: 52 49 4d 45 4d 5b 22 47 72 65 65 6e 77 69 63 68 RIMEM["Greenwich
1a60: 22 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 ",0,..
1a70: 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 ANGLEUNIT["deg
1a80: 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 ree",0.017453292
1a90: 35 31 39 39 34 33 33 5d 5d 5d 2c 0d 0a 20 20 20 5199433]]],..
1aa0: 20 43 4f 4e 56 45 52 53 49 4f 4e 5b 22 49 74 61 CONVERSION["Ita
1ab0: 6c 79 20 7a 6f 6e 65 20 31 22 2c 0d 0a 20 20 20 ly zone 1",..
1ac0: 20 20 20 20 20 4d 45 54 48 4f 44 5b 22 54 72 61 METHOD["Tra
1ad0: 6e 73 76 65 72 73 65 20 4d 65 72 63 61 74 6f 72 nsverse Mercator
1ae0: 22 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ",..
1af0: 49 44 5b 22 45 50 53 47 22 2c 39 38 30 37 5d 5d ID["EPSG",9807]]
1b00: 2c 0d 0a 20 20 20 20 20 20 20 20 50 41 52 41 4d ,.. PARAM
1b10: 45 54 45 52 5b 22 4c 61 74 69 74 75 64 65 20 6f ETER["Latitude o
1b20: 66 20 6e 61 74 75 72 61 6c 20 6f 72 69 67 69 6e f natural origin
1b30: 22 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 ",0,..
1b40: 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 ANGLEUNIT["deg
1b50: 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 ree",0.017453292
1b60: 35 31 39 39 34 33 33 5d 2c 0d 0a 20 20 20 20 20 5199433],..
1b70: 20 20 20 20 20 20 20 49 44 5b 22 45 50 53 47 22 ID["EPSG"
1b80: 2c 38 38 30 31 5d 5d 2c 0d 0a 20 20 20 20 20 20 ,8801]],..
1b90: 20 20 50 41 52 41 4d 45 54 45 52 5b 22 4c 6f 6e PARAMETER["Lon
1ba0: 67 69 74 75 64 65 20 6f 66 20 6e 61 74 75 72 61 gitude of natura
1bb0: 6c 20 6f 72 69 67 69 6e 22 2c 39 2c 0d 0a 20 20 l origin",9,..
1bc0: 20 20 20 20 20 20 20 20 20 20 41 4e 47 4c 45 55 ANGLEU
1bd0: 4e 49 54 5b 22 64 65 67 72 65 65 22 2c 30 2e 30 NIT["degree",0.0
1be0: 31 37 34 35 33 32 39 32 35 31 39 39 34 33 33 5d 174532925199433]
1bf0: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 ,.. I
1c00: 44 5b 22 45 50 53 47 22 2c 38 38 30 32 5d 5d 2c D["EPSG",8802]],
1c10: 0d 0a 20 20 20 20 20 20 20 20 50 41 52 41 4d 45 .. PARAME
1c20: 54 45 52 5b 22 53 63 61 6c 65 20 66 61 63 74 6f TER["Scale facto
1c30: 72 20 61 74 20 6e 61 74 75 72 61 6c 20 6f 72 69 r at natural ori
1c40: 67 69 6e 22 2c 30 2e 39 39 39 36 2c 0d 0a 20 20 gin",0.9996,..
1c50: 20 20 20 20 20 20 20 20 20 20 53 43 41 4c 45 55 SCALEU
1c60: 4e 49 54 5b 22 75 6e 69 74 79 22 2c 31 5d 2c 0d NIT["unity",1],.
1c70: 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 44 5b . ID[
1c80: 22 45 50 53 47 22 2c 38 38 30 35 5d 5d 2c 0d 0a "EPSG",8805]],..
1c90: 20 20 20 20 20 20 20 20 50 41 52 41 4d 45 54 45 PARAMETE
1ca0: 52 5b 22 46 61 6c 73 65 20 65 61 73 74 69 6e 67 R["False easting
1cb0: 22 2c 31 35 30 30 30 30 30 2c 0d 0a 20 20 20 20 ",1500000,..
1cc0: 20 20 20 20 20 20 20 20 4c 45 4e 47 54 48 55 4e LENGTHUN
1cd0: 49 54 5b 22 6d 65 74 72 65 22 2c 31 5d 2c 0d 0a IT["metre",1],..
1ce0: 20 20 20 20 20 20 20 20 20 20 20 20 49 44 5b 22 ID["
1cf0: 45 50 53 47 22 2c 38 38 30 36 5d 5d 2c 0d 0a 20 EPSG",8806]],..
1d00: 20 20 20 20 20 20 20 50 41 52 41 4d 45 54 45 52 PARAMETER
1d10: 5b 22 46 61 6c 73 65 20 6e 6f 72 74 68 69 6e 67 ["False northing
1d20: 22 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 ",0,..
1d30: 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 LENGTHUNIT["me
1d40: 74 72 65 22 2c 31 5d 2c 0d 0a 20 20 20 20 20 20 tre",1],..
1d50: 20 20 20 20 20 20 49 44 5b 22 45 50 53 47 22 2c ID["EPSG",
1d60: 38 38 30 37 5d 5d 5d 2c 0d 0a 20 20 20 20 43 53 8807]]],.. CS
1d70: 5b 43 61 72 74 65 73 69 61 6e 2c 32 5d 2c 0d 0a [Cartesian,2],..
1d80: 20 20 20 20 20 20 20 20 41 58 49 53 5b 22 65 61 AXIS["ea
1d90: 73 74 69 6e 67 20 28 58 29 22 2c 65 61 73 74 2c sting (X)",east,
1da0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4f 52 .. OR
1db0: 44 45 52 5b 31 5d 2c 0d 0a 20 20 20 20 20 20 20 DER[1],..
1dc0: 20 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b LENGTHUNIT[
1dd0: 22 6d 65 74 72 65 22 2c 31 5d 5d 2c 0d 0a 20 20 "metre",1]],..
1de0: 20 20 20 20 20 20 41 58 49 53 5b 22 6e 6f 72 74 AXIS["nort
1df0: 68 69 6e 67 20 28 59 29 22 2c 6e 6f 72 74 68 2c hing (Y)",north,
1e00: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4f 52 .. OR
1e10: 44 45 52 5b 32 5d 2c 3c 62 72 3e 0d 0a 20 20 20 DER[2],<br>..
1e20: 20 20 20 20 20 20 20 20 20 4c 45 4e 47 54 48 55 LENGTHU
1e30: 4e 49 54 5b 22 6d 65 74 72 65 22 2c 31 5d 5d 2c NIT["metre",1]],
1e40: 0d 0a 20 20 20 20 41 52 45 41 5b 22 49 74 61 6c .. AREA["Ital
1e50: 79 20 2d 20 77 65 73 74 20 6f 66 20 31 32 c2 b0 y - west of 12..
1e60: 45 22 5d 2c 0d 0a 20 20 20 20 42 42 4f 58 5b 33 E"],.. BBOX[3
1e70: 36 2e 35 33 2c 35 2e 39 34 2c 34 37 2e 30 34 2c 6.53,5.94,47.04,
1e80: 31 32 5d 2c 0d 0a 20 20 20 20 49 44 5b 22 45 50 12],.. ID["EP
1e90: 53 47 22 2c 33 30 30 33 5d 5d 0d 0a 3c 2f 76 65 SG",3003]]..</ve
1ea0: 72 62 61 74 69 6d 3e 3c 2f 74 64 3e 0d 0a 3c 74 rbatim></td>..<t
1eb0: 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 3c d valign="top"><
1ec0: 76 65 72 62 61 74 69 6d 3e 0d 0a 47 45 4f 44 43 verbatim>..GEODC
1ed0: 52 53 5b 22 57 47 53 20 38 34 22 2c 0d 0a 20 20 RS["WGS 84",..
1ee0: 20 20 44 41 54 55 4d 5b 22 57 6f 72 6c 64 20 47 DATUM["World G
1ef0: 65 6f 64 65 74 69 63 20 53 79 73 74 65 6d 20 31 eodetic System 1
1f00: 39 38 34 22 2c 0d 0a 20 20 20 20 20 20 20 20 45 984",.. E
1f10: 4c 4c 49 50 53 4f 49 44 5b 22 57 47 53 20 38 34 LLIPSOID["WGS 84
1f20: 22 2c 36 33 37 38 31 33 37 2c 32 39 38 2e 32 35 ",6378137,298.25
1f30: 37 32 32 33 35 36 33 2c 0d 0a 20 20 20 20 20 20 7223563,..
1f40: 20 20 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 LENGTHUNIT
1f50: 5b 22 6d 65 74 72 65 22 2c 31 5d 5d 5d 2c 0d 0a ["metre",1]]],..
1f60: 20 20 20 20 50 52 49 4d 45 4d 5b 22 47 72 65 65 PRIMEM["Gree
1f70: 6e 77 69 63 68 22 2c 30 2c 0d 0a 20 20 20 20 20 nwich",0,..
1f80: 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 ANGLEUNIT["de
1f90: 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 gree",0.01745329
1fa0: 32 35 31 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 25199433]],..
1fb0: 20 43 53 5b 65 6c 6c 69 70 73 6f 69 64 61 6c 2c CS[ellipsoidal,
1fc0: 32 5d 2c 0d 0a 20 20 20 20 20 20 20 20 41 58 49 2],.. AXI
1fd0: 53 5b 22 67 65 6f 64 65 74 69 63 20 6c 61 74 69 S["geodetic lati
1fe0: 74 75 64 65 20 28 4c 61 74 29 22 2c 6e 6f 72 74 tude (Lat)",nort
1ff0: 68 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 h,..
2000: 4f 52 44 45 52 5b 31 5d 2c 0d 0a 20 20 20 20 20 ORDER[1],..
2010: 20 20 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 ANGLEUNIT
2020: 5b 22 64 65 67 72 65 65 22 2c 30 2e 30 31 37 34 ["degree",0.0174
2030: 35 33 32 39 32 35 31 39 39 34 33 33 5d 5d 2c 0d 532925199433]],.
2040: 0a 20 20 20 20 20 20 20 20 41 58 49 53 5b 22 67 . AXIS["g
2050: 65 6f 64 65 74 69 63 20 6c 6f 6e 67 69 74 75 64 eodetic longitud
2060: 65 20 28 4c 6f 6e 29 22 2c 65 61 73 74 2c 0d 0a e (Lon)",east,..
2070: 20 20 20 20 20 20 20 20 20 20 20 20 4f 52 44 45 ORDE
2080: 52 5b 32 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 R[2],..
2090: 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 ANGLEUNIT["de
20a0: 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 gree",0.01745329
20b0: 32 35 31 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 25199433]],..
20c0: 20 41 52 45 41 5b 22 57 6f 72 6c 64 22 5d 2c 0d AREA["World"],.
20d0: 0a 20 20 20 20 42 42 4f 58 5b 2d 39 30 2c 2d 31 . BBOX[-90,-1
20e0: 38 30 2c 39 30 2c 31 38 30 5d 2c 0d 0a 20 20 20 80,90,180],..
20f0: 20 49 44 5b 22 45 50 53 47 22 2c 34 33 32 36 5d ID["EPSG",4326]
2100: 5d 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 3c 2f ]..</verbatim></
2110: 74 64 3e 0d 0a 3c 74 64 20 76 61 6c 69 67 6e 3d td>..<td valign=
2120: 22 74 6f 70 22 3e 3c 76 65 72 62 61 74 69 6d 3e "top"><verbatim>
2130: 0d 0a 50 52 4f 4a 43 52 53 5b 22 57 47 53 20 38 ..PROJCRS["WGS 8
2140: 34 20 2f 20 55 54 4d 20 7a 6f 6e 65 20 33 32 4e 4 / UTM zone 32N
2150: 22 2c 0d 0a 20 20 20 20 42 41 53 45 47 45 4f 44 ",.. BASEGEOD
2160: 43 52 53 5b 22 57 47 53 20 38 34 22 2c 0d 0a 20 CRS["WGS 84",..
2170: 20 20 20 20 20 20 20 44 41 54 55 4d 5b 22 57 6f DATUM["Wo
2180: 72 6c 64 20 47 65 6f 64 65 74 69 63 20 53 79 73 rld Geodetic Sys
2190: 74 65 6d 20 31 39 38 34 22 2c 0d 0a 20 20 20 20 tem 1984",..
21a0: 20 20 20 20 20 20 20 20 45 4c 4c 49 50 53 4f 49 ELLIPSOI
21b0: 44 5b 22 57 47 53 20 38 34 22 2c 36 33 37 38 31 D["WGS 84",63781
21c0: 33 37 2c 32 39 38 2e 32 35 37 32 32 33 35 36 33 37,298.257223563
21d0: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ,..
21e0: 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d LENGTHUNIT["m
21f0: 65 74 72 65 22 2c 31 5d 5d 5d 2c 0d 0a 20 20 20 etre",1]]],..
2200: 20 20 20 20 20 50 52 49 4d 45 4d 5b 22 47 72 65 PRIMEM["Gre
2210: 65 6e 77 69 63 68 22 2c 30 2c 0d 0a 20 20 20 20 enwich",0,..
2220: 20 20 20 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 ANGLEUNI
2230: 54 5b 22 64 65 67 72 65 65 22 2c 30 2e 30 31 37 T["degree",0.017
2240: 34 35 33 32 39 32 35 31 39 39 34 33 33 5d 5d 5d 4532925199433]]]
2250: 2c 0d 0a 20 20 20 20 43 4f 4e 56 45 52 53 49 4f ,.. CONVERSIO
2260: 4e 5b 22 55 54 4d 20 7a 6f 6e 65 20 33 32 4e 22 N["UTM zone 32N"
2270: 2c 0d 0a 20 20 20 20 20 20 20 20 4d 45 54 48 4f ,.. METHO
2280: 44 5b 22 54 72 61 6e 73 76 65 72 73 65 20 4d 65 D["Transverse Me
2290: 72 63 61 74 6f 72 22 2c 0d 0a 20 20 20 20 20 20 rcator",..
22a0: 20 20 20 20 20 20 49 44 5b 22 45 50 53 47 22 2c ID["EPSG",
22b0: 39 38 30 37 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 9807]],..
22c0: 20 50 41 52 41 4d 45 54 45 52 5b 22 4c 61 74 69 PARAMETER["Lati
22d0: 74 75 64 65 20 6f 66 20 6e 61 74 75 72 61 6c 20 tude of natural
22e0: 6f 72 69 67 69 6e 22 2c 30 2c 0d 0a 20 20 20 20 origin",0,..
22f0: 20 20 20 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 ANGLEUNI
2300: 54 5b 22 64 65 67 72 65 65 22 2c 30 2e 30 31 37 T["degree",0.017
2310: 34 35 33 32 39 32 35 31 39 39 34 33 33 5d 2c 0d 4532925199433],.
2320: 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 44 5b . ID[
2330: 22 45 50 53 47 22 2c 38 38 30 31 5d 5d 2c 0d 0a "EPSG",8801]],..
2340: 20 20 20 20 20 20 20 20 50 41 52 41 4d 45 54 45 PARAMETE
2350: 52 5b 22 4c 6f 6e 67 69 74 75 64 65 20 6f 66 20 R["Longitude of
2360: 6e 61 74 75 72 61 6c 20 6f 72 69 67 69 6e 22 2c natural origin",
2370: 39 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 9,..
2380: 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 ANGLEUNIT["degre
2390: 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 e",0.01745329251
23a0: 39 39 34 33 33 5d 2c 0d 0a 20 20 20 20 20 20 20 99433],..
23b0: 20 20 20 20 20 49 44 5b 22 45 50 53 47 22 2c 38 ID["EPSG",8
23c0: 38 30 32 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 802]],..
23d0: 50 41 52 41 4d 45 54 45 52 5b 22 53 63 61 6c 65 PARAMETER["Scale
23e0: 20 66 61 63 74 6f 72 20 61 74 20 6e 61 74 75 72 factor at natur
23f0: 61 6c 20 6f 72 69 67 69 6e 22 2c 30 2e 39 39 39 al origin",0.999
2400: 36 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 6,..
2410: 53 43 41 4c 45 55 4e 49 54 5b 22 75 6e 69 74 79 SCALEUNIT["unity
2420: 22 2c 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 ",1],..
2430: 20 20 20 49 44 5b 22 45 50 53 47 22 2c 38 38 30 ID["EPSG",880
2440: 35 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 41 5]],.. PA
2450: 52 41 4d 45 54 45 52 5b 22 46 61 6c 73 65 20 65 RAMETER["False e
2460: 61 73 74 69 6e 67 22 2c 35 30 30 30 30 30 2c 0d asting",500000,.
2470: 0a 20 20 20 20 20 20 20 20 20 20 20 20 4c 45 4e . LEN
2480: 47 54 48 55 4e 49 54 5b 22 6d 65 74 72 65 22 2c GTHUNIT["metre",
2490: 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 1],..
24a0: 20 49 44 5b 22 45 50 53 47 22 2c 38 38 30 36 5d ID["EPSG",8806]
24b0: 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 41 52 41 ],.. PARA
24c0: 4d 45 54 45 52 5b 22 46 61 6c 73 65 20 6e 6f 72 METER["False nor
24d0: 74 68 69 6e 67 22 2c 30 2c 0d 0a 20 20 20 20 20 thing",0,..
24e0: 20 20 20 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 LENGTHUNI
24f0: 54 5b 22 6d 65 74 72 65 22 2c 31 5d 2c 0d 0a 20 T["metre",1],..
2500: 20 20 20 20 20 20 20 20 20 20 20 49 44 5b 22 45 ID["E
2510: 50 53 47 22 2c 38 38 30 37 5d 5d 5d 2c 0d 0a 20 PSG",8807]]],..
2520: 20 20 20 43 53 5b 43 61 72 74 65 73 69 61 6e 2c CS[Cartesian,
2530: 32 5d 2c 0d 0a 20 20 20 20 20 20 20 20 41 58 49 2],.. AXI
2540: 53 5b 22 28 45 29 22 2c 65 61 73 74 2c 0d 0a 20 S["(E)",east,..
2550: 20 20 20 20 20 20 20 20 20 20 20 4f 52 44 45 52 ORDER
2560: 5b 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 [1],..
2570: 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 LENGTHUNIT["me
2580: 74 72 65 22 2c 31 5d 5d 2c 0d 0a 20 20 20 20 20 tre",1]],..
2590: 20 20 20 41 58 49 53 5b 22 28 4e 29 22 2c 6e 6f AXIS["(N)",no
25a0: 72 74 68 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 rth,..
25b0: 20 20 4f 52 44 45 52 5b 32 5d 2c 0d 0a 20 20 20 ORDER[2],..
25c0: 20 20 20 20 20 20 20 20 20 4c 45 4e 47 54 48 55 LENGTHU
25d0: 4e 49 54 5b 22 6d 65 74 72 65 22 2c 31 5d 5d 2c NIT["metre",1]],
25e0: 0d 0a 20 20 20 20 41 52 45 41 5b 22 57 6f 72 6c .. AREA["Worl
25f0: 64 20 2d 20 4e 20 68 65 6d 69 73 70 68 65 72 65 d - N hemisphere
2600: 20 2d 20 36 c2 b0 45 20 74 6f 20 31 32 c2 b0 45 - 6..E to 12..E
2610: 20 2d 20 62 79 20 63 6f 75 6e 74 72 79 22 5d 2c - by country"],
2620: 0d 0a 20 20 20 20 42 42 4f 58 5b 30 2c 36 2c 38 .. BBOX[0,6,8
2630: 34 2c 31 32 5d 2c 0d 0a 20 20 20 20 49 44 5b 22 4,12],.. ID["
2640: 45 50 53 47 22 2c 33 32 36 33 32 5d 5d 0d 0a 3c EPSG",32632]]..<
2650: 2f 76 65 72 62 61 74 69 6d 3e 3c 2f 74 64 3e 0d /verbatim></td>.
2660: 0a 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e .</tr>..</table>
2670: 0d 0a 3c 62 72 3e 0d 0a 41 73 20 79 6f 75 20 63 ..<br>..As you c
2680: 61 6e 20 65 61 73 69 6c 79 20 6e 6f 74 69 63 65 an easily notice
2690: 2c 20 74 68 65 20 74 77 6f 20 6e 6f 74 61 74 69 , the two notati
26a0: 6f 6e 73 20 61 72 65 20 70 72 6f 66 6f 75 6e 64 ons are profound
26b0: 6c 79 20 64 69 66 66 65 72 65 6e 74 2e 0d 0a 54 ly different...T
26c0: 68 65 20 6f 6c 64 20 3c 62 3e 70 72 6f 6a 2d 73 he old <b>proj-s
26d0: 74 72 69 6e 67 3c 2f 62 3e 20 6e 6f 74 61 74 69 tring</b> notati
26e0: 6f 6e 20 69 73 20 65 78 74 72 65 6d 65 6c 79 20 on is extremely
26f0: 63 6f 6e 63 69 73 65 20 61 6e 64 20 72 6f 75 67 concise and roug
2700: 68 2c 20 77 68 69 6c 73 74 20 74 68 65 20 6e 65 h, whilst the ne
2710: 77 20 3c 62 3e 49 53 4f 2d 57 4b 54 3c 2f 62 3e w <b>ISO-WKT</b>
2720: 20 69 73 20 76 65 72 62 6f 73 65 20 62 75 74 20 is verbose but
2730: 65 78 68 61 75 73 74 69 76 65 2c 20 64 65 74 61 exhaustive, deta
2740: 69 6c 65 64 20 61 6e 64 20 70 72 65 63 69 73 65 iled and precise
2750: 2e 3c 62 72 3e 0d 0a 54 68 65 72 65 20 69 73 20 .<br>..There is
2760: 6e 6f 20 70 6f 73 73 69 62 6c 65 20 6d 61 74 63 no possible matc
2770: 68 3a 20 49 53 4f 2d 57 4b 54 20 69 73 20 63 6c h: ISO-WKT is cl
2780: 65 61 72 6c 79 20 73 75 70 65 72 69 6f 72 20 61 early superior a
2790: 6e 64 20 6d 6f 72 65 20 73 6f 70 68 69 73 74 69 nd more sophisti
27a0: 63 61 74 65 64 20 75 6e 64 65 72 20 61 6e 79 20 cated under any
27b0: 70 6f 73 73 69 62 6c 65 20 61 73 70 65 63 74 2e possible aspect.
27c0: 3c 62 72 3e 0d 0a 4e 6f 74 20 61 74 20 61 6c 6c <br>..Not at all
27d0: 20 73 75 72 70 72 69 73 69 6e 67 6c 79 2c 20 63 surprisingly, c
27e0: 6f 6f 72 64 69 6e 61 74 65 20 74 72 61 6e 73 66 oordinate transf
27f0: 6f 72 6d 61 74 69 6f 6e 73 20 62 61 73 65 64 20 ormations based
2800: 6f 6e 20 49 53 4f 2d 57 4b 54 20 64 65 66 69 6e on ISO-WKT defin
2810: 69 74 69 6f 6e 73 20 28 69 6e 73 74 65 61 64 20 itions (instead
2820: 6f 66 20 70 72 6f 6a 2d 73 74 72 69 6e 67 73 29 of proj-strings)
2830: 20 61 72 65 20 75 73 75 61 6c 6c 79 20 65 78 70 are usually exp
2840: 65 63 74 65 64 20 74 6f 20 62 65 20 6d 6f 72 65 ected to be more
2850: 20 61 63 63 75 72 61 74 65 2e 3c 62 72 3e 3c 62 accurate.<br><b
2860: 72 3e 0d 0a 41 6e 64 20 74 68 61 74 27 73 20 6e r>..And that's n
2870: 6f 74 20 61 6c 6c 3b 20 74 68 65 20 6f 6c 64 20 ot all; the old
2880: 3c 62 3e 70 72 6f 6a 2d 73 74 72 69 6e 67 73 3c <b>proj-strings<
2890: 2f 62 3e 20 77 65 72 65 6e 27 74 20 66 6f 72 6d /b> weren't form
28a0: 61 6c 6c 79 20 64 65 66 69 6e 65 64 20 62 79 20 ally defined by
28b0: 61 6e 79 20 73 74 61 6e 64 61 72 64 2c 20 61 6e any standard, an
28c0: 64 20 6f 6e 6c 79 20 50 52 4f 4a 2c 20 47 44 41 d only PROJ, GDA
28d0: 4c 20 61 6e 64 20 66 65 77 20 6f 74 68 65 72 20 L and few other
28e0: 46 4c 4f 53 53 20 2f 20 47 46 4f 53 53 20 69 6d FLOSS / GFOSS im
28f0: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20 63 6f plementations co
2900: 75 6c 64 20 62 65 20 65 78 70 65 63 74 65 64 20 uld be expected
2910: 74 6f 20 75 6e 64 65 72 73 74 61 6e 64 20 74 68 to understand th
2920: 65 6d 2e 3c 62 72 3e 0d 0a 41 74 20 74 68 65 20 em.<br>..At the
2930: 6f 70 70 6f 73 69 74 65 2c 20 74 68 65 20 6e 65 opposite, the ne
2940: 77 20 3c 62 3e 49 53 4f 2d 57 4b 54 3c 2f 62 3e w <b>ISO-WKT</b>
2950: 20 69 73 20 66 6f 72 6d 61 6c 6c 79 20 64 65 66 is formally def
2960: 69 6e 65 64 20 62 79 20 61 6e 20 69 6e 74 65 72 ined by an inter
2970: 6e 61 74 69 6f 6e 61 6c 20 73 74 61 6e 64 61 72 national standar
2980: 64 2c 20 61 6e 64 20 61 6c 6d 6f 73 74 20 61 6c d, and almost al
2990: 6c 20 66 72 65 65 20 61 6e 64 20 70 72 6f 70 72 l free and propr
29a0: 69 65 74 61 72 79 20 69 6d 70 6c 65 6d 65 6e 74 ietary implement
29b0: 61 74 69 6f 6e 73 20 61 72 65 20 65 78 70 65 63 ations are expec
29c0: 74 65 64 20 74 6f 20 73 75 70 70 6f 72 74 20 69 ted to support i
29d0: 74 2e 3c 62 72 3e 0d 0a 54 68 69 73 20 69 73 20 t.<br>..This is
29e0: 61 20 76 65 72 79 20 72 65 6c 65 76 61 6e 74 20 a very relevant
29f0: 63 68 61 6e 67 65 20 74 68 61 74 20 65 6e 73 75 change that ensu
2a00: 72 65 73 20 61 20 72 6f 62 75 73 74 20 63 6f 6d res a robust com
2a10: 70 61 74 69 62 69 6c 69 74 79 20 62 65 74 77 65 patibility betwe
2a20: 65 6e 20 64 69 66 66 65 72 65 6e 74 20 61 70 70 en different app
2a30: 6c 69 63 61 74 69 6f 6e 73 2e 3c 62 72 3e 3c 62 lications.<br><b
2a40: 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 r>..<table cells
2a50: 70 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 pacing="8" cellp
2a60: 61 64 64 69 6e 67 3d 22 31 36 22 20 62 67 63 6f adding="16" bgco
2a70: 6c 6f 72 3d 22 23 66 66 66 66 65 39 22 3e 0d 0a lor="#ffffe9">..
2a80: 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 62 3e 3c 75 3e <tr><td>..<b><u>
2a90: 49 6d 70 6f 72 74 61 6e 74 20 6e 6f 74 69 63 65 Important notice
2aa0: 3c 2f 75 3e 3c 2f 62 3e 3a 20 74 68 65 72 65 20 </u></b>: there
2ab0: 61 72 65 20 73 65 76 65 72 61 6c 20 64 69 61 6c are several dial
2ac0: 65 63 74 73 20 69 6e 20 74 68 65 20 57 4b 54 20 ects in the WKT
2ad0: 6e 6f 74 61 74 69 6f 6e 20 64 65 73 63 72 69 62 notation describ
2ae0: 69 6e 67 20 43 52 53 65 73 2e 3c 62 72 3e 0d 0a ing CRSes.<br>..
2af0: 41 6c 6c 20 74 68 65 6d 20 73 68 61 72 65 20 74 All them share t
2b00: 68 65 20 73 61 6d 65 20 63 6f 6d 6d 6f 6e 20 63 he same common c
2b10: 6f 72 65 20 61 6e 64 20 6d 61 69 6e 6c 79 20 64 ore and mainly d
2b20: 69 66 66 65 72 20 69 6e 20 66 65 77 20 6d 69 6e iffer in few min
2b30: 6f 72 20 64 65 74 61 69 6c 73 2e 3c 62 72 3e 0d or details.<br>.
2b40: 0a 50 52 4f 4a 2e 36 20 63 61 6e 20 75 6e 64 65 .PROJ.6 can unde
2b50: 72 73 74 61 6e 64 20 74 68 65 20 66 6f 6c 6c 6f rstand the follo
2b60: 77 69 6e 67 20 64 69 61 6c 65 63 74 73 3a 0d 0a wing dialects:..
2b70: 3c 6f 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 45 53 52 <ol>..<li><b>ESR
2b80: 49 20 57 4b 54 3c 2f 62 3e 3a 20 61 20 64 69 61 I WKT</b>: a dia
2b90: 6c 65 63 74 20 77 69 64 65 6c 79 20 61 64 6f 70 lect widely adop
2ba0: 74 65 64 20 62 79 20 45 53 52 49 20 70 72 6f 70 ted by ESRI prop
2bb0: 72 69 65 74 61 72 79 20 73 6f 66 74 77 61 72 65 rietary software
2bc0: 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 47 .</li>..<li><b>G
2bd0: 44 41 4c 20 57 4b 54 31 3c 2f 62 3e 3a 20 61 20 DAL WKT1</b>: a
2be0: 64 69 61 6c 65 63 74 20 68 69 73 74 6f 72 69 63 dialect historic
2bf0: 61 6c 6c 79 20 73 75 70 70 6f 72 74 65 64 20 62 ally supported b
2c00: 79 20 74 68 65 20 6f 70 65 6e 20 73 6f 75 72 63 y the open sourc
2c10: 65 20 47 44 41 4c 20 6c 69 62 72 61 72 79 2e 3c e GDAL library.<
2c20: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 57 4b 54 /li>..<li><b>WKT
2c30: 32 3a 32 30 31 35 3c 2f 62 3e 3a 20 61 73 20 64 2:2015</b>: as d
2c40: 65 66 69 6e 65 64 20 62 79 20 3c 62 3e 49 53 4f efined by <b>ISO
2c50: 20 31 39 31 36 32 3a 32 30 31 35 3c 2f 62 3e 20 19162:2015</b>
2c60: 73 74 61 6e 64 61 72 64 20 73 70 65 63 69 66 69 standard specifi
2c70: 63 61 74 69 6f 6e 20 28 6e 6f 77 20 73 75 70 65 cation (now supe
2c80: 72 73 65 64 65 64 29 2e 3c 2f 6c 69 3e 0d 0a 3c rseded).</li>..<
2c90: 6c 69 3e 3c 62 3e 57 4b 54 32 3a 32 30 31 38 3c li><b>WKT2:2018<
2ca0: 2f 62 3e 3a 20 61 73 20 64 65 66 69 6e 65 64 20 /b>: as defined
2cb0: 62 79 20 74 68 65 20 6d 6f 72 65 20 72 65 63 65 by the more rece
2cc0: 6e 74 20 3c 62 3e 49 53 4f 20 31 39 31 36 32 3a nt <b>ISO 19162:
2cd0: 32 30 31 38 3c 2f 62 3e 20 73 74 61 6e 64 61 72 2018</b> standar
2ce0: 64 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 20 d specification
2cf0: 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 6f 6c 3e 0d 0a 3c .</li>..</ol>..<
2d00: 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 /td></tr>..</tab
2d10: 6c 65 3e 3c 62 72 3e 0d 0a 3c 68 33 3e 54 68 65 le><br>..<h3>The
2d20: 20 70 72 69 76 61 74 65 20 53 51 4c 69 74 65 20 private SQLite
2d30: 64 61 74 61 62 61 73 65 20 73 75 70 70 6f 72 74 database support
2d40: 69 6e 67 20 50 52 4f 4a 2e 36 3c 2f 68 33 3e 0d ing PROJ.6</h3>.
2d50: 0a 53 74 61 72 74 69 6e 67 20 73 69 6e 63 65 20 .Starting since
2d60: 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 20 74 68 <b>PROJ.6</b> th
2d70: 65 20 50 52 4f 4a 20 6c 69 62 72 61 72 79 20 69 e PROJ library i
2d80: 73 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 61 s supported by a
2d90: 20 70 72 69 76 61 74 65 20 53 51 4c 69 74 65 20 private SQLite
2da0: 64 61 74 61 62 61 73 65 20 63 6f 6e 74 61 69 6e database contain
2db0: 69 6e 67 20 61 6c 6c 20 64 65 66 69 6e 69 74 69 ing all definiti
2dc0: 6f 6e 73 20 61 62 6f 75 74 20 73 75 70 70 6f 72 ons about suppor
2dd0: 74 65 64 20 43 52 53 65 73 2c 20 45 6c 6c 69 70 ted CRSes, Ellip
2de0: 73 6f 69 64 73 2c 20 50 72 69 6d 65 20 4d 65 72 soids, Prime Mer
2df0: 69 64 69 61 6e 73 2c 20 55 6e 69 74 73 20 6f 66 idians, Units of
2e00: 20 4d 65 61 73 75 72 65 2c 20 43 6f 6e 76 65 72 Measure, Conver
2e10: 73 69 6f 6e 73 2c 20 54 72 61 6e 73 66 6f 72 6d sions, Transform
2e20: 61 74 69 6f 6e 73 20 61 6e 64 20 61 6c 69 6b 65 ations and alike
2e30: 2e 3c 62 72 3e 0d 0a 3c 62 3e 3c 75 3e 4e 6f 74 .<br>..<b><u>Not
2e40: 65 3c 2f 75 3e 3c 2f 62 3e 3a 20 6d 61 6e 79 20 e</u></b>: many
2e50: 6f 66 20 74 68 65 20 6e 65 77 20 61 64 76 61 6e of the new advan
2e60: 63 65 64 20 50 52 4f 4a 2e 36 20 66 65 61 74 75 ced PROJ.6 featu
2e70: 72 65 73 20 77 69 6c 6c 20 66 61 69 6c 20 69 66 res will fail if
2e80: 20 73 75 63 68 20 64 61 74 61 62 61 73 65 20 69 such database i
2e90: 73 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 s not available
2ea0: 61 74 20 72 75 6e 20 74 69 6d 65 2e 0d 0a 3c 68 at run time...<h
2eb0: 33 3e 44 69 72 65 63 74 20 74 72 61 6e 73 66 6f 3>Direct transfo
2ec0: 72 6d 61 74 69 6f 6e 73 20 66 72 6f 6d 20 43 52 rmations from CR
2ed0: 53 20 74 6f 20 43 52 53 3c 2f 68 33 3e 0d 0a 44 S to CRS</h3>..D
2ee0: 69 66 66 65 72 65 6e 74 6c 79 20 66 72 6f 6d 20 ifferently from
2ef0: 61 6c 6c 20 70 72 65 76 69 6f 75 73 20 76 65 72 all previous ver
2f00: 73 69 6f 6e 73 2c 20 50 52 4f 4a 2e 36 20 63 61 sions, PROJ.6 ca
2f10: 6e 20 6e 6f 77 20 61 70 70 6c 79 20 61 6e 79 20 n now apply any
2f20: 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 66 transformation f
2f30: 72 6f 6d 20 61 20 43 52 53 20 74 6f 20 61 6e 6f rom a CRS to ano
2f40: 74 68 65 72 20 77 69 74 68 6f 75 74 20 72 65 71 ther without req
2f50: 75 69 72 69 6e 67 20 74 6f 20 73 70 65 63 69 66 uiring to specif
2f60: 79 20 61 6e 79 20 3c 62 3e 3c 69 3e 70 72 6f 6a y any <b><i>proj
2f70: 2d 73 74 72 69 6e 67 3c 2f 69 3e 3c 2f 62 3e 20 -string</i></b>
2f80: 6f 72 20 3c 62 3e 3c 69 3e 57 4b 54 20 65 78 70 or <b><i>WKT exp
2f90: 72 65 73 73 69 6f 6e 3c 2f 69 3e 3c 2f 62 3e 20 ression</i></b>
2fa0: 71 75 61 6c 69 66 79 69 6e 67 20 65 61 63 68 20 qualifying each
2fb0: 43 52 53 2e 3c 62 72 3e 0d 0a 54 68 69 73 20 69 CRS.<br>..This i
2fc0: 73 20 62 65 63 61 75 73 65 20 50 52 4f 4a 2e 36 s because PROJ.6
2fd0: 20 69 73 20 6e 6f 77 20 63 61 70 61 62 6c 65 20 is now capable
2fe0: 74 6f 20 72 65 74 72 69 65 76 65 20 61 6e 79 20 to retrieve any
2ff0: 43 52 53 20 64 65 66 69 6e 69 74 69 6f 6e 20 64 CRS definition d
3000: 69 72 65 63 74 6c 79 0d 0a 66 72 6f 6d 20 69 74 irectly..from it
3010: 73 20 6f 77 6e 20 70 72 69 76 61 74 65 20 53 51 s own private SQ
3020: 4c 69 74 65 20 64 61 74 61 62 61 73 65 2c 20 61 Lite database, a
3030: 6e 64 20 63 6f 6e 73 65 71 75 65 6e 74 6c 79 20 nd consequently
3040: 65 61 63 68 20 43 52 53 20 63 61 6e 20 62 65 20 each CRS can be
3050: 66 75 6c 6c 79 20 69 64 65 6e 74 69 66 69 65 64 fully identified
3060: 20 62 79 20 73 69 6d 70 6c 79 20 73 70 65 63 69 by simply speci
3070: 66 79 69 6e 67 20 69 74 73 20 73 79 6d 62 6f 6c fying its symbol
3080: 69 63 20 6e 61 6d 65 2c 20 61 73 20 69 6e 3a 0d ic name, as in:.
3090: 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 45 50 .<ul>..<li><b>EP
30a0: 53 47 3a 34 33 32 36 3c 2f 62 3e 3c 2f 6c 69 3e SG:4326</b></li>
30b0: 0d 0a 3c 6c 69 3e 6f 72 20 61 6c 74 65 72 6e 61 ..<li>or alterna
30c0: 74 69 76 65 6c 79 3c 2f 6c 69 3e 0d 0a 3c 6c 69 tively</li>..<li
30d0: 3e 3c 62 3e 75 72 6e 3a 6f 67 63 3a 64 65 66 3a ><b>urn:ogc:def:
30e0: 63 72 73 3a 45 50 53 47 3a 3a 34 33 32 36 3c 2f crs:EPSG::4326</
30f0: 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a b></li>..</ul>..
3100: 3c 68 33 3e 53 75 70 70 6f 72 74 69 6e 67 20 73 <h3>Supporting s
3110: 70 65 63 69 66 69 63 20 61 72 65 61 73 20 6f 66 pecific areas of
3120: 20 75 73 65 3c 2f 68 33 3e 0d 0a 3c 74 61 62 6c use</h3>..<tabl
3130: 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 e cellspacing="8
3140: 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 38 " cellpadding="8
3150: 22 20 62 67 63 6f 6c 6f 72 3d 22 23 65 38 66 66 " bgcolor="#e8ff
3160: 65 38 22 20 62 6f 72 64 65 72 3d 22 31 22 3e 0d e8" border="1">.
3170: 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 50 52 4f 4a 2e .<tr><td>..PROJ.
3180: 36 20 69 73 20 6e 6f 77 20 61 62 6c 65 20 74 6f 6 is now able to
3190: 20 6d 61 6b 65 20 61 20 64 69 73 74 69 6e 63 74 make a distinct
31a0: 69 6f 6e 20 62 65 74 77 65 65 6e 20 64 69 66 66 ion between diff
31b0: 65 72 65 6e 74 20 3c 62 3e 61 72 65 61 73 20 6f erent <b>areas o
31c0: 66 20 75 73 65 3c 2f 62 3e 20 77 69 74 68 69 6e f use</b> within
31d0: 20 61 20 43 52 53 2c 20 61 6e 64 20 63 61 6e 20 a CRS, and can
31e0: 65 76 65 6e 74 75 61 6c 6c 79 20 61 70 70 6c 79 eventually apply
31f0: 20 74 68 65 20 6d 6f 73 74 20 61 70 70 72 6f 70 the most approp
3200: 72 69 61 74 65 20 74 72 61 6e 73 66 6f 72 6d 61 riate transforma
3210: 74 69 6f 6e 20 77 68 65 6e 20 74 68 65 20 69 6e tion when the in
3220: 74 65 6e 64 65 64 20 61 72 65 61 2d 6f 66 2d 75 tended area-of-u
3230: 73 65 20 69 73 20 65 78 70 6c 69 63 69 74 6c 79 se is explicitly
3240: 20 73 70 65 63 69 66 69 65 64 2c 20 74 68 75 73 specified, thus
3250: 20 6c 65 61 64 69 6e 67 20 74 6f 20 6d 6f 72 65 leading to more
3260: 20 70 72 65 63 69 73 65 20 72 65 73 75 6c 74 73 precise results
3270: 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 54 68 65 20 73 .<br><br>..The s
3280: 69 64 65 20 66 69 67 75 72 65 20 73 68 6f 77 73 ide figure shows
3290: 20 74 68 65 20 73 69 74 75 61 74 69 6f 6e 20 66 the situation f
32a0: 6f 72 20 74 68 65 20 49 74 61 6c 69 61 6e 20 70 or the Italian p
32b0: 65 6e 69 6e 73 75 6c 61 2e 3c 62 72 3e 0d 0a 41 eninsula.<br>..A
32c0: 73 20 79 6f 75 20 63 61 6e 20 6e 6f 74 69 63 65 s you can notice
32d0: 20 74 68 65 72 65 20 61 72 65 20 74 77 6f 20 6d there are two m
32e0: 61 69 6e 20 61 72 65 61 73 20 28 3c 62 3e 3c 69 ain areas (<b><i
32f0: 3e 45 61 73 74 3c 2f 69 3e 3c 2f 62 3e 20 61 6e >East</i></b> an
3300: 64 20 3c 62 3e 3c 69 3e 57 65 73 74 3c 2f 69 3e d <b><i>West</i>
3310: 3c 2f 62 3e 20 6f 66 20 6c 6f 6e 67 69 74 75 64 </b> of longitud
3320: 65 20 3c 62 3e 31 32 45 3c 2f 62 3e 29 2c 20 62 e <b>12E</b>), b
3330: 75 74 20 74 68 65 72 65 20 61 72 65 20 73 65 76 ut there are sev
3340: 65 72 61 6c 20 73 6d 61 6c 6c 65 72 20 61 72 65 eral smaller are
3350: 61 73 20 63 6f 76 65 72 69 6e 67 20 73 70 65 63 as covering spec
3360: 69 66 69 63 20 72 65 67 69 6f 6e 73 2e 0d 0a 3c ific regions...<
3370: 75 6c 3e 0d 0a 3c 6c 69 3e 54 68 65 20 74 77 6f ul>..<li>The two
3380: 20 6d 61 69 6e 20 61 72 65 61 73 20 63 6f 72 72 main areas corr
3390: 65 73 70 6f 6e 64 20 74 6f 20 3c 62 3e 45 50 53 espond to <b>EPS
33a0: 47 3a 33 30 30 33 20 3c 69 3e 4d 6f 6e 74 65 20 G:3003 <i>Monte
33b0: 4d 61 72 69 6f 20 2f 20 49 74 61 6c 79 20 7a 6f Mario / Italy zo
33c0: 6e 65 20 31 3c 2f 69 3e 3c 2f 62 3e 20 61 6e 64 ne 1</i></b> and
33d0: 20 3c 62 3e 45 50 53 47 3a 33 30 30 34 20 3c 69 <b>EPSG:3004 <i
33e0: 3e 4d 6f 6e 74 65 20 4d 61 72 69 6f 20 2f 20 49 >Monte Mario / I
33f0: 74 61 6c 79 20 7a 6f 6e 65 20 32 3c 2f 69 3e 3c taly zone 2</i><
3400: 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 54 /b>.</li>..<li>T
3410: 68 65 20 73 6d 61 6c 6c 65 73 74 20 61 72 65 61 he smallest area
3420: 73 20 63 6f 72 72 65 73 70 6f 6e 64 20 74 6f 20 s correspond to
3430: 74 68 65 20 6d 6f 72 65 20 73 70 65 63 69 66 69 the more specifi
3440: 63 20 3c 62 3e 3c 69 3e 61 72 65 61 73 20 6f 66 c <b><i>areas of
3450: 20 75 73 65 3c 2f 69 3e 3c 2f 62 3e 20 6e 6f 77 use</i></b> now
3460: 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 50 52 supported by PR
3470: 4f 4a 2e 36 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e OJ.6</li>..</ul>
3480: 3c 62 72 3e 0d 0a 49 66 20 79 6f 75 72 20 73 70 <br>..If your sp
3490: 65 63 69 66 69 63 20 61 72 65 61 20 6f 66 20 69 ecific area of i
34a0: 6e 74 65 72 65 73 74 20 69 73 20 63 6f 6e 74 61 nterest is conta
34b0: 69 6e 65 64 20 77 69 74 68 69 6e 20 6f 6e 65 20 ined within one
34c0: 6f 66 20 73 75 63 68 20 73 75 62 2d 72 65 67 69 of such sub-regi
34d0: 6f 6e 73 20 79 6f 75 20 63 61 6e 20 75 73 65 66 ons you can usef
34e0: 75 6c 6c 79 20 69 6e 66 6f 72 6d 20 50 52 4f 4a ully inform PROJ
34f0: 2e 36 20 61 62 6f 75 74 20 74 68 65 20 69 6e 74 .6 about the int
3500: 65 6e 64 65 64 20 42 42 4f 58 2c 20 61 6e 64 20 ended BBOX, and
3510: 74 68 65 6e 20 50 52 4f 4a 2e 36 20 77 69 6c 6c then PROJ.6 will
3520: 20 61 74 74 65 6d 70 74 20 74 6f 20 75 73 65 20 attempt to use
3530: 74 68 65 20 6d 6f 73 74 20 73 70 65 63 69 66 69 the most specifi
3540: 63 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e c transformation
3550: 20 70 61 72 61 6d 65 74 65 72 73 20 61 76 61 69 parameters avai
3560: 6c 61 62 6c 65 2e 3c 62 72 3e 3c 62 72 3e 0d 0a lable.<br><br>..
3570: 57 65 27 6c 6c 20 65 78 61 6d 69 6e 65 20 69 6e We'll examine in
3580: 20 6d 6f 72 65 20 64 65 70 74 68 20 74 68 69 73 more depth this
3590: 20 74 6f 70 69 63 20 6f 6e 20 66 6f 6c 6c 6f 77 topic on follow
35a0: 69 6e 67 20 73 65 63 74 69 6f 6e 73 2e 20 0d 0a ing sections. ..
35b0: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a 3c 69 6d </td>..<td>..<im
35c0: 67 20 73 72 63 3d 22 68 74 74 70 73 3a 2f 2f 77 g src="https://w
35d0: 77 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 2f 67 ww.gaia-gis.it/g
35e0: 61 69 61 2d 73 69 6e 73 2f 70 72 6f 6a 36 70 69 aia-sins/proj6pi
35f0: 63 73 2f 69 74 61 6c 79 2d 61 72 65 61 73 2d 6f cs/italy-areas-o
3600: 66 2d 75 73 65 2e 70 6e 67 22 20 61 6c 74 3d 22 f-use.png" alt="
3610: 69 74 61 6c 79 20 61 72 65 61 73 20 6f 66 20 75 italy areas of u
3620: 73 65 22 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e se">..</td></tr>
3630: 0d 0a 3c 2f 74 61 62 6c 65 3e 0d 0a 3c 62 72 3e ..</table>..<br>
3640: 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c <br>..<table cel
3650: 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65 6c lspacing="8" cel
3660: 6c 70 61 64 64 69 6e 67 3d 22 31 36 22 20 62 67 lpadding="16" bg
3670: 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 39 22 3e color="#ffffe9">
3680: 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 68 33 3e ..<tr><td>..<h3>
3690: 43 6f 6e 63 65 70 74 73 20 74 6f 20 6b 65 65 70 Concepts to keep
36a0: 20 77 65 6c 6c 20 69 6e 20 6d 69 6e 64 3c 2f 68 well in mind</h
36b0: 33 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 66 6f 3>..<ul>..<li>fo
36c0: 72 67 65 74 20 74 68 65 20 6f 6c 64 20 70 72 6f rget the old pro
36d0: 6a 2d 73 74 72 69 6e 67 73 3b 20 74 68 65 79 20 j-strings; they
36e0: 61 72 65 20 6e 6f 20 6c 6f 6e 67 65 72 20 74 68 are no longer th
36f0: 65 20 62 65 73 74 20 77 61 79 20 66 6f 72 20 74 e best way for t
3700: 61 6b 69 6e 67 20 66 75 6c 6c 20 70 72 6f 66 69 aking full profi
3710: 74 20 66 72 6f 6d 20 50 52 4f 4a 2e 36 3c 2f 6c t from PROJ.6</l
3720: 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 62 65 73 74 i>..<li>the best
3730: 20 77 61 79 20 74 6f 20 6d 61 6b 65 20 74 68 65 way to make the
3740: 20 6d 6f 73 74 20 6f 66 20 50 52 4f 4a 2e 36 20 most of PROJ.6
3750: 63 61 70 61 62 69 6c 69 74 69 65 73 20 69 73 20 capabilities is
3760: 62 79 20 6c 65 61 76 69 6e 67 20 74 68 65 20 6c by leaving the l
3770: 69 62 72 61 72 79 20 66 75 6c 6c 79 20 66 72 65 ibrary fully fre
3780: 65 20 74 6f 20 63 68 6f 6f 73 65 20 74 68 65 20 e to choose the
3790: 62 65 73 74 20 70 6f 73 73 69 62 6c 65 20 74 72 best possible tr
37a0: 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f ansformation fro
37b0: 6d 20 74 68 65 20 6f 72 69 67 69 6e 20 61 6e 64 m the origin and
37c0: 20 74 68 65 20 64 65 73 74 69 6e 61 74 69 6f 6e the destination
37d0: 20 43 52 53 65 73 2e 3c 62 72 3e 0d 0a 62 75 74 CRSes.<br>..but
37e0: 20 74 68 69 73 20 73 74 72 69 63 74 6c 79 20 72 this strictly r
37f0: 65 71 75 69 72 65 73 20 74 68 61 74 20 74 68 65 equires that the
3800: 20 6c 69 62 72 61 72 79 20 77 69 6c 6c 20 62 65 library will be
3810: 20 62 61 63 6b 65 64 20 75 70 20 62 79 20 69 74 backed up by it
3820: 73 20 6f 77 6e 20 70 72 69 76 61 74 65 20 64 61 s own private da
3830: 74 61 62 61 73 65 2e 3c 2f 6c 69 3e 0d 0a 3c 2f tabase.</li>..</
3840: 75 6c 3e 0d 0a 3c 68 33 3e 41 64 64 69 74 69 6f ul>..<h3>Additio
3850: 6e 61 6c 20 63 6f 6e 63 65 70 74 3c 2f 68 33 3e nal concept</h3>
3860: 0d 0a 54 68 65 20 74 72 61 64 69 74 69 6f 6e 61 ..The traditiona
3870: 6c 20 3c 62 3e 73 70 61 74 69 61 6c 5f 72 65 66 l <b>spatial_ref
3880: 5f 73 79 73 3c 2f 62 3e 20 74 61 62 6c 65 20 63 _sys</b> table c
3890: 6f 6e 74 61 69 6e 65 64 20 77 69 74 68 69 6e 20 ontained within
38a0: 61 6e 79 20 53 70 61 74 69 61 4c 69 74 65 20 44 any SpatiaLite D
38b0: 42 20 6e 6f 74 69 63 65 61 62 6c 79 20 63 68 61 B noticeably cha
38c0: 6e 67 65 73 20 69 74 73 20 69 6e 74 65 6e 64 65 nges its intende
38d0: 64 20 73 63 6f 70 65 20 69 6e 20 50 52 4f 4a 2e d scope in PROJ.
38e0: 36 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 6:..<ul>..<li><b
38f0: 3e 73 72 69 64 3c 2f 62 3e 2c 20 3c 62 3e 61 75 >srid</b>, <b>au
3900: 74 68 5f 6e 61 6d 65 3c 2f 62 3e 2c 20 3c 62 3e th_name</b>, <b>
3910: 61 75 74 68 5f 73 72 69 64 3c 2f 62 3e 20 61 6e auth_srid</b> an
3920: 64 20 3c 62 3e 72 65 66 5f 73 79 73 5f 6e 61 6d d <b>ref_sys_nam
3930: 65 3c 2f 62 3e 20 63 6f 6c 75 6d 6e 73 20 61 72 e</b> columns ar
3940: 65 20 73 74 69 6c 6c 20 72 65 71 75 69 72 65 64 e still required
3950: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 64 65 66 in order to def
3960: 69 6e 65 20 61 6c 6c 20 73 75 70 70 6f 72 74 65 ine all supporte
3970: 64 20 43 52 53 65 73 20 61 6e 64 20 74 6f 20 73 d CRSes and to s
3980: 75 70 70 6f 72 74 20 0d 0a 72 65 6c 61 74 69 6f upport ..relatio
3990: 6e 73 20 62 61 73 65 64 20 6f 6e 20 50 72 69 6d ns based on Prim
39a0: 61 72 79 20 61 6e 64 20 46 6f 72 65 69 67 6e 20 ary and Foreign
39b0: 4b 65 79 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e Keys.</li>..<li>
39c0: 62 75 74 20 63 6f 6c 75 6d 6e 73 20 3c 62 3e 70 but columns <b>p
39d0: 72 6f 6a 34 74 65 78 74 3c 2f 62 3e 20 61 6e 64 roj4text</b> and
39e0: 20 3c 62 3e 73 72 74 65 78 74 3c 2f 62 3e 20 61 <b>srtext</b> a
39f0: 72 65 20 6e 6f 77 20 70 72 61 63 74 69 63 61 6c re now practical
3a00: 6c 79 20 75 73 65 6c 65 73 73 2c 20 62 65 63 61 ly useless, beca
3a10: 75 73 65 20 50 52 4f 4a 2e 36 20 69 73 20 6e 6f use PROJ.6 is no
3a20: 77 20 63 61 70 61 62 6c 65 20 74 6f 20 66 75 6c w capable to ful
3a30: 6c 79 20 64 65 66 69 6e 65 20 61 6e 79 20 43 52 ly define any CR
3a40: 53 20 62 79 20 64 69 72 65 63 74 6c 79 20 71 75 S by directly qu
3a50: 65 72 79 69 6e 67 20 69 74 73 20 6f 77 6e 20 70 erying its own p
3a60: 72 69 76 61 74 65 20 64 61 74 61 62 61 73 65 2e rivate database.
3a70: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 69 3e 3c 75 </li>..<li><i><u
3a80: 3e 46 75 74 75 72 65 20 46 6f 72 65 63 61 73 74 >Future Forecast
3a90: 73 3c 2f 75 3e 3c 2f 69 3e 3a 20 62 6f 74 68 20 s</u></i>: both
3aa0: 3c 62 3e 70 72 6f 6a 34 74 65 78 74 3c 2f 62 3e <b>proj4text</b>
3ab0: 20 61 6e 64 20 3c 62 3e 73 72 74 65 78 74 3c 2f and <b>srtext</
3ac0: 62 3e 20 77 69 6c 6c 20 62 65 20 70 72 6f 62 61 b> will be proba
3ad0: 62 6c 79 20 72 65 6d 6f 76 65 64 20 69 6e 20 73 bly removed in s
3ae0: 6f 6d 65 20 66 75 74 75 72 65 20 76 65 72 73 69 ome future versi
3af0: 6f 6e 20 6f 66 20 53 70 61 74 69 61 4c 69 74 65 on of SpatiaLite
3b00: 2e 3c 62 72 3e 0d 0a 46 6f 72 20 6e 6f 77 20 74 .<br>..For now t
3b10: 68 65 79 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20 hey continue to
3b20: 62 65 20 73 75 70 70 6f 72 74 65 64 20 6d 61 69 be supported mai
3b30: 6e 6c 79 20 74 6f 20 74 68 65 20 62 65 6e 65 66 nly to the benef
3b40: 69 74 20 6f 66 20 70 72 65 76 69 6f 75 73 20 76 it of previous v
3b50: 65 72 73 69 6f 6e 73 20 6f 66 20 53 70 61 74 69 ersions of Spati
3b60: 61 4c 69 74 65 20 62 65 69 6e 67 20 62 61 73 65 aLite being base
3b70: 64 20 6f 6e 20 74 68 65 20 6e 6f 77 20 73 75 70 d on the now sup
3b80: 65 72 73 65 64 65 64 20 50 52 4f 4a 2e 34 3c 2f erseded PROJ.4</
3b90: 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 2f 74 64 li>..</ul>..</td
3ba0: 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e ></tr>..</table>
3bb0: 0d 0a 3c 68 33 3e 54 72 61 6e 73 66 6f 72 6d 61 ..<h3>Transforma
3bc0: 74 69 6f 6e 20 70 69 70 65 6c 69 6e 65 73 3c 2f tion pipelines</
3bd0: 68 33 3e 0d 0a 54 68 65 72 65 20 69 73 20 61 20 h3>..There is a
3be0: 6c 61 73 74 20 61 73 74 6f 6e 69 73 68 69 6e 67 last astonishing
3bf0: 20 69 6d 70 72 6f 76 65 6d 65 6e 74 20 73 75 70 improvement sup
3c00: 70 6f 72 74 65 64 20 62 79 20 50 52 4f 4a 2e 36 ported by PROJ.6
3c10: 2c 20 74 68 61 74 20 61 72 65 20 3c 62 3e 3c 69 , that are <b><i
3c20: 3e 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 >transformation
3c30: 70 69 70 65 6c 69 6e 65 73 3c 2f 69 3e 3c 2f 62 pipelines</i></b
3c40: 3e 2e 3c 62 72 3e 0d 0a 57 68 65 6e 20 75 73 69 >.<br>..When usi
3c50: 6e 67 20 61 20 3c 62 3e 3c 69 3e 70 69 70 65 6c ng a <b><i>pipel
3c60: 69 6e 65 3c 2f 69 3e 3c 2f 62 3e 20 79 6f 75 20 ine</i></b> you
3c70: 63 61 6e 20 66 72 65 65 6c 79 20 64 65 66 69 6e can freely defin
3c80: 65 20 61 6e 79 20 63 6f 6d 70 6c 65 78 20 67 65 e any complex ge
3c90: 6f 64 65 74 69 63 20 74 72 61 6e 73 66 6f 72 6d odetic transform
3ca0: 61 74 69 6f 6e 20 62 79 20 63 68 61 69 6e 69 6e ation by chainin
3cb0: 67 20 74 6f 67 65 74 68 65 72 20 6d 61 6e 79 20 g together many
3cc0: 65 6c 65 6d 65 6e 74 61 72 79 20 73 74 65 70 73 elementary steps
3cd0: 20 73 75 63 68 20 61 73 20 63 6f 6e 76 65 72 73 such as convers
3ce0: 69 6f 6e 2c 20 74 72 61 6e 73 66 6f 72 6d 61 74 ion, transformat
3cf0: 69 6f 6e 2c 20 70 72 6f 6a 65 63 74 69 6f 6e 2c ion, projection,
3d00: 20 61 78 69 73 20 73 77 61 70 20 61 6e 64 20 73 axis swap and s
3d10: 6f 20 6f 6e 2e 3c 62 72 3e 0d 0a 41 20 70 69 70 o on.<br>..A pip
3d20: 65 6c 69 6e 65 20 69 73 20 63 6f 6e 63 65 70 74 eline is concept
3d30: 75 61 6c 6c 79 20 73 69 6d 69 6c 61 72 20 74 6f ually similar to
3d40: 20 61 20 55 4e 49 58 20 73 68 65 6c 6c 20 73 63 a UNIX shell sc
3d50: 72 69 70 74 2c 20 77 69 74 68 20 61 20 64 61 74 ript, with a dat
3d60: 61 66 6c 6f 77 20 72 65 67 75 6c 61 72 6c 79 20 aflow regularly
3d70: 70 72 6f 63 65 64 69 6e 67 20 66 6f 72 77 61 72 proceding forwar
3d80: 64 20 66 72 6f 6d 20 73 74 65 70 20 74 6f 20 73 d from step to s
3d90: 74 65 70 20 75 6e 74 69 6c 20 70 72 6f 64 75 63 tep until produc
3da0: 69 6e 67 20 74 68 65 20 66 69 6e 61 6c 20 72 65 ing the final re
3db0: 73 75 6c 74 2e 3c 62 72 3e 0d 0a 54 68 65 20 66 sult.<br>..The f
3dc0: 6f 6c 6c 6f 77 69 6e 67 20 69 73 20 61 20 70 72 ollowing is a pr
3dd0: 61 63 74 69 61 6c 20 65 78 61 6d 70 6c 65 20 6f actial example o
3de0: 66 20 61 20 70 69 70 65 6c 69 6e 65 20 63 6f 72 f a pipeline cor
3df0: 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 61 20 responding to a
3e00: 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 66 transformation f
3e10: 72 6f 6d 20 3c 62 3e 45 50 53 47 3a 34 33 32 36 rom <b>EPSG:4326
3e20: 3c 2f 62 3e 20 3c 69 3e 57 47 53 20 38 34 3c 2f </b> <i>WGS 84</
3e30: 69 3e 20 74 6f 20 3c 62 3e 45 50 53 47 3a 33 32 i> to <b>EPSG:32
3e40: 36 33 32 3c 2f 62 3e 20 3c 69 3e 57 47 53 20 38 632</b> <i>WGS 8
3e50: 34 20 2f 20 55 54 4d 20 7a 6f 6e 65 20 33 32 4e 4 / UTM zone 32N
3e60: 3c 2f 69 3e 3a 0d 0a 3c 76 65 72 62 61 74 69 6d </i>:..<verbatim
3e70: 3e 0d 0a 2b 70 72 6f 6a 3d 70 69 70 65 6c 69 6e >..+proj=pipelin
3e80: 65 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d e ..+step +proj=
3e90: 61 78 69 73 73 77 61 70 20 2b 6f 72 64 65 72 3d axisswap +order=
3ea0: 32 2c 31 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 2,1 ..+step +pro
3eb0: 6a 3d 75 6e 69 74 63 6f 6e 76 65 72 74 20 2b 78 j=unitconvert +x
3ec0: 79 5f 69 6e 3d 64 65 67 20 2b 78 79 5f 6f 75 74 y_in=deg +xy_out
3ed0: 3d 72 61 64 20 0d 0a 2b 73 74 65 70 20 2b 70 72 =rad ..+step +pr
3ee0: 6f 6a 3d 75 74 6d 20 2b 7a 6f 6e 65 3d 33 32 20 oj=utm +zone=32
3ef0: 2b 65 6c 6c 70 73 3d 57 47 53 38 34 0d 0a 3c 2f +ellps=WGS84..</
3f00: 76 65 72 62 61 74 69 6d 3e 0d 0a 3c 74 61 62 6c verbatim>..<tabl
3f10: 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 e cellspacing="8
3f20: 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 31 " cellpadding="1
3f30: 36 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 6" bgcolor="#fff
3f40: 66 64 30 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d fd0">..<tr><td>.
3f50: 0a 3c 62 3e 3c 75 3e 55 73 65 66 75 6c 20 68 69 .<b><u>Useful hi
3f60: 6e 74 3c 2f 75 3e 3c 2f 62 3e 3a 20 50 52 4f 4a nt</u></b>: PROJ
3f70: 2e 36 20 73 75 70 70 6f 72 74 73 20 61 20 6e 65 .6 supports a ne
3f80: 77 20 43 4c 49 20 74 6f 6f 6c 20 28 3c 62 3e 70 w CLI tool (<b>p
3f90: 72 6f 6a 69 6e 66 6f 3c 2f 62 3e 29 20 66 6f 72 rojinfo</b>) for
3fa0: 20 69 6e 73 70 65 63 74 69 6e 67 20 69 6e 20 66 inspecting in f
3fb0: 75 6c 6c 20 64 65 74 61 69 6c 20 74 68 65 20 69 ull detail the i
3fc0: 6e 74 65 72 6e 61 6c 20 64 65 66 69 6e 69 74 69 nternal definiti
3fd0: 6f 6e 73 20 6f 66 20 43 52 53 65 73 2c 20 54 72 ons of CRSes, Tr
3fe0: 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 73 20 65 74 ansformations et
3ff0: 63 2e 3c 62 72 3e 0d 0a 54 68 65 20 61 62 6f 76 c.<br>..The abov
4000: 65 20 70 69 70 65 6c 69 6e 65 20 69 73 20 73 69 e pipeline is si
4010: 6d 70 6c 79 20 74 68 65 20 6f 75 74 70 75 74 20 mply the output
4020: 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 of the following
4030: 20 63 6f 6d 6d 61 6e 64 3a 0d 0a 3c 76 65 72 62 command:..<verb
4040: 61 74 69 6d 3e 0d 0a 70 72 6f 6a 69 6e 66 6f 20 atim>..projinfo
4050: 2d 73 20 45 50 53 47 3a 34 33 32 36 20 2d 74 20 -s EPSG:4326 -t
4060: 45 50 53 47 3a 33 32 36 33 32 20 2d 6f 20 70 72 EPSG:32632 -o pr
4070: 6f 6a 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d oj..</verbatim>.
4080: 0a 3c 62 3e 70 72 6f 6a 69 6e 66 6f 3c 2f 62 3e .<b>projinfo</b>
4090: 20 69 73 20 61 20 76 65 72 79 20 70 72 65 63 69 is a very preci
40a0: 6f 75 73 20 72 65 73 6f 75 72 63 65 3b 20 64 6f ous resource; do
40b0: 6e 27 74 20 65 73 69 74 61 74 65 20 74 6f 20 66 n't esitate to f
40c0: 72 65 71 75 65 6e 74 6c 79 20 75 73 65 20 69 74 requently use it
40d0: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 64 69 73 in order to dis
40e0: 63 6f 76 65 72 20 77 68 61 74 27 73 20 72 65 61 cover what's rea
40f0: 6c 6c 79 20 68 61 70 70 65 6e 69 6e 67 20 62 65 lly happening be
4100: 68 69 6e 64 20 74 68 65 20 73 63 65 6e 65 73 2e hind the scenes.
4110: 3c 62 72 3e 0d 0a 49 74 27 73 20 74 68 65 20 62 <br>..It's the b
4120: 65 73 74 20 61 6e 64 20 65 61 73 69 65 73 74 20 est and easiest
4130: 77 61 79 20 66 6f 72 20 66 75 6c 6c 79 20 75 6e way for fully un
4140: 64 65 72 73 74 61 6e 74 69 6e 67 20 68 6f 77 20 derstanting how
4150: 50 52 4f 4a 2e 36 20 64 6f 20 72 65 61 6c 6c 79 PROJ.6 do really
4160: 20 77 6f 72 6b 73 2e 0d 0a 3c 2f 74 64 3e 3c 2f works...</td></
4170: 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 tr>..</table><br
4180: 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 ><br>..<table ce
4190: 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65 llspacing="8" ce
41a0: 6c 6c 70 61 64 64 69 6e 67 3d 22 38 22 20 62 67 llpadding="8" bg
41b0: 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 39 22 3e color="#ffffe9">
41c0: 0d 0a 3c 74 72 3e 3c 74 68 3e 0d 0a 49 6e 20 6f ..<tr><th>..In o
41d0: 72 64 65 72 20 74 6f 20 6c 65 61 72 6e 20 6d 6f rder to learn mo
41e0: 72 65 20 61 62 6f 75 74 20 74 68 65 20 6d 61 6e re about the man
41f0: 79 20 69 6e 74 65 72 65 73 74 69 6e 67 20 63 6f y interesting co
4200: 6f 6c 20 6e 65 77 20 66 65 61 74 75 72 65 73 20 ol new features
4210: 73 75 70 70 6f 72 74 65 64 20 62 79 20 50 52 4f supported by PRO
4220: 4a 2e 36 20 70 6c 65 61 73 65 20 63 6f 6e 73 75 J.6 please consu
4230: 6c 74 20 74 68 65 20 3c 61 20 68 72 65 66 3d 22 lt the <a href="
4240: 68 74 74 70 73 3a 2f 2f 70 72 6f 6a 34 2e 6f 72 https://proj4.or
4250: 67 2f 22 3e 6f 72 69 67 69 6e 61 6c 20 64 6f 63 g/">original doc
4260: 75 6d 65 6e 74 61 74 69 6f 6e 3c 2f 61 3e 0d 0a umentation</a>..
4270: 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 </th></tr>..</ta
4280: 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 68 72 3e 0d 0a ble><br>..<hr>..
4290: 3c 68 31 3e 50 52 4f 4a 2e 36 20 73 75 70 70 6f <h1>PROJ.6 suppo
42a0: 72 74 20 6f 6e 20 53 70 61 74 69 61 4c 69 74 65 rt on SpatiaLite
42b0: 2d 35 2e 30 2e 30 3c 2f 68 31 3e 0d 0a 3c 68 33 -5.0.0</h1>..<h3
42c0: 3e 43 72 65 61 74 69 6e 67 20 61 6e 64 20 70 6f >Creating and po
42d0: 70 75 6c 61 74 69 6e 67 20 74 68 65 20 73 70 61 pulating the spa
42e0: 74 69 61 6c 5f 72 65 66 5f 73 79 73 20 6d 65 74 tial_ref_sys met
42f0: 61 74 61 62 6c 65 3c 2f 68 33 3e 0d 0a 54 68 65 atable</h3>..The
4300: 72 65 20 69 73 20 6e 6f 20 72 65 6c 65 76 61 6e re is no relevan
4310: 74 20 63 68 61 6e 67 65 2e 20 41 73 20 69 6e 20 t change. As in
4320: 61 6c 6c 20 70 72 65 76 69 6f 75 73 20 76 65 72 all previous ver
4330: 73 69 6f 6e 73 20 3c 62 3e 73 70 61 74 69 61 6c sions <b>spatial
4340: 5f 72 65 66 5f 73 79 73 3c 2f 62 3e 20 77 69 6c _ref_sys</b> wil
4350: 6c 20 62 65 20 61 75 74 6f 6d 61 74 69 63 61 6c l be automatical
4360: 6c 79 20 63 72 65 61 74 65 64 20 61 6e 64 20 70 ly created and p
4370: 72 6f 70 65 72 6c 79 20 70 6f 70 75 6c 61 74 65 roperly populate
4380: 20 62 79 20 63 61 6c 6c 69 6e 67 20 74 68 65 20 by calling the
4390: 61 70 70 72 6f 70 72 69 61 74 65 20 53 51 4c 20 appropriate SQL
43a0: 66 75 6e 63 74 69 6f 6e 2e 0d 0a 3c 76 65 72 62 function...<verb
43b0: 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 54 20 49 6e atim>..SELECT In
43c0: 69 74 53 70 61 74 69 61 6c 4d 65 74 61 44 61 74 itSpatialMetaDat
43d0: 61 28 31 29 3b 0d 0a 20 20 20 20 20 20 6f 72 0d a(1);.. or.
43e0: 0a 53 45 4c 45 43 54 20 49 6e 69 74 53 70 61 74 .SELECT InitSpat
43f0: 69 61 6c 4d 65 74 61 44 61 74 61 46 75 6c 6c 28 ialMetaDataFull(
4400: 31 29 3b 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 1);..</verbatim>
4410: 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 ..<table cellspa
4420: 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 cing="8" cellpad
4430: 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 ding="8" bgcolor
4440: 3d 22 23 66 66 66 66 65 39 22 3e 0d 0a 3c 74 72 ="#ffffe9">..<tr
4450: 3e 3c 74 64 3e 0d 0a 50 6c 65 61 73 65 20 72 65 ><td>..Please re
4460: 6d 65 62 65 72 20 74 68 61 74 20 6e 6f 77 20 69 meber that now i
4470: 6e 20 53 70 61 74 69 61 4c 69 74 65 2d 35 2e 30 n SpatiaLite-5.0
4480: 2e 30 20 3c 62 3e 49 6e 69 74 53 70 61 74 69 61 .0 <b>InitSpatia
4490: 6c 4d 65 74 61 44 61 74 61 46 75 6c 6c 3c 2f 62 lMetaDataFull</b
44a0: 3e 20 72 65 70 72 65 73 65 6e 74 73 20 74 68 65 > represents the
44b0: 20 70 72 65 66 65 72 72 65 64 20 6d 65 74 68 6f preferred metho
44c0: 64 20 66 6f 72 20 63 72 65 61 74 69 6e 67 20 61 d for creating a
44d0: 6c 6c 20 6d 65 74 61 64 61 74 61 20 74 61 62 6c ll metadata tabl
44e0: 65 73 20 72 65 71 75 69 72 65 64 20 62 79 20 74 es required by t
44f0: 68 69 73 20 76 65 72 73 69 6f 6e 2e 3c 62 72 3e his version.<br>
4500: 0d 0a 3c 62 3e 49 6e 69 74 53 70 61 74 69 61 6c ..<b>InitSpatial
4510: 4d 65 74 61 44 61 74 61 3c 2f 62 3e 20 69 73 20 MetaData</b> is
4520: 73 74 69 6c 6c 20 6d 61 69 6e 74 61 69 6e 65 64 still maintained
4530: 20 73 6f 20 74 6f 20 6e 6f 74 20 62 72 65 61 6b so to not break
4540: 20 68 69 73 74 6f 72 69 63 61 6c 20 63 6f 6d 70 historical comp
4550: 61 74 69 62 69 6c 69 74 79 2c 20 62 75 74 20 73 atibility, but s
4560: 68 6f 75 6c 64 6e 27 74 20 62 65 20 75 73 65 64 houldn't be used
4570: 20 61 6e 79 20 6c 6f 6e 67 65 72 2e 0d 0a 3c 2f any longer...</
4580: 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c td></tr>..</tabl
4590: 65 3e 3c 62 72 3e 0d 0a 54 68 65 20 6d 6f 73 74 e><br>..The most
45a0: 20 72 65 6c 65 76 61 6e 74 20 63 68 61 6e 67 65 relevant change
45b0: 20 69 73 20 74 68 61 74 20 64 69 66 66 65 72 65 is that differe
45c0: 6e 74 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 nt versions of S
45d0: 70 61 74 69 61 4c 69 74 65 2f 50 52 4f 4a 20 77 patiaLite/PROJ w
45e0: 69 6c 6c 20 6e 6f 77 20 62 65 68 61 76 65 20 69 ill now behave i
45f0: 6e 20 72 61 64 69 63 61 6c 6c 79 20 64 69 66 66 n radically diff
4600: 65 72 65 6e 74 20 77 61 79 73 2c 20 61 73 20 73 erent ways, as s
4610: 75 6d 6d 61 72 69 7a 65 64 20 69 6e 20 74 68 65 ummarized in the
4620: 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 72 6f 73 73 following cross
4630: 2d 76 65 72 73 69 6f 6e 20 63 6f 6d 70 61 74 69 -version compati
4640: 62 69 6c 69 74 79 20 74 61 62 6c 65 2e 3c 62 72 bility table.<br
4650: 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 ><br>..<table ce
4660: 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65 llspacing="8" ce
4670: 6c 6c 70 61 64 64 69 6e 67 3d 22 31 36 22 20 62 llpadding="16" b
4680: 67 63 6f 6c 6f 72 3d 22 23 65 38 66 66 65 38 22 gcolor="#e8ffe8"
4690: 20 62 6f 72 64 65 72 3d 22 31 22 3e 0d 0a 3c 74 border="1">..<t
46a0: 72 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 r><th bgcolor="#
46b0: 66 66 62 30 33 65 22 3e 53 70 61 74 69 61 4c 69 ffb03e">SpatiaLi
46c0: 74 65 20 2f 20 50 52 4f 4a 20 76 65 72 73 69 6f te / PROJ versio
46d0: 6e 3c 2f 74 68 3e 3c 74 68 20 62 67 63 6f 6c 6f n</th><th bgcolo
46e0: 72 3d 22 23 66 66 62 30 33 65 22 3e 43 6f 6e 6e r="#ffb03e">Conn
46f0: 65 63 74 65 64 20 44 42 3c 2f 74 68 3e 3c 74 68 ected DB</th><th
4700: 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 bgcolor="#ffb03
4710: 65 22 3e 41 63 74 69 6f 6e 3c 2f 74 68 3e 3c 2f e">Action</th></
4720: 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 20 72 tr>..<tr>..<td r
4730: 6f 77 73 70 61 6e 3d 22 32 22 3e 53 70 61 74 69 owspan="2">Spati
4740: 61 4c 69 74 65 2d 35 20 62 75 69 6c 74 20 6f 6e aLite-5 built on
4750: 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 3c 2f <b>PROJ.6</b></
4760: 74 64 3e 0d 0a 3c 74 64 3e 44 42 20 63 72 65 61 td>..<td>DB crea
4770: 74 65 64 20 62 79 20 53 70 61 74 69 61 4c 69 74 ted by SpatiaLit
4780: 65 2d 35 20 2f 20 50 52 4f 4a 2e 36 3c 2f 74 64 e-5 / PROJ.6</td
4790: 3e 0d 0a 3c 74 64 20 72 6f 77 73 70 61 6e 3d 22 >..<td rowspan="
47a0: 32 22 3e 0d 0a 3c 62 3e 6c 69 62 73 70 61 74 69 2">..<b>libspati
47b0: 61 6c 69 74 65 2d 35 3c 2f 62 3e 20 77 68 65 6e alite-5</b> when
47c0: 20 62 75 69 6c 74 20 6f 6e 20 3c 62 3e 50 52 4f built on <b>PRO
47d0: 4a 2e 36 3c 2f 62 3e 20 77 69 6c 6c 20 61 6c 77 J.6</b> will alw
47e0: 61 79 73 20 69 67 6e 6f 72 65 20 62 6f 74 68 20 ays ignore both
47f0: 74 68 65 20 70 72 6f 6a 2d 73 74 72 69 6e 67 73 the proj-strings
4800: 20 73 74 6f 72 65 64 20 69 6e 20 63 6f 6c 75 6d stored in colum
4810: 6e 20 3c 62 3e 70 72 6f 6a 34 74 65 78 74 3c 2f n <b>proj4text</
4820: 62 3e 20 61 6e 64 20 74 68 65 20 57 4b 54 20 64 b> and the WKT d
4830: 65 66 69 6e 69 74 69 6f 6e 73 20 73 74 6f 72 65 efinitions store
4840: 64 20 69 6e 20 63 6f 6c 75 6d 6e 20 3c 62 3e 73 d in column <b>s
4850: 72 74 65 78 74 3c 2f 62 3e 2e 3c 62 72 3e 0d 0a rtext</b>.<br>..
4860: 49 74 20 77 69 6c 6c 20 69 6e 73 74 65 61 64 20 It will instead
4870: 6c 65 61 76 65 20 50 52 4f 4a 2e 36 20 66 75 6c leave PROJ.6 ful
4880: 6c 79 20 66 72 65 65 20 74 6f 20 75 73 65 20 74 ly free to use t
4890: 68 65 20 43 52 53 20 64 65 66 69 6e 69 74 69 6f he CRS definitio
48a0: 6e 73 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20 ns contained in
48b0: 69 74 73 20 6f 77 6e 20 70 72 69 76 61 74 65 20 its own private
48c0: 64 61 74 61 62 61 73 65 2e 3c 62 72 3e 3c 62 72 database.<br><br
48d0: 3e 0d 0a 4e 6f 74 65 20 74 68 61 74 20 74 68 69 >..Note that thi
48e0: 73 20 61 70 70 6c 69 65 73 20 69 6e 64 69 66 66 s applies indiff
48f0: 65 72 65 6e 74 6c 79 20 74 6f 20 62 6f 74 68 20 erently to both
4900: 3c 62 3e 3c 69 3e 6c 65 67 61 63 79 20 64 61 74 <b><i>legacy dat
4910: 61 62 61 73 65 73 3c 2f 69 3e 3c 2f 62 3e 20 63 abases</i></b> c
4920: 72 65 61 74 65 64 20 62 79 20 61 6e 79 20 70 72 reated by any pr
4930: 65 76 69 6f 75 73 20 76 65 72 73 69 6f 6e 20 61 evious version a
4940: 6e 64 20 3c 62 3e 3c 69 3e 6d 6f 73 74 20 6d 6f nd <b><i>most mo
4950: 64 65 72 6e 20 64 61 74 61 62 61 73 65 73 3c 2f dern databases</
4960: 69 3e 3c 2f 62 3e 20 63 72 65 61 74 65 64 20 62 i></b> created b
4970: 79 20 74 68 65 20 6c 61 74 65 73 74 20 76 65 72 y the latest ver
4980: 73 69 6f 6e 2e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 sion...</td></tr
4990: 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 44 42 20 >..<tr>..<td>DB
49a0: 63 72 65 61 74 65 64 20 62 79 20 53 70 61 74 69 created by Spati
49b0: 61 4c 69 74 65 2d 35 20 2f 20 50 52 4f 4a 2e 34 aLite-5 / PROJ.4
49c0: 3c 62 72 3e 0d 0a 6f 72 3c 62 72 3e 0d 0a 62 79 <br>..or<br>..by
49d0: 20 61 6e 79 20 70 72 65 76 69 6f 75 73 20 76 65 any previous ve
49e0: 72 73 69 6f 6e 20 6f 66 20 53 70 61 74 69 61 4c rsion of SpatiaL
49f0: 69 74 65 20 28 3c 20 35 2e 30 2e 30 29 3c 2f 74 ite (< 5.0.0)</t
4a00: 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d d>..</tr>..<tr>.
4a10: 0a 3c 74 64 20 72 6f 77 73 70 61 6e 3d 22 32 22 .<td rowspan="2"
4a20: 3e 53 70 61 74 69 61 4c 69 74 65 2d 35 20 62 75 >SpatiaLite-5 bu
4a30: 69 6c 74 20 6f 6e 20 3c 62 3e 50 52 4f 4a 2e 34 ilt on <b>PROJ.4
4a40: 3c 2f 62 3e 3c 62 72 3e 0d 0a 6f 72 3c 62 72 3e </b><br>..or<br>
4a50: 0d 0a 61 6e 79 20 70 72 65 76 69 6f 75 73 20 76 ..any previous v
4a60: 65 72 73 69 6f 6e 20 6f 66 20 53 70 61 74 69 61 ersion of Spatia
4a70: 4c 69 74 65 20 28 3c 20 35 2e 30 2e 30 29 3c 2f Lite (< 5.0.0)</
4a80: 74 64 3e 0d 0a 3c 74 64 3e 44 42 20 63 72 65 61 td>..<td>DB crea
4a90: 74 65 64 20 62 79 20 53 70 61 74 69 61 4c 69 74 ted by SpatiaLit
4aa0: 65 2d 35 20 2f 20 50 52 4f 4a 2e 36 3c 2f 74 64 e-5 / PROJ.6</td
4ab0: 3e 0d 0a 3c 74 64 20 72 6f 77 73 70 61 6e 3d 22 >..<td rowspan="
4ac0: 32 22 3e 0d 0a 57 68 65 6e 20 3c 62 3e 6c 69 62 2">..When <b>lib
4ad0: 73 70 61 74 69 61 6c 69 74 65 3c 2f 62 3e 20 28 spatialite</b> (
4ae0: 61 6e 79 20 76 65 72 73 69 6f 6e 2c 20 69 6e 63 any version, inc
4af0: 6c 75 64 69 6e 67 20 35 2e 30 2e 30 29 20 69 73 luding 5.0.0) is
4b00: 20 6e 6f 74 20 73 75 70 70 6f 72 74 65 64 20 62 not supported b
4b10: 79 20 50 52 4f 4a 2e 36 20 74 68 65 6e 20 74 68 y PROJ.6 then th
4b20: 65 20 74 72 61 64 69 74 69 6f 6e 61 6c 20 61 70 e traditional ap
4b30: 70 72 6f 61 63 68 20 77 69 6c 6c 20 62 65 20 61 proach will be a
4b40: 6c 77 61 79 73 20 61 70 70 6c 69 65 64 2c 20 61 lways applied, a
4b50: 6e 64 20 65 61 63 68 20 43 52 53 20 77 69 6c 6c nd each CRS will
4b60: 20 62 65 20 63 6f 6e 73 65 71 75 65 6e 74 6c 79 be consequently
4b70: 20 69 64 65 6e 74 69 66 69 65 64 20 62 79 20 69 identified by i
4b80: 74 73 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 ts corresponding
4b90: 20 70 72 6f 6a 2d 73 74 72 69 6e 67 20 73 74 6f proj-string sto
4ba0: 72 65 64 20 69 6e 20 63 6f 6c 75 6d 6e 20 3c 62 red in column <b
4bb0: 3e 70 72 6f 6a 34 74 65 78 74 3c 2f 62 3e 3c 62 >proj4text</b><b
4bc0: 72 3e 3c 62 72 3e 0d 0a 4e 6f 74 65 20 74 68 61 r><br>..Note tha
4bd0: 74 20 65 76 65 6e 20 77 68 65 6e 20 50 52 4f 4a t even when PROJ
4be0: 2e 36 20 69 73 20 6e 6f 74 20 73 75 70 70 6f 72 .6 is not suppor
4bf0: 74 65 64 20 61 6e 79 20 76 65 72 73 69 6f 6e 20 ted any version
4c00: 6f 66 20 53 70 61 74 69 61 4c 69 74 65 20 28 74 of SpatiaLite (t
4c10: 68 69 73 20 69 6e 63 6c 75 64 69 6e 67 20 35 2e his including 5.
4c20: 30 2e 30 29 20 63 61 6e 20 73 61 66 65 6c 79 20 0.0) can safely
4c30: 63 6f 6e 6e 65 63 74 20 74 6f 20 61 6e 79 20 44 connect to any D
4c40: 42 2d 66 69 6c 65 20 63 72 65 61 74 65 64 20 62 B-file created b
4c50: 79 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e y the most recen
4c60: 74 20 76 65 72 73 69 6f 6e 20 77 69 74 68 20 66 t version with f
4c70: 75 6c 6c 20 50 52 4f 4a 2e 36 20 73 75 70 70 6f ull PROJ.6 suppo
4c80: 72 74 2e 0d 0a 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 rt...</td>..</tr
4c90: 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 44 42 20 >..<tr>..<td>DB
4ca0: 63 72 65 61 74 65 64 20 62 79 20 53 70 61 74 69 created by Spati
4cb0: 61 4c 69 74 65 2d 35 20 2f 20 50 52 4f 4a 2e 34 aLite-5 / PROJ.4
4cc0: 3c 62 72 3e 0d 0a 6f 72 3c 62 72 3e 0d 0a 62 79 <br>..or<br>..by
4cd0: 20 61 6e 79 20 70 72 65 76 69 6f 75 73 20 76 65 any previous ve
4ce0: 72 73 69 6f 6e 20 6f 66 20 53 70 61 74 69 61 4c rsion of SpatiaL
4cf0: 69 74 65 20 28 3c 20 35 2e 30 2e 30 29 3c 2f 74 ite (< 5.0.0)</t
4d00: 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 d>..</tr>..</tab
4d10: 6c 65 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 68 33 le><br><br>..<h3
4d20: 3e 45 78 69 73 74 69 6e 67 20 53 51 4c 20 66 75 >Existing SQL fu
4d30: 6e 63 74 69 6f 6e 73 20 61 66 66 65 63 74 65 64 nctions affected
4d40: 20 62 79 20 50 52 4f 4a 2e 36 3c 2f 68 33 3e 0d by PROJ.6</h3>.
4d50: 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 .<table cellspac
4d60: 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 ing="8" cellpadd
4d70: 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 3d ing="8" bgcolor=
4d80: 22 23 65 38 66 66 65 38 22 20 62 6f 72 64 65 72 "#e8ffe8" border
4d90: 3d 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 ="1">..<tr><th b
4da0: 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 gcolor="#ffb03e"
4db0: 3e 53 51 4c 20 46 75 6e 63 74 69 6f 6e 3c 2f 74 >SQL Function</t
4dc0: 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 h><th bgcolor="#
4dd0: 66 66 62 30 33 65 22 3e 45 78 74 65 6e 64 65 64 ffb03e">Extended
4de0: 20 73 69 67 6e 61 74 75 72 65 3c 2f 74 68 3e 3c signature</th><
4df0: 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 th bgcolor="#ffb
4e00: 30 33 65 22 3e 42 65 68 61 76 69 6f 72 20 75 6e 03e">Behavior un
4e10: 64 65 72 20 50 52 4f 4a 2e 36 3c 2f 74 68 3e 3c der PROJ.6</th><
4e20: 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 /tr>..<tr><td><b
4e30: 3e 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 29 3c >ST_Transform()<
4e40: 2f 62 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a /b></td>..<td>..
4e50: 3c 62 3e 53 54 5f 54 72 61 6e 73 66 6f 72 6d 3c <b>ST_Transform<
4e60: 2f 62 3e 20 28 20 67 65 6f 6d 20 3c 69 3e 47 65 /b> ( geom <i>Ge
4e70: 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 6e 65 77 ometry</i> , new
4e80: 53 72 69 64 20 3c 69 3e 49 6e 74 65 67 65 72 3c Srid <i>Integer<
4e90: 2f 69 3e 20 2c 20 61 72 65 61 20 3c 69 3e 47 65 /i> , area <i>Ge
4ea0: 6f 6d 65 74 72 79 3c 2f 69 3e 20 29 20 3a 20 3c ometry</i> ) : <
4eb0: 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 3c 68 i>Geometry</i><h
4ec0: 72 3e 0d 0a 3c 62 3e 53 54 5f 54 72 61 6e 73 66 r>..<b>ST_Transf
4ed0: 6f 72 6d 3c 2f 62 3e 20 28 20 67 65 6f 6d 20 3c orm</b> ( geom <
4ee0: 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c i>Geometry</i> ,
4ef0: 20 6e 65 77 53 72 69 64 20 3c 69 3e 49 6e 74 65 newSrid <i>Inte
4f00: 67 65 72 3c 2f 69 3e 20 2c 20 61 72 65 61 20 3c ger</i> , area <
4f10: 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c i>Geometry</i> ,
4f20: 20 70 72 6f 6a 5f 73 74 72 69 6e 67 5f 66 72 6f proj_string_fro
4f30: 6d 20 3c 69 3e 54 65 78 74 3c 2f 69 3e 20 29 20 m <i>Text</i> )
4f40: 3a 20 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 : <i>Geometry</i
4f50: 3e 3c 68 72 3e 0d 0a 3c 62 3e 53 54 5f 54 72 61 ><hr>..<b>ST_Tra
4f60: 6e 73 66 6f 72 6d 3c 2f 62 3e 20 28 20 67 65 6f nsform</b> ( geo
4f70: 6d 20 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 m <i>Geometry</i
4f80: 3e 20 2c 20 6e 65 77 53 72 69 64 20 3c 69 3e 49 > , newSrid <i>I
4f90: 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 61 72 65 nteger</i> , are
4fa0: 61 20 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 a <i>Geometry</i
4fb0: 3e 20 2c 20 70 72 6f 6a 5f 73 74 72 69 6e 67 5f > , proj_string_
4fc0: 66 72 6f 6d 20 3c 69 3e 54 65 78 74 3c 2f 69 3e from <i>Text</i>
4fd0: 20 2c 20 70 72 6f 6a 5f 73 74 72 69 6e 67 5f 74 , proj_string_t
4fe0: 6f 20 3c 69 3e 54 65 78 74 3c 2f 69 3e 20 29 20 o <i>Text</i> )
4ff0: 3a 20 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 : <i>Geometry</i
5000: 3e 0d 0a 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a >..</td>..<td>..
5010: 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 <table cellspaci
5020: 6e 67 3d 22 34 22 20 63 65 6c 6c 70 61 64 64 69 ng="4" cellpaddi
5030: 6e 67 3d 22 34 22 20 62 67 63 6f 6c 6f 72 3d 22 ng="4" bgcolor="
5040: 23 66 66 66 66 64 30 22 3e 0d 0a 3c 74 72 3e 3c #ffffd0">..<tr><
5050: 74 64 3e 0d 0a 3c 62 3e 3c 75 3e 3c 69 3e 4e 6f td>..<b><u><i>No
5060: 74 65 3c 2f 69 3e 3c 2f 75 3e 3c 2f 62 3e 3a 20 te</i></u></b>:
5070: 61 6c 6c 20 74 68 65 73 65 20 3c 62 3e 3c 69 3e all these <b><i>
5080: 65 78 74 65 6e 64 65 64 20 73 69 67 6e 61 74 75 extended signatu
5090: 72 65 73 3c 2f 69 3e 3c 2f 62 3e 20 61 72 65 20 res</i></b> are
50a0: 73 75 70 70 6f 72 74 65 64 20 6f 6e 6c 79 20 77 supported only w
50b0: 68 65 6e 20 3c 62 3e 6c 69 62 73 70 61 74 69 61 hen <b>libspatia
50c0: 6c 69 74 65 2d 35 2e 30 3c 2f 62 3e 20 68 61 73 lite-5.0</b> has
50d0: 20 62 65 65 6e 20 62 75 69 6c 74 20 6f 6e 20 74 been built on t
50e0: 68 65 20 74 6f 70 20 6f 66 20 3c 62 3e 50 52 4f he top of <b>PRO
50f0: 4a 2e 36 3c 2f 62 3e 3c 62 72 3e 0d 0a 49 66 20 J.6</b><br>..If
5100: 74 68 65 20 6c 69 62 72 61 72 79 20 68 61 73 20 the library has
5110: 62 65 65 6e 20 62 75 69 6c 74 20 69 6e 73 74 65 been built inste
5120: 61 64 20 6f 6e 20 65 61 72 6c 69 65 72 20 76 65 ad on earlier ve
5130: 72 73 69 6f 6e 73 20 6f 66 20 50 52 4f 4a 20 61 rsions of PROJ a
5140: 6e 79 20 61 74 74 65 6d 70 74 20 74 6f 20 63 61 ny attempt to ca
5150: 6c 6c 20 74 68 65 73 65 20 65 78 74 65 6e 64 65 ll these extende
5160: 64 20 73 69 67 6e 61 74 75 72 65 73 20 77 69 6c d signatures wil
5170: 6c 20 6a 75 73 74 20 72 65 74 75 72 6e 20 61 20 l just return a
5180: 3c 62 3e 3c 69 3e 77 72 6f 6e 67 20 6e 75 6d 62 <b><i>wrong numb
5190: 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 er of arguments
51a0: 74 6f 20 66 75 6e 63 74 69 6f 6e 20 53 54 5f 54 to function ST_T
51b0: 72 61 6e 73 66 6f 72 6d 28 29 3c 2f 69 3e 3c 2f ransform()</i></
51c0: 62 3e 20 65 72 72 6f 72 2e 0d 0a 3c 2f 74 64 3e b> error...</td>
51d0: 3c 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 <tr>..</table><b
51e0: 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 r>..<table cells
51f0: 70 61 63 69 6e 67 3d 22 34 22 20 63 65 6c 6c 70 pacing="4" cellp
5200: 61 64 64 69 6e 67 3d 22 34 22 20 62 67 63 6f 6c adding="4" bgcol
5210: 6f 72 3d 22 23 66 66 64 66 64 30 22 3e 0d 0a 3c or="#ffdfd0">..<
5220: 74 72 3e 3c 74 64 3e 0d 0a 41 6e 79 20 69 6e 76 tr><td>..Any inv
5230: 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 20 70 61 alid argument pa
5240: 73 73 65 64 20 74 6f 20 3c 62 3e 53 54 5f 54 72 ssed to <b>ST_Tr
5250: 61 6e 73 66 6f 72 6d 28 29 3c 2f 62 3e 20 28 3c ansform()</b> (<
5260: 62 3e 3c 69 3e 65 78 74 65 6e 64 65 64 20 73 69 b><i>extended si
5270: 67 6e 61 74 75 72 65 73 3c 2f 69 3e 3c 2f 62 3e gnatures</i></b>
5280: 29 20 77 69 6c 6c 20 72 61 69 73 65 20 61 6e 20 ) will raise an
5290: 3c 62 3e 53 51 4c 20 45 78 63 65 70 74 69 6f 6e <b>SQL Exception
52a0: 3c 2f 62 3e 2e 0d 0a 3c 2f 74 64 3e 3c 74 72 3e </b>...</td><tr>
52b0: 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a ..</table><br>..
52c0: 3c 75 6c 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 <ul>..<li>the op
52d0: 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 tional argument
52e0: 3c 62 3e 61 72 65 61 3c 2f 62 3e 20 6d 61 79 20 <b>area</b> may
52f0: 62 65 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 28 be <b>NULL</b> (
5300: 3c 69 3e 64 65 66 61 75 6c 74 20 73 65 74 74 69 <i>default setti
5310: 6e 67 3c 2f 69 3e 29 2e 3c 62 72 3e 0d 0a 4f 74 ng</i>).<br>..Ot
5320: 68 65 72 77 69 73 65 20 69 74 27 73 20 65 78 70 herwise it's exp
5330: 65 63 74 65 64 20 74 6f 20 63 6f 6e 74 61 69 6e ected to contain
5340: 20 61 20 76 61 6c 69 64 20 47 65 6f 6d 65 74 72 a valid Geometr
5350: 79 20 69 6e 20 3c 62 3e 53 52 49 44 3d 34 33 32 y in <b>SRID=432
5360: 36 20 28 6c 6f 6e 67 2f 6c 61 74 29 3c 2f 62 3e 6 (long/lat)</b>
5370: 2e 0d 0a 57 68 65 6e 20 61 6e 20 3c 62 3e 3c 69 ...When an <b><i
5380: 3e 61 72 65 61 20 6f 66 20 75 73 65 3c 2f 69 3e >area of use</i>
5390: 3c 2f 62 3e 20 69 73 20 65 78 70 6c 69 63 69 74 </b> is explicit
53a0: 6c 79 20 73 75 70 70 6c 69 65 64 2c 20 74 68 65 ly supplied, the
53b0: 6e 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 20 n <b>PROJ.6</b>
53c0: 6d 61 79 20 65 76 65 6e 74 75 61 6c 6c 79 20 75 may eventually u
53d0: 73 65 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e se the correspon
53e0: 64 69 6e 67 20 3c 62 3e 42 42 4f 58 3c 2f 62 3e ding <b>BBOX</b>
53f0: 20 66 6f 72 20 66 69 6e 65 6c 79 20 74 75 6e 69 for finely tuni
5400: 6e 67 20 74 68 65 20 6d 6f 72 65 20 61 63 63 75 ng the more accu
5410: 72 61 74 65 20 74 72 61 6e 73 66 6f 72 6d 61 74 rate transformat
5420: 69 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 62 ion.</li>..<li>b
5430: 6f 74 68 20 74 68 65 20 6f 70 74 69 6f 6e 61 6c oth the optional
5440: 20 61 72 67 75 6d 65 6e 74 73 20 3c 62 3e 70 72 arguments <b>pr
5450: 6f 6a 5f 73 74 72 69 6e 67 5f 66 72 6f 6d 3c 2f oj_string_from</
5460: 62 3e 20 61 6e 64 20 3c 62 3e 70 72 6f 6a 5f 73 b> and <b>proj_s
5470: 74 72 69 6e 67 5f 74 6f 3c 2f 62 3e 20 6d 61 79 tring_to</b> may
5480: 20 62 65 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 be <b>NULL</b>
5490: 28 3c 69 3e 64 65 66 61 75 6c 74 20 73 65 74 74 (<i>default sett
54a0: 69 6e 67 3c 2f 69 3e 29 2e 3c 62 72 3e 0d 0a 4f ing</i>).<br>..O
54b0: 74 68 65 72 77 69 73 65 20 74 68 65 79 20 61 72 therwise they ar
54c0: 65 20 65 78 c3 a8 70 65 63 74 65 64 20 74 6f 20 e ex..pected to
54d0: 63 6f 6e 74 61 69 6e 20 61 20 76 61 6c 69 64 20 contain a valid
54e0: 73 74 72 69 6e 67 20 74 6f 20 62 65 20 75 73 65 string to be use
54f0: 64 20 66 6f 72 20 69 64 65 6e 74 69 66 79 69 6e d for identifyin
5500: 67 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 g the correspond
5510: 69 6e 67 20 43 52 53 2e 3c 62 72 3e 0d 0a 50 52 ing CRS.<br>..PR
5520: 4f 4a 2e 36 20 61 63 63 65 70 74 73 20 74 68 65 OJ.6 accepts the
5530: 20 66 6f 6c 6c 6f 77 69 6e 67 20 43 52 53 20 73 following CRS s
5540: 74 72 69 6e 67 73 3a 0d 0a 3c 75 6c 3e 0d 0a 3c trings:..<ul>..<
5550: 6c 69 3e 74 72 61 64 69 74 69 6f 6e 61 6c 20 3c li>traditional <
5560: 62 3e 3c 69 3e 70 72 6f 6a 2d 73 74 72 69 6e 67 b><i>proj-string
5570: 73 3c 2f 69 3e 3c 2f 62 3e 20 75 73 65 64 20 62 s</i></b> used b
5580: 79 20 61 6c 6c 20 70 72 65 76 69 6f 75 73 20 76 y all previous v
5590: 65 72 73 69 6f 6e 73 20 6f 66 20 50 52 4f 4a 2c ersions of PROJ,
55a0: 20 61 73 20 65 2e 67 2e 0d 0a 3c 75 6c 3e 0d 0a as e.g...<ul>..
55b0: 3c 6c 69 3e 3c 62 3e 2b 70 72 6f 6a 3d 6d 65 72 <li><b>+proj=mer
55c0: 63 20 2b 61 3d 36 33 37 38 31 33 37 20 2b 62 3d c +a=6378137 +b=
55d0: 36 33 37 38 31 33 37 20 2b 6c 61 74 5f 74 73 3d 6378137 +lat_ts=
55e0: 30 20 2b 6c 6f 6e 5f 30 3d 30 20 2b 78 5f 30 3d 0 +lon_0=0 +x_0=
55f0: 30 20 2b 79 5f 30 3d 30 20 2b 6b 3d 31 20 2b 75 0 +y_0=0 +k=1 +u
5600: 6e 69 74 73 3d 6d 20 2b 6e 61 64 67 72 69 64 73 nits=m +nadgrids
5610: 3d 40 6e 75 6c 6c 20 2b 77 6b 74 65 78 74 20 2b =@null +wktext +
5620: 6e 6f 5f 64 65 66 73 3c 2f 62 3e 3c 2f 6c 69 3e no_defs</b></li>
5630: 0d 0a 3c 6c 69 3e 3c 62 3e 2b 70 72 6f 6a 3d 75 ..<li><b>+proj=u
5640: 74 6d 20 2b 7a 6f 6e 65 3d 33 32 20 2b 73 6f 75 tm +zone=32 +sou
5650: 74 68 20 2b 65 6c 6c 70 73 3d 57 47 53 37 32 20 th +ellps=WGS72
5660: 2b 74 6f 77 67 73 38 34 3d 30 2c 30 2c 34 2e 35 +towgs84=0,0,4.5
5670: 2c 30 2c 30 2c 30 2e 35 35 34 2c 30 2e 32 32 36 ,0,0,0.554,0.226
5680: 33 20 2b 75 6e 69 74 73 3d 6d 20 2b 6e 6f 5f 64 3 +units=m +no_d
5690: 65 66 73 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 6c efs</b></li>..<l
56a0: 69 3e 3c 62 3e 2b 70 72 6f 6a 3d 75 74 6d 20 2b i><b>+proj=utm +
56b0: 7a 6f 6e 65 3d 33 32 20 2b 65 6c 6c 70 73 3d 69 zone=32 +ellps=i
56c0: 6e 74 6c 20 2b 74 6f 77 67 73 38 34 3d 2d 38 37 ntl +towgs84=-87
56d0: 2c 2d 39 38 2c 2d 31 32 31 2c 30 2c 30 2c 30 2c ,-98,-121,0,0,0,
56e0: 30 20 2b 75 6e 69 74 73 3d 6d 20 2b 6e 6f 5f 64 0 +units=m +no_d
56f0: 65 66 73 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f efs</b></li>..</
5700: 75 6c 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c 69 3e 0d ul>..</ul></li>.
5710: 0a 3c 6c 69 3e 61 6e 79 20 3c 62 3e 3c 69 3e 57 .<li>any <b><i>W
5720: 4b 54 20 65 78 70 72 65 73 73 69 6f 6e 3c 2f 69 KT expression</i
5730: 3e 3c 2f 62 3e 20 64 65 66 69 6e 69 6e 67 20 61 ></b> defining a
5740: 20 43 52 53 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e CRS.</li>..<li>
5750: 61 20 3c 62 3e 3c 69 3e 43 52 53 20 6e 61 6d 65 a <b><i>CRS name
5760: 3c 2f 69 3e 3c 2f 62 3e 20 61 73 20 65 2e 67 2e </i></b> as e.g.
5770: 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 57 ..<ul>..<li><b>W
5780: 47 53 20 38 34 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a GS 84</b></li>..
5790: 3c 6c 69 3e 3c 62 3e 57 47 53 20 38 34 20 2f 20 <li><b>WGS 84 /
57a0: 55 54 4d 20 7a 6f 6e 65 20 33 32 4e 3c 2f 62 3e UTM zone 32N</b>
57b0: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 49 47 </li>..<li><b>IG
57c0: 4d 39 35 20 2f 20 55 54 4d 20 7a 6f 6e 65 20 33 M95 / UTM zone 3
57d0: 33 4e 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 3N</b></li>..</u
57e0: 6c 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 61 6e 79 l></li>..<li>any
57f0: 20 3c 62 3e 3c 69 3e 63 61 6e 6f 6e 69 63 61 6c <b><i>canonical
5800: 20 43 52 53 20 72 65 66 65 72 65 6e 63 3c 2f 69 CRS referenc</i
5810: 3e 3c 2f 62 3e 20 61 73 20 65 2e 67 2e 0d 0a 3c ></b> as e.g...<
5820: 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 45 50 53 47 ul>..<li><b>EPSG
5830: 3a 34 33 32 36 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a :4326</b></li>..
5840: 3c 6c 69 3e 3c 62 3e 75 72 6e 3a 6f 67 63 3a 64 <li><b>urn:ogc:d
5850: 65 66 3a 63 72 73 3a 45 50 53 47 3a 3a 33 30 30 ef:crs:EPSG::300
5860: 33 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3</b></li>..</ul
5870: 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c ></li>..</ul>..<
5880: 62 72 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c br>..<ul>..<li><
5890: 62 3e 3c 75 3e 3c 69 3e 53 70 65 63 69 61 6c 20 b><u><i>Special
58a0: 63 61 73 65 3c 2f 69 3e 3c 2f 75 3e 3c 2f 62 3e case</i></u></b>
58b0: 3a 20 69 66 20 3c 62 3e 70 72 6f 6a 5f 73 74 72 : if <b>proj_str
58c0: 69 6e 67 5f 74 6f 3c 2f 62 3e 20 69 73 20 4e 55 ing_to</b> is NU
58d0: 4c 4c 20 77 68 69 6c 73 74 20 3c 62 3e 70 72 6f LL whilst <b>pro
58e0: 6a 5f 73 74 72 69 6e 67 5f 66 72 6f 6d 3c 2f 62 j_string_from</b
58f0: 3e 20 69 73 20 65 78 70 6c 69 63 69 74 6c 79 20 > is explicitly
5900: 73 65 74 2c 20 74 68 65 6e 20 69 74 20 77 69 6c set, then it wil
5910: 6c 20 69 6e 74 65 72 70 72 65 74 65 64 20 61 73 l interpreted as
5920: 20 61 6e 20 75 73 65 72 20 64 65 66 69 6e 65 64 an user defined
5930: 20 3c 62 3e 74 72 61 6e 73 66 6f 72 6d 61 74 69 <b>transformati
5940: 6f 6e 20 73 74 72 69 6e 67 3c 2f 62 3e 20 28 70 on string</b> (p
5950: 6f 73 73 69 62 6c 79 2c 20 61 73 20 61 20 3c 62 ossibly, as a <b
5960: 3e 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 >transformation
5970: 70 69 70 65 6c 69 6e 65 3c 2f 62 3e 29 20 61 73 pipeline</b>) as
5980: 20 65 2e 67 2e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 e.g...<ul>..<li
5990: 3e 3c 62 3e 2b 70 72 6f 6a 3d 70 69 70 65 6c 69 ><b>+proj=pipeli
59a0: 6e 65 3c 62 72 3e 0d 0a 2b 73 74 65 70 20 2b 70 ne<br>..+step +p
59b0: 72 6f 6a 3d 61 78 69 73 73 77 61 70 20 2b 6f 72 roj=axisswap +or
59c0: 64 65 72 3d 32 2c 31 3c 62 72 3e 20 0d 0a 2b 73 der=2,1<br> ..+s
59d0: 74 65 70 20 2b 70 72 6f 6a 3d 75 6e 69 74 63 6f tep +proj=unitco
59e0: 6e 76 65 72 74 20 2b 78 79 5f 69 6e 3d 64 65 67 nvert +xy_in=deg
59f0: 20 2b 78 79 5f 6f 75 74 3d 72 61 64 3c 62 72 3e +xy_out=rad<br>
5a00: 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 75 ..+step +proj=pu
5a10: 73 68 20 2b 76 5f 33 3c 62 72 3e 0d 0a 2b 73 74 sh +v_3<br>..+st
5a20: 65 70 20 2b 70 72 6f 6a 3d 63 61 72 74 20 2b 65 ep +proj=cart +e
5a30: 6c 6c 70 73 3d 57 47 53 38 34 3c 62 72 3e 20 0d llps=WGS84<br> .
5a40: 0a 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f .+step +inv +pro
5a50: 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 3d 2d 31 30 j=helmert +x=-10
5a60: 34 2e 31 20 2b 79 3d 2d 34 39 2e 31 20 2b 7a 3d 4.1 +y=-49.1 +z=
5a70: 2d 39 2e 39 20 2b 72 78 3d 30 2e 39 37 31 20 2b -9.9 +rx=0.971 +
5a80: 72 79 3d 2d 32 2e 39 31 37 20 2b 72 7a 3d 30 2e ry=-2.917 +rz=0.
5a90: 37 31 34 20 2b 73 3d 2d 31 31 2e 36 38 20 2b 63 714 +s=-11.68 +c
5aa0: 6f 6e 76 65 6e 74 69 6f 6e 3d 70 6f 73 69 74 69 onvention=positi
5ab0: 6f 6e 5f 76 65 63 74 6f 72 3c 62 72 3e 0d 0a 2b on_vector<br>..+
5ac0: 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d step +inv +proj=
5ad0: 63 61 72 74 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c cart +ellps=intl
5ae0: 3c 62 72 3e 0d 0a 2b 73 74 65 70 20 2b 70 72 6f <br>..+step +pro
5af0: 6a 3d 70 6f 70 20 2b 76 5f 33 3c 62 72 3e 20 0d j=pop +v_3<br> .
5b00: 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 74 6d 65 .+step +proj=tme
5b10: 72 63 20 2b 6c 61 74 5f 30 3d 30 20 2b 6c 6f 6e rc +lat_0=0 +lon
5b20: 5f 30 3d 39 20 2b 6b 3d 30 2e 39 39 39 36 20 2b _0=9 +k=0.9996 +
5b30: 78 5f 30 3d 31 35 30 30 30 30 30 20 2b 79 5f 30 x_0=1500000 +y_0
5b40: 3d 30 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c 3c 2f =0 +ellps=intl</
5b50: 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a b></li>..</ul>..
5b60: 3c 2f 75 6c 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 </ul>..</td></tr
5b70: 3e 0d 0a 3c 74 72 3e 3c 74 64 20 63 6f 6c 73 70 >..<tr><td colsp
5b80: 61 6e 3d 22 33 22 3e 0d 0a 3c 68 33 3e 4e 6f 74 an="3">..<h3>Not
5b90: 65 73 3c 2f 68 33 3e 0d 0a 3c 75 6c 3e 0d 0a 3c es</h3>..<ul>..<
5ba0: 6c 69 3e 53 70 61 74 69 61 4c 69 74 65 20 64 6f li>SpatiaLite do
5bb0: 65 73 20 6e 6f 74 20 63 6f 6e 73 74 72 61 69 6e es not constrain
5bc0: 74 73 20 79 6f 75 20 69 6e 20 61 6e 79 20 77 61 ts you in any wa
5bd0: 79 20 61 6e 64 20 66 75 6c 6c 79 20 72 65 73 70 y and fully resp
5be0: 65 63 74 73 20 75 73 65 72 73 20 66 72 65 65 64 ects users freed
5bf0: 6f 6d 20 63 61 72 65 66 75 6c 6c 79 20 61 76 6f om carefully avo
5c00: 69 64 69 6e 67 20 3c 69 3e 61 75 74 6f 2d 6d 61 iding <i>auto-ma
5c10: 67 69 63 61 6c 3c 2f 69 3e 20 61 73 73 75 6d 70 gical</i> assump
5c20: 74 69 6f 6e 73 2e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c tions...<ul>..<l
5c30: 69 3e 54 68 65 20 6e 65 77 20 3c 62 3e 3c 69 3e i>The new <b><i>
5c40: 65 78 74 65 6e 64 65 64 20 73 69 67 6e 61 74 75 extended signatu
5c50: 72 65 73 3c 2f 69 3e 3c 2f 62 3e 20 73 75 70 70 res</i></b> supp
5c60: 6f 72 74 65 64 20 62 79 20 3c 62 3e 53 54 5f 54 orted by <b>ST_T
5c70: 72 61 6e 73 66 6f 72 6d 3c 2f 62 3e 20 63 6c 6f ransform</b> clo
5c80: 73 65 6c 79 20 6d 69 6d 69 63 20 74 68 65 20 6d sely mimic the m
5c90: 6f 73 74 20 72 65 63 65 6e 74 20 50 52 4f 4a 2e ost recent PROJ.
5ca0: 36 20 41 50 49 2c 20 73 6f 20 79 6f 75 20 61 72 6 API, so you ar
5cb0: 65 20 66 72 65 65 20 74 6f 20 64 65 66 69 6e 65 e free to define
5cc0: 20 79 6f 75 72 20 63 6f 6f 72 64 69 6e 61 74 65 your coordinate
5cd0: 73 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e s transformation
5ce0: 73 20 69 6e 20 73 65 76 65 72 61 6c 20 64 69 66 s in several dif
5cf0: 66 65 72 65 6e 74 20 77 61 79 73 2e 3c 2f 6c 69 ferent ways.</li
5d00: 3e 20 0d 0a 3c 6c 69 3e 54 68 65 20 64 65 66 61 > ..<li>The defa
5d10: 75 6c 74 20 62 65 68 61 76 69 6f 72 20 6f 66 20 ult behavior of
5d20: 53 70 61 74 69 61 4c 69 74 65 20 77 68 65 6e 20 SpatiaLite when
5d30: 75 73 69 6e 67 20 50 52 4f 4a 2e 36 20 69 73 20 using PROJ.6 is
5d40: 74 6f 20 63 6f 6d 70 6c 65 74 65 6c 79 20 69 67 to completely ig
5d50: 6e 6f 72 65 20 74 68 65 20 43 52 53 20 64 65 66 nore the CRS def
5d60: 69 6e 69 74 69 6f 6e 73 20 73 74 6f 72 65 64 20 initions stored
5d70: 77 69 74 68 69 6e 20 74 68 65 20 69 6e 74 65 72 within the inter
5d80: 6e 61 6c 20 74 61 62 6c 65 20 3c 62 3e 73 70 61 nal table <b>spa
5d90: 74 69 61 6c 5f 72 65 66 5f 73 79 73 3c 2f 62 3e tial_ref_sys</b>
5da0: 3c 62 72 3e 0d 0a 41 6e 79 20 72 65 71 75 69 72 <br>..Any requir
5db0: 65 64 20 43 52 53 20 64 65 66 69 6e 69 74 69 6f ed CRS definitio
5dc0: 6e 20 77 69 6c 6c 20 62 65 20 61 6c 77 61 79 73 n will be always
5dd0: 20 72 65 74 72 69 65 76 65 64 20 66 72 6f 6d 20 retrieved from
5de0: 50 52 4f 4a 2e 36 20 69 74 73 65 6c 66 20 74 68 PROJ.6 itself th
5df0: 61 74 20 77 69 6c 6c 20 73 69 6d 70 6c 79 20 72 at will simply r
5e00: 65 63 65 69 76 65 20 61 20 72 65 71 75 65 73 74 eceive a request
5e10: 20 69 6e 20 74 68 65 20 66 6f 72 6d 20 3c 62 3e in the form <b>
5e20: 3c 69 3e 66 72 6f 6d 20 45 50 53 47 3a 33 32 36 <i>from EPSG:326
5e30: 33 32 20 74 6f 20 45 50 53 47 3a 33 30 30 33 3c 32 to EPSG:3003<
5e40: 2f 69 3e 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c /i></b>.</li>..<
5e50: 6c 69 3e 49 66 20 79 6f 75 20 68 61 76 65 20 61 li>If you have a
5e60: 6e 79 20 67 6f 6f 64 20 72 65 61 73 6f 6e 20 73 ny good reason s
5e70: 75 67 67 65 73 74 69 6e 67 20 74 6f 20 64 6f 20 uggesting to do
5e80: 73 75 63 68 20 61 20 74 68 69 6e 67 2c 20 79 6f such a thing, yo
5e90: 75 20 61 72 65 20 61 6e 79 77 61 79 20 66 72 65 u are anyway fre
5ea0: 65 20 74 6f 20 75 73 65 20 61 6e 79 20 6b 69 6e e to use any kin
5eb0: 64 20 6f 66 20 70 72 6f 6a 2d 73 74 72 69 6e 67 d of proj-string
5ec0: 73 2c 20 57 4b 54 20 64 65 66 69 6e 69 74 69 6f s, WKT definitio
5ed0: 6e 73 20 6f 72 20 43 52 53 20 6e 61 6d 65 73 20 ns or CRS names
5ee0: 73 75 70 70 6f 72 74 65 64 20 62 79 20 50 52 4f supported by PRO
5ef0: 4a 2e 36 3c 2f 62 3e 2e 3c 62 72 3e 0d 0a 42 75 J.6</b>.<br>..Bu
5f00: 74 20 74 68 69 73 20 69 73 20 75 6e 64 65 72 20 t this is under
5f10: 79 6f 75 72 20 66 75 6c 6c 20 72 65 73 70 6f 6e your full respon
5f20: 73 69 62 69 6c 69 74 79 2c 20 61 6e 64 20 79 6f sibility, and yo
5f30: 75 20 6d 75 73 74 20 62 65 20 77 65 6c 6c 20 73 u must be well s
5f40: 65 6c 66 2d 63 6f 6e 73 63 69 6f 75 73 20 6f 66 elf-conscious of
5f50: 20 77 68 61 74 20 61 72 65 20 79 6f 75 20 64 6f what are you do
5f60: 69 6e 67 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e ing.</li>..</ul>
5f70: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 53 70 61 74 69 </li>..<li>Spati
5f80: 61 4c 69 74 65 20 65 6e 63 6f 75 72 61 67 65 73 aLite encourages
5f90: 20 61 6e 64 20 70 72 6f 6d 6f 74 65 73 20 74 68 and promotes th
5fa0: 65 20 6d 6f 73 74 20 63 72 65 61 74 69 76 65 20 e most creative
5fb0: 75 73 65 73 20 6f 66 20 50 52 4f 4a 2e 36 2c 20 uses of PROJ.6,
5fc0: 74 68 69 73 20 69 6e 63 6c 75 64 69 6e 67 20 75 this including u
5fd0: 73 69 6e 67 20 79 6f 75 72 20 6f 77 6e 20 63 75 sing your own cu
5fe0: 73 74 6f 6d 69 7a 65 64 20 3c 62 3e 74 72 61 6e stomized <b>tran
5ff0: 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 6c sformation pipel
6000: 69 6e 65 73 3c 2f 62 3e 2e 3c 62 72 3e 0d 0a 43 ines</b>.<br>..C
6010: 6f 72 72 65 63 74 6c 79 20 75 73 69 6e 67 20 63 orrectly using c
6020: 75 73 74 6f 6d 20 74 72 61 6e 73 66 6f 72 6d 61 ustom transforma
6030: 74 69 6f 6e 73 20 69 73 6e 27 74 20 6e 65 63 65 tions isn't nece
6040: 73 73 61 72 69 6c 79 20 73 69 6d 70 6c 65 20 61 ssarily simple a
6050: 6e 64 20 65 61 73 79 2c 20 62 75 74 20 69 74 27 nd easy, but it'
6060: 73 20 61 20 62 69 67 20 6f 70 70 6f 72 74 75 6e s a big opportun
6070: 69 74 79 20 66 6f 72 20 61 6c 6c 20 73 6b 69 6c ity for all skil
6080: 6c 65 64 20 61 6e 64 20 74 61 6c 65 6e 74 65 64 led and talented
6090: 20 70 6f 77 65 72 20 75 73 65 72 73 2e 3c 2f 6c power users.</l
60a0: 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 3c 62 72 i>..</ul><br><br
60b0: 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c >..</td></tr>..<
60c0: 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 46 65 77 /table><br>..Few
60d0: 20 70 72 61 63 74 69 63 61 6c 20 53 51 4c 20 65 practical SQL e
60e0: 78 61 6d 70 6c 65 73 3a 0d 0a 3c 76 65 72 62 61 xamples:..<verba
60f0: 74 69 6d 3e 0d 0a 2d 2d 20 66 72 6f 6d 20 45 50 tim>..-- from EP
6100: 53 47 3a 34 33 32 36 20 74 6f 20 45 50 53 47 3a SG:4326 to EPSG:
6110: 33 30 30 33 20 2d 20 64 65 66 61 75 6c 74 20 73 3003 - default s
6120: 65 74 74 69 6e 67 73 3b 20 69 67 6e 6f 72 69 6e ettings; ignorin
6130: 67 20 73 70 61 74 69 61 6c 69 74 65 5f 72 65 66 g spatialite_ref
6140: 5f 73 79 73 20 61 6e 64 20 72 65 6c 79 69 6e 67 _sys and relying
6150: 20 6f 6e 20 50 52 4f 4a 2e 36 20 6f 77 6e 20 70 on PROJ.6 own p
6160: 72 69 76 61 74 65 20 64 61 74 61 62 61 73 65 0d rivate database.
6170: 0a 53 45 4c 45 43 54 20 41 73 45 57 4b 54 20 28 .SELECT AsEWKT (
6180: 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d ST_Transform( M
6190: 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 38 akePoint( 11.878
61a0: 30 35 36 20 2c 20 34 33 2e 34 36 33 30 35 36 20 056 , 43.463056
61b0: 2c 20 34 33 32 36 20 29 20 2c 20 33 30 30 33 20 , 4326 ) , 3003
61c0: 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ));..-----------
61d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
61e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 ----------..SRID
61f0: 3d 33 30 30 33 3b 50 4f 49 4e 54 28 31 37 33 32 =3003;POINT(1732
6200: 38 35 32 2e 39 34 32 37 31 36 37 36 39 20 34 38 852.942716769 48
6210: 31 36 32 37 37 2e 36 31 37 36 39 30 36 37 34 29 16277.617690674)
6220: 0d 0a 0d 0a 0d 0a 2d 2d 20 66 72 6f 6d 20 45 50 ......-- from EP
6230: 53 47 3a 34 33 32 36 20 74 6f 20 45 50 53 47 3a SG:4326 to EPSG:
6240: 33 30 30 33 20 2d 20 65 78 61 63 74 6c 79 20 74 3003 - exactly t
6250: 68 65 20 73 61 6d 65 20 61 73 20 61 62 6f 76 65 he same as above
6260: 2c 20 62 75 74 20 74 68 69 73 20 74 69 6d 65 20 , but this time
6270: 69 6e 20 61 6e 20 65 78 70 6c 69 63 69 74 20 66 in an explicit f
6280: 6f 72 6d 0d 0a 53 45 4c 45 43 54 20 41 73 45 57 orm..SELECT AsEW
6290: 4b 54 20 28 20 53 54 5f 54 72 61 6e 73 66 6f 72 KT ( ST_Transfor
62a0: 6d 28 20 4d 61 6b 65 50 6f 69 6e 74 28 20 31 31 m( MakePoint( 11
62b0: 2e 38 37 38 30 35 36 20 2c 20 34 33 2e 34 36 33 .878056 , 43.463
62c0: 30 35 36 2c 20 34 33 32 36 20 29 20 2c 20 33 30 056, 4326 ) , 30
62d0: 30 33 2c 20 4e 55 4c 4c 2c 20 27 45 50 53 47 3a 03, NULL, 'EPSG:
62e0: 34 33 32 36 27 2c 20 27 45 50 53 47 3a 33 30 30 4326', 'EPSG:300
62f0: 33 27 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 3'));..---------
6300: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6310: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52 ------------..SR
6320: 49 44 3d 33 30 30 33 3b 50 4f 49 4e 54 28 31 37 ID=3003;POINT(17
6330: 33 32 38 35 32 2e 39 34 32 37 31 36 37 36 39 20 32852.942716769
6340: 34 38 31 36 32 37 37 2e 36 31 37 36 39 30 36 37 4816277.61769067
6350: 34 29 0d 0a 0d 0a 0d 0a 2d 2d 20 66 72 6f 6d 20 4)......-- from
6360: 45 50 53 47 3a 34 33 32 36 20 74 6f 20 45 50 53 EPSG:4326 to EPS
6370: 47 3a 33 30 30 33 20 2d 20 73 61 6d 65 20 61 73 G:3003 - same as
6380: 20 61 62 6f 76 65 2c 20 75 73 69 6e 67 20 74 68 above, using th
6390: 65 20 61 6c 74 65 72 6e 61 74 69 76 65 20 6e 6f e alternative no
63a0: 74 61 74 69 6f 6e 0d 0a 53 45 4c 45 43 54 20 41 tation..SELECT A
63b0: 73 45 57 4b 54 20 28 20 53 54 5f 54 72 61 6e 73 sEWKT ( ST_Trans
63c0: 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 6e 74 28 form( MakePoint(
63d0: 20 31 31 2e 38 37 38 30 35 36 20 2c 20 34 33 2e 11.878056 , 43.
63e0: 34 36 33 30 35 36 2c 20 34 33 32 36 20 29 20 2c 463056, 4326 ) ,
63f0: 20 33 30 30 33 2c 20 4e 55 4c 4c 2c 20 27 75 72 3003, NULL, 'ur
6400: 6e 3a 6f 67 63 3a 64 65 66 3a 63 72 73 3a 45 50 n:ogc:def:crs:EP
6410: 53 47 3a 3a 34 33 32 36 27 2c 20 27 75 72 6e 3a SG::4326', 'urn:
6420: 6f 67 63 3a 64 65 66 3a 63 72 73 3a 45 50 53 47 ogc:def:crs:EPSG
6430: 3a 3a 33 30 30 33 27 29 29 3b 0d 0a 2d 2d 2d 2d ::3003'));..----
6440: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6450: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6460: 2d 0d 0a 53 52 49 44 3d 33 30 30 33 3b 50 4f 49 -..SRID=3003;POI
6470: 4e 54 28 31 37 33 32 38 35 32 2e 39 34 32 37 31 NT(1732852.94271
6480: 36 37 36 39 20 34 38 31 36 32 37 37 2e 36 31 37 6769 4816277.617
6490: 36 39 30 36 37 34 29 0d 0a 0d 0a 0d 0a 2d 2d 20 690674)......--
64a0: 66 72 6f 6d 20 45 50 53 47 3a 34 33 32 36 20 74 from EPSG:4326 t
64b0: 6f 20 45 50 53 47 3a 33 30 30 33 20 2d 20 65 78 o EPSG:3003 - ex
64c0: 70 6c 69 63 69 74 6c 79 20 70 61 73 73 69 6e 67 plicitly passing
64d0: 20 43 52 53 20 6e 61 6d 65 73 0d 0a 53 45 4c 45 CRS names..SELE
64e0: 43 54 20 41 73 45 57 4b 54 20 28 20 53 54 5f 54 CT AsEWKT ( ST_T
64f0: 72 61 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f ransform( MakePo
6500: 69 6e 74 28 20 31 31 2e 38 37 38 30 35 36 20 2c int( 11.878056 ,
6510: 20 34 33 2e 34 36 33 30 35 36 2c 20 34 33 32 36 43.463056, 4326
6520: 20 29 20 2c 20 33 30 30 33 2c 20 4e 55 4c 4c 2c ) , 3003, NULL,
6530: 20 27 57 47 53 20 38 34 27 2c 20 27 4d 6f 6e 74 'WGS 84', 'Mont
6540: 65 20 4d 61 72 69 6f 20 2f 20 49 74 61 6c 79 20 e Mario / Italy
6550: 7a 6f 6e 65 20 31 27 29 29 3b 0d 0a 2d 2d 2d 2d zone 1'));..----
6560: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6570: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6580: 2d 0d 0a 53 52 49 44 3d 33 30 30 33 3b 50 4f 49 -..SRID=3003;POI
6590: 4e 54 28 31 37 33 32 38 35 32 2e 39 34 32 37 31 NT(1732852.94271
65a0: 36 37 36 39 20 34 38 31 36 32 37 37 2e 36 31 37 6769 4816277.617
65b0: 36 39 30 36 37 34 29 0d 0a 0d 0a 0d 0a 2d 2d 20 690674)......--
65c0: 66 72 6f 6d 20 45 50 53 47 3a 34 33 32 36 20 74 from EPSG:4326 t
65d0: 6f 20 45 50 53 47 3a 33 30 30 33 20 2d 20 73 69 o EPSG:3003 - si
65e0: 6d 75 6c 61 74 69 6e 67 20 74 68 65 20 63 6c 61 mulating the cla
65f0: 73 73 69 63 20 50 52 4f 4a 2e 34 20 61 70 70 72 ssic PROJ.4 appr
6600: 6f 61 63 68 20 62 61 73 65 64 20 6f 6e 20 70 72 oach based on pr
6610: 6f 6a 2d 73 74 72 69 6e 67 73 20 73 74 6f 72 65 oj-strings store
6620: 64 20 69 6e 74 6f 20 73 70 61 74 69 61 6c 5f 72 d into spatial_r
6630: 65 66 5f 73 79 73 0d 0a 53 45 4c 45 43 54 20 41 ef_sys..SELECT A
6640: 73 45 57 4b 54 20 28 20 53 54 5f 54 72 61 6e 73 sEWKT ( ST_Trans
6650: 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 6e 74 28 form( MakePoint(
6660: 20 31 31 2e 38 37 38 30 35 36 20 2c 20 34 33 2e 11.878056 , 43.
6670: 34 36 33 30 35 36 2c 20 34 33 32 36 20 29 20 2c 463056, 4326 ) ,
6680: 20 33 30 30 33 20 2c 20 4e 55 4c 4c 20 2c 20 0d 3003 , NULL , .
6690: 0a 20 20 28 53 45 4c 45 43 54 20 70 72 6f 6a 34 . (SELECT proj4
66a0: 74 65 78 74 20 46 52 4f 4d 20 73 70 61 74 69 61 text FROM spatia
66b0: 6c 5f 72 65 66 5f 73 79 73 20 57 48 45 52 45 20 l_ref_sys WHERE
66c0: 73 72 69 64 20 3d 20 34 33 32 36 29 2c 0d 0a 20 srid = 4326),..
66d0: 20 28 53 45 4c 45 43 54 20 70 72 6f 6a 34 74 65 (SELECT proj4te
66e0: 78 74 20 46 52 4f 4d 20 73 70 61 74 69 61 6c 5f xt FROM spatial_
66f0: 72 65 66 5f 73 79 73 20 57 48 45 52 45 20 73 72 ref_sys WHERE sr
6700: 69 64 20 3d 20 33 30 30 33 29 29 29 3b 0d 0a 2d id = 3003)));..-
6710: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6720: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6730: 2d 2d 2d 2d 0d 0a 53 52 49 44 3d 33 30 30 33 3b ----..SRID=3003;
6740: 50 4f 49 4e 54 28 31 37 33 32 38 35 32 2e 39 34 POINT(1732852.94
6750: 32 37 31 36 37 36 39 20 34 38 31 36 32 37 37 2e 2716769 4816277.
6760: 36 31 37 36 39 30 36 37 34 29 0d 0a 0d 0a 0d 0a 617690674)......
6770: 2d 2d 20 66 72 6f 6d 20 45 50 53 47 3a 34 33 32 -- from EPSG:432
6780: 36 20 74 6f 20 45 50 53 47 3a 33 30 30 33 20 2d 6 to EPSG:3003 -
6790: 20 66 61 6e 63 79 20 6d 6f 64 65 20 62 61 73 65 fancy mode base
67a0: 64 20 6f 6e 20 57 4b 54 20 65 78 70 72 65 73 73 d on WKT express
67b0: 69 6f 6e 73 20 73 74 6f 72 65 64 20 69 6e 74 6f ions stored into
67c0: 20 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 spatial_ref_sys
67d0: 0d 0a 53 45 4c 45 43 54 20 41 73 45 57 4b 54 20 ..SELECT AsEWKT
67e0: 28 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 ( ST_Transform(
67f0: 4d 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 MakePoint( 11.87
6800: 38 30 35 36 20 2c 20 34 33 2e 34 36 33 30 35 36 8056 , 43.463056
6810: 2c 20 34 33 32 36 20 29 20 2c 20 33 30 30 33 2c , 4326 ) , 3003,
6820: 20 4e 55 4c 4c 2c 20 0d 0a 20 20 28 53 45 4c 45 NULL, .. (SELE
6830: 43 54 20 73 72 74 65 78 74 20 46 52 4f 4d 20 73 CT srtext FROM s
6840: 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 20 57 patial_ref_sys W
6850: 48 45 52 45 20 73 72 69 64 20 3d 20 34 33 32 36 HERE srid = 4326
6860: 29 2c 0d 0a 20 20 28 53 45 4c 45 43 54 20 73 72 ),.. (SELECT sr
6870: 74 65 78 74 20 46 52 4f 4d 20 73 70 61 74 69 61 text FROM spatia
6880: 6c 5f 72 65 66 5f 73 79 73 20 57 48 45 52 45 20 l_ref_sys WHERE
6890: 73 72 69 64 20 3d 20 33 30 30 33 29 29 29 3b 0d srid = 3003)));.
68a0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
68b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
68c0: 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d 33 30 30 ------..SRID=300
68d0: 33 3b 50 4f 49 4e 54 28 31 37 33 32 38 35 32 2e 3;POINT(1732852.
68e0: 39 34 32 37 31 36 37 36 39 20 34 38 31 36 32 37 942716769 481627
68f0: 37 2e 36 31 37 36 39 30 36 37 34 29 0d 0a 3c 2f 7.617690674)..</
6900: 76 65 72 62 61 74 69 6d 3e 0d 0a 54 68 69 73 20 verbatim>..This
6910: 66 69 72 73 74 20 74 65 73 74 20 69 73 20 62 61 first test is ba
6920: 73 65 64 20 6f 6e 20 61 20 6e 65 77 20 53 70 61 sed on a new Spa
6930: 74 69 61 4c 69 74 65 20 64 61 74 61 62 61 73 65 tiaLite database
6940: 20 63 72 65 61 74 65 64 20 77 69 74 68 20 66 75 created with fu
6950: 6c 6c 20 50 52 4f 4a 2e 36 20 73 75 70 70 6f 72 ll PROJ.6 suppor
6960: 74 2e 20 54 68 65 72 65 20 69 73 6e 27 74 20 61 t. There isn't a
6970: 6e 79 74 68 69 6e 67 20 77 6f 72 74 68 20 74 6f nything worth to
6980: 20 62 65 20 6e 6f 74 65 64 2c 20 65 78 63 65 70 be noted, excep
6990: 74 20 74 68 61 74 20 61 6c 6c 20 6d 65 74 68 6f t that all metho
69a0: 64 73 20 72 65 74 75 72 6e 20 74 68 65 20 73 61 ds return the sa
69b0: 6d 65 20 72 65 73 75 6c 74 73 2e 3c 62 72 3e 3c me results.<br><
69c0: 62 72 3e 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d br>..<verbatim>.
69d0: 0a 2d 2d 20 66 72 6f 6d 20 45 50 53 47 3a 34 33 .-- from EPSG:43
69e0: 32 36 20 74 6f 20 45 50 53 47 3a 33 30 30 33 20 26 to EPSG:3003
69f0: 2d 20 75 73 69 6e 67 20 61 20 74 72 61 6e 73 66 - using a transf
6a00: 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 6c 69 6e ormation pipelin
6a10: 65 0d 0a 53 45 4c 45 43 54 20 41 73 45 57 4b 54 e..SELECT AsEWKT
6a20: 20 28 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 ( ST_Transform(
6a30: 20 53 77 61 70 43 6f 6f 72 64 73 20 28 20 4d 61 SwapCoords ( Ma
6a40: 6b 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 38 30 kePoint( 11.8780
6a50: 35 36 20 2c 20 34 33 2e 34 36 33 30 35 36 2c 20 56 , 43.463056,
6a60: 34 33 32 36 20 29 20 29 20 2c 20 33 30 30 33 20 4326 ) ) , 3003
6a70: 2c 20 4e 55 4c 4c 20 2c 0d 0a 27 2b 70 72 6f 6a , NULL ,..'+proj
6a80: 3d 70 69 70 65 6c 69 6e 65 20 0d 0a 2b 73 74 65 =pipeline ..+ste
6a90: 70 20 2b 70 72 6f 6a 3d 61 78 69 73 73 77 61 70 p +proj=axisswap
6aa0: 20 2b 6f 72 64 65 72 3d 32 2c 31 20 0d 0a 2b 73 +order=2,1 ..+s
6ab0: 74 65 70 20 2b 70 72 6f 6a 3d 75 6e 69 74 63 6f tep +proj=unitco
6ac0: 6e 76 65 72 74 20 2b 78 79 5f 69 6e 3d 64 65 67 nvert +xy_in=deg
6ad0: 20 2b 78 79 5f 6f 75 74 3d 72 61 64 20 0d 0a 2b +xy_out=rad ..+
6ae0: 73 74 65 70 20 2b 70 72 6f 6a 3d 70 75 73 68 20 step +proj=push
6af0: 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 +v_3 ..+step +pr
6b00: 6f 6a 3d 63 61 72 74 20 2b 65 6c 6c 70 73 3d 57 oj=cart +ellps=W
6b10: 47 53 38 34 20 0d 0a 2b 73 74 65 70 20 2b 69 6e GS84 ..+step +in
6b20: 76 20 2b 70 72 6f 6a 3d 68 65 6c 6d 65 72 74 20 v +proj=helmert
6b30: 2b 78 3d 2d 31 30 34 2e 31 20 2b 79 3d 2d 34 39 +x=-104.1 +y=-49
6b40: 2e 31 20 2b 7a 3d 2d 39 2e 39 20 2b 72 78 3d 30 .1 +z=-9.9 +rx=0
6b50: 2e 39 37 31 20 2b 72 79 3d 2d 32 2e 39 31 37 20 .971 +ry=-2.917
6b60: 2b 72 7a 3d 30 2e 37 31 34 20 2b 73 3d 2d 31 31 +rz=0.714 +s=-11
6b70: 2e 36 38 20 2b 63 6f 6e 76 65 6e 74 69 6f 6e 3d .68 +convention=
6b80: 70 6f 73 69 74 69 6f 6e 5f 76 65 63 74 6f 72 20 position_vector
6b90: 0d 0a 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 ..+step +inv +pr
6ba0: 6f 6a 3d 63 61 72 74 20 2b 65 6c 6c 70 73 3d 69 oj=cart +ellps=i
6bb0: 6e 74 6c 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f ntl ..+step +pro
6bc0: 6a 3d 70 6f 70 20 2b 76 5f 33 20 0d 0a 2b 73 74 j=pop +v_3 ..+st
6bd0: 65 70 20 2b 70 72 6f 6a 3d 74 6d 65 72 63 20 2b ep +proj=tmerc +
6be0: 6c 61 74 5f 30 3d 30 20 2b 6c 6f 6e 5f 30 3d 39 lat_0=0 +lon_0=9
6bf0: 20 2b 6b 3d 30 2e 39 39 39 36 20 2b 78 5f 30 3d +k=0.9996 +x_0=
6c00: 31 35 30 30 30 30 30 20 2b 79 5f 30 3d 30 20 2b 1500000 +y_0=0 +
6c10: 65 6c 6c 70 73 3d 69 6e 74 6c 27 20 29 29 3b 0d ellps=intl' ));.
6c20: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
6c30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6c40: 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d 33 30 30 ------..SRID=300
6c50: 33 3b 50 4f 49 4e 54 28 31 37 33 32 38 35 32 2e 3;POINT(1732852.
6c60: 39 34 32 37 31 36 37 36 39 20 34 38 31 36 32 37 942716769 481627
6c70: 37 2e 36 31 37 36 39 30 36 37 34 29 0d 0a 0d 0a 7.617690674)....
6c80: 0d 0a 2d 2d 20 66 72 6f 6d 20 45 50 53 47 3a 34 ..-- from EPSG:4
6c90: 33 32 36 20 74 6f 20 45 50 53 47 3a 33 30 30 33 326 to EPSG:3003
6ca0: 20 2d 20 75 73 69 6e 67 20 61 20 63 75 73 74 6f - using a custo
6cb0: 6d 69 7a 65 64 20 74 72 61 6e 73 66 6f 72 6d 61 mized transforma
6cc0: 74 69 6f 6e 20 70 69 70 65 6c 69 6e 65 0d 0a 53 tion pipeline..S
6cd0: 45 4c 45 43 54 20 41 73 45 57 4b 54 20 28 20 53 ELECT AsEWKT ( S
6ce0: 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d 61 6b T_Transform( Mak
6cf0: 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 38 30 35 ePoint( 11.87805
6d00: 36 20 2c 20 34 33 2e 34 36 33 30 35 36 2c 20 34 6 , 43.463056, 4
6d10: 33 32 36 20 29 20 2c 20 33 30 30 33 20 2c 20 4e 326 ) , 3003 , N
6d20: 55 4c 4c 20 2c 0d 0a 27 2b 70 72 6f 6a 3d 70 69 ULL ,..'+proj=pi
6d30: 70 65 6c 69 6e 65 20 20 0d 0a 2b 73 74 65 70 20 peline ..+step
6d40: 2b 70 72 6f 6a 3d 75 6e 69 74 63 6f 6e 76 65 72 +proj=unitconver
6d50: 74 20 2b 78 79 5f 69 6e 3d 64 65 67 20 2b 78 79 t +xy_in=deg +xy
6d60: 5f 6f 75 74 3d 72 61 64 20 0d 0a 2b 73 74 65 70 _out=rad ..+step
6d70: 20 2b 70 72 6f 6a 3d 70 75 73 68 20 2b 76 5f 33 +proj=push +v_3
6d80: 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 63 ..+step +proj=c
6d90: 61 72 74 20 2b 65 6c 6c 70 73 3d 57 47 53 38 34 art +ellps=WGS84
6da0: 20 0d 0a 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 ..+step +inv +p
6db0: 72 6f 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 3d 2d roj=helmert +x=-
6dc0: 31 30 34 2e 31 20 2b 79 3d 2d 34 39 2e 31 20 2b 104.1 +y=-49.1 +
6dd0: 7a 3d 2d 39 2e 39 20 2b 72 78 3d 30 2e 39 37 31 z=-9.9 +rx=0.971
6de0: 20 2b 72 79 3d 2d 32 2e 39 31 37 20 2b 72 7a 3d +ry=-2.917 +rz=
6df0: 30 2e 37 31 34 20 2b 73 3d 2d 31 31 2e 36 38 20 0.714 +s=-11.68
6e00: 2b 63 6f 6e 76 65 6e 74 69 6f 6e 3d 70 6f 73 69 +convention=posi
6e10: 74 69 6f 6e 5f 76 65 63 74 6f 72 20 0d 0a 2b 73 tion_vector ..+s
6e20: 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d 63 tep +inv +proj=c
6e30: 61 72 74 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20 art +ellps=intl
6e40: 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 6f ..+step +proj=po
6e50: 70 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b p +v_3 ..+step +
6e60: 70 72 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 5f proj=tmerc +lat_
6e70: 30 3d 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 0=0 +lon_0=9 +k=
6e80: 30 2e 39 39 39 36 20 2b 78 5f 30 3d 31 35 30 30 0.9996 +x_0=1500
6e90: 30 30 30 20 2b 79 5f 30 3d 30 20 2b 65 6c 6c 70 000 +y_0=0 +ellp
6ea0: 73 3d 69 6e 74 6c 27 20 29 29 3b 0d 0a 2d 2d 2d s=intl' ));..---
6eb0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6ec0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6ed0: 2d 2d 0d 0a 53 52 49 44 3d 33 30 30 33 3b 50 4f --..SRID=3003;PO
6ee0: 49 4e 54 28 31 37 33 32 38 35 32 2e 39 34 32 37 INT(1732852.9427
6ef0: 31 36 37 36 39 20 34 38 31 36 32 37 37 2e 36 31 16769 4816277.61
6f00: 37 36 39 30 36 37 34 29 0d 0a 3c 2f 76 65 72 62 7690674)..</verb
6f10: 61 74 69 6d 3e 0d 0a 54 68 69 73 20 73 65 63 6f atim>..This seco
6f20: 6e 64 20 74 65 73 74 20 69 73 20 62 61 73 65 64 nd test is based
6f30: 20 6f 6e 20 75 73 69 6e 67 20 3c 62 3e 3c 69 3e on using <b><i>
6f40: 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 transformation p
6f50: 69 70 65 6c 69 6e 65 73 3c 2f 69 3e 3c 2f 62 3e ipelines</i></b>
6f60: 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 74 68 65 :..<ul>..<li>the
6f70: 20 66 69 72 73 74 20 71 75 65 72 79 20 64 69 72 first query dir
6f80: 65 63 74 6c 79 20 75 73 65 73 20 61 20 63 61 6e ectly uses a can
6f90: 6f 6e 69 63 61 6c 20 73 74 72 69 6e 67 20 72 65 onical string re
6fa0: 70 72 65 73 65 6e 74 69 6e 67 20 74 68 65 20 70 presenting the p
6fb0: 69 70 65 6c 69 6e 65 20 61 73 20 72 65 74 75 72 ipeline as retur
6fc0: 6e 69 6e 67 20 62 79 20 74 68 69 73 20 63 6f 6d ning by this com
6fd0: 6d 61 6e 64 20 65 78 65 63 75 74 65 64 20 66 72 mand executed fr
6fe0: 6f 6d 20 74 68 65 20 73 68 65 6c 6c 3a 0d 0a 3c om the shell:..<
6ff0: 76 65 72 62 61 74 69 6d 3e 0d 0a 70 72 6f 6a 69 verbatim>..proji
7000: 6e 66 6f 20 20 2d 73 20 45 50 53 47 3a 34 33 32 nfo -s EPSG:432
7010: 36 20 2d 74 20 45 50 53 47 3a 33 30 30 33 20 2d 6 -t EPSG:3003 -
7020: 2d 61 72 65 61 20 20 22 49 74 61 6c 79 20 2d 20 -area "Italy -
7030: 6d 61 69 6e 6c 61 6e 64 22 20 2d 6f 20 70 72 6f mainland" -o pro
7040: 6a 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a j..</verbatim>..
7050: 28 77 65 27 6c 6c 20 73 65 65 20 74 68 69 73 20 (we'll see this
7060: 74 6f 70 69 63 20 69 6e 20 6d 6f 72 65 20 64 65 topic in more de
7070: 70 74 68 20 6f 6e 20 74 68 65 20 6e 65 78 74 20 pth on the next
7080: 73 65 63 74 69 6f 6e 29 2e 3c 2f 6c 69 3e 0d 0a section).</li>..
7090: 3c 6c 69 3e 74 68 65 20 73 65 63 6f 6e 64 20 71 <li>the second q
70a0: 75 65 72 79 20 69 73 20 6a 75 73 74 20 61 20 73 uery is just a s
70b0: 6d 61 6c 6c 20 61 64 61 70 74 61 74 69 6f 6e 20 mall adaptation
70c0: 6f 66 20 74 68 65 20 66 69 72 73 74 20 6f 6e 65 of the first one
70d0: 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 41 73 20 :..<ul>..<li>As
70e0: 79 6f 75 20 63 61 6e 20 6e 6f 74 69 63 65 20 74 you can notice t
70f0: 68 65 20 66 69 72 73 74 20 71 75 65 72 79 20 72 he first query r
7100: 65 71 75 69 72 65 73 20 63 61 6c 6c 69 6e 67 20 equires calling
7110: 3c 62 3e 53 77 61 70 43 6f 6f 64 69 6e 61 74 65 <b>SwapCoodinate
7120: 73 28 29 3c 2f 62 3e 20 62 65 63 61 75 73 65 20 s()</b> because
7130: 74 68 65 20 66 69 72 73 74 20 73 74 65 70 20 6f the first step o
7140: 66 20 74 68 65 20 70 69 70 65 6c 69 6e 65 20 68 f the pipeline h
7150: 61 73 20 61 6e 20 3c 62 3e 61 78 69 73 73 77 61 as an <b>axisswa
7160: 70 3c 2f 62 3e 20 64 69 72 65 63 74 69 76 65 2e p</b> directive.
7170: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 54 68 65 20 73 </li>..<li>The s
7180: 65 63 6f 6e 64 20 71 75 65 72 79 20 6a 75 73 74 econd query just
7190: 20 61 76 6f 69 64 73 20 74 6f 20 63 61 6c 6c 20 avoids to call
71a0: 3c 62 3e 53 77 61 70 43 6f 6f 72 64 73 28 29 3c <b>SwapCoords()<
71b0: 2f 62 3e 20 61 6e 64 20 63 6f 6e 73 65 71 75 65 /b> and conseque
71c0: 6e 74 6c 79 20 74 68 69 73 20 66 69 72 73 74 20 ntly this first
71d0: 73 74 65 70 20 68 61 73 20 62 65 65 6e 20 72 65 step has been re
71e0: 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 20 70 moved from the p
71f0: 69 70 65 6c 69 6e 65 20 73 6f 20 74 6f 20 67 65 ipeline so to ge
7200: 74 20 74 68 65 20 73 61 6d 65 20 69 64 65 6e 74 t the same ident
7210: 69 63 61 6c 20 6f 76 65 72 61 6c 6c 20 65 66 66 ical overall eff
7220: 65 63 74 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e ect.</li>..</ul>
7230: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 3c 75 </li>..<li><b><u
7240: 3e 4e 6f 74 65 3c 2f 75 3e 3c 2f 62 3e 3a 20 53 >Note</u></b>: S
7250: 70 61 74 69 61 4c 69 74 65 20 61 6e 64 20 50 52 patiaLite and PR
7260: 4f 4a 2e 36 20 77 69 6c 6c 20 61 6c 77 61 79 73 OJ.6 will always
7270: 20 64 6f 20 61 20 62 65 73 74 20 65 66 66 6f 72 do a best effor
7280: 74 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 67 75 t in order to gu
7290: 65 73 73 20 69 66 20 73 77 61 70 70 69 6e 67 20 ess if swapping
72a0: 74 68 65 20 63 6f 6f 72 64 69 6e 61 74 65 73 20 the coordinates
72b0: 69 73 20 72 65 71 75 69 72 65 64 20 6f 72 20 6e is required or n
72c0: 6f 74 2e 3c 62 72 3e 0d 0a 42 75 74 20 69 6e 20 ot.<br>..But in
72d0: 74 68 65 20 73 70 65 63 69 66 69 63 20 63 61 73 the specific cas
72e0: 65 20 6f 66 20 74 72 61 6e 73 66 6f 72 6d 61 74 e of transformat
72f0: 69 6f 6e 20 70 69 70 65 6c 69 6e 65 73 20 74 68 ion pipelines th
7300: 65 20 75 73 65 72 20 69 73 20 65 78 70 65 63 74 e user is expect
7310: 65 64 20 74 6f 20 65 78 70 6c 69 63 69 74 6c 79 ed to explicitly
7320: 20 63 61 6c 6c 20 3c 62 3e 53 77 61 70 43 6f 6f call <b>SwapCoo
7330: 72 64 73 28 29 3c 2f 62 3e 20 77 68 65 6e 65 76 rds()</b> whenev
7340: 65 72 20 72 65 71 75 69 72 65 64 2e 3c 2f 6c 69 er required.</li
7350: 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 0d 0a 3c 74 >..</ul><br>..<t
7360: 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 able cellspacing
7370: 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 ="8" cellpadding
7380: 3d 22 31 36 22 20 62 67 63 6f 6c 6f 72 3d 22 23 ="16" bgcolor="#
7390: 63 39 66 66 66 30 22 3e 0d 0a 3c 74 72 3e 3c 74 c9fff0">..<tr><t
73a0: 64 3e 0d 0a 3c 68 32 3e 54 65 63 68 20 4e 6f 74 d>..<h2>Tech Not
73b0: 65 3a 20 75 73 69 6e 67 20 70 72 6f 6a 69 6e 66 e: using projinf
73c0: 6f 20 66 6f 72 20 64 69 73 63 6f 76 65 72 69 6e o for discoverin
73d0: 67 20 70 69 70 65 6c 69 6e 65 73 20 61 6e 64 20 g pipelines and
73e0: 61 72 65 61 73 20 6f 66 20 75 73 65 3c 2f 68 32 areas of use</h2
73f0: 3e 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 70 >..<verbatim>..p
7400: 72 6f 6a 69 6e 66 6f 20 2d 73 20 45 50 53 47 3a rojinfo -s EPSG:
7410: 34 33 32 36 20 2d 74 20 45 50 53 47 3a 33 30 30 4326 -t EPSG:300
7420: 33 20 2d 6f 20 70 72 6f 6a 20 2d 2d 73 70 61 74 3 -o proj --spat
7430: 69 61 6c 2d 74 65 73 74 20 69 6e 74 65 72 73 65 ial-test interse
7440: 63 74 0d 0a 43 61 6e 64 69 64 61 74 65 20 6f 70 ct..Candidate op
7450: 65 72 61 74 69 6f 6e 73 20 66 6f 75 6e 64 3a 20 erations found:
7460: 33 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 3..-------------
7470: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
7480: 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 4f 70 65 72 61 74 --------..Operat
7490: 69 6f 6e 20 6e c2 b0 31 3a 0d 0a 0d 0a 75 6e 6b ion n..1:....unk
74a0: 6e 6f 77 6e 20 69 64 2c 20 49 6e 76 65 72 73 65 nown id, Inverse
74b0: 20 6f 66 20 4d 6f 6e 74 65 20 4d 61 72 69 6f 20 of Monte Mario
74c0: 74 6f 20 57 47 53 20 38 34 20 28 34 29 20 2b 20 to WGS 84 (4) +
74d0: 49 74 61 6c 79 20 7a 6f 6e 65 20 31 2c 20 34 20 Italy zone 1, 4
74e0: 6d 2c 20 49 74 61 6c 79 20 2d 20 6d 61 69 6e 6c m, Italy - mainl
74f0: 61 6e 64 0d 0a 0d 0a 50 52 4f 4a 20 73 74 72 69 and....PROJ stri
7500: 6e 67 3a 0d 0a 2b 70 72 6f 6a 3d 70 69 70 65 6c ng:..+proj=pipel
7510: 69 6e 65 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f ine ..+step +pro
7520: 6a 3d 61 78 69 73 73 77 61 70 20 2b 6f 72 64 65 j=axisswap +orde
7530: 72 3d 32 2c 31 20 0d 0a 2b 73 74 65 70 20 2b 70 r=2,1 ..+step +p
7540: 72 6f 6a 3d 75 6e 69 74 63 6f 6e 76 65 72 74 20 roj=unitconvert
7550: 2b 78 79 5f 69 6e 3d 64 65 67 20 2b 78 79 5f 6f +xy_in=deg +xy_o
7560: 75 74 3d 72 61 64 20 0d 0a 2b 73 74 65 70 20 2b ut=rad ..+step +
7570: 70 72 6f 6a 3d 70 75 73 68 20 2b 76 5f 33 20 0d proj=push +v_3 .
7580: 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 63 61 72 .+step +proj=car
7590: 74 20 2b 65 6c 6c 70 73 3d 57 47 53 38 34 20 0d t +ellps=WGS84 .
75a0: 0a 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f .+step +inv +pro
75b0: 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 3d 2d 31 30 j=helmert +x=-10
75c0: 34 2e 31 20 2b 79 3d 2d 34 39 2e 31 20 2b 7a 3d 4.1 +y=-49.1 +z=
75d0: 2d 39 2e 39 20 2b 72 78 3d 30 2e 39 37 31 20 2b -9.9 +rx=0.971 +
75e0: 72 79 3d 2d 32 2e 39 31 37 20 2b 72 7a 3d 30 2e ry=-2.917 +rz=0.
75f0: 37 31 34 20 2b 73 3d 2d 31 31 2e 36 38 20 2b 63 714 +s=-11.68 +c
7600: 6f 6e 76 65 6e 74 69 6f 6e 3d 70 6f 73 69 74 69 onvention=positi
7610: 6f 6e 5f 76 65 63 74 6f 72 20 0d 0a 2b 73 74 65 on_vector ..+ste
7620: 70 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d 63 61 72 p +inv +proj=car
7630: 74 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20 0d 0a t +ellps=intl ..
7640: 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 6f 70 20 +step +proj=pop
7650: 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 +v_3 ..+step +pr
7660: 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 5f 30 3d oj=tmerc +lat_0=
7670: 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 2e 0 +lon_0=9 +k=0.
7680: 39 39 39 36 20 2b 78 5f 30 3d 31 35 30 30 30 30 9996 +x_0=150000
7690: 30 20 2b 79 5f 30 3d 30 20 2b 65 6c 6c 70 73 3d 0 +y_0=0 +ellps=
76a0: 69 6e 74 6c 0d 0a 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d intl....--------
76b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
76c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 4f -------------..O
76d0: 70 65 72 61 74 69 6f 6e 20 6e c2 b0 32 3a 0d 0a peration n..2:..
76e0: 0d 0a 75 6e 6b 6e 6f 77 6e 20 69 64 2c 20 49 6e ..unknown id, In
76f0: 76 65 72 73 65 20 6f 66 20 4d 6f 6e 74 65 20 4d verse of Monte M
7700: 61 72 69 6f 20 74 6f 20 57 47 53 20 38 34 20 28 ario to WGS 84 (
7710: 32 29 20 2b 20 49 74 61 6c 79 20 7a 6f 6e 65 20 2) + Italy zone
7720: 31 2c 20 34 20 6d 2c 20 49 74 61 6c 79 20 2d 20 1, 4 m, Italy -
7730: 53 61 72 64 69 6e 69 61 20 6f 6e 73 68 6f 72 65 Sardinia onshore
7740: 0d 0a 0d 0a 50 52 4f 4a 20 73 74 72 69 6e 67 3a ....PROJ string:
7750: 0d 0a 2b 70 72 6f 6a 3d 70 69 70 65 6c 69 6e 65 ..+proj=pipeline
7760: 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 61 ..+step +proj=a
7770: 78 69 73 73 77 61 70 20 2b 6f 72 64 65 72 3d 32 xisswap +order=2
7780: 2c 31 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a ,1 ..+step +proj
7790: 3d 75 6e 69 74 63 6f 6e 76 65 72 74 20 2b 78 79 =unitconvert +xy
77a0: 5f 69 6e 3d 64 65 67 20 2b 78 79 5f 6f 75 74 3d _in=deg +xy_out=
77b0: 72 61 64 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f rad ..+step +pro
77c0: 6a 3d 70 75 73 68 20 2b 76 5f 33 20 0d 0a 2b 73 j=push +v_3 ..+s
77d0: 74 65 70 20 2b 70 72 6f 6a 3d 63 61 72 74 20 2b tep +proj=cart +
77e0: 65 6c 6c 70 73 3d 57 47 53 38 34 20 0d 0a 2b 73 ellps=WGS84 ..+s
77f0: 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d 68 tep +inv +proj=h
7800: 65 6c 6d 65 72 74 20 2b 78 3d 2d 31 36 38 2e 36 elmert +x=-168.6
7810: 20 2b 79 3d 2d 33 34 20 2b 7a 3d 33 38 2e 36 20 +y=-34 +z=38.6
7820: 2b 72 78 3d 2d 30 2e 33 37 34 20 2b 72 79 3d 2d +rx=-0.374 +ry=-
7830: 30 2e 36 37 39 20 2b 72 7a 3d 2d 31 2e 33 37 39 0.679 +rz=-1.379
7840: 20 2b 73 3d 2d 39 2e 34 38 20 2b 63 6f 6e 76 65 +s=-9.48 +conve
7850: 6e 74 69 6f 6e 3d 70 6f 73 69 74 69 6f 6e 5f 76 ntion=position_v
7860: 65 63 74 6f 72 20 0d 0a 2b 73 74 65 70 20 2b 69 ector ..+step +i
7870: 6e 76 20 2b 70 72 6f 6a 3d 63 61 72 74 20 2b 65 nv +proj=cart +e
7880: 6c 6c 70 73 3d 69 6e 74 6c 20 0d 0a 2b 73 74 65 llps=intl ..+ste
7890: 70 20 2b 70 72 6f 6a 3d 70 6f 70 20 2b 76 5f 33 p +proj=pop +v_3
78a0: 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 74 ..+step +proj=t
78b0: 6d 65 72 63 20 2b 6c 61 74 5f 30 3d 30 20 2b 6c merc +lat_0=0 +l
78c0: 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 2e 39 39 39 36 on_0=9 +k=0.9996
78d0: 20 2b 78 5f 30 3d 31 35 30 30 30 30 30 20 2b 79 +x_0=1500000 +y
78e0: 5f 30 3d 30 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c _0=0 +ellps=intl
78f0: 0d 0a 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ....------------
7900: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
7910: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 4f 70 65 72 61 ---------..Opera
7920: 74 69 6f 6e 20 6e c2 b0 33 3a 0d 0a 0d 0a 75 6e tion n..3:....un
7930: 6b 6e 6f 77 6e 20 69 64 2c 20 49 6e 76 65 72 73 known id, Invers
7940: 65 20 6f 66 20 4d 6f 6e 74 65 20 4d 61 72 69 6f e of Monte Mario
7950: 20 74 6f 20 57 47 53 20 38 34 20 28 31 31 29 20 to WGS 84 (11)
7960: 2b 20 49 74 61 6c 79 20 7a 6f 6e 65 20 31 2c 20 + Italy zone 1,
7970: 31 30 20 6d 2c 20 49 74 61 6c 79 20 2d 20 53 69 10 m, Italy - Si
7980: 63 69 6c 79 20 53 74 72 61 69 74 20 77 65 73 74 cily Strait west
7990: 20 6f 66 20 31 33 c2 b0 45 0d 0a 0d 0a 50 52 4f of 13..E....PRO
79a0: 4a 20 73 74 72 69 6e 67 3a 0d 0a 2b 70 72 6f 6a J string:..+proj
79b0: 3d 70 69 70 65 6c 69 6e 65 20 0d 0a 2b 73 74 65 =pipeline ..+ste
79c0: 70 20 2b 70 72 6f 6a 3d 61 78 69 73 73 77 61 70 p +proj=axisswap
79d0: 20 2b 6f 72 64 65 72 3d 32 2c 31 20 0d 0a 2b 73 +order=2,1 ..+s
79e0: 74 65 70 20 2b 70 72 6f 6a 3d 75 6e 69 74 63 6f tep +proj=unitco
79f0: 6e 76 65 72 74 20 2b 78 79 5f 69 6e 3d 64 65 67 nvert +xy_in=deg
7a00: 20 2b 78 79 5f 6f 75 74 3d 72 61 64 20 0d 0a 2b +xy_out=rad ..+
7a10: 73 74 65 70 20 2b 70 72 6f 6a 3d 70 75 73 68 20 step +proj=push
7a20: 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 +v_3 ..+step +pr
7a30: 6f 6a 3d 63 61 72 74 20 2b 65 6c 6c 70 73 3d 57 oj=cart +ellps=W
7a40: 47 53 38 34 20 0d 0a 2b 73 74 65 70 20 2b 70 72 GS84 ..+step +pr
7a50: 6f 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 3d 32 33 oj=helmert +x=23
7a60: 30 2e 34 37 20 2b 79 3d 35 36 2e 30 38 20 2b 7a 0.47 +y=56.08 +z
7a70: 3d 2d 32 32 2e 34 33 20 0d 0a 2b 73 74 65 70 20 =-22.43 ..+step
7a80: 2b 69 6e 76 20 2b 70 72 6f 6a 3d 63 61 72 74 20 +inv +proj=cart
7a90: 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20 0d 0a 2b 73 +ellps=intl ..+s
7aa0: 74 65 70 20 2b 70 72 6f 6a 3d 70 6f 70 20 2b 76 tep +proj=pop +v
7ab0: 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a _3 ..+step +proj
7ac0: 3d 74 6d 65 72 63 20 2b 6c 61 74 5f 30 3d 30 20 =tmerc +lat_0=0
7ad0: 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 2e 39 39 +lon_0=9 +k=0.99
7ae0: 39 36 20 2b 78 5f 30 3d 31 35 30 30 30 30 30 20 96 +x_0=1500000
7af0: 2b 79 5f 30 3d 30 20 2b 65 6c 6c 70 73 3d 69 6e +y_0=0 +ellps=in
7b00: 74 6c 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d tl..</verbatim>.
7b10: 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 .</td></tr>..</t
7b20: 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 76 65 72 62 able><br>..<verb
7b30: 61 74 69 6d 3e 0d 0a 2d 2d 20 74 6f 20 45 50 53 atim>..-- to EPS
7b40: 47 3a 33 30 30 33 20 2d 20 64 65 66 61 75 6c 74 G:3003 - default
7b50: 20 73 65 74 74 69 6e 67 73 2c 20 4e 55 4c 4c 20 settings, NULL
7b60: 61 72 65 61 20 6f 66 20 75 73 65 2c 20 2d 20 69 area of use, - i
7b70: 67 6e 6f 72 69 6e 67 20 73 70 61 74 69 61 6c 69 gnoring spatiali
7b80: 74 65 5f 72 65 66 5f 73 79 73 20 61 6e 64 20 75 te_ref_sys and u
7b90: 73 69 6e 67 20 74 68 65 20 50 52 4f 4a 2e 36 20 sing the PROJ.6
7ba0: 6f 77 6e 20 70 72 69 76 61 74 65 20 64 61 74 61 own private data
7bb0: 62 61 73 65 0d 0a 53 45 4c 45 43 54 20 41 73 45 base..SELECT AsE
7bc0: 57 4b 54 20 28 20 53 54 5f 54 72 61 6e 73 66 6f WKT ( ST_Transfo
7bd0: 72 6d 28 20 4d 61 6b 65 50 6f 69 6e 74 28 20 39 rm( MakePoint( 9
7be0: 2e 31 36 39 34 36 34 2c 20 33 39 2e 34 37 38 32 .169464, 39.4782
7bf0: 37 35 2c 20 34 33 32 36 20 29 2c 20 33 30 30 33 75, 4326 ), 3003
7c00: 20 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ));..----------
7c10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
7c20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 -----------..SRI
7c30: 44 3d 33 30 30 33 3b 50 4f 49 4e 54 28 31 35 31 D=3003;POINT(151
7c40: 34 36 30 30 2e 31 33 34 33 32 31 38 36 32 20 34 4600.134321862 4
7c50: 33 36 39 38 37 34 2e 34 38 39 32 36 39 39 35 37 369874.489269957
7c60: 29 0d 0a 0d 0a 2d 2d 20 74 6f 20 45 50 53 47 3a )....-- to EPSG:
7c70: 33 30 30 33 20 2d 20 73 61 6d 65 20 61 73 20 61 3003 - same as a
7c80: 62 6f 76 65 2c 20 62 75 74 20 65 78 70 6c 69 63 bove, but explic
7c90: 69 74 6c 79 20 64 65 66 69 6e 69 6e 67 20 61 20 itly defining a
7ca0: 73 70 65 63 69 66 69 63 20 61 72 65 61 20 6f 66 specific area of
7cb0: 20 75 73 65 0d 0a 53 45 4c 45 43 54 20 41 73 45 use..SELECT AsE
7cc0: 57 4b 54 20 28 20 53 54 5f 54 72 61 6e 73 66 6f WKT ( ST_Transfo
7cd0: 72 6d 28 20 4d 61 6b 65 50 6f 69 6e 74 28 20 39 rm( MakePoint( 9
7ce0: 2e 31 36 39 34 36 34 2c 20 33 39 2e 34 37 38 32 .169464, 39.4782
7cf0: 37 35 2c 20 34 33 32 36 20 29 2c 20 33 30 30 33 75, 4326 ), 3003
7d00: 20 2c 20 42 75 69 6c 64 4d 42 52 28 39 2e 31 20 , BuildMBR(9.1
7d10: 2c 20 33 39 2e 34 20 2c 20 39 2e 32 20 2c 20 33 , 39.4 , 9.2 , 3
7d20: 39 2e 35 20 2c 20 34 33 32 36 20 29 29 29 3b 0d 9.5 , 4326 )));.
7d30: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
7d40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
7d50: 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d 33 30 30 ------..SRID=300
7d60: 33 3b 50 4f 49 4e 54 28 31 35 31 34 36 30 35 2e 3;POINT(1514605.
7d70: 39 38 32 37 36 32 32 34 38 20 34 33 36 39 38 37 982762248 436987
7d80: 33 2e 30 30 34 32 32 36 39 34 33 29 0d 0a 3c 2f 3.004226943)..</
7d90: 76 65 72 62 61 74 69 6d 3e 0d 0a 54 68 69 72 64 verbatim>..Third
7da0: 20 61 6e 64 20 6c 61 73 74 20 65 78 61 6d 70 6c and last exampl
7db0: 65 2e 20 49 6e 20 73 6f 6d 65 20 63 61 73 65 73 e. In some cases
7dc0: 20 65 78 70 6c 69 63 69 74 6c 79 20 64 65 66 69 explicitly defi
7dd0: 6e 69 6e 67 20 61 20 73 70 65 63 69 66 69 63 20 ning a specific
7de0: 3c 62 3e 3c 69 3e 61 72 65 61 20 6f 66 20 75 73 <b><i>area of us
7df0: 65 3c 2f 69 3e 3c 2f 62 3e 20 6d 61 79 20 65 6e e</i></b> may en
7e00: 61 62 6c 65 20 50 52 4f 4a 2e 36 20 74 6f 20 73 able PROJ.6 to s
7e10: 65 6c 65 63 74 20 61 6e 20 6f 70 74 69 6d 69 7a elect an optimiz
7e20: 65 64 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f ed transformatio
7e30: 6e 20 6c 65 61 64 69 6e 67 20 74 6f 20 6d 6f 72 n leading to mor
7e40: 65 20 70 72 65 63 69 73 65 20 72 65 73 75 6c 74 e precise result
7e50: 73 2e 3c 62 72 3e 0d 0a 49 6e 20 74 68 69 73 20 s.<br>..In this
7e60: 65 78 61 6d 70 6c 65 20 77 65 27 76 65 20 75 73 example we've us
7e70: 65 64 20 61 20 50 6f 69 6e 74 20 6c 6f 63 61 74 ed a Point locat
7e80: 65 64 20 69 6e 20 53 61 72 64 69 6e 69 61 2c 20 ed in Sardinia,
7e90: 61 6e 64 20 50 52 4f 4a 2e 36 20 73 75 70 70 6f and PROJ.6 suppo
7ea0: 72 74 73 20 73 65 76 65 72 61 6c 20 66 6c 61 76 rts several flav
7eb0: 6f 72 73 20 6f 66 20 3c 62 3e 45 50 53 47 3a 33 ors of <b>EPSG:3
7ec0: 30 30 33 3c 2f 62 3e 20 64 65 70 65 6e 64 69 6e 003</b> dependin
7ed0: 67 20 6f 6e 20 74 68 65 20 73 70 65 63 69 66 69 g on the specifi
7ee0: 63 20 61 72 65 61 20 6f 66 20 75 73 65 2e 3c 62 c area of use.<b
7ef0: 72 3e 0d 0a 3c 62 3e 49 74 61 6c 79 20 2d 20 53 r>..<b>Italy - S
7f00: 61 72 64 69 6e 69 61 20 6f 6e 73 68 6f 72 65 3c ardinia onshore<
7f10: 2f 62 3e 20 69 73 20 6f 6e 65 20 62 65 74 77 65 /b> is one betwe
7f20: 65 6e 20 74 68 65 6d 2c 20 73 6f 20 61 66 74 65 en them, so afte
7f30: 72 20 73 70 65 63 69 66 79 69 6e 67 20 61 6e 20 r specifying an
7f40: 65 78 70 6c 69 63 69 74 20 3c 62 3e 61 72 65 61 explicit <b>area
7f50: 20 6f 66 20 75 73 65 3c 2f 62 3e 20 61 20 6d 6f of use</b> a mo
7f60: 72 65 20 70 72 65 63 69 73 65 20 74 72 61 6e 73 re precise trans
7f70: 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 6c 69 formation pipeli
7f80: 6e 65 20 77 61 73 20 73 65 6c 65 63 74 65 64 2e ne was selected.
7f90: 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 <br><br>..<table
7fa0: 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 cellspacing="8"
7fb0: 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 31 36 cellpadding="16
7fc0: 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 " bgcolor="#ffff
7fd0: 64 30 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a d0">..<tr><td>..
7fe0: 3c 62 3e 3c 75 3e 4c 65 73 73 6f 6e 20 6c 65 61 <b><u>Lesson lea
7ff0: 72 6e 65 64 3c 2f 75 3e 3c 2f 62 3e 3a 0d 0a 3c rned</u></b>:..<
8000: 75 6c 3e 0d 0a 3c 6c 69 3e 54 68 65 20 62 65 73 ul>..<li>The bes
8010: 74 20 6d 6f 64 65 20 66 6f 72 20 74 61 6b 69 6e t mode for takin
8020: 67 20 66 75 6c 6c 20 70 72 6f 66 69 74 20 66 72 g full profit fr
8030: 6f 6d 20 50 52 4f 4a 2e 36 20 69 73 20 62 79 20 om PROJ.6 is by
8040: 75 73 69 6e 67 20 3c 69 3e 6d 65 74 68 6f 64 3c using <i>method<
8050: 2f 69 3e 3d 3c 62 3e 61 75 74 68 5f 6e 61 6d 65 /i>=<b>auth_name
8060: 3a 61 75 74 68 5f 73 72 69 64 3c 2f 62 3e 20 28 :auth_srid</b> (
8070: 74 68 61 74 20 69 73 20 74 68 65 20 3c 62 3e 3c that is the <b><
8080: 69 3e 64 65 66 61 75 6c 74 20 73 65 74 74 69 6e i>default settin
8090: 67 3c 2f 69 3e 3c 2f 62 3e 29 2e 3c 62 72 3e 0d g</i></b>).<br>.
80a0: 0a 54 68 69 73 20 77 61 79 20 79 6f 75 27 6c 6c .This way you'll
80b0: 20 62 65 20 61 62 73 6f 6c 75 74 65 6c 79 20 73 be absolutely s
80c0: 75 72 65 20 74 68 61 74 20 74 68 65 20 6d 6f 73 ure that the mos
80d0: 74 20 72 65 63 65 6e 74 20 61 6e 64 20 66 75 6c t recent and ful
80e0: 6c 79 20 64 65 74 61 69 6c 65 64 20 64 65 66 69 ly detailed defi
80f0: 6e 69 74 69 6f 6e 73 20 77 69 6c 6c 20 62 65 20 nitions will be
8100: 61 6c 77 61 79 73 20 72 65 74 72 69 65 76 65 64 always retrieved
8110: 20 66 72 6f 6d 20 74 68 65 20 50 52 4f 4a 2e 36 from the PROJ.6
8120: 20 6f 77 6e 20 64 61 74 61 62 61 73 65 20 63 6f own database co
8130: 6d 70 6c 65 74 65 6c 79 20 69 67 6e 6f 72 69 6e mpletely ignorin
8140: 67 20 61 6e 79 20 64 65 66 69 6e 69 74 69 6f 6e g any definition
8150: 20 28 6d 61 79 20 62 65 20 69 6e 63 6f 6d 70 6c (may be incompl
8160: 65 74 65 20 6f 72 20 6f 62 73 6f 6c 65 74 65 29 ete or obsolete)
8170: 20 65 76 65 6e 74 75 61 6c 6c 79 20 73 74 6f 72 eventually stor
8180: 65 64 20 69 6e 74 6f 20 74 68 65 20 3c 62 3e 73 ed into the <b>s
8190: 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 3c 2f patial_ref_sys</
81a0: 62 3e 20 74 61 62 6c 65 2e 0d 0a 54 68 69 73 20 b> table...This
81b0: 69 73 20 61 20 70 61 72 74 69 63 75 6c 61 72 79 is a particulary
81c0: 20 75 73 65 66 75 6c 20 6f 70 74 69 6f 6e 20 77 useful option w
81d0: 68 65 6e 20 70 72 6f 63 65 73 73 69 6e 67 20 6f hen processing o
81e0: 6c 64 65 72 20 64 61 74 61 62 61 73 65 73 20 62 lder databases b
81f0: 65 69 6e 67 20 63 72 65 61 74 65 64 20 62 79 20 eing created by
8200: 65 61 72 6c 69 65 72 20 76 65 72 73 69 6f 6e 73 earlier versions
8210: 20 6f 66 20 53 70 61 74 69 61 4c 69 74 65 20 6e of SpatiaLite n
8220: 6f 74 20 79 65 74 20 73 75 70 70 6f 72 74 69 6e ot yet supportin
8230: 67 20 50 52 4f 4a 2e 36 3c 2f 6c 69 3e 0d 0a 3c g PROJ.6</li>..<
8240: 6c 69 3e 53 70 61 74 69 61 4c 69 74 65 20 64 6f li>SpatiaLite do
8250: 65 73 20 6e 6f 74 20 63 6f 6e 73 74 72 61 69 6e es not constrain
8260: 74 73 20 79 6f 75 20 69 6e 20 61 6e 79 20 77 61 ts you in any wa
8270: 79 20 61 6e 64 20 66 75 6c 6c 79 20 72 65 73 70 y and fully resp
8280: 65 63 74 73 20 75 73 65 72 73 20 66 72 65 65 64 ects users freed
8290: 6f 6d 20 63 61 72 65 66 75 6c 6c 79 20 61 76 6f om carefully avo
82a0: 69 64 69 6e 67 20 3c 69 3e 61 75 74 6f 2d 6d 61 iding <i>auto-ma
82b0: 67 69 63 61 6c 3c 2f 69 3e 20 61 73 73 75 6d 70 gical</i> assump
82c0: 74 69 6f 6e 73 2e 3c 62 72 3e 0d 0a 49 66 20 79 tions.<br>..If y
82d0: 6f 75 20 68 61 76 65 20 61 6e 79 20 67 6f 6f 64 ou have any good
82e0: 20 72 65 61 73 6f 6e 20 73 75 67 67 65 73 74 69 reason suggesti
82f0: 6e 67 20 74 6f 20 64 6f 20 73 75 63 68 20 61 20 ng to do such a
8300: 74 68 69 6e 67 20 79 6f 75 20 61 72 65 20 61 6e thing you are an
8310: 79 77 61 79 20 66 72 65 65 20 74 6f 20 75 73 65 yway free to use
8320: 20 74 68 65 20 70 72 6f 6a 2d 73 74 72 69 6e 67 the proj-string
8330: 73 20 28 3c 69 3e 6d 65 74 68 6f 64 3c 2f 69 3e s (<i>method</i>
8340: 3d 3c 62 3e 70 72 6f 6a 34 74 65 78 74 3c 2f 62 =<b>proj4text</b
8350: 3e 29 20 6f 72 20 74 68 65 20 57 4b 54 20 64 65 >) or the WKT de
8360: 66 69 6e 69 74 69 6f 6e 73 20 28 3c 69 3e 6d 65 finitions (<i>me
8370: 74 68 6f 64 3c 2f 69 3e 3d 3c 62 3e 73 72 74 65 thod</i>=<b>srte
8380: 78 74 3c 2f 62 3e 29 20 73 74 6f 72 65 64 20 69 xt</b>) stored i
8390: 6e 74 6f 20 74 68 65 20 3c 62 3e 73 70 61 74 69 nto the <b>spati
83a0: 61 6c 5f 72 65 66 5f 73 79 73 3c 2f 62 3e 20 74 al_ref_sys</b> t
83b0: 61 62 6c 65 2e 3c 62 72 3e 0d 0a 42 75 74 20 74 able.<br>..But t
83c0: 68 69 73 20 69 73 20 75 6e 64 65 72 20 79 6f 75 his is under you
83d0: 72 20 66 75 6c 6c 20 72 65 73 70 6f 6e 73 69 62 r full responsib
83e0: 69 6c 69 74 79 2c 20 61 6e 64 20 79 6f 75 20 6d ility, and you m
83f0: 75 73 74 20 62 65 20 77 65 6c 6c 20 73 75 72 65 ust be well sure
8400: 20 6f 66 20 77 68 61 74 20 61 72 65 20 79 6f 75 of what are you
8410: 20 64 6f 69 6e 67 2e 3c 2f 6c 69 3e 0d 0a 3c 6c doing.</li>..<l
8420: 69 3e 53 70 61 74 69 61 4c 69 74 65 20 65 6e 63 i>SpatiaLite enc
8430: 6f 75 72 61 67 65 73 20 61 6e 64 20 70 72 6f 6d ourages and prom
8440: 6f 74 65 73 20 74 68 65 20 6d 6f 73 74 20 63 72 otes the most cr
8450: 65 61 74 69 76 65 20 75 73 65 73 20 6f 66 20 50 eative uses of P
8460: 52 4f 4a 2e 36 2c 20 74 68 69 73 20 69 6e 63 6c ROJ.6, this incl
8470: 75 64 69 6e 67 20 3c 62 3e 3c 69 3e 74 72 61 6e uding <b><i>tran
8480: 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 6c sformation pipel
8490: 69 6e 65 73 3c 2f 69 3e 3c 2f 62 3e 2e 3c 62 72 ines</i></b>.<br
84a0: 3e 0d 0a 43 6f 72 72 65 63 74 6c 79 20 75 73 69 >..Correctly usi
84b0: 6e 67 20 3c 69 3e 6d 65 74 68 6f 64 3c 2f 69 3e ng <i>method</i>
84c0: 3d 3c 62 3e 70 72 6f 6a 5f 73 74 72 69 6e 67 3c =<b>proj_string<
84d0: 2f 62 3e 20 66 6f 72 20 63 6f 6d 70 75 74 69 6e /b> for computin
84e0: 67 20 63 75 73 74 6f 6d 20 74 72 61 6e 73 66 6f g custom transfo
84f0: 72 6d 61 74 69 6f 6e 73 20 69 73 6e 27 74 20 6e rmations isn't n
8500: 65 63 65 73 73 61 72 69 6c 79 20 73 69 6d 70 6c ecessarily simpl
8510: 65 20 61 6e 64 20 65 61 73 79 2c 20 62 75 74 20 e and easy, but
8520: 69 74 27 73 20 61 20 62 69 67 20 6f 70 70 6f 72 it's a big oppor
8530: 74 75 6e 69 74 79 20 66 6f 72 20 61 6c 6c 20 73 tunity for all s
8540: 6b 69 6c 6c 65 64 20 61 6e 64 20 74 61 6c 65 6e killed and talen
8550: 74 65 64 20 70 6f 77 65 72 20 75 73 65 72 73 2e ted power users.
8560: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 2f </li>..</ul>..</
8570: 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c td></tr>..</tabl
8580: 65 3e 3c 62 72 3e 0d 0a 3c 68 33 3e 4e 65 77 20 e><br>..<h3>New
8590: 61 75 78 69 6c 69 61 72 79 20 53 51 4c 20 66 75 auxiliary SQL fu
85a0: 6e 63 74 69 6f 6e 73 20 73 70 65 63 69 66 69 63 nctions specific
85b0: 61 6c 6c 79 20 73 75 70 70 6f 72 74 69 6e 67 20 ally supporting
85c0: 50 52 4f 4a 2e 36 3c 2f 68 33 3e 0d 0a 3c 74 61 PROJ.6</h3>..<ta
85d0: 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d ble cellspacing=
85e0: 22 38 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d "8" cellpadding=
85f0: 22 38 22 20 62 67 63 6f 6c 6f 72 3d 22 23 65 38 "8" bgcolor="#e8
8600: 66 66 65 38 22 20 62 6f 72 64 65 72 3d 22 31 22 ffe8" border="1"
8610: 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 67 63 6f 6c >..<tr><th bgcol
8620: 6f 72 3d 22 23 66 66 62 30 33 65 22 3e 53 51 4c or="#ffb03e">SQL
8630: 20 46 75 6e 63 74 69 6f 6e 3c 2f 74 68 3e 3c 74 Function</th><t
8640: 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 h bgcolor="#ffb0
8650: 33 65 22 3e 53 75 70 70 6f 72 74 65 64 20 61 72 3e">Supported ar
8660: 67 75 6d 65 6e 74 73 3c 2f 74 68 3e 3c 74 68 20 guments</th><th
8670: 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 bgcolor="#ffb03e
8680: 22 3e 44 65 73 63 72 69 70 74 69 6f 6e 3c 2f 74 ">Description</t
8690: 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 h></tr>..<tr><td
86a0: 3e 3c 62 3e 48 61 73 50 72 6f 6a 36 3c 2f 62 3e ><b>HasProj6</b>
86b0: 28 20 3c 69 3e 76 6f 69 64 3c 2f 69 3e 20 29 20 ( <i>void</i> )
86c0: 3a 20 3c 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e : <i>Boolean</i>
86d0: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4e 6f 6e 65 3c </td>..<td>None<
86e0: 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 72 /td>..<td>Will r
86f0: 65 74 75 72 6e 20 3c 62 3e 31 3c 2f 62 3e 20 28 eturn <b>1</b> (
8700: 3c 62 3e 54 52 55 45 3c 2f 62 3e 29 20 69 66 20 <b>TRUE</b>) if
8710: 74 68 65 20 6c 69 62 72 61 72 79 20 68 61 73 20 the library has
8720: 62 65 65 6e 20 62 75 69 6c 74 20 6f 6e 20 3c 62 been built on <b
8730: 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 20 28 6f 72 20 >PROJ.6</b> (or
8740: 61 6e 79 20 6c 61 74 65 72 20 76 65 72 73 69 6f any later versio
8750: 6e 29 2c 20 6f 74 68 65 72 77 69 73 65 20 3c 62 n), otherwise <b
8760: 3e 30 3c 2f 62 3e 20 28 3c 62 3e 46 41 4c 53 45 >0</b> (<b>FALSE
8770: 3c 2f 62 3e 29 2e 3c 2f 74 64 3e 3c 2f 74 72 3e </b>).</td></tr>
8780: 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f ..<tr><td><b>PRO
8790: 4a 5f 47 65 74 4c 61 73 74 45 72 72 6f 72 4d 73 J_GetLastErrorMs
87a0: 67 3c 2f 62 3e 28 20 3c 69 3e 76 6f 69 64 3c 2f g</b>( <i>void</
87b0: 69 3e 20 29 20 3a 20 3c 69 3e 53 74 72 69 6e 67 i> ) : <i>String
87c0: 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4e </i></td>..<td>N
87d0: 6f 6e 65 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 one</td>..<td>Wi
87e0: 6c 6c 20 72 65 74 75 72 6e 20 74 68 65 20 6d 6f ll return the mo
87f0: 73 74 20 72 65 63 65 6e 74 20 65 72 72 6f 72 20 st recent error
8800: 6d 65 73 73 61 67 65 20 72 65 74 75 72 6e 65 64 message returned
8810: 20 62 79 20 50 52 4f 4a 20 28 69 66 20 61 6e 79 by PROJ (if any
8820: 29 2e 3c 62 72 3e 0d 0a 3c 62 3e 4e 55 4c 4c 3c ).<br>..<b>NULL<
8830: 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72 65 74 75 /b> will be retu
8840: 72 6e 65 64 20 69 66 20 74 68 65 72 65 20 69 73 rned if there is
8850: 20 6e 6f 20 63 75 72 65 6e 74 6c 79 20 70 65 6e no curently pen
8860: 64 69 6e 67 20 50 52 4f 4a 20 65 72 72 6f 72 2e ding PROJ error.
8870: 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e </td></tr>..<tr>
8880: 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f 47 65 74 44 <td><b>PROJ_GetD
8890: 61 74 61 62 61 73 65 50 61 74 68 3c 2f 62 3e 28 atabasePath</b>(
88a0: 20 3c 69 3e 76 6f 69 64 3c 2f 69 3e 20 3a 20 3c <i>void</i> : <
88b0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 29 3c 2f 74 i>String</i>)</t
88c0: 64 3e 0d 0a 3c 74 64 3e 4e 6f 6e 65 3c 2f 74 64 d>..<td>None</td
88d0: 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75 >..<td>Will retu
88e0: 72 6e 20 74 68 65 20 63 75 72 72 65 6e 74 6c 79 rn the currently
88f0: 20 73 65 74 20 70 61 74 68 6e 61 6d 65 20 6c 65 set pathname le
8900: 61 64 69 6e 67 20 74 6f 20 74 68 65 20 70 72 69 ading to the pri
8910: 76 61 74 65 20 50 52 4f 4a 27 73 20 53 51 4c 69 vate PROJ's SQLi
8920: 74 65 20 64 61 74 61 62 61 73 65 2e 3c 62 72 3e te database.<br>
8930: 0d 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 ..<b>NULL</b> wi
8940: 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 69 ll be returned i
8950: 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20 70 72 f there is no pr
8960: 69 76 61 74 65 20 50 52 4f 4a 27 73 20 53 51 4c ivate PROJ's SQL
8970: 69 74 65 20 64 61 74 61 62 61 73 65 20 63 75 72 ite database cur
8980: 72 65 6e 74 6c 79 20 63 6f 6e 6e 65 63 74 65 64 rently connected
8990: 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 .</td></tr>..<tr
89a0: 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f 53 65 74 ><td><b>PROJ_Set
89b0: 44 61 74 61 62 61 73 65 50 61 74 68 3c 2f 62 3e DatabasePath</b>
89c0: 20 28 20 6e 65 77 5f 70 61 74 68 20 3c 69 3e 53 ( new_path <i>S
89d0: 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 tring</i> ) : <i
89e0: 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e >String</i></td>
89f0: 0d 0a 3c 74 64 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c ..<td>..<ul>..<l
8a00: 69 3e 3c 62 3e 6e 65 77 5f 70 61 74 68 3c 2f 62 i><b>new_path</b
8a10: 3e 3a 20 61 20 72 65 6c 61 74 69 76 65 20 6f 72 >: a relative or
8a20: 20 61 62 73 6f 6c 75 74 65 20 70 61 74 68 6e 61 absolute pathna
8a30: 6d 65 20 6c 65 61 64 69 6e 67 20 74 6f 20 61 20 me leading to a
8a40: 76 61 6c 69 64 20 50 52 4f 4a 27 73 20 53 51 4c valid PROJ's SQL
8a50: 69 74 65 20 64 61 74 61 62 61 73 65 2e 3c 2f 6c ite database.</l
8a60: 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 74 64 3e 0d 0a i>..</ul></td>..
8a70: 3c 74 64 3e 57 69 6c 6c 20 63 68 61 6e 67 65 20 <td>Will change
8a80: 74 68 65 20 63 75 72 72 65 6e 74 6c 79 20 73 65 the currently se
8a90: 74 20 70 61 74 68 6e 61 6d 65 20 6c 65 61 64 69 t pathname leadi
8aa0: 6e 67 20 74 6f 20 74 68 65 20 70 72 69 76 61 74 ng to the privat
8ab0: 65 20 50 52 4f 4a 27 73 20 53 51 4c 69 74 65 20 e PROJ's SQLite
8ac0: 64 61 74 61 62 61 73 65 2e 3c 62 72 3e 0d 0a 3c database.<br>..<
8ad0: 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 b>NULL</b> will
8ae0: 62 65 20 72 65 74 75 72 6e 65 64 20 69 66 20 74 be returned if t
8af0: 68 65 20 70 61 73 73 65 64 20 70 61 74 68 20 69 he passed path i
8b00: 73 20 69 6e 76 61 6c 69 64 2c 20 6f 74 68 65 72 s invalid, other
8b10: 77 69 73 65 20 74 68 65 20 70 61 74 68 20 6f 66 wise the path of
8b20: 20 74 68 65 20 63 75 72 72 65 6e 74 6c 79 20 73 the currently s
8b30: 65 74 20 70 72 69 76 61 74 65 20 50 52 4f 4a 27 et private PROJ'
8b40: 73 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 s SQLite databas
8b50: 65 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e e will be return
8b60: 65 64 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c ed.</td></tr>..<
8b70: 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f 41 tr><td><b>PROJ_A
8b80: 73 57 4b 54 3c 2f 62 3e 20 28 20 61 75 74 68 5f sWKT</b> ( auth_
8b90: 6e 61 6d 65 20 3c 69 3e 53 74 72 69 6e 67 3c 2f name <i>String</
8ba0: 69 3e 20 2c 20 61 75 74 68 5f 73 72 69 64 20 3c i> , auth_srid <
8bb0: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 i>Integer</i> )
8bc0: 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c : <i>String</i><
8bd0: 68 72 3e 0d 0a 3c 62 3e 50 52 4f 4a 5f 41 73 57 hr>..<b>PROJ_AsW
8be0: 4b 54 3c 2f 62 3e 20 28 20 61 75 74 68 5f 6e 61 KT</b> ( auth_na
8bf0: 6d 65 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e me <i>String</i>
8c00: 20 2c 20 61 75 74 68 5f 73 72 69 64 20 3c 69 3e , auth_srid <i>
8c10: 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 77 6b Integer</i> , wk
8c20: 74 5f 73 74 79 6c 65 20 3c 69 3e 53 74 72 69 6e t_style <i>Strin
8c30: 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 53 74 72 g</i> ) : <i>Str
8c40: 69 6e 67 3c 2f 69 3e 3c 68 72 3e 0d 0a 3c 62 3e ing</i><hr>..<b>
8c50: 50 52 4f 4a 5f 41 73 57 4b 54 3c 2f 62 3e 20 28 PROJ_AsWKT</b> (
8c60: 20 61 75 74 68 5f 6e 61 6d 65 20 3c 69 3e 53 74 auth_name <i>St
8c70: 72 69 6e 67 3c 2f 69 3e 20 2c 20 61 75 74 68 5f ring</i> , auth_
8c80: 73 72 69 64 20 3c 69 3e 49 6e 74 65 67 65 72 3c srid <i>Integer<
8c90: 2f 69 3e 20 2c 20 77 6b 74 5f 73 74 79 6c 65 20 /i> , wkt_style
8ca0: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 <i>String</i> ,
8cb0: 69 6e 64 65 6e 74 65 64 20 3c 69 3e 42 6f 6f 6c indented <i>Bool
8cc0: 65 61 6e 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 53 ean</i> ) : <i>S
8cd0: 74 72 69 6e 67 3c 2f 69 3e 3c 68 72 3e 0d 0a 3c tring</i><hr>..<
8ce0: 62 3e 50 52 4f 4a 5f 41 73 57 4b 54 3c 2f 62 3e b>PROJ_AsWKT</b>
8cf0: 20 28 20 61 75 74 68 5f 6e 61 6d 65 20 3c 69 3e ( auth_name <i>
8d00: 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 61 75 74 String</i> , aut
8d10: 68 5f 73 72 69 64 20 3c 69 3e 49 6e 74 65 67 65 h_srid <i>Intege
8d20: 72 3c 2f 69 3e 20 2c 20 77 6b 74 5f 73 74 79 6c r</i> , wkt_styl
8d30: 65 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 e <i>String</i>
8d40: 2c 20 69 6e 64 65 6e 74 65 64 20 3c 69 3e 42 6f , indented <i>Bo
8d50: 6f 6c 65 61 6e 3c 2f 69 3e 20 2c 20 69 6e 64 65 olean</i> , inde
8d60: 6e 74 61 74 69 6f 6e 20 3c 69 3e 49 6e 74 65 67 ntation <i>Integ
8d70: 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 53 74 er</i> ) : <i>St
8d80: 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c ring</i></td>..<
8d90: 74 64 3e 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e td><ul>..<li><b>
8da0: 61 75 74 68 5f 6e 61 6d 65 3c 2f 62 3e 20 61 6e auth_name</b> an
8db0: 64 20 3c 62 3e 61 75 74 68 5f 73 72 69 64 3c 2f d <b>auth_srid</
8dc0: 62 3e 20 69 64 65 6e 74 69 66 79 20 74 68 65 20 b> identify the
8dd0: 69 6e 74 65 6e 64 65 64 20 43 52 53 2e 3c 62 72 intended CRS.<br
8de0: 3e 0d 0a 3c 62 3e 61 75 74 68 5f 6e 61 6d 65 3c >..<b>auth_name<
8df0: 2f 62 3e 20 63 61 6e 20 62 65 20 3c 62 3e 4e 55 /b> can be <b>NU
8e00: 4c 4c 3c 2f 62 3e 2c 20 61 6e 64 20 69 6e 20 74 LL</b>, and in t
8e10: 68 69 73 20 63 61 73 65 20 3c 62 3e 45 50 53 47 his case <b>EPSG
8e20: 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 61 73 73 </b> will be ass
8e30: 75 6d 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e umed.</li>..<li>
8e40: 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 the optional arg
8e50: 75 6d 65 6e 74 20 3c 62 3e 73 74 79 6c 65 3c 2f ument <b>style</
8e60: 62 3e 20 64 65 74 65 72 6d 69 6e 65 73 20 77 68 b> determines wh
8e70: 69 63 68 20 73 70 65 63 69 66 69 63 20 57 4b 54 ich specific WKT
8e80: 20 66 6f 72 6d 61 74 20 73 68 6f 75 6c 64 20 62 format should b
8e90: 65 20 61 64 6f 70 74 65 64 2c 20 61 6e 64 20 6d e adopted, and m
8ea0: 75 73 74 20 62 65 20 6f 6e 65 20 62 65 74 77 65 ust be one betwe
8eb0: 65 6e 20 3c 62 3e 47 44 41 4c 3c 2f 62 3e 2c 20 en <b>GDAL</b>,
8ec0: 3c 62 3e 45 53 52 49 3c 2f 62 3e 2c 20 3c 62 3e <b>ESRI</b>, <b>
8ed0: 49 53 4f 2d 32 30 31 35 3c 2f 62 3e 20 6f 72 20 ISO-2015</b> or
8ee0: 3c 62 3e 49 53 4f 2d 32 30 31 38 3c 2f 62 3e 20 <b>ISO-2018</b>
8ef0: 28 74 68 69 73 20 6c 61 74 74 65 72 20 62 65 69 (this latter bei
8f00: 6e 67 20 74 68 65 20 64 65 66 61 75 6c 74 20 73 ng the default s
8f10: 65 74 74 69 6e 67 29 2e 3c 2f 6c 69 3e 0d 0a 3c etting).</li>..<
8f20: 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 li>the optional
8f30: 61 72 67 75 6d 65 6e 74 20 3c 62 3e 69 6e 64 65 argument <b>inde
8f40: 6e 74 65 64 3c 2f 62 3e 20 69 66 20 73 65 74 20 nted</b> if set
8f50: 74 6f 20 3c 62 3e 54 52 55 45 3c 2f 62 3e 20 77 to <b>TRUE</b> w
8f60: 69 6c 6c 20 6e 69 63 65 6c 79 20 66 6f 72 6d 61 ill nicely forma
8f70: 74 20 61 20 6d 75 6c 74 69 6c 69 6e 65 20 57 4b t a multiline WK
8f80: 54 20 65 78 70 72 65 73 73 69 6f 6e 2c 20 6f 74 T expression, ot
8f90: 68 65 72 77 69 73 65 20 61 20 73 69 6e 67 6c 65 herwise a single
8fa0: 20 6d 6f 6e 6f 6c 69 74 68 69 63 20 6c 69 6e 65 monolithic line
8fb0: 20 6c 61 63 6b 69 6e 67 20 61 6e 79 20 77 68 69 lacking any whi
8fc0: 74 65 2d 73 70 61 63 65 20 6f 72 20 6e 65 77 2d te-space or new-
8fd0: 6c 69 6e 65 20 77 69 6c 6c 20 62 65 20 70 72 69 line will be pri
8fe0: 6e 74 65 64 20 28 74 68 65 20 64 65 66 61 75 6c nted (the defaul
8ff0: 74 20 69 73 20 3c 62 3e 54 52 55 45 3c 2f 62 3e t is <b>TRUE</b>
9000: 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 ).</li>..<li>the
9010: 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 optional argume
9020: 6e 74 20 3c 62 3e 69 6e 64 65 6e 74 61 74 69 6f nt <b>indentatio
9030: 6e 3c 2f 62 3e 20 64 65 74 65 72 6d 69 6e 65 73 n</b> determines
9040: 20 68 6f 77 20 6d 61 6e 79 20 77 68 69 74 65 2d how many white-
9050: 73 70 61 63 65 73 20 61 72 65 20 74 6f 20 62 65 spaces are to be
9060: 20 75 73 65 64 20 66 6f 72 20 69 6e 64 65 6e 74 used for indent
9070: 69 6e 67 20 28 6f 6e 6c 79 20 6d 65 61 6e 69 6e ing (only meanin
9080: 67 66 75 6c 20 69 66 20 3c 62 3e 3c 69 3e 69 6e gful if <b><i>in
9090: 64 65 6e 74 65 64 3d 54 52 55 45 3c 2f 69 3e 3c dented=TRUE</i><
90a0: 2f 62 3e 3b 20 74 68 65 20 64 65 66 61 75 6c 74 /b>; the default
90b0: 20 76 61 6c 75 65 73 20 69 73 20 3c 62 3e 34 3c values is <b>4<
90c0: 2f 62 3e 29 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c /b>).</li>..</ul
90d0: 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c ></td>..<td>Will
90e0: 20 72 65 74 75 72 6e 20 74 68 65 20 57 4b 54 20 return the WKT
90f0: 65 78 70 72 65 73 73 69 6f 6e 20 63 6f 72 72 65 expression corre
9100: 73 70 6f 6e 64 69 6e 67 20 74 6f 20 61 20 67 69 sponding to a gi
9110: 76 65 6e 20 43 52 53 3b 20 74 68 65 20 64 65 66 ven CRS; the def
9120: 69 6e 69 74 69 6f 6e 73 20 77 69 6c 6c 20 62 65 initions will be
9130: 20 74 61 6b 65 6e 20 64 69 72 65 63 74 6c 79 20 taken directly
9140: 66 72 6f 6d 20 74 68 65 20 70 72 69 76 61 74 65 from the private
9150: 20 50 52 4f 4a 27 73 20 6f 77 6e 20 64 61 74 61 PROJ's own data
9160: 62 61 73 65 2e 3c 62 72 3e 0d 0a 3c 62 3e 4e 55 base.<br>..<b>NU
9170: 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72 LL</b> will be r
9180: 65 74 75 72 6e 65 64 20 6f 6e 20 66 61 69 6c 75 eturned on failu
9190: 72 65 20 6f 72 20 6f 6e 20 69 6e 76 61 6c 69 64 re or on invalid
91a0: 20 61 72 67 75 6d 65 6e 74 73 2e 3c 2f 74 64 3e arguments.</td>
91b0: 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c </tr>..<tr><td><
91c0: 62 3e 50 52 4f 4a 5f 47 75 65 73 73 53 72 69 64 b>PROJ_GuessSrid
91d0: 46 72 6f 6d 57 4b 54 3c 2f 62 3e 20 28 20 77 6b FromWKT</b> ( wk
91e0: 74 5f 65 78 70 72 20 3c 69 3e 53 74 72 69 6e 67 t_expr <i>String
91f0: 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 6e 74 65 </i> ) : <i>Inte
9200: 67 65 72 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 ger</i></td>..<t
9210: 64 3e 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 77 d><ul>..<li><b>w
9220: 6b 74 5f 65 78 70 72 3c 2f 62 3e 3a 20 74 68 65 kt_expr</b>: the
9230: 20 57 4b 54 20 65 78 70 72 65 73 73 69 6f 6e 20 WKT expression
9240: 74 6f 20 62 65 20 65 76 61 6c 75 61 74 65 64 2e to be evaluated.
9250: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 74 64 </li>..</ul></td
9260: 3e 0d 0a 3c 74 64 3e 0d 0a 57 69 6c 6c 20 70 6f >..<td>..Will po
9270: 73 73 69 62 6c 79 20 72 65 74 75 72 6e 20 74 68 ssibly return th
9280: 65 20 3c 62 3e 53 52 49 44 20 76 61 6c 75 65 3c e <b>SRID value<
9290: 2f 62 3e 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e /b> correspondin
92a0: 67 20 74 6f 20 61 20 67 69 76 65 6e 20 57 4b 54 g to a given WKT
92b0: 20 65 78 70 72 65 73 73 69 6f 6e 20 64 65 66 69 expression defi
92c0: 6e 69 6e 67 20 61 20 43 52 53 2e 3c 62 72 3e 0d ning a CRS.<br>.
92d0: 0a 3c 62 3e 2d 31 3c 2f 62 3e 20 77 69 6c 6c 20 .<b>-1</b> will
92e0: 62 65 20 72 65 74 75 72 6e 65 64 20 69 66 20 6e be returned if n
92f0: 6f 20 43 52 53 20 73 75 70 70 6f 72 74 65 64 20 o CRS supported
9300: 62 79 20 50 52 4f 4a 2e 36 20 6d 61 74 63 68 65 by PROJ.6 matche
9310: 73 20 74 68 65 20 57 4b 54 20 65 78 70 72 65 73 s the WKT expres
9320: 73 69 6f 6e 2e 3c 62 72 3e 0d 0a 3c 62 3e 4e 55 sion.<br>..<b>NU
9330: 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72 LL</b> will be r
9340: 65 74 75 72 6e 65 64 20 6f 6e 20 69 6e 76 61 6c eturned on inval
9350: 69 64 20 61 72 67 75 6d 65 6e 74 2e 0d 0a 3c 2f id argument...</
9360: 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 td></tr>..<tr><t
9370: 64 3e 3c 62 3e 50 52 4f 4a 5f 47 75 65 73 73 53 d><b>PROJ_GuessS
9380: 72 69 64 46 72 6f 6d 53 48 50 3c 2f 62 3e 20 28 ridFromSHP</b> (
9390: 20 66 69 6c 65 6e 61 6d 65 20 3c 69 3e 53 74 72 filename <i>Str
93a0: 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 ing</i> ) : <i>I
93b0: 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 64 3e 0d nteger</i></td>.
93c0: 0a 3c 74 64 3e 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c .<td><ul>..<li><
93d0: 62 3e 66 69 6c 65 6e 61 6d 65 3c 2f 62 3e 3a 20 b>filename</b>:
93e0: 74 68 65 20 61 62 73 6f 6c 75 74 65 20 6f 72 20 the absolute or
93f0: 72 65 6c 61 74 69 76 65 20 70 61 74 68 20 6c 65 relative path le
9400: 61 64 69 6e 67 20 74 6f 20 73 6f 6d 65 20 53 68 ading to some Sh
9410: 61 70 65 66 69 6c 65 2e 3c 62 72 3e 0d 0a 4e 6f apefile.<br>..No
9420: 74 65 3a 20 65 78 61 63 74 6c 65 79 20 61 73 20 te: exactley as
9430: 72 65 71 75 69 72 65 64 20 62 79 20 3c 62 3e 3c required by <b><
9440: 69 3e 49 6d 70 6f 72 74 53 48 50 3c 2f 69 3e 3c i>ImportSHP</i><
9450: 2f 62 3e 28 29 20 3c 62 3e 3c 69 3e 66 69 6c 65 /b>() <b><i>file
9460: 6e 61 6d 65 3c 2f 69 3e 3c 2f 62 3e 20 6d 75 73 name</i></b> mus
9470: 74 20 6f 6d 69 74 20 61 6e 79 20 3c 62 3e 2e 73 t omit any <b>.s
9480: 68 70 3c 2f 62 3e 2c 20 3c 62 3e 2e 73 68 78 3c hp</b>, <b>.shx<
9490: 2f 62 3e 2c 20 3c 62 3e 2e 64 62 66 3c 2f 62 3e /b>, <b>.dbf</b>
94a0: 20 6f 72 20 3c 62 3e 2e 70 72 6a 3c 2f 62 3e 20 or <b>.prj</b>
94b0: 73 75 66 66 69 78 2e 3c 2f 6c 69 3e 0d 0a 3c 2f suffix.</li>..</
94c0: 75 6c 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a ul></td>..<td>..
94d0: 57 69 6c 6c 20 70 6f 73 73 69 62 6c 79 20 72 65 Will possibly re
94e0: 74 75 72 6e 20 74 68 65 20 3c 62 3e 53 52 49 44 turn the <b>SRID
94f0: 20 76 61 6c 75 65 3c 2f 62 3e 20 63 6f 72 72 65 value</b> corre
9500: 73 70 6f 6e 64 69 6e 67 20 74 6f 20 74 68 65 20 sponding to the
9510: 43 52 53 20 64 65 66 69 6e 65 64 20 62 79 20 74 CRS defined by t
9520: 68 65 20 2e 50 52 4a 20 6d 65 6d 62 65 72 20 6f he .PRJ member o
9530: 66 20 74 68 65 20 53 68 61 70 65 66 69 6c 65 2e f the Shapefile.
9540: 3c 62 72 3e 0d 0a 3c 62 3e 2d 31 3c 2f 62 3e 20 <br>..<b>-1</b>
9550: 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 will be returned
9560: 20 69 66 20 6e 6f 20 43 52 53 20 73 75 70 70 6f if no CRS suppo
9570: 72 74 65 64 20 62 79 20 50 52 4f 4a 2e 36 20 6d rted by PROJ.6 m
9580: 61 74 63 68 65 73 20 50 52 4a 20 6d 65 6d 62 65 atches PRJ membe
9590: 72 20 6f 66 20 74 68 65 20 53 68 61 70 65 66 69 r of the Shapefi
95a0: 6c 65 2e 3c 62 72 3e 0d 0a 3c 62 3e 4e 55 4c 4c le.<br>..<b>NULL
95b0: 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72 65 74 </b> will be ret
95c0: 75 72 6e 65 64 20 6f 6e 20 69 6e 76 61 6c 69 64 urned on invalid
95d0: 20 61 72 67 75 6d 65 6e 74 2e 3c 68 72 3e 0d 0a argument.<hr>..
95e0: 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74 65 20 77 <u>Please note w
95f0: 65 6c 6c 3c 2f 75 3e 3a 20 74 68 69 73 20 53 51 ell</u>: this SQ
9600: 4c 20 66 75 6e 63 74 69 6f 6e 20 6f 70 65 6e 64 L function opend
9610: 20 74 68 65 20 64 6f 6f 72 20 74 6f 20 6d 61 6e the door to man
9620: 79 20 70 6f 74 65 6e 74 69 61 6c 20 73 65 63 75 y potential secu
9630: 72 69 74 79 20 69 73 73 75 65 73 2c 20 61 6e 64 rity issues, and
9640: 20 74 68 75 73 20 69 73 20 61 6c 77 61 79 73 20 thus is always
9650: 3c 69 3e 64 69 73 61 62 6c 65 64 20 62 79 20 64 <i>disabled by d
9660: 65 66 61 75 6c 74 3c 2f 69 3e 2e 3c 62 72 3e 0d efault</i>.<br>.
9670: 0a 45 78 70 6c 69 63 69 74 6c 79 20 73 65 74 74 .Explicitly sett
9680: 69 6e 67 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d ing the environm
9690: 65 6e 74 20 76 61 72 69 61 62 6c 65 20 3c 62 3e ent variable <b>
96a0: 53 50 41 54 49 41 4c 49 54 45 5f 53 45 43 55 52 SPATIALITE_SECUR
96b0: 49 54 59 3d 72 65 6c 61 78 65 64 3c 2f 62 3e 20 ITY=relaxed</b>
96c0: 69 73 20 61 62 73 6f 6c 75 74 65 6c 79 20 72 65 is absolutely re
96d0: 71 75 69 72 65 64 20 69 6e 20 6f 72 64 65 72 20 quired in order
96e0: 74 6f 20 65 6e 61 62 6c 65 20 74 68 69 73 20 66 to enable this f
96f0: 75 6e 63 74 69 6f 6e 2e 0d 0a 3c 2f 74 64 3e 3c unction...</td><
9700: 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 /tr>..</table><b
9710: 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 r>..<table cells
9720: 70 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 pacing="8" cellp
9730: 61 64 64 69 6e 67 3d 22 31 36 22 20 62 67 63 6f adding="16" bgco
9740: 6c 6f 72 3d 22 23 66 66 66 66 65 39 22 3e 0d 0a lor="#ffffe9">..
9750: 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 62 3e 3c 75 3e <tr><td>..<b><u>
9760: 4e 6f 74 65 3c 2f 75 3e 3c 2f 62 3e 3a 20 61 6c Note</u></b>: al
9770: 6c 20 74 68 65 20 61 62 6f 76 65 20 53 51 4c 20 l the above SQL
9780: 46 75 6e 63 74 69 6f 6e 73 20 77 69 6c 6c 20 62 Functions will b
9790: 65 20 61 76 61 69 6c 61 62 6c 65 20 6f 6e 6c 79 e available only
97a0: 20 77 68 65 6e 20 53 70 61 74 69 61 6c 69 74 65 when Spatialite
97b0: 2d 35 2e 30 2e 30 20 68 61 73 20 62 65 65 6e 20 -5.0.0 has been
97c0: 62 75 69 6c 74 20 61 67 61 69 6e 73 74 20 3c 62 built against <b
97d0: 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 20 28 6f 72 20 >PROJ.6</b> (or
97e0: 61 6e 79 20 73 75 62 73 65 71 75 65 6e 74 20 76 any subsequent v
97f0: 65 72 73 69 6f 6e 29 2e 3c 62 72 3e 0d 0a 49 66 ersion).<br>..If
9800: 20 53 70 61 74 69 61 4c 69 74 65 2d 35 2e 30 2e SpatiaLite-5.0.
9810: 30 20 68 61 73 20 62 65 65 6e 20 62 75 69 6c 74 0 has been built
9820: 20 69 6e 73 74 65 61 64 20 61 67 61 69 6e 73 74 instead against
9830: 20 61 6e 79 20 70 72 65 76 69 6f 73 75 73 20 76 any previosus v
9840: 65 72 73 69 6f 6e 20 28 61 73 20 65 2e 67 2e 20 ersion (as e.g.
9850: 3c 62 3e 50 52 4f 4a 2e 34 3c 2f 62 3e 29 20 61 <b>PROJ.4</b>) a
9860: 6e 79 20 61 74 74 65 6d 70 74 20 74 6f 20 63 61 ny attempt to ca
9870: 6c 6c 20 6f 6e 65 20 6f 66 20 74 68 65 73 65 20 ll one of these
9880: 53 51 4c 20 46 75 6e 63 74 69 6f 6e 73 20 77 69 SQL Functions wi
9890: 6c 6c 20 73 69 6d 70 6c 79 20 72 65 74 75 72 6e ll simply return
98a0: 20 61 20 3c 62 3e 3c 69 3e 3c 75 3e 6e 6f 20 73 a <b><i><u>no s
98b0: 75 63 68 20 66 75 6e 63 74 69 6f 6e 3c 2f 75 3e uch function</u>
98c0: 3c 2f 69 3e 3c 2f 62 3e 20 53 51 4c 20 65 72 72 </i></b> SQL err
98d0: 6f 72 2e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d or...</td></tr>.
98e0: 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c .</table><br>..<
98f0: 62 3e 50 72 61 63 74 69 63 61 6c 20 65 78 61 6d b>Practical exam
9900: 70 6c 65 73 3a 3c 2f 62 3e 0d 0a 3c 76 65 72 62 ples:</b>..<verb
9910: 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 54 20 50 52 atim>..SELECT PR
9920: 4f 4a 5f 47 65 74 44 61 74 61 62 61 73 65 50 61 OJ_GetDatabasePa
9930: 74 68 28 29 3b 20 20 2d 2d 20 72 65 74 72 69 65 th(); -- retrie
9940: 76 69 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74 ving the current
9950: 6c 79 20 73 65 74 20 50 52 4f 4a 27 73 20 6f 77 ly set PROJ's ow
9960: 6e 20 64 61 74 61 62 61 73 65 0d 0a 2d 2d 2d 2d n database..----
9970: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9980: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 2f 75 73 72 ----------../usr
9990: 2f 6c 6f 63 61 6c 2f 73 68 61 72 65 2f 70 72 6f /local/share/pro
99a0: 6a 2f 70 72 6f 6a 2e 64 62 0d 0a 0d 0a 53 45 4c j/proj.db....SEL
99b0: 45 43 54 20 50 52 4f 4a 5f 53 65 74 44 61 74 61 ECT PROJ_SetData
99c0: 62 61 73 65 50 61 74 68 28 27 2f 68 6f 6d 65 2f basePath('/home/
99d0: 73 61 6e 64 72 6f 2f 6e 6f 74 5f 65 78 69 73 74 sandro/not_exist
99e0: 69 6e 67 5f 70 72 6f 6a 2e 64 62 27 29 3b 20 2d ing_proj.db'); -
99f0: 2d 20 6e 6f 6e 20 65 78 69 73 74 69 6e 67 20 64 - non existing d
9a00: 61 74 61 62 61 73 65 0d 0a 2d 2d 2d 2d 2d 2d 2d atabase..-------
9a10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9a20: 2d 2d 2d 2d 2d 2d 2d 0d 0a 4e 55 4c 4c 0d 0a 0d -------..NULL...
9a30: 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f 47 65 74 .SELECT PROJ_Get
9a40: 4c 61 73 74 45 72 72 6f 72 4d 73 67 28 29 3b 20 LastErrorMsg();
9a50: 2d 2d 20 72 65 74 72 69 65 76 69 6e 67 20 74 68 -- retrieving th
9a60: 65 20 66 61 69 6c 75 72 65 20 63 61 75 73 65 0d e failure cause.
9a70: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
9a80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d ---------------.
9a90: 0a 70 72 6f 6a 5f 63 6f 6e 74 65 78 74 5f 73 65 .proj_context_se
9aa0: 74 5f 64 61 74 61 62 61 73 65 5f 70 61 74 68 3a t_database_path:
9ab0: 20 4f 70 65 6e 20 6f 66 20 2f 68 6f 6d 65 2f 73 Open of /home/s
9ac0: 61 6e 64 72 6f 2f 6e 6f 74 5f 65 78 69 73 74 69 andro/not_existi
9ad0: 6e 67 5f 70 72 6f 6a 2e 64 62 20 66 61 69 6c 65 ng_proj.db faile
9ae0: 64 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a d....SELECT PROJ
9af0: 5f 53 65 74 44 61 74 61 62 61 73 65 50 61 74 68 _SetDatabasePath
9b00: 28 27 2f 68 6f 6d 65 2f 73 61 6e 64 72 6f 2f 76 ('/home/sandro/v
9b10: 61 6c 69 64 5f 70 72 6f 6a 2e 64 62 27 29 3b 20 alid_proj.db');
9b20: 2d 2d 20 76 61 6c 69 64 20 64 61 74 61 62 61 73 -- valid databas
9b30: 65 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d e..-------------
9b40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9b50: 2d 0d 0a 2f 68 6f 6d 65 2f 73 61 6e 64 72 6f 2f -../home/sandro/
9b60: 76 61 6c 69 64 5f 70 72 6f 6a 2e 64 62 0d 0a 0d valid_proj.db...
9b70: 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f 41 73 57 .SELECT PROJ_AsW
9b80: 4b 54 28 27 45 50 53 47 27 2c 20 34 33 32 36 29 KT('EPSG', 4326)
9b90: 3b 20 2d 2d 20 64 65 66 61 75 6c 74 20 73 65 74 ; -- default set
9ba0: 74 69 6e 67 73 3a 20 49 53 4f 2d 32 30 31 38 20 tings: ISO-2018
9bb0: 73 74 79 6c 65 2c 20 69 6e 64 65 6e 74 65 64 20 style, indented
9bc0: 77 69 74 68 20 69 6e 64 65 6e 74 61 74 69 6f 6e with indentation
9bd0: 20 34 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 4..------------
9be0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9bf0: 2d 2d 0d 0a 47 45 4f 44 43 52 53 5b 22 57 47 53 --..GEODCRS["WGS
9c00: 20 38 34 22 2c 0d 0a 20 20 20 20 44 41 54 55 4d 84",.. DATUM
9c10: 5b 22 57 6f 72 6c 64 20 47 65 6f 64 65 74 69 63 ["World Geodetic
9c20: 20 53 79 73 74 65 6d 20 31 39 38 34 22 2c 0d 0a System 1984",..
9c30: 20 20 20 20 20 20 20 20 45 4c 4c 49 50 53 4f 49 ELLIPSOI
9c40: 44 5b 22 57 47 53 20 38 34 22 2c 36 33 37 38 31 D["WGS 84",63781
9c50: 33 37 2c 32 39 38 2e 32 35 37 32 32 33 35 36 33 37,298.257223563
9c60: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4c ,.. L
9c70: 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 74 72 65 ENGTHUNIT["metre
9c80: 22 2c 31 5d 5d 5d 2c 0d 0a 20 20 20 20 50 52 49 ",1]]],.. PRI
9c90: 4d 45 4d 5b 22 47 72 65 65 6e 77 69 63 68 22 2c MEM["Greenwich",
9ca0: 30 2c 0d 0a 20 20 20 20 20 20 20 20 41 4e 47 4c 0,.. ANGL
9cb0: 45 55 4e 49 54 5b 22 64 65 67 72 65 65 22 2c 30 EUNIT["degree",0
9cc0: 2e 30 31 37 34 35 33 32 39 32 35 31 39 39 34 33 .017453292519943
9cd0: 33 5d 5d 2c 0d 0a 20 20 20 20 43 53 5b 65 6c 6c 3]],.. CS[ell
9ce0: 69 70 73 6f 69 64 61 6c 2c 32 5d 2c 0d 0a 20 20 ipsoidal,2],..
9cf0: 20 20 20 20 20 20 41 58 49 53 5b 22 67 65 6f 64 AXIS["geod
9d00: 65 74 69 63 20 6c 61 74 69 74 75 64 65 20 28 4c etic latitude (L
9d10: 61 74 29 22 2c 6e 6f 72 74 68 2c 0d 0a 20 20 20 at)",north,..
9d20: 20 20 20 20 20 20 20 20 20 4f 52 44 45 52 5b 31 ORDER[1
9d30: 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ],..
9d40: 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 ANGLEUNIT["degre
9d50: 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 e",0.01745329251
9d60: 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20 20 20 99433]],..
9d70: 20 20 41 58 49 53 5b 22 67 65 6f 64 65 74 69 63 AXIS["geodetic
9d80: 20 6c 6f 6e 67 69 74 75 64 65 20 28 4c 6f 6e 29 longitude (Lon)
9d90: 22 2c 65 61 73 74 2c 0d 0a 20 20 20 20 20 20 20 ",east,..
9da0: 20 20 20 20 20 4f 52 44 45 52 5b 32 5d 2c 0d 0a ORDER[2],..
9db0: 20 20 20 20 20 20 20 20 20 20 20 20 41 4e 47 4c ANGL
9dc0: 45 55 4e 49 54 5b 22 64 65 67 72 65 65 22 2c 30 EUNIT["degree",0
9dd0: 2e 30 31 37 34 35 33 32 39 32 35 31 39 39 34 33 .017453292519943
9de0: 33 5d 5d 2c 0d 0a 20 20 20 20 41 52 45 41 5b 22 3]],.. AREA["
9df0: 57 6f 72 6c 64 22 5d 2c 0d 0a 20 20 20 20 42 42 World"],.. BB
9e00: 4f 58 5b 2d 39 30 2c 2d 31 38 30 2c 39 30 2c 31 OX[-90,-180,90,1
9e10: 38 30 5d 2c 0d 0a 20 20 20 20 49 44 5b 22 45 50 80],.. ID["EP
9e20: 53 47 22 2c 34 33 32 36 5d 5d 0d 0a 0d 0a 53 45 SG",4326]]....SE
9e30: 4c 45 43 54 20 50 52 4f 4a 5f 41 73 57 4b 54 28 LECT PROJ_AsWKT(
9e40: 27 45 50 53 47 27 2c 20 34 33 32 36 2c 20 27 45 'EPSG', 4326, 'E
9e50: 53 52 49 27 2c 20 30 2c 20 30 29 3b 20 2d 2d 20 SRI', 0, 0); --
9e60: 45 53 52 49 20 73 74 79 6c 65 2c 20 6d 6f 6e 6f ESRI style, mono
9e70: 6c 69 74 68 69 63 20 6c 69 6e 65 0d 0a 2d 2d 2d lithic line..---
9e80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9e90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 47 45 4f -----------..GEO
9ea0: 47 43 53 5b 22 47 43 53 5f 57 47 53 5f 31 39 38 GCS["GCS_WGS_198
9eb0: 34 22 2c 44 41 54 55 4d 5b 22 44 5f 57 47 53 5f 4",DATUM["D_WGS_
9ec0: 31 39 38 34 22 2c 53 50 48 45 52 4f 49 44 5b 22 1984",SPHEROID["
9ed0: 57 47 53 5f 31 39 38 34 22 2c 36 33 37 38 31 33 WGS_1984",637813
9ee0: 37 2e 30 2c 32 39 38 2e 32 35 37 32 32 33 35 36 7.0,298.25722356
9ef0: 33 5d 5d 2c 50 52 49 4d 45 4d 5b 22 47 72 65 65 3]],PRIMEM["Gree
9f00: 6e 77 69 63 68 22 2c 30 2e 30 5d 2c 55 4e 49 54 nwich",0.0],UNIT
9f10: 5b 22 44 65 67 72 65 65 22 2c 30 2e 30 31 37 34 ["Degree",0.0174
9f20: 35 33 32 39 32 35 31 39 39 34 33 33 5d 5d 0d 0a 532925199433]]..
9f30: 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f 47 75 ..SELECT PROJ_Gu
9f40: 65 73 73 53 72 69 64 46 72 6f 6d 57 4b 54 28 27 essSridFromWKT('
9f50: 47 45 4f 47 43 53 5b 22 47 43 53 5f 4d 6f 6e 74 GEOGCS["GCS_Mont
9f60: 65 5f 4d 61 72 69 6f 5f 52 6f 6d 65 22 2c 44 41 e_Mario_Rome",DA
9f70: 54 55 4d 5b 22 44 5f 4d 6f 6e 74 65 5f 4d 61 72 TUM["D_Monte_Mar
9f80: 69 6f 22 2c 53 50 48 45 52 4f 49 44 5b 22 49 6e io",SPHEROID["In
9f90: 74 65 72 6e 61 74 69 6f 6e 61 6c 5f 31 39 32 34 ternational_1924
9fa0: 22 2c 36 33 37 38 33 38 38 2e 30 2c 32 39 37 2e ",6378388.0,297.
9fb0: 30 5d 5d 2c 50 52 49 4d 45 4d 5b 22 52 6f 6d 65 0]],PRIMEM["Rome
9fc0: 22 2c 31 32 2e 34 35 32 33 33 33 33 33 33 33 33 ",12.45233333333
9fd0: 33 33 5d 2c 55 4e 49 54 5b 22 44 65 67 72 65 65 33],UNIT["Degree
9fe0: 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 39 ",0.017453292519
9ff0: 39 34 33 33 5d 5d 27 29 3b 20 0d 0a 2d 2d 2d 2d 9433]]'); ..----
a000: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a010: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 34 38 30 36 ----------..4806
a020: 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f ....SELECT PROJ_
a030: 47 75 65 73 73 53 72 69 64 46 72 6f 6d 53 48 50 GuessSridFromSHP
a040: 28 27 2f 68 6f 6d 65 2f 73 61 6e 64 72 6f 2f 74 ('/home/sandro/t
a050: 75 73 63 61 6e 79 5f 73 68 70 2f 70 72 6f 76 32 uscany_shp/prov2
a060: 30 31 31 27 29 3b 20 2d 2d 20 72 65 6d 65 6d 62 011'); -- rememb
a070: 65 72 3a 20 72 65 71 75 69 72 65 73 20 74 6f 20 er: requires to
a080: 65 78 70 6c 69 63 69 74 6c 79 20 73 65 74 20 53 explicitly set S
a090: 50 41 54 49 41 4c 49 54 45 5f 53 45 43 55 52 49 PATIALITE_SECURI
a0a0: 54 59 3d 72 65 6c 61 78 65 64 0d 0a 2d 2d 2d 2d TY=relaxed..----
a0b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
a0c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 33 30 30 33 ----------..3003
a0d0: 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 3c ..</verbatim>..<
a0e0: 62 72 3e 0d 0a 3c 68 72 3e 3c 62 72 3e 0d 0a 3c br>..<hr><br>..<
a0f0: 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 6e table cellspacin
a100: 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 69 6e g="8" cellpaddin
a110: 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 3d 22 23 g="8" bgcolor="#
a120: 66 66 65 30 65 39 22 20 77 69 64 74 68 3d 22 31 ffe0e9" width="1
a130: 30 30 25 22 3e 0d 0a 3c 74 72 3e 3c 74 68 3e 0d 00%">..<tr><th>.
a140: 0a 3c 68 31 3e 49 6d 70 6f 72 74 61 6e 74 20 6e .<h1>Important n
a150: 6f 74 69 63 65 20 66 6f 72 20 57 69 6e 64 6f 77 otice for Window
a160: 73 20 75 73 65 72 73 3c 2f 68 31 3e 0d 0a 3c 2f s users</h1>..</
a170: 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 th></tr>..<tr><t
a180: 64 3e 0d 0a 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 d>..<b>PROJ.6</b
a190: 3e 20 63 72 69 74 69 63 61 6c 6c 79 20 64 65 70 > critically dep
a1a0: 65 6e 64 73 20 6f 6e 20 69 74 73 20 6f 77 6e 20 ends on its own
a1b0: 70 72 69 76 61 74 65 20 53 51 4c 69 74 65 20 64 private SQLite d
a1c0: 61 74 61 62 61 73 65 20 28 3c 62 3e 70 72 6f 6a atabase (<b>proj
a1d0: 2e 64 62 3c 2f 62 3e 29 20 63 6f 6e 74 61 69 6e .db</b>) contain
a1e0: 69 6e 67 20 61 6c 6c 20 72 65 6c 65 76 61 6e 74 ing all relevant
a1f0: 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 61 62 6f definitions abo
a200: 75 74 20 45 6c 6c 69 70 73 6f 69 64 73 2c 20 50 ut Ellipsoids, P
a210: 72 69 6d 65 20 4d 65 72 69 64 69 61 6e 73 2c 20 rime Meridians,
a220: 43 52 53 65 73 2c 20 54 72 61 6e 73 66 6f 72 6d CRSes, Transform
a230: 61 74 69 6f 6e 73 20 61 6e 64 20 61 6c 69 6b 65 ations and alike
a240: 2e 3c 62 72 3e 0d 0a 49 66 20 50 52 4f 4a 2e 36 .<br>..If PROJ.6
a250: 20 69 73 20 75 6e 61 62 6c 65 20 74 6f 20 63 6f is unable to co
a260: 72 72 65 63 74 6c 79 20 65 73 74 61 62 6c 69 73 rrectly establis
a270: 68 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 h a connection t
a280: 6f 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 o this database
a290: 69 74 20 77 69 6c 6c 20 62 65 20 73 65 76 65 72 it will be sever
a2a0: 65 6c 79 20 6c 69 6d 69 74 65 64 20 61 6e 64 20 ely limited and
a2b0: 77 69 6c 6c 20 6e 6f 74 20 62 65 20 61 62 6c 65 will not be able
a2c0: 20 74 6f 20 63 6f 72 72 65 63 74 6c 79 20 62 65 to correctly be
a2d0: 68 61 76 65 20 61 73 20 65 78 70 65 63 74 65 64 have as expected
a2e0: 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 75 6c 3e 0d .<br><br>..<ul>.
a2f0: 0a 3c 6c 69 3e 3c 62 3e 3c 75 3e 3c 69 3e 53 68 .<li><b><u><i>Sh
a300: 6f 72 74 20 63 6f 6e 63 6c 75 73 69 6f 6e 3c 2f ort conclusion</
a310: 69 3e 3c 2f 75 3e 3c 2f 62 3e 3a 20 69 6e 73 74 i></u></b>: inst
a320: 61 6c 6c 69 6e 67 20 74 68 65 20 73 6f 66 74 77 alling the softw
a330: 61 72 65 20 61 6c 6f 6e 65 20 69 73 20 6e 6f 74 are alone is not
a340: 20 65 6e 6f 75 67 68 2e 3c 62 72 3e 0d 0a 54 68 enough.<br>..Th
a350: 65 20 50 52 4f 4a 2e 36 20 70 72 69 76 61 74 65 e PROJ.6 private
a360: 20 64 61 74 61 62 61 73 65 20 3c 62 3e 70 72 6f database <b>pro
a370: 6a 2e 64 62 3c 2f 62 3e 20 6d 75 73 74 20 62 65 j.db</b> must be
a380: 20 70 72 6f 70 65 72 6c 79 20 69 6e 73 74 61 6c properly instal
a390: 6c 65 64 20 61 73 20 77 65 6c 6c 2c 20 69 6e 20 led as well, in
a3a0: 6f 72 64 65 72 20 74 6f 20 65 6e 73 75 72 65 20 order to ensure
a3b0: 74 68 61 74 20 61 6e 79 74 68 69 6e 67 20 72 75 that anything ru
a3c0: 6e 73 20 73 6d 6f 6f 74 68 6c 79 2e 3c 2f 6c 69 ns smoothly.</li
a3d0: 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 0d 0a 54 68 >..</ul><br>..Th
a3e0: 69 73 20 69 73 6e 27 74 20 75 73 75 61 6c 6c 79 is isn't usually
a3f0: 20 61 20 62 69 67 20 69 73 73 75 65 20 6f 6e 20 a big issue on
a400: 4c 69 6e 75 78 20 61 6e 64 20 55 6e 69 78 2d 6c Linux and Unix-l
a410: 69 6b 65 20 70 6c 61 74 66 6f 72 6d 73 2c 20 77 ike platforms, w
a420: 68 65 72 65 20 61 20 72 61 74 69 6f 6e 61 6c 20 here a rational
a430: 61 6e 64 20 76 65 72 79 20 63 6c 65 61 72 20 66 and very clear f
a440: 69 6c 65 73 79 73 74 65 6d 20 6c 61 79 6f 75 74 ilesystem layout
a450: 20 65 78 69 73 74 73 2e 3c 62 72 3e 0d 0a 4f 6e exists.<br>..On
a460: 20 74 68 65 73 65 20 6f 70 65 72 61 74 69 6e 67 these operating
a470: 20 73 79 73 74 65 6d 73 20 74 68 65 20 70 61 63 systems the pac
a480: 6b 61 67 65 20 6d 61 6e 61 67 65 72 20 28 6f 72 kage manager (or
a490: 20 3c 62 3e 6d 61 6b 65 20 69 6e 73 74 61 6c 6c <b>make install
a4a0: 3c 2f 62 3e 29 20 77 69 6c 6c 20 61 75 74 6f 6d </b>) will autom
a4b0: 61 74 69 63 61 6c 6c 79 20 74 61 6b 65 20 63 61 atically take ca
a4c0: 72 65 20 74 6f 20 69 6e 73 74 61 6c 6c 20 3c 62 re to install <b
a4d0: 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20 6f 6e 20 >proj.db</b> on
a4e0: 74 68 65 20 6d 6f 73 74 20 61 70 70 72 6f 70 72 the most appropr
a4f0: 69 61 74 65 20 64 69 72 65 63 74 6f 72 79 20 28 iate directory (
a500: 75 73 75 61 6c 6c 79 20 61 73 20 3c 62 3e 2f 75 usually as <b>/u
a510: 73 72 2f 73 68 61 72 65 2f 70 72 6f 6a 2f 70 72 sr/share/proj/pr
a520: 6f 6a 2e 64 62 3c 2f 62 3e 20 6f 72 20 61 73 20 oj.db</b> or as
a530: 3c 62 3e 2f 75 73 72 2f 6c 6f 63 61 6c 2f 73 68 <b>/usr/local/sh
a540: 61 72 65 2f 70 72 6f 6a 2f 70 72 6f 6a 2e 64 62 are/proj/proj.db
a550: 3c 2f 62 3e 29 20 61 6e 64 20 74 68 61 74 27 73 </b>) and that's
a560: 20 61 6c 6c 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 54 all.<br><br>..T
a570: 68 69 6e 67 73 20 61 72 65 20 75 6e 68 61 70 70 hings are unhapp
a580: 69 6c 79 20 61 20 6c 69 74 74 6c 65 20 62 69 74 ily a little bit
a590: 20 6d 6f 72 65 20 64 69 66 66 69 63 75 6c 74 73 more difficults
a5a0: 20 6f 6e 20 57 69 6e 64 6f 77 73 20 70 6c 61 74 on Windows plat
a5b0: 66 6f 72 6d 73 2e 0d 0a 54 68 65 20 75 73 65 72 forms...The user
a5c0: 20 69 74 73 65 6c 66 20 69 73 20 72 65 73 70 6f itself is respo
a5d0: 6e 73 69 62 6c 65 20 66 6f 72 20 70 72 6f 70 65 nsible for prope
a5e0: 72 6c 79 20 69 6e 73 74 61 6c 6c 69 6e 67 20 3c rly installing <
a5f0: 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e 0d 0a 53 b>proj.db</b>..S
a600: 6f 20 69 74 20 62 65 63 6f 6d 65 73 20 63 72 69 o it becomes cri
a610: 74 69 63 61 6c 20 75 6e 64 65 72 73 74 61 6e 64 tical understand
a620: 69 6e 67 20 74 68 65 20 62 61 73 69 63 20 72 75 ing the basic ru
a630: 6c 65 73 20 61 64 6f 70 74 65 64 20 62 79 20 3c les adopted by <
a640: 62 3e 6c 69 62 73 70 61 74 69 61 6c 69 74 65 3c b>libspatialite<
a650: 2f 62 3e 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 /b> in order to
a660: 70 72 6f 70 65 72 6c 79 20 6c 6f 63 61 74 65 20 properly locate
a670: 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20 6f <b>proj.db</b> o
a680: 6e 20 57 69 6e 64 6f 77 73 2e 0d 0a 3c 2f 74 64 n Windows...</td
a690: 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 68 3e ></tr>..<tr><th>
a6a0: 0d 0a 3c 68 32 3e 57 68 65 72 65 20 70 72 6f 6a ..<h2>Where proj
a6b0: 2e 64 62 20 69 73 20 65 78 70 65 63 74 65 64 20 .db is expected
a6c0: 74 6f 20 62 65 20 66 6f 75 6e 64 20 6f 6e 20 57 to be found on W
a6d0: 69 6e 64 6f 77 73 3c 2f 68 32 3e 0d 0a 3c 2f 74 indows</h2>..</t
a6e0: 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 d></tr>..<tr><td
a6f0: 3e 0d 0a 3c 6f 6c 3e 0d 0a 3c 6c 69 3e 74 68 65 >..<ol>..<li>the
a700: 20 66 69 72 73 74 20 70 6c 61 63 65 20 77 68 65 first place whe
a710: 72 65 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 re <b>proj.db</b
a720: 3e 20 77 69 6c 6c 20 62 65 20 73 65 61 72 63 68 > will be search
a730: 65 64 20 69 73 20 74 68 65 20 73 61 6d 65 20 66 ed is the same f
a740: 6f 6c 64 65 72 20 66 6f 72 6d 20 77 68 65 72 65 older form where
a750: 20 74 68 65 20 3c 62 3e 45 58 45 3c 2f 62 3e 20 the <b>EXE</b>
a760: 62 69 6e 61 72 79 20 77 61 73 20 69 6e 69 74 69 binary was initi
a770: 61 6c 6c 79 20 6c 6f 61 64 65 64 2e 3c 62 72 3e ally loaded.<br>
a780: 0d 0a 3c 69 3e 3c 75 3e 45 78 61 6d 70 6c 65 3c ..<i><u>Example<
a790: 2f 69 3e 3c 2f 75 3e 3a 20 61 73 73 75 6d 69 6e /i></u>: assumin
a7a0: 67 20 74 68 61 74 20 79 6f 75 20 61 72 65 20 63 g that you are c
a7b0: 75 72 72 65 6e 74 6c 79 20 65 78 65 63 75 74 69 urrently executi
a7c0: 6e 67 20 3c 62 3e 43 3a 5c 6d 79 70 72 6f 67 73 ng <b>C:\myprogs
a7d0: 5c 73 70 61 74 69 61 6c 69 74 65 5c 62 69 6e 5c \spatialite\bin\
a7e0: 73 70 61 74 69 61 6c 69 74 65 2e 65 78 65 3c 2f spatialite.exe</
a7f0: 62 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 74 68 b>..<ul>..<li>th
a800: 65 6e 20 61 6e 20 61 74 74 65 6d 70 74 20 77 69 en an attempt wi
a810: 6c 6c 20 62 65 20 6d 61 64 65 20 74 6f 20 63 6f ll be made to co
a820: 6e 6e 65 63 74 20 3c 62 3e 43 3a 5c 6d 79 70 72 nnect <b>C:\mypr
a830: 6f 67 73 5c 73 70 61 74 69 61 6c 69 74 65 5c 62 ogs\spatialite\b
a840: 69 6e 5c 70 72 6f 6a 2e 64 62 3c 2f 62 3e 3c 2f in\proj.db</b></
a850: 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c 69 3e 0d li>..</ul></li>.
a860: 0a 3c 6c 69 3e 61 20 73 65 63 6f 6e 64 20 61 74 .<li>a second at
a870: 74 65 6d 70 74 20 77 69 6c 6c 20 62 65 20 6d 61 tempt will be ma
a880: 64 65 20 6f 6e 20 62 65 68 61 6c 66 20 6f 66 20 de on behalf of
a890: 74 68 65 20 3c 62 3e 50 75 62 6c 69 63 3c 2f 62 the <b>Public</b
a8a0: 3e 20 66 6f 6c 64 65 72 2e 3c 62 72 3e 0d 0a 3c > folder.<br>..<
a8b0: 69 3e 3c 75 3e 45 78 61 6d 70 6c 65 3c 2f 75 3e i><u>Example</u>
a8c0: 3c 2f 69 3e 3a 20 61 6e 20 61 74 74 65 6d 70 74 </i>: an attempt
a8d0: 20 77 69 6c 6c 20 62 65 20 6d 61 64 65 20 74 6f will be made to
a8e0: 20 63 6f 6e 6e 65 63 74 20 3c 62 3e 43 3a 5c 55 connect <b>C:\U
a8f0: 73 65 72 73 5c 50 75 62 6c 69 63 5c 73 70 61 74 sers\Public\spat
a900: 69 61 6c 69 74 65 5c 70 72 6f 6a 5c 70 72 6f 6a ialite\proj\proj
a910: 2e 64 62 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 6c .db</b></li>..<l
a920: 69 3e 61 20 74 68 69 72 64 20 28 61 6e 64 20 6c i>a third (and l
a930: 61 73 74 29 20 61 74 74 65 6d 70 74 20 77 69 6c ast) attempt wil
a940: 6c 20 62 65 20 6d 61 64 65 20 6f 6e 20 62 65 68 l be made on beh
a950: 61 6c 66 20 6f 66 20 74 68 65 20 3c 62 3e 55 73 alf of the <b>Us
a960: 65 72 3c 2f 62 3e 20 66 6f 6c 64 65 72 2e 3c 62 er</b> folder.<b
a970: 72 3e 0d 0a 3c 69 3e 3c 75 3e 45 78 61 6d 70 6c r>..<i><u>Exampl
a980: 65 3c 2f 69 3e 3c 2f 75 3e 3a 20 61 6e 20 61 74 e</i></u>: an at
a990: 74 65 6d 70 74 20 77 69 6c 6c 20 62 65 20 6d 61 tempt will be ma
a9a0: 64 65 20 74 6f 20 63 6f 6e 6e 65 63 74 20 3c 62 de to connect <b
a9b0: 3e 43 3a 5c 55 73 65 72 73 5c 73 61 6e 64 72 6f >C:\Users\sandro
a9c0: 5c 73 70 61 74 69 61 6c 69 74 65 5c 70 72 6f 6a \spatialite\proj
a9d0: 5c 70 72 6f 6a 2e 64 62 3c 2f 62 3e 3c 2f 6c 69 \proj.db</b></li
a9e0: 3e 0d 0a 3c 2f 6f 6c 3e 0d 0a 3c 68 33 3e 41 6e >..</ol>..<h3>An
a9f0: 20 75 73 65 66 75 6c 20 64 69 61 67 6e 6f 73 74 useful diagnost
aa00: 69 63 20 63 68 65 63 6b 3c 2f 68 33 3e 0d 0a 3c ic check</h3>..<
aa10: 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 verbatim>..SELEC
aa20: 54 20 50 52 4f 4a 5f 47 65 74 44 61 74 61 62 61 T PROJ_GetDataba
aa30: 73 65 50 61 74 68 28 29 3b 0d 0a 3c 2f 76 65 72 sePath();..</ver
aa40: 62 61 74 69 6d 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c batim>..<ul>..<l
aa50: 69 3e 69 66 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e i>if <b>NULL</b>
aa60: 20 69 73 20 72 65 74 75 72 6e 65 64 2c 20 74 68 is returned, th
aa70: 65 6e 20 50 52 4f 4a 2e 36 20 69 73 20 64 65 66 en PROJ.6 is def
aa80: 69 6e 69 74 65 6c 79 20 75 6e 61 62 6c 65 20 74 initely unable t
aa90: 6f 20 63 6f 6e 6e 65 63 74 20 74 6f 20 69 74 73 o connect to its
aaa0: 20 6f 77 6e 20 70 72 69 76 61 74 65 20 53 51 4c own private SQL
aab0: 69 74 65 20 64 61 74 61 62 61 73 65 20 3c 62 3e ite database <b>
aac0: 70 72 6f 6a 2e 64 62 3c 2f 62 3e 3c 62 72 3e 0d proj.db</b><br>.
aad0: 0a 59 6f 75 20 68 61 76 65 20 74 6f 20 63 61 72 .You have to car
aae0: 65 66 75 6c 6c 79 20 76 65 72 69 66 69 79 20 74 efully verifiy t
aaf0: 68 61 74 20 69 74 27 73 20 72 65 61 6c 6c 79 20 hat it's really
ab00: 69 6e 73 74 61 6c 6c 65 64 20 6f 6e 20 6f 6e 65 installed on one
ab10: 20 6f 66 20 74 68 65 20 65 78 70 65 63 74 65 64 of the expected
ab20: 20 73 74 61 6e 64 61 72 64 20 6c 6f 63 61 74 69 standard locati
ab30: 6f 6e 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 6f ons.</li>..<li>o
ab40: 74 68 65 72 77 69 73 65 20 74 68 65 20 70 61 74 therwise the pat
ab50: 68 20 6c 65 61 64 69 6e 67 20 74 6f 20 74 68 65 h leading to the
ab60: 20 63 75 72 72 65 6e 74 6c 79 20 63 6f 6e 6e 65 currently conne
ab70: 63 74 65 64 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c cted <b>proj.db<
ab80: 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72 65 74 75 /b> will be retu
ab90: 72 6e 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c rned.</li>..</ul
aba0: 3e 3c 62 72 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 ><br>..</td></tr
abb0: 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 3c >..</table><br><
abc0: 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c br>..<table cell
abd0: 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c spacing="8" cell
abe0: 70 61 64 64 69 6e 67 3d 22 38 22 20 62 67 63 6f padding="8" bgco
abf0: 6c 6f 72 3d 22 23 63 39 66 66 66 30 22 20 77 69 lor="#c9fff0" wi
ac00: 64 74 68 3d 22 31 30 30 25 22 3e 0d 0a 3c 74 72 dth="100%">..<tr
ac10: 3e 3c 74 68 3e 0d 0a 3c 68 32 3e 55 73 69 6e 67 ><th>..<h2>Using
ac20: 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 the environment
ac30: 20 76 61 72 69 61 62 6c 65 20 53 50 41 54 49 41 variable SPATIA
ac40: 4c 49 54 45 5f 50 52 4f 4a 5f 44 42 5f 50 41 54 LITE_PROJ_DB_PAT
ac50: 48 3c 2f 68 32 3e 0d 0a 3c 2f 74 68 3e 3c 2f 74 H</h2>..</th></t
ac60: 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 49 66 r>..<tr><td>..If
ac70: 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 the environment
ac80: 20 76 61 72 69 61 62 6c 65 20 3c 62 3e 53 50 41 variable <b>SPA
ac90: 54 49 41 4c 49 54 45 5f 50 52 4f 4a 5f 44 42 5f TIALITE_PROJ_DB_
aca0: 50 41 54 48 3c 2f 62 3e 20 69 73 20 73 65 74 2c PATH</b> is set,
acb0: 20 74 68 65 6e 20 3c 62 3e 6c 69 62 73 70 61 74 then <b>libspat
acc0: 69 61 6c 69 74 65 3c 2f 62 3e 20 77 69 6c 6c 20 ialite</b> will
acd0: 73 69 6d 70 6c 79 20 61 74 74 65 6d 70 74 20 74 simply attempt t
ace0: 6f 20 63 6f 6e 6e 65 63 74 20 74 68 65 20 64 61 o connect the da
acf0: 74 61 62 61 73 65 20 70 6f 69 6e 74 65 64 20 62 tabase pointed b
ad00: 79 20 74 68 69 73 20 76 61 72 69 61 62 6c 65 2e y this variable.
ad10: 3c 62 72 3e 0d 0a 53 75 63 68 20 61 20 63 61 70 <br>..Such a cap
ad20: 61 62 69 6c 69 74 79 20 69 73 20 73 75 70 70 6f ability is suppo
ad30: 72 74 65 64 20 6e 6f 74 20 6f 6e 6c 79 20 6f 6e rted not only on
ad40: 20 57 69 6e 64 6f 77 73 20 62 75 74 20 61 6c 73 Windows but als
ad50: 6f 20 6f 6e 20 4c 69 6e 75 78 20 28 61 6e 64 20 o on Linux (and
ad60: 6f 6e 20 61 6e 79 20 6f 74 68 65 72 20 70 6c 61 on any other pla
ad70: 74 66 6f 72 6d 29 2e 3c 62 72 3e 3c 62 72 3e 0d tform).<br><br>.
ad80: 0a 3c 69 3e 3c 75 3e 4c 69 6e 75 78 20 65 78 61 .<i><u>Linux exa
ad90: 6d 70 6c 65 3c 2f 75 3e 3c 2f 69 3e 3a 0d 0a 3c mple</u></i>:..<
ada0: 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 65 78 70 6f ul>..<li><b>expo
adb0: 72 74 20 22 53 50 41 54 49 41 4c 49 54 45 5f 50 rt "SPATIALITE_P
adc0: 52 4f 4a 5f 44 42 5f 50 41 54 48 3d 2f 68 6f 6d ROJ_DB_PATH=/hom
add0: 65 2f 73 61 6e 64 72 6f 2f 61 75 78 2f 70 72 6f e/sandro/aux/pro
ade0: 6a 2e 64 62 22 3c 62 72 3e 0d 0a 65 63 68 6f 20 j.db"<br>..echo
adf0: 24 53 50 41 54 49 41 4c 49 54 45 5f 50 52 4f 4a $SPATIALITE_PROJ
ae00: 5f 44 42 5f 50 41 54 48 3c 62 72 3e 0d 0a 73 70 _DB_PATH<br>..sp
ae10: 61 74 69 61 6c 69 74 65 3c 62 3e 3c 2f 6c 69 3e atialite<b></li>
ae20: 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 3c 62 72 3e 0d ..</ul><br><br>.
ae30: 0a 3c 69 3e 3c 75 3e 57 69 6e 64 6f 77 73 20 65 .<i><u>Windows e
ae40: 78 61 6d 70 6c 65 3c 2f 75 3e 3c 2f 69 3e 3a 0d xample</u></i>:.
ae50: 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 53 45 .<ul>..<li><b>SE
ae60: 54 20 53 50 41 54 49 41 4c 49 54 45 5f 50 52 4f T SPATIALITE_PRO
ae70: 4a 5f 44 42 5f 50 41 54 48 3d 43 3a 5c 55 73 65 J_DB_PATH=C:\Use
ae80: 72 73 5c 73 61 6e 64 72 6f 5c 61 75 78 5c 70 72 rs\sandro\aux\pr
ae90: 6f 6a 2e 64 62 3c 62 72 3e 0d 0a 65 63 68 6f 20 oj.db<br>..echo
aea0: 25 53 50 41 54 49 41 4c 49 54 45 5f 50 52 4f 4a %SPATIALITE_PROJ
aeb0: 5f 44 42 5f 50 41 54 48 25 3c 62 72 3e 0d 0a 73 _DB_PATH%<br>..s
aec0: 70 61 74 69 61 6c 69 74 65 5f 67 75 69 3c 62 3e patialite_gui<b>
aed0: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e </li>..</ul><br>
aee0: 3c 62 72 3e 0d 0a 3c 2f 74 68 3e 3c 2f 74 72 3e <br>..</th></tr>
aef0: 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a ..</table><br>..
af00: 3c 68 72 3e 3c 62 72 3e 0d 0a 3c 61 20 68 72 65 <hr><br>..<a hre
af10: 66 3d 22 68 74 74 70 73 3a 2f 2f 77 77 77 2e 67 f="https://www.g
af20: 61 69 61 2d 67 69 73 2e 69 74 2f 66 6f 73 73 69 aia-gis.it/fossi
af30: 6c 2f 6c 69 62 73 70 61 74 69 61 6c 69 74 65 2f l/libspatialite/
af40: 77 69 6b 69 3f 6e 61 6d 65 3d 34 2e 33 2e 30 2d wiki?name=4.3.0-
af50: 64 6f 63 22 3e 62 61 63 6b 3c 2f 61 3e 0a 5a 20 doc">back</a>.Z
af60: 61 64 34 36 30 64 39 33 34 65 65 66 34 38 61 37 ad460d934eef48a7
af70: 64 36 33 62 66 63 63 32 34 31 35 65 65 61 30 38 d63bfcc2415eea08
af80: 0a .