0000: 44 20 32 30 31 39 2d 30 35 2d 31 34 54 30 39 3a D 2019-05-14T09:
0010: 35 35 3a 34 39 2e 36 38 37 0a 4c 20 50 52 4f 4a 55:49.687.L PROJ
0020: 2e 36 0a 50 20 64 63 66 30 31 33 38 63 35 30 64 .6.P dcf0138c50d
0030: 34 65 35 34 37 30 38 34 39 66 63 63 31 63 66 66 4e5470849fcc1cff
0040: 30 33 32 63 35 64 36 38 62 33 63 35 65 0a 55 20 032c5d68b3c5e.U
0050: 73 61 6e 64 72 6f 0a 57 20 34 33 35 30 35 0a 3c sandro.W 43505.<
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 3c 62 72 ific regions.<br
3370: 3e 0d 0a 49 66 20 79 6f 75 72 20 61 72 65 61 20 >..If your area
3380: 6f 66 20 69 6e 74 65 72 65 73 74 20 69 73 20 63 of interest is c
3390: 6f 6e 74 61 69 6e 65 64 20 77 69 74 68 69 6e 20 ontained within
33a0: 6f 6e 65 20 6f 66 20 73 75 63 68 20 72 65 67 69 one of such regi
33b0: 6f 6e 73 20 79 6f 75 20 63 61 6e 20 75 73 65 66 ons you can usef
33c0: 75 6c 6c 79 20 69 6e 66 6f 72 6d 20 50 52 4f 4a ully inform PROJ
33d0: 2e 36 20 61 62 6f 75 74 20 74 68 65 20 69 6e 74 .6 about the int
33e0: 65 6e 64 65 64 20 42 42 4f 58 2c 20 61 6e 64 20 ended BBOX, and
33f0: 74 68 65 6e 20 50 52 4f 4a 2e 36 20 77 69 6c 6c then PROJ.6 will
3400: 20 61 74 74 65 6d 70 74 20 74 6f 20 75 73 65 20 attempt to use
3410: 74 68 65 20 6d 6f 73 74 20 73 70 65 63 69 66 69 the most specifi
3420: 63 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e c transformation
3430: 20 70 61 72 61 6d 65 74 65 72 73 20 61 76 61 69 parameters avai
3440: 6c 61 62 6c 65 2e 3c 62 72 3e 3c 62 72 3e 0d 0a lable.<br><br>..
3450: 57 65 27 6c 6c 20 65 78 61 6d 69 6e 65 20 69 6e We'll examine in
3460: 20 6d 6f 72 65 20 64 65 70 74 68 20 74 68 69 73 more depth this
3470: 20 74 6f 70 69 63 20 6f 6e 20 66 6f 6c 6c 6f 77 topic on follow
3480: 69 6e 67 20 73 65 63 74 69 6f 6e 73 2e 20 0d 0a ing sections. ..
3490: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a 3c 69 6d </td>..<td>..<im
34a0: 67 20 73 72 63 3d 22 68 74 74 70 73 3a 2f 2f 77 g src="https://w
34b0: 77 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 2f 67 ww.gaia-gis.it/g
34c0: 61 69 61 2d 73 69 6e 73 2f 70 72 6f 6a 36 70 69 aia-sins/proj6pi
34d0: 63 73 2f 69 74 61 6c 79 2d 61 72 65 61 73 2d 6f cs/italy-areas-o
34e0: 66 2d 75 73 65 2e 70 6e 67 22 20 61 6c 74 3d 22 f-use.png" alt="
34f0: 69 74 61 6c 79 20 61 72 65 61 73 20 6f 66 20 75 italy areas of u
3500: 73 65 22 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e se">..</td></tr>
3510: 0d 0a 3c 2f 74 61 62 6c 65 3e 0d 0a 3c 62 72 3e ..</table>..<br>
3520: 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c <br>..<table cel
3530: 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65 6c lspacing="8" cel
3540: 6c 70 61 64 64 69 6e 67 3d 22 31 36 22 20 62 67 lpadding="16" bg
3550: 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 39 22 3e color="#ffffe9">
3560: 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 68 33 3e ..<tr><td>..<h3>
3570: 43 6f 6e 63 65 70 74 73 20 74 6f 20 6b 65 65 70 Concepts to keep
3580: 20 77 65 6c 6c 20 69 6e 20 6d 69 6e 64 3c 2f 68 well in mind</h
3590: 33 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 66 6f 3>..<ul>..<li>fo
35a0: 72 67 65 74 20 74 68 65 20 6f 6c 64 20 70 72 6f rget the old pro
35b0: 6a 2d 73 74 72 69 6e 67 73 3b 20 74 68 65 79 20 j-strings; they
35c0: 61 72 65 20 6e 6f 20 6c 6f 6e 67 65 72 20 74 68 are no longer th
35d0: 65 20 62 65 73 74 20 77 61 79 20 66 6f 72 20 74 e best way for t
35e0: 61 6b 69 6e 67 20 66 75 6c 6c 20 70 72 6f 66 69 aking full profi
35f0: 74 20 66 72 6f 6d 20 50 52 4f 4a 2e 36 3c 2f 6c t from PROJ.6</l
3600: 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 62 65 73 74 i>..<li>the best
3610: 20 77 61 79 20 74 6f 20 6d 61 6b 65 20 74 68 65 way to make the
3620: 20 6d 6f 73 74 20 6f 66 20 50 52 4f 4a 2e 36 20 most of PROJ.6
3630: 63 61 70 61 62 69 6c 69 74 69 65 73 20 69 73 20 capabilities is
3640: 62 79 20 6c 65 61 76 69 6e 67 20 74 68 65 20 6c by leaving the l
3650: 69 62 72 61 72 79 20 66 75 6c 6c 79 20 66 72 65 ibrary fully fre
3660: 65 20 74 6f 20 63 68 6f 6f 73 65 20 74 68 65 20 e to choose the
3670: 62 65 73 74 20 70 6f 73 73 69 62 6c 65 20 74 72 best possible tr
3680: 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f ansformation fro
3690: 6d 20 74 68 65 20 6f 72 69 67 69 6e 20 61 6e 64 m the origin and
36a0: 20 74 68 65 20 64 65 73 74 69 6e 61 74 69 6f 6e the destination
36b0: 20 43 52 53 65 73 2e 3c 62 72 3e 0d 0a 62 75 74 CRSes.<br>..but
36c0: 20 74 68 69 73 20 73 74 72 69 63 74 6c 79 20 72 this strictly r
36d0: 65 71 75 69 72 65 73 20 74 68 61 74 20 74 68 65 equires that the
36e0: 20 6c 69 62 72 61 72 79 20 77 69 6c 6c 20 62 65 library will be
36f0: 20 62 61 63 6b 65 64 20 75 70 20 62 79 20 69 74 backed up by it
3700: 73 20 6f 77 6e 20 70 72 69 76 61 74 65 20 64 61 s own private da
3710: 74 61 62 61 73 65 2e 3c 2f 6c 69 3e 0d 0a 3c 2f tabase.</li>..</
3720: 75 6c 3e 0d 0a 3c 68 33 3e 41 64 64 69 74 69 6f ul>..<h3>Additio
3730: 6e 61 6c 20 63 6f 6e 63 65 70 74 3c 2f 68 33 3e nal concept</h3>
3740: 0d 0a 54 68 65 20 74 72 61 64 69 74 69 6f 6e 61 ..The traditiona
3750: 6c 20 3c 62 3e 73 70 61 74 69 61 6c 5f 72 65 66 l <b>spatial_ref
3760: 5f 73 79 73 3c 2f 62 3e 20 74 61 62 6c 65 20 63 _sys</b> table c
3770: 6f 6e 74 61 69 6e 65 64 20 77 69 74 68 69 6e 20 ontained within
3780: 61 6e 79 20 53 70 61 74 69 61 4c 69 74 65 20 44 any SpatiaLite D
3790: 42 20 6e 6f 74 69 63 65 61 62 6c 79 20 63 68 61 B noticeably cha
37a0: 6e 67 65 73 20 69 74 73 20 69 6e 74 65 6e 64 65 nges its intende
37b0: 64 20 73 63 6f 70 65 20 69 6e 20 50 52 4f 4a 2e d scope in PROJ.
37c0: 36 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 6:..<ul>..<li><b
37d0: 3e 73 72 69 64 3c 2f 62 3e 2c 20 3c 62 3e 61 75 >srid</b>, <b>au
37e0: 74 68 5f 6e 61 6d 65 3c 2f 62 3e 2c 20 3c 62 3e th_name</b>, <b>
37f0: 61 75 74 68 5f 73 72 69 64 3c 2f 62 3e 20 61 6e auth_srid</b> an
3800: 64 20 3c 62 3e 72 65 66 5f 73 79 73 5f 6e 61 6d d <b>ref_sys_nam
3810: 65 3c 2f 62 3e 20 63 6f 6c 75 6d 6e 73 20 61 72 e</b> columns ar
3820: 65 20 73 74 69 6c 6c 20 72 65 71 75 69 72 65 64 e still required
3830: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 64 65 66 in order to def
3840: 69 6e 65 20 61 6c 6c 20 73 75 70 70 6f 72 74 65 ine all supporte
3850: 64 20 43 52 53 65 73 20 61 6e 64 20 74 6f 20 73 d CRSes and to s
3860: 75 70 70 6f 72 74 20 0d 0a 72 65 6c 61 74 69 6f upport ..relatio
3870: 6e 73 20 62 61 73 65 64 20 6f 6e 20 50 72 69 6d ns based on Prim
3880: 61 72 79 20 61 6e 64 20 46 6f 72 65 69 67 6e 20 ary and Foreign
3890: 4b 65 79 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e Keys.</li>..<li>
38a0: 62 75 74 20 63 6f 6c 75 6d 6e 73 20 3c 62 3e 70 but columns <b>p
38b0: 72 6f 6a 34 74 65 78 74 3c 2f 62 3e 20 61 6e 64 roj4text</b> and
38c0: 20 3c 62 3e 73 72 74 65 78 74 3c 2f 62 3e 20 61 <b>srtext</b> a
38d0: 72 65 20 6e 6f 77 20 70 72 61 63 74 69 63 61 6c re now practical
38e0: 6c 79 20 75 73 65 6c 65 73 73 2c 20 62 65 63 61 ly useless, beca
38f0: 75 73 65 20 50 52 4f 4a 2e 36 20 69 73 20 6e 6f use PROJ.6 is no
3900: 77 20 63 61 70 61 62 6c 65 20 74 6f 20 66 75 6c w capable to ful
3910: 6c 79 20 64 65 66 69 6e 65 20 61 6e 79 20 43 52 ly define any CR
3920: 53 20 62 79 20 64 69 72 65 63 74 6c 79 20 71 75 S by directly qu
3930: 65 72 79 69 6e 67 20 69 74 73 20 6f 77 6e 20 70 erying its own p
3940: 72 69 76 61 74 65 20 64 61 74 61 62 61 73 65 2e rivate database.
3950: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 69 3e 3c 75 </li>..<li><i><u
3960: 3e 46 75 74 75 72 65 20 46 6f 72 65 63 61 73 74 >Future Forecast
3970: 73 3c 2f 75 3e 3c 2f 69 3e 3a 20 62 6f 74 68 20 s</u></i>: both
3980: 3c 62 3e 70 72 6f 6a 34 74 65 78 74 3c 2f 62 3e <b>proj4text</b>
3990: 20 61 6e 64 20 3c 62 3e 73 72 74 65 78 74 3c 2f and <b>srtext</
39a0: 62 3e 20 77 69 6c 6c 20 62 65 20 70 72 6f 62 61 b> will be proba
39b0: 62 6c 79 20 72 65 6d 6f 76 65 64 20 69 6e 20 73 bly removed in s
39c0: 6f 6d 65 20 66 75 74 75 72 65 20 76 65 72 73 69 ome future versi
39d0: 6f 6e 20 6f 66 20 53 70 61 74 69 61 4c 69 74 65 on of SpatiaLite
39e0: 2e 3c 62 72 3e 0d 0a 46 6f 72 20 6e 6f 77 20 74 .<br>..For now t
39f0: 68 65 79 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20 hey continue to
3a00: 62 65 20 73 75 70 70 6f 72 74 65 64 20 6d 61 69 be supported mai
3a10: 6e 6c 79 20 74 6f 20 74 68 65 20 62 65 6e 65 66 nly to the benef
3a20: 69 74 20 6f 66 20 70 72 65 76 69 6f 75 73 20 76 it of previous v
3a30: 65 72 73 69 6f 6e 73 20 6f 66 20 53 70 61 74 69 ersions of Spati
3a40: 61 4c 69 74 65 20 62 65 69 6e 67 20 62 61 73 65 aLite being base
3a50: 64 20 6f 6e 20 74 68 65 20 6e 6f 77 20 73 75 70 d on the now sup
3a60: 65 72 73 65 64 65 64 20 50 52 4f 4a 2e 34 3c 2f erseded PROJ.4</
3a70: 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 2f 74 64 li>..</ul>..</td
3a80: 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e ></tr>..</table>
3a90: 0d 0a 3c 68 33 3e 54 72 61 6e 73 66 6f 72 6d 61 ..<h3>Transforma
3aa0: 74 69 6f 6e 20 70 69 70 65 6c 69 6e 65 73 3c 2f tion pipelines</
3ab0: 68 33 3e 0d 0a 54 68 65 72 65 20 69 73 20 61 20 h3>..There is a
3ac0: 6c 61 73 74 20 61 73 74 6f 6e 69 73 68 69 6e 67 last astonishing
3ad0: 20 69 6d 70 72 6f 76 65 6d 65 6e 74 20 73 75 70 improvement sup
3ae0: 70 6f 72 74 65 64 20 62 79 20 50 52 4f 4a 2e 36 ported by PROJ.6
3af0: 2c 20 74 68 61 74 20 61 72 65 20 3c 62 3e 3c 69 , that are <b><i
3b00: 3e 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 >transformation
3b10: 70 69 70 65 6c 69 6e 65 73 3c 2f 69 3e 3c 2f 62 pipelines</i></b
3b20: 3e 2e 3c 62 72 3e 0d 0a 57 68 65 6e 20 75 73 69 >.<br>..When usi
3b30: 6e 67 20 61 20 3c 62 3e 3c 69 3e 70 69 70 65 6c ng a <b><i>pipel
3b40: 69 6e 65 3c 2f 69 3e 3c 2f 62 3e 20 79 6f 75 20 ine</i></b> you
3b50: 63 61 6e 20 66 72 65 65 6c 79 20 64 65 66 69 6e can freely defin
3b60: 65 20 61 6e 79 20 63 6f 6d 70 6c 65 78 20 67 65 e any complex ge
3b70: 6f 64 65 74 69 63 20 74 72 61 6e 73 66 6f 72 6d odetic transform
3b80: 61 74 69 6f 6e 20 62 79 20 63 68 61 69 6e 69 6e ation by chainin
3b90: 67 20 74 6f 67 65 74 68 65 72 20 6d 61 6e 79 20 g together many
3ba0: 65 6c 65 6d 65 6e 74 61 72 79 20 73 74 65 70 73 elementary steps
3bb0: 20 73 75 63 68 20 61 73 20 63 6f 6e 76 65 72 73 such as convers
3bc0: 69 6f 6e 2c 20 74 72 61 6e 73 66 6f 72 6d 61 74 ion, transformat
3bd0: 69 6f 6e 2c 20 70 72 6f 6a 65 63 74 69 6f 6e 2c ion, projection,
3be0: 20 61 78 69 73 20 73 77 61 70 20 61 6e 64 20 73 axis swap and s
3bf0: 6f 20 6f 6e 2e 3c 62 72 3e 0d 0a 41 20 70 69 70 o on.<br>..A pip
3c00: 65 6c 69 6e 65 20 69 73 20 63 6f 6e 63 65 70 74 eline is concept
3c10: 75 61 6c 6c 79 20 73 69 6d 69 6c 61 72 20 74 6f ually similar to
3c20: 20 61 20 55 4e 49 58 20 73 68 65 6c 6c 20 73 63 a UNIX shell sc
3c30: 72 69 70 74 2c 20 77 69 74 68 20 61 20 64 61 74 ript, with a dat
3c40: 61 66 6c 6f 77 20 72 65 67 75 6c 61 72 6c 79 20 aflow regularly
3c50: 70 72 6f 63 65 64 69 6e 67 20 66 6f 72 77 61 72 proceding forwar
3c60: 64 20 66 72 6f 6d 20 73 74 65 70 20 74 6f 20 73 d from step to s
3c70: 74 65 70 20 75 6e 74 69 6c 20 70 72 6f 64 75 63 tep until produc
3c80: 69 6e 67 20 74 68 65 20 66 69 6e 61 6c 20 72 65 ing the final re
3c90: 73 75 6c 74 2e 3c 62 72 3e 0d 0a 54 68 65 20 66 sult.<br>..The f
3ca0: 6f 6c 6c 6f 77 69 6e 67 20 69 73 20 61 20 70 72 ollowing is a pr
3cb0: 61 63 74 69 61 6c 20 65 78 61 6d 70 6c 65 20 6f actial example o
3cc0: 66 20 61 20 70 69 70 65 6c 69 6e 65 20 63 6f 72 f a pipeline cor
3cd0: 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 61 20 responding to a
3ce0: 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 66 transformation f
3cf0: 72 6f 6d 20 3c 62 3e 45 50 53 47 3a 34 33 32 36 rom <b>EPSG:4326
3d00: 3c 2f 62 3e 20 3c 69 3e 57 47 53 20 38 34 3c 2f </b> <i>WGS 84</
3d10: 69 3e 20 74 6f 20 3c 62 3e 45 50 53 47 3a 33 32 i> to <b>EPSG:32
3d20: 36 33 32 3c 2f 62 3e 20 3c 69 3e 57 47 53 20 38 632</b> <i>WGS 8
3d30: 34 20 2f 20 55 54 4d 20 7a 6f 6e 65 20 33 32 4e 4 / UTM zone 32N
3d40: 3c 2f 69 3e 3a 0d 0a 3c 76 65 72 62 61 74 69 6d </i>:..<verbatim
3d50: 3e 0d 0a 2b 70 72 6f 6a 3d 70 69 70 65 6c 69 6e >..+proj=pipelin
3d60: 65 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d e ..+step +proj=
3d70: 61 78 69 73 73 77 61 70 20 2b 6f 72 64 65 72 3d axisswap +order=
3d80: 32 2c 31 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 2,1 ..+step +pro
3d90: 6a 3d 75 6e 69 74 63 6f 6e 76 65 72 74 20 2b 78 j=unitconvert +x
3da0: 79 5f 69 6e 3d 64 65 67 20 2b 78 79 5f 6f 75 74 y_in=deg +xy_out
3db0: 3d 72 61 64 20 0d 0a 2b 73 74 65 70 20 2b 70 72 =rad ..+step +pr
3dc0: 6f 6a 3d 75 74 6d 20 2b 7a 6f 6e 65 3d 33 32 20 oj=utm +zone=32
3dd0: 2b 65 6c 6c 70 73 3d 57 47 53 38 34 0d 0a 3c 2f +ellps=WGS84..</
3de0: 76 65 72 62 61 74 69 6d 3e 0d 0a 3c 74 61 62 6c verbatim>..<tabl
3df0: 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 e cellspacing="8
3e00: 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 31 " cellpadding="1
3e10: 36 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 6" bgcolor="#fff
3e20: 66 64 30 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d fd0">..<tr><td>.
3e30: 0a 3c 62 3e 3c 75 3e 55 73 65 66 75 6c 20 68 69 .<b><u>Useful hi
3e40: 6e 74 3c 2f 75 3e 3c 2f 62 3e 3a 20 50 52 4f 4a nt</u></b>: PROJ
3e50: 2e 36 20 73 75 70 70 6f 72 74 73 20 61 20 6e 65 .6 supports a ne
3e60: 77 20 43 4c 49 20 74 6f 6f 6c 20 28 3c 62 3e 70 w CLI tool (<b>p
3e70: 72 6f 6a 69 6e 66 6f 3c 2f 62 3e 29 20 66 6f 72 rojinfo</b>) for
3e80: 20 69 6e 73 70 65 63 74 69 6e 67 20 69 6e 20 66 inspecting in f
3e90: 75 6c 6c 20 64 65 74 61 69 6c 20 74 68 65 20 69 ull detail the i
3ea0: 6e 74 65 72 6e 61 6c 20 64 65 66 69 6e 69 74 69 nternal definiti
3eb0: 6f 6e 73 20 6f 66 20 43 52 53 65 73 2c 20 54 72 ons of CRSes, Tr
3ec0: 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 73 20 65 74 ansformations et
3ed0: 63 2e 3c 62 72 3e 0d 0a 54 68 65 20 61 62 6f 76 c.<br>..The abov
3ee0: 65 20 70 69 70 65 6c 69 6e 65 20 69 73 20 73 69 e pipeline is si
3ef0: 6d 70 6c 79 20 74 68 65 20 6f 75 74 70 75 74 20 mply the output
3f00: 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 of the following
3f10: 20 63 6f 6d 6d 61 6e 64 3a 0d 0a 3c 76 65 72 62 command:..<verb
3f20: 61 74 69 6d 3e 0d 0a 70 72 6f 6a 69 6e 66 6f 20 atim>..projinfo
3f30: 2d 73 20 45 50 53 47 3a 34 33 32 36 20 2d 74 20 -s EPSG:4326 -t
3f40: 45 50 53 47 3a 33 32 36 33 32 20 2d 6f 20 70 72 EPSG:32632 -o pr
3f50: 6f 6a 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d oj..</verbatim>.
3f60: 0a 3c 62 3e 70 72 6f 6a 69 6e 66 6f 3c 2f 62 3e .<b>projinfo</b>
3f70: 20 69 73 20 61 20 76 65 72 79 20 70 72 65 63 69 is a very preci
3f80: 6f 75 73 20 72 65 73 6f 75 72 63 65 3b 20 64 6f ous resource; do
3f90: 6e 27 74 20 65 73 69 74 61 74 65 20 74 6f 20 66 n't esitate to f
3fa0: 72 65 71 75 65 6e 74 6c 79 20 75 73 65 20 69 74 requently use it
3fb0: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 64 69 73 in order to dis
3fc0: 63 6f 76 65 72 20 77 68 61 74 27 73 20 72 65 61 cover what's rea
3fd0: 6c 6c 79 20 68 61 70 70 65 6e 69 6e 67 20 62 65 lly happening be
3fe0: 68 69 6e 64 20 74 68 65 20 73 63 65 6e 65 73 2e hind the scenes.
3ff0: 3c 62 72 3e 0d 0a 49 74 27 73 20 74 68 65 20 62 <br>..It's the b
4000: 65 73 74 20 61 6e 64 20 65 61 73 69 65 73 74 20 est and easiest
4010: 77 61 79 20 66 6f 72 20 66 75 6c 6c 79 20 75 6e way for fully un
4020: 64 65 72 73 74 61 6e 74 69 6e 67 20 68 6f 77 20 derstanting how
4030: 50 52 4f 4a 2e 36 20 64 6f 20 72 65 61 6c 6c 79 PROJ.6 do really
4040: 20 77 6f 72 6b 73 2e 0d 0a 3c 2f 74 64 3e 3c 2f works...</td></
4050: 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 tr>..</table><br
4060: 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 ><br>..<table ce
4070: 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65 llspacing="8" ce
4080: 6c 6c 70 61 64 64 69 6e 67 3d 22 38 22 20 62 67 llpadding="8" bg
4090: 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 39 22 3e color="#ffffe9">
40a0: 0d 0a 3c 74 72 3e 3c 74 68 3e 0d 0a 49 6e 20 6f ..<tr><th>..In o
40b0: 72 64 65 72 20 74 6f 20 6c 65 61 72 6e 20 6d 6f rder to learn mo
40c0: 72 65 20 61 62 6f 75 74 20 74 68 65 20 6d 61 6e re about the man
40d0: 79 20 69 6e 74 65 72 65 73 74 69 6e 67 20 63 6f y interesting co
40e0: 6f 6c 20 6e 65 77 20 66 65 61 74 75 72 65 73 20 ol new features
40f0: 73 75 70 70 6f 72 74 65 64 20 62 79 20 50 52 4f supported by PRO
4100: 4a 2e 36 20 70 6c 65 61 73 65 20 63 6f 6e 73 75 J.6 please consu
4110: 6c 74 20 74 68 65 20 3c 61 20 68 72 65 66 3d 22 lt the <a href="
4120: 68 74 74 70 73 3a 2f 2f 70 72 6f 6a 34 2e 6f 72 https://proj4.or
4130: 67 2f 22 3e 6f 72 69 67 69 6e 61 6c 20 64 6f 63 g/">original doc
4140: 75 6d 65 6e 74 61 74 69 6f 6e 3c 2f 61 3e 0d 0a umentation</a>..
4150: 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 </th></tr>..</ta
4160: 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 68 72 3e 0d 0a ble><br>..<hr>..
4170: 3c 68 31 3e 50 52 4f 4a 2e 36 20 73 75 70 70 6f <h1>PROJ.6 suppo
4180: 72 74 20 6f 6e 20 53 70 61 74 69 61 4c 69 74 65 rt on SpatiaLite
4190: 2d 35 2e 30 2e 30 3c 2f 68 31 3e 0d 0a 3c 68 33 -5.0.0</h1>..<h3
41a0: 3e 43 72 65 61 74 69 6e 67 20 61 6e 64 20 70 6f >Creating and po
41b0: 70 75 6c 61 74 69 6e 67 20 74 68 65 20 73 70 61 pulating the spa
41c0: 74 69 61 6c 5f 72 65 66 5f 73 79 73 20 6d 65 74 tial_ref_sys met
41d0: 61 74 61 62 6c 65 3c 2f 68 33 3e 0d 0a 54 68 65 atable</h3>..The
41e0: 72 65 20 69 73 20 6e 6f 20 72 65 6c 65 76 61 6e re is no relevan
41f0: 74 20 63 68 61 6e 67 65 2e 20 41 73 20 69 6e 20 t change. As in
4200: 61 6c 6c 20 70 72 65 76 69 6f 75 73 20 76 65 72 all previous ver
4210: 73 69 6f 6e 73 20 3c 62 3e 73 70 61 74 69 61 6c sions <b>spatial
4220: 5f 72 65 66 5f 73 79 73 3c 2f 62 3e 20 77 69 6c _ref_sys</b> wil
4230: 6c 20 62 65 20 61 75 74 6f 6d 61 74 69 63 61 6c l be automatical
4240: 6c 79 20 63 72 65 61 74 65 64 20 61 6e 64 20 70 ly created and p
4250: 72 6f 70 65 72 6c 79 20 70 6f 70 75 6c 61 74 65 roperly populate
4260: 20 62 79 20 63 61 6c 6c 69 6e 67 20 74 68 65 20 by calling the
4270: 61 70 70 72 6f 70 72 69 61 74 65 20 53 51 4c 20 appropriate SQL
4280: 66 75 6e 63 74 69 6f 6e 2e 0d 0a 3c 76 65 72 62 function...<verb
4290: 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 54 20 49 6e atim>..SELECT In
42a0: 69 74 53 70 61 74 69 61 6c 4d 65 74 61 44 61 74 itSpatialMetaDat
42b0: 61 28 31 29 3b 0d 0a 20 20 20 20 20 20 6f 72 0d a(1);.. or.
42c0: 0a 53 45 4c 45 43 54 20 49 6e 69 74 53 70 61 74 .SELECT InitSpat
42d0: 69 61 6c 4d 65 74 61 44 61 74 61 46 75 6c 6c 28 ialMetaDataFull(
42e0: 31 29 3b 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 1);..</verbatim>
42f0: 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 ..<table cellspa
4300: 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 cing="8" cellpad
4310: 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 ding="8" bgcolor
4320: 3d 22 23 66 66 66 66 65 39 22 3e 0d 0a 3c 74 72 ="#ffffe9">..<tr
4330: 3e 3c 74 64 3e 0d 0a 50 6c 65 61 73 65 20 72 65 ><td>..Please re
4340: 6d 65 62 65 72 20 74 68 61 74 20 6e 6f 77 20 69 meber that now i
4350: 6e 20 53 70 61 74 69 61 4c 69 74 65 2d 35 2e 30 n SpatiaLite-5.0
4360: 2e 30 20 3c 62 3e 49 6e 69 74 53 70 61 74 69 61 .0 <b>InitSpatia
4370: 6c 4d 65 74 61 44 61 74 61 46 75 6c 6c 3c 2f 62 lMetaDataFull</b
4380: 3e 20 72 65 70 72 65 73 65 6e 74 73 20 74 68 65 > represents the
4390: 20 70 72 65 66 65 72 72 65 64 20 6d 65 74 68 6f preferred metho
43a0: 64 20 66 6f 72 20 63 72 65 61 74 69 6e 67 20 61 d for creating a
43b0: 6c 6c 20 6d 65 74 61 64 61 74 61 20 74 61 62 6c ll metadata tabl
43c0: 65 73 20 72 65 71 75 69 72 65 64 20 62 79 20 74 es required by t
43d0: 68 69 73 20 76 65 72 73 69 6f 6e 2e 3c 62 72 3e his version.<br>
43e0: 0d 0a 3c 62 3e 49 6e 69 74 53 70 61 74 69 61 6c ..<b>InitSpatial
43f0: 4d 65 74 61 44 61 74 61 3c 2f 62 3e 20 69 73 20 MetaData</b> is
4400: 73 74 69 6c 6c 20 6d 61 69 6e 74 61 69 6e 65 64 still maintained
4410: 20 73 6f 20 74 6f 20 6e 6f 74 20 62 72 65 61 6b so to not break
4420: 20 68 69 73 74 6f 72 69 63 61 6c 20 63 6f 6d 70 historical comp
4430: 61 74 69 62 69 6c 69 74 79 2c 20 62 75 74 20 73 atibility, but s
4440: 68 6f 75 6c 64 6e 27 74 20 62 65 20 75 73 65 64 houldn't be used
4450: 20 61 6e 79 20 6c 6f 6e 67 65 72 2e 0d 0a 3c 2f any longer...</
4460: 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c td></tr>..</tabl
4470: 65 3e 3c 62 72 3e 0d 0a 54 68 65 20 6d 6f 73 74 e><br>..The most
4480: 20 72 65 6c 65 76 61 6e 74 20 63 68 61 6e 67 65 relevant change
4490: 20 69 73 20 74 68 61 74 20 64 69 66 66 65 72 65 is that differe
44a0: 6e 74 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 nt versions of S
44b0: 70 61 74 69 61 4c 69 74 65 2f 50 52 4f 4a 20 77 patiaLite/PROJ w
44c0: 69 6c 6c 20 6e 6f 77 20 62 65 68 61 76 65 20 69 ill now behave i
44d0: 6e 20 72 61 64 69 63 61 6c 6c 79 20 64 69 66 66 n radically diff
44e0: 65 72 65 6e 74 20 77 61 79 73 2c 20 61 73 20 73 erent ways, as s
44f0: 75 6d 6d 61 72 69 7a 65 64 20 69 6e 20 74 68 65 ummarized in the
4500: 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 72 6f 73 73 following cross
4510: 2d 76 65 72 73 69 6f 6e 20 63 6f 6d 70 61 74 69 -version compati
4520: 62 69 6c 69 74 79 20 74 61 62 6c 65 2e 3c 62 72 bility table.<br
4530: 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 ><br>..<table ce
4540: 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65 llspacing="8" ce
4550: 6c 6c 70 61 64 64 69 6e 67 3d 22 31 36 22 20 62 llpadding="16" b
4560: 67 63 6f 6c 6f 72 3d 22 23 65 38 66 66 65 38 22 gcolor="#e8ffe8"
4570: 20 62 6f 72 64 65 72 3d 22 31 22 3e 0d 0a 3c 74 border="1">..<t
4580: 72 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 r><th bgcolor="#
4590: 66 66 62 30 33 65 22 3e 53 70 61 74 69 61 4c 69 ffb03e">SpatiaLi
45a0: 74 65 20 2f 20 50 52 4f 4a 20 76 65 72 73 69 6f te / PROJ versio
45b0: 6e 3c 2f 74 68 3e 3c 74 68 20 62 67 63 6f 6c 6f n</th><th bgcolo
45c0: 72 3d 22 23 66 66 62 30 33 65 22 3e 43 6f 6e 6e r="#ffb03e">Conn
45d0: 65 63 74 65 64 20 44 42 3c 2f 74 68 3e 3c 74 68 ected DB</th><th
45e0: 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 bgcolor="#ffb03
45f0: 65 22 3e 41 63 74 69 6f 6e 3c 2f 74 68 3e 3c 2f e">Action</th></
4600: 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 20 72 tr>..<tr>..<td r
4610: 6f 77 73 70 61 6e 3d 22 32 22 3e 53 70 61 74 69 owspan="2">Spati
4620: 61 4c 69 74 65 2d 35 20 62 75 69 6c 74 20 6f 6e aLite-5 built on
4630: 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 3c 2f <b>PROJ.6</b></
4640: 74 64 3e 0d 0a 3c 74 64 3e 44 42 20 63 72 65 61 td>..<td>DB crea
4650: 74 65 64 20 62 79 20 53 70 61 74 69 61 4c 69 74 ted by SpatiaLit
4660: 65 2d 35 20 2f 20 50 52 4f 4a 2e 36 3c 2f 74 64 e-5 / PROJ.6</td
4670: 3e 0d 0a 3c 74 64 20 72 6f 77 73 70 61 6e 3d 22 >..<td rowspan="
4680: 32 22 3e 0d 0a 3c 62 3e 6c 69 62 73 70 61 74 69 2">..<b>libspati
4690: 61 6c 69 74 65 2d 35 3c 2f 62 3e 20 77 68 65 6e alite-5</b> when
46a0: 20 62 75 69 6c 74 20 6f 6e 20 3c 62 3e 50 52 4f built on <b>PRO
46b0: 4a 2e 36 3c 2f 62 3e 20 77 69 6c 6c 20 61 6c 77 J.6</b> will alw
46c0: 61 79 73 20 69 67 6e 6f 72 65 20 62 6f 74 68 20 ays ignore both
46d0: 74 68 65 20 70 72 6f 6a 2d 73 74 72 69 6e 67 73 the proj-strings
46e0: 20 73 74 6f 72 65 64 20 69 6e 20 63 6f 6c 75 6d stored in colum
46f0: 6e 20 3c 62 3e 70 72 6f 6a 34 74 65 78 74 3c 2f n <b>proj4text</
4700: 62 3e 20 61 6e 64 20 74 68 65 20 57 4b 54 20 64 b> and the WKT d
4710: 65 66 69 6e 69 74 69 6f 6e 73 20 73 74 6f 72 65 efinitions store
4720: 64 20 69 6e 20 63 6f 6c 75 6d 6e 20 3c 62 3e 73 d in column <b>s
4730: 72 74 65 78 74 3c 2f 62 3e 2e 3c 62 72 3e 0d 0a rtext</b>.<br>..
4740: 49 74 20 77 69 6c 6c 20 69 6e 73 74 65 61 64 20 It will instead
4750: 6c 65 61 76 65 20 50 52 4f 4a 2e 36 20 66 75 6c leave PROJ.6 ful
4760: 6c 79 20 66 72 65 65 20 74 6f 20 75 73 65 20 74 ly free to use t
4770: 68 65 20 43 52 53 20 64 65 66 69 6e 69 74 69 6f he CRS definitio
4780: 6e 73 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20 ns contained in
4790: 69 74 73 20 6f 77 6e 20 70 72 69 76 61 74 65 20 its own private
47a0: 64 61 74 61 62 61 73 65 2e 3c 62 72 3e 3c 62 72 database.<br><br
47b0: 3e 0d 0a 4e 6f 74 65 20 74 68 61 74 20 74 68 69 >..Note that thi
47c0: 73 20 61 70 70 6c 69 65 73 20 69 6e 64 69 66 66 s applies indiff
47d0: 65 72 65 6e 74 6c 79 20 74 6f 20 62 6f 74 68 20 erently to both
47e0: 3c 62 3e 3c 69 3e 6c 65 67 61 63 79 20 64 61 74 <b><i>legacy dat
47f0: 61 62 61 73 65 73 3c 2f 69 3e 3c 2f 62 3e 20 63 abases</i></b> c
4800: 72 65 61 74 65 64 20 62 79 20 61 6e 79 20 70 72 reated by any pr
4810: 65 76 69 6f 75 73 20 76 65 72 73 69 6f 6e 20 61 evious version a
4820: 6e 64 20 3c 62 3e 3c 69 3e 6d 6f 73 74 20 6d 6f nd <b><i>most mo
4830: 64 65 72 6e 20 64 61 74 61 62 61 73 65 73 3c 2f dern databases</
4840: 69 3e 3c 2f 62 3e 20 63 72 65 61 74 65 64 20 62 i></b> created b
4850: 79 20 74 68 65 20 6c 61 74 65 73 74 20 76 65 72 y the latest ver
4860: 73 69 6f 6e 2e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 sion...</td></tr
4870: 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 44 42 20 >..<tr>..<td>DB
4880: 63 72 65 61 74 65 64 20 62 79 20 53 70 61 74 69 created by Spati
4890: 61 4c 69 74 65 2d 35 20 2f 20 50 52 4f 4a 2e 34 aLite-5 / PROJ.4
48a0: 3c 62 72 3e 0d 0a 6f 72 3c 62 72 3e 0d 0a 62 79 <br>..or<br>..by
48b0: 20 61 6e 79 20 70 72 65 76 69 6f 75 73 20 76 65 any previous ve
48c0: 72 73 69 6f 6e 20 6f 66 20 53 70 61 74 69 61 4c rsion of SpatiaL
48d0: 69 74 65 20 28 3c 20 35 2e 30 2e 30 29 3c 2f 74 ite (< 5.0.0)</t
48e0: 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d d>..</tr>..<tr>.
48f0: 0a 3c 74 64 20 72 6f 77 73 70 61 6e 3d 22 32 22 .<td rowspan="2"
4900: 3e 53 70 61 74 69 61 4c 69 74 65 2d 35 20 62 75 >SpatiaLite-5 bu
4910: 69 6c 74 20 6f 6e 20 3c 62 3e 50 52 4f 4a 2e 34 ilt on <b>PROJ.4
4920: 3c 2f 62 3e 3c 62 72 3e 0d 0a 6f 72 3c 62 72 3e </b><br>..or<br>
4930: 0d 0a 61 6e 79 20 70 72 65 76 69 6f 75 73 20 76 ..any previous v
4940: 65 72 73 69 6f 6e 20 6f 66 20 53 70 61 74 69 61 ersion of Spatia
4950: 4c 69 74 65 20 28 3c 20 35 2e 30 2e 30 29 3c 2f Lite (< 5.0.0)</
4960: 74 64 3e 0d 0a 3c 74 64 3e 44 42 20 63 72 65 61 td>..<td>DB crea
4970: 74 65 64 20 62 79 20 53 70 61 74 69 61 4c 69 74 ted by SpatiaLit
4980: 65 2d 35 20 2f 20 50 52 4f 4a 2e 36 3c 2f 74 64 e-5 / PROJ.6</td
4990: 3e 0d 0a 3c 74 64 20 72 6f 77 73 70 61 6e 3d 22 >..<td rowspan="
49a0: 32 22 3e 0d 0a 57 68 65 6e 20 3c 62 3e 6c 69 62 2">..When <b>lib
49b0: 73 70 61 74 69 61 6c 69 74 65 3c 2f 62 3e 20 28 spatialite</b> (
49c0: 61 6e 79 20 76 65 72 73 69 6f 6e 2c 20 69 6e 63 any version, inc
49d0: 6c 75 64 69 6e 67 20 35 2e 30 2e 30 29 20 69 73 luding 5.0.0) is
49e0: 20 6e 6f 74 20 73 75 70 70 6f 72 74 65 64 20 62 not supported b
49f0: 79 20 50 52 4f 4a 2e 36 20 74 68 65 6e 20 74 68 y PROJ.6 then th
4a00: 65 20 74 72 61 64 69 74 69 6f 6e 61 6c 20 61 70 e traditional ap
4a10: 70 72 6f 61 63 68 20 77 69 6c 6c 20 62 65 20 61 proach will be a
4a20: 6c 77 61 79 73 20 61 70 70 6c 69 65 64 2c 20 61 lways applied, a
4a30: 6e 64 20 65 61 63 68 20 43 52 53 20 77 69 6c 6c nd each CRS will
4a40: 20 62 65 20 63 6f 6e 73 65 71 75 65 6e 74 6c 79 be consequently
4a50: 20 69 64 65 6e 74 69 66 69 65 64 20 62 79 20 69 identified by i
4a60: 74 73 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 ts corresponding
4a70: 20 70 72 6f 6a 2d 73 74 72 69 6e 67 20 73 74 6f proj-string sto
4a80: 72 65 64 20 69 6e 20 63 6f 6c 75 6d 6e 20 3c 62 red in column <b
4a90: 3e 70 72 6f 6a 34 74 65 78 74 3c 2f 62 3e 3c 62 >proj4text</b><b
4aa0: 72 3e 3c 62 72 3e 0d 0a 4e 6f 74 65 20 74 68 61 r><br>..Note tha
4ab0: 74 20 65 76 65 6e 20 77 68 65 6e 20 50 52 4f 4a t even when PROJ
4ac0: 2e 36 20 69 73 20 6e 6f 74 20 73 75 70 70 6f 72 .6 is not suppor
4ad0: 74 65 64 20 61 6e 79 20 76 65 72 73 69 6f 6e 20 ted any version
4ae0: 6f 66 20 53 70 61 74 69 61 4c 69 74 65 20 28 74 of SpatiaLite (t
4af0: 68 69 73 20 69 6e 63 6c 75 64 69 6e 67 20 35 2e his including 5.
4b00: 30 2e 30 29 20 63 61 6e 20 73 61 66 65 6c 79 20 0.0) can safely
4b10: 63 6f 6e 6e 65 63 74 20 74 6f 20 61 6e 79 20 44 connect to any D
4b20: 42 2d 66 69 6c 65 20 63 72 65 61 74 65 64 20 62 B-file created b
4b30: 79 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e y the most recen
4b40: 74 20 76 65 72 73 69 6f 6e 20 77 69 74 68 20 66 t version with f
4b50: 75 6c 6c 20 50 52 4f 4a 2e 36 20 73 75 70 70 6f ull PROJ.6 suppo
4b60: 72 74 2e 0d 0a 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 rt...</td>..</tr
4b70: 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 44 42 20 >..<tr>..<td>DB
4b80: 63 72 65 61 74 65 64 20 62 79 20 53 70 61 74 69 created by Spati
4b90: 61 4c 69 74 65 2d 35 20 2f 20 50 52 4f 4a 2e 34 aLite-5 / PROJ.4
4ba0: 3c 62 72 3e 0d 0a 6f 72 3c 62 72 3e 0d 0a 62 79 <br>..or<br>..by
4bb0: 20 61 6e 79 20 70 72 65 76 69 6f 75 73 20 76 65 any previous ve
4bc0: 72 73 69 6f 6e 20 6f 66 20 53 70 61 74 69 61 4c rsion of SpatiaL
4bd0: 69 74 65 20 28 3c 20 35 2e 30 2e 30 29 3c 2f 74 ite (< 5.0.0)</t
4be0: 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 d>..</tr>..</tab
4bf0: 6c 65 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 68 33 le><br><br>..<h3
4c00: 3e 45 78 69 73 74 69 6e 67 20 53 51 4c 20 66 75 >Existing SQL fu
4c10: 6e 63 74 69 6f 6e 73 20 61 66 66 65 63 74 65 64 nctions affected
4c20: 20 62 79 20 50 52 4f 4a 2e 36 3c 2f 68 33 3e 0d by PROJ.6</h3>.
4c30: 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 .<table cellspac
4c40: 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 ing="8" cellpadd
4c50: 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 3d ing="8" bgcolor=
4c60: 22 23 65 38 66 66 65 38 22 20 62 6f 72 64 65 72 "#e8ffe8" border
4c70: 3d 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 ="1">..<tr><th b
4c80: 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 gcolor="#ffb03e"
4c90: 3e 53 51 4c 20 46 75 6e 63 74 69 6f 6e 3c 2f 74 >SQL Function</t
4ca0: 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 h><th bgcolor="#
4cb0: 66 66 62 30 33 65 22 3e 45 78 74 65 6e 64 65 64 ffb03e">Extended
4cc0: 20 73 69 67 6e 61 74 75 72 65 3c 2f 74 68 3e 3c signature</th><
4cd0: 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 th bgcolor="#ffb
4ce0: 30 33 65 22 3e 42 65 68 61 76 69 6f 72 20 75 6e 03e">Behavior un
4cf0: 64 65 72 20 50 52 4f 4a 2e 36 3c 2f 74 68 3e 3c der PROJ.6</th><
4d00: 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 /tr>..<tr><td><b
4d10: 3e 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 29 3c >ST_Transform()<
4d20: 2f 62 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a /b></td>..<td>..
4d30: 3c 62 3e 53 54 5f 54 72 61 6e 73 66 6f 72 6d 3c <b>ST_Transform<
4d40: 2f 62 3e 20 28 20 67 65 6f 6d 20 3c 69 3e 47 65 /b> ( geom <i>Ge
4d50: 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 6e 65 77 ometry</i> , new
4d60: 53 72 69 64 20 3c 69 3e 49 6e 74 65 67 65 72 3c Srid <i>Integer<
4d70: 2f 69 3e 20 2c 20 61 72 65 61 20 3c 69 3e 47 65 /i> , area <i>Ge
4d80: 6f 6d 65 74 72 79 3c 2f 69 3e 20 29 20 3a 20 3c ometry</i> ) : <
4d90: 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 3c 68 i>Geometry</i><h
4da0: 72 3e 0d 0a 3c 62 3e 53 54 5f 54 72 61 6e 73 66 r>..<b>ST_Transf
4db0: 6f 72 6d 3c 2f 62 3e 20 28 20 67 65 6f 6d 20 3c orm</b> ( geom <
4dc0: 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c i>Geometry</i> ,
4dd0: 20 6e 65 77 53 72 69 64 20 3c 69 3e 49 6e 74 65 newSrid <i>Inte
4de0: 67 65 72 3c 2f 69 3e 20 2c 20 61 72 65 61 20 3c ger</i> , area <
4df0: 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c i>Geometry</i> ,
4e00: 20 6d 65 74 68 6f 64 20 3c 69 3e 54 65 78 74 3c method <i>Text<
4e10: 2f 69 3e 20 29 20 3a 20 3c 69 3e 47 65 6f 6d 65 /i> ) : <i>Geome
4e20: 74 72 79 3c 2f 69 3e 3c 68 72 3e 0d 0a 3c 62 3e try</i><hr>..<b>
4e30: 53 54 5f 54 72 61 6e 73 66 6f 72 6d 3c 2f 62 3e ST_Transform</b>
4e40: 20 28 20 67 65 6f 6d 20 3c 69 3e 47 65 6f 6d 65 ( geom <i>Geome
4e50: 74 72 79 3c 2f 69 3e 20 2c 20 6e 65 77 53 72 69 try</i> , newSri
4e60: 64 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e d <i>Integer</i>
4e70: 20 2c 20 61 72 65 61 20 3c 69 3e 47 65 6f 6d 65 , area <i>Geome
4e80: 74 72 79 3c 2f 69 3e 20 2c 20 6d 65 74 68 6f 64 try</i> , method
4e90: 20 3c 69 3e 54 65 78 74 3c 2f 69 3e 20 2c 20 70 <i>Text</i> , p
4ea0: 72 6f 6a 5f 73 74 72 69 6e 67 20 3c 69 3e 54 65 roj_string <i>Te
4eb0: 78 74 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 47 65 xt</i> ) : <i>Ge
4ec0: 6f 6d 65 74 72 79 3c 2f 69 3e 0d 0a 3c 2f 74 64 ometry</i>..</td
4ed0: 3e 0d 0a 3c 74 64 3e 0d 0a 3c 74 61 62 6c 65 20 >..<td>..<table
4ee0: 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 34 22 20 cellspacing="4"
4ef0: 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 34 22 20 cellpadding="4"
4f00: 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 64 30 bgcolor="#ffffd0
4f10: 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 62 ">..<tr><td>..<b
4f20: 3e 3c 75 3e 3c 69 3e 4e 6f 74 65 3c 2f 69 3e 3c ><u><i>Note</i><
4f30: 2f 75 3e 3c 2f 62 3e 3a 20 61 6c 6c 20 74 68 65 /u></b>: all the
4f40: 73 65 20 3c 62 3e 3c 69 3e 65 78 74 65 6e 64 65 se <b><i>extende
4f50: 64 20 73 69 67 6e 61 74 75 72 65 73 3c 2f 69 3e d signatures</i>
4f60: 3c 2f 62 3e 20 61 72 65 20 73 75 70 70 6f 72 74 </b> are support
4f70: 65 64 20 6f 6e 6c 79 20 77 68 65 6e 20 3c 62 3e ed only when <b>
4f80: 6c 69 62 73 70 61 74 69 61 6c 69 74 65 2d 35 2e libspatialite-5.
4f90: 30 3c 2f 62 3e 20 68 61 73 20 62 65 65 6e 20 62 0</b> has been b
4fa0: 75 69 6c 74 20 6f 6e 20 74 68 65 20 74 6f 70 20 uilt on the top
4fb0: 6f 66 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e of <b>PROJ.6</b>
4fc0: 3c 62 72 3e 0d 0a 49 66 20 74 68 65 20 6c 69 62 <br>..If the lib
4fd0: 72 61 72 79 20 68 61 73 20 62 65 65 6e 20 62 75 rary has been bu
4fe0: 69 6c 74 20 69 6e 73 74 65 61 64 20 6f 6e 20 65 ilt instead on e
4ff0: 61 72 6c 69 65 72 20 76 65 72 73 69 6f 6e 73 20 arlier versions
5000: 6f 66 20 50 52 4f 4a 20 61 6e 79 20 61 74 74 65 of PROJ any atte
5010: 6d 70 74 20 74 6f 20 63 61 6c 6c 20 74 68 65 73 mpt to call thes
5020: 65 20 65 78 74 65 6e 64 65 64 20 73 69 67 6e 61 e extended signa
5030: 74 75 72 65 73 20 77 69 6c 6c 20 6a 75 73 74 20 tures will just
5040: 72 65 74 75 72 6e 20 61 20 3c 62 3e 3c 69 3e 77 return a <b><i>w
5050: 72 6f 6e 67 20 6e 75 6d 62 65 72 20 6f 66 20 61 rong number of a
5060: 72 67 75 6d 65 6e 74 73 20 74 6f 20 66 75 6e 63 rguments to func
5070: 74 69 6f 6e 20 53 54 5f 54 72 61 6e 73 66 6f 72 tion ST_Transfor
5080: 6d 28 29 3c 2f 69 3e 3c 2f 62 3e 20 65 72 72 6f m()</i></b> erro
5090: 72 2e 0d 0a 3c 2f 74 64 3e 3c 74 72 3e 0d 0a 3c r...</td><tr>..<
50a0: 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 74 61 /table><br>..<ta
50b0: 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d ble cellspacing=
50c0: 22 34 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d "4" cellpadding=
50d0: 22 34 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 "4" bgcolor="#ff
50e0: 64 66 64 30 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e dfd0">..<tr><td>
50f0: 0d 0a 41 6e 79 20 69 6e 76 61 6c 69 64 20 61 72 ..Any invalid ar
5100: 67 75 6d 65 6e 74 20 70 61 73 73 65 64 20 74 6f gument passed to
5110: 20 3c 62 3e 53 54 5f 54 72 61 6e 73 66 6f 72 6d <b>ST_Transform
5120: 28 29 3c 2f 62 3e 20 28 3c 62 3e 3c 69 3e 65 78 ()</b> (<b><i>ex
5130: 74 65 6e 64 65 64 20 73 69 67 6e 61 74 75 72 65 tended signature
5140: 73 3c 2f 69 3e 3c 2f 62 3e 29 20 77 69 6c 6c 20 s</i></b>) will
5150: 72 61 69 73 65 20 61 6e 20 3c 62 3e 53 51 4c 20 raise an <b>SQL
5160: 45 78 63 65 70 74 69 6f 6e 3c 2f 62 3e 2e 0d 0a Exception</b>...
5170: 3c 2f 74 64 3e 3c 74 72 3e 0d 0a 3c 2f 74 61 62 </td><tr>..</tab
5180: 6c 65 3e 3c 62 72 3e 0d 0a 3c 75 6c 3e 0d 0a 3c le><br>..<ul>..<
5190: 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 li>the optional
51a0: 61 72 67 75 6d 65 6e 74 20 3c 62 3e 61 72 65 61 argument <b>area
51b0: 3c 2f 62 3e 20 6d 61 79 20 62 65 20 3c 62 3e 4e </b> may be <b>N
51c0: 55 4c 4c 3c 2f 62 3e 20 28 3c 69 3e 64 65 66 61 ULL</b> (<i>defa
51d0: 75 6c 74 20 73 65 74 74 69 6e 67 3c 2f 69 3e 29 ult setting</i>)
51e0: 2e 3c 62 72 3e 0d 0a 4f 74 68 65 72 77 69 73 65 .<br>..Otherwise
51f0: 20 69 74 27 73 20 65 78 70 65 63 74 65 64 20 74 it's expected t
5200: 6f 20 63 6f 6e 74 61 69 6e 20 61 20 76 61 6c 69 o contain a vali
5210: 64 20 47 65 6f 6d 65 74 72 79 20 69 6e 20 3c 62 d Geometry in <b
5220: 3e 53 52 49 44 3d 34 33 32 36 20 28 6c 6f 6e 67 >SRID=4326 (long
5230: 2f 6c 61 74 29 3c 2f 62 3e 2e 0d 0a 57 68 65 6e /lat)</b>...When
5240: 20 61 6e 20 3c 62 3e 3c 69 3e 61 72 65 61 20 6f an <b><i>area o
5250: 66 20 75 73 65 3c 2f 69 3e 3c 2f 62 3e 20 69 73 f use</i></b> is
5260: 20 65 78 70 6c 69 63 69 74 6c 79 20 73 75 70 70 explicitly supp
5270: 6c 69 65 64 2c 20 74 68 65 6e 20 3c 62 3e 50 52 lied, then <b>PR
5280: 4f 4a 2e 36 3c 2f 62 3e 20 6d 61 79 20 65 76 65 OJ.6</b> may eve
5290: 6e 74 75 61 6c 6c 79 20 75 73 65 20 74 68 65 20 ntually use the
52a0: 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 3c 62 corresponding <b
52b0: 3e 42 42 4f 58 3c 2f 62 3e 20 66 6f 72 20 66 69 >BBOX</b> for fi
52c0: 6e 65 6c 79 20 74 75 6e 69 6e 67 20 74 68 65 20 nely tuning the
52d0: 6d 6f 72 65 20 61 63 63 75 72 61 74 65 20 74 72 more accurate tr
52e0: 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 2e 3c 2f 6c ansformation.</l
52f0: 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69 i>..<li>the opti
5300: 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62 onal argument <b
5310: 3e 6d 65 74 68 6f 64 3c 2f 62 3e 20 69 73 20 65 >method</b> is e
5320: 78 70 65 63 74 65 64 20 74 6f 20 63 6f 6e 74 61 xpected to conta
5330: 69 6e 20 6f 6e 65 20 74 68 65 20 66 6f 6c 6c 6f in one the follo
5340: 77 69 6e 67 20 76 61 6c 75 65 73 20 28 3c 62 3e wing values (<b>
5350: 61 75 74 68 5f 6e 61 6d 65 3a 61 75 74 68 5f 73 auth_name:auth_s
5360: 74 72 69 64 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 trid</b> will be
5370: 20 61 6c 77 61 79 73 20 61 73 73 75 6d 65 64 20 always assumed
5380: 61 73 20 74 68 65 20 3c 69 3e 64 65 66 61 75 6c as the <i>defaul
5390: 74 20 73 65 74 74 69 6e 67 3c 2f 69 3e 29 3a 3c t setting</i>):<
53a0: 2f 6c 69 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e /li>..<ul>..<li>
53b0: 3c 62 3e 70 72 6f 6a 34 74 65 78 74 3c 2f 62 3e <b>proj4text</b>
53c0: 3a 20 62 6f 74 68 20 43 52 53 65 73 20 28 6f 72 : both CRSes (or
53d0: 69 67 69 6e 20 61 6e 64 20 64 65 73 74 69 6e 61 igin and destina
53e0: 74 69 6f 6e 29 20 77 69 6c 6c 20 62 65 20 64 65 tion) will be de
53f0: 66 69 6e 65 64 20 62 79 20 70 61 73 73 69 6e 67 fined by passing
5400: 20 74 6f 20 50 52 4f 4a 2e 36 20 74 68 65 20 74 to PROJ.6 the t
5410: 72 61 64 69 74 69 6f 6e 61 6c 73 20 3c 62 3e 70 raditionals <b>p
5420: 72 6f 6a 2d 73 74 72 69 6e 67 3c 2f 62 3e 20 64 roj-string</b> d
5430: 65 66 69 6e 69 74 69 6f 6e 73 20 66 6f 72 20 74 efinitions for t
5440: 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 he corresponding
5450: 20 53 52 49 44 73 20 72 65 74 72 69 65 76 65 64 SRIDs retrieved
5460: 20 66 72 6f 6d 20 63 6f 6c 75 6d 6e 20 3c 62 3e from column <b>
5470: 70 72 6f 6a 34 74 65 78 74 3c 2f 62 3e 20 69 6e proj4text</b> in
5480: 20 54 61 62 6c 65 20 3c 62 3e 73 70 61 74 69 61 Table <b>spatia
5490: 6c 5f 72 65 66 5f 73 79 73 3c 2f 62 3e 3c 62 72 l_ref_sys</b><br
54a0: 3e 0d 0a 54 68 69 73 20 65 78 61 63 74 6c 79 20 >..This exactly
54b0: 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 74 corresponds to t
54c0: 68 65 20 77 65 6c 6c 20 65 78 74 61 62 6c 69 73 he well extablis
54d0: 68 65 64 20 74 72 61 64 69 74 69 6f 6e 61 6c 20 hed traditional
54e0: 62 65 68 61 76 69 6f 72 20 6f 66 20 61 6c 6c 20 behavior of all
54f0: 70 72 65 76 69 6f 75 73 20 76 65 72 73 69 6f 6e previous version
5500: 73 20 6f 66 20 3c 62 3e 6c 69 62 73 70 61 74 69 s of <b>libspati
5510: 61 6c 69 74 65 3c 2f 62 3e 20 61 6e 64 20 73 74 alite</b> and st
5520: 69 6c 6c 20 63 6f 6e 74 69 6e 75 65 73 20 74 6f ill continues to
5530: 20 62 65 20 73 75 70 70 6f 72 74 65 64 2c 20 62 be supported, b
5540: 75 74 20 3c 62 3e 3c 75 3e 3c 69 3e 69 73 6e 27 ut <b><u><i>isn'
5550: 74 20 61 6e 79 20 6c 6f 6e 67 65 72 20 74 68 65 t any longer the
5560: 20 62 65 73 74 20 77 61 79 20 66 6f 72 20 74 61 best way for ta
5570: 6b 69 6e 67 20 66 75 6c 6c 20 70 72 6f 66 69 74 king full profit
5580: 20 6f 66 20 74 68 65 20 6d 6f 72 65 20 61 64 76 of the more adv
5590: 61 6e 63 65 64 20 63 61 70 61 62 69 6c 69 74 69 anced capabiliti
55a0: 65 73 20 6f 66 20 50 52 4f 4a 2e 36 3c 2f 69 3e es of PROJ.6</i>
55b0: 3c 2f 75 3e 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c </u></b></li>..<
55c0: 6c 69 3e 3c 62 3e 73 72 74 65 78 74 3c 2f 62 3e li><b>srtext</b>
55d0: 3a 20 62 6f 74 68 20 43 52 53 65 73 20 28 6f 72 : both CRSes (or
55e0: 69 67 69 6e 20 61 6e 64 20 64 65 73 74 69 6e 61 igin and destina
55f0: 74 69 6f 6e 29 20 77 69 6c 6c 20 62 65 20 64 65 tion) will be de
5600: 66 69 6e 65 64 20 62 79 20 70 61 73 73 69 6e 67 fined by passing
5610: 20 74 6f 20 50 52 4f 4a 2e 36 20 74 68 65 20 3c to PROJ.6 the <
5620: 62 3e 57 4b 54 3c 2f 62 3e 20 64 65 66 69 6e 69 b>WKT</b> defini
5630: 74 69 6f 6e 73 20 66 6f 72 20 74 68 65 20 63 6f tions for the co
5640: 72 72 65 73 70 6f 6e 64 69 6e 67 20 53 52 49 44 rresponding SRID
5650: 73 20 72 65 74 72 69 65 76 65 64 20 66 72 6f 6d s retrieved from
5660: 20 63 6f 6c 75 6d 6e 20 3c 62 3e 73 72 74 65 78 column <b>srtex
5670: 74 3c 2f 62 3e 20 69 6e 20 54 61 62 6c 65 20 3c t</b> in Table <
5680: 62 3e 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 b>spatial_ref_sy
5690: 73 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e s</b></li>..<li>
56a0: 3c 62 3e 61 75 74 68 5f 6e 61 6d 65 3a 61 75 74 <b>auth_name:aut
56b0: 68 5f 73 72 69 64 3c 2f 62 3e 3a 20 62 6f 74 68 h_srid</b>: both
56c0: 20 43 52 53 65 73 20 28 6f 72 69 67 69 6e 20 61 CRSes (origin a
56d0: 6e 64 20 64 65 73 74 69 6e 61 74 69 6f 6e 29 20 nd destination)
56e0: 77 69 6c 6c 20 62 65 20 64 65 66 69 6e 65 64 20 will be defined
56f0: 62 79 20 69 67 6e 6f 72 69 6e 67 20 74 68 65 20 by ignoring the
5700: 64 65 66 69 6e 69 74 69 6f 6e 73 20 73 74 6f 72 definitions stor
5710: 65 64 20 69 6e 20 3c 62 3e 73 70 61 74 69 61 6c ed in <b>spatial
5720: 5f 72 65 66 5f 73 79 73 3c 2f 62 3e 20 61 6e 64 _ref_sys</b> and
5730: 20 6c 65 61 76 69 6e 67 20 50 52 4f 4a 2e 36 20 leaving PROJ.6
5740: 66 72 65 65 20 74 6f 20 72 65 74 72 69 65 76 65 free to retrieve
5750: 20 74 68 65 69 72 20 63 6f 72 72 65 73 70 6f 6e their correspon
5760: 64 69 6e 67 20 64 65 66 69 6e 69 74 69 6f 6e 73 ding definitions
5770: 20 66 72 6f 6d 20 69 74 73 20 6f 77 6e 20 70 72 from its own pr
5780: 69 76 61 74 65 20 53 51 4c 69 74 65 20 64 61 74 ivate SQLite dat
5790: 61 62 61 73 65 2e 3c 62 72 3e 0d 0a 3c 62 3e 3c abase.<br>..<b><
57a0: 75 3e 3c 69 3e 4e 6f 74 65 3c 2f 69 3e 3c 2f 75 u><i>Note</i></u
57b0: 3e 3c 2f 62 3e 3a 20 74 68 69 73 20 6d 65 74 68 ></b>: this meth
57c0: 6f 64 20 77 69 6c 6c 20 61 6c 77 61 79 73 20 74 od will always t
57d0: 61 6b 65 20 66 75 6c 6c 20 70 72 6f 66 69 74 20 ake full profit
57e0: 6f 66 20 74 68 65 20 6d 6f 72 65 20 61 64 76 61 of the more adva
57f0: 6e 63 65 64 20 63 61 70 61 62 69 6c 69 74 69 65 nced capabilitie
5800: 73 20 6f 66 20 50 52 4f 4a 2e 36 2c 20 65 76 65 s of PROJ.6, eve
5810: 6e 20 77 68 65 6e 20 75 73 69 6e 67 20 73 6f 6d n when using som
5820: 65 20 53 70 61 74 69 61 4c 69 74 65 20 64 61 74 e SpatiaLite dat
5830: 61 62 61 73 65 20 63 72 65 61 74 65 64 20 62 79 abase created by
5840: 20 65 61 72 6c 69 65 72 20 76 65 72 73 69 6f 6e earlier version
5850: 73 20 6e 6f 74 20 79 65 74 20 73 75 70 70 6f 72 s not yet suppor
5860: 74 69 6e 67 20 50 52 4f 4a 2e 36 3c 2f 6c 69 3e ting PROJ.6</li>
5870: 0d 0a 3c 6c 69 3e 3c 62 3e 70 72 6f 6a 5f 73 74 ..<li><b>proj_st
5880: 72 69 6e 67 3c 2f 62 3e 3a 20 61 6e 20 3c 62 3e ring</b>: an <b>
5890: 3c 69 3e 75 73 65 72 2d 64 65 66 69 6e 65 64 20 <i>user-defined
58a0: 70 72 6f 6a 2d 73 74 72 69 6e 67 3c 2f 69 3e 3c proj-string</i><
58b0: 2f 62 3e 20 28 6d 61 79 20 62 65 20 6f 6e 65 20 /b> (may be one
58c0: 64 65 66 69 6e 69 6e 69 6e 67 20 61 20 3c 62 3e definining a <b>
58d0: 3c 69 3e 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f <i>transformatio
58e0: 6e 20 70 69 70 65 6c 69 6e 65 3c 2f 69 3e 3c 2f n pipeline</i></
58f0: 62 3e 29 20 77 69 6c 6c 20 62 65 20 70 61 73 73 b>) will be pass
5900: 65 64 20 74 6f 20 50 52 4f 4a 2e 36 3b 20 74 68 ed to PROJ.6; th
5910: 69 73 20 69 73 20 61 6e 20 61 64 76 61 6e 63 65 is is an advance
5920: 64 20 6f 70 74 69 6f 6e 20 72 65 73 65 72 76 65 d option reserve
5930: 64 20 74 6f 20 73 6b 69 6c 6c 65 64 20 70 6f 77 d to skilled pow
5940: 65 72 20 75 73 65 72 73 2e 3c 2f 6c 69 3e 0d 0a er users.</li>..
5950: 3c 2f 75 6c 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e </ul></li>..<li>
5960: 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 the optional arg
5970: 75 6d 65 6e 74 20 3c 62 3e 70 72 6f 6a 5f 73 74 ument <b>proj_st
5980: 72 69 6e 67 3c 2f 62 3e 20 6d 61 79 20 62 65 20 ring</b> may be
5990: 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 28 3c 69 3e <b>NULL</b> (<i>
59a0: 64 65 66 61 75 6c 74 20 73 65 74 74 69 6e 67 3c default setting<
59b0: 2f 69 3e 29 2e 3c 62 72 3e 0d 0a 4f 74 68 65 72 /i>).<br>..Other
59c0: 77 69 73 65 20 69 74 27 73 20 65 78 70 65 63 74 wise it's expect
59d0: 65 64 20 74 6f 20 63 6f 6e 74 61 69 6e 20 61 20 ed to contain a
59e0: 76 61 6c 69 64 20 3c 62 3e 50 52 4f 4a 2e 36 20 valid <b>PROJ.6
59f0: 3c 69 3e 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f <i>transformatio
5a00: 6e 20 73 74 72 69 6e 67 3c 2f 69 3e 3c 2f 62 3e n string</i></b>
5a10: 2c 20 6d 61 79 20 77 65 6c 6c 20 62 65 20 63 6f , may well be co
5a20: 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 61 rresponding to a
5a30: 6e 20 3c 62 3e 3c 69 3e 75 73 65 72 2d 64 65 66 n <b><i>user-def
5a40: 69 6e 65 64 20 74 72 61 6e 73 66 6f 72 6d 61 74 ined transformat
5a50: 69 6f 6e 20 70 69 70 65 6c 69 6e 65 3c 2f 69 3e ion pipeline</i>
5a60: 3c 2f 62 3e 2e 0d 0a 4d 65 61 6e 69 6e 67 66 75 </b>...Meaningfu
5a70: 6c 20 6f 6e 6c 79 20 69 6e 20 74 68 65 20 63 61 l only in the ca
5a80: 73 65 20 6f 66 20 3c 62 3e 6d 65 74 68 6f 64 3d se of <b>method=
5a90: 70 72 6f 6a 5f 73 74 72 69 6e 67 3c 2f 62 3e 3c proj_string</b><
5aa0: 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 2f 74 /li>..</ul>..</t
5ab0: 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 d></tr>..<tr><td
5ac0: 20 63 6f 6c 73 70 61 6e 3d 22 33 22 3e 0d 0a 3c colspan="3">..<
5ad0: 68 33 3e 4e 6f 74 65 73 3c 2f 68 33 3e 0d 0a 3c h3>Notes</h3>..<
5ae0: 75 6c 3e 0d 0a 3c 6c 69 3e 53 70 61 74 69 61 4c ul>..<li>SpatiaL
5af0: 69 74 65 20 64 6f 65 73 20 6e 6f 74 20 63 6f 6e ite does not con
5b00: 73 74 72 61 69 6e 74 73 20 79 6f 75 20 69 6e 20 straints you in
5b10: 61 6e 79 20 77 61 79 20 61 6e 64 20 66 75 6c 6c any way and full
5b20: 79 20 72 65 73 70 65 63 74 73 20 75 73 65 72 73 y respects users
5b30: 20 66 72 65 65 64 6f 6d 20 63 61 72 65 66 75 6c freedom careful
5b40: 6c 79 20 61 76 6f 69 64 69 6e 67 20 3c 69 3e 61 ly avoiding <i>a
5b50: 75 74 6f 2d 6d 61 67 69 63 61 6c 3c 2f 69 3e 20 uto-magical</i>
5b60: 61 73 73 75 6d 70 74 69 6f 6e 73 2e 0d 0a 3c 75 assumptions...<u
5b70: 6c 3e 0d 0a 3c 6c 69 3e 54 68 65 20 6e 65 77 20 l>..<li>The new
5b80: 3c 62 3e 3c 69 3e 65 78 74 65 6e 64 65 64 20 73 <b><i>extended s
5b90: 69 67 6e 61 74 75 72 65 73 3c 2f 69 3e 3c 2f 62 ignatures</i></b
5ba0: 3e 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 3c > supported by <
5bb0: 62 3e 53 54 5f 54 72 61 6e 73 66 6f 72 6d 3c 2f b>ST_Transform</
5bc0: 62 3e 20 63 6c 6f 73 65 6c 79 20 6d 69 6d 69 63 b> closely mimic
5bd0: 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 the most recent
5be0: 20 50 52 4f 4a 2e 36 20 41 50 49 2c 20 73 6f 20 PROJ.6 API, so
5bf0: 79 6f 75 20 61 72 65 20 66 72 65 65 20 74 6f 20 you are free to
5c00: 64 65 66 69 6e 65 20 79 6f 75 72 20 63 6f 6f 72 define your coor
5c10: 64 69 6e 61 74 65 73 20 74 72 61 6e 73 66 6f 72 dinates transfor
5c20: 6d 61 74 69 6f 6e 73 20 69 6e 20 73 65 76 65 72 mations in sever
5c30: 61 6c 20 64 69 66 66 65 72 65 6e 74 20 77 61 79 al different way
5c40: 73 2e 3c 2f 6c 69 3e 20 0d 0a 3c 6c 69 3e 54 68 s.</li> ..<li>Th
5c50: 65 20 64 65 66 61 75 6c 74 20 62 65 68 61 76 69 e default behavi
5c60: 6f 72 20 6f 66 20 53 70 61 74 69 61 4c 69 74 65 or of SpatiaLite
5c70: 20 77 68 65 6e 20 75 73 69 6e 67 20 50 52 4f 4a when using PROJ
5c80: 2e 36 20 69 73 20 74 6f 20 63 6f 6d 70 6c 65 74 .6 is to complet
5c90: 65 6c 79 20 69 67 6e 6f 72 65 20 74 68 65 20 43 ely ignore the C
5ca0: 52 53 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 73 RS definitions s
5cb0: 74 6f 72 65 64 20 77 69 74 68 69 6e 20 74 68 65 tored within the
5cc0: 20 69 6e 74 65 72 6e 61 6c 20 74 61 62 6c 65 20 internal table
5cd0: 3c 62 3e 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 <b>spatial_ref_s
5ce0: 79 73 3c 2f 62 3e 3c 62 72 3e 0d 0a 41 6e 79 20 ys</b><br>..Any
5cf0: 72 65 71 75 69 72 65 64 20 43 52 53 20 64 65 66 required CRS def
5d00: 69 6e 69 74 69 6f 6e 20 77 69 6c 6c 20 62 65 20 inition will be
5d10: 61 6c 77 61 79 73 20 72 65 74 72 69 65 76 65 64 always retrieved
5d20: 20 66 6f 72 6d 20 74 68 65 20 70 72 69 76 61 74 form the privat
5d30: 65 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 e SQLite databas
5d40: 65 20 73 75 70 70 6f 72 74 69 6e 67 20 50 52 4f e supporting PRO
5d50: 4a 2e 36 20 28 3c 69 3e 6d 65 74 68 6f 64 3c 2f J.6 (<i>method</
5d60: 69 3e 3d 3c 62 3e 61 75 74 68 5f 6e 61 6d 65 3a i>=<b>auth_name:
5d70: 61 75 74 68 5f 73 72 69 64 3c 2f 62 3e 29 2e 3c auth_srid</b>).<
5d80: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 49 66 20 79 6f 75 /li>..<li>If you
5d90: 20 68 61 76 65 20 61 6e 79 20 67 6f 6f 64 20 72 have any good r
5da0: 65 61 73 6f 6e 20 73 75 67 67 65 73 74 69 6e 67 eason suggesting
5db0: 20 74 6f 20 64 6f 20 73 75 63 68 20 61 20 74 68 to do such a th
5dc0: 69 6e 67 2c 20 79 6f 75 20 61 72 65 20 61 6e 79 ing, you are any
5dd0: 77 61 79 20 66 72 65 65 20 74 6f 20 75 73 65 20 way free to use
5de0: 74 68 65 20 70 72 6f 6a 2d 73 74 72 69 6e 67 73 the proj-strings
5df0: 20 28 3c 69 3e 6d 65 74 68 6f 64 3c 2f 69 3e 3d (<i>method</i>=
5e00: 3c 62 3e 70 72 6f 6a 34 74 65 78 74 3c 2f 62 3e <b>proj4text</b>
5e10: 29 20 6f 72 20 74 68 65 20 57 4b 54 20 64 65 66 ) or the WKT def
5e20: 69 6e 69 74 69 6f 6e 73 20 28 3c 69 3e 6d 65 74 initions (<i>met
5e30: 68 6f 64 3c 2f 69 3e 3d 3c 62 3e 73 72 74 65 78 hod</i>=<b>srtex
5e40: 3c 2f 62 3e 74 29 20 73 74 6f 72 65 64 20 69 6e </b>t) stored in
5e50: 74 6f 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 to the internal
5e60: 74 61 62 6c 65 20 3c 62 3e 73 70 61 74 69 61 6c table <b>spatial
5e70: 5f 72 65 66 5f 73 79 73 20 74 61 62 6c 65 3c 2f _ref_sys table</
5e80: 62 3e 2e 3c 62 72 3e 0d 0a 42 75 74 20 74 68 69 b>.<br>..But thi
5e90: 73 20 69 73 20 75 6e 64 65 72 20 79 6f 75 72 20 s is under your
5ea0: 66 75 6c 6c 20 72 65 73 70 6f 6e 73 69 62 69 6c full responsibil
5eb0: 69 74 79 2c 20 61 6e 64 20 79 6f 75 20 6d 75 73 ity, and you mus
5ec0: 74 20 62 65 20 77 65 6c 6c 20 73 65 6c 66 2d 63 t be well self-c
5ed0: 6f 6e 73 63 69 6f 75 73 20 6f 66 20 77 68 61 74 onscious of what
5ee0: 20 61 72 65 20 79 6f 75 20 64 6f 69 6e 67 2e 3c are you doing.<
5ef0: 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c 69 3e /li>..</ul></li>
5f00: 0d 0a 3c 6c 69 3e 53 70 61 74 69 61 4c 69 74 65 ..<li>SpatiaLite
5f10: 20 65 6e 63 6f 75 72 61 67 65 73 20 61 6e 64 20 encourages and
5f20: 70 72 6f 6d 6f 74 65 73 20 74 68 65 20 6d 6f 73 promotes the mos
5f30: 74 20 63 72 65 61 74 69 76 65 20 75 73 65 73 20 t creative uses
5f40: 6f 66 20 50 52 4f 4a 2e 36 2c 20 74 68 69 73 20 of PROJ.6, this
5f50: 69 6e 63 6c 75 64 69 6e 67 20 3c 62 3e 74 72 61 including <b>tra
5f60: 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 nsformation pipe
5f70: 6c 69 6e 65 73 3c 2f 62 3e 2e 3c 62 72 3e 0d 0a lines</b>.<br>..
5f80: 43 6f 72 72 65 63 74 6c 79 20 75 73 69 6e 67 20 Correctly using
5f90: 3c 69 3e 6d 65 74 68 6f 64 3c 2f 69 3e 3d 3c 62 <i>method</i>=<b
5fa0: 3e 70 72 6f 6a 5f 73 74 72 69 6e 67 3c 2f 62 3e >proj_string</b>
5fb0: 20 66 6f 72 20 63 6f 6d 70 75 74 69 6e 67 20 63 for computing c
5fc0: 75 73 74 6f 6d 20 74 72 61 6e 73 66 6f 72 6d 61 ustom transforma
5fd0: 74 69 6f 6e 73 20 69 73 6e 27 74 20 6e 65 63 65 tions isn't nece
5fe0: 73 73 61 72 69 6c 79 20 73 69 6d 70 6c 65 20 61 ssarily simple a
5ff0: 6e 64 20 65 61 73 79 2c 20 62 75 74 20 69 74 27 nd easy, but it'
6000: 73 20 61 20 62 69 67 20 6f 70 70 6f 72 74 75 6e s a big opportun
6010: 69 74 79 20 66 6f 72 20 61 6c 6c 20 73 6b 69 6c ity for all skil
6020: 6c 65 64 20 61 6e 64 20 74 61 6c 65 6e 74 65 64 led and talented
6030: 20 70 6f 77 65 72 20 75 73 65 72 73 2e 3c 2f 6c power users.</l
6040: 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 3c 62 72 i>..</ul><br><br
6050: 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c >..</td></tr>..<
6060: 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 46 65 77 /table><br>..Few
6070: 20 70 72 61 63 74 69 63 61 6c 20 53 51 4c 20 65 practical SQL e
6080: 78 61 6d 70 6c 65 73 3a 0d 0a 3c 76 65 72 62 61 xamples:..<verba
6090: 74 69 6d 3e 0d 0a 2d 2d 20 74 6f 20 45 50 53 47 tim>..-- to EPSG
60a0: 3a 33 30 30 33 20 2d 20 64 65 66 61 75 6c 74 20 :3003 - default
60b0: 73 65 74 74 69 6e 67 73 3b 20 69 67 6e 6f 72 69 settings; ignori
60c0: 6e 67 20 73 70 61 74 69 61 6c 69 74 65 5f 72 65 ng spatialite_re
60d0: 66 5f 73 79 73 20 61 6e 64 20 75 73 69 6e 67 20 f_sys and using
60e0: 74 68 65 20 50 52 4f 4a 2e 36 20 6f 77 6e 20 70 the PROJ.6 own p
60f0: 72 69 76 61 74 65 20 64 61 74 61 62 61 73 65 0d rivate database.
6100: 0a 53 45 4c 45 43 54 20 41 73 45 57 4b 54 20 28 .SELECT AsEWKT (
6110: 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d ST_Transform( M
6120: 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 38 akePoint( 11.878
6130: 30 35 36 20 2c 20 34 33 2e 34 36 33 30 35 36 20 056 , 43.463056
6140: 2c 20 34 33 32 36 20 29 20 2c 20 33 30 30 33 20 , 4326 ) , 3003
6150: 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ));..-----------
6160: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6170: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 ----------..SRID
6180: 3d 33 30 30 33 3b 50 4f 49 4e 54 28 31 37 33 32 =3003;POINT(1732
6190: 38 35 32 2e 39 34 32 37 31 36 37 36 39 20 34 38 852.942716769 48
61a0: 31 36 32 37 37 2e 36 31 37 36 39 30 36 37 34 29 16277.617690674)
61b0: 0d 0a 0d 0a 2d 2d 20 74 6f 20 45 50 53 47 3a 33 ....-- to EPSG:3
61c0: 30 30 33 20 2d 20 4e 55 4c 4c 20 61 72 65 61 20 003 - NULL area
61d0: 6f 66 20 75 73 65 2c 20 75 73 69 6e 67 20 57 4b of use, using WK
61e0: 54 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 66 72 T definitions fr
61f0: 6f 6d 20 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 om spatial_ref_s
6200: 79 73 2e 73 72 74 65 78 74 0d 0a 53 45 4c 45 43 ys.srtext..SELEC
6210: 54 20 41 73 45 57 4b 54 20 28 20 53 54 5f 54 72 T AsEWKT ( ST_Tr
6220: 61 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 ansform( MakePoi
6230: 6e 74 28 20 31 31 2e 38 37 38 30 35 36 20 2c 20 nt( 11.878056 ,
6240: 34 33 2e 34 36 33 30 35 36 2c 20 34 33 32 36 20 43.463056, 4326
6250: 29 20 2c 20 33 30 30 33 20 2c 20 4e 55 4c 4c 20 ) , 3003 , NULL
6260: 2c 20 27 73 72 74 65 78 74 27 20 29 29 3b 0d 0a , 'srtext' ));..
6270: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6280: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6290: 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d 33 30 30 33 -----..SRID=3003
62a0: 3b 50 4f 49 4e 54 28 31 37 33 32 38 35 32 2e 39 ;POINT(1732852.9
62b0: 34 32 37 31 36 37 36 39 20 34 38 31 36 32 37 37 42716769 4816277
62c0: 2e 36 31 37 36 39 30 36 37 34 29 0d 0a 0d 0a 2d .617690674)....-
62d0: 2d 20 74 6f 20 45 50 53 47 3a 33 30 30 33 20 2d - to EPSG:3003 -
62e0: 20 4e 55 4c 4c 20 61 72 65 61 20 6f 66 20 75 73 NULL area of us
62f0: 65 2c 20 75 73 69 6e 67 20 70 72 6f 6a 2d 73 74 e, using proj-st
6300: 72 69 6e 67 20 64 65 66 69 6e 69 74 69 6f 6e 73 ring definitions
6310: 20 66 72 6f 6d 20 73 70 61 74 69 61 6c 5f 72 65 from spatial_re
6320: 66 5f 73 79 73 2e 70 72 6f 6a 34 74 65 78 74 0d f_sys.proj4text.
6330: 0a 53 45 4c 45 43 54 20 41 73 45 57 4b 54 20 28 .SELECT AsEWKT (
6340: 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d ST_Transform( M
6350: 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 38 akePoint( 11.878
6360: 30 35 36 20 2c 20 34 33 2e 34 36 33 30 35 36 2c 056 , 43.463056,
6370: 20 34 33 32 36 20 29 20 2c 20 33 30 30 33 20 2c 4326 ) , 3003 ,
6380: 20 4e 55 4c 4c 20 2c 20 27 70 72 6f 6a 34 74 65 NULL , 'proj4te
6390: 78 74 27 20 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d xt' ));..-------
63a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
63b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a --------------..
63c0: 53 52 49 44 3d 33 30 30 33 3b 50 4f 49 4e 54 28 SRID=3003;POINT(
63d0: 31 37 33 32 38 35 32 2e 39 34 32 37 31 36 37 36 1732852.94271676
63e0: 39 20 34 38 31 36 32 37 37 2e 36 31 37 36 39 30 9 4816277.617690
63f0: 36 37 34 29 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 674)..</verbatim
6400: 3e 0d 0a 54 68 69 73 20 66 69 72 73 74 20 74 65 >..This first te
6410: 73 74 20 69 73 20 62 61 73 65 64 20 6f 6e 20 61 st is based on a
6420: 20 6e 65 77 20 53 70 61 74 69 61 4c 69 74 65 20 new SpatiaLite
6430: 64 61 74 61 62 61 73 65 20 63 72 65 61 74 65 64 database created
6440: 20 77 69 74 68 20 66 75 6c 6c 20 50 52 4f 4a 2e with full PROJ.
6450: 36 20 73 75 70 70 6f 72 74 2e 20 54 68 65 72 65 6 support. There
6460: 20 69 73 6e 27 74 20 61 6e 79 74 68 69 6e 67 20 isn't anything
6470: 77 6f 72 74 68 20 74 6f 20 62 65 20 6e 6f 74 65 worth to be note
6480: 64 2c 20 65 78 63 65 70 74 20 74 68 61 74 20 61 d, except that a
6490: 6c 6c 20 6d 65 74 68 6f 64 73 20 72 65 74 75 72 ll methods retur
64a0: 6e 20 74 68 65 20 73 61 6d 65 20 72 65 73 75 6c n the same resul
64b0: 74 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 76 65 72 t.<br><br>..<ver
64c0: 62 61 74 69 6d 3e 0d 0a 2d 2d 20 74 6f 20 45 50 batim>..-- to EP
64d0: 53 47 3a 33 30 30 33 20 2d 20 75 73 69 6e 67 20 SG:3003 - using
64e0: 61 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e a transformation
64f0: 20 70 69 70 65 6c 69 6e 65 0d 0a 53 45 4c 45 43 pipeline..SELEC
6500: 54 20 41 73 45 57 4b 54 20 28 20 53 54 5f 54 72 T AsEWKT ( ST_Tr
6510: 61 6e 73 66 6f 72 6d 28 20 53 77 61 70 43 6f 6f ansform( SwapCoo
6520: 72 64 73 20 28 20 4d 61 6b 65 50 6f 69 6e 74 28 rds ( MakePoint(
6530: 20 31 31 2e 38 37 38 30 35 36 20 2c 20 34 33 2e 11.878056 , 43.
6540: 34 36 33 30 35 36 2c 20 34 33 32 36 20 29 20 29 463056, 4326 ) )
6550: 20 2c 20 33 30 30 33 20 2c 20 4e 55 4c 4c 20 2c , 3003 , NULL ,
6560: 20 27 70 72 6f 6a 5f 73 74 72 69 6e 67 27 20 2c 'proj_string' ,
6570: 0d 0a 27 2b 70 72 6f 6a 3d 70 69 70 65 6c 69 6e ..'+proj=pipelin
6580: 65 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d e ..+step +proj=
6590: 61 78 69 73 73 77 61 70 20 2b 6f 72 64 65 72 3d axisswap +order=
65a0: 32 2c 31 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 2,1 ..+step +pro
65b0: 6a 3d 75 6e 69 74 63 6f 6e 76 65 72 74 20 2b 78 j=unitconvert +x
65c0: 79 5f 69 6e 3d 64 65 67 20 2b 78 79 5f 6f 75 74 y_in=deg +xy_out
65d0: 3d 72 61 64 20 0d 0a 2b 73 74 65 70 20 2b 70 72 =rad ..+step +pr
65e0: 6f 6a 3d 70 75 73 68 20 2b 76 5f 33 20 0d 0a 2b oj=push +v_3 ..+
65f0: 73 74 65 70 20 2b 70 72 6f 6a 3d 63 61 72 74 20 step +proj=cart
6600: 2b 65 6c 6c 70 73 3d 57 47 53 38 34 20 0d 0a 2b +ellps=WGS84 ..+
6610: 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d step +inv +proj=
6620: 68 65 6c 6d 65 72 74 20 2b 78 3d 2d 31 30 34 2e helmert +x=-104.
6630: 31 20 2b 79 3d 2d 34 39 2e 31 20 2b 7a 3d 2d 39 1 +y=-49.1 +z=-9
6640: 2e 39 20 2b 72 78 3d 30 2e 39 37 31 20 2b 72 79 .9 +rx=0.971 +ry
6650: 3d 2d 32 2e 39 31 37 20 2b 72 7a 3d 30 2e 37 31 =-2.917 +rz=0.71
6660: 34 20 2b 73 3d 2d 31 31 2e 36 38 20 2b 63 6f 6e 4 +s=-11.68 +con
6670: 76 65 6e 74 69 6f 6e 3d 70 6f 73 69 74 69 6f 6e vention=position
6680: 5f 76 65 63 74 6f 72 20 0d 0a 2b 73 74 65 70 20 _vector ..+step
6690: 2b 69 6e 76 20 2b 70 72 6f 6a 3d 63 61 72 74 20 +inv +proj=cart
66a0: 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20 0d 0a 2b 73 +ellps=intl ..+s
66b0: 74 65 70 20 2b 70 72 6f 6a 3d 70 6f 70 20 2b 76 tep +proj=pop +v
66c0: 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a _3 ..+step +proj
66d0: 3d 74 6d 65 72 63 20 2b 6c 61 74 5f 30 3d 30 20 =tmerc +lat_0=0
66e0: 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 2e 39 39 +lon_0=9 +k=0.99
66f0: 39 36 20 2b 78 5f 30 3d 31 35 30 30 30 30 30 20 96 +x_0=1500000
6700: 2b 79 5f 30 3d 30 20 2b 65 6c 6c 70 73 3d 69 6e +y_0=0 +ellps=in
6710: 74 6c 27 20 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d tl' ));..-------
6720: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6730: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a --------------..
6740: 53 52 49 44 3d 33 30 30 33 3b 50 4f 49 4e 54 28 SRID=3003;POINT(
6750: 31 37 33 32 38 35 32 2e 39 34 32 37 31 36 37 36 1732852.94271676
6760: 39 20 34 38 31 36 32 37 37 2e 36 31 37 36 39 30 9 4816277.617690
6770: 36 37 34 29 0d 0a 0d 0a 2d 2d 20 74 6f 20 45 50 674)....-- to EP
6780: 53 47 3a 33 30 30 33 20 2d 20 75 73 69 6e 67 20 SG:3003 - using
6790: 61 20 63 75 73 74 6f 6d 69 7a 65 64 20 74 72 61 a customized tra
67a0: 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 nsformation pipe
67b0: 6c 69 6e 65 0d 0a 53 45 4c 45 43 54 20 41 73 45 line..SELECT AsE
67c0: 57 4b 54 20 28 20 53 54 5f 54 72 61 6e 73 66 6f WKT ( ST_Transfo
67d0: 72 6d 28 20 4d 61 6b 65 50 6f 69 6e 74 28 20 31 rm( MakePoint( 1
67e0: 31 2e 38 37 38 30 35 36 20 2c 20 34 33 2e 34 36 1.878056 , 43.46
67f0: 33 30 35 36 2c 20 34 33 32 36 20 29 20 2c 20 33 3056, 4326 ) , 3
6800: 30 30 33 20 2c 20 4e 55 4c 4c 20 2c 20 27 70 72 003 , NULL , 'pr
6810: 6f 6a 5f 73 74 72 69 6e 67 27 20 2c 0d 0a 27 2b oj_string' ,..'+
6820: 70 72 6f 6a 3d 70 69 70 65 6c 69 6e 65 20 20 0d proj=pipeline .
6830: 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 75 6e 69 .+step +proj=uni
6840: 74 63 6f 6e 76 65 72 74 20 2b 78 79 5f 69 6e 3d tconvert +xy_in=
6850: 64 65 67 20 2b 78 79 5f 6f 75 74 3d 72 61 64 20 deg +xy_out=rad
6860: 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 75 ..+step +proj=pu
6870: 73 68 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 sh +v_3 ..+step
6880: 2b 70 72 6f 6a 3d 63 61 72 74 20 2b 65 6c 6c 70 +proj=cart +ellp
6890: 73 3d 57 47 53 38 34 20 0d 0a 2b 73 74 65 70 20 s=WGS84 ..+step
68a0: 2b 69 6e 76 20 2b 70 72 6f 6a 3d 68 65 6c 6d 65 +inv +proj=helme
68b0: 72 74 20 2b 78 3d 2d 31 30 34 2e 31 20 2b 79 3d rt +x=-104.1 +y=
68c0: 2d 34 39 2e 31 20 2b 7a 3d 2d 39 2e 39 20 2b 72 -49.1 +z=-9.9 +r
68d0: 78 3d 30 2e 39 37 31 20 2b 72 79 3d 2d 32 2e 39 x=0.971 +ry=-2.9
68e0: 31 37 20 2b 72 7a 3d 30 2e 37 31 34 20 2b 73 3d 17 +rz=0.714 +s=
68f0: 2d 31 31 2e 36 38 20 2b 63 6f 6e 76 65 6e 74 69 -11.68 +conventi
6900: 6f 6e 3d 70 6f 73 69 74 69 6f 6e 5f 76 65 63 74 on=position_vect
6910: 6f 72 20 0d 0a 2b 73 74 65 70 20 2b 69 6e 76 20 or ..+step +inv
6920: 2b 70 72 6f 6a 3d 63 61 72 74 20 2b 65 6c 6c 70 +proj=cart +ellp
6930: 73 3d 69 6e 74 6c 20 0d 0a 2b 73 74 65 70 20 2b s=intl ..+step +
6940: 70 72 6f 6a 3d 70 6f 70 20 2b 76 5f 33 20 0d 0a proj=pop +v_3 ..
6950: 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 74 6d 65 72 +step +proj=tmer
6960: 63 20 2b 6c 61 74 5f 30 3d 30 20 2b 6c 6f 6e 5f c +lat_0=0 +lon_
6970: 30 3d 39 20 2b 6b 3d 30 2e 39 39 39 36 20 2b 78 0=9 +k=0.9996 +x
6980: 5f 30 3d 31 35 30 30 30 30 30 20 2b 79 5f 30 3d _0=1500000 +y_0=
6990: 30 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c 27 20 29 0 +ellps=intl' )
69a0: 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d );..------------
69b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
69c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d ---------..SRID=
69d0: 33 30 30 33 3b 50 4f 49 4e 54 28 31 37 33 32 38 3003;POINT(17328
69e0: 35 32 2e 39 34 32 37 31 36 37 36 39 20 34 38 31 52.942716769 481
69f0: 36 32 37 37 2e 36 31 37 36 39 30 36 37 34 29 0d 6277.617690674).
6a00: 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 54 68 .</verbatim>..Th
6a10: 69 73 20 73 65 63 6f 6e 64 20 74 65 73 74 20 69 is second test i
6a20: 73 20 62 61 73 65 64 20 6f 6e 20 75 73 69 6e 67 s based on using
6a30: 20 3c 62 3e 3c 69 3e 74 72 61 6e 73 66 6f 72 6d <b><i>transform
6a40: 61 74 69 6f 6e 20 70 69 70 65 6c 69 6e 65 73 3c ation pipelines<
6a50: 2f 69 3e 3c 2f 62 3e 3a 0d 0a 3c 75 6c 3e 0d 0a /i></b>:..<ul>..
6a60: 3c 6c 69 3e 74 68 65 20 66 69 72 73 74 20 71 75 <li>the first qu
6a70: 65 72 79 20 64 69 72 65 63 74 6c 79 20 75 73 65 ery directly use
6a80: 73 20 61 20 70 72 6f 6a 2d 73 74 72 69 6e 67 20 s a proj-string
6a90: 72 65 70 72 65 73 65 6e 74 69 6e 67 20 74 68 65 representing the
6aa0: 20 70 69 70 65 6c 69 6e 65 20 61 73 20 64 65 66 pipeline as def
6ab0: 69 6e 65 64 20 62 79 20 65 78 65 63 75 74 69 6e ined by executin
6ac0: 67 3c 62 72 3e 0d 0a 3c 62 3e 70 72 6f 6a 69 6e g<br>..<b>projin
6ad0: 66 6f 20 20 2d 73 20 45 50 53 47 3a 34 33 32 36 fo -s EPSG:4326
6ae0: 20 2d 74 20 45 50 53 47 3a 33 30 30 33 20 2d 2d -t EPSG:3003 --
6af0: 61 72 65 61 20 20 22 49 74 61 6c 79 20 2d 20 6d area "Italy - m
6b00: 61 69 6e 6c 61 6e 64 22 20 2d 6f 20 70 72 6f 6a ainland" -o proj
6b10: 3c 2f 62 3e 3c 62 72 3e 0d 0a 28 77 65 27 6c 6c </b><br>..(we'll
6b20: 20 73 65 65 20 74 68 69 73 20 74 6f 70 69 63 20 see this topic
6b30: 69 6e 20 6d 6f 72 65 20 64 65 70 74 68 20 6f 6e in more depth on
6b40: 20 74 68 65 20 6e 65 78 74 20 70 61 72 61 67 72 the next paragr
6b50: 61 70 68 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e aph).</li>..<li>
6b60: 74 68 65 20 73 65 63 6f 6e 64 20 71 75 65 72 79 the second query
6b70: 20 69 73 20 6a 75 73 74 20 61 20 73 6d 61 6c 6c is just a small
6b80: 20 61 64 61 70 74 61 74 69 6f 6e 20 6f 66 20 74 adaptation of t
6b90: 68 65 20 66 69 72 73 74 20 6f 6e 65 3a 0d 0a 3c he first one:..<
6ba0: 75 6c 3e 0d 0a 3c 6c 69 3e 41 73 20 79 6f 75 20 ul>..<li>As you
6bb0: 63 61 6e 20 6e 6f 74 69 63 65 20 74 68 65 20 66 can notice the f
6bc0: 69 72 73 74 20 71 75 65 72 79 20 72 65 71 75 69 irst query requi
6bd0: 72 65 73 20 63 61 6c 6c 69 6e 67 20 3c 62 3e 53 res calling <b>S
6be0: 77 61 70 43 6f 6f 64 69 6e 61 74 65 73 28 29 3c wapCoodinates()<
6bf0: 2f 62 3e 20 62 65 63 61 75 73 65 20 74 68 65 20 /b> because the
6c00: 66 69 72 73 74 20 73 74 65 70 20 6f 66 20 74 68 first step of th
6c10: 65 20 70 69 70 65 6c 69 6e 65 20 68 61 73 20 61 e pipeline has a
6c20: 6e 20 3c 62 3e 61 78 69 73 73 77 61 70 3c 2f 62 n <b>axisswap</b
6c30: 3e 20 64 69 72 65 63 74 69 76 65 2e 3c 2f 6c 69 > directive.</li
6c40: 3e 0d 0a 3c 6c 69 3e 54 68 65 20 73 65 63 6f 6e >..<li>The secon
6c50: 64 20 71 75 65 72 79 20 6a 75 73 74 20 61 76 6f d query just avo
6c60: 69 64 73 20 74 6f 20 63 61 6c 6c 20 3c 62 3e 53 ids to call <b>S
6c70: 77 61 70 43 6f 6f 72 64 73 28 29 3c 2f 62 3e 20 wapCoords()</b>
6c80: 61 6e 64 20 63 6f 6e 73 65 71 75 65 6e 74 6c 79 and consequently
6c90: 20 74 68 65 20 74 72 61 73 66 6f 72 6d 61 74 69 the trasformati
6ca0: 6f 6e 20 70 69 70 65 6c 69 6e 65 20 73 74 65 70 on pipeline step
6cb0: 20 72 65 6d 6f 76 65 73 20 74 68 69 73 20 66 69 removes this fi
6cc0: 72 73 74 20 73 74 65 70 20 73 6f 20 74 6f 20 67 rst step so to g
6cd0: 65 74 20 74 68 65 20 73 61 6d 65 20 69 64 65 6e et the same iden
6ce0: 74 69 63 61 6c 20 6f 76 65 72 61 6c 6c 20 65 66 tical overall ef
6cf0: 66 65 63 74 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c fect.</li>..</ul
6d00: 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 3c ></li>..<li><b><
6d10: 75 3e 4e 6f 74 65 3c 2f 75 3e 3c 2f 62 3e 3a 20 u>Note</u></b>:
6d20: 53 70 61 74 69 61 4c 69 74 65 20 77 69 6c 6c 20 SpatiaLite will
6d30: 61 6c 77 61 79 73 20 64 6f 20 61 20 62 65 73 74 always do a best
6d40: 20 65 66 66 6f 72 74 20 69 6e 20 6f 72 64 65 72 effort in order
6d50: 20 74 6f 20 67 75 65 73 73 20 69 66 20 73 77 61 to guess if swa
6d60: 70 70 69 6e 67 20 74 68 65 20 63 6f 6f 72 64 69 pping the coordi
6d70: 6e 61 74 65 73 20 62 65 66 6f 72 65 20 70 61 73 nates before pas
6d80: 73 69 6e 67 20 74 68 65 6d 20 74 6f 20 50 52 4f sing them to PRO
6d90: 4a 2e 36 20 69 73 20 72 65 71 75 69 72 65 64 20 J.6 is required
6da0: 6f 72 20 6e 6f 74 2e 3c 62 72 3e 0d 0a 42 75 74 or not.<br>..But
6db0: 20 69 6e 20 74 68 65 20 73 70 65 63 69 66 69 63 in the specific
6dc0: 20 63 61 73 65 20 6f 66 20 61 20 74 72 61 6e 73 case of a trans
6dd0: 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 6c 69 formation pipeli
6de0: 6e 65 20 74 68 69 73 20 74 65 73 74 20 6d 61 79 ne this test may
6df0: 20 65 61 73 69 6c 79 20 66 61 69 6c 2c 20 74 68 easily fail, th
6e00: 75 73 20 72 65 71 75 69 72 69 6e 67 20 74 6f 20 us requiring to
6e10: 65 78 70 6c 69 63 69 74 6c 79 20 63 61 6c 6c 20 explicitly call
6e20: 3c 62 3e 53 77 61 70 43 6f 6f 72 64 73 28 29 3c <b>SwapCoords()<
6e30: 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c /b></li>..</ul><
6e40: 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c br>..<table cell
6e50: 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c spacing="8" cell
6e60: 70 61 64 64 69 6e 67 3d 22 31 36 22 20 62 67 63 padding="16" bgc
6e70: 6f 6c 6f 72 3d 22 23 63 39 66 66 66 30 22 3e 0d olor="#c9fff0">.
6e80: 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 68 33 3e 75 .<tr><td>..<h3>u
6e90: 73 69 6e 67 20 70 72 6f 6a 69 6e 66 6f 20 66 6f sing projinfo fo
6ea0: 72 20 64 65 74 65 63 74 69 6e 67 20 74 72 61 6e r detecting tran
6eb0: 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 6c sformation pipel
6ec0: 69 6e 65 73 20 61 6e 64 20 73 75 70 70 6f 72 74 ines and support
6ed0: 65 64 20 61 72 65 61 73 20 6f 66 20 75 73 65 3c ed areas of use<
6ee0: 2f 68 33 3e 0d 0a 3c 76 65 72 62 61 74 69 6d 3e /h3>..<verbatim>
6ef0: 0d 0a 70 72 6f 6a 69 6e 66 6f 20 2d 73 20 45 50 ..projinfo -s EP
6f00: 53 47 3a 34 33 32 36 20 2d 74 20 45 50 53 47 3a SG:4326 -t EPSG:
6f10: 33 30 30 33 20 2d 6f 20 70 72 6f 6a 20 2d 2d 73 3003 -o proj --s
6f20: 70 61 74 69 61 6c 2d 74 65 73 74 20 69 6e 74 65 patial-test inte
6f30: 72 73 65 63 74 0d 0a 43 61 6e 64 69 64 61 74 65 rsect..Candidate
6f40: 20 6f 70 65 72 61 74 69 6f 6e 73 20 66 6f 75 6e operations foun
6f50: 64 3a 20 33 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d d: 3..----------
6f60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
6f70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 4f 70 65 -----------..Ope
6f80: 72 61 74 69 6f 6e 20 6e c2 b0 31 3a 0d 0a 0d 0a ration n..1:....
6f90: 75 6e 6b 6e 6f 77 6e 20 69 64 2c 20 49 6e 76 65 unknown id, Inve
6fa0: 72 73 65 20 6f 66 20 4d 6f 6e 74 65 20 4d 61 72 rse of Monte Mar
6fb0: 69 6f 20 74 6f 20 57 47 53 20 38 34 20 28 34 29 io to WGS 84 (4)
6fc0: 20 2b 20 49 74 61 6c 79 20 7a 6f 6e 65 20 31 2c + Italy zone 1,
6fd0: 20 34 20 6d 2c 20 49 74 61 6c 79 20 2d 20 6d 61 4 m, Italy - ma
6fe0: 69 6e 6c 61 6e 64 0d 0a 0d 0a 50 52 4f 4a 20 73 inland....PROJ s
6ff0: 74 72 69 6e 67 3a 0d 0a 2b 70 72 6f 6a 3d 70 69 tring:..+proj=pi
7000: 70 65 6c 69 6e 65 20 0d 0a 2b 73 74 65 70 20 2b peline ..+step +
7010: 70 72 6f 6a 3d 61 78 69 73 73 77 61 70 20 2b 6f proj=axisswap +o
7020: 72 64 65 72 3d 32 2c 31 20 0d 0a 2b 73 74 65 70 rder=2,1 ..+step
7030: 20 2b 70 72 6f 6a 3d 75 6e 69 74 63 6f 6e 76 65 +proj=unitconve
7040: 72 74 20 2b 78 79 5f 69 6e 3d 64 65 67 20 2b 78 rt +xy_in=deg +x
7050: 79 5f 6f 75 74 3d 72 61 64 20 0d 0a 2b 73 74 65 y_out=rad ..+ste
7060: 70 20 2b 70 72 6f 6a 3d 70 75 73 68 20 2b 76 5f p +proj=push +v_
7070: 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 3 ..+step +proj=
7080: 63 61 72 74 20 2b 65 6c 6c 70 73 3d 57 47 53 38 cart +ellps=WGS8
7090: 34 20 0d 0a 2b 73 74 65 70 20 2b 69 6e 76 20 2b 4 ..+step +inv +
70a0: 70 72 6f 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 3d proj=helmert +x=
70b0: 2d 31 30 34 2e 31 20 2b 79 3d 2d 34 39 2e 31 20 -104.1 +y=-49.1
70c0: 2b 7a 3d 2d 39 2e 39 20 2b 72 78 3d 30 2e 39 37 +z=-9.9 +rx=0.97
70d0: 31 20 2b 72 79 3d 2d 32 2e 39 31 37 20 2b 72 7a 1 +ry=-2.917 +rz
70e0: 3d 30 2e 37 31 34 20 2b 73 3d 2d 31 31 2e 36 38 =0.714 +s=-11.68
70f0: 20 2b 63 6f 6e 76 65 6e 74 69 6f 6e 3d 70 6f 73 +convention=pos
7100: 69 74 69 6f 6e 5f 76 65 63 74 6f 72 20 0d 0a 2b ition_vector ..+
7110: 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d step +inv +proj=
7120: 63 61 72 74 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c cart +ellps=intl
7130: 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 ..+step +proj=p
7140: 6f 70 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 op +v_3 ..+step
7150: 2b 70 72 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 +proj=tmerc +lat
7160: 5f 30 3d 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b _0=0 +lon_0=9 +k
7170: 3d 30 2e 39 39 39 36 20 2b 78 5f 30 3d 31 35 30 =0.9996 +x_0=150
7180: 30 30 30 30 20 2b 79 5f 30 3d 30 20 2b 65 6c 6c 0000 +y_0=0 +ell
7190: 70 73 3d 69 6e 74 6c 0d 0a 0d 0a 2d 2d 2d 2d 2d ps=intl....-----
71a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
71b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
71c0: 0d 0a 4f 70 65 72 61 74 69 6f 6e 20 6e c2 b0 32 ..Operation n..2
71d0: 3a 0d 0a 0d 0a 75 6e 6b 6e 6f 77 6e 20 69 64 2c :....unknown id,
71e0: 20 49 6e 76 65 72 73 65 20 6f 66 20 4d 6f 6e 74 Inverse of Mont
71f0: 65 20 4d 61 72 69 6f 20 74 6f 20 57 47 53 20 38 e Mario to WGS 8
7200: 34 20 28 32 29 20 2b 20 49 74 61 6c 79 20 7a 6f 4 (2) + Italy zo
7210: 6e 65 20 31 2c 20 34 20 6d 2c 20 49 74 61 6c 79 ne 1, 4 m, Italy
7220: 20 2d 20 53 61 72 64 69 6e 69 61 20 6f 6e 73 68 - Sardinia onsh
7230: 6f 72 65 0d 0a 0d 0a 50 52 4f 4a 20 73 74 72 69 ore....PROJ stri
7240: 6e 67 3a 0d 0a 2b 70 72 6f 6a 3d 70 69 70 65 6c ng:..+proj=pipel
7250: 69 6e 65 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f ine ..+step +pro
7260: 6a 3d 61 78 69 73 73 77 61 70 20 2b 6f 72 64 65 j=axisswap +orde
7270: 72 3d 32 2c 31 20 0d 0a 2b 73 74 65 70 20 2b 70 r=2,1 ..+step +p
7280: 72 6f 6a 3d 75 6e 69 74 63 6f 6e 76 65 72 74 20 roj=unitconvert
7290: 2b 78 79 5f 69 6e 3d 64 65 67 20 2b 78 79 5f 6f +xy_in=deg +xy_o
72a0: 75 74 3d 72 61 64 20 0d 0a 2b 73 74 65 70 20 2b ut=rad ..+step +
72b0: 70 72 6f 6a 3d 70 75 73 68 20 2b 76 5f 33 20 0d proj=push +v_3 .
72c0: 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 63 61 72 .+step +proj=car
72d0: 74 20 2b 65 6c 6c 70 73 3d 57 47 53 38 34 20 0d t +ellps=WGS84 .
72e0: 0a 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f .+step +inv +pro
72f0: 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 3d 2d 31 36 j=helmert +x=-16
7300: 38 2e 36 20 2b 79 3d 2d 33 34 20 2b 7a 3d 33 38 8.6 +y=-34 +z=38
7310: 2e 36 20 2b 72 78 3d 2d 30 2e 33 37 34 20 2b 72 .6 +rx=-0.374 +r
7320: 79 3d 2d 30 2e 36 37 39 20 2b 72 7a 3d 2d 31 2e y=-0.679 +rz=-1.
7330: 33 37 39 20 2b 73 3d 2d 39 2e 34 38 20 2b 63 6f 379 +s=-9.48 +co
7340: 6e 76 65 6e 74 69 6f 6e 3d 70 6f 73 69 74 69 6f nvention=positio
7350: 6e 5f 76 65 63 74 6f 72 20 0d 0a 2b 73 74 65 70 n_vector ..+step
7360: 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d 63 61 72 74 +inv +proj=cart
7370: 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20 0d 0a 2b +ellps=intl ..+
7380: 73 74 65 70 20 2b 70 72 6f 6a 3d 70 6f 70 20 2b step +proj=pop +
7390: 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f v_3 ..+step +pro
73a0: 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 5f 30 3d 30 j=tmerc +lat_0=0
73b0: 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 2e 39 +lon_0=9 +k=0.9
73c0: 39 39 36 20 2b 78 5f 30 3d 31 35 30 30 30 30 30 996 +x_0=1500000
73d0: 20 2b 79 5f 30 3d 30 20 2b 65 6c 6c 70 73 3d 69 +y_0=0 +ellps=i
73e0: 6e 74 6c 0d 0a 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d ntl....---------
73f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
7400: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 4f 70 ------------..Op
7410: 65 72 61 74 69 6f 6e 20 6e c2 b0 33 3a 0d 0a 0d eration n..3:...
7420: 0a 75 6e 6b 6e 6f 77 6e 20 69 64 2c 20 49 6e 76 .unknown id, Inv
7430: 65 72 73 65 20 6f 66 20 4d 6f 6e 74 65 20 4d 61 erse of Monte Ma
7440: 72 69 6f 20 74 6f 20 57 47 53 20 38 34 20 28 31 rio to WGS 84 (1
7450: 31 29 20 2b 20 49 74 61 6c 79 20 7a 6f 6e 65 20 1) + Italy zone
7460: 31 2c 20 31 30 20 6d 2c 20 49 74 61 6c 79 20 2d 1, 10 m, Italy -
7470: 20 53 69 63 69 6c 79 20 53 74 72 61 69 74 20 77 Sicily Strait w
7480: 65 73 74 20 6f 66 20 31 33 c2 b0 45 0d 0a 0d 0a est of 13..E....
7490: 50 52 4f 4a 20 73 74 72 69 6e 67 3a 0d 0a 2b 70 PROJ string:..+p
74a0: 72 6f 6a 3d 70 69 70 65 6c 69 6e 65 20 0d 0a 2b roj=pipeline ..+
74b0: 73 74 65 70 20 2b 70 72 6f 6a 3d 61 78 69 73 73 step +proj=axiss
74c0: 77 61 70 20 2b 6f 72 64 65 72 3d 32 2c 31 20 0d wap +order=2,1 .
74d0: 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 75 6e 69 .+step +proj=uni
74e0: 74 63 6f 6e 76 65 72 74 20 2b 78 79 5f 69 6e 3d tconvert +xy_in=
74f0: 64 65 67 20 2b 78 79 5f 6f 75 74 3d 72 61 64 20 deg +xy_out=rad
7500: 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 75 ..+step +proj=pu
7510: 73 68 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 sh +v_3 ..+step
7520: 2b 70 72 6f 6a 3d 63 61 72 74 20 2b 65 6c 6c 70 +proj=cart +ellp
7530: 73 3d 57 47 53 38 34 20 0d 0a 2b 73 74 65 70 20 s=WGS84 ..+step
7540: 2b 70 72 6f 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 +proj=helmert +x
7550: 3d 32 33 30 2e 34 37 20 2b 79 3d 35 36 2e 30 38 =230.47 +y=56.08
7560: 20 2b 7a 3d 2d 32 32 2e 34 33 20 0d 0a 2b 73 74 +z=-22.43 ..+st
7570: 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d 63 61 ep +inv +proj=ca
7580: 72 74 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20 0d rt +ellps=intl .
7590: 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 6f 70 .+step +proj=pop
75a0: 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 +v_3 ..+step +p
75b0: 72 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 5f 30 roj=tmerc +lat_0
75c0: 3d 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 =0 +lon_0=9 +k=0
75d0: 2e 39 39 39 36 20 2b 78 5f 30 3d 31 35 30 30 30 .9996 +x_0=15000
75e0: 30 30 20 2b 79 5f 30 3d 30 20 2b 65 6c 6c 70 73 00 +y_0=0 +ellps
75f0: 3d 69 6e 74 6c 0d 0a 3c 2f 76 65 72 62 61 74 69 =intl..</verbati
7600: 6d 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a m>..</td></tr>..
7610: 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 76 </table><br>..<v
7620: 65 72 62 61 74 69 6d 3e 0d 0a 2d 2d 20 74 6f 20 erbatim>..-- to
7630: 45 50 53 47 3a 33 30 30 33 20 2d 20 64 65 66 61 EPSG:3003 - defa
7640: 75 6c 74 20 73 65 74 74 69 6e 67 73 2c 20 4e 55 ult settings, NU
7650: 4c 4c 20 61 72 65 61 20 6f 66 20 75 73 65 2c 20 LL area of use,
7660: 2d 20 69 67 6e 6f 72 69 6e 67 20 73 70 61 74 69 - ignoring spati
7670: 61 6c 69 74 65 5f 72 65 66 5f 73 79 73 20 61 6e alite_ref_sys an
7680: 64 20 75 73 69 6e 67 20 74 68 65 20 50 52 4f 4a d using the PROJ
7690: 2e 36 20 6f 77 6e 20 70 72 69 76 61 74 65 20 64 .6 own private d
76a0: 61 74 61 62 61 73 65 0d 0a 53 45 4c 45 43 54 20 atabase..SELECT
76b0: 41 73 45 57 4b 54 20 28 20 53 54 5f 54 72 61 6e AsEWKT ( ST_Tran
76c0: 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 6e 74 sform( MakePoint
76d0: 28 20 39 2e 31 36 39 34 36 34 2c 20 33 39 2e 34 ( 9.169464, 39.4
76e0: 37 38 32 37 35 2c 20 34 33 32 36 20 29 2c 20 33 78275, 4326 ), 3
76f0: 30 30 33 20 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 003 ));..-------
7700: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
7710: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a --------------..
7720: 53 52 49 44 3d 33 30 30 33 3b 50 4f 49 4e 54 28 SRID=3003;POINT(
7730: 31 35 31 34 36 30 30 2e 31 33 34 33 32 31 38 36 1514600.13432186
7740: 32 20 34 33 36 39 38 37 34 2e 34 38 39 32 36 39 2 4369874.489269
7750: 39 35 37 29 0d 0a 0d 0a 2d 2d 20 74 6f 20 45 50 957)....-- to EP
7760: 53 47 3a 33 30 30 33 20 2d 20 73 61 6d 65 20 61 SG:3003 - same a
7770: 73 20 61 62 6f 76 65 2c 20 62 75 74 20 65 78 70 s above, but exp
7780: 6c 69 63 69 74 6c 79 20 64 65 66 69 6e 69 6e 67 licitly defining
7790: 20 61 20 73 70 65 63 69 66 69 63 20 61 72 65 61 a specific area
77a0: 20 6f 66 20 75 73 65 0d 0a 53 45 4c 45 43 54 20 of use..SELECT
77b0: 41 73 45 57 4b 54 20 28 20 53 54 5f 54 72 61 6e AsEWKT ( ST_Tran
77c0: 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 6e 74 sform( MakePoint
77d0: 28 20 39 2e 31 36 39 34 36 34 2c 20 33 39 2e 34 ( 9.169464, 39.4
77e0: 37 38 32 37 35 2c 20 34 33 32 36 20 29 2c 20 33 78275, 4326 ), 3
77f0: 30 30 33 20 2c 20 42 75 69 6c 64 4d 42 52 28 39 003 , BuildMBR(9
7800: 2e 31 20 2c 20 33 39 2e 34 20 2c 20 39 2e 32 20 .1 , 39.4 , 9.2
7810: 2c 20 33 39 2e 35 20 2c 20 34 33 32 36 20 29 29 , 39.5 , 4326 ))
7820: 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d );..------------
7830: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
7840: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d ---------..SRID=
7850: 33 30 30 33 3b 50 4f 49 4e 54 28 31 35 31 34 36 3003;POINT(15146
7860: 30 35 2e 39 38 32 37 36 32 32 34 38 20 34 33 36 05.982762248 436
7870: 39 38 37 33 2e 30 30 34 32 32 36 39 34 33 29 0d 9873.004226943).
7880: 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 54 68 .</verbatim>..Th
7890: 69 72 64 20 61 6e 64 20 6c 61 73 74 20 65 78 61 ird and last exa
78a0: 6d 70 6c 65 2e 20 49 6e 20 73 6f 6d 65 20 63 61 mple. In some ca
78b0: 73 65 73 20 65 78 70 6c 69 63 69 74 6c 79 20 64 ses explicitly d
78c0: 65 66 69 6e 69 6e 67 20 61 20 73 70 65 63 69 66 efining a specif
78d0: 69 63 20 3c 62 3e 3c 69 3e 61 72 65 61 20 6f 66 ic <b><i>area of
78e0: 20 75 73 65 3c 2f 69 3e 3c 2f 62 3e 20 6d 61 79 use</i></b> may
78f0: 20 65 6e 61 62 6c 65 20 50 52 4f 4a 2e 36 20 74 enable PROJ.6 t
7900: 6f 20 73 65 6c 65 63 74 20 61 6e 20 6f 70 74 69 o select an opti
7910: 6d 69 7a 65 64 20 74 72 61 6e 73 66 6f 72 6d 61 mized transforma
7920: 74 69 6f 6e 20 6c 65 61 64 69 6e 67 20 74 6f 20 tion leading to
7930: 6d 6f 72 65 20 70 72 65 63 69 73 65 20 72 65 73 more precise res
7940: 75 6c 74 73 2e 3c 62 72 3e 0d 0a 49 6e 20 74 68 ults.<br>..In th
7950: 69 73 20 65 78 61 6d 70 6c 65 20 77 65 27 76 65 is example we've
7960: 20 75 73 65 64 20 61 20 50 6f 69 6e 74 20 6c 6f used a Point lo
7970: 63 61 74 65 64 20 69 6e 20 53 61 72 64 69 6e 69 cated in Sardini
7980: 61 2c 20 61 6e 64 20 50 52 4f 4a 2e 36 20 73 75 a, and PROJ.6 su
7990: 70 70 6f 72 74 73 20 73 65 76 65 72 61 6c 20 66 pports several f
79a0: 6c 61 76 6f 72 73 20 6f 66 20 3c 62 3e 45 50 53 lavors of <b>EPS
79b0: 47 3a 33 30 30 33 3c 2f 62 3e 20 64 65 70 65 6e G:3003</b> depen
79c0: 64 69 6e 67 20 6f 6e 20 74 68 65 20 73 70 65 63 ding on the spec
79d0: 69 66 69 63 20 61 72 65 61 20 6f 66 20 75 73 65 ific area of use
79e0: 2e 3c 62 72 3e 0d 0a 3c 62 3e 49 74 61 6c 79 20 .<br>..<b>Italy
79f0: 2d 20 53 61 72 64 69 6e 69 61 20 6f 6e 73 68 6f - Sardinia onsho
7a00: 72 65 3c 2f 62 3e 20 69 73 20 6f 6e 65 20 62 65 re</b> is one be
7a10: 74 77 65 65 6e 20 74 68 65 6d 2c 20 73 6f 20 61 tween them, so a
7a20: 66 74 65 72 20 73 70 65 63 69 66 79 69 6e 67 20 fter specifying
7a30: 61 6e 20 65 78 70 6c 69 63 69 74 20 3c 62 3e 61 an explicit <b>a
7a40: 72 65 61 20 6f 66 20 75 73 65 3c 2f 62 3e 20 61 rea of use</b> a
7a50: 20 6d 6f 72 65 20 70 72 65 63 69 73 65 20 74 72 more precise tr
7a60: 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 ansformation pip
7a70: 65 6c 69 6e 65 20 77 61 73 20 73 65 6c 65 63 74 eline was select
7a80: 65 64 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 74 61 ed.<br><br>..<ta
7a90: 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d ble cellspacing=
7aa0: 22 38 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d "8" cellpadding=
7ab0: 22 31 36 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 "16" bgcolor="#f
7ac0: 66 66 66 64 30 22 3e 0d 0a 3c 74 72 3e 3c 74 64 fffd0">..<tr><td
7ad0: 3e 0d 0a 3c 62 3e 3c 75 3e 4c 65 73 73 6f 6e 20 >..<b><u>Lesson
7ae0: 6c 65 61 72 6e 65 64 3c 2f 75 3e 3c 2f 62 3e 3a learned</u></b>:
7af0: 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 54 68 65 20 ..<ul>..<li>The
7b00: 62 65 73 74 20 6d 6f 64 65 20 66 6f 72 20 74 61 best mode for ta
7b10: 6b 69 6e 67 20 66 75 6c 6c 20 70 72 6f 66 69 74 king full profit
7b20: 20 66 72 6f 6d 20 50 52 4f 4a 2e 36 20 69 73 20 from PROJ.6 is
7b30: 62 79 20 75 73 69 6e 67 20 3c 69 3e 6d 65 74 68 by using <i>meth
7b40: 6f 64 3c 2f 69 3e 3d 3c 62 3e 61 75 74 68 5f 6e od</i>=<b>auth_n
7b50: 61 6d 65 3a 61 75 74 68 5f 73 72 69 64 3c 2f 62 ame:auth_srid</b
7b60: 3e 20 28 74 68 61 74 20 69 73 20 74 68 65 20 3c > (that is the <
7b70: 62 3e 3c 69 3e 64 65 66 61 75 6c 74 20 73 65 74 b><i>default set
7b80: 74 69 6e 67 3c 2f 69 3e 3c 2f 62 3e 29 2e 3c 62 ting</i></b>).<b
7b90: 72 3e 0d 0a 54 68 69 73 20 77 61 79 20 79 6f 75 r>..This way you
7ba0: 27 6c 6c 20 62 65 20 61 62 73 6f 6c 75 74 65 6c 'll be absolutel
7bb0: 79 20 73 75 72 65 20 74 68 61 74 20 74 68 65 20 y sure that the
7bc0: 6d 6f 73 74 20 72 65 63 65 6e 74 20 61 6e 64 20 most recent and
7bd0: 66 75 6c 6c 79 20 64 65 74 61 69 6c 65 64 20 64 fully detailed d
7be0: 65 66 69 6e 69 74 69 6f 6e 73 20 77 69 6c 6c 20 efinitions will
7bf0: 62 65 20 61 6c 77 61 79 73 20 72 65 74 72 69 65 be always retrie
7c00: 76 65 64 20 66 72 6f 6d 20 74 68 65 20 50 52 4f ved from the PRO
7c10: 4a 2e 36 20 6f 77 6e 20 64 61 74 61 62 61 73 65 J.6 own database
7c20: 20 63 6f 6d 70 6c 65 74 65 6c 79 20 69 67 6e 6f completely igno
7c30: 72 69 6e 67 20 61 6e 79 20 64 65 66 69 6e 69 74 ring any definit
7c40: 69 6f 6e 20 28 6d 61 79 20 62 65 20 69 6e 63 6f ion (may be inco
7c50: 6d 70 6c 65 74 65 20 6f 72 20 6f 62 73 6f 6c 65 mplete or obsole
7c60: 74 65 29 20 65 76 65 6e 74 75 61 6c 6c 79 20 73 te) eventually s
7c70: 74 6f 72 65 64 20 69 6e 74 6f 20 74 68 65 20 3c tored into the <
7c80: 62 3e 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 b>spatial_ref_sy
7c90: 73 3c 2f 62 3e 20 74 61 62 6c 65 2e 0d 0a 54 68 s</b> table...Th
7ca0: 69 73 20 69 73 20 61 20 70 61 72 74 69 63 75 6c is is a particul
7cb0: 61 72 79 20 75 73 65 66 75 6c 20 6f 70 74 69 6f ary useful optio
7cc0: 6e 20 77 68 65 6e 20 70 72 6f 63 65 73 73 69 6e n when processin
7cd0: 67 20 6f 6c 64 65 72 20 64 61 74 61 62 61 73 65 g older database
7ce0: 73 20 62 65 69 6e 67 20 63 72 65 61 74 65 64 20 s being created
7cf0: 62 79 20 65 61 72 6c 69 65 72 20 76 65 72 73 69 by earlier versi
7d00: 6f 6e 73 20 6f 66 20 53 70 61 74 69 61 4c 69 74 ons of SpatiaLit
7d10: 65 20 6e 6f 74 20 79 65 74 20 73 75 70 70 6f 72 e not yet suppor
7d20: 74 69 6e 67 20 50 52 4f 4a 2e 36 3c 2f 6c 69 3e ting PROJ.6</li>
7d30: 0d 0a 3c 6c 69 3e 53 70 61 74 69 61 4c 69 74 65 ..<li>SpatiaLite
7d40: 20 64 6f 65 73 20 6e 6f 74 20 63 6f 6e 73 74 72 does not constr
7d50: 61 69 6e 74 73 20 79 6f 75 20 69 6e 20 61 6e 79 aints you in any
7d60: 20 77 61 79 20 61 6e 64 20 66 75 6c 6c 79 20 72 way and fully r
7d70: 65 73 70 65 63 74 73 20 75 73 65 72 73 20 66 72 espects users fr
7d80: 65 65 64 6f 6d 20 63 61 72 65 66 75 6c 6c 79 20 eedom carefully
7d90: 61 76 6f 69 64 69 6e 67 20 3c 69 3e 61 75 74 6f avoiding <i>auto
7da0: 2d 6d 61 67 69 63 61 6c 3c 2f 69 3e 20 61 73 73 -magical</i> ass
7db0: 75 6d 70 74 69 6f 6e 73 2e 3c 62 72 3e 0d 0a 49 umptions.<br>..I
7dc0: 66 20 79 6f 75 20 68 61 76 65 20 61 6e 79 20 67 f you have any g
7dd0: 6f 6f 64 20 72 65 61 73 6f 6e 20 73 75 67 67 65 ood reason sugge
7de0: 73 74 69 6e 67 20 74 6f 20 64 6f 20 73 75 63 68 sting to do such
7df0: 20 61 20 74 68 69 6e 67 20 79 6f 75 20 61 72 65 a thing you are
7e00: 20 61 6e 79 77 61 79 20 66 72 65 65 20 74 6f 20 anyway free to
7e10: 75 73 65 20 74 68 65 20 70 72 6f 6a 2d 73 74 72 use the proj-str
7e20: 69 6e 67 73 20 28 3c 69 3e 6d 65 74 68 6f 64 3c ings (<i>method<
7e30: 2f 69 3e 3d 3c 62 3e 70 72 6f 6a 34 74 65 78 74 /i>=<b>proj4text
7e40: 3c 2f 62 3e 29 20 6f 72 20 74 68 65 20 57 4b 54 </b>) or the WKT
7e50: 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 28 3c 69 definitions (<i
7e60: 3e 6d 65 74 68 6f 64 3c 2f 69 3e 3d 3c 62 3e 73 >method</i>=<b>s
7e70: 72 74 65 78 74 3c 2f 62 3e 29 20 73 74 6f 72 65 rtext</b>) store
7e80: 64 20 69 6e 74 6f 20 74 68 65 20 3c 62 3e 73 70 d into the <b>sp
7e90: 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 3c 2f 62 atial_ref_sys</b
7ea0: 3e 20 74 61 62 6c 65 2e 3c 62 72 3e 0d 0a 42 75 > table.<br>..Bu
7eb0: 74 20 74 68 69 73 20 69 73 20 75 6e 64 65 72 20 t this is under
7ec0: 79 6f 75 72 20 66 75 6c 6c 20 72 65 73 70 6f 6e your full respon
7ed0: 73 69 62 69 6c 69 74 79 2c 20 61 6e 64 20 79 6f sibility, and yo
7ee0: 75 20 6d 75 73 74 20 62 65 20 77 65 6c 6c 20 73 u must be well s
7ef0: 75 72 65 20 6f 66 20 77 68 61 74 20 61 72 65 20 ure of what are
7f00: 79 6f 75 20 64 6f 69 6e 67 2e 3c 2f 6c 69 3e 0d you doing.</li>.
7f10: 0a 3c 6c 69 3e 53 70 61 74 69 61 4c 69 74 65 20 .<li>SpatiaLite
7f20: 65 6e 63 6f 75 72 61 67 65 73 20 61 6e 64 20 70 encourages and p
7f30: 72 6f 6d 6f 74 65 73 20 74 68 65 20 6d 6f 73 74 romotes the most
7f40: 20 63 72 65 61 74 69 76 65 20 75 73 65 73 20 6f creative uses o
7f50: 66 20 50 52 4f 4a 2e 36 2c 20 74 68 69 73 20 69 f PROJ.6, this i
7f60: 6e 63 6c 75 64 69 6e 67 20 3c 62 3e 3c 69 3e 74 ncluding <b><i>t
7f70: 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 ransformation pi
7f80: 70 65 6c 69 6e 65 73 3c 2f 69 3e 3c 2f 62 3e 2e pelines</i></b>.
7f90: 3c 62 72 3e 0d 0a 43 6f 72 72 65 63 74 6c 79 20 <br>..Correctly
7fa0: 75 73 69 6e 67 20 3c 69 3e 6d 65 74 68 6f 64 3c using <i>method<
7fb0: 2f 69 3e 3d 3c 62 3e 70 72 6f 6a 5f 73 74 72 69 /i>=<b>proj_stri
7fc0: 6e 67 3c 2f 62 3e 20 66 6f 72 20 63 6f 6d 70 75 ng</b> for compu
7fd0: 74 69 6e 67 20 63 75 73 74 6f 6d 20 74 72 61 6e ting custom tran
7fe0: 73 66 6f 72 6d 61 74 69 6f 6e 73 20 69 73 6e 27 sformations isn'
7ff0: 74 20 6e 65 63 65 73 73 61 72 69 6c 79 20 73 69 t necessarily si
8000: 6d 70 6c 65 20 61 6e 64 20 65 61 73 79 2c 20 62 mple and easy, b
8010: 75 74 20 69 74 27 73 20 61 20 62 69 67 20 6f 70 ut it's a big op
8020: 70 6f 72 74 75 6e 69 74 79 20 66 6f 72 20 61 6c portunity for al
8030: 6c 20 73 6b 69 6c 6c 65 64 20 61 6e 64 20 74 61 l skilled and ta
8040: 6c 65 6e 74 65 64 20 70 6f 77 65 72 20 75 73 65 lented power use
8050: 72 73 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d rs.</li>..</ul>.
8060: 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 .</td></tr>..</t
8070: 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 68 33 3e 4e able><br>..<h3>N
8080: 65 77 20 61 75 78 69 6c 69 61 72 79 20 53 51 4c ew auxiliary SQL
8090: 20 66 75 6e 63 74 69 6f 6e 73 20 73 70 65 63 69 functions speci
80a0: 66 69 63 61 6c 6c 79 20 73 75 70 70 6f 72 74 69 fically supporti
80b0: 6e 67 20 50 52 4f 4a 2e 36 3c 2f 68 33 3e 0d 0a ng PROJ.6</h3>..
80c0: 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 <table cellspaci
80d0: 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 69 ng="8" cellpaddi
80e0: 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 3d 22 ng="8" bgcolor="
80f0: 23 65 38 66 66 65 38 22 20 62 6f 72 64 65 72 3d #e8ffe8" border=
8100: 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 67 "1">..<tr><th bg
8110: 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 3e color="#ffb03e">
8120: 53 51 4c 20 46 75 6e 63 74 69 6f 6e 3c 2f 74 68 SQL Function</th
8130: 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 ><th bgcolor="#f
8140: 66 62 30 33 65 22 3e 53 75 70 70 6f 72 74 65 64 fb03e">Supported
8150: 20 61 72 67 75 6d 65 6e 74 73 3c 2f 74 68 3e 3c arguments</th><
8160: 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 th bgcolor="#ffb
8170: 30 33 65 22 3e 44 65 73 63 72 69 70 74 69 6f 6e 03e">Description
8180: 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e </th></tr>..<tr>
8190: 3c 74 64 3e 3c 62 3e 48 61 73 50 72 6f 6a 36 3c <td><b>HasProj6<
81a0: 2f 62 3e 28 20 3c 69 3e 76 6f 69 64 3c 2f 69 3e /b>( <i>void</i>
81b0: 20 29 20 3a 20 3c 69 3e 42 6f 6f 6c 65 61 6e 3c ) : <i>Boolean<
81c0: 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4e 6f /i></td>..<td>No
81d0: 6e 65 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c ne</td>..<td>Wil
81e0: 6c 20 72 65 74 75 72 6e 20 3c 62 3e 31 3c 2f 62 l return <b>1</b
81f0: 3e 20 28 3c 62 3e 54 52 55 45 3c 2f 62 3e 29 20 > (<b>TRUE</b>)
8200: 69 66 20 74 68 65 20 6c 69 62 72 61 72 79 20 68 if the library h
8210: 61 73 20 62 65 65 6e 20 62 75 69 6c 74 20 6f 6e as been built on
8220: 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 20 28 <b>PROJ.6</b> (
8230: 6f 72 20 61 6e 79 20 6c 61 74 65 72 20 76 65 72 or any later ver
8240: 73 69 6f 6e 29 2c 20 6f 74 68 65 72 77 69 73 65 sion), otherwise
8250: 20 3c 62 3e 30 3c 2f 62 3e 20 28 3c 62 3e 46 41 <b>0</b> (<b>FA
8260: 4c 53 45 3c 2f 62 3e 29 2e 3c 2f 74 64 3e 3c 2f LSE</b>).</td></
8270: 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e tr>..<tr><td><b>
8280: 50 52 4f 4a 5f 47 65 74 4c 61 73 74 45 72 72 6f PROJ_GetLastErro
8290: 72 4d 73 67 3c 2f 62 3e 28 20 3c 69 3e 76 6f 69 rMsg</b>( <i>voi
82a0: 64 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 53 74 72 d</i> ) : <i>Str
82b0: 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 ing</i></td>..<t
82c0: 64 3e 4e 6f 6e 65 3c 2f 74 64 3e 0d 0a 3c 74 64 d>None</td>..<td
82d0: 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 65 >Will return the
82e0: 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 65 72 72 most recent err
82f0: 6f 72 20 6d 65 73 73 61 67 65 20 72 65 74 75 72 or message retur
8300: 6e 65 64 20 62 79 20 50 52 4f 4a 20 28 69 66 20 ned by PROJ (if
8310: 61 6e 79 29 2e 3c 62 72 3e 0d 0a 3c 62 3e 4e 55 any).<br>..<b>NU
8320: 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72 LL</b> will be r
8330: 65 74 75 72 6e 65 64 20 69 66 20 74 68 65 72 65 eturned if there
8340: 20 69 73 20 6e 6f 20 63 75 72 65 6e 74 6c 79 20 is no curently
8350: 70 65 6e 64 69 6e 67 20 50 52 4f 4a 20 65 72 72 pending PROJ err
8360: 6f 72 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c or.</td></tr>..<
8370: 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f 47 tr><td><b>PROJ_G
8380: 65 74 44 61 74 61 62 61 73 65 50 61 74 68 3c 2f etDatabasePath</
8390: 62 3e 28 20 3c 69 3e 76 6f 69 64 3c 2f 69 3e 20 b>( <i>void</i>
83a0: 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 29 : <i>String</i>)
83b0: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4e 6f 6e 65 3c </td>..<td>None<
83c0: 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 72 /td>..<td>Will r
83d0: 65 74 75 72 6e 20 74 68 65 20 63 75 72 72 65 6e eturn the curren
83e0: 74 6c 79 20 73 65 74 20 70 61 74 68 6e 61 6d 65 tly set pathname
83f0: 20 6c 65 61 64 69 6e 67 20 74 6f 20 74 68 65 20 leading to the
8400: 70 72 69 76 61 74 65 20 50 52 4f 4a 27 73 20 53 private PROJ's S
8410: 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 2e 3c QLite database.<
8420: 62 72 3e 0d 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e br>..<b>NULL</b>
8430: 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 will be returne
8440: 64 20 69 66 20 74 68 65 72 65 20 69 73 20 6e 6f d if there is no
8450: 20 70 72 69 76 61 74 65 20 50 52 4f 4a 27 73 20 private PROJ's
8460: 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 20 SQLite database
8470: 63 75 72 72 65 6e 74 6c 79 20 63 6f 6e 6e 65 63 currently connec
8480: 74 65 64 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a ted.</td></tr>..
8490: 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f <tr><td><b>PROJ_
84a0: 53 65 74 44 61 74 61 62 61 73 65 50 61 74 68 3c SetDatabasePath<
84b0: 2f 62 3e 20 28 20 6e 65 77 5f 70 61 74 68 20 3c /b> ( new_path <
84c0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a i>String</i> ) :
84d0: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f <i>String</i></
84e0: 74 64 3e 0d 0a 3c 74 64 3e 0d 0a 3c 75 6c 3e 0d td>..<td>..<ul>.
84f0: 0a 3c 6c 69 3e 3c 62 3e 6e 65 77 5f 70 61 74 68 .<li><b>new_path
8500: 3c 2f 62 3e 3a 20 61 20 72 65 6c 61 74 69 76 65 </b>: a relative
8510: 20 6f 72 20 61 62 73 6f 6c 75 74 65 20 70 61 74 or absolute pat
8520: 68 6e 61 6d 65 20 6c 65 61 64 69 6e 67 20 74 6f hname leading to
8530: 20 61 20 76 61 6c 69 64 20 50 52 4f 4a 27 73 20 a valid PROJ's
8540: 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 2e SQLite database.
8550: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 74 64 </li>..</ul></td
8560: 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 63 68 61 6e >..<td>Will chan
8570: 67 65 20 74 68 65 20 63 75 72 72 65 6e 74 6c 79 ge the currently
8580: 20 73 65 74 20 70 61 74 68 6e 61 6d 65 20 6c 65 set pathname le
8590: 61 64 69 6e 67 20 74 6f 20 74 68 65 20 70 72 69 ading to the pri
85a0: 76 61 74 65 20 50 52 4f 4a 27 73 20 53 51 4c 69 vate PROJ's SQLi
85b0: 74 65 20 64 61 74 61 62 61 73 65 2e 3c 62 72 3e te database.<br>
85c0: 0d 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 ..<b>NULL</b> wi
85d0: 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 69 ll be returned i
85e0: 66 20 74 68 65 20 70 61 73 73 65 64 20 70 61 74 f the passed pat
85f0: 68 20 69 73 20 69 6e 76 61 6c 69 64 2c 20 6f 74 h is invalid, ot
8600: 68 65 72 77 69 73 65 20 74 68 65 20 70 61 74 68 herwise the path
8610: 20 6f 66 20 74 68 65 20 63 75 72 72 65 6e 74 6c of the currentl
8620: 79 20 73 65 74 20 70 72 69 76 61 74 65 20 50 52 y set private PR
8630: 4f 4a 27 73 20 53 51 4c 69 74 65 20 64 61 74 61 OJ's SQLite data
8640: 62 61 73 65 20 77 69 6c 6c 20 62 65 20 72 65 74 base will be ret
8650: 75 72 6e 65 64 2e 3c 2f 74 64 3e 3c 2f 74 72 3e urned.</td></tr>
8660: 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f ..<tr><td><b>PRO
8670: 4a 5f 41 73 57 4b 54 3c 2f 62 3e 20 28 20 61 75 J_AsWKT</b> ( au
8680: 74 68 5f 6e 61 6d 65 20 3c 69 3e 53 74 72 69 6e th_name <i>Strin
8690: 67 3c 2f 69 3e 20 2c 20 61 75 74 68 5f 73 72 69 g</i> , auth_sri
86a0: 64 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e d <i>Integer</i>
86b0: 20 29 20 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f ) : <i>String</
86c0: 69 3e 3c 68 72 3e 0d 0a 3c 62 3e 50 52 4f 4a 5f i><hr>..<b>PROJ_
86d0: 41 73 57 4b 54 3c 2f 62 3e 20 28 20 61 75 74 68 AsWKT</b> ( auth
86e0: 5f 6e 61 6d 65 20 3c 69 3e 53 74 72 69 6e 67 3c _name <i>String<
86f0: 2f 69 3e 20 2c 20 61 75 74 68 5f 73 72 69 64 20 /i> , auth_srid
8700: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c <i>Integer</i> ,
8710: 20 77 6b 74 5f 73 74 79 6c 65 20 3c 69 3e 53 74 wkt_style <i>St
8720: 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e ring</i> ) : <i>
8730: 53 74 72 69 6e 67 3c 2f 69 3e 3c 68 72 3e 0d 0a String</i><hr>..
8740: 3c 62 3e 50 52 4f 4a 5f 41 73 57 4b 54 3c 2f 62 <b>PROJ_AsWKT</b
8750: 3e 20 28 20 61 75 74 68 5f 6e 61 6d 65 20 3c 69 > ( auth_name <i
8760: 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 61 75 >String</i> , au
8770: 74 68 5f 73 72 69 64 20 3c 69 3e 49 6e 74 65 67 th_srid <i>Integ
8780: 65 72 3c 2f 69 3e 20 2c 20 77 6b 74 5f 73 74 79 er</i> , wkt_sty
8790: 6c 65 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e le <i>String</i>
87a0: 20 2c 20 69 6e 64 65 6e 74 65 64 20 3c 69 3e 42 , indented <i>B
87b0: 6f 6f 6c 65 61 6e 3c 2f 69 3e 20 29 20 3a 20 3c oolean</i> ) : <
87c0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 68 72 3e i>String</i><hr>
87d0: 0d 0a 3c 62 3e 50 52 4f 4a 5f 41 73 57 4b 54 3c ..<b>PROJ_AsWKT<
87e0: 2f 62 3e 20 28 20 61 75 74 68 5f 6e 61 6d 65 20 /b> ( auth_name
87f0: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 <i>String</i> ,
8800: 61 75 74 68 5f 73 72 69 64 20 3c 69 3e 49 6e 74 auth_srid <i>Int
8810: 65 67 65 72 3c 2f 69 3e 20 2c 20 77 6b 74 5f 73 eger</i> , wkt_s
8820: 74 79 6c 65 20 3c 69 3e 53 74 72 69 6e 67 3c 2f tyle <i>String</
8830: 69 3e 20 2c 20 69 6e 64 65 6e 74 65 64 20 3c 69 i> , indented <i
8840: 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 20 2c 20 69 >Boolean</i> , i
8850: 6e 64 65 6e 74 61 74 69 6f 6e 20 3c 69 3e 49 6e ndentation <i>In
8860: 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69 teger</i> ) : <i
8870: 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e >String</i></td>
8880: 0d 0a 3c 74 64 3e 3c 75 6c 3e 0d 0a 3c 6c 69 3e ..<td><ul>..<li>
8890: 3c 62 3e 61 75 74 68 5f 6e 61 6d 65 3c 2f 62 3e <b>auth_name</b>
88a0: 20 61 6e 64 20 3c 62 3e 61 75 74 68 5f 73 72 69 and <b>auth_sri
88b0: 64 3c 2f 62 3e 20 69 64 65 6e 74 69 66 79 20 74 d</b> identify t
88c0: 68 65 20 69 6e 74 65 6e 64 65 64 20 43 52 53 2e he intended CRS.
88d0: 3c 62 72 3e 0d 0a 3c 62 3e 61 75 74 68 5f 6e 61 <br>..<b>auth_na
88e0: 6d 65 3c 2f 62 3e 20 63 61 6e 20 62 65 20 3c 62 me</b> can be <b
88f0: 3e 4e 55 4c 4c 3c 2f 62 3e 2c 20 61 6e 64 20 69 >NULL</b>, and i
8900: 6e 20 74 68 69 73 20 63 61 73 65 20 3c 62 3e 45 n this case <b>E
8910: 50 53 47 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 PSG</b> will be
8920: 61 73 73 75 6d 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c assumed.</li>..<
8930: 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 li>the optional
8940: 61 72 67 75 6d 65 6e 74 20 3c 62 3e 73 74 79 6c argument <b>styl
8950: 65 3c 2f 62 3e 20 64 65 74 65 72 6d 69 6e 65 73 e</b> determines
8960: 20 77 68 69 63 68 20 73 70 65 63 69 66 69 63 20 which specific
8970: 57 4b 54 20 66 6f 72 6d 61 74 20 73 68 6f 75 6c WKT format shoul
8980: 64 20 62 65 20 61 64 6f 70 74 65 64 2c 20 61 6e d be adopted, an
8990: 64 20 6d 75 73 74 20 62 65 20 6f 6e 65 20 62 65 d must be one be
89a0: 74 77 65 65 6e 20 3c 62 3e 47 44 41 4c 3c 2f 62 tween <b>GDAL</b
89b0: 3e 2c 20 3c 62 3e 45 53 52 49 3c 2f 62 3e 2c 20 >, <b>ESRI</b>,
89c0: 3c 62 3e 49 53 4f 2d 32 30 31 35 3c 2f 62 3e 20 <b>ISO-2015</b>
89d0: 6f 72 20 3c 62 3e 49 53 4f 2d 32 30 31 38 3c 2f or <b>ISO-2018</
89e0: 62 3e 20 28 74 68 69 73 20 6c 61 74 74 65 72 20 b> (this latter
89f0: 62 65 69 6e 67 20 74 68 65 20 64 65 66 61 75 6c being the defaul
8a00: 74 20 73 65 74 74 69 6e 67 29 2e 3c 2f 6c 69 3e t setting).</li>
8a10: 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e ..<li>the option
8a20: 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e 69 al argument <b>i
8a30: 6e 64 65 6e 74 65 64 3c 2f 62 3e 20 69 66 20 73 ndented</b> if s
8a40: 65 74 20 74 6f 20 3c 62 3e 54 52 55 45 3c 2f 62 et to <b>TRUE</b
8a50: 3e 20 77 69 6c 6c 20 6e 69 63 65 6c 79 20 66 6f > will nicely fo
8a60: 72 6d 61 74 20 61 20 6d 75 6c 74 69 6c 69 6e 65 rmat a multiline
8a70: 20 57 4b 54 20 65 78 70 72 65 73 73 69 6f 6e 2c WKT expression,
8a80: 20 6f 74 68 65 72 77 69 73 65 20 61 20 73 69 6e otherwise a sin
8a90: 67 6c 65 20 6d 6f 6e 6f 6c 69 74 68 69 63 20 6c gle monolithic l
8aa0: 69 6e 65 20 6c 61 63 6b 69 6e 67 20 61 6e 79 20 ine lacking any
8ab0: 77 68 69 74 65 2d 73 70 61 63 65 20 6f 72 20 6e white-space or n
8ac0: 65 77 2d 6c 69 6e 65 20 77 69 6c 6c 20 62 65 20 ew-line will be
8ad0: 70 72 69 6e 74 65 64 20 28 74 68 65 20 64 65 66 printed (the def
8ae0: 61 75 6c 74 20 69 73 20 3c 62 3e 54 52 55 45 3c ault is <b>TRUE<
8af0: 2f 62 3e 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e /b>).</li>..<li>
8b00: 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 the optional arg
8b10: 75 6d 65 6e 74 20 3c 62 3e 69 6e 64 65 6e 74 61 ument <b>indenta
8b20: 74 69 6f 6e 3c 2f 62 3e 20 64 65 74 65 72 6d 69 tion</b> determi
8b30: 6e 65 73 20 68 6f 77 20 6d 61 6e 79 20 77 68 69 nes how many whi
8b40: 74 65 2d 73 70 61 63 65 73 20 61 72 65 20 74 6f te-spaces are to
8b50: 20 62 65 20 75 73 65 64 20 66 6f 72 20 69 6e 64 be used for ind
8b60: 65 6e 74 69 6e 67 20 28 6f 6e 6c 79 20 6d 65 61 enting (only mea
8b70: 6e 69 6e 67 66 75 6c 20 69 66 20 3c 62 3e 3c 69 ningful if <b><i
8b80: 3e 69 6e 64 65 6e 74 65 64 3d 54 52 55 45 3c 2f >indented=TRUE</
8b90: 69 3e 3c 2f 62 3e 3b 20 74 68 65 20 64 65 66 61 i></b>; the defa
8ba0: 75 6c 74 20 76 61 6c 75 65 73 20 69 73 20 3c 62 ult values is <b
8bb0: 3e 34 3c 2f 62 3e 29 2e 3c 2f 6c 69 3e 0d 0a 3c >4</b>).</li>..<
8bc0: 2f 75 6c 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 /ul></td>..<td>W
8bd0: 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 65 20 57 ill return the W
8be0: 4b 54 20 65 78 70 72 65 73 73 69 6f 6e 20 63 6f KT expression co
8bf0: 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 61 rresponding to a
8c00: 20 67 69 76 65 6e 20 43 52 53 3b 20 74 68 65 20 given CRS; the
8c10: 64 65 66 69 6e 69 74 69 6f 6e 73 20 77 69 6c 6c definitions will
8c20: 20 62 65 20 74 61 6b 65 6e 20 64 69 72 65 63 74 be taken direct
8c30: 6c 79 20 66 72 6f 6d 20 74 68 65 20 70 72 69 76 ly from the priv
8c40: 61 74 65 20 50 52 4f 4a 27 73 20 6f 77 6e 20 64 ate PROJ's own d
8c50: 61 74 61 62 61 73 65 2e 3c 62 72 3e 0d 0a 3c 62 atabase.<br>..<b
8c60: 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 62 >NULL</b> will b
8c70: 65 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 66 61 e returned on fa
8c80: 69 6c 75 72 65 20 6f 72 20 6f 6e 20 69 6e 76 61 ilure or on inva
8c90: 6c 69 64 20 61 72 67 75 6d 65 6e 74 73 2e 3c 2f lid arguments.</
8ca0: 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 td></tr>..<tr><t
8cb0: 64 3e 3c 62 3e 50 52 4f 4a 5f 47 75 65 73 73 53 d><b>PROJ_GuessS
8cc0: 72 69 64 46 72 6f 6d 57 4b 54 3c 2f 62 3e 20 28 ridFromWKT</b> (
8cd0: 20 77 6b 74 5f 65 78 70 72 20 3c 69 3e 53 74 72 wkt_expr <i>Str
8ce0: 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49 ing</i> ) : <i>I
8cf0: 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 64 3e 0d nteger</i></td>.
8d00: 0a 3c 74 64 3e 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c .<td><ul>..<li><
8d10: 62 3e 77 6b 74 5f 65 78 70 72 3c 2f 62 3e 3a 20 b>wkt_expr</b>:
8d20: 74 68 65 20 57 4b 54 20 65 78 70 72 65 73 73 69 the WKT expressi
8d30: 6f 6e 20 74 6f 20 62 65 20 65 76 61 6c 75 61 74 on to be evaluat
8d40: 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c ed.</li>..</ul><
8d50: 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a 57 69 6c 6c /td>..<td>..Will
8d60: 20 70 6f 73 73 69 62 6c 79 20 72 65 74 75 72 6e possibly return
8d70: 20 74 68 65 20 3c 62 3e 53 52 49 44 20 76 61 6c the <b>SRID val
8d80: 75 65 3c 2f 62 3e 20 63 6f 72 72 65 73 70 6f 6e ue</b> correspon
8d90: 64 69 6e 67 20 74 6f 20 61 20 67 69 76 65 6e 20 ding to a given
8da0: 57 4b 54 20 65 78 70 72 65 73 73 69 6f 6e 20 64 WKT expression d
8db0: 65 66 69 6e 69 6e 67 20 61 20 43 52 53 2e 3c 62 efining a CRS.<b
8dc0: 72 3e 0d 0a 3c 62 3e 2d 31 3c 2f 62 3e 20 77 69 r>..<b>-1</b> wi
8dd0: 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 69 ll be returned i
8de0: 66 20 6e 6f 20 43 52 53 20 73 75 70 70 6f 72 74 f no CRS support
8df0: 65 64 20 62 79 20 50 52 4f 4a 2e 36 20 6d 61 74 ed by PROJ.6 mat
8e00: 63 68 65 73 20 74 68 65 20 57 4b 54 20 65 78 70 ches the WKT exp
8e10: 72 65 73 73 69 6f 6e 2e 3c 62 72 3e 0d 0a 3c 62 ression.<br>..<b
8e20: 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 62 >NULL</b> will b
8e30: 65 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 69 6e e returned on in
8e40: 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 2e 0d valid argument..
8e50: 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 .</td></tr>..<tr
8e60: 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f 47 75 65 ><td><b>PROJ_Gue
8e70: 73 73 53 72 69 64 46 72 6f 6d 53 48 50 3c 2f 62 ssSridFromSHP</b
8e80: 3e 20 28 20 66 69 6c 65 6e 61 6d 65 20 3c 69 3e > ( filename <i>
8e90: 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c String</i> ) : <
8ea0: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 i>Integer</i></t
8eb0: 64 3e 0d 0a 3c 74 64 3e 3c 75 6c 3e 0d 0a 3c 6c d>..<td><ul>..<l
8ec0: 69 3e 3c 62 3e 66 69 6c 65 6e 61 6d 65 3c 2f 62 i><b>filename</b
8ed0: 3e 3a 20 74 68 65 20 61 62 73 6f 6c 75 74 65 20 >: the absolute
8ee0: 6f 72 20 72 65 6c 61 74 69 76 65 20 70 61 74 68 or relative path
8ef0: 20 6c 65 61 64 69 6e 67 20 74 6f 20 73 6f 6d 65 leading to some
8f00: 20 53 68 61 70 65 66 69 6c 65 2e 3c 62 72 3e 0d Shapefile.<br>.
8f10: 0a 4e 6f 74 65 3a 20 65 78 61 63 74 6c 65 79 20 .Note: exactley
8f20: 61 73 20 72 65 71 75 69 72 65 64 20 62 79 20 3c as required by <
8f30: 62 3e 3c 69 3e 49 6d 70 6f 72 74 53 48 50 3c 2f b><i>ImportSHP</
8f40: 69 3e 3c 2f 62 3e 28 29 20 3c 62 3e 3c 69 3e 66 i></b>() <b><i>f
8f50: 69 6c 65 6e 61 6d 65 3c 2f 69 3e 3c 2f 62 3e 20 ilename</i></b>
8f60: 6d 75 73 74 20 6f 6d 69 74 20 61 6e 79 20 3c 62 must omit any <b
8f70: 3e 2e 73 68 70 3c 2f 62 3e 2c 20 3c 62 3e 2e 73 >.shp</b>, <b>.s
8f80: 68 78 3c 2f 62 3e 2c 20 3c 62 3e 2e 64 62 66 3c hx</b>, <b>.dbf<
8f90: 2f 62 3e 20 6f 72 20 3c 62 3e 2e 70 72 6a 3c 2f /b> or <b>.prj</
8fa0: 62 3e 20 73 75 66 66 69 78 2e 3c 2f 6c 69 3e 0d b> suffix.</li>.
8fb0: 0a 3c 2f 75 6c 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 .</ul></td>..<td
8fc0: 3e 0d 0a 57 69 6c 6c 20 70 6f 73 73 69 62 6c 79 >..Will possibly
8fd0: 20 72 65 74 75 72 6e 20 74 68 65 20 3c 62 3e 53 return the <b>S
8fe0: 52 49 44 20 76 61 6c 75 65 3c 2f 62 3e 20 63 6f RID value</b> co
8ff0: 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 74 rresponding to t
9000: 68 65 20 43 52 53 20 64 65 66 69 6e 65 64 20 62 he CRS defined b
9010: 79 20 74 68 65 20 2e 50 52 4a 20 6d 65 6d 62 65 y the .PRJ membe
9020: 72 20 6f 66 20 74 68 65 20 53 68 61 70 65 66 69 r of the Shapefi
9030: 6c 65 2e 3c 62 72 3e 0d 0a 3c 62 3e 2d 31 3c 2f le.<br>..<b>-1</
9040: 62 3e 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 b> will be retur
9050: 6e 65 64 20 69 66 20 6e 6f 20 43 52 53 20 73 75 ned if no CRS su
9060: 70 70 6f 72 74 65 64 20 62 79 20 50 52 4f 4a 2e pported by PROJ.
9070: 36 20 6d 61 74 63 68 65 73 20 50 52 4a 20 6d 65 6 matches PRJ me
9080: 6d 62 65 72 20 6f 66 20 74 68 65 20 53 68 61 70 mber of the Shap
9090: 65 66 69 6c 65 2e 3c 62 72 3e 0d 0a 3c 62 3e 4e efile.<br>..<b>N
90a0: 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 ULL</b> will be
90b0: 72 65 74 75 72 6e 65 64 20 6f 6e 20 69 6e 76 61 returned on inva
90c0: 6c 69 64 20 61 72 67 75 6d 65 6e 74 2e 3c 68 72 lid argument.<hr
90d0: 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74 >..<u>Please not
90e0: 65 20 77 65 6c 6c 3c 2f 75 3e 3a 20 74 68 69 73 e well</u>: this
90f0: 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 6f 70 SQL function op
9100: 65 6e 64 20 74 68 65 20 64 6f 6f 72 20 74 6f 20 end the door to
9110: 6d 61 6e 79 20 70 6f 74 65 6e 74 69 61 6c 20 73 many potential s
9120: 65 63 75 72 69 74 79 20 69 73 73 75 65 73 2c 20 ecurity issues,
9130: 61 6e 64 20 74 68 75 73 20 69 73 20 61 6c 77 61 and thus is alwa
9140: 79 73 20 3c 69 3e 64 69 73 61 62 6c 65 64 20 62 ys <i>disabled b
9150: 79 20 64 65 66 61 75 6c 74 3c 2f 69 3e 2e 3c 62 y default</i>.<b
9160: 72 3e 0d 0a 45 78 70 6c 69 63 69 74 6c 79 20 73 r>..Explicitly s
9170: 65 74 74 69 6e 67 20 74 68 65 20 65 6e 76 69 72 etting the envir
9180: 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 onment variable
9190: 3c 62 3e 53 50 41 54 49 41 4c 49 54 45 5f 53 45 <b>SPATIALITE_SE
91a0: 43 55 52 49 54 59 3d 72 65 6c 61 78 65 64 3c 2f CURITY=relaxed</
91b0: 62 3e 20 69 73 20 61 62 73 6f 6c 75 74 65 6c 79 b> is absolutely
91c0: 20 72 65 71 75 69 72 65 64 20 69 6e 20 6f 72 64 required in ord
91d0: 65 72 20 74 6f 20 65 6e 61 62 6c 65 20 74 68 69 er to enable thi
91e0: 73 20 66 75 6e 63 74 69 6f 6e 2e 0d 0a 3c 2f 74 s function...</t
91f0: 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 d></tr>..</table
9200: 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 ><br>..<table ce
9210: 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65 llspacing="8" ce
9220: 6c 6c 70 61 64 64 69 6e 67 3d 22 31 36 22 20 62 llpadding="16" b
9230: 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 39 22 gcolor="#ffffe9"
9240: 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 62 3e >..<tr><td>..<b>
9250: 3c 75 3e 4e 6f 74 65 3c 2f 75 3e 3c 2f 62 3e 3a <u>Note</u></b>:
9260: 20 61 6c 6c 20 74 68 65 20 61 62 6f 76 65 20 53 all the above S
9270: 51 4c 20 46 75 6e 63 74 69 6f 6e 73 20 77 69 6c QL Functions wil
9280: 6c 20 62 65 20 61 76 61 69 6c 61 62 6c 65 20 6f l be available o
9290: 6e 6c 79 20 77 68 65 6e 20 53 70 61 74 69 61 6c nly when Spatial
92a0: 69 74 65 2d 35 2e 30 2e 30 20 68 61 73 20 62 65 ite-5.0.0 has be
92b0: 65 6e 20 62 75 69 6c 74 20 61 67 61 69 6e 73 74 en built against
92c0: 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 20 28 <b>PROJ.6</b> (
92d0: 6f 72 20 61 6e 79 20 73 75 62 73 65 71 75 65 6e or any subsequen
92e0: 74 20 76 65 72 73 69 6f 6e 29 2e 3c 62 72 3e 0d t version).<br>.
92f0: 0a 49 66 20 53 70 61 74 69 61 4c 69 74 65 2d 35 .If SpatiaLite-5
9300: 2e 30 2e 30 20 68 61 73 20 62 65 65 6e 20 62 75 .0.0 has been bu
9310: 69 6c 74 20 69 6e 73 74 65 61 64 20 61 67 61 69 ilt instead agai
9320: 6e 73 74 20 61 6e 79 20 70 72 65 76 69 6f 73 75 nst any previosu
9330: 73 20 76 65 72 73 69 6f 6e 20 28 61 73 20 65 2e s version (as e.
9340: 67 2e 20 3c 62 3e 50 52 4f 4a 2e 34 3c 2f 62 3e g. <b>PROJ.4</b>
9350: 29 20 61 6e 79 20 61 74 74 65 6d 70 74 20 74 6f ) any attempt to
9360: 20 63 61 6c 6c 20 6f 6e 65 20 6f 66 20 74 68 65 call one of the
9370: 73 65 20 53 51 4c 20 46 75 6e 63 74 69 6f 6e 73 se SQL Functions
9380: 20 77 69 6c 6c 20 73 69 6d 70 6c 79 20 72 65 74 will simply ret
9390: 75 72 6e 20 61 20 3c 62 3e 3c 69 3e 3c 75 3e 6e urn a <b><i><u>n
93a0: 6f 20 73 75 63 68 20 66 75 6e 63 74 69 6f 6e 3c o such function<
93b0: 2f 75 3e 3c 2f 69 3e 3c 2f 62 3e 20 53 51 4c 20 /u></i></b> SQL
93c0: 65 72 72 6f 72 2e 0d 0a 3c 2f 74 64 3e 3c 2f 74 error...</td></t
93d0: 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e r>..</table><br>
93e0: 0d 0a 3c 62 3e 50 72 61 63 74 69 63 61 6c 20 65 ..<b>Practical e
93f0: 78 61 6d 70 6c 65 73 3a 3c 2f 62 3e 0d 0a 3c 76 xamples:</b>..<v
9400: 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 54 erbatim>..SELECT
9410: 20 50 52 4f 4a 5f 47 65 74 44 61 74 61 62 61 73 PROJ_GetDatabas
9420: 65 50 61 74 68 28 29 3b 20 20 2d 2d 20 72 65 74 ePath(); -- ret
9430: 72 69 65 76 69 6e 67 20 74 68 65 20 63 75 72 72 rieving the curr
9440: 65 6e 74 6c 79 20 73 65 74 20 50 52 4f 4a 27 73 ently set PROJ's
9450: 20 6f 77 6e 20 64 61 74 61 62 61 73 65 0d 0a 2d own database..-
9460: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9470: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 2f -------------../
9480: 75 73 72 2f 6c 6f 63 61 6c 2f 73 68 61 72 65 2f usr/local/share/
9490: 70 72 6f 6a 2f 70 72 6f 6a 2e 64 62 0d 0a 0d 0a proj/proj.db....
94a0: 53 45 4c 45 43 54 20 50 52 4f 4a 5f 53 65 74 44 SELECT PROJ_SetD
94b0: 61 74 61 62 61 73 65 50 61 74 68 28 27 2f 68 6f atabasePath('/ho
94c0: 6d 65 2f 73 61 6e 64 72 6f 2f 6e 6f 74 5f 65 78 me/sandro/not_ex
94d0: 69 73 74 69 6e 67 5f 70 72 6f 6a 2e 64 62 27 29 isting_proj.db')
94e0: 3b 20 2d 2d 20 6e 6f 6e 20 65 78 69 73 74 69 6e ; -- non existin
94f0: 67 20 64 61 74 61 62 61 73 65 0d 0a 2d 2d 2d 2d g database..----
9500: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9510: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 4e 55 4c 4c ----------..NULL
9520: 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f ....SELECT PROJ_
9530: 47 65 74 4c 61 73 74 45 72 72 6f 72 4d 73 67 28 GetLastErrorMsg(
9540: 29 3b 20 2d 2d 20 72 65 74 72 69 65 76 69 6e 67 ); -- retrieving
9550: 20 74 68 65 20 66 61 69 6c 75 72 65 20 63 61 75 the failure cau
9560: 73 65 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d se..------------
9570: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9580: 2d 2d 0d 0a 70 72 6f 6a 5f 63 6f 6e 74 65 78 74 --..proj_context
9590: 5f 73 65 74 5f 64 61 74 61 62 61 73 65 5f 70 61 _set_database_pa
95a0: 74 68 3a 20 4f 70 65 6e 20 6f 66 20 2f 68 6f 6d th: Open of /hom
95b0: 65 2f 73 61 6e 64 72 6f 2f 6e 6f 74 5f 65 78 69 e/sandro/not_exi
95c0: 73 74 69 6e 67 5f 70 72 6f 6a 2e 64 62 20 66 61 sting_proj.db fa
95d0: 69 6c 65 64 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 iled....SELECT P
95e0: 52 4f 4a 5f 53 65 74 44 61 74 61 62 61 73 65 50 ROJ_SetDatabaseP
95f0: 61 74 68 28 27 2f 68 6f 6d 65 2f 73 61 6e 64 72 ath('/home/sandr
9600: 6f 2f 76 61 6c 69 64 5f 70 72 6f 6a 2e 64 62 27 o/valid_proj.db'
9610: 29 3b 20 2d 2d 20 76 61 6c 69 64 20 64 61 74 61 ); -- valid data
9620: 62 61 73 65 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d base..----------
9630: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9640: 2d 2d 2d 2d 0d 0a 2f 68 6f 6d 65 2f 73 61 6e 64 ----../home/sand
9650: 72 6f 2f 76 61 6c 69 64 5f 70 72 6f 6a 2e 64 62 ro/valid_proj.db
9660: 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f ....SELECT PROJ_
9670: 41 73 57 4b 54 28 27 45 50 53 47 27 2c 20 34 33 AsWKT('EPSG', 43
9680: 32 36 29 3b 20 2d 2d 20 64 65 66 61 75 6c 74 20 26); -- default
9690: 73 65 74 74 69 6e 67 73 3a 20 49 53 4f 2d 32 30 settings: ISO-20
96a0: 31 38 20 73 74 79 6c 65 2c 20 69 6e 64 65 6e 74 18 style, indent
96b0: 65 64 20 77 69 74 68 20 69 6e 64 65 6e 74 61 74 ed with indentat
96c0: 69 6f 6e 20 34 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d ion 4..---------
96d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
96e0: 2d 2d 2d 2d 2d 0d 0a 47 45 4f 44 43 52 53 5b 22 -----..GEODCRS["
96f0: 57 47 53 20 38 34 22 2c 0d 0a 20 20 20 20 44 41 WGS 84",.. DA
9700: 54 55 4d 5b 22 57 6f 72 6c 64 20 47 65 6f 64 65 TUM["World Geode
9710: 74 69 63 20 53 79 73 74 65 6d 20 31 39 38 34 22 tic System 1984"
9720: 2c 0d 0a 20 20 20 20 20 20 20 20 45 4c 4c 49 50 ,.. ELLIP
9730: 53 4f 49 44 5b 22 57 47 53 20 38 34 22 2c 36 33 SOID["WGS 84",63
9740: 37 38 31 33 37 2c 32 39 38 2e 32 35 37 32 32 33 78137,298.257223
9750: 35 36 33 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 563,..
9760: 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 LENGTHUNIT["me
9770: 74 72 65 22 2c 31 5d 5d 5d 2c 0d 0a 20 20 20 20 tre",1]]],..
9780: 50 52 49 4d 45 4d 5b 22 47 72 65 65 6e 77 69 63 PRIMEM["Greenwic
9790: 68 22 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 41 h",0,.. A
97a0: 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 65 NGLEUNIT["degree
97b0: 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 39 ",0.017453292519
97c0: 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20 43 53 5b 9433]],.. CS[
97d0: 65 6c 6c 69 70 73 6f 69 64 61 6c 2c 32 5d 2c 0d ellipsoidal,2],.
97e0: 0a 20 20 20 20 20 20 20 20 41 58 49 53 5b 22 67 . AXIS["g
97f0: 65 6f 64 65 74 69 63 20 6c 61 74 69 74 75 64 65 eodetic latitude
9800: 20 28 4c 61 74 29 22 2c 6e 6f 72 74 68 2c 0d 0a (Lat)",north,..
9810: 20 20 20 20 20 20 20 20 20 20 20 20 4f 52 44 45 ORDE
9820: 52 5b 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 R[1],..
9830: 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 ANGLEUNIT["de
9840: 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 gree",0.01745329
9850: 32 35 31 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 25199433]],..
9860: 20 20 20 20 20 41 58 49 53 5b 22 67 65 6f 64 65 AXIS["geode
9870: 74 69 63 20 6c 6f 6e 67 69 74 75 64 65 20 28 4c tic longitude (L
9880: 6f 6e 29 22 2c 65 61 73 74 2c 0d 0a 20 20 20 20 on)",east,..
9890: 20 20 20 20 20 20 20 20 4f 52 44 45 52 5b 32 5d ORDER[2]
98a0: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 41 ,.. A
98b0: 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 65 NGLEUNIT["degree
98c0: 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 39 ",0.017453292519
98d0: 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20 41 52 45 9433]],.. ARE
98e0: 41 5b 22 57 6f 72 6c 64 22 5d 2c 0d 0a 20 20 20 A["World"],..
98f0: 20 42 42 4f 58 5b 2d 39 30 2c 2d 31 38 30 2c 39 BBOX[-90,-180,9
9900: 30 2c 31 38 30 5d 2c 0d 0a 20 20 20 20 49 44 5b 0,180],.. ID[
9910: 22 45 50 53 47 22 2c 34 33 32 36 5d 5d 0d 0a 0d "EPSG",4326]]...
9920: 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f 41 73 57 .SELECT PROJ_AsW
9930: 4b 54 28 27 45 50 53 47 27 2c 20 34 33 32 36 2c KT('EPSG', 4326,
9940: 20 27 45 53 52 49 27 2c 20 30 2c 20 30 29 3b 20 'ESRI', 0, 0);
9950: 2d 2d 20 45 53 52 49 20 73 74 79 6c 65 2c 20 6d -- ESRI style, m
9960: 6f 6e 6f 6c 69 74 68 69 63 20 6c 69 6e 65 0d 0a onolithic line..
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 2d 2d 2d 2d 0d 0a --------------..
9990: 47 45 4f 47 43 53 5b 22 47 43 53 5f 57 47 53 5f GEOGCS["GCS_WGS_
99a0: 31 39 38 34 22 2c 44 41 54 55 4d 5b 22 44 5f 57 1984",DATUM["D_W
99b0: 47 53 5f 31 39 38 34 22 2c 53 50 48 45 52 4f 49 GS_1984",SPHEROI
99c0: 44 5b 22 57 47 53 5f 31 39 38 34 22 2c 36 33 37 D["WGS_1984",637
99d0: 38 31 33 37 2e 30 2c 32 39 38 2e 32 35 37 32 32 8137.0,298.25722
99e0: 33 35 36 33 5d 5d 2c 50 52 49 4d 45 4d 5b 22 47 3563]],PRIMEM["G
99f0: 72 65 65 6e 77 69 63 68 22 2c 30 2e 30 5d 2c 55 reenwich",0.0],U
9a00: 4e 49 54 5b 22 44 65 67 72 65 65 22 2c 30 2e 30 NIT["Degree",0.0
9a10: 31 37 34 35 33 32 39 32 35 31 39 39 34 33 33 5d 174532925199433]
9a20: 5d 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a ]....SELECT PROJ
9a30: 5f 47 75 65 73 73 53 72 69 64 46 72 6f 6d 57 4b _GuessSridFromWK
9a40: 54 28 27 47 45 4f 47 43 53 5b 22 47 43 53 5f 4d T('GEOGCS["GCS_M
9a50: 6f 6e 74 65 5f 4d 61 72 69 6f 5f 52 6f 6d 65 22 onte_Mario_Rome"
9a60: 2c 44 41 54 55 4d 5b 22 44 5f 4d 6f 6e 74 65 5f ,DATUM["D_Monte_
9a70: 4d 61 72 69 6f 22 2c 53 50 48 45 52 4f 49 44 5b Mario",SPHEROID[
9a80: 22 49 6e 74 65 72 6e 61 74 69 6f 6e 61 6c 5f 31 "International_1
9a90: 39 32 34 22 2c 36 33 37 38 33 38 38 2e 30 2c 32 924",6378388.0,2
9aa0: 39 37 2e 30 5d 5d 2c 50 52 49 4d 45 4d 5b 22 52 97.0]],PRIMEM["R
9ab0: 6f 6d 65 22 2c 31 32 2e 34 35 32 33 33 33 33 33 ome",12.45233333
9ac0: 33 33 33 33 33 5d 2c 55 4e 49 54 5b 22 44 65 67 33333],UNIT["Deg
9ad0: 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32 ree",0.017453292
9ae0: 35 31 39 39 34 33 33 5d 5d 27 29 3b 20 0d 0a 2d 5199433]]'); ..-
9af0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9b00: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 34 -------------..4
9b10: 38 30 36 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 806....SELECT PR
9b20: 4f 4a 5f 47 75 65 73 73 53 72 69 64 46 72 6f 6d OJ_GuessSridFrom
9b30: 53 48 50 28 27 2f 68 6f 6d 65 2f 73 61 6e 64 72 SHP('/home/sandr
9b40: 6f 2f 74 75 73 63 61 6e 79 5f 73 68 70 2f 70 72 o/tuscany_shp/pr
9b50: 6f 76 32 30 31 31 27 29 3b 20 2d 2d 20 72 65 6d ov2011'); -- rem
9b60: 65 6d 62 65 72 3a 20 72 65 71 75 69 72 65 73 20 ember: requires
9b70: 74 6f 20 65 78 70 6c 69 63 69 74 6c 79 20 73 65 to explicitly se
9b80: 74 20 53 50 41 54 49 41 4c 49 54 45 5f 53 45 43 t SPATIALITE_SEC
9b90: 55 52 49 54 59 3d 72 65 6c 61 78 65 64 0d 0a 2d URITY=relaxed..-
9ba0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9bb0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 33 -------------..3
9bc0: 30 30 33 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 003..</verbatim>
9bd0: 0d 0a 3c 62 72 3e 0d 0a 3c 68 72 3e 3c 62 72 3e ..<br>..<hr><br>
9be0: 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 ..<table cellspa
9bf0: 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 cing="8" cellpad
9c00: 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 ding="8" bgcolor
9c10: 3d 22 23 66 66 65 30 65 39 22 20 77 69 64 74 68 ="#ffe0e9" width
9c20: 3d 22 31 30 30 25 22 3e 0d 0a 3c 74 72 3e 3c 74 ="100%">..<tr><t
9c30: 68 3e 0d 0a 3c 68 31 3e 49 6d 70 6f 72 74 61 6e h>..<h1>Importan
9c40: 74 20 6e 6f 74 69 63 65 20 66 6f 72 20 57 69 6e t notice for Win
9c50: 64 6f 77 73 20 75 73 65 72 73 3c 2f 68 31 3e 0d dows users</h1>.
9c60: 0a 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 .</th></tr>..<tr
9c70: 3e 3c 74 64 3e 0d 0a 3c 62 3e 50 52 4f 4a 2e 36 ><td>..<b>PROJ.6
9c80: 3c 2f 62 3e 20 63 72 69 74 69 63 61 6c 6c 79 20 </b> critically
9c90: 64 65 70 65 6e 64 73 20 6f 6e 20 69 74 73 20 6f depends on its o
9ca0: 77 6e 20 70 72 69 76 61 74 65 20 53 51 4c 69 74 wn private SQLit
9cb0: 65 20 64 61 74 61 62 61 73 65 20 28 3c 62 3e 70 e database (<b>p
9cc0: 72 6f 6a 2e 64 62 3c 2f 62 3e 29 20 63 6f 6e 74 roj.db</b>) cont
9cd0: 61 69 6e 69 6e 67 20 61 6c 6c 20 72 65 6c 65 76 aining all relev
9ce0: 61 6e 74 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 ant definitions
9cf0: 61 62 6f 75 74 20 45 6c 6c 69 70 73 6f 69 64 73 about Ellipsoids
9d00: 2c 20 50 72 69 6d 65 20 4d 65 72 69 64 69 61 6e , Prime Meridian
9d10: 73 2c 20 43 52 53 65 73 2c 20 54 72 61 6e 73 66 s, CRSes, Transf
9d20: 6f 72 6d 61 74 69 6f 6e 73 20 61 6e 64 20 61 6c ormations and al
9d30: 69 6b 65 2e 3c 62 72 3e 0d 0a 49 66 20 50 52 4f ike.<br>..If PRO
9d40: 4a 2e 36 20 69 73 20 75 6e 61 62 6c 65 20 74 6f J.6 is unable to
9d50: 20 63 6f 72 72 65 63 74 6c 79 20 65 73 74 61 62 correctly estab
9d60: 6c 69 73 68 20 61 20 63 6f 6e 6e 65 63 74 69 6f lish a connectio
9d70: 6e 20 74 6f 20 74 68 69 73 20 64 61 74 61 62 61 n to this databa
9d80: 73 65 20 69 74 20 77 69 6c 6c 20 62 65 20 73 65 se it will be se
9d90: 76 65 72 65 6c 79 20 6c 69 6d 69 74 65 64 20 61 verely limited a
9da0: 6e 64 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 61 nd will not be a
9db0: 62 6c 65 20 74 6f 20 63 6f 72 72 65 63 74 6c 79 ble to correctly
9dc0: 20 62 65 68 61 76 65 20 61 73 20 65 78 70 65 63 behave as expec
9dd0: 74 65 64 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 75 ted.<br><br>..<u
9de0: 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 3c 75 3e 3c 69 l>..<li><b><u><i
9df0: 3e 53 68 6f 72 74 20 63 6f 6e 63 6c 75 73 69 6f >Short conclusio
9e00: 6e 3c 2f 69 3e 3c 2f 75 3e 3c 2f 62 3e 3a 20 69 n</i></u></b>: i
9e10: 6e 73 74 61 6c 6c 69 6e 67 20 74 68 65 20 73 6f nstalling the so
9e20: 66 74 77 61 72 65 20 61 6c 6f 6e 65 20 69 73 20 ftware alone is
9e30: 6e 6f 74 20 65 6e 6f 75 67 68 2e 3c 62 72 3e 0d not enough.<br>.
9e40: 0a 54 68 65 20 50 52 4f 4a 2e 36 20 70 72 69 76 .The PROJ.6 priv
9e50: 61 74 65 20 64 61 74 61 62 61 73 65 20 3c 62 3e ate database <b>
9e60: 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20 6d 75 73 74 proj.db</b> must
9e70: 20 62 65 20 70 72 6f 70 65 72 6c 79 20 69 6e 73 be properly ins
9e80: 74 61 6c 6c 65 64 20 61 73 20 77 65 6c 6c 2c 20 talled as well,
9e90: 69 6e 20 6f 72 64 65 72 20 74 6f 20 65 6e 73 75 in order to ensu
9ea0: 72 65 20 74 68 61 74 20 61 6e 79 74 68 69 6e 67 re that anything
9eb0: 20 72 75 6e 73 20 73 6d 6f 6f 74 68 6c 79 2e 3c runs smoothly.<
9ec0: 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 0d /li>..</ul><br>.
9ed0: 0a 54 68 69 73 20 69 73 6e 27 74 20 75 73 75 61 .This isn't usua
9ee0: 6c 6c 79 20 61 20 62 69 67 20 69 73 73 75 65 20 lly a big issue
9ef0: 6f 6e 20 4c 69 6e 75 78 20 61 6e 64 20 55 6e 69 on Linux and Uni
9f00: 78 2d 6c 69 6b 65 20 70 6c 61 74 66 6f 72 6d 73 x-like platforms
9f10: 2c 20 77 68 65 72 65 20 61 20 72 61 74 69 6f 6e , where a ration
9f20: 61 6c 20 61 6e 64 20 76 65 72 79 20 63 6c 65 61 al and very clea
9f30: 72 20 66 69 6c 65 73 79 73 74 65 6d 20 6c 61 79 r filesystem lay
9f40: 6f 75 74 20 65 78 69 73 74 73 2e 3c 62 72 3e 0d out exists.<br>.
9f50: 0a 4f 6e 20 74 68 65 73 65 20 6f 70 65 72 61 74 .On these operat
9f60: 69 6e 67 20 73 79 73 74 65 6d 73 20 74 68 65 20 ing systems the
9f70: 70 61 63 6b 61 67 65 20 6d 61 6e 61 67 65 72 20 package manager
9f80: 28 6f 72 20 3c 62 3e 6d 61 6b 65 20 69 6e 73 74 (or <b>make inst
9f90: 61 6c 6c 3c 2f 62 3e 29 20 77 69 6c 6c 20 61 75 all</b>) will au
9fa0: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 74 61 6b 65 tomatically take
9fb0: 20 63 61 72 65 20 74 6f 20 69 6e 73 74 61 6c 6c care to install
9fc0: 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20 <b>proj.db</b>
9fd0: 6f 6e 20 74 68 65 20 6d 6f 73 74 20 61 70 70 72 on the most appr
9fe0: 6f 70 72 69 61 74 65 20 64 69 72 65 63 74 6f 72 opriate director
9ff0: 79 20 28 75 73 75 61 6c 6c 79 20 61 73 20 3c 62 y (usually as <b
a000: 3e 2f 75 73 72 2f 73 68 61 72 65 2f 70 72 6f 6a >/usr/share/proj
a010: 2f 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20 6f 72 20 /proj.db</b> or
a020: 61 73 20 3c 62 3e 2f 75 73 72 2f 6c 6f 63 61 6c as <b>/usr/local
a030: 2f 73 68 61 72 65 2f 70 72 6f 6a 2f 70 72 6f 6a /share/proj/proj
a040: 2e 64 62 3c 2f 62 3e 29 20 61 6e 64 20 74 68 61 .db</b>) and tha
a050: 74 27 73 20 61 6c 6c 2e 3c 62 72 3e 3c 62 72 3e t's all.<br><br>
a060: 0d 0a 54 68 69 6e 67 73 20 61 72 65 20 75 6e 68 ..Things are unh
a070: 61 70 70 69 6c 79 20 61 20 6c 69 74 74 6c 65 20 appily a little
a080: 62 69 74 20 6d 6f 72 65 20 64 69 66 66 69 63 75 bit more difficu
a090: 6c 74 73 20 6f 6e 20 57 69 6e 64 6f 77 73 20 70 lts on Windows p
a0a0: 6c 61 74 66 6f 72 6d 73 2e 0d 0a 54 68 65 20 75 latforms...The u
a0b0: 73 65 72 20 69 74 73 65 6c 66 20 69 73 20 72 65 ser itself is re
a0c0: 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 70 72 sponsible for pr
a0d0: 6f 70 65 72 6c 79 20 69 6e 73 74 61 6c 6c 69 6e operly installin
a0e0: 67 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e g <b>proj.db</b>
a0f0: 0d 0a 53 6f 20 69 74 20 62 65 63 6f 6d 65 73 20 ..So it becomes
a100: 63 72 69 74 69 63 61 6c 20 75 6e 64 65 72 73 74 critical underst
a110: 61 6e 64 69 6e 67 20 74 68 65 20 62 61 73 69 63 anding the basic
a120: 20 72 75 6c 65 73 20 61 64 6f 70 74 65 64 20 62 rules adopted b
a130: 79 20 3c 62 3e 6c 69 62 73 70 61 74 69 61 6c 69 y <b>libspatiali
a140: 74 65 3c 2f 62 3e 20 69 6e 20 6f 72 64 65 72 20 te</b> in order
a150: 74 6f 20 70 72 6f 70 65 72 6c 79 20 6c 6f 63 61 to properly loca
a160: 74 65 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 te <b>proj.db</b
a170: 3e 20 6f 6e 20 57 69 6e 64 6f 77 73 2e 0d 0a 3c > on Windows...<
a180: 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c /td></tr>..<tr><
a190: 74 68 3e 0d 0a 3c 68 32 3e 57 68 65 72 65 20 70 th>..<h2>Where p
a1a0: 72 6f 6a 2e 64 62 20 69 73 20 65 78 70 65 63 74 roj.db is expect
a1b0: 65 64 20 74 6f 20 62 65 20 66 6f 75 6e 64 20 6f ed to be found o
a1c0: 6e 20 57 69 6e 64 6f 77 73 3c 2f 68 32 3e 0d 0a n Windows</h2>..
a1d0: 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e </td></tr>..<tr>
a1e0: 3c 74 64 3e 0d 0a 3c 6f 6c 3e 0d 0a 3c 6c 69 3e <td>..<ol>..<li>
a1f0: 74 68 65 20 66 69 72 73 74 20 70 6c 61 63 65 20 the first place
a200: 77 68 65 72 65 20 3c 62 3e 70 72 6f 6a 2e 64 62 where <b>proj.db
a210: 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 73 65 61 </b> will be sea
a220: 72 63 68 65 64 20 69 73 20 74 68 65 20 73 61 6d rched is the sam
a230: 65 20 66 6f 6c 64 65 72 20 66 6f 72 6d 20 77 68 e folder form wh
a240: 65 72 65 20 74 68 65 20 3c 62 3e 45 58 45 3c 2f ere the <b>EXE</
a250: 62 3e 20 62 69 6e 61 72 79 20 77 61 73 20 69 6e b> binary was in
a260: 69 74 69 61 6c 6c 79 20 6c 6f 61 64 65 64 2e 3c itially loaded.<
a270: 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 45 78 61 6d 70 br>..<i><u>Examp
a280: 6c 65 3c 2f 69 3e 3c 2f 75 3e 3a 20 61 73 73 75 le</i></u>: assu
a290: 6d 69 6e 67 20 74 68 61 74 20 79 6f 75 20 61 72 ming that you ar
a2a0: 65 20 63 75 72 72 65 6e 74 6c 79 20 65 78 65 63 e currently exec
a2b0: 75 74 69 6e 67 20 3c 62 3e 43 3a 5c 6d 79 70 72 uting <b>C:\mypr
a2c0: 6f 67 73 5c 73 70 61 74 69 61 6c 69 74 65 5c 62 ogs\spatialite\b
a2d0: 69 6e 5c 73 70 61 74 69 61 6c 69 74 65 2e 65 78 in\spatialite.ex
a2e0: 65 3c 2f 62 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 e</b>..<ul>..<li
a2f0: 3e 74 68 65 6e 20 61 6e 20 61 74 74 65 6d 70 74 >then an attempt
a300: 20 77 69 6c 6c 20 62 65 20 6d 61 64 65 20 74 6f will be made to
a310: 20 63 6f 6e 6e 65 63 74 20 3c 62 3e 43 3a 5c 6d connect <b>C:\m
a320: 79 70 72 6f 67 73 5c 73 70 61 74 69 61 6c 69 74 yprogs\spatialit
a330: 65 5c 62 69 6e 5c 70 72 6f 6a 2e 64 62 3c 2f 62 e\bin\proj.db</b
a340: 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c ></li>..</ul></l
a350: 69 3e 0d 0a 3c 6c 69 3e 61 20 73 65 63 6f 6e 64 i>..<li>a second
a360: 20 61 74 74 65 6d 70 74 20 77 69 6c 6c 20 62 65 attempt will be
a370: 20 6d 61 64 65 20 6f 6e 20 62 65 68 61 6c 66 20 made on behalf
a380: 6f 66 20 74 68 65 20 3c 62 3e 50 75 62 6c 69 63 of the <b>Public
a390: 3c 2f 62 3e 20 66 6f 6c 64 65 72 2e 3c 62 72 3e </b> folder.<br>
a3a0: 0d 0a 3c 69 3e 3c 75 3e 45 78 61 6d 70 6c 65 3c ..<i><u>Example<
a3b0: 2f 75 3e 3c 2f 69 3e 3a 20 61 6e 20 61 74 74 65 /u></i>: an atte
a3c0: 6d 70 74 20 77 69 6c 6c 20 62 65 20 6d 61 64 65 mpt will be made
a3d0: 20 74 6f 20 63 6f 6e 6e 65 63 74 20 3c 62 3e 43 to connect <b>C
a3e0: 3a 5c 55 73 65 72 73 5c 50 75 62 6c 69 63 5c 73 :\Users\Public\s
a3f0: 70 61 74 69 61 6c 69 74 65 5c 70 72 6f 6a 5c 70 patialite\proj\p
a400: 72 6f 6a 2e 64 62 3c 2f 62 3e 3c 2f 6c 69 3e 0d roj.db</b></li>.
a410: 0a 3c 6c 69 3e 61 20 74 68 69 72 64 20 28 61 6e .<li>a third (an
a420: 64 20 6c 61 73 74 29 20 61 74 74 65 6d 70 74 20 d last) attempt
a430: 77 69 6c 6c 20 62 65 20 6d 61 64 65 20 6f 6e 20 will be made on
a440: 62 65 68 61 6c 66 20 6f 66 20 74 68 65 20 3c 62 behalf of the <b
a450: 3e 55 73 65 72 3c 2f 62 3e 20 66 6f 6c 64 65 72 >User</b> folder
a460: 2e 3c 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 45 78 61 .<br>..<i><u>Exa
a470: 6d 70 6c 65 3c 2f 69 3e 3c 2f 75 3e 3a 20 61 6e mple</i></u>: an
a480: 20 61 74 74 65 6d 70 74 20 77 69 6c 6c 20 62 65 attempt will be
a490: 20 6d 61 64 65 20 74 6f 20 63 6f 6e 6e 65 63 74 made to connect
a4a0: 20 3c 62 3e 43 3a 5c 55 73 65 72 73 5c 73 61 6e <b>C:\Users\san
a4b0: 64 72 6f 5c 73 70 61 74 69 61 6c 69 74 65 5c 70 dro\spatialite\p
a4c0: 72 6f 6a 5c 70 72 6f 6a 2e 64 62 3c 2f 62 3e 3c roj\proj.db</b><
a4d0: 2f 6c 69 3e 0d 0a 3c 2f 6f 6c 3e 0d 0a 3c 68 33 /li>..</ol>..<h3
a4e0: 3e 41 6e 20 75 73 65 66 75 6c 20 64 69 61 67 6e >An useful diagn
a4f0: 6f 73 74 69 63 20 63 68 65 63 6b 3c 2f 68 33 3e ostic check</h3>
a500: 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 ..<verbatim>..SE
a510: 4c 45 43 54 20 50 52 4f 4a 5f 47 65 74 44 61 74 LECT PROJ_GetDat
a520: 61 62 61 73 65 50 61 74 68 28 29 3b 0d 0a 3c 2f abasePath();..</
a530: 76 65 72 62 61 74 69 6d 3e 0d 0a 3c 75 6c 3e 0d verbatim>..<ul>.
a540: 0a 3c 6c 69 3e 69 66 20 3c 62 3e 4e 55 4c 4c 3c .<li>if <b>NULL<
a550: 2f 62 3e 20 69 73 20 72 65 74 75 72 6e 65 64 2c /b> is returned,
a560: 20 74 68 65 6e 20 50 52 4f 4a 2e 36 20 69 73 20 then PROJ.6 is
a570: 64 65 66 69 6e 69 74 65 6c 79 20 75 6e 61 62 6c definitely unabl
a580: 65 20 74 6f 20 63 6f 6e 6e 65 63 74 20 74 6f 20 e to connect to
a590: 69 74 73 20 6f 77 6e 20 70 72 69 76 61 74 65 20 its own private
a5a0: 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 20 SQLite database
a5b0: 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e 3c 62 <b>proj.db</b><b
a5c0: 72 3e 0d 0a 59 6f 75 20 68 61 76 65 20 74 6f 20 r>..You have to
a5d0: 63 61 72 65 66 75 6c 6c 79 20 76 65 72 69 66 69 carefully verifi
a5e0: 79 20 74 68 61 74 20 69 74 27 73 20 72 65 61 6c y that it's real
a5f0: 6c 79 20 69 6e 73 74 61 6c 6c 65 64 20 6f 6e 20 ly installed on
a600: 6f 6e 65 20 6f 66 20 74 68 65 20 65 78 70 65 63 one of the expec
a610: 74 65 64 20 73 74 61 6e 64 61 72 64 20 6c 6f 63 ted standard loc
a620: 61 74 69 6f 6e 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c ations.</li>..<l
a630: 69 3e 6f 74 68 65 72 77 69 73 65 20 74 68 65 20 i>otherwise the
a640: 70 61 74 68 20 6c 65 61 64 69 6e 67 20 74 6f 20 path leading to
a650: 74 68 65 20 63 75 72 72 65 6e 74 6c 79 20 63 6f the currently co
a660: 6e 6e 65 63 74 65 64 20 3c 62 3e 70 72 6f 6a 2e nnected <b>proj.
a670: 64 62 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72 db</b> will be r
a680: 65 74 75 72 6e 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c eturned.</li>..<
a690: 2f 75 6c 3e 3c 62 72 3e 0d 0a 3c 2f 74 64 3e 3c /ul><br>..</td><
a6a0: 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 /tr>..</table><b
a6b0: 72 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 r><br>..<table c
a6c0: 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 ellspacing="8" c
a6d0: 65 6c 6c 70 61 64 64 69 6e 67 3d 22 38 22 20 62 ellpadding="8" b
a6e0: 67 63 6f 6c 6f 72 3d 22 23 63 39 66 66 66 30 22 gcolor="#c9fff0"
a6f0: 20 77 69 64 74 68 3d 22 31 30 30 25 22 3e 0d 0a width="100%">..
a700: 3c 74 72 3e 3c 74 68 3e 0d 0a 3c 68 32 3e 55 73 <tr><th>..<h2>Us
a710: 69 6e 67 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d ing the environm
a720: 65 6e 74 20 76 61 72 69 61 62 6c 65 20 53 50 41 ent variable SPA
a730: 54 49 41 4c 49 54 45 5f 50 52 4f 4a 5f 44 42 5f TIALITE_PROJ_DB_
a740: 50 41 54 48 3c 2f 68 32 3e 0d 0a 3c 2f 74 68 3e PATH</h2>..</th>
a750: 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d </tr>..<tr><td>.
a760: 0a 49 66 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d .If the environm
a770: 65 6e 74 20 76 61 72 69 61 62 6c 65 20 3c 62 3e ent variable <b>
a780: 53 50 41 54 49 41 4c 49 54 45 5f 50 52 4f 4a 5f SPATIALITE_PROJ_
a790: 44 42 5f 50 41 54 48 3c 2f 62 3e 20 69 73 20 73 DB_PATH</b> is s
a7a0: 65 74 2c 20 74 68 65 6e 20 3c 62 3e 6c 69 62 73 et, then <b>libs
a7b0: 70 61 74 69 61 6c 69 74 65 3c 2f 62 3e 20 77 69 patialite</b> wi
a7c0: 6c 6c 20 73 69 6d 70 6c 79 20 61 74 74 65 6d 70 ll simply attemp
a7d0: 74 20 74 6f 20 63 6f 6e 6e 65 63 74 20 74 68 65 t to connect the
a7e0: 20 64 61 74 61 62 61 73 65 20 70 6f 69 6e 74 65 database pointe
a7f0: 64 20 62 79 20 74 68 69 73 20 76 61 72 69 61 62 d by this variab
a800: 6c 65 2e 3c 62 72 3e 0d 0a 53 75 63 68 20 61 20 le.<br>..Such a
a810: 63 61 70 61 62 69 6c 69 74 79 20 69 73 20 73 75 capability is su
a820: 70 70 6f 72 74 65 64 20 6e 6f 74 20 6f 6e 6c 79 pported not only
a830: 20 6f 6e 20 57 69 6e 64 6f 77 73 20 62 75 74 20 on Windows but
a840: 61 6c 73 6f 20 6f 6e 20 4c 69 6e 75 78 20 28 61 also on Linux (a
a850: 6e 64 20 6f 6e 20 61 6e 79 20 6f 74 68 65 72 20 nd on any other
a860: 70 6c 61 74 66 6f 72 6d 29 2e 3c 62 72 3e 3c 62 platform).<br><b
a870: 72 3e 0d 0a 3c 69 3e 3c 75 3e 4c 69 6e 75 78 20 r>..<i><u>Linux
a880: 65 78 61 6d 70 6c 65 3c 2f 75 3e 3c 2f 69 3e 3a example</u></i>:
a890: 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 65 ..<ul>..<li><b>e
a8a0: 78 70 6f 72 74 20 22 53 50 41 54 49 41 4c 49 54 xport "SPATIALIT
a8b0: 45 5f 50 52 4f 4a 5f 44 42 5f 50 41 54 48 3d 2f E_PROJ_DB_PATH=/
a8c0: 68 6f 6d 65 2f 73 61 6e 64 72 6f 2f 61 75 78 2f home/sandro/aux/
a8d0: 70 72 6f 6a 2e 64 62 22 3c 62 72 3e 0d 0a 65 63 proj.db"<br>..ec
a8e0: 68 6f 20 24 53 50 41 54 49 41 4c 49 54 45 5f 50 ho $SPATIALITE_P
a8f0: 52 4f 4a 5f 44 42 5f 50 41 54 48 3c 62 72 3e 0d ROJ_DB_PATH<br>.
a900: 0a 73 70 61 74 69 61 6c 69 74 65 3c 62 3e 3c 2f .spatialite<b></
a910: 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 3c 62 li>..</ul><br><b
a920: 72 3e 0d 0a 3c 69 3e 3c 75 3e 57 69 6e 64 6f 77 r>..<i><u>Window
a930: 73 20 65 78 61 6d 70 6c 65 3c 2f 75 3e 3c 2f 69 s example</u></i
a940: 3e 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 >:..<ul>..<li><b
a950: 3e 53 45 54 20 53 50 41 54 49 41 4c 49 54 45 5f >SET SPATIALITE_
a960: 50 52 4f 4a 5f 44 42 5f 50 41 54 48 3d 43 3a 5c PROJ_DB_PATH=C:\
a970: 55 73 65 72 73 5c 73 61 6e 64 72 6f 5c 61 75 78 Users\sandro\aux
a980: 5c 70 72 6f 6a 2e 64 62 3c 62 72 3e 0d 0a 65 63 \proj.db<br>..ec
a990: 68 6f 20 25 53 50 41 54 49 41 4c 49 54 45 5f 50 ho %SPATIALITE_P
a9a0: 52 4f 4a 5f 44 42 5f 50 41 54 48 25 3c 62 72 3e ROJ_DB_PATH%<br>
a9b0: 0d 0a 73 70 61 74 69 61 6c 69 74 65 5f 67 75 69 ..spatialite_gui
a9c0: 3c 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c <b></li>..</ul><
a9d0: 62 72 3e 3c 62 72 3e 0d 0a 3c 2f 74 68 3e 3c 2f br><br>..</th></
a9e0: 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 tr>..</table><br
a9f0: 3e 0d 0a 3c 68 72 3e 3c 62 72 3e 0d 0a 3c 61 20 >..<hr><br>..<a
aa00: 68 72 65 66 3d 22 68 74 74 70 73 3a 2f 2f 77 77 href="https://ww
aa10: 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 2f 66 6f w.gaia-gis.it/fo
aa20: 73 73 69 6c 2f 6c 69 62 73 70 61 74 69 61 6c 69 ssil/libspatiali
aa30: 74 65 2f 77 69 6b 69 3f 6e 61 6d 65 3d 34 2e 33 te/wiki?name=4.3
aa40: 2e 30 2d 64 6f 63 22 3e 62 61 63 6b 3c 2f 61 3e .0-doc">back</a>
aa50: 0a 5a 20 61 30 64 38 63 36 37 65 37 37 30 35 34 .Z a0d8c67e77054
aa60: 61 62 34 64 63 66 35 38 63 34 61 30 32 63 35 65 ab4dcf58c4a02c5e
aa70: 32 63 34 0a 2c4.