Hex Artifact Content
Not logged in

Artifact dcf0138c50d4e5470849fcc1cff032c5d68b3c5e:

Wiki page [PROJ.6] by sandro 2019-05-12 17:43:33.
0000: 44 20 32 30 31 39 2d 30 35 2d 31 32 54 31 37 3a  D 2019-05-12T17:
0010: 34 33 3a 33 33 2e 38 39 38 0a 4c 20 50 52 4f 4a  43:33.898.L PROJ
0020: 2e 36 0a 50 20 37 38 31 34 64 30 65 35 62 32 66  .6.P 7814d0e5b2f
0030: 65 61 62 66 66 65 32 63 62 35 63 66 66 30 37 37  eabffe2cb5cff077
0040: 32 39 64 33 39 63 38 37 65 66 33 36 61 0a 55 20  29d39c87ef36a.U 
0050: 73 61 6e 64 72 6f 0a 57 20 33 39 38 34 34 0a 3c  sandro.W 39844.<
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 54 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e  3>Transformation
2ec0: 73 20 66 72 6f 6d 20 43 52 53 20 74 6f 20 43 52  s from CRS to CR
2ed0: 53 3c 2f 68 33 3e 0d 0a 44 69 66 66 65 72 65 6e  S</h3>..Differen
2ee0: 74 6c 79 20 66 72 6f 6d 20 61 6c 6c 20 70 72 65  tly from all pre
2ef0: 76 69 6f 75 73 20 76 65 72 73 69 6f 6e 73 2c 20  vious versions, 
2f00: 50 52 4f 4a 2e 36 20 63 61 6e 20 6e 6f 77 20 61  PROJ.6 can now a
2f10: 70 70 6c 79 20 61 6e 79 20 74 72 61 6e 73 66 6f  pply any transfo
2f20: 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 61 20 43  rmation from a C
2f30: 52 53 20 74 6f 20 61 6e 6f 74 68 65 72 20 77 69  RS to another wi
2f40: 74 68 6f 75 74 20 72 65 71 75 69 72 69 6e 67 20  thout requiring 
2f50: 74 6f 20 73 70 65 63 69 66 79 20 61 6e 79 20 3c  to specify any <
2f60: 62 3e 3c 69 3e 70 72 6f 6a 2d 73 74 72 69 6e 67  b><i>proj-string
2f70: 3c 2f 69 3e 3c 2f 62 3e 20 6f 72 20 3c 62 3e 3c  </i></b> or <b><
2f80: 69 3e 57 4b 54 20 65 78 70 72 65 73 73 69 6f 6e  i>WKT expression
2f90: 3c 2f 69 3e 3c 2f 62 3e 20 71 75 61 6c 69 66 79  </i></b> qualify
2fa0: 69 6e 67 20 65 61 63 68 20 43 52 53 2e 3c 62 72  ing each CRS.<br
2fb0: 3e 0d 0a 54 68 69 73 20 69 73 20 62 65 63 61 75  >..This is becau
2fc0: 73 65 20 50 52 4f 4a 2e 36 20 69 73 20 6e 6f 77  se PROJ.6 is now
2fd0: 20 63 61 70 61 62 6c 65 20 74 6f 20 72 65 74 72   capable to retr
2fe0: 69 65 76 65 20 61 6e 79 20 43 52 53 20 64 65 66  ieve any CRS def
2ff0: 69 6e 69 74 69 6f 6e 20 64 69 72 65 63 74 6c 79  inition directly
3000: 0d 0a 66 72 6f 6d 20 69 74 73 20 6f 77 6e 20 70  ..from its own p
3010: 72 69 76 61 74 65 20 53 51 4c 69 74 65 20 64 61  rivate SQLite da
3020: 74 61 62 61 73 65 2c 20 61 6e 64 20 63 6f 6e 73  tabase, and cons
3030: 65 71 75 65 6e 74 6c 79 20 65 61 63 68 20 43 52  equently each CR
3040: 53 20 63 61 6e 20 62 65 20 66 75 6c 6c 79 20 69  S can be fully i
3050: 64 65 6e 74 69 66 69 65 64 20 62 79 20 73 69 6d  dentified by sim
3060: 70 6c 79 20 73 70 65 63 69 66 79 69 6e 67 20 69  ply specifying i
3070: 74 73 20 73 79 6d 62 6f 6c 69 63 20 6e 61 6d 65  ts symbolic name
3080: 2c 20 61 73 20 69 6e 3a 0d 0a 3c 75 6c 3e 0d 0a  , as in:..<ul>..
3090: 3c 6c 69 3e 3c 62 3e 45 50 53 47 3a 34 33 32 36  <li><b>EPSG:4326
30a0: 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 6f  </b></li>..<li>o
30b0: 72 20 61 6c 74 65 72 6e 61 74 69 76 65 6c 79 3c  r alternatively<
30c0: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 75 72 6e  /li>..<li><b>urn
30d0: 3a 6f 67 63 3a 64 65 66 3a 63 72 73 3a 45 50 53  :ogc:def:crs:EPS
30e0: 47 3a 3a 34 33 32 36 3c 2f 62 3e 3c 2f 6c 69 3e  G::4326</b></li>
30f0: 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 74 61 62 6c 65 20  ..</ul>..<table 
3100: 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20  cellspacing="8" 
3110: 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 31 36 22  cellpadding="16"
3120: 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65   bgcolor="#ffffe
3130: 39 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c  9">..<tr><td>..<
3140: 68 33 3e 43 6f 6e 63 65 70 74 73 20 74 6f 20 6b  h3>Concepts to k
3150: 65 65 70 20 77 65 6c 6c 20 69 6e 20 6d 69 6e 64  eep well in mind
3160: 3c 2f 68 33 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69  </h3>..<ul>..<li
3170: 3e 66 6f 72 67 65 74 20 74 68 65 20 6f 6c 64 20  >forget the old 
3180: 70 72 6f 6a 2d 73 74 72 69 6e 67 73 3b 20 74 68  proj-strings; th
3190: 65 79 20 61 72 65 20 6e 6f 20 6c 6f 6e 67 65 72  ey are no longer
31a0: 20 74 68 65 20 62 65 73 74 20 77 61 79 20 66 6f   the best way fo
31b0: 72 20 74 61 6b 69 6e 67 20 66 75 6c 6c 20 70 72  r taking full pr
31c0: 6f 66 69 74 20 66 72 6f 6d 20 50 52 4f 4a 2e 36  ofit from PROJ.6
31d0: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 62  </li>..<li>the b
31e0: 65 73 74 20 77 61 79 20 74 6f 20 6d 61 6b 65 20  est way to make 
31f0: 74 68 65 20 6d 6f 73 74 20 6f 66 20 50 52 4f 4a  the most of PROJ
3200: 2e 36 20 63 61 70 61 62 69 6c 69 74 69 65 73 20  .6 capabilities 
3210: 69 73 20 62 79 20 6c 65 61 76 69 6e 67 20 74 68  is by leaving th
3220: 65 20 6c 69 62 72 61 72 79 20 66 75 6c 6c 79 20  e library fully 
3230: 66 72 65 65 20 74 6f 20 63 68 6f 6f 73 65 20 74  free to choose t
3240: 68 65 20 62 65 73 74 20 70 6f 73 73 69 62 6c 65  he best possible
3250: 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20   transformation 
3260: 66 72 6f 6d 20 74 68 65 20 6f 72 69 67 69 6e 20  from the origin 
3270: 61 6e 64 20 74 68 65 20 64 65 73 74 69 6e 61 74  and the destinat
3280: 69 6f 6e 20 43 52 53 65 73 2e 3c 62 72 3e 0d 0a  ion CRSes.<br>..
3290: 62 75 74 20 74 68 69 73 20 73 74 72 69 63 74 6c  but this strictl
32a0: 79 20 72 65 71 75 69 72 65 73 20 74 68 61 74 20  y requires that 
32b0: 74 68 65 20 6c 69 62 72 61 72 79 20 77 69 6c 6c  the library will
32c0: 20 62 65 20 62 61 63 6b 65 64 20 75 70 20 62 79   be backed up by
32d0: 20 69 74 73 20 6f 77 6e 20 70 72 69 76 61 74 65   its own private
32e0: 20 64 61 74 61 62 61 73 65 2e 3c 2f 6c 69 3e 0d   database.</li>.
32f0: 0a 3c 2f 75 6c 3e 0d 0a 3c 68 33 3e 41 64 64 69  .</ul>..<h3>Addi
3300: 74 69 6f 6e 61 6c 20 63 6f 6e 63 65 70 74 3c 2f  tional concept</
3310: 68 33 3e 0d 0a 54 68 65 20 74 72 61 64 69 74 69  h3>..The traditi
3320: 6f 6e 61 6c 20 3c 62 3e 73 70 61 74 69 61 6c 5f  onal <b>spatial_
3330: 72 65 66 5f 73 79 73 3c 2f 62 3e 20 74 61 62 6c  ref_sys</b> tabl
3340: 65 20 63 6f 6e 74 61 69 6e 65 64 20 77 69 74 68  e contained with
3350: 69 6e 20 61 6e 79 20 53 70 61 74 69 61 4c 69 74  in any SpatiaLit
3360: 65 20 44 42 20 6e 6f 74 69 63 65 61 62 6c 79 20  e DB noticeably 
3370: 63 68 61 6e 67 65 73 20 69 74 73 20 69 6e 74 65  changes its inte
3380: 6e 64 65 64 20 73 63 6f 70 65 20 69 6e 20 50 52  nded scope in PR
3390: 4f 4a 2e 36 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69  OJ.6:..<ul>..<li
33a0: 3e 3c 62 3e 73 72 69 64 3c 2f 62 3e 2c 20 3c 62  ><b>srid</b>, <b
33b0: 3e 61 75 74 68 5f 6e 61 6d 65 3c 2f 62 3e 2c 20  >auth_name</b>, 
33c0: 3c 62 3e 61 75 74 68 5f 73 72 69 64 3c 2f 62 3e  <b>auth_srid</b>
33d0: 20 61 6e 64 20 3c 62 3e 72 65 66 5f 73 79 73 5f   and <b>ref_sys_
33e0: 6e 61 6d 65 3c 2f 62 3e 20 63 6f 6c 75 6d 6e 73  name</b> columns
33f0: 20 61 72 65 20 73 74 69 6c 6c 20 72 65 71 75 69   are still requi
3400: 72 65 64 20 69 6e 20 6f 72 64 65 72 20 74 6f 20  red in order to 
3410: 64 65 66 69 6e 65 20 61 6c 6c 20 73 75 70 70 6f  define all suppo
3420: 72 74 65 64 20 43 52 53 65 73 20 61 6e 64 20 74  rted CRSes and t
3430: 6f 20 73 75 70 70 6f 72 74 20 0d 0a 72 65 6c 61  o support ..rela
3440: 74 69 6f 6e 73 20 62 61 73 65 64 20 6f 6e 20 50  tions based on P
3450: 72 69 6d 61 72 79 20 61 6e 64 20 46 6f 72 65 69  rimary and Forei
3460: 67 6e 20 4b 65 79 73 2e 3c 2f 6c 69 3e 0d 0a 3c  gn Keys.</li>..<
3470: 6c 69 3e 62 75 74 20 63 6f 6c 75 6d 6e 73 20 3c  li>but columns <
3480: 62 3e 70 72 6f 6a 34 74 65 78 74 3c 2f 62 3e 20  b>proj4text</b> 
3490: 61 6e 64 20 3c 62 3e 73 72 74 65 78 74 3c 2f 62  and <b>srtext</b
34a0: 3e 20 61 72 65 20 6e 6f 77 20 70 72 61 63 74 69  > are now practi
34b0: 63 61 6c 6c 79 20 75 73 65 6c 65 73 73 2c 20 62  cally useless, b
34c0: 65 63 61 75 73 65 20 50 52 4f 4a 2e 36 20 69 73  ecause PROJ.6 is
34d0: 20 6e 6f 77 20 63 61 70 61 62 6c 65 20 74 6f 20   now capable to 
34e0: 66 75 6c 6c 79 20 64 65 66 69 6e 65 20 61 6e 79  fully define any
34f0: 20 43 52 53 20 62 79 20 64 69 72 65 63 74 6c 79   CRS by directly
3500: 20 71 75 65 72 79 69 6e 67 20 69 74 73 20 6f 77   querying its ow
3510: 6e 20 70 72 69 76 61 74 65 20 64 61 74 61 62 61  n private databa
3520: 73 65 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 69  se.</li>..<li><i
3530: 3e 3c 75 3e 46 75 74 75 72 65 20 46 6f 72 65 63  ><u>Future Forec
3540: 61 73 74 73 3c 2f 75 3e 3c 2f 69 3e 3a 20 62 6f  asts</u></i>: bo
3550: 74 68 20 3c 62 3e 70 72 6f 6a 34 74 65 78 74 3c  th <b>proj4text<
3560: 2f 62 3e 20 61 6e 64 20 3c 62 3e 73 72 74 65 78  /b> and <b>srtex
3570: 74 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 70 72  t</b> will be pr
3580: 6f 62 61 62 6c 79 20 72 65 6d 6f 76 65 64 20 69  obably removed i
3590: 6e 20 73 6f 6d 65 20 66 75 74 75 72 65 20 76 65  n some future ve
35a0: 72 73 69 6f 6e 20 6f 66 20 53 70 61 74 69 61 4c  rsion of SpatiaL
35b0: 69 74 65 2e 3c 62 72 3e 0d 0a 46 6f 72 20 6e 6f  ite.<br>..For no
35c0: 77 20 74 68 65 79 20 63 6f 6e 74 69 6e 75 65 20  w they continue 
35d0: 74 6f 20 62 65 20 73 75 70 70 6f 72 74 65 64 20  to be supported 
35e0: 6d 61 69 6e 6c 79 20 74 6f 20 74 68 65 20 62 65  mainly to the be
35f0: 6e 65 66 69 74 20 6f 66 20 70 72 65 76 69 6f 75  nefit of previou
3600: 73 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 70  s versions of Sp
3610: 61 74 69 61 4c 69 74 65 20 62 65 69 6e 67 20 62  atiaLite being b
3620: 61 73 65 64 20 6f 6e 20 74 68 65 20 6e 6f 77 20  ased on the now 
3630: 73 75 70 65 72 73 65 64 65 64 20 50 52 4f 4a 2e  superseded PROJ.
3640: 34 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c  4</li>..</ul>..<
3650: 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62  /td></tr>..</tab
3660: 6c 65 3e 0d 0a 3c 68 33 3e 54 72 61 6e 73 66 6f  le>..<h3>Transfo
3670: 72 6d 61 74 69 6f 6e 20 70 69 70 65 6c 69 6e 65  rmation pipeline
3680: 73 3c 2f 68 33 3e 0d 0a 54 68 65 72 65 20 69 73  s</h3>..There is
3690: 20 61 20 6c 61 73 74 20 61 73 74 6f 6e 69 73 68   a last astonish
36a0: 69 6e 67 20 69 6d 70 72 6f 76 65 6d 65 6e 74 20  ing improvement 
36b0: 73 75 70 70 6f 72 74 65 64 20 62 79 20 50 52 4f  supported by PRO
36c0: 4a 2e 36 2c 20 74 68 61 74 20 61 72 65 20 3c 62  J.6, that are <b
36d0: 3e 3c 69 3e 74 72 61 6e 73 66 6f 72 6d 61 74 69  ><i>transformati
36e0: 6f 6e 20 70 69 70 65 6c 69 6e 65 73 3c 2f 69 3e  on pipelines</i>
36f0: 3c 2f 62 3e 2e 3c 62 72 3e 0d 0a 57 68 65 6e 20  </b>.<br>..When 
3700: 75 73 69 6e 67 20 61 20 3c 62 3e 3c 69 3e 70 69  using a <b><i>pi
3710: 70 65 6c 69 6e 65 3c 2f 69 3e 3c 2f 62 3e 20 79  peline</i></b> y
3720: 6f 75 20 63 61 6e 20 66 72 65 65 6c 79 20 64 65  ou can freely de
3730: 66 69 6e 65 20 61 6e 79 20 63 6f 6d 70 6c 65 78  fine any complex
3740: 20 67 65 6f 64 65 74 69 63 20 74 72 61 6e 73 66   geodetic transf
3750: 6f 72 6d 61 74 69 6f 6e 20 62 79 20 63 68 61 69  ormation by chai
3760: 6e 69 6e 67 20 74 6f 67 65 74 68 65 72 20 6d 61  ning together ma
3770: 6e 79 20 65 6c 65 6d 65 6e 74 61 72 79 20 73 74  ny elementary st
3780: 65 70 73 20 73 75 63 68 20 61 73 20 63 6f 6e 76  eps such as conv
3790: 65 72 73 69 6f 6e 2c 20 74 72 61 6e 73 66 6f 72  ersion, transfor
37a0: 6d 61 74 69 6f 6e 2c 20 70 72 6f 6a 65 63 74 69  mation, projecti
37b0: 6f 6e 2c 20 61 78 69 73 20 73 77 61 70 20 61 6e  on, axis swap an
37c0: 64 20 73 6f 20 6f 6e 2e 3c 62 72 3e 0d 0a 41 20  d so on.<br>..A 
37d0: 70 69 70 65 6c 69 6e 65 20 69 73 20 63 6f 6e 63  pipeline is conc
37e0: 65 70 74 75 61 6c 6c 79 20 73 69 6d 69 6c 61 72  eptually similar
37f0: 20 74 6f 20 61 20 55 4e 49 58 20 73 68 65 6c 6c   to a UNIX shell
3800: 20 73 63 72 69 70 74 2c 20 77 69 74 68 20 61 20   script, with a 
3810: 64 61 74 61 66 6c 6f 77 20 72 65 67 75 6c 61 72  dataflow regular
3820: 6c 79 20 70 72 6f 63 65 64 69 6e 67 20 66 6f 72  ly proceding for
3830: 77 61 72 64 20 66 72 6f 6d 20 73 74 65 70 20 74  ward from step t
3840: 6f 20 73 74 65 70 20 75 6e 74 69 6c 20 70 72 6f  o step until pro
3850: 64 75 63 69 6e 67 20 74 68 65 20 66 69 6e 61 6c  ducing the final
3860: 20 72 65 73 75 6c 74 2e 3c 62 72 3e 0d 0a 54 68   result.<br>..Th
3870: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 73 20 61  e following is a
3880: 20 70 72 61 63 74 69 61 6c 20 65 78 61 6d 70 6c   practial exampl
3890: 65 20 6f 66 20 61 20 70 69 70 65 6c 69 6e 65 20  e of a pipeline 
38a0: 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f  corresponding to
38b0: 20 61 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f   a transformatio
38c0: 6e 20 66 72 6f 6d 20 3c 62 3e 45 50 53 47 3a 34  n from <b>EPSG:4
38d0: 33 32 36 3c 2f 62 3e 20 3c 69 3e 57 47 53 20 38  326</b> <i>WGS 8
38e0: 34 3c 2f 69 3e 20 74 6f 20 3c 62 3e 45 50 53 47  4</i> to <b>EPSG
38f0: 3a 33 32 36 33 32 3c 2f 62 3e 20 3c 69 3e 57 47  :32632</b> <i>WG
3900: 53 20 38 34 20 2f 20 55 54 4d 20 7a 6f 6e 65 20  S 84 / UTM zone 
3910: 33 32 4e 3c 2f 69 3e 3a 0d 0a 3c 76 65 72 62 61  32N</i>:..<verba
3920: 74 69 6d 3e 0d 0a 2b 70 72 6f 6a 3d 70 69 70 65  tim>..+proj=pipe
3930: 6c 69 6e 65 20 0d 0a 2b 73 74 65 70 20 2b 70 72  line ..+step +pr
3940: 6f 6a 3d 61 78 69 73 73 77 61 70 20 2b 6f 72 64  oj=axisswap +ord
3950: 65 72 3d 32 2c 31 20 0d 0a 2b 73 74 65 70 20 2b  er=2,1 ..+step +
3960: 70 72 6f 6a 3d 75 6e 69 74 63 6f 6e 76 65 72 74  proj=unitconvert
3970: 20 2b 78 79 5f 69 6e 3d 64 65 67 20 2b 78 79 5f   +xy_in=deg +xy_
3980: 6f 75 74 3d 72 61 64 20 0d 0a 2b 73 74 65 70 20  out=rad ..+step 
3990: 2b 70 72 6f 6a 3d 75 74 6d 20 2b 7a 6f 6e 65 3d  +proj=utm +zone=
39a0: 33 32 20 2b 65 6c 6c 70 73 3d 57 47 53 38 34 0d  32 +ellps=WGS84.
39b0: 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 3c 74  .</verbatim>..<t
39c0: 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 69 6e 67  able cellspacing
39d0: 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 69 6e 67  ="8" cellpadding
39e0: 3d 22 31 36 22 20 62 67 63 6f 6c 6f 72 3d 22 23  ="16" bgcolor="#
39f0: 66 66 66 66 64 30 22 3e 0d 0a 3c 74 72 3e 3c 74  ffffd0">..<tr><t
3a00: 64 3e 0d 0a 3c 62 3e 3c 75 3e 55 73 65 66 75 6c  d>..<b><u>Useful
3a10: 20 68 69 6e 74 3c 2f 75 3e 3c 2f 62 3e 3a 20 50   hint</u></b>: P
3a20: 52 4f 4a 2e 36 20 73 75 70 70 6f 72 74 73 20 61  ROJ.6 supports a
3a30: 20 6e 65 77 20 43 4c 49 20 74 6f 6f 6c 20 28 3c   new CLI tool (<
3a40: 62 3e 70 72 6f 6a 69 6e 66 6f 3c 2f 62 3e 29 20  b>projinfo</b>) 
3a50: 66 6f 72 20 69 6e 73 70 65 63 74 69 6e 67 20 69  for inspecting i
3a60: 6e 20 66 75 6c 6c 20 64 65 74 61 69 6c 20 74 68  n full detail th
3a70: 65 20 69 6e 74 65 72 6e 61 6c 20 64 65 66 69 6e  e internal defin
3a80: 69 74 69 6f 6e 73 20 6f 66 20 43 52 53 65 73 2c  itions of CRSes,
3a90: 20 54 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 73   Transformations
3aa0: 20 65 74 63 2e 3c 62 72 3e 0d 0a 54 68 65 20 61   etc.<br>..The a
3ab0: 62 6f 76 65 20 70 69 70 65 6c 69 6e 65 20 69 73  bove pipeline is
3ac0: 20 73 69 6d 70 6c 79 20 74 68 65 20 6f 75 74 70   simply the outp
3ad0: 75 74 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77  ut of the follow
3ae0: 69 6e 67 20 63 6f 6d 6d 61 6e 64 3a 0d 0a 3c 76  ing command:..<v
3af0: 65 72 62 61 74 69 6d 3e 0d 0a 70 72 6f 6a 69 6e  erbatim>..projin
3b00: 66 6f 20 2d 73 20 45 50 53 47 3a 34 33 32 36 20  fo -s EPSG:4326 
3b10: 2d 74 20 45 50 53 47 3a 33 32 36 33 32 20 2d 6f  -t EPSG:32632 -o
3b20: 20 70 72 6f 6a 0d 0a 3c 2f 76 65 72 62 61 74 69   proj..</verbati
3b30: 6d 3e 0d 0a 3c 62 3e 70 72 6f 6a 69 6e 66 6f 3c  m>..<b>projinfo<
3b40: 2f 62 3e 20 69 73 20 61 20 76 65 72 79 20 70 72  /b> is a very pr
3b50: 65 63 69 6f 75 73 20 72 65 73 6f 75 72 63 65 3b  ecious resource;
3b60: 20 64 6f 6e 27 74 20 65 73 69 74 61 74 65 20 74   don't esitate t
3b70: 6f 20 66 72 65 71 75 65 6e 74 6c 79 20 75 73 65  o frequently use
3b80: 20 69 74 20 69 6e 20 6f 72 64 65 72 20 74 6f 20   it in order to 
3b90: 64 69 73 63 6f 76 65 72 20 77 68 61 74 27 73 20  discover what's 
3ba0: 72 65 61 6c 6c 79 20 68 61 70 70 65 6e 69 6e 67  really happening
3bb0: 20 62 65 68 69 6e 64 20 74 68 65 20 73 63 65 6e   behind the scen
3bc0: 65 73 2e 3c 62 72 3e 0d 0a 49 74 27 73 20 74 68  es.<br>..It's th
3bd0: 65 20 62 65 73 74 20 61 6e 64 20 65 61 73 69 65  e best and easie
3be0: 73 74 20 77 61 79 20 66 6f 72 20 66 75 6c 6c 79  st way for fully
3bf0: 20 75 6e 64 65 72 73 74 61 6e 74 69 6e 67 20 68   understanting h
3c00: 6f 77 20 50 52 4f 4a 2e 36 20 64 6f 20 72 65 61  ow PROJ.6 do rea
3c10: 6c 6c 79 20 77 6f 72 6b 73 2e 0d 0a 3c 2f 74 64  lly works...</td
3c20: 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e  ></tr>..</table>
3c30: 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65  <br><br>..<table
3c40: 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22   cellspacing="8"
3c50: 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 38 22   cellpadding="8"
3c60: 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65   bgcolor="#ffffe
3c70: 39 22 3e 0d 0a 3c 74 72 3e 3c 74 68 3e 0d 0a 49  9">..<tr><th>..I
3c80: 6e 20 6f 72 64 65 72 20 74 6f 20 6c 65 61 72 6e  n order to learn
3c90: 20 6d 6f 72 65 20 61 62 6f 75 74 20 74 68 65 20   more about the 
3ca0: 6d 61 6e 79 20 69 6e 74 65 72 65 73 74 69 6e 67  many interesting
3cb0: 20 63 6f 6f 6c 20 6e 65 77 20 66 65 61 74 75 72   cool new featur
3cc0: 65 73 20 73 75 70 70 6f 72 74 65 64 20 62 79 20  es supported by 
3cd0: 50 52 4f 4a 2e 36 20 70 6c 65 61 73 65 20 63 6f  PROJ.6 please co
3ce0: 6e 73 75 6c 74 20 74 68 65 20 3c 61 20 68 72 65  nsult the <a hre
3cf0: 66 3d 22 68 74 74 70 73 3a 2f 2f 70 72 6f 6a 34  f="https://proj4
3d00: 2e 6f 72 67 2f 22 3e 6f 72 69 67 69 6e 61 6c 20  .org/">original 
3d10: 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 3c 2f 61  documentation</a
3d20: 3e 0d 0a 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c  >..</th></tr>..<
3d30: 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 68 72  /table><br>..<hr
3d40: 3e 0d 0a 3c 68 31 3e 53 70 61 74 69 61 4c 69 74  >..<h1>SpatiaLit
3d50: 65 2d 35 2e 30 2e 30 20 73 75 70 70 6f 72 74 69  e-5.0.0 supporti
3d60: 6e 67 20 50 52 4f 4a 2e 36 3c 2f 68 31 3e 0d 0a  ng PROJ.6</h1>..
3d70: 3c 68 33 3e 43 72 65 61 74 69 6e 67 20 61 6e 64  <h3>Creating and
3d80: 20 70 6f 70 75 6c 61 74 69 6e 67 20 74 68 65 20   populating the 
3d90: 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 20  spatial_ref_sys 
3da0: 6d 65 74 61 74 61 62 6c 65 3c 2f 68 33 3e 0d 0a  metatable</h3>..
3db0: 3c 68 33 3e 45 78 69 73 74 69 6e 67 20 53 51 4c  <h3>Existing SQL
3dc0: 20 66 75 6e 63 74 69 6f 6e 73 20 61 66 66 65 63   functions affec
3dd0: 74 65 64 20 62 79 20 50 52 4f 4a 2e 36 3c 2f 68  ted by PROJ.6</h
3de0: 33 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73  3>..<table cells
3df0: 70 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70  pacing="8" cellp
3e00: 61 64 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c  adding="8" bgcol
3e10: 6f 72 3d 22 23 65 38 66 66 65 38 22 20 62 6f 72  or="#e8ffe8" bor
3e20: 64 65 72 3d 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74  der="1">..<tr><t
3e30: 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30  h bgcolor="#ffb0
3e40: 33 65 22 3e 53 51 4c 20 46 75 6e 63 74 69 6f 6e  3e">SQL Function
3e50: 3c 2f 74 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72  </th><th bgcolor
3e60: 3d 22 23 66 66 62 30 33 65 22 3e 45 78 74 65 6e  ="#ffb03e">Exten
3e70: 64 65 64 20 73 69 67 6e 61 74 75 72 65 3c 2f 74  ded signature</t
3e80: 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23  h><th bgcolor="#
3e90: 66 66 62 30 33 65 22 3e 42 65 68 61 76 69 6f 72  ffb03e">Behavior
3ea0: 20 75 6e 64 65 72 20 50 52 4f 4a 2e 36 3c 2f 74   under PROJ.6</t
3eb0: 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64  h></tr>..<tr><td
3ec0: 3e 3c 62 3e 53 54 5f 54 72 61 6e 73 66 6f 72 6d  ><b>ST_Transform
3ed0: 28 29 3c 2f 62 3e 3c 2f 74 64 3e 0d 0a 3c 74 64  ()</b></td>..<td
3ee0: 3e 0d 0a 3c 62 3e 53 54 5f 54 72 61 6e 73 66 6f  >..<b>ST_Transfo
3ef0: 72 6d 3c 2f 62 3e 20 28 20 67 65 6f 6d 20 3c 69  rm</b> ( geom <i
3f00: 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20  >Geometry</i> , 
3f10: 6e 65 77 53 72 69 64 20 3c 69 3e 49 6e 74 65 67  newSrid <i>Integ
3f20: 65 72 3c 2f 69 3e 20 2c 20 61 72 65 61 20 3c 69  er</i> , area <i
3f30: 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 29 20  >Geometry</i> ) 
3f40: 3a 20 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69  : <i>Geometry</i
3f50: 3e 3c 68 72 3e 0d 0a 3c 62 3e 53 54 5f 54 72 61  ><hr>..<b>ST_Tra
3f60: 6e 73 66 6f 72 6d 3c 2f 62 3e 20 28 20 67 65 6f  nsform</b> ( geo
3f70: 6d 20 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69  m <i>Geometry</i
3f80: 3e 20 2c 20 6e 65 77 53 72 69 64 20 3c 69 3e 49  > , newSrid <i>I
3f90: 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 61 72 65  nteger</i> , are
3fa0: 61 20 3c 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69  a <i>Geometry</i
3fb0: 3e 20 2c 20 6d 65 74 68 6f 64 20 3c 69 3e 54 65  > , method <i>Te
3fc0: 78 74 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 47 65  xt</i> ) : <i>Ge
3fd0: 6f 6d 65 74 72 79 3c 2f 69 3e 3c 68 72 3e 0d 0a  ometry</i><hr>..
3fe0: 3c 62 3e 53 54 5f 54 72 61 6e 73 66 6f 72 6d 3c  <b>ST_Transform<
3ff0: 2f 62 3e 20 28 20 67 65 6f 6d 20 3c 69 3e 47 65  /b> ( geom <i>Ge
4000: 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 6e 65 77  ometry</i> , new
4010: 53 72 69 64 20 3c 69 3e 49 6e 74 65 67 65 72 3c  Srid <i>Integer<
4020: 2f 69 3e 20 2c 20 61 72 65 61 20 3c 69 3e 47 65  /i> , area <i>Ge
4030: 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 6d 65 74  ometry</i> , met
4040: 68 6f 64 20 3c 69 3e 54 65 78 74 3c 2f 69 3e 20  hod <i>Text</i> 
4050: 2c 20 70 72 6f 6a 5f 73 74 72 69 6e 67 20 3c 69  , proj_string <i
4060: 3e 54 65 78 74 3c 2f 69 3e 20 29 20 3a 20 3c 69  >Text</i> ) : <i
4070: 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 0d 0a 3c  >Geometry</i>..<
4080: 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a 3c 74 61 62  /td>..<td>..<tab
4090: 6c 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22  le cellspacing="
40a0: 34 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22  4" cellpadding="
40b0: 34 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66  4" bgcolor="#fff
40c0: 66 64 30 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d  fd0">..<tr><td>.
40d0: 0a 3c 62 3e 3c 75 3e 3c 69 3e 4e 6f 74 65 3c 2f  .<b><u><i>Note</
40e0: 69 3e 3c 2f 75 3e 3c 2f 62 3e 3a 20 61 6c 6c 20  i></u></b>: all 
40f0: 74 68 65 73 65 20 3c 62 3e 3c 69 3e 65 78 74 65  these <b><i>exte
4100: 6e 64 65 64 20 73 69 67 6e 61 74 75 72 65 73 3c  nded signatures<
4110: 2f 69 3e 3c 2f 62 3e 20 61 72 65 20 73 75 70 70  /i></b> are supp
4120: 6f 72 74 65 64 20 6f 6e 6c 79 20 77 68 65 6e 20  orted only when 
4130: 3c 62 3e 6c 69 62 73 70 61 74 69 61 6c 69 74 65  <b>libspatialite
4140: 2d 35 2e 30 3c 2f 62 3e 20 68 61 73 20 62 65 65  -5.0</b> has bee
4150: 6e 20 62 75 69 6c 74 20 6f 6e 20 74 68 65 20 74  n built on the t
4160: 6f 70 20 6f 66 20 3c 62 3e 50 52 4f 4a 2e 36 3c  op of <b>PROJ.6<
4170: 2f 62 3e 3c 62 72 3e 0d 0a 49 66 20 74 68 65 20  /b><br>..If the 
4180: 6c 69 62 72 61 72 79 20 68 61 73 20 62 65 65 6e  library has been
4190: 20 62 75 69 6c 74 20 69 6e 73 74 65 61 64 20 6f   built instead o
41a0: 6e 20 65 61 72 6c 69 65 72 20 76 65 72 73 69 6f  n earlier versio
41b0: 6e 73 20 6f 66 20 50 52 4f 4a 20 61 6e 79 20 61  ns of PROJ any a
41c0: 74 74 65 6d 70 74 20 74 6f 20 63 61 6c 6c 20 74  ttempt to call t
41d0: 68 65 73 65 20 65 78 74 65 6e 64 65 64 20 73 69  hese extended si
41e0: 67 6e 61 74 75 72 65 73 20 77 69 6c 6c 20 6a 75  gnatures will ju
41f0: 73 74 20 72 65 74 75 72 6e 20 61 20 3c 62 3e 3c  st return a <b><
4200: 69 3e 77 72 6f 6e 67 20 6e 75 6d 62 65 72 20 6f  i>wrong number o
4210: 66 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 66  f arguments to f
4220: 75 6e 63 74 69 6f 6e 20 53 54 5f 54 72 61 6e 73  unction ST_Trans
4230: 66 6f 72 6d 28 29 3c 2f 69 3e 3c 2f 62 3e 20 65  form()</i></b> e
4240: 72 72 6f 72 2e 0d 0a 3c 2f 74 64 3e 3c 74 72 3e  rror...</td><tr>
4250: 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a  ..</table><br>..
4260: 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 69  <table cellspaci
4270: 6e 67 3d 22 34 22 20 63 65 6c 6c 70 61 64 64 69  ng="4" cellpaddi
4280: 6e 67 3d 22 34 22 20 62 67 63 6f 6c 6f 72 3d 22  ng="4" bgcolor="
4290: 23 66 66 64 66 64 30 22 3e 0d 0a 3c 74 72 3e 3c  #ffdfd0">..<tr><
42a0: 74 64 3e 0d 0a 41 6e 79 20 69 6e 76 61 6c 69 64  td>..Any invalid
42b0: 20 61 72 67 75 6d 65 6e 74 20 70 61 73 73 65 64   argument passed
42c0: 20 74 6f 20 3c 62 3e 53 54 5f 54 72 61 6e 73 66   to <b>ST_Transf
42d0: 6f 72 6d 28 29 3c 2f 62 3e 20 28 3c 62 3e 3c 69  orm()</b> (<b><i
42e0: 3e 65 78 74 65 6e 64 65 64 20 73 69 67 6e 61 74  >extended signat
42f0: 75 72 65 73 3c 2f 69 3e 3c 2f 62 3e 29 20 77 69  ures</i></b>) wi
4300: 6c 6c 20 72 61 69 73 65 20 61 6e 20 3c 62 3e 53  ll raise an <b>S
4310: 51 4c 20 45 78 63 65 70 74 69 6f 6e 3c 2f 62 3e  QL Exception</b>
4320: 2e 0d 0a 3c 2f 74 64 3e 3c 74 72 3e 0d 0a 3c 2f  ...</td><tr>..</
4330: 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 75 6c 3e  table><br>..<ul>
4340: 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e  ..<li>the option
4350: 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e 61  al argument <b>a
4360: 72 65 61 3c 2f 62 3e 20 6d 61 79 20 62 65 20 3c  rea</b> may be <
4370: 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 28 3c 69 3e 64  b>NULL</b> (<i>d
4380: 65 66 61 75 6c 74 20 73 65 74 74 69 6e 67 3c 2f  efault setting</
4390: 69 3e 29 2e 3c 62 72 3e 0d 0a 4f 74 68 65 72 77  i>).<br>..Otherw
43a0: 69 73 65 20 69 74 27 73 20 65 78 70 65 63 74 65  ise it's expecte
43b0: 64 20 74 6f 20 63 6f 6e 74 61 69 6e 20 61 20 76  d to contain a v
43c0: 61 6c 69 64 20 47 65 6f 6d 65 74 72 79 20 69 6e  alid Geometry in
43d0: 20 3c 62 3e 53 52 49 44 3d 34 33 32 36 20 28 6c   <b>SRID=4326 (l
43e0: 6f 6e 67 2f 6c 61 74 29 3c 2f 62 3e 2e 0d 0a 57  ong/lat)</b>...W
43f0: 68 65 6e 20 61 6e 20 3c 62 3e 3c 69 3e 61 72 65  hen an <b><i>are
4400: 61 20 6f 66 20 75 73 65 3c 2f 69 3e 3c 2f 62 3e  a of use</i></b>
4410: 20 69 73 20 65 78 70 6c 69 63 69 74 6c 79 20 73   is explicitly s
4420: 75 70 70 6c 69 65 64 2c 20 74 68 65 6e 20 3c 62  upplied, then <b
4430: 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 20 6d 61 79 20  >PROJ.6</b> may 
4440: 65 76 65 6e 74 75 61 6c 6c 79 20 75 73 65 20 74  eventually use t
4450: 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67  he corresponding
4460: 20 3c 62 3e 42 42 4f 58 3c 2f 62 3e 20 66 6f 72   <b>BBOX</b> for
4470: 20 66 69 6e 65 6c 79 20 74 75 6e 69 6e 67 20 74   finely tuning t
4480: 68 65 20 6d 6f 72 65 20 61 63 63 75 72 61 74 65  he more accurate
4490: 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 2e   transformation.
44a0: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f  </li>..<li>the o
44b0: 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74  ptional argument
44c0: 20 3c 62 3e 6d 65 74 68 6f 64 3c 2f 62 3e 20 69   <b>method</b> i
44d0: 73 20 65 78 70 65 63 74 65 64 20 74 6f 20 63 6f  s expected to co
44e0: 6e 74 61 69 6e 20 6f 6e 65 20 74 68 65 20 66 6f  ntain one the fo
44f0: 6c 6c 6f 77 69 6e 67 20 76 61 6c 75 65 73 20 28  llowing values (
4500: 3c 62 3e 61 75 74 68 5f 6e 61 6d 65 3a 61 75 74  <b>auth_name:aut
4510: 68 5f 73 74 72 69 64 3c 2f 62 3e 20 77 69 6c 6c  h_strid</b> will
4520: 20 62 65 20 61 6c 77 61 79 73 20 61 73 73 75 6d   be always assum
4530: 65 64 20 61 73 20 74 68 65 20 3c 69 3e 64 65 66  ed as the <i>def
4540: 61 75 6c 74 20 73 65 74 74 69 6e 67 3c 2f 69 3e  ault setting</i>
4550: 29 3a 3c 2f 6c 69 3e 0d 0a 3c 75 6c 3e 0d 0a 3c  ):</li>..<ul>..<
4560: 6c 69 3e 3c 62 3e 70 72 6f 6a 34 74 65 78 74 3c  li><b>proj4text<
4570: 2f 62 3e 3a 20 62 6f 74 68 20 43 52 53 65 73 20  /b>: both CRSes 
4580: 28 6f 72 69 67 69 6e 20 61 6e 64 20 64 65 73 74  (origin and dest
4590: 69 6e 61 74 69 6f 6e 29 20 77 69 6c 6c 20 62 65  ination) will be
45a0: 20 64 65 66 69 6e 65 64 20 62 79 20 70 61 73 73   defined by pass
45b0: 69 6e 67 20 74 6f 20 50 52 4f 4a 2e 36 20 74 68  ing to PROJ.6 th
45c0: 65 20 74 72 61 64 69 74 69 6f 6e 61 6c 73 20 3c  e traditionals <
45d0: 62 3e 70 72 6f 6a 2d 73 74 72 69 6e 67 3c 2f 62  b>proj-string</b
45e0: 3e 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 66 6f  > definitions fo
45f0: 72 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64  r the correspond
4600: 69 6e 67 20 53 52 49 44 73 20 72 65 74 72 69 65  ing SRIDs retrie
4610: 76 65 64 20 66 72 6f 6d 20 63 6f 6c 75 6d 6e 20  ved from column 
4620: 3c 62 3e 70 72 6f 6a 34 74 65 78 74 3c 2f 62 3e  <b>proj4text</b>
4630: 20 69 6e 20 54 61 62 6c 65 20 3c 62 3e 73 70 61   in Table <b>spa
4640: 74 69 61 6c 5f 72 65 66 5f 73 79 73 3c 2f 62 3e  tial_ref_sys</b>
4650: 3c 62 72 3e 0d 0a 54 68 69 73 20 65 78 61 63 74  <br>..This exact
4660: 6c 79 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74  ly corresponds t
4670: 6f 20 74 68 65 20 77 65 6c 6c 20 65 78 74 61 62  o the well extab
4680: 6c 69 73 68 65 64 20 74 72 61 64 69 74 69 6f 6e  lished tradition
4690: 61 6c 20 62 65 68 61 76 69 6f 72 20 6f 66 20 61  al behavior of a
46a0: 6c 6c 20 70 72 65 76 69 6f 75 73 20 76 65 72 73  ll previous vers
46b0: 69 6f 6e 73 20 6f 66 20 3c 62 3e 6c 69 62 73 70  ions of <b>libsp
46c0: 61 74 69 61 6c 69 74 65 3c 2f 62 3e 20 61 6e 64  atialite</b> and
46d0: 20 73 74 69 6c 6c 20 63 6f 6e 74 69 6e 75 65 73   still continues
46e0: 20 74 6f 20 62 65 20 73 75 70 70 6f 72 74 65 64   to be supported
46f0: 2c 20 62 75 74 20 3c 62 3e 3c 75 3e 3c 69 3e 69  , but <b><u><i>i
4700: 73 6e 27 74 20 61 6e 79 20 6c 6f 6e 67 65 72 20  sn't any longer 
4710: 74 68 65 20 62 65 73 74 20 77 61 79 20 66 6f 72  the best way for
4720: 20 74 61 6b 69 6e 67 20 66 75 6c 6c 20 70 72 6f   taking full pro
4730: 66 69 74 20 6f 66 20 74 68 65 20 6d 6f 72 65 20  fit of the more 
4740: 61 64 76 61 6e 63 65 64 20 63 61 70 61 62 69 6c  advanced capabil
4750: 69 74 69 65 73 20 6f 66 20 50 52 4f 4a 2e 36 3c  ities of PROJ.6<
4760: 2f 69 3e 3c 2f 75 3e 3c 2f 62 3e 3c 2f 6c 69 3e  /i></u></b></li>
4770: 0d 0a 3c 6c 69 3e 3c 62 3e 73 72 74 65 78 74 3c  ..<li><b>srtext<
4780: 2f 62 3e 3a 20 62 6f 74 68 20 43 52 53 65 73 20  /b>: both CRSes 
4790: 28 6f 72 69 67 69 6e 20 61 6e 64 20 64 65 73 74  (origin and dest
47a0: 69 6e 61 74 69 6f 6e 29 20 77 69 6c 6c 20 62 65  ination) will be
47b0: 20 64 65 66 69 6e 65 64 20 62 79 20 70 61 73 73   defined by pass
47c0: 69 6e 67 20 74 6f 20 50 52 4f 4a 2e 36 20 74 68  ing to PROJ.6 th
47d0: 65 20 3c 62 3e 57 4b 54 3c 2f 62 3e 20 64 65 66  e <b>WKT</b> def
47e0: 69 6e 69 74 69 6f 6e 73 20 66 6f 72 20 74 68 65  initions for the
47f0: 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 53   corresponding S
4800: 52 49 44 73 20 72 65 74 72 69 65 76 65 64 20 66  RIDs retrieved f
4810: 72 6f 6d 20 63 6f 6c 75 6d 6e 20 3c 62 3e 73 72  rom column <b>sr
4820: 74 65 78 74 3c 2f 62 3e 20 69 6e 20 54 61 62 6c  text</b> in Tabl
4830: 65 20 3c 62 3e 73 70 61 74 69 61 6c 5f 72 65 66  e <b>spatial_ref
4840: 5f 73 79 73 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c  _sys</b></li>..<
4850: 6c 69 3e 3c 62 3e 61 75 74 68 5f 6e 61 6d 65 3a  li><b>auth_name:
4860: 61 75 74 68 5f 73 72 69 64 3c 2f 62 3e 3a 20 62  auth_srid</b>: b
4870: 6f 74 68 20 43 52 53 65 73 20 28 6f 72 69 67 69  oth CRSes (origi
4880: 6e 20 61 6e 64 20 64 65 73 74 69 6e 61 74 69 6f  n and destinatio
4890: 6e 29 20 77 69 6c 6c 20 62 65 20 64 65 66 69 6e  n) will be defin
48a0: 65 64 20 62 79 20 69 67 6e 6f 72 69 6e 67 20 74  ed by ignoring t
48b0: 68 65 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 73  he definitions s
48c0: 74 6f 72 65 64 20 69 6e 20 3c 62 3e 73 70 61 74  tored in <b>spat
48d0: 69 61 6c 5f 72 65 66 5f 73 79 73 3c 2f 62 3e 20  ial_ref_sys</b> 
48e0: 61 6e 64 20 6c 65 61 76 69 6e 67 20 50 52 4f 4a  and leaving PROJ
48f0: 2e 36 20 66 72 65 65 20 74 6f 20 72 65 74 72 69  .6 free to retri
4900: 65 76 65 20 74 68 65 69 72 20 63 6f 72 72 65 73  eve their corres
4910: 70 6f 6e 64 69 6e 67 20 64 65 66 69 6e 69 74 69  ponding definiti
4920: 6f 6e 73 20 66 72 6f 6d 20 69 74 73 20 6f 77 6e  ons from its own
4930: 20 70 72 69 76 61 74 65 20 53 51 4c 69 74 65 20   private SQLite 
4940: 64 61 74 61 62 61 73 65 2e 3c 62 72 3e 0d 0a 3c  database.<br>..<
4950: 62 3e 3c 75 3e 3c 69 3e 4e 6f 74 65 3c 2f 69 3e  b><u><i>Note</i>
4960: 3c 2f 75 3e 3c 2f 62 3e 3a 20 74 68 69 73 20 6d  </u></b>: this m
4970: 65 74 68 6f 64 20 77 69 6c 6c 20 61 6c 77 61 79  ethod will alway
4980: 73 20 74 61 6b 65 20 66 75 6c 6c 20 70 72 6f 66  s take full prof
4990: 69 74 20 6f 66 20 74 68 65 20 6d 6f 72 65 20 61  it of the more a
49a0: 64 76 61 6e 63 65 64 20 63 61 70 61 62 69 6c 69  dvanced capabili
49b0: 74 69 65 73 20 6f 66 20 50 52 4f 4a 2e 36 2c 20  ties of PROJ.6, 
49c0: 65 76 65 6e 20 77 68 65 6e 20 75 73 69 6e 67 20  even when using 
49d0: 73 6f 6d 65 20 53 70 61 74 69 61 4c 69 74 65 20  some SpatiaLite 
49e0: 64 61 74 61 62 61 73 65 20 63 72 65 61 74 65 64  database created
49f0: 20 62 79 20 65 61 72 6c 69 65 72 20 76 65 72 73   by earlier vers
4a00: 69 6f 6e 73 20 6e 6f 74 20 79 65 74 20 73 75 70  ions not yet sup
4a10: 70 6f 72 74 69 6e 67 20 50 52 4f 4a 2e 36 3c 2f  porting PROJ.6</
4a20: 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 70 72 6f 6a  li>..<li><b>proj
4a30: 5f 73 74 72 69 6e 67 3c 2f 62 3e 3a 20 61 6e 20  _string</b>: an 
4a40: 3c 62 3e 3c 69 3e 75 73 65 72 2d 64 65 66 69 6e  <b><i>user-defin
4a50: 65 64 20 70 72 6f 6a 2d 73 74 72 69 6e 67 3c 2f  ed proj-string</
4a60: 69 3e 3c 2f 62 3e 20 28 6d 61 79 20 62 65 20 6f  i></b> (may be o
4a70: 6e 65 20 64 65 66 69 6e 69 6e 69 6e 67 20 61 20  ne definining a 
4a80: 3c 62 3e 3c 69 3e 74 72 61 6e 73 66 6f 72 6d 61  <b><i>transforma
4a90: 74 69 6f 6e 20 70 69 70 65 6c 69 6e 65 3c 2f 69  tion pipeline</i
4aa0: 3e 3c 2f 62 3e 29 20 77 69 6c 6c 20 62 65 20 70  ></b>) will be p
4ab0: 61 73 73 65 64 20 74 6f 20 50 52 4f 4a 2e 36 3b  assed to PROJ.6;
4ac0: 20 74 68 69 73 20 69 73 20 61 6e 20 61 64 76 61   this is an adva
4ad0: 6e 63 65 64 20 6f 70 74 69 6f 6e 20 72 65 73 65  nced option rese
4ae0: 72 76 65 64 20 74 6f 20 73 6b 69 6c 6c 65 64 20  rved to skilled 
4af0: 70 6f 77 65 72 20 75 73 65 72 73 2e 3c 2f 6c 69  power users.</li
4b00: 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c 69 3e 0d 0a 3c  >..</ul></li>..<
4b10: 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20  li>the optional 
4b20: 61 72 67 75 6d 65 6e 74 20 3c 62 3e 70 72 6f 6a  argument <b>proj
4b30: 5f 73 74 72 69 6e 67 3c 2f 62 3e 20 6d 61 79 20  _string</b> may 
4b40: 62 65 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 28  be <b>NULL</b> (
4b50: 3c 69 3e 64 65 66 61 75 6c 74 20 73 65 74 74 69  <i>default setti
4b60: 6e 67 3c 2f 69 3e 29 2e 3c 62 72 3e 0d 0a 4f 74  ng</i>).<br>..Ot
4b70: 68 65 72 77 69 73 65 20 69 74 27 73 20 65 78 70  herwise it's exp
4b80: 65 63 74 65 64 20 74 6f 20 63 6f 6e 74 61 69 6e  ected to contain
4b90: 20 61 20 76 61 6c 69 64 20 3c 62 3e 50 52 4f 4a   a valid <b>PROJ
4ba0: 2e 36 20 3c 69 3e 74 72 61 6e 73 66 6f 72 6d 61  .6 <i>transforma
4bb0: 74 69 6f 6e 20 73 74 72 69 6e 67 3c 2f 69 3e 3c  tion string</i><
4bc0: 2f 62 3e 2c 20 6d 61 79 20 77 65 6c 6c 20 62 65  /b>, may well be
4bd0: 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74   corresponding t
4be0: 6f 20 61 6e 20 3c 62 3e 3c 69 3e 75 73 65 72 2d  o an <b><i>user-
4bf0: 64 65 66 69 6e 65 64 20 74 72 61 6e 73 66 6f 72  defined transfor
4c00: 6d 61 74 69 6f 6e 20 70 69 70 65 6c 69 6e 65 3c  mation pipeline<
4c10: 2f 69 3e 3c 2f 62 3e 2e 0d 0a 4d 65 61 6e 69 6e  /i></b>...Meanin
4c20: 67 66 75 6c 20 6f 6e 6c 79 20 69 6e 20 74 68 65  gful only in the
4c30: 20 63 61 73 65 20 6f 66 20 3c 62 3e 6d 65 74 68   case of <b>meth
4c40: 6f 64 3d 70 72 6f 6a 5f 73 74 72 69 6e 67 3c 2f  od=proj_string</
4c50: 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a  b></li>..</ul>..
4c60: 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e  </td></tr>..<tr>
4c70: 3c 74 64 20 63 6f 6c 73 70 61 6e 3d 22 33 22 3e  <td colspan="3">
4c80: 0d 0a 3c 68 33 3e 4e 6f 74 65 73 3c 2f 68 33 3e  ..<h3>Notes</h3>
4c90: 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 53 70 61 74  ..<ul>..<li>Spat
4ca0: 69 61 4c 69 74 65 20 64 6f 65 73 20 6e 6f 74 20  iaLite does not 
4cb0: 63 6f 6e 73 74 72 61 69 6e 74 73 20 79 6f 75 20  constraints you 
4cc0: 69 6e 20 61 6e 79 20 77 61 79 20 61 6e 64 20 66  in any way and f
4cd0: 75 6c 6c 79 20 72 65 73 70 65 63 74 73 20 75 73  ully respects us
4ce0: 65 72 73 20 66 72 65 65 64 6f 6d 20 63 61 72 65  ers freedom care
4cf0: 66 75 6c 6c 79 20 61 76 6f 69 64 69 6e 67 20 3c  fully avoiding <
4d00: 69 3e 61 75 74 6f 2d 6d 61 67 69 63 61 6c 3c 2f  i>auto-magical</
4d10: 69 3e 20 61 73 73 75 6d 70 74 69 6f 6e 73 2e 0d  i> assumptions..
4d20: 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 54 68 65 20 6e  .<ul>..<li>The n
4d30: 65 77 20 3c 62 3e 3c 69 3e 65 78 74 65 6e 64 65  ew <b><i>extende
4d40: 64 20 73 69 67 6e 61 74 75 72 65 73 3c 2f 69 3e  d signatures</i>
4d50: 3c 2f 62 3e 20 73 75 70 70 6f 72 74 65 64 20 62  </b> supported b
4d60: 79 20 3c 62 3e 53 54 5f 54 72 61 6e 73 66 6f 72  y <b>ST_Transfor
4d70: 6d 3c 2f 62 3e 20 63 6c 6f 73 65 6c 79 20 6d 69  m</b> closely mi
4d80: 6d 69 63 20 74 68 65 20 6d 6f 73 74 20 72 65 63  mic the most rec
4d90: 65 6e 74 20 50 52 4f 4a 2e 36 20 41 50 49 2c 20  ent PROJ.6 API, 
4da0: 73 6f 20 79 6f 75 20 61 72 65 20 66 72 65 65 20  so you are free 
4db0: 74 6f 20 64 65 66 69 6e 65 20 79 6f 75 72 20 63  to define your c
4dc0: 6f 6f 72 64 69 6e 61 74 65 73 20 74 72 61 6e 73  oordinates trans
4dd0: 66 6f 72 6d 61 74 69 6f 6e 73 20 69 6e 20 73 65  formations in se
4de0: 76 65 72 61 6c 20 64 69 66 66 65 72 65 6e 74 20  veral different 
4df0: 77 61 79 73 2e 3c 2f 6c 69 3e 20 0d 0a 3c 6c 69  ways.</li> ..<li
4e00: 3e 54 68 65 20 64 65 66 61 75 6c 74 20 62 65 68  >The default beh
4e10: 61 76 69 6f 72 20 6f 66 20 53 70 61 74 69 61 4c  avior of SpatiaL
4e20: 69 74 65 20 77 68 65 6e 20 75 73 69 6e 67 20 50  ite when using P
4e30: 52 4f 4a 2e 36 20 69 73 20 74 6f 20 63 6f 6d 70  ROJ.6 is to comp
4e40: 6c 65 74 65 6c 79 20 69 67 6e 6f 72 65 20 74 68  letely ignore th
4e50: 65 20 43 52 53 20 64 65 66 69 6e 69 74 69 6f 6e  e CRS definition
4e60: 73 20 73 74 6f 72 65 64 20 77 69 74 68 69 6e 20  s stored within 
4e70: 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 74 61 62  the internal tab
4e80: 6c 65 20 3c 62 3e 73 70 61 74 69 61 6c 5f 72 65  le <b>spatial_re
4e90: 66 5f 73 79 73 3c 2f 62 3e 3c 62 72 3e 0d 0a 41  f_sys</b><br>..A
4ea0: 6e 79 20 72 65 71 75 69 72 65 64 20 43 52 53 20  ny required CRS 
4eb0: 64 65 66 69 6e 69 74 69 6f 6e 20 77 69 6c 6c 20  definition will 
4ec0: 62 65 20 61 6c 77 61 79 73 20 72 65 74 72 69 65  be always retrie
4ed0: 76 65 64 20 66 6f 72 6d 20 74 68 65 20 70 72 69  ved form the pri
4ee0: 76 61 74 65 20 53 51 4c 69 74 65 20 64 61 74 61  vate SQLite data
4ef0: 62 61 73 65 20 73 75 70 70 6f 72 74 69 6e 67 20  base supporting 
4f00: 50 52 4f 4a 2e 36 20 28 3c 69 3e 6d 65 74 68 6f  PROJ.6 (<i>metho
4f10: 64 3c 2f 69 3e 3d 3c 62 3e 61 75 74 68 5f 6e 61  d</i>=<b>auth_na
4f20: 6d 65 3a 61 75 74 68 5f 73 72 69 64 3c 2f 62 3e  me:auth_srid</b>
4f30: 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 49 66 20  ).</li>..<li>If 
4f40: 79 6f 75 20 68 61 76 65 20 61 6e 79 20 67 6f 6f  you have any goo
4f50: 64 20 72 65 61 73 6f 6e 20 73 75 67 67 65 73 74  d reason suggest
4f60: 69 6e 67 20 74 6f 20 64 6f 20 73 75 63 68 20 61  ing to do such a
4f70: 20 74 68 69 6e 67 2c 20 79 6f 75 20 61 72 65 20   thing, you are 
4f80: 61 6e 79 77 61 79 20 66 72 65 65 20 74 6f 20 75  anyway free to u
4f90: 73 65 20 74 68 65 20 70 72 6f 6a 2d 73 74 72 69  se the proj-stri
4fa0: 6e 67 73 20 28 3c 69 3e 6d 65 74 68 6f 64 3c 2f  ngs (<i>method</
4fb0: 69 3e 3d 3c 62 3e 70 72 6f 6a 34 74 65 78 74 3c  i>=<b>proj4text<
4fc0: 2f 62 3e 29 20 6f 72 20 74 68 65 20 57 4b 54 20  /b>) or the WKT 
4fd0: 64 65 66 69 6e 69 74 69 6f 6e 73 20 28 3c 69 3e  definitions (<i>
4fe0: 6d 65 74 68 6f 64 3c 2f 69 3e 3d 3c 62 3e 73 72  method</i>=<b>sr
4ff0: 74 65 78 3c 2f 62 3e 74 29 20 73 74 6f 72 65 64  tex</b>t) stored
5000: 20 69 6e 74 6f 20 74 68 65 20 69 6e 74 65 72 6e   into the intern
5010: 61 6c 20 74 61 62 6c 65 20 3c 62 3e 73 70 61 74  al table <b>spat
5020: 69 61 6c 5f 72 65 66 5f 73 79 73 20 74 61 62 6c  ial_ref_sys tabl
5030: 65 3c 2f 62 3e 2e 3c 62 72 3e 0d 0a 42 75 74 20  e</b>.<br>..But 
5040: 74 68 69 73 20 69 73 20 75 6e 64 65 72 20 79 6f  this is under yo
5050: 75 72 20 66 75 6c 6c 20 72 65 73 70 6f 6e 73 69  ur full responsi
5060: 62 69 6c 69 74 79 2c 20 61 6e 64 20 79 6f 75 20  bility, and you 
5070: 6d 75 73 74 20 62 65 20 77 65 6c 6c 20 73 65 6c  must be well sel
5080: 66 2d 63 6f 6e 73 63 69 6f 75 73 20 6f 66 20 77  f-conscious of w
5090: 68 61 74 20 61 72 65 20 79 6f 75 20 64 6f 69 6e  hat are you doin
50a0: 67 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f  g.</li>..</ul></
50b0: 6c 69 3e 0d 0a 3c 6c 69 3e 53 70 61 74 69 61 4c  li>..<li>SpatiaL
50c0: 69 74 65 20 65 6e 63 6f 75 72 61 67 65 73 20 61  ite encourages a
50d0: 6e 64 20 70 72 6f 6d 6f 74 65 73 20 74 68 65 20  nd promotes the 
50e0: 6d 6f 73 74 20 63 72 65 61 74 69 76 65 20 75 73  most creative us
50f0: 65 73 20 6f 66 20 50 52 4f 4a 2e 36 2c 20 74 68  es of PROJ.6, th
5100: 69 73 20 69 6e 63 6c 75 64 69 6e 67 20 3c 62 3e  is including <b>
5110: 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70  transformation p
5120: 69 70 65 6c 69 6e 65 73 3c 2f 62 3e 2e 3c 62 72  ipelines</b>.<br
5130: 3e 0d 0a 43 6f 72 72 65 63 74 6c 79 20 75 73 69  >..Correctly usi
5140: 6e 67 20 3c 69 3e 6d 65 74 68 6f 64 3c 2f 69 3e  ng <i>method</i>
5150: 3d 3c 62 3e 70 72 6f 6a 5f 73 74 72 69 6e 67 3c  =<b>proj_string<
5160: 2f 62 3e 20 66 6f 72 20 63 6f 6d 70 75 74 69 6e  /b> for computin
5170: 67 20 63 75 73 74 6f 6d 20 74 72 61 6e 73 66 6f  g custom transfo
5180: 72 6d 61 74 69 6f 6e 73 20 69 73 6e 27 74 20 6e  rmations isn't n
5190: 65 63 65 73 73 61 72 69 6c 79 20 73 69 6d 70 6c  ecessarily simpl
51a0: 65 20 61 6e 64 20 65 61 73 79 2c 20 62 75 74 20  e and easy, but 
51b0: 69 74 27 73 20 61 20 62 69 67 20 6f 70 70 6f 72  it's a big oppor
51c0: 74 75 6e 69 74 79 20 66 6f 72 20 61 6c 6c 20 73  tunity for all s
51d0: 6b 69 6c 6c 65 64 20 61 6e 64 20 74 61 6c 65 6e  killed and talen
51e0: 74 65 64 20 70 6f 77 65 72 20 75 73 65 72 73 2e  ted power users.
51f0: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e  </li>..</ul><br>
5200: 3c 62 72 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e  <br>..</td></tr>
5210: 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a  ..</table><br>..
5220: 46 65 77 20 70 72 61 63 74 69 63 61 6c 20 53 51  Few practical SQ
5230: 4c 20 65 78 61 6d 70 6c 65 73 3a 0d 0a 3c 76 65  L examples:..<ve
5240: 72 62 61 74 69 6d 3e 0d 0a 2d 2d 20 74 6f 20 45  rbatim>..-- to E
5250: 50 53 47 3a 33 30 30 33 20 2d 20 64 65 66 61 75  PSG:3003 - defau
5260: 6c 74 20 73 65 74 74 69 6e 67 73 3b 20 69 67 6e  lt settings; ign
5270: 6f 72 69 6e 67 20 73 70 61 74 69 61 6c 69 74 65  oring spatialite
5280: 5f 72 65 66 5f 73 79 73 20 61 6e 64 20 75 73 69  _ref_sys and usi
5290: 6e 67 20 74 68 65 20 50 52 4f 4a 2e 36 20 6f 77  ng the PROJ.6 ow
52a0: 6e 20 70 72 69 76 61 74 65 20 64 61 74 61 62 61  n private databa
52b0: 73 65 0d 0a 53 45 4c 45 43 54 20 41 73 45 57 4b  se..SELECT AsEWK
52c0: 54 20 28 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d  T ( ST_Transform
52d0: 28 20 4d 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e  ( MakePoint( 11.
52e0: 38 37 38 30 35 36 20 2c 20 34 33 2e 34 36 33 30  878056 , 43.4630
52f0: 35 36 20 2c 20 34 33 32 36 20 29 20 2c 20 33 30  56 , 4326 ) , 30
5300: 30 33 20 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d  03 ));..--------
5310: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
5320: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53  -------------..S
5330: 52 49 44 3d 33 30 30 33 3b 50 4f 49 4e 54 28 31  RID=3003;POINT(1
5340: 37 33 32 38 35 32 2e 39 34 32 37 31 36 37 36 39  732852.942716769
5350: 20 34 38 31 36 32 37 37 2e 36 31 37 36 39 30 36   4816277.6176906
5360: 37 34 29 0d 0a 0d 0a 2d 2d 20 74 6f 20 45 50 53  74)....-- to EPS
5370: 47 3a 33 30 30 33 20 2d 20 4e 55 4c 4c 20 61 72  G:3003 - NULL ar
5380: 65 61 20 6f 66 20 75 73 65 2c 20 75 73 69 6e 67  ea of use, using
5390: 20 57 4b 54 20 64 65 66 69 6e 69 74 69 6f 6e 73   WKT definitions
53a0: 20 66 72 6f 6d 20 73 70 61 74 69 61 6c 5f 72 65   from spatial_re
53b0: 66 5f 73 79 73 2e 73 72 74 65 78 74 0d 0a 53 45  f_sys.srtext..SE
53c0: 4c 45 43 54 20 41 73 45 57 4b 54 20 28 20 53 54  LECT AsEWKT ( ST
53d0: 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d 61 6b 65  _Transform( Make
53e0: 50 6f 69 6e 74 28 20 31 31 2e 38 37 38 30 35 36  Point( 11.878056
53f0: 20 2c 20 34 33 2e 34 36 33 30 35 36 2c 20 34 33   , 43.463056, 43
5400: 32 36 20 29 20 2c 20 33 30 30 33 20 2c 20 4e 55  26 ) , 3003 , NU
5410: 4c 4c 20 2c 20 27 73 72 74 65 78 74 27 20 29 29  LL , 'srtext' ))
5420: 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ;..-------------
5430: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
5440: 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52 49 44 3d 33  --------..SRID=3
5450: 30 30 33 3b 50 4f 49 4e 54 28 31 37 33 32 38 35  003;POINT(173285
5460: 32 2e 39 34 32 37 31 36 37 36 39 20 34 38 31 36  2.942716769 4816
5470: 32 37 37 2e 36 31 37 36 39 30 36 37 34 29 0d 0a  277.617690674)..
5480: 0d 0a 2d 2d 20 74 6f 20 45 50 53 47 3a 33 30 30  ..-- to EPSG:300
5490: 33 20 2d 20 4e 55 4c 4c 20 61 72 65 61 20 6f 66  3 - NULL area of
54a0: 20 75 73 65 2c 20 75 73 69 6e 67 20 70 72 6f 6a   use, using proj
54b0: 2d 73 74 72 69 6e 67 20 64 65 66 69 6e 69 74 69  -string definiti
54c0: 6f 6e 73 20 66 72 6f 6d 20 73 70 61 74 69 61 6c  ons from spatial
54d0: 5f 72 65 66 5f 73 79 73 2e 70 72 6f 6a 34 74 65  _ref_sys.proj4te
54e0: 78 74 0d 0a 53 45 4c 45 43 54 20 41 73 45 57 4b  xt..SELECT AsEWK
54f0: 54 20 28 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d  T ( ST_Transform
5500: 28 20 4d 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e  ( MakePoint( 11.
5510: 38 37 38 30 35 36 20 2c 20 34 33 2e 34 36 33 30  878056 , 43.4630
5520: 35 36 2c 20 34 33 32 36 20 29 20 2c 20 33 30 30  56, 4326 ) , 300
5530: 33 20 2c 20 4e 55 4c 4c 20 2c 20 27 70 72 6f 6a  3 , NULL , 'proj
5540: 34 74 65 78 74 27 20 29 29 3b 0d 0a 2d 2d 2d 2d  4text' ));..----
5550: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
5560: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
5570: 2d 0d 0a 53 52 49 44 3d 33 30 30 33 3b 50 4f 49  -..SRID=3003;POI
5580: 4e 54 28 31 37 33 32 38 35 32 2e 39 34 32 37 31  NT(1732852.94271
5590: 36 37 36 39 20 34 38 31 36 32 37 37 2e 36 31 37  6769 4816277.617
55a0: 36 39 30 36 37 34 29 0d 0a 3c 2f 76 65 72 62 61  690674)..</verba
55b0: 74 69 6d 3e 0d 0a 54 68 69 73 20 66 69 72 73 74  tim>..This first
55c0: 20 74 65 73 74 20 69 73 20 62 61 73 65 64 20 6f   test is based o
55d0: 6e 20 61 20 6e 65 77 20 53 70 61 74 69 61 4c 69  n a new SpatiaLi
55e0: 74 65 20 64 61 74 61 62 61 73 65 20 63 72 65 61  te database crea
55f0: 74 65 64 20 77 69 74 68 20 66 75 6c 6c 20 50 52  ted with full PR
5600: 4f 4a 2e 36 20 73 75 70 70 6f 72 74 2e 20 54 68  OJ.6 support. Th
5610: 65 72 65 20 69 73 6e 27 74 20 61 6e 79 74 68 69  ere isn't anythi
5620: 6e 67 20 77 6f 72 74 68 20 74 6f 20 62 65 20 6e  ng worth to be n
5630: 6f 74 65 64 2c 20 65 78 63 65 70 74 20 74 68 61  oted, except tha
5640: 74 20 61 6c 6c 20 6d 65 74 68 6f 64 73 20 72 65  t all methods re
5650: 74 75 72 6e 20 74 68 65 20 73 61 6d 65 20 72 65  turn the same re
5660: 73 75 6c 74 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c  sult.<br><br>..<
5670: 76 65 72 62 61 74 69 6d 3e 0d 0a 2d 2d 20 74 6f  verbatim>..-- to
5680: 20 45 50 53 47 3a 33 30 30 33 20 2d 20 75 73 69   EPSG:3003 - usi
5690: 6e 67 20 61 20 74 72 61 6e 73 66 6f 72 6d 61 74  ng a transformat
56a0: 69 6f 6e 20 70 69 70 65 6c 69 6e 65 0d 0a 53 45  ion pipeline..SE
56b0: 4c 45 43 54 20 41 73 45 57 4b 54 20 28 20 53 54  LECT AsEWKT ( ST
56c0: 5f 54 72 61 6e 73 66 6f 72 6d 28 20 53 77 61 70  _Transform( Swap
56d0: 43 6f 6f 72 64 73 20 28 20 4d 61 6b 65 50 6f 69  Coords ( MakePoi
56e0: 6e 74 28 20 31 31 2e 38 37 38 30 35 36 20 2c 20  nt( 11.878056 , 
56f0: 34 33 2e 34 36 33 30 35 36 2c 20 34 33 32 36 20  43.463056, 4326 
5700: 29 20 29 20 2c 20 33 30 30 33 20 2c 20 4e 55 4c  ) ) , 3003 , NUL
5710: 4c 20 2c 20 27 70 72 6f 6a 5f 73 74 72 69 6e 67  L , 'proj_string
5720: 27 20 2c 0d 0a 27 2b 70 72 6f 6a 3d 70 69 70 65  ' ,..'+proj=pipe
5730: 6c 69 6e 65 20 0d 0a 2b 73 74 65 70 20 2b 70 72  line ..+step +pr
5740: 6f 6a 3d 61 78 69 73 73 77 61 70 20 2b 6f 72 64  oj=axisswap +ord
5750: 65 72 3d 32 2c 31 20 0d 0a 2b 73 74 65 70 20 2b  er=2,1 ..+step +
5760: 70 72 6f 6a 3d 75 6e 69 74 63 6f 6e 76 65 72 74  proj=unitconvert
5770: 20 2b 78 79 5f 69 6e 3d 64 65 67 20 2b 78 79 5f   +xy_in=deg +xy_
5780: 6f 75 74 3d 72 61 64 20 0d 0a 2b 73 74 65 70 20  out=rad ..+step 
5790: 2b 70 72 6f 6a 3d 70 75 73 68 20 2b 76 5f 33 20  +proj=push +v_3 
57a0: 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 63 61  ..+step +proj=ca
57b0: 72 74 20 2b 65 6c 6c 70 73 3d 57 47 53 38 34 20  rt +ellps=WGS84 
57c0: 0d 0a 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 72  ..+step +inv +pr
57d0: 6f 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 3d 2d 31  oj=helmert +x=-1
57e0: 30 34 2e 31 20 2b 79 3d 2d 34 39 2e 31 20 2b 7a  04.1 +y=-49.1 +z
57f0: 3d 2d 39 2e 39 20 2b 72 78 3d 30 2e 39 37 31 20  =-9.9 +rx=0.971 
5800: 2b 72 79 3d 2d 32 2e 39 31 37 20 2b 72 7a 3d 30  +ry=-2.917 +rz=0
5810: 2e 37 31 34 20 2b 73 3d 2d 31 31 2e 36 38 20 2b  .714 +s=-11.68 +
5820: 63 6f 6e 76 65 6e 74 69 6f 6e 3d 70 6f 73 69 74  convention=posit
5830: 69 6f 6e 5f 76 65 63 74 6f 72 20 0d 0a 2b 73 74  ion_vector ..+st
5840: 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d 63 61  ep +inv +proj=ca
5850: 72 74 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20 0d  rt +ellps=intl .
5860: 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 6f 70  .+step +proj=pop
5870: 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70   +v_3 ..+step +p
5880: 72 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 5f 30  roj=tmerc +lat_0
5890: 3d 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 30  =0 +lon_0=9 +k=0
58a0: 2e 39 39 39 36 20 2b 78 5f 30 3d 31 35 30 30 30  .9996 +x_0=15000
58b0: 30 30 20 2b 79 5f 30 3d 30 20 2b 65 6c 6c 70 73  00 +y_0=0 +ellps
58c0: 3d 69 6e 74 6c 27 20 29 29 3b 0d 0a 2d 2d 2d 2d  =intl' ));..----
58d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
58e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
58f0: 2d 0d 0a 53 52 49 44 3d 33 30 30 33 3b 50 4f 49  -..SRID=3003;POI
5900: 4e 54 28 31 37 33 32 38 35 32 2e 39 34 32 37 31  NT(1732852.94271
5910: 36 37 36 39 20 34 38 31 36 32 37 37 2e 36 31 37  6769 4816277.617
5920: 36 39 30 36 37 34 29 0d 0a 0d 0a 2d 2d 20 74 6f  690674)....-- to
5930: 20 45 50 53 47 3a 33 30 30 33 20 2d 20 75 73 69   EPSG:3003 - usi
5940: 6e 67 20 61 20 63 75 73 74 6f 6d 69 7a 65 64 20  ng a customized 
5950: 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70  transformation p
5960: 69 70 65 6c 69 6e 65 0d 0a 53 45 4c 45 43 54 20  ipeline..SELECT 
5970: 41 73 45 57 4b 54 20 28 20 53 54 5f 54 72 61 6e  AsEWKT ( ST_Tran
5980: 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 6e 74  sform( MakePoint
5990: 28 20 31 31 2e 38 37 38 30 35 36 20 2c 20 34 33  ( 11.878056 , 43
59a0: 2e 34 36 33 30 35 36 2c 20 34 33 32 36 20 29 20  .463056, 4326 ) 
59b0: 2c 20 33 30 30 33 20 2c 20 4e 55 4c 4c 20 2c 20  , 3003 , NULL , 
59c0: 27 70 72 6f 6a 5f 73 74 72 69 6e 67 27 20 2c 0d  'proj_string' ,.
59d0: 0a 27 2b 70 72 6f 6a 3d 70 69 70 65 6c 69 6e 65  .'+proj=pipeline
59e0: 20 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d    ..+step +proj=
59f0: 75 6e 69 74 63 6f 6e 76 65 72 74 20 2b 78 79 5f  unitconvert +xy_
5a00: 69 6e 3d 64 65 67 20 2b 78 79 5f 6f 75 74 3d 72  in=deg +xy_out=r
5a10: 61 64 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a  ad ..+step +proj
5a20: 3d 70 75 73 68 20 2b 76 5f 33 20 0d 0a 2b 73 74  =push +v_3 ..+st
5a30: 65 70 20 2b 70 72 6f 6a 3d 63 61 72 74 20 2b 65  ep +proj=cart +e
5a40: 6c 6c 70 73 3d 57 47 53 38 34 20 0d 0a 2b 73 74  llps=WGS84 ..+st
5a50: 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d 68 65  ep +inv +proj=he
5a60: 6c 6d 65 72 74 20 2b 78 3d 2d 31 30 34 2e 31 20  lmert +x=-104.1 
5a70: 2b 79 3d 2d 34 39 2e 31 20 2b 7a 3d 2d 39 2e 39  +y=-49.1 +z=-9.9
5a80: 20 2b 72 78 3d 30 2e 39 37 31 20 2b 72 79 3d 2d   +rx=0.971 +ry=-
5a90: 32 2e 39 31 37 20 2b 72 7a 3d 30 2e 37 31 34 20  2.917 +rz=0.714 
5aa0: 2b 73 3d 2d 31 31 2e 36 38 20 2b 63 6f 6e 76 65  +s=-11.68 +conve
5ab0: 6e 74 69 6f 6e 3d 70 6f 73 69 74 69 6f 6e 5f 76  ntion=position_v
5ac0: 65 63 74 6f 72 20 0d 0a 2b 73 74 65 70 20 2b 69  ector ..+step +i
5ad0: 6e 76 20 2b 70 72 6f 6a 3d 63 61 72 74 20 2b 65  nv +proj=cart +e
5ae0: 6c 6c 70 73 3d 69 6e 74 6c 20 0d 0a 2b 73 74 65  llps=intl ..+ste
5af0: 70 20 2b 70 72 6f 6a 3d 70 6f 70 20 2b 76 5f 33  p +proj=pop +v_3
5b00: 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 74   ..+step +proj=t
5b10: 6d 65 72 63 20 2b 6c 61 74 5f 30 3d 30 20 2b 6c  merc +lat_0=0 +l
5b20: 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 2e 39 39 39 36  on_0=9 +k=0.9996
5b30: 20 2b 78 5f 30 3d 31 35 30 30 30 30 30 20 2b 79   +x_0=1500000 +y
5b40: 5f 30 3d 30 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c  _0=0 +ellps=intl
5b50: 27 20 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d  ' ));..---------
5b60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
5b70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52  ------------..SR
5b80: 49 44 3d 33 30 30 33 3b 50 4f 49 4e 54 28 31 37  ID=3003;POINT(17
5b90: 33 32 38 35 32 2e 39 34 32 37 31 36 37 36 39 20  32852.942716769 
5ba0: 34 38 31 36 32 37 37 2e 36 31 37 36 39 30 36 37  4816277.61769067
5bb0: 34 29 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d  4)..</verbatim>.
5bc0: 0a 54 68 69 73 20 73 65 63 6f 6e 64 20 74 65 73  .This second tes
5bd0: 74 20 69 73 20 62 61 73 65 64 20 6f 6e 20 75 73  t is based on us
5be0: 69 6e 67 20 3c 62 3e 3c 69 3e 74 72 61 6e 73 66  ing <b><i>transf
5bf0: 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 6c 69 6e  ormation pipelin
5c00: 65 73 3c 2f 69 3e 3c 2f 62 3e 3a 0d 0a 3c 75 6c  es</i></b>:..<ul
5c10: 3e 0d 0a 3c 6c 69 3e 74 68 65 20 66 69 72 73 74  >..<li>the first
5c20: 20 71 75 65 72 79 20 64 69 72 65 63 74 6c 79 20   query directly 
5c30: 75 73 65 73 20 61 20 70 72 6f 6a 2d 73 74 72 69  uses a proj-stri
5c40: 6e 67 20 72 65 70 72 65 73 65 6e 74 69 6e 67 20  ng representing 
5c50: 74 68 65 20 70 69 70 65 6c 69 6e 65 20 61 73 20  the pipeline as 
5c60: 64 65 66 69 6e 65 64 20 62 79 20 65 78 65 63 75  defined by execu
5c70: 74 69 6e 67 3c 62 72 3e 0d 0a 3c 62 3e 70 72 6f  ting<br>..<b>pro
5c80: 6a 69 6e 66 6f 20 20 2d 73 20 45 50 53 47 3a 34  jinfo  -s EPSG:4
5c90: 33 32 36 20 2d 74 20 45 50 53 47 3a 33 30 30 33  326 -t EPSG:3003
5ca0: 20 2d 2d 61 72 65 61 20 20 22 49 74 61 6c 79 20   --area  "Italy 
5cb0: 2d 20 6d 61 69 6e 6c 61 6e 64 22 20 2d 6f 20 70  - mainland" -o p
5cc0: 72 6f 6a 3c 2f 62 3e 3c 62 72 3e 0d 0a 28 77 65  roj</b><br>..(we
5cd0: 27 6c 6c 20 73 65 65 20 74 68 69 73 20 74 6f 70  'll see this top
5ce0: 69 63 20 69 6e 20 6d 6f 72 65 20 64 65 70 74 68  ic in more depth
5cf0: 20 6f 6e 20 74 68 65 20 6e 65 78 74 20 70 61 72   on the next par
5d00: 61 67 72 61 70 68 29 2e 3c 2f 6c 69 3e 0d 0a 3c  agraph).</li>..<
5d10: 6c 69 3e 74 68 65 20 73 65 63 6f 6e 64 20 71 75  li>the second qu
5d20: 65 72 79 20 69 73 20 6a 75 73 74 20 61 20 73 6d  ery is just a sm
5d30: 61 6c 6c 20 61 64 61 70 74 61 74 69 6f 6e 20 6f  all adaptation o
5d40: 66 20 74 68 65 20 66 69 72 73 74 20 6f 6e 65 3a  f the first one:
5d50: 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 41 73 20 79  ..<ul>..<li>As y
5d60: 6f 75 20 63 61 6e 20 6e 6f 74 69 63 65 20 74 68  ou can notice th
5d70: 65 20 66 69 72 73 74 20 71 75 65 72 79 20 72 65  e first query re
5d80: 71 75 69 72 65 73 20 63 61 6c 6c 69 6e 67 20 3c  quires calling <
5d90: 62 3e 53 77 61 70 43 6f 6f 64 69 6e 61 74 65 73  b>SwapCoodinates
5da0: 28 29 3c 2f 62 3e 20 62 65 63 61 75 73 65 20 74  ()</b> because t
5db0: 68 65 20 66 69 72 73 74 20 73 74 65 70 20 6f 66  he first step of
5dc0: 20 74 68 65 20 70 69 70 65 6c 69 6e 65 20 68 61   the pipeline ha
5dd0: 73 20 61 6e 20 3c 62 3e 61 78 69 73 73 77 61 70  s an <b>axisswap
5de0: 3c 2f 62 3e 20 64 69 72 65 63 74 69 76 65 2e 3c  </b> directive.<
5df0: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 54 68 65 20 73 65  /li>..<li>The se
5e00: 63 6f 6e 64 20 71 75 65 72 79 20 6a 75 73 74 20  cond query just 
5e10: 61 76 6f 69 64 73 20 74 6f 20 63 61 6c 6c 20 3c  avoids to call <
5e20: 62 3e 53 77 61 70 43 6f 6f 72 64 73 28 29 3c 2f  b>SwapCoords()</
5e30: 62 3e 20 61 6e 64 20 63 6f 6e 73 65 71 75 65 6e  b> and consequen
5e40: 74 6c 79 20 74 68 65 20 74 72 61 73 66 6f 72 6d  tly the trasform
5e50: 61 74 69 6f 6e 20 70 69 70 65 6c 69 6e 65 20 73  ation pipeline s
5e60: 74 65 70 20 72 65 6d 6f 76 65 73 20 74 68 69 73  tep removes this
5e70: 20 66 69 72 73 74 20 73 74 65 70 20 73 6f 20 74   first step so t
5e80: 6f 20 67 65 74 20 74 68 65 20 73 61 6d 65 20 69  o get the same i
5e90: 64 65 6e 74 69 63 61 6c 20 6f 76 65 72 61 6c 6c  dentical overall
5ea0: 20 65 66 66 65 63 74 2e 3c 2f 6c 69 3e 0d 0a 3c   effect.</li>..<
5eb0: 2f 75 6c 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c  /ul></li>..<li><
5ec0: 62 3e 3c 75 3e 4e 6f 74 65 3c 2f 75 3e 3c 2f 62  b><u>Note</u></b
5ed0: 3e 3a 20 53 70 61 74 69 61 4c 69 74 65 20 77 69  >: SpatiaLite wi
5ee0: 6c 6c 20 61 6c 77 61 79 73 20 64 6f 20 61 20 62  ll always do a b
5ef0: 65 73 74 20 65 66 66 6f 72 74 20 69 6e 20 6f 72  est effort in or
5f00: 64 65 72 20 74 6f 20 67 75 65 73 73 20 69 66 20  der to guess if 
5f10: 73 77 61 70 70 69 6e 67 20 74 68 65 20 63 6f 6f  swapping the coo
5f20: 72 64 69 6e 61 74 65 73 20 62 65 66 6f 72 65 20  rdinates before 
5f30: 70 61 73 73 69 6e 67 20 74 68 65 6d 20 74 6f 20  passing them to 
5f40: 50 52 4f 4a 2e 36 20 69 73 20 72 65 71 75 69 72  PROJ.6 is requir
5f50: 65 64 20 6f 72 20 6e 6f 74 2e 3c 62 72 3e 0d 0a  ed or not.<br>..
5f60: 42 75 74 20 69 6e 20 74 68 65 20 73 70 65 63 69  But in the speci
5f70: 66 69 63 20 63 61 73 65 20 6f 66 20 61 20 74 72  fic case of a tr
5f80: 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70  ansformation pip
5f90: 65 6c 69 6e 65 20 74 68 69 73 20 74 65 73 74 20  eline this test 
5fa0: 6d 61 79 20 65 61 73 69 6c 79 20 66 61 69 6c 2c  may easily fail,
5fb0: 20 74 68 75 73 20 72 65 71 75 69 72 69 6e 67 20   thus requiring 
5fc0: 74 6f 20 65 78 70 6c 69 63 69 74 6c 79 20 63 61  to explicitly ca
5fd0: 6c 6c 20 3c 62 3e 53 77 61 70 43 6f 6f 72 64 73  ll <b>SwapCoords
5fe0: 28 29 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75  ()</b></li>..</u
5ff0: 6c 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63  l><br>..<table c
6000: 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63  ellspacing="8" c
6010: 65 6c 6c 70 61 64 64 69 6e 67 3d 22 31 36 22 20  ellpadding="16" 
6020: 62 67 63 6f 6c 6f 72 3d 22 23 63 39 66 66 66 30  bgcolor="#c9fff0
6030: 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 68  ">..<tr><td>..<h
6040: 33 3e 75 73 69 6e 67 20 70 72 6f 6a 69 6e 66 6f  3>using projinfo
6050: 20 66 6f 72 20 64 65 74 65 63 74 69 6e 67 20 74   for detecting t
6060: 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69  ransformation pi
6070: 70 65 6c 69 6e 65 73 20 61 6e 64 20 73 75 70 70  pelines and supp
6080: 6f 72 74 65 64 20 61 72 65 61 73 20 6f 66 20 75  orted areas of u
6090: 73 65 3c 2f 68 33 3e 0d 0a 3c 76 65 72 62 61 74  se</h3>..<verbat
60a0: 69 6d 3e 0d 0a 70 72 6f 6a 69 6e 66 6f 20 2d 73  im>..projinfo -s
60b0: 20 45 50 53 47 3a 34 33 32 36 20 2d 74 20 45 50   EPSG:4326 -t EP
60c0: 53 47 3a 33 30 30 33 20 2d 6f 20 70 72 6f 6a 20  SG:3003 -o proj 
60d0: 2d 2d 73 70 61 74 69 61 6c 2d 74 65 73 74 20 69  --spatial-test i
60e0: 6e 74 65 72 73 65 63 74 0d 0a 43 61 6e 64 69 64  ntersect..Candid
60f0: 61 74 65 20 6f 70 65 72 61 74 69 6f 6e 73 20 66  ate operations f
6100: 6f 75 6e 64 3a 20 33 0d 0a 2d 2d 2d 2d 2d 2d 2d  ound: 3..-------
6110: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
6120: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a  --------------..
6130: 4f 70 65 72 61 74 69 6f 6e 20 6e c2 b0 31 3a 0d  Operation n..1:.
6140: 0a 0d 0a 75 6e 6b 6e 6f 77 6e 20 69 64 2c 20 49  ...unknown id, I
6150: 6e 76 65 72 73 65 20 6f 66 20 4d 6f 6e 74 65 20  nverse of Monte 
6160: 4d 61 72 69 6f 20 74 6f 20 57 47 53 20 38 34 20  Mario to WGS 84 
6170: 28 34 29 20 2b 20 49 74 61 6c 79 20 7a 6f 6e 65  (4) + Italy zone
6180: 20 31 2c 20 34 20 6d 2c 20 49 74 61 6c 79 20 2d   1, 4 m, Italy -
6190: 20 6d 61 69 6e 6c 61 6e 64 0d 0a 0d 0a 50 52 4f   mainland....PRO
61a0: 4a 20 73 74 72 69 6e 67 3a 0d 0a 2b 70 72 6f 6a  J string:..+proj
61b0: 3d 70 69 70 65 6c 69 6e 65 20 0d 0a 2b 73 74 65  =pipeline ..+ste
61c0: 70 20 2b 70 72 6f 6a 3d 61 78 69 73 73 77 61 70  p +proj=axisswap
61d0: 20 2b 6f 72 64 65 72 3d 32 2c 31 20 0d 0a 2b 73   +order=2,1 ..+s
61e0: 74 65 70 20 2b 70 72 6f 6a 3d 75 6e 69 74 63 6f  tep +proj=unitco
61f0: 6e 76 65 72 74 20 2b 78 79 5f 69 6e 3d 64 65 67  nvert +xy_in=deg
6200: 20 2b 78 79 5f 6f 75 74 3d 72 61 64 20 0d 0a 2b   +xy_out=rad ..+
6210: 73 74 65 70 20 2b 70 72 6f 6a 3d 70 75 73 68 20  step +proj=push 
6220: 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72  +v_3 ..+step +pr
6230: 6f 6a 3d 63 61 72 74 20 2b 65 6c 6c 70 73 3d 57  oj=cart +ellps=W
6240: 47 53 38 34 20 0d 0a 2b 73 74 65 70 20 2b 69 6e  GS84 ..+step +in
6250: 76 20 2b 70 72 6f 6a 3d 68 65 6c 6d 65 72 74 20  v +proj=helmert 
6260: 2b 78 3d 2d 31 30 34 2e 31 20 2b 79 3d 2d 34 39  +x=-104.1 +y=-49
6270: 2e 31 20 2b 7a 3d 2d 39 2e 39 20 2b 72 78 3d 30  .1 +z=-9.9 +rx=0
6280: 2e 39 37 31 20 2b 72 79 3d 2d 32 2e 39 31 37 20  .971 +ry=-2.917 
6290: 2b 72 7a 3d 30 2e 37 31 34 20 2b 73 3d 2d 31 31  +rz=0.714 +s=-11
62a0: 2e 36 38 20 2b 63 6f 6e 76 65 6e 74 69 6f 6e 3d  .68 +convention=
62b0: 70 6f 73 69 74 69 6f 6e 5f 76 65 63 74 6f 72 20  position_vector 
62c0: 0d 0a 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 72  ..+step +inv +pr
62d0: 6f 6a 3d 63 61 72 74 20 2b 65 6c 6c 70 73 3d 69  oj=cart +ellps=i
62e0: 6e 74 6c 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f  ntl ..+step +pro
62f0: 6a 3d 70 6f 70 20 2b 76 5f 33 20 0d 0a 2b 73 74  j=pop +v_3 ..+st
6300: 65 70 20 2b 70 72 6f 6a 3d 74 6d 65 72 63 20 2b  ep +proj=tmerc +
6310: 6c 61 74 5f 30 3d 30 20 2b 6c 6f 6e 5f 30 3d 39  lat_0=0 +lon_0=9
6320: 20 2b 6b 3d 30 2e 39 39 39 36 20 2b 78 5f 30 3d   +k=0.9996 +x_0=
6330: 31 35 30 30 30 30 30 20 2b 79 5f 30 3d 30 20 2b  1500000 +y_0=0 +
6340: 65 6c 6c 70 73 3d 69 6e 74 6c 0d 0a 0d 0a 2d 2d  ellps=intl....--
6350: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
6360: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
6370: 2d 2d 2d 0d 0a 4f 70 65 72 61 74 69 6f 6e 20 6e  ---..Operation n
6380: c2 b0 32 3a 0d 0a 0d 0a 75 6e 6b 6e 6f 77 6e 20  ..2:....unknown 
6390: 69 64 2c 20 49 6e 76 65 72 73 65 20 6f 66 20 4d  id, Inverse of M
63a0: 6f 6e 74 65 20 4d 61 72 69 6f 20 74 6f 20 57 47  onte Mario to WG
63b0: 53 20 38 34 20 28 32 29 20 2b 20 49 74 61 6c 79  S 84 (2) + Italy
63c0: 20 7a 6f 6e 65 20 31 2c 20 34 20 6d 2c 20 49 74   zone 1, 4 m, It
63d0: 61 6c 79 20 2d 20 53 61 72 64 69 6e 69 61 20 6f  aly - Sardinia o
63e0: 6e 73 68 6f 72 65 0d 0a 0d 0a 50 52 4f 4a 20 73  nshore....PROJ s
63f0: 74 72 69 6e 67 3a 0d 0a 2b 70 72 6f 6a 3d 70 69  tring:..+proj=pi
6400: 70 65 6c 69 6e 65 20 0d 0a 2b 73 74 65 70 20 2b  peline ..+step +
6410: 70 72 6f 6a 3d 61 78 69 73 73 77 61 70 20 2b 6f  proj=axisswap +o
6420: 72 64 65 72 3d 32 2c 31 20 0d 0a 2b 73 74 65 70  rder=2,1 ..+step
6430: 20 2b 70 72 6f 6a 3d 75 6e 69 74 63 6f 6e 76 65   +proj=unitconve
6440: 72 74 20 2b 78 79 5f 69 6e 3d 64 65 67 20 2b 78  rt +xy_in=deg +x
6450: 79 5f 6f 75 74 3d 72 61 64 20 0d 0a 2b 73 74 65  y_out=rad ..+ste
6460: 70 20 2b 70 72 6f 6a 3d 70 75 73 68 20 2b 76 5f  p +proj=push +v_
6470: 33 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d  3 ..+step +proj=
6480: 63 61 72 74 20 2b 65 6c 6c 70 73 3d 57 47 53 38  cart +ellps=WGS8
6490: 34 20 0d 0a 2b 73 74 65 70 20 2b 69 6e 76 20 2b  4 ..+step +inv +
64a0: 70 72 6f 6a 3d 68 65 6c 6d 65 72 74 20 2b 78 3d  proj=helmert +x=
64b0: 2d 31 36 38 2e 36 20 2b 79 3d 2d 33 34 20 2b 7a  -168.6 +y=-34 +z
64c0: 3d 33 38 2e 36 20 2b 72 78 3d 2d 30 2e 33 37 34  =38.6 +rx=-0.374
64d0: 20 2b 72 79 3d 2d 30 2e 36 37 39 20 2b 72 7a 3d   +ry=-0.679 +rz=
64e0: 2d 31 2e 33 37 39 20 2b 73 3d 2d 39 2e 34 38 20  -1.379 +s=-9.48 
64f0: 2b 63 6f 6e 76 65 6e 74 69 6f 6e 3d 70 6f 73 69  +convention=posi
6500: 74 69 6f 6e 5f 76 65 63 74 6f 72 20 0d 0a 2b 73  tion_vector ..+s
6510: 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a 3d 63  tep +inv +proj=c
6520: 61 72 74 20 2b 65 6c 6c 70 73 3d 69 6e 74 6c 20  art +ellps=intl 
6530: 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 70 6f  ..+step +proj=po
6540: 70 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 70 20 2b  p +v_3 ..+step +
6550: 70 72 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61 74 5f  proj=tmerc +lat_
6560: 30 3d 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d  0=0 +lon_0=9 +k=
6570: 30 2e 39 39 39 36 20 2b 78 5f 30 3d 31 35 30 30  0.9996 +x_0=1500
6580: 30 30 30 20 2b 79 5f 30 3d 30 20 2b 65 6c 6c 70  000 +y_0=0 +ellp
6590: 73 3d 69 6e 74 6c 0d 0a 0d 0a 2d 2d 2d 2d 2d 2d  s=intl....------
65a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
65b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d  ---------------.
65c0: 0a 4f 70 65 72 61 74 69 6f 6e 20 6e c2 b0 33 3a  .Operation n..3:
65d0: 0d 0a 0d 0a 75 6e 6b 6e 6f 77 6e 20 69 64 2c 20  ....unknown id, 
65e0: 49 6e 76 65 72 73 65 20 6f 66 20 4d 6f 6e 74 65  Inverse of Monte
65f0: 20 4d 61 72 69 6f 20 74 6f 20 57 47 53 20 38 34   Mario to WGS 84
6600: 20 28 31 31 29 20 2b 20 49 74 61 6c 79 20 7a 6f   (11) + Italy zo
6610: 6e 65 20 31 2c 20 31 30 20 6d 2c 20 49 74 61 6c  ne 1, 10 m, Ital
6620: 79 20 2d 20 53 69 63 69 6c 79 20 53 74 72 61 69  y - Sicily Strai
6630: 74 20 77 65 73 74 20 6f 66 20 31 33 c2 b0 45 0d  t west of 13..E.
6640: 0a 0d 0a 50 52 4f 4a 20 73 74 72 69 6e 67 3a 0d  ...PROJ string:.
6650: 0a 2b 70 72 6f 6a 3d 70 69 70 65 6c 69 6e 65 20  .+proj=pipeline 
6660: 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 61 78  ..+step +proj=ax
6670: 69 73 73 77 61 70 20 2b 6f 72 64 65 72 3d 32 2c  isswap +order=2,
6680: 31 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d  1 ..+step +proj=
6690: 75 6e 69 74 63 6f 6e 76 65 72 74 20 2b 78 79 5f  unitconvert +xy_
66a0: 69 6e 3d 64 65 67 20 2b 78 79 5f 6f 75 74 3d 72  in=deg +xy_out=r
66b0: 61 64 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a  ad ..+step +proj
66c0: 3d 70 75 73 68 20 2b 76 5f 33 20 0d 0a 2b 73 74  =push +v_3 ..+st
66d0: 65 70 20 2b 70 72 6f 6a 3d 63 61 72 74 20 2b 65  ep +proj=cart +e
66e0: 6c 6c 70 73 3d 57 47 53 38 34 20 0d 0a 2b 73 74  llps=WGS84 ..+st
66f0: 65 70 20 2b 70 72 6f 6a 3d 68 65 6c 6d 65 72 74  ep +proj=helmert
6700: 20 2b 78 3d 32 33 30 2e 34 37 20 2b 79 3d 35 36   +x=230.47 +y=56
6710: 2e 30 38 20 2b 7a 3d 2d 32 32 2e 34 33 20 0d 0a  .08 +z=-22.43 ..
6720: 2b 73 74 65 70 20 2b 69 6e 76 20 2b 70 72 6f 6a  +step +inv +proj
6730: 3d 63 61 72 74 20 2b 65 6c 6c 70 73 3d 69 6e 74  =cart +ellps=int
6740: 6c 20 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d  l ..+step +proj=
6750: 70 6f 70 20 2b 76 5f 33 20 0d 0a 2b 73 74 65 70  pop +v_3 ..+step
6760: 20 2b 70 72 6f 6a 3d 74 6d 65 72 63 20 2b 6c 61   +proj=tmerc +la
6770: 74 5f 30 3d 30 20 2b 6c 6f 6e 5f 30 3d 39 20 2b  t_0=0 +lon_0=9 +
6780: 6b 3d 30 2e 39 39 39 36 20 2b 78 5f 30 3d 31 35  k=0.9996 +x_0=15
6790: 30 30 30 30 30 20 2b 79 5f 30 3d 30 20 2b 65 6c  00000 +y_0=0 +el
67a0: 6c 70 73 3d 69 6e 74 6c 0d 0a 3c 2f 76 65 72 62  lps=intl..</verb
67b0: 61 74 69 6d 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72  atim>..</td></tr
67c0: 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d  >..</table><br>.
67d0: 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 2d 2d 20  .<verbatim>..-- 
67e0: 74 6f 20 45 50 53 47 3a 33 30 30 33 20 2d 20 64  to EPSG:3003 - d
67f0: 65 66 61 75 6c 74 20 73 65 74 74 69 6e 67 73 2c  efault settings,
6800: 20 4e 55 4c 4c 20 61 72 65 61 20 6f 66 20 75 73   NULL area of us
6810: 65 2c 20 2d 20 69 67 6e 6f 72 69 6e 67 20 73 70  e, - ignoring sp
6820: 61 74 69 61 6c 69 74 65 5f 72 65 66 5f 73 79 73  atialite_ref_sys
6830: 20 61 6e 64 20 75 73 69 6e 67 20 74 68 65 20 50   and using the P
6840: 52 4f 4a 2e 36 20 6f 77 6e 20 70 72 69 76 61 74  ROJ.6 own privat
6850: 65 20 64 61 74 61 62 61 73 65 0d 0a 53 45 4c 45  e database..SELE
6860: 43 54 20 41 73 45 57 4b 54 20 28 20 53 54 5f 54  CT AsEWKT ( ST_T
6870: 72 61 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f  ransform( MakePo
6880: 69 6e 74 28 20 39 2e 31 36 39 34 36 34 2c 20 33  int( 9.169464, 3
6890: 39 2e 34 37 38 32 37 35 2c 20 34 33 32 36 20 29  9.478275, 4326 )
68a0: 2c 20 33 30 30 33 20 29 29 3b 0d 0a 2d 2d 2d 2d  , 3003 ));..----
68b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
68c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
68d0: 2d 0d 0a 53 52 49 44 3d 33 30 30 33 3b 50 4f 49  -..SRID=3003;POI
68e0: 4e 54 28 31 35 31 34 36 30 30 2e 31 33 34 33 32  NT(1514600.13432
68f0: 31 38 36 32 20 34 33 36 39 38 37 34 2e 34 38 39  1862 4369874.489
6900: 32 36 39 39 35 37 29 0d 0a 0d 0a 2d 2d 20 74 6f  269957)....-- to
6910: 20 45 50 53 47 3a 33 30 30 33 20 2d 20 73 61 6d   EPSG:3003 - sam
6920: 65 20 61 73 20 61 62 6f 76 65 2c 20 62 75 74 20  e as above, but 
6930: 65 78 70 6c 69 63 69 74 6c 79 20 64 65 66 69 6e  explicitly defin
6940: 69 6e 67 20 61 20 73 70 65 63 69 66 69 63 20 61  ing a specific a
6950: 72 65 61 20 6f 66 20 75 73 65 0d 0a 53 45 4c 45  rea of use..SELE
6960: 43 54 20 41 73 45 57 4b 54 20 28 20 53 54 5f 54  CT AsEWKT ( ST_T
6970: 72 61 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f  ransform( MakePo
6980: 69 6e 74 28 20 39 2e 31 36 39 34 36 34 2c 20 33  int( 9.169464, 3
6990: 39 2e 34 37 38 32 37 35 2c 20 34 33 32 36 20 29  9.478275, 4326 )
69a0: 2c 20 33 30 30 33 20 2c 20 42 75 69 6c 64 4d 42  , 3003 , BuildMB
69b0: 52 28 39 2e 31 20 2c 20 33 39 2e 34 20 2c 20 39  R(9.1 , 39.4 , 9
69c0: 2e 32 20 2c 20 33 39 2e 35 20 2c 20 34 33 32 36  .2 , 39.5 , 4326
69d0: 20 29 29 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d   )));..---------
69e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
69f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 53 52  ------------..SR
6a00: 49 44 3d 33 30 30 33 3b 50 4f 49 4e 54 28 31 35  ID=3003;POINT(15
6a10: 31 34 36 30 35 2e 39 38 32 37 36 32 32 34 38 20  14605.982762248 
6a20: 34 33 36 39 38 37 33 2e 30 30 34 32 32 36 39 34  4369873.00422694
6a30: 33 29 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d  3)..</verbatim>.
6a40: 0a 54 68 69 72 64 20 61 6e 64 20 6c 61 73 74 20  .Third and last 
6a50: 65 78 61 6d 70 6c 65 2e 20 49 6e 20 73 6f 6d 65  example. In some
6a60: 20 63 61 73 65 73 20 65 78 70 6c 69 63 69 74 6c   cases explicitl
6a70: 79 20 64 65 66 69 6e 69 6e 67 20 61 20 73 70 65  y defining a spe
6a80: 63 69 66 69 63 20 3c 62 3e 3c 69 3e 61 72 65 61  cific <b><i>area
6a90: 20 6f 66 20 75 73 65 3c 2f 69 3e 3c 2f 62 3e 20   of use</i></b> 
6aa0: 6d 61 79 20 65 6e 61 62 6c 65 20 50 52 4f 4a 2e  may enable PROJ.
6ab0: 36 20 74 6f 20 73 65 6c 65 63 74 20 61 6e 20 6f  6 to select an o
6ac0: 70 74 69 6d 69 7a 65 64 20 74 72 61 6e 73 66 6f  ptimized transfo
6ad0: 72 6d 61 74 69 6f 6e 20 6c 65 61 64 69 6e 67 20  rmation leading 
6ae0: 74 6f 20 6d 6f 72 65 20 70 72 65 63 69 73 65 20  to more precise 
6af0: 72 65 73 75 6c 74 73 2e 3c 62 72 3e 0d 0a 49 6e  results.<br>..In
6b00: 20 74 68 69 73 20 65 78 61 6d 70 6c 65 20 77 65   this example we
6b10: 27 76 65 20 75 73 65 64 20 61 20 50 6f 69 6e 74  've used a Point
6b20: 20 6c 6f 63 61 74 65 64 20 69 6e 20 53 61 72 64   located in Sard
6b30: 69 6e 69 61 2c 20 61 6e 64 20 50 52 4f 4a 2e 36  inia, and PROJ.6
6b40: 20 73 75 70 70 6f 72 74 73 20 73 65 76 65 72 61   supports severa
6b50: 6c 20 66 6c 61 76 6f 72 73 20 6f 66 20 3c 62 3e  l flavors of <b>
6b60: 45 50 53 47 3a 33 30 30 33 3c 2f 62 3e 20 64 65  EPSG:3003</b> de
6b70: 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 73  pending on the s
6b80: 70 65 63 69 66 69 63 20 61 72 65 61 20 6f 66 20  pecific area of 
6b90: 75 73 65 2e 3c 62 72 3e 0d 0a 3c 62 3e 49 74 61  use.<br>..<b>Ita
6ba0: 6c 79 20 2d 20 53 61 72 64 69 6e 69 61 20 6f 6e  ly - Sardinia on
6bb0: 73 68 6f 72 65 3c 2f 62 3e 20 69 73 20 6f 6e 65  shore</b> is one
6bc0: 20 62 65 74 77 65 65 6e 20 74 68 65 6d 2c 20 73   between them, s
6bd0: 6f 20 61 66 74 65 72 20 73 70 65 63 69 66 79 69  o after specifyi
6be0: 6e 67 20 61 6e 20 65 78 70 6c 69 63 69 74 20 3c  ng an explicit <
6bf0: 62 3e 61 72 65 61 20 6f 66 20 75 73 65 3c 2f 62  b>area of use</b
6c00: 3e 20 61 20 6d 6f 72 65 20 70 72 65 63 69 73 65  > a more precise
6c10: 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20   transformation 
6c20: 70 69 70 65 6c 69 6e 65 20 77 61 73 20 73 65 6c  pipeline was sel
6c30: 65 63 74 65 64 2e 3c 62 72 3e 3c 62 72 3e 0d 0a  ected.<br><br>..
6c40: 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 69  <table cellspaci
6c50: 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 69  ng="8" cellpaddi
6c60: 6e 67 3d 22 31 36 22 20 62 67 63 6f 6c 6f 72 3d  ng="16" bgcolor=
6c70: 22 23 66 66 66 66 64 30 22 3e 0d 0a 3c 74 72 3e  "#ffffd0">..<tr>
6c80: 3c 74 64 3e 0d 0a 3c 62 3e 3c 75 3e 4c 65 73 73  <td>..<b><u>Less
6c90: 6f 6e 20 6c 65 61 72 6e 65 64 3c 2f 75 3e 3c 2f  on learned</u></
6ca0: 62 3e 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 54  b>:..<ul>..<li>T
6cb0: 68 65 20 62 65 73 74 20 6d 6f 64 65 20 66 6f 72  he best mode for
6cc0: 20 74 61 6b 69 6e 67 20 66 75 6c 6c 20 70 72 6f   taking full pro
6cd0: 66 69 74 20 66 72 6f 6d 20 50 52 4f 4a 2e 36 20  fit from PROJ.6 
6ce0: 69 73 20 62 79 20 75 73 69 6e 67 20 3c 69 3e 6d  is by using <i>m
6cf0: 65 74 68 6f 64 3c 2f 69 3e 3d 3c 62 3e 61 75 74  ethod</i>=<b>aut
6d00: 68 5f 6e 61 6d 65 3a 61 75 74 68 5f 73 72 69 64  h_name:auth_srid
6d10: 3c 2f 62 3e 20 28 74 68 61 74 20 69 73 20 74 68  </b> (that is th
6d20: 65 20 3c 62 3e 3c 69 3e 64 65 66 61 75 6c 74 20  e <b><i>default 
6d30: 73 65 74 74 69 6e 67 3c 2f 69 3e 3c 2f 62 3e 29  setting</i></b>)
6d40: 2e 3c 62 72 3e 0d 0a 54 68 69 73 20 77 61 79 20  .<br>..This way 
6d50: 79 6f 75 27 6c 6c 20 62 65 20 61 62 73 6f 6c 75  you'll be absolu
6d60: 74 65 6c 79 20 73 75 72 65 20 74 68 61 74 20 74  tely sure that t
6d70: 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 61  he most recent a
6d80: 6e 64 20 66 75 6c 6c 79 20 64 65 74 61 69 6c 65  nd fully detaile
6d90: 64 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 77 69  d definitions wi
6da0: 6c 6c 20 62 65 20 61 6c 77 61 79 73 20 72 65 74  ll be always ret
6db0: 72 69 65 76 65 64 20 66 72 6f 6d 20 74 68 65 20  rieved from the 
6dc0: 50 52 4f 4a 2e 36 20 6f 77 6e 20 64 61 74 61 62  PROJ.6 own datab
6dd0: 61 73 65 20 63 6f 6d 70 6c 65 74 65 6c 79 20 69  ase completely i
6de0: 67 6e 6f 72 69 6e 67 20 61 6e 79 20 64 65 66 69  gnoring any defi
6df0: 6e 69 74 69 6f 6e 20 28 6d 61 79 20 62 65 20 69  nition (may be i
6e00: 6e 63 6f 6d 70 6c 65 74 65 20 6f 72 20 6f 62 73  ncomplete or obs
6e10: 6f 6c 65 74 65 29 20 65 76 65 6e 74 75 61 6c 6c  olete) eventuall
6e20: 79 20 73 74 6f 72 65 64 20 69 6e 74 6f 20 74 68  y stored into th
6e30: 65 20 3c 62 3e 73 70 61 74 69 61 6c 5f 72 65 66  e <b>spatial_ref
6e40: 5f 73 79 73 3c 2f 62 3e 20 74 61 62 6c 65 2e 0d  _sys</b> table..
6e50: 0a 54 68 69 73 20 69 73 20 61 20 70 61 72 74 69  .This is a parti
6e60: 63 75 6c 61 72 79 20 75 73 65 66 75 6c 20 6f 70  culary useful op
6e70: 74 69 6f 6e 20 77 68 65 6e 20 70 72 6f 63 65 73  tion when proces
6e80: 73 69 6e 67 20 6f 6c 64 65 72 20 64 61 74 61 62  sing older datab
6e90: 61 73 65 73 20 62 65 69 6e 67 20 63 72 65 61 74  ases being creat
6ea0: 65 64 20 62 79 20 65 61 72 6c 69 65 72 20 76 65  ed by earlier ve
6eb0: 72 73 69 6f 6e 73 20 6f 66 20 53 70 61 74 69 61  rsions of Spatia
6ec0: 4c 69 74 65 20 6e 6f 74 20 79 65 74 20 73 75 70  Lite not yet sup
6ed0: 70 6f 72 74 69 6e 67 20 50 52 4f 4a 2e 36 3c 2f  porting PROJ.6</
6ee0: 6c 69 3e 0d 0a 3c 6c 69 3e 53 70 61 74 69 61 4c  li>..<li>SpatiaL
6ef0: 69 74 65 20 64 6f 65 73 20 6e 6f 74 20 63 6f 6e  ite does not con
6f00: 73 74 72 61 69 6e 74 73 20 79 6f 75 20 69 6e 20  straints you in 
6f10: 61 6e 79 20 77 61 79 20 61 6e 64 20 66 75 6c 6c  any way and full
6f20: 79 20 72 65 73 70 65 63 74 73 20 75 73 65 72 73  y respects users
6f30: 20 66 72 65 65 64 6f 6d 20 63 61 72 65 66 75 6c   freedom careful
6f40: 6c 79 20 61 76 6f 69 64 69 6e 67 20 3c 69 3e 61  ly avoiding <i>a
6f50: 75 74 6f 2d 6d 61 67 69 63 61 6c 3c 2f 69 3e 20  uto-magical</i> 
6f60: 61 73 73 75 6d 70 74 69 6f 6e 73 2e 3c 62 72 3e  assumptions.<br>
6f70: 0d 0a 49 66 20 79 6f 75 20 68 61 76 65 20 61 6e  ..If you have an
6f80: 79 20 67 6f 6f 64 20 72 65 61 73 6f 6e 20 73 75  y good reason su
6f90: 67 67 65 73 74 69 6e 67 20 74 6f 20 64 6f 20 73  ggesting to do s
6fa0: 75 63 68 20 61 20 74 68 69 6e 67 20 79 6f 75 20  uch a thing you 
6fb0: 61 72 65 20 61 6e 79 77 61 79 20 66 72 65 65 20  are anyway free 
6fc0: 74 6f 20 75 73 65 20 74 68 65 20 70 72 6f 6a 2d  to use the proj-
6fd0: 73 74 72 69 6e 67 73 20 28 3c 69 3e 6d 65 74 68  strings (<i>meth
6fe0: 6f 64 3c 2f 69 3e 3d 3c 62 3e 70 72 6f 6a 34 74  od</i>=<b>proj4t
6ff0: 65 78 74 3c 2f 62 3e 29 20 6f 72 20 74 68 65 20  ext</b>) or the 
7000: 57 4b 54 20 64 65 66 69 6e 69 74 69 6f 6e 73 20  WKT definitions 
7010: 28 3c 69 3e 6d 65 74 68 6f 64 3c 2f 69 3e 3d 3c  (<i>method</i>=<
7020: 62 3e 73 72 74 65 78 74 3c 2f 62 3e 29 20 73 74  b>srtext</b>) st
7030: 6f 72 65 64 20 69 6e 74 6f 20 74 68 65 20 3c 62  ored into the <b
7040: 3e 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73  >spatial_ref_sys
7050: 3c 2f 62 3e 20 74 61 62 6c 65 2e 3c 62 72 3e 0d  </b> table.<br>.
7060: 0a 42 75 74 20 74 68 69 73 20 69 73 20 75 6e 64  .But this is und
7070: 65 72 20 79 6f 75 72 20 66 75 6c 6c 20 72 65 73  er your full res
7080: 70 6f 6e 73 69 62 69 6c 69 74 79 2c 20 61 6e 64  ponsibility, and
7090: 20 79 6f 75 20 6d 75 73 74 20 62 65 20 77 65 6c   you must be wel
70a0: 6c 20 73 75 72 65 20 6f 66 20 77 68 61 74 20 61  l sure of what a
70b0: 72 65 20 79 6f 75 20 64 6f 69 6e 67 2e 3c 2f 6c  re you doing.</l
70c0: 69 3e 0d 0a 3c 6c 69 3e 53 70 61 74 69 61 4c 69  i>..<li>SpatiaLi
70d0: 74 65 20 65 6e 63 6f 75 72 61 67 65 73 20 61 6e  te encourages an
70e0: 64 20 70 72 6f 6d 6f 74 65 73 20 74 68 65 20 6d  d promotes the m
70f0: 6f 73 74 20 63 72 65 61 74 69 76 65 20 75 73 65  ost creative use
7100: 73 20 6f 66 20 50 52 4f 4a 2e 36 2c 20 74 68 69  s of PROJ.6, thi
7110: 73 20 69 6e 63 6c 75 64 69 6e 67 20 3c 62 3e 3c  s including <b><
7120: 69 3e 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e  i>transformation
7130: 20 70 69 70 65 6c 69 6e 65 73 3c 2f 69 3e 3c 2f   pipelines</i></
7140: 62 3e 2e 3c 62 72 3e 0d 0a 43 6f 72 72 65 63 74  b>.<br>..Correct
7150: 6c 79 20 75 73 69 6e 67 20 3c 69 3e 6d 65 74 68  ly using <i>meth
7160: 6f 64 3c 2f 69 3e 3d 3c 62 3e 70 72 6f 6a 5f 73  od</i>=<b>proj_s
7170: 74 72 69 6e 67 3c 2f 62 3e 20 66 6f 72 20 63 6f  tring</b> for co
7180: 6d 70 75 74 69 6e 67 20 63 75 73 74 6f 6d 20 74  mputing custom t
7190: 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 73 20 69  ransformations i
71a0: 73 6e 27 74 20 6e 65 63 65 73 73 61 72 69 6c 79  sn't necessarily
71b0: 20 73 69 6d 70 6c 65 20 61 6e 64 20 65 61 73 79   simple and easy
71c0: 2c 20 62 75 74 20 69 74 27 73 20 61 20 62 69 67  , but it's a big
71d0: 20 6f 70 70 6f 72 74 75 6e 69 74 79 20 66 6f 72   opportunity for
71e0: 20 61 6c 6c 20 73 6b 69 6c 6c 65 64 20 61 6e 64   all skilled and
71f0: 20 74 61 6c 65 6e 74 65 64 20 70 6f 77 65 72 20   talented power 
7200: 75 73 65 72 73 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75  users.</li>..</u
7210: 6c 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a  l>..</td></tr>..
7220: 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 68  </table><br>..<h
7230: 33 3e 4e 65 77 20 61 75 78 69 6c 69 61 72 79 20  3>New auxiliary 
7240: 53 51 4c 20 66 75 6e 63 74 69 6f 6e 73 20 73 70  SQL functions sp
7250: 65 63 69 66 69 63 61 6c 6c 79 20 73 75 70 70 6f  ecifically suppo
7260: 72 74 69 6e 67 20 50 52 4f 4a 2e 36 3c 2f 68 33  rting PROJ.6</h3
7270: 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70  >..<table cellsp
7280: 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61  acing="8" cellpa
7290: 64 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f  dding="8" bgcolo
72a0: 72 3d 22 23 65 38 66 66 65 38 22 20 62 6f 72 64  r="#e8ffe8" bord
72b0: 65 72 3d 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 68  er="1">..<tr><th
72c0: 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33   bgcolor="#ffb03
72d0: 65 22 3e 53 51 4c 20 46 75 6e 63 74 69 6f 6e 3c  e">SQL Function<
72e0: 2f 74 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d  /th><th bgcolor=
72f0: 22 23 66 66 62 30 33 65 22 3e 53 75 70 70 6f 72  "#ffb03e">Suppor
7300: 74 65 64 20 61 72 67 75 6d 65 6e 74 73 3c 2f 74  ted arguments</t
7310: 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23  h><th bgcolor="#
7320: 66 66 62 30 33 65 22 3e 44 65 73 63 72 69 70 74  ffb03e">Descript
7330: 69 6f 6e 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c  ion</th></tr>..<
7340: 74 72 3e 3c 74 64 3e 3c 62 3e 48 61 73 50 72 6f  tr><td><b>HasPro
7350: 6a 36 3c 2f 62 3e 28 20 3c 69 3e 76 6f 69 64 3c  j6</b>( <i>void<
7360: 2f 69 3e 20 29 20 3a 20 3c 69 3e 42 6f 6f 6c 65  /i> ) : <i>Boole
7370: 61 6e 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64  an</i></td>..<td
7380: 3e 4e 6f 6e 65 3c 2f 74 64 3e 0d 0a 3c 74 64 3e  >None</td>..<td>
7390: 57 69 6c 6c 20 72 65 74 75 72 6e 20 3c 62 3e 31  Will return <b>1
73a0: 3c 2f 62 3e 20 28 3c 62 3e 54 52 55 45 3c 2f 62  </b> (<b>TRUE</b
73b0: 3e 29 20 69 66 20 74 68 65 20 6c 69 62 72 61 72  >) if the librar
73c0: 79 20 68 61 73 20 62 65 65 6e 20 62 75 69 6c 74  y has been built
73d0: 20 6f 6e 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62   on <b>PROJ.6</b
73e0: 3e 20 28 6f 72 20 61 6e 79 20 6c 61 74 65 72 20  > (or any later 
73f0: 76 65 72 73 69 6f 6e 29 2c 20 6f 74 68 65 72 77  version), otherw
7400: 69 73 65 20 3c 62 3e 30 3c 2f 62 3e 20 28 3c 62  ise <b>0</b> (<b
7410: 3e 46 41 4c 53 45 3c 2f 62 3e 29 2e 3c 2f 74 64  >FALSE</b>).</td
7420: 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e  ></tr>..<tr><td>
7430: 3c 62 3e 50 52 4f 4a 5f 47 65 74 4c 61 73 74 45  <b>PROJ_GetLastE
7440: 72 72 6f 72 4d 73 67 3c 2f 62 3e 28 20 3c 69 3e  rrorMsg</b>( <i>
7450: 76 6f 69 64 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e  void</i> ) : <i>
7460: 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d  String</i></td>.
7470: 0a 3c 74 64 3e 4e 6f 6e 65 3c 2f 74 64 3e 0d 0a  .<td>None</td>..
7480: 3c 74 64 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20  <td>Will return 
7490: 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20  the most recent 
74a0: 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 72 65  error message re
74b0: 74 75 72 6e 65 64 20 62 79 20 50 52 4f 4a 20 28  turned by PROJ (
74c0: 69 66 20 61 6e 79 29 2e 3c 62 72 3e 0d 0a 3c 62  if any).<br>..<b
74d0: 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 62  >NULL</b> will b
74e0: 65 20 72 65 74 75 72 6e 65 64 20 69 66 20 74 68  e returned if th
74f0: 65 72 65 20 69 73 20 6e 6f 20 63 75 72 65 6e 74  ere is no curent
7500: 6c 79 20 70 65 6e 64 69 6e 67 20 50 52 4f 4a 20  ly pending PROJ 
7510: 65 72 72 6f 72 2e 3c 2f 74 64 3e 3c 2f 74 72 3e  error.</td></tr>
7520: 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f  ..<tr><td><b>PRO
7530: 4a 5f 47 65 74 44 61 74 61 62 61 73 65 50 61 74  J_GetDatabasePat
7540: 68 3c 2f 62 3e 28 20 3c 69 3e 76 6f 69 64 3c 2f  h</b>( <i>void</
7550: 69 3e 20 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  i> : <i>String</
7560: 69 3e 29 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4e 6f  i>)</td>..<td>No
7570: 6e 65 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c  ne</td>..<td>Wil
7580: 6c 20 72 65 74 75 72 6e 20 74 68 65 20 63 75 72  l return the cur
7590: 72 65 6e 74 6c 79 20 73 65 74 20 70 61 74 68 6e  rently set pathn
75a0: 61 6d 65 20 6c 65 61 64 69 6e 67 20 74 6f 20 74  ame leading to t
75b0: 68 65 20 70 72 69 76 61 74 65 20 50 52 4f 4a 27  he private PROJ'
75c0: 73 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73  s SQLite databas
75d0: 65 2e 3c 62 72 3e 0d 0a 3c 62 3e 4e 55 4c 4c 3c  e.<br>..<b>NULL<
75e0: 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72 65 74 75  /b> will be retu
75f0: 72 6e 65 64 20 69 66 20 74 68 65 72 65 20 69 73  rned if there is
7600: 20 6e 6f 20 70 72 69 76 61 74 65 20 50 52 4f 4a   no private PROJ
7610: 27 73 20 53 51 4c 69 74 65 20 64 61 74 61 62 61  's SQLite databa
7620: 73 65 20 63 75 72 72 65 6e 74 6c 79 20 63 6f 6e  se currently con
7630: 6e 65 63 74 65 64 2e 3c 2f 74 64 3e 3c 2f 74 72  nected.</td></tr
7640: 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52  >..<tr><td><b>PR
7650: 4f 4a 5f 53 65 74 44 61 74 61 62 61 73 65 50 61  OJ_SetDatabasePa
7660: 74 68 3c 2f 62 3e 20 28 20 6e 65 77 5f 70 61 74  th</b> ( new_pat
7670: 68 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20  h <i>String</i> 
7680: 29 20 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69  ) : <i>String</i
7690: 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a 3c 75  ></td>..<td>..<u
76a0: 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 6e 65 77 5f 70  l>..<li><b>new_p
76b0: 61 74 68 3c 2f 62 3e 3a 20 61 20 72 65 6c 61 74  ath</b>: a relat
76c0: 69 76 65 20 6f 72 20 61 62 73 6f 6c 75 74 65 20  ive or absolute 
76d0: 70 61 74 68 6e 61 6d 65 20 6c 65 61 64 69 6e 67  pathname leading
76e0: 20 74 6f 20 61 20 76 61 6c 69 64 20 50 52 4f 4a   to a valid PROJ
76f0: 27 73 20 53 51 4c 69 74 65 20 64 61 74 61 62 61  's SQLite databa
7700: 73 65 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c  se.</li>..</ul><
7710: 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 63  /td>..<td>Will c
7720: 68 61 6e 67 65 20 74 68 65 20 63 75 72 72 65 6e  hange the curren
7730: 74 6c 79 20 73 65 74 20 70 61 74 68 6e 61 6d 65  tly set pathname
7740: 20 6c 65 61 64 69 6e 67 20 74 6f 20 74 68 65 20   leading to the 
7750: 70 72 69 76 61 74 65 20 50 52 4f 4a 27 73 20 53  private PROJ's S
7760: 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 2e 3c  QLite database.<
7770: 62 72 3e 0d 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e  br>..<b>NULL</b>
7780: 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65   will be returne
7790: 64 20 69 66 20 74 68 65 20 70 61 73 73 65 64 20  d if the passed 
77a0: 70 61 74 68 20 69 73 20 69 6e 76 61 6c 69 64 2c  path is invalid,
77b0: 20 6f 74 68 65 72 77 69 73 65 20 74 68 65 20 70   otherwise the p
77c0: 61 74 68 20 6f 66 20 74 68 65 20 63 75 72 72 65  ath of the curre
77d0: 6e 74 6c 79 20 73 65 74 20 70 72 69 76 61 74 65  ntly set private
77e0: 20 50 52 4f 4a 27 73 20 53 51 4c 69 74 65 20 64   PROJ's SQLite d
77f0: 61 74 61 62 61 73 65 20 77 69 6c 6c 20 62 65 20  atabase will be 
7800: 72 65 74 75 72 6e 65 64 2e 3c 2f 74 64 3e 3c 2f  returned.</td></
7810: 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e  tr>..<tr><td><b>
7820: 50 52 4f 4a 5f 41 73 57 4b 54 3c 2f 62 3e 20 28  PROJ_AsWKT</b> (
7830: 20 61 75 74 68 5f 6e 61 6d 65 20 3c 69 3e 53 74   auth_name <i>St
7840: 72 69 6e 67 3c 2f 69 3e 20 2c 20 61 75 74 68 5f  ring</i> , auth_
7850: 73 72 69 64 20 3c 69 3e 49 6e 74 65 67 65 72 3c  srid <i>Integer<
7860: 2f 69 3e 20 29 20 3a 20 3c 69 3e 53 74 72 69 6e  /i> ) : <i>Strin
7870: 67 3c 2f 69 3e 3c 68 72 3e 0d 0a 3c 62 3e 50 52  g</i><hr>..<b>PR
7880: 4f 4a 5f 41 73 57 4b 54 3c 2f 62 3e 20 28 20 61  OJ_AsWKT</b> ( a
7890: 75 74 68 5f 6e 61 6d 65 20 3c 69 3e 53 74 72 69  uth_name <i>Stri
78a0: 6e 67 3c 2f 69 3e 20 2c 20 61 75 74 68 5f 73 72  ng</i> , auth_sr
78b0: 69 64 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69  id <i>Integer</i
78c0: 3e 20 2c 20 77 6b 74 5f 73 74 79 6c 65 20 3c 69  > , wkt_style <i
78d0: 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20  >String</i> ) : 
78e0: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 68 72  <i>String</i><hr
78f0: 3e 0d 0a 3c 62 3e 50 52 4f 4a 5f 41 73 57 4b 54  >..<b>PROJ_AsWKT
7900: 3c 2f 62 3e 20 28 20 61 75 74 68 5f 6e 61 6d 65  </b> ( auth_name
7910: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c   <i>String</i> ,
7920: 20 61 75 74 68 5f 73 72 69 64 20 3c 69 3e 49 6e   auth_srid <i>In
7930: 74 65 67 65 72 3c 2f 69 3e 20 2c 20 77 6b 74 5f  teger</i> , wkt_
7940: 73 74 79 6c 65 20 3c 69 3e 53 74 72 69 6e 67 3c  style <i>String<
7950: 2f 69 3e 20 2c 20 69 6e 64 65 6e 74 65 64 20 3c  /i> , indented <
7960: 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 20 29 20  i>Boolean</i> ) 
7970: 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c  : <i>String</i><
7980: 68 72 3e 0d 0a 3c 62 3e 50 52 4f 4a 5f 41 73 57  hr>..<b>PROJ_AsW
7990: 4b 54 3c 2f 62 3e 20 28 20 61 75 74 68 5f 6e 61  KT</b> ( auth_na
79a0: 6d 65 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  me <i>String</i>
79b0: 20 2c 20 61 75 74 68 5f 73 72 69 64 20 3c 69 3e   , auth_srid <i>
79c0: 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c 20 77 6b  Integer</i> , wk
79d0: 74 5f 73 74 79 6c 65 20 3c 69 3e 53 74 72 69 6e  t_style <i>Strin
79e0: 67 3c 2f 69 3e 20 2c 20 69 6e 64 65 6e 74 65 64  g</i> , indented
79f0: 20 3c 69 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 20   <i>Boolean</i> 
7a00: 2c 20 69 6e 64 65 6e 74 61 74 69 6f 6e 20 3c 69  , indentation <i
7a10: 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a  >Integer</i> ) :
7a20: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f   <i>String</i></
7a30: 74 64 3e 0d 0a 3c 74 64 3e 3c 75 6c 3e 0d 0a 3c  td>..<td><ul>..<
7a40: 6c 69 3e 3c 62 3e 61 75 74 68 5f 6e 61 6d 65 3c  li><b>auth_name<
7a50: 2f 62 3e 20 61 6e 64 20 3c 62 3e 61 75 74 68 5f  /b> and <b>auth_
7a60: 73 72 69 64 3c 2f 62 3e 20 69 64 65 6e 74 69 66  srid</b> identif
7a70: 79 20 74 68 65 20 69 6e 74 65 6e 64 65 64 20 43  y the intended C
7a80: 52 53 2e 3c 62 72 3e 0d 0a 3c 62 3e 61 75 74 68  RS.<br>..<b>auth
7a90: 5f 6e 61 6d 65 3c 2f 62 3e 20 63 61 6e 20 62 65  _name</b> can be
7aa0: 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 2c 20 61 6e   <b>NULL</b>, an
7ab0: 64 20 69 6e 20 74 68 69 73 20 63 61 73 65 20 3c  d in this case <
7ac0: 62 3e 45 50 53 47 3c 2f 62 3e 20 77 69 6c 6c 20  b>EPSG</b> will 
7ad0: 62 65 20 61 73 73 75 6d 65 64 2e 3c 2f 6c 69 3e  be assumed.</li>
7ae0: 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e  ..<li>the option
7af0: 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e 73  al argument <b>s
7b00: 74 79 6c 65 3c 2f 62 3e 20 64 65 74 65 72 6d 69  tyle</b> determi
7b10: 6e 65 73 20 77 68 69 63 68 20 73 70 65 63 69 66  nes which specif
7b20: 69 63 20 57 4b 54 20 66 6f 72 6d 61 74 20 73 68  ic WKT format sh
7b30: 6f 75 6c 64 20 62 65 20 61 64 6f 70 74 65 64 2c  ould be adopted,
7b40: 20 61 6e 64 20 6d 75 73 74 20 62 65 20 6f 6e 65   and must be one
7b50: 20 62 65 74 77 65 65 6e 20 3c 62 3e 47 44 41 4c   between <b>GDAL
7b60: 3c 2f 62 3e 2c 20 3c 62 3e 45 53 52 49 3c 2f 62  </b>, <b>ESRI</b
7b70: 3e 2c 20 3c 62 3e 49 53 4f 2d 32 30 31 35 3c 2f  >, <b>ISO-2015</
7b80: 62 3e 20 6f 72 20 3c 62 3e 49 53 4f 2d 32 30 31  b> or <b>ISO-201
7b90: 38 3c 2f 62 3e 20 28 74 68 69 73 20 6c 61 74 74  8</b> (this latt
7ba0: 65 72 20 62 65 69 6e 67 20 74 68 65 20 64 65 66  er being the def
7bb0: 61 75 6c 74 20 73 65 74 74 69 6e 67 29 2e 3c 2f  ault setting).</
7bc0: 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74  li>..<li>the opt
7bd0: 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c  ional argument <
7be0: 62 3e 69 6e 64 65 6e 74 65 64 3c 2f 62 3e 20 69  b>indented</b> i
7bf0: 66 20 73 65 74 20 74 6f 20 3c 62 3e 54 52 55 45  f set to <b>TRUE
7c00: 3c 2f 62 3e 20 77 69 6c 6c 20 6e 69 63 65 6c 79  </b> will nicely
7c10: 20 66 6f 72 6d 61 74 20 61 20 6d 75 6c 74 69 6c   format a multil
7c20: 69 6e 65 20 57 4b 54 20 65 78 70 72 65 73 73 69  ine WKT expressi
7c30: 6f 6e 2c 20 6f 74 68 65 72 77 69 73 65 20 61 20  on, otherwise a 
7c40: 73 69 6e 67 6c 65 20 6d 6f 6e 6f 6c 69 74 68 69  single monolithi
7c50: 63 20 6c 69 6e 65 20 6c 61 63 6b 69 6e 67 20 61  c line lacking a
7c60: 6e 79 20 77 68 69 74 65 2d 73 70 61 63 65 20 6f  ny white-space o
7c70: 72 20 6e 65 77 2d 6c 69 6e 65 20 77 69 6c 6c 20  r new-line will 
7c80: 62 65 20 70 72 69 6e 74 65 64 20 28 74 68 65 20  be printed (the 
7c90: 64 65 66 61 75 6c 74 20 69 73 20 3c 62 3e 54 52  default is <b>TR
7ca0: 55 45 3c 2f 62 3e 29 2e 3c 2f 6c 69 3e 0d 0a 3c  UE</b>).</li>..<
7cb0: 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20  li>the optional 
7cc0: 61 72 67 75 6d 65 6e 74 20 3c 62 3e 69 6e 64 65  argument <b>inde
7cd0: 6e 74 61 74 69 6f 6e 3c 2f 62 3e 20 64 65 74 65  ntation</b> dete
7ce0: 72 6d 69 6e 65 73 20 68 6f 77 20 6d 61 6e 79 20  rmines how many 
7cf0: 77 68 69 74 65 2d 73 70 61 63 65 73 20 61 72 65  white-spaces are
7d00: 20 74 6f 20 62 65 20 75 73 65 64 20 66 6f 72 20   to be used for 
7d10: 69 6e 64 65 6e 74 69 6e 67 20 28 6f 6e 6c 79 20  indenting (only 
7d20: 6d 65 61 6e 69 6e 67 66 75 6c 20 69 66 20 3c 62  meaningful if <b
7d30: 3e 3c 69 3e 69 6e 64 65 6e 74 65 64 3d 54 52 55  ><i>indented=TRU
7d40: 45 3c 2f 69 3e 3c 2f 62 3e 3b 20 74 68 65 20 64  E</i></b>; the d
7d50: 65 66 61 75 6c 74 20 76 61 6c 75 65 73 20 69 73  efault values is
7d60: 20 3c 62 3e 34 3c 2f 62 3e 29 2e 3c 2f 6c 69 3e   <b>4</b>).</li>
7d70: 0d 0a 3c 2f 75 6c 3e 3c 2f 74 64 3e 0d 0a 3c 74  ..</ul></td>..<t
7d80: 64 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20 74 68  d>Will return th
7d90: 65 20 57 4b 54 20 65 78 70 72 65 73 73 69 6f 6e  e WKT expression
7da0: 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74   corresponding t
7db0: 6f 20 61 20 67 69 76 65 6e 20 43 52 53 3b 20 74  o a given CRS; t
7dc0: 68 65 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 77  he definitions w
7dd0: 69 6c 6c 20 62 65 20 74 61 6b 65 6e 20 64 69 72  ill be taken dir
7de0: 65 63 74 6c 79 20 66 72 6f 6d 20 74 68 65 20 70  ectly from the p
7df0: 72 69 76 61 74 65 20 50 52 4f 4a 27 73 20 6f 77  rivate PROJ's ow
7e00: 6e 20 64 61 74 61 62 61 73 65 2e 3c 62 72 3e 0d  n database.<br>.
7e10: 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c  .<b>NULL</b> wil
7e20: 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 6f 6e  l be returned on
7e30: 20 66 61 69 6c 75 72 65 20 6f 72 20 6f 6e 20 69   failure or on i
7e40: 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 73  nvalid arguments
7e50: 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72  .</td></tr>..<tr
7e60: 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f 47 75 65  ><td><b>PROJ_Gue
7e70: 73 73 53 72 69 64 46 72 6f 6d 57 4b 54 3c 2f 62  ssSridFromWKT</b
7e80: 3e 20 28 20 77 6b 74 5f 65 78 70 72 20 3c 69 3e  > ( wkt_expr <i>
7e90: 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c  String</i> ) : <
7ea0: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74  i>Integer</i></t
7eb0: 64 3e 0d 0a 3c 74 64 3e 3c 75 6c 3e 0d 0a 3c 6c  d>..<td><ul>..<l
7ec0: 69 3e 3c 62 3e 77 6b 74 5f 65 78 70 72 3c 2f 62  i><b>wkt_expr</b
7ed0: 3e 3a 20 74 68 65 20 57 4b 54 20 65 78 70 72 65  >: the WKT expre
7ee0: 73 73 69 6f 6e 20 74 6f 20 62 65 20 65 76 61 6c  ssion to be eval
7ef0: 75 61 74 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75  uated.</li>..</u
7f00: 6c 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a 57  l></td>..<td>..W
7f10: 69 6c 6c 20 70 6f 73 73 69 62 6c 79 20 72 65 74  ill possibly ret
7f20: 75 72 6e 20 74 68 65 20 3c 62 3e 53 52 49 44 20  urn the <b>SRID 
7f30: 76 61 6c 75 65 3c 2f 62 3e 20 63 6f 72 72 65 73  value</b> corres
7f40: 70 6f 6e 64 69 6e 67 20 74 6f 20 61 20 67 69 76  ponding to a giv
7f50: 65 6e 20 57 4b 54 20 65 78 70 72 65 73 73 69 6f  en WKT expressio
7f60: 6e 20 64 65 66 69 6e 69 6e 67 20 61 20 43 52 53  n defining a CRS
7f70: 2e 3c 62 72 3e 0d 0a 3c 62 3e 2d 31 3c 2f 62 3e  .<br>..<b>-1</b>
7f80: 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65   will be returne
7f90: 64 20 69 66 20 6e 6f 20 43 52 53 20 73 75 70 70  d if no CRS supp
7fa0: 6f 72 74 65 64 20 62 79 20 50 52 4f 4a 2e 36 20  orted by PROJ.6 
7fb0: 6d 61 74 63 68 65 73 20 74 68 65 20 57 4b 54 20  matches the WKT 
7fc0: 65 78 70 72 65 73 73 69 6f 6e 2e 3c 62 72 3e 0d  expression.<br>.
7fd0: 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c  .<b>NULL</b> wil
7fe0: 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 6f 6e  l be returned on
7ff0: 20 69 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e   invalid argumen
8000: 74 2e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a  t...</td></tr>..
8010: 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f  <tr><td><b>PROJ_
8020: 47 75 65 73 73 53 72 69 64 46 72 6f 6d 53 48 50  GuessSridFromSHP
8030: 3c 2f 62 3e 20 28 20 66 69 6c 65 6e 61 6d 65 20  </b> ( filename 
8040: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20  <i>String</i> ) 
8050: 3a 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  : <i>Integer</i>
8060: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 3c 75 6c 3e 0d  </td>..<td><ul>.
8070: 0a 3c 6c 69 3e 3c 62 3e 66 69 6c 65 6e 61 6d 65  .<li><b>filename
8080: 3c 2f 62 3e 3a 20 74 68 65 20 61 62 73 6f 6c 75  </b>: the absolu
8090: 74 65 20 6f 72 20 72 65 6c 61 74 69 76 65 20 70  te or relative p
80a0: 61 74 68 20 6c 65 61 64 69 6e 67 20 74 6f 20 73  ath leading to s
80b0: 6f 6d 65 20 53 68 61 70 65 66 69 6c 65 2e 3c 62  ome Shapefile.<b
80c0: 72 3e 0d 0a 4e 6f 74 65 3a 20 65 78 61 63 74 6c  r>..Note: exactl
80d0: 65 79 20 61 73 20 72 65 71 75 69 72 65 64 20 62  ey as required b
80e0: 79 20 3c 62 3e 3c 69 3e 49 6d 70 6f 72 74 53 48  y <b><i>ImportSH
80f0: 50 3c 2f 69 3e 3c 2f 62 3e 28 29 20 3c 62 3e 3c  P</i></b>() <b><
8100: 69 3e 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 3c 2f  i>filename</i></
8110: 62 3e 20 6d 75 73 74 20 6f 6d 69 74 20 61 6e 79  b> must omit any
8120: 20 3c 62 3e 2e 73 68 70 3c 2f 62 3e 2c 20 3c 62   <b>.shp</b>, <b
8130: 3e 2e 73 68 78 3c 2f 62 3e 2c 20 3c 62 3e 2e 64  >.shx</b>, <b>.d
8140: 62 66 3c 2f 62 3e 20 6f 72 20 3c 62 3e 2e 70 72  bf</b> or <b>.pr
8150: 6a 3c 2f 62 3e 20 73 75 66 66 69 78 2e 3c 2f 6c  j</b> suffix.</l
8160: 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 74 64 3e 0d 0a  i>..</ul></td>..
8170: 3c 74 64 3e 0d 0a 57 69 6c 6c 20 70 6f 73 73 69  <td>..Will possi
8180: 62 6c 79 20 72 65 74 75 72 6e 20 74 68 65 20 3c  bly return the <
8190: 62 3e 53 52 49 44 20 76 61 6c 75 65 3c 2f 62 3e  b>SRID value</b>
81a0: 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74   corresponding t
81b0: 6f 20 74 68 65 20 43 52 53 20 64 65 66 69 6e 65  o the CRS define
81c0: 64 20 62 79 20 74 68 65 20 2e 50 52 4a 20 6d 65  d by the .PRJ me
81d0: 6d 62 65 72 20 6f 66 20 74 68 65 20 53 68 61 70  mber of the Shap
81e0: 65 66 69 6c 65 2e 3c 62 72 3e 0d 0a 3c 62 3e 2d  efile.<br>..<b>-
81f0: 31 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72 65  1</b> will be re
8200: 74 75 72 6e 65 64 20 69 66 20 6e 6f 20 43 52 53  turned if no CRS
8210: 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 50 52   supported by PR
8220: 4f 4a 2e 36 20 6d 61 74 63 68 65 73 20 50 52 4a  OJ.6 matches PRJ
8230: 20 6d 65 6d 62 65 72 20 6f 66 20 74 68 65 20 53   member of the S
8240: 68 61 70 65 66 69 6c 65 2e 3c 62 72 3e 0d 0a 3c  hapefile.<br>..<
8250: 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20  b>NULL</b> will 
8260: 62 65 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 69  be returned on i
8270: 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 2e  nvalid argument.
8280: 3c 68 72 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20  <hr>..<u>Please 
8290: 6e 6f 74 65 20 77 65 6c 6c 3c 2f 75 3e 3a 20 74  note well</u>: t
82a0: 68 69 73 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e  his SQL function
82b0: 20 6f 70 65 6e 64 20 74 68 65 20 64 6f 6f 72 20   opend the door 
82c0: 74 6f 20 6d 61 6e 79 20 70 6f 74 65 6e 74 69 61  to many potentia
82d0: 6c 20 73 65 63 75 72 69 74 79 20 69 73 73 75 65  l security issue
82e0: 73 2c 20 61 6e 64 20 74 68 75 73 20 69 73 20 61  s, and thus is a
82f0: 6c 77 61 79 73 20 3c 69 3e 64 69 73 61 62 6c 65  lways <i>disable
8300: 64 20 62 79 20 64 65 66 61 75 6c 74 3c 2f 69 3e  d by default</i>
8310: 2e 3c 62 72 3e 0d 0a 45 78 70 6c 69 63 69 74 6c  .<br>..Explicitl
8320: 79 20 73 65 74 74 69 6e 67 20 74 68 65 20 65 6e  y setting the en
8330: 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62  vironment variab
8340: 6c 65 20 3c 62 3e 53 50 41 54 49 41 4c 49 54 45  le <b>SPATIALITE
8350: 5f 53 45 43 55 52 49 54 59 3d 72 65 6c 61 78 65  _SECURITY=relaxe
8360: 64 3c 2f 62 3e 20 69 73 20 61 62 73 6f 6c 75 74  d</b> is absolut
8370: 65 6c 79 20 72 65 71 75 69 72 65 64 20 69 6e 20  ely required in 
8380: 6f 72 64 65 72 20 74 6f 20 65 6e 61 62 6c 65 20  order to enable 
8390: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0d 0a  this function...
83a0: 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61  </td></tr>..</ta
83b0: 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65  ble><br>..<table
83c0: 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22   cellspacing="8"
83d0: 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 31 36   cellpadding="16
83e0: 22 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66  " bgcolor="#ffff
83f0: 65 39 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a  e9">..<tr><td>..
8400: 3c 62 3e 3c 75 3e 4e 6f 74 65 3c 2f 75 3e 3c 2f  <b><u>Note</u></
8410: 62 3e 3a 20 61 6c 6c 20 74 68 65 20 61 62 6f 76  b>: all the abov
8420: 65 20 53 51 4c 20 46 75 6e 63 74 69 6f 6e 73 20  e SQL Functions 
8430: 77 69 6c 6c 20 62 65 20 61 76 61 69 6c 61 62 6c  will be availabl
8440: 65 20 6f 6e 6c 79 20 77 68 65 6e 20 53 70 61 74  e only when Spat
8450: 69 61 6c 69 74 65 2d 35 2e 30 2e 30 20 68 61 73  ialite-5.0.0 has
8460: 20 62 65 65 6e 20 62 75 69 6c 74 20 61 67 61 69   been built agai
8470: 6e 73 74 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62  nst <b>PROJ.6</b
8480: 3e 20 28 6f 72 20 61 6e 79 20 73 75 62 73 65 71  > (or any subseq
8490: 75 65 6e 74 20 76 65 72 73 69 6f 6e 29 2e 3c 62  uent version).<b
84a0: 72 3e 0d 0a 49 66 20 53 70 61 74 69 61 4c 69 74  r>..If SpatiaLit
84b0: 65 2d 35 2e 30 2e 30 20 68 61 73 20 62 65 65 6e  e-5.0.0 has been
84c0: 20 62 75 69 6c 74 20 69 6e 73 74 65 61 64 20 61   built instead a
84d0: 67 61 69 6e 73 74 20 61 6e 79 20 70 72 65 76 69  gainst any previ
84e0: 6f 73 75 73 20 76 65 72 73 69 6f 6e 20 28 61 73  osus version (as
84f0: 20 65 2e 67 2e 20 3c 62 3e 50 52 4f 4a 2e 34 3c   e.g. <b>PROJ.4<
8500: 2f 62 3e 29 20 61 6e 79 20 61 74 74 65 6d 70 74  /b>) any attempt
8510: 20 74 6f 20 63 61 6c 6c 20 6f 6e 65 20 6f 66 20   to call one of 
8520: 74 68 65 73 65 20 53 51 4c 20 46 75 6e 63 74 69  these SQL Functi
8530: 6f 6e 73 20 77 69 6c 6c 20 73 69 6d 70 6c 79 20  ons will simply 
8540: 72 65 74 75 72 6e 20 61 20 3c 62 3e 3c 69 3e 3c  return a <b><i><
8550: 75 3e 6e 6f 20 73 75 63 68 20 66 75 6e 63 74 69  u>no such functi
8560: 6f 6e 3c 2f 75 3e 3c 2f 69 3e 3c 2f 62 3e 20 53  on</u></i></b> S
8570: 51 4c 20 65 72 72 6f 72 2e 0d 0a 3c 2f 74 64 3e  QL error...</td>
8580: 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c  </tr>..</table><
8590: 62 72 3e 0d 0a 3c 62 3e 50 72 61 63 74 69 63 61  br>..<b>Practica
85a0: 6c 20 65 78 61 6d 70 6c 65 73 3a 3c 2f 62 3e 0d  l examples:</b>.
85b0: 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c  .<verbatim>..SEL
85c0: 45 43 54 20 50 52 4f 4a 5f 47 65 74 44 61 74 61  ECT PROJ_GetData
85d0: 62 61 73 65 50 61 74 68 28 29 3b 20 20 2d 2d 20  basePath();  -- 
85e0: 72 65 74 72 69 65 76 69 6e 67 20 74 68 65 20 63  retrieving the c
85f0: 75 72 72 65 6e 74 6c 79 20 73 65 74 20 50 52 4f  urrently set PRO
8600: 4a 27 73 20 6f 77 6e 20 64 61 74 61 62 61 73 65  J's own database
8610: 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ..--------------
8620: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
8630: 0d 0a 2f 75 73 72 2f 6c 6f 63 61 6c 2f 73 68 61  ../usr/local/sha
8640: 72 65 2f 70 72 6f 6a 2f 70 72 6f 6a 2e 64 62 0d  re/proj/proj.db.
8650: 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f 53  ...SELECT PROJ_S
8660: 65 74 44 61 74 61 62 61 73 65 50 61 74 68 28 27  etDatabasePath('
8670: 2f 68 6f 6d 65 2f 73 61 6e 64 72 6f 2f 6e 6f 74  /home/sandro/not
8680: 5f 65 78 69 73 74 69 6e 67 5f 70 72 6f 6a 2e 64  _existing_proj.d
8690: 62 27 29 3b 20 2d 2d 20 6e 6f 6e 20 65 78 69 73  b'); -- non exis
86a0: 74 69 6e 67 20 64 61 74 61 62 61 73 65 0d 0a 2d  ting database..-
86b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
86c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 4e  -------------..N
86d0: 55 4c 4c 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52  ULL....SELECT PR
86e0: 4f 4a 5f 47 65 74 4c 61 73 74 45 72 72 6f 72 4d  OJ_GetLastErrorM
86f0: 73 67 28 29 3b 20 2d 2d 20 72 65 74 72 69 65 76  sg(); -- retriev
8700: 69 6e 67 20 74 68 65 20 66 61 69 6c 75 72 65 20  ing the failure 
8710: 63 61 75 73 65 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d  cause..---------
8720: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
8730: 2d 2d 2d 2d 2d 0d 0a 70 72 6f 6a 5f 63 6f 6e 74  -----..proj_cont
8740: 65 78 74 5f 73 65 74 5f 64 61 74 61 62 61 73 65  ext_set_database
8750: 5f 70 61 74 68 3a 20 4f 70 65 6e 20 6f 66 20 2f  _path: Open of /
8760: 68 6f 6d 65 2f 73 61 6e 64 72 6f 2f 6e 6f 74 5f  home/sandro/not_
8770: 65 78 69 73 74 69 6e 67 5f 70 72 6f 6a 2e 64 62  existing_proj.db
8780: 20 66 61 69 6c 65 64 0d 0a 0d 0a 53 45 4c 45 43   failed....SELEC
8790: 54 20 50 52 4f 4a 5f 53 65 74 44 61 74 61 62 61  T PROJ_SetDataba
87a0: 73 65 50 61 74 68 28 27 2f 68 6f 6d 65 2f 73 61  sePath('/home/sa
87b0: 6e 64 72 6f 2f 76 61 6c 69 64 5f 70 72 6f 6a 2e  ndro/valid_proj.
87c0: 64 62 27 29 3b 20 2d 2d 20 76 61 6c 69 64 20 64  db'); -- valid d
87d0: 61 74 61 62 61 73 65 0d 0a 2d 2d 2d 2d 2d 2d 2d  atabase..-------
87e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
87f0: 2d 2d 2d 2d 2d 2d 2d 0d 0a 2f 68 6f 6d 65 2f 73  -------../home/s
8800: 61 6e 64 72 6f 2f 76 61 6c 69 64 5f 70 72 6f 6a  andro/valid_proj
8810: 2e 64 62 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52  .db....SELECT PR
8820: 4f 4a 5f 41 73 57 4b 54 28 27 45 50 53 47 27 2c  OJ_AsWKT('EPSG',
8830: 20 34 33 32 36 29 3b 20 2d 2d 20 64 65 66 61 75   4326); -- defau
8840: 6c 74 20 73 65 74 74 69 6e 67 73 3a 20 49 53 4f  lt settings: ISO
8850: 2d 32 30 31 38 20 73 74 79 6c 65 2c 20 69 6e 64  -2018 style, ind
8860: 65 6e 74 65 64 20 77 69 74 68 20 69 6e 64 65 6e  ented with inden
8870: 74 61 74 69 6f 6e 20 34 0d 0a 2d 2d 2d 2d 2d 2d  tation 4..------
8880: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
8890: 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 47 45 4f 44 43 52  --------..GEODCR
88a0: 53 5b 22 57 47 53 20 38 34 22 2c 0d 0a 20 20 20  S["WGS 84",..   
88b0: 20 44 41 54 55 4d 5b 22 57 6f 72 6c 64 20 47 65   DATUM["World Ge
88c0: 6f 64 65 74 69 63 20 53 79 73 74 65 6d 20 31 39  odetic System 19
88d0: 38 34 22 2c 0d 0a 20 20 20 20 20 20 20 20 45 4c  84",..        EL
88e0: 4c 49 50 53 4f 49 44 5b 22 57 47 53 20 38 34 22  LIPSOID["WGS 84"
88f0: 2c 36 33 37 38 31 33 37 2c 32 39 38 2e 32 35 37  ,6378137,298.257
8900: 32 32 33 35 36 33 2c 0d 0a 20 20 20 20 20 20 20  223563,..       
8910: 20 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b       LENGTHUNIT[
8920: 22 6d 65 74 72 65 22 2c 31 5d 5d 5d 2c 0d 0a 20  "metre",1]]],.. 
8930: 20 20 20 50 52 49 4d 45 4d 5b 22 47 72 65 65 6e     PRIMEM["Green
8940: 77 69 63 68 22 2c 30 2c 0d 0a 20 20 20 20 20 20  wich",0,..      
8950: 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67    ANGLEUNIT["deg
8960: 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32  ree",0.017453292
8970: 35 31 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20  5199433]],..    
8980: 43 53 5b 65 6c 6c 69 70 73 6f 69 64 61 6c 2c 32  CS[ellipsoidal,2
8990: 5d 2c 0d 0a 20 20 20 20 20 20 20 20 41 58 49 53  ],..        AXIS
89a0: 5b 22 67 65 6f 64 65 74 69 63 20 6c 61 74 69 74  ["geodetic latit
89b0: 75 64 65 20 28 4c 61 74 29 22 2c 6e 6f 72 74 68  ude (Lat)",north
89c0: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4f  ,..            O
89d0: 52 44 45 52 5b 31 5d 2c 0d 0a 20 20 20 20 20 20  RDER[1],..      
89e0: 20 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b        ANGLEUNIT[
89f0: 22 64 65 67 72 65 65 22 2c 30 2e 30 31 37 34 35  "degree",0.01745
8a00: 33 32 39 32 35 31 39 39 34 33 33 5d 5d 2c 0d 0a  32925199433]],..
8a10: 20 20 20 20 20 20 20 20 41 58 49 53 5b 22 67 65          AXIS["ge
8a20: 6f 64 65 74 69 63 20 6c 6f 6e 67 69 74 75 64 65  odetic longitude
8a30: 20 28 4c 6f 6e 29 22 2c 65 61 73 74 2c 0d 0a 20   (Lon)",east,.. 
8a40: 20 20 20 20 20 20 20 20 20 20 20 4f 52 44 45 52             ORDER
8a50: 5b 32 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20  [2],..          
8a60: 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67    ANGLEUNIT["deg
8a70: 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32  ree",0.017453292
8a80: 35 31 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20  5199433]],..    
8a90: 41 52 45 41 5b 22 57 6f 72 6c 64 22 5d 2c 0d 0a  AREA["World"],..
8aa0: 20 20 20 20 42 42 4f 58 5b 2d 39 30 2c 2d 31 38      BBOX[-90,-18
8ab0: 30 2c 39 30 2c 31 38 30 5d 2c 0d 0a 20 20 20 20  0,90,180],..    
8ac0: 49 44 5b 22 45 50 53 47 22 2c 34 33 32 36 5d 5d  ID["EPSG",4326]]
8ad0: 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f  ....SELECT PROJ_
8ae0: 41 73 57 4b 54 28 27 45 50 53 47 27 2c 20 34 33  AsWKT('EPSG', 43
8af0: 32 36 2c 20 27 45 53 52 49 27 2c 20 30 2c 20 30  26, 'ESRI', 0, 0
8b00: 29 3b 20 2d 2d 20 45 53 52 49 20 73 74 79 6c 65  ); -- ESRI style
8b10: 2c 20 6d 6f 6e 6f 6c 69 74 68 69 63 20 6c 69 6e  , monolithic lin
8b20: 65 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  e..-------------
8b30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
8b40: 2d 0d 0a 47 45 4f 47 43 53 5b 22 47 43 53 5f 57  -..GEOGCS["GCS_W
8b50: 47 53 5f 31 39 38 34 22 2c 44 41 54 55 4d 5b 22  GS_1984",DATUM["
8b60: 44 5f 57 47 53 5f 31 39 38 34 22 2c 53 50 48 45  D_WGS_1984",SPHE
8b70: 52 4f 49 44 5b 22 57 47 53 5f 31 39 38 34 22 2c  ROID["WGS_1984",
8b80: 36 33 37 38 31 33 37 2e 30 2c 32 39 38 2e 32 35  6378137.0,298.25
8b90: 37 32 32 33 35 36 33 5d 5d 2c 50 52 49 4d 45 4d  7223563]],PRIMEM
8ba0: 5b 22 47 72 65 65 6e 77 69 63 68 22 2c 30 2e 30  ["Greenwich",0.0
8bb0: 5d 2c 55 4e 49 54 5b 22 44 65 67 72 65 65 22 2c  ],UNIT["Degree",
8bc0: 30 2e 30 31 37 34 35 33 32 39 32 35 31 39 39 34  0.01745329251994
8bd0: 33 33 5d 5d 0d 0a 0d 0a 53 45 4c 45 43 54 20 50  33]]....SELECT P
8be0: 52 4f 4a 5f 47 75 65 73 73 53 72 69 64 46 72 6f  ROJ_GuessSridFro
8bf0: 6d 57 4b 54 28 27 47 45 4f 47 43 53 5b 22 47 43  mWKT('GEOGCS["GC
8c00: 53 5f 4d 6f 6e 74 65 5f 4d 61 72 69 6f 5f 52 6f  S_Monte_Mario_Ro
8c10: 6d 65 22 2c 44 41 54 55 4d 5b 22 44 5f 4d 6f 6e  me",DATUM["D_Mon
8c20: 74 65 5f 4d 61 72 69 6f 22 2c 53 50 48 45 52 4f  te_Mario",SPHERO
8c30: 49 44 5b 22 49 6e 74 65 72 6e 61 74 69 6f 6e 61  ID["Internationa
8c40: 6c 5f 31 39 32 34 22 2c 36 33 37 38 33 38 38 2e  l_1924",6378388.
8c50: 30 2c 32 39 37 2e 30 5d 5d 2c 50 52 49 4d 45 4d  0,297.0]],PRIMEM
8c60: 5b 22 52 6f 6d 65 22 2c 31 32 2e 34 35 32 33 33  ["Rome",12.45233
8c70: 33 33 33 33 33 33 33 33 5d 2c 55 4e 49 54 5b 22  33333333],UNIT["
8c80: 44 65 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33  Degree",0.017453
8c90: 32 39 32 35 31 39 39 34 33 33 5d 5d 27 29 3b 20  2925199433]]'); 
8ca0: 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ..--------------
8cb0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
8cc0: 0d 0a 34 38 30 36 0d 0a 0d 0a 53 45 4c 45 43 54  ..4806....SELECT
8cd0: 20 50 52 4f 4a 5f 47 75 65 73 73 53 72 69 64 46   PROJ_GuessSridF
8ce0: 72 6f 6d 53 48 50 28 27 2f 68 6f 6d 65 2f 73 61  romSHP('/home/sa
8cf0: 6e 64 72 6f 2f 74 75 73 63 61 6e 79 5f 73 68 70  ndro/tuscany_shp
8d00: 2f 70 72 6f 76 32 30 31 31 27 29 3b 20 2d 2d 20  /prov2011'); -- 
8d10: 72 65 6d 65 6d 62 65 72 3a 20 72 65 71 75 69 72  remember: requir
8d20: 65 73 20 74 6f 20 65 78 70 6c 69 63 69 74 6c 79  es to explicitly
8d30: 20 73 65 74 20 53 50 41 54 49 41 4c 49 54 45 5f   set SPATIALITE_
8d40: 53 45 43 55 52 49 54 59 3d 72 65 6c 61 78 65 64  SECURITY=relaxed
8d50: 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ..--------------
8d60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
8d70: 0d 0a 33 30 30 33 0d 0a 3c 2f 76 65 72 62 61 74  ..3003..</verbat
8d80: 69 6d 3e 0d 0a 3c 62 72 3e 0d 0a 3c 68 72 3e 3c  im>..<br>..<hr><
8d90: 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c  br>..<table cell
8da0: 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c  spacing="8" cell
8db0: 70 61 64 64 69 6e 67 3d 22 38 22 20 62 67 63 6f  padding="8" bgco
8dc0: 6c 6f 72 3d 22 23 66 66 65 30 65 39 22 20 77 69  lor="#ffe0e9" wi
8dd0: 64 74 68 3d 22 31 30 30 25 22 3e 0d 0a 3c 74 72  dth="100%">..<tr
8de0: 3e 3c 74 68 3e 0d 0a 3c 68 31 3e 49 6d 70 6f 72  ><th>..<h1>Impor
8df0: 74 61 6e 74 20 6e 6f 74 69 63 65 20 66 6f 72 20  tant notice for 
8e00: 57 69 6e 64 6f 77 73 20 75 73 65 72 73 3c 2f 68  Windows users</h
8e10: 31 3e 0d 0a 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a  1>..</th></tr>..
8e20: 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 62 3e 50 52 4f  <tr><td>..<b>PRO
8e30: 4a 2e 36 3c 2f 62 3e 20 63 72 69 74 69 63 61 6c  J.6</b> critical
8e40: 6c 79 20 64 65 70 65 6e 64 73 20 6f 6e 20 69 74  ly depends on it
8e50: 73 20 6f 77 6e 20 70 72 69 76 61 74 65 20 53 51  s own private SQ
8e60: 4c 69 74 65 20 64 61 74 61 62 61 73 65 20 28 3c  Lite database (<
8e70: 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e 29 20 63  b>proj.db</b>) c
8e80: 6f 6e 74 61 69 6e 69 6e 67 20 61 6c 6c 20 72 65  ontaining all re
8e90: 6c 65 76 61 6e 74 20 64 65 66 69 6e 69 74 69 6f  levant definitio
8ea0: 6e 73 20 61 62 6f 75 74 20 45 6c 6c 69 70 73 6f  ns about Ellipso
8eb0: 69 64 73 2c 20 50 72 69 6d 65 20 4d 65 72 69 64  ids, Prime Merid
8ec0: 69 61 6e 73 2c 20 43 52 53 65 73 2c 20 54 72 61  ians, CRSes, Tra
8ed0: 6e 73 66 6f 72 6d 61 74 69 6f 6e 73 20 61 6e 64  nsformations and
8ee0: 20 61 6c 69 6b 65 2e 3c 62 72 3e 0d 0a 49 66 20   alike.<br>..If 
8ef0: 50 52 4f 4a 2e 36 20 69 73 20 75 6e 61 62 6c 65  PROJ.6 is unable
8f00: 20 74 6f 20 63 6f 72 72 65 63 74 6c 79 20 65 73   to correctly es
8f10: 74 61 62 6c 69 73 68 20 61 20 63 6f 6e 6e 65 63  tablish a connec
8f20: 74 69 6f 6e 20 74 6f 20 74 68 69 73 20 64 61 74  tion to this dat
8f30: 61 62 61 73 65 20 69 74 20 77 69 6c 6c 20 62 65  abase it will be
8f40: 20 73 65 76 65 72 65 6c 79 20 6c 69 6d 69 74 65   severely limite
8f50: 64 20 61 6e 64 20 77 69 6c 6c 20 6e 6f 74 20 62  d and will not b
8f60: 65 20 61 62 6c 65 20 74 6f 20 63 6f 72 72 65 63  e able to correc
8f70: 74 6c 79 20 62 65 68 61 76 65 20 61 73 20 65 78  tly behave as ex
8f80: 70 65 63 74 65 64 2e 3c 62 72 3e 3c 62 72 3e 0d  pected.<br><br>.
8f90: 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 3c 75  .<ul>..<li><b><u
8fa0: 3e 3c 69 3e 53 68 6f 72 74 20 63 6f 6e 63 6c 75  ><i>Short conclu
8fb0: 73 69 6f 6e 3c 2f 69 3e 3c 2f 75 3e 3c 2f 62 3e  sion</i></u></b>
8fc0: 3a 20 69 6e 73 74 61 6c 6c 69 6e 67 20 74 68 65  : installing the
8fd0: 20 73 6f 66 74 77 61 72 65 20 61 6c 6f 6e 65 20   software alone 
8fe0: 69 73 20 6e 6f 74 20 65 6e 6f 75 67 68 2e 3c 62  is not enough.<b
8ff0: 72 3e 0d 0a 54 68 65 20 50 52 4f 4a 2e 36 20 70  r>..The PROJ.6 p
9000: 72 69 76 61 74 65 20 64 61 74 61 62 61 73 65 20  rivate database 
9010: 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20 6d  <b>proj.db</b> m
9020: 75 73 74 20 62 65 20 70 72 6f 70 65 72 6c 79 20  ust be properly 
9030: 69 6e 73 74 61 6c 6c 65 64 20 61 73 20 77 65 6c  installed as wel
9040: 6c 2c 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 65  l, in order to e
9050: 6e 73 75 72 65 20 74 68 61 74 20 61 6e 79 74 68  nsure that anyth
9060: 69 6e 67 20 72 75 6e 73 20 73 6d 6f 6f 74 68 6c  ing runs smoothl
9070: 79 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62  y.</li>..</ul><b
9080: 72 3e 0d 0a 54 68 69 73 20 69 73 6e 27 74 20 75  r>..This isn't u
9090: 73 75 61 6c 6c 79 20 61 20 62 69 67 20 69 73 73  sually a big iss
90a0: 75 65 20 6f 6e 20 4c 69 6e 75 78 20 61 6e 64 20  ue on Linux and 
90b0: 55 6e 69 78 2d 6c 69 6b 65 20 70 6c 61 74 66 6f  Unix-like platfo
90c0: 72 6d 73 2c 20 77 68 65 72 65 20 61 20 72 61 74  rms, where a rat
90d0: 69 6f 6e 61 6c 20 61 6e 64 20 76 65 72 79 20 63  ional and very c
90e0: 6c 65 61 72 20 66 69 6c 65 73 79 73 74 65 6d 20  lear filesystem 
90f0: 6c 61 79 6f 75 74 20 65 78 69 73 74 73 2e 3c 62  layout exists.<b
9100: 72 3e 0d 0a 4f 6e 20 74 68 65 73 65 20 6f 70 65  r>..On these ope
9110: 72 61 74 69 6e 67 20 73 79 73 74 65 6d 73 20 74  rating systems t
9120: 68 65 20 70 61 63 6b 61 67 65 20 6d 61 6e 61 67  he package manag
9130: 65 72 20 28 6f 72 20 3c 62 3e 6d 61 6b 65 20 69  er (or <b>make i
9140: 6e 73 74 61 6c 6c 3c 2f 62 3e 29 20 77 69 6c 6c  nstall</b>) will
9150: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 74   automatically t
9160: 61 6b 65 20 63 61 72 65 20 74 6f 20 69 6e 73 74  ake care to inst
9170: 61 6c 6c 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f  all <b>proj.db</
9180: 62 3e 20 6f 6e 20 74 68 65 20 6d 6f 73 74 20 61  b> on the most a
9190: 70 70 72 6f 70 72 69 61 74 65 20 64 69 72 65 63  ppropriate direc
91a0: 74 6f 72 79 20 28 75 73 75 61 6c 6c 79 20 61 73  tory (usually as
91b0: 20 3c 62 3e 2f 75 73 72 2f 73 68 61 72 65 2f 70   <b>/usr/share/p
91c0: 72 6f 6a 2f 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20  roj/proj.db</b> 
91d0: 6f 72 20 61 73 20 3c 62 3e 2f 75 73 72 2f 6c 6f  or as <b>/usr/lo
91e0: 63 61 6c 2f 73 68 61 72 65 2f 70 72 6f 6a 2f 70  cal/share/proj/p
91f0: 72 6f 6a 2e 64 62 3c 2f 62 3e 29 20 61 6e 64 20  roj.db</b>) and 
9200: 74 68 61 74 27 73 20 61 6c 6c 2e 3c 62 72 3e 3c  that's all.<br><
9210: 62 72 3e 0d 0a 54 68 69 6e 67 73 20 61 72 65 20  br>..Things are 
9220: 75 6e 68 61 70 70 69 6c 79 20 61 20 6c 69 74 74  unhappily a litt
9230: 6c 65 20 62 69 74 20 6d 6f 72 65 20 64 69 66 66  le bit more diff
9240: 69 63 75 6c 74 73 20 6f 6e 20 57 69 6e 64 6f 77  icults on Window
9250: 73 20 70 6c 61 74 66 6f 72 6d 73 2e 0d 0a 54 68  s platforms...Th
9260: 65 20 75 73 65 72 20 69 74 73 65 6c 66 20 69 73  e user itself is
9270: 20 72 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72   responsible for
9280: 20 70 72 6f 70 65 72 6c 79 20 69 6e 73 74 61 6c   properly instal
9290: 6c 69 6e 67 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c  ling <b>proj.db<
92a0: 2f 62 3e 0d 0a 53 6f 20 69 74 20 62 65 63 6f 6d  /b>..So it becom
92b0: 65 73 20 63 72 69 74 69 63 61 6c 20 75 6e 64 65  es critical unde
92c0: 72 73 74 61 6e 64 69 6e 67 20 74 68 65 20 62 61  rstanding the ba
92d0: 73 69 63 20 72 75 6c 65 73 20 61 64 6f 70 74 65  sic rules adopte
92e0: 64 20 62 79 20 3c 62 3e 6c 69 62 73 70 61 74 69  d by <b>libspati
92f0: 61 6c 69 74 65 3c 2f 62 3e 20 69 6e 20 6f 72 64  alite</b> in ord
9300: 65 72 20 74 6f 20 70 72 6f 70 65 72 6c 79 20 6c  er to properly l
9310: 6f 63 61 74 65 20 3c 62 3e 70 72 6f 6a 2e 64 62  ocate <b>proj.db
9320: 3c 2f 62 3e 20 6f 6e 20 57 69 6e 64 6f 77 73 2e  </b> on Windows.
9330: 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74  ..</td></tr>..<t
9340: 72 3e 3c 74 68 3e 0d 0a 3c 68 32 3e 57 68 65 72  r><th>..<h2>Wher
9350: 65 20 70 72 6f 6a 2e 64 62 20 69 73 20 65 78 70  e proj.db is exp
9360: 65 63 74 65 64 20 74 6f 20 62 65 20 66 6f 75 6e  ected to be foun
9370: 64 20 6f 6e 20 57 69 6e 64 6f 77 73 3c 2f 68 32  d on Windows</h2
9380: 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c  >..</td></tr>..<
9390: 74 72 3e 3c 74 64 3e 0d 0a 3c 6f 6c 3e 0d 0a 3c  tr><td>..<ol>..<
93a0: 6c 69 3e 74 68 65 20 66 69 72 73 74 20 70 6c 61  li>the first pla
93b0: 63 65 20 77 68 65 72 65 20 3c 62 3e 70 72 6f 6a  ce where <b>proj
93c0: 2e 64 62 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20  .db</b> will be 
93d0: 73 65 61 72 63 68 65 64 20 69 73 20 74 68 65 20  searched is the 
93e0: 73 61 6d 65 20 66 6f 6c 64 65 72 20 66 6f 72 6d  same folder form
93f0: 20 77 68 65 72 65 20 74 68 65 20 3c 62 3e 45 58   where the <b>EX
9400: 45 3c 2f 62 3e 20 62 69 6e 61 72 79 20 77 61 73  E</b> binary was
9410: 20 69 6e 69 74 69 61 6c 6c 79 20 6c 6f 61 64 65   initially loade
9420: 64 2e 3c 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 45 78  d.<br>..<i><u>Ex
9430: 61 6d 70 6c 65 3c 2f 69 3e 3c 2f 75 3e 3a 20 61  ample</i></u>: a
9440: 73 73 75 6d 69 6e 67 20 74 68 61 74 20 79 6f 75  ssuming that you
9450: 20 61 72 65 20 63 75 72 72 65 6e 74 6c 79 20 65   are currently e
9460: 78 65 63 75 74 69 6e 67 20 3c 62 3e 43 3a 5c 6d  xecuting <b>C:\m
9470: 79 70 72 6f 67 73 5c 73 70 61 74 69 61 6c 69 74  yprogs\spatialit
9480: 65 5c 62 69 6e 5c 73 70 61 74 69 61 6c 69 74 65  e\bin\spatialite
9490: 2e 65 78 65 3c 2f 62 3e 0d 0a 3c 75 6c 3e 0d 0a  .exe</b>..<ul>..
94a0: 3c 6c 69 3e 74 68 65 6e 20 61 6e 20 61 74 74 65  <li>then an atte
94b0: 6d 70 74 20 77 69 6c 6c 20 62 65 20 6d 61 64 65  mpt will be made
94c0: 20 74 6f 20 63 6f 6e 6e 65 63 74 20 3c 62 3e 43   to connect <b>C
94d0: 3a 5c 6d 79 70 72 6f 67 73 5c 73 70 61 74 69 61  :\myprogs\spatia
94e0: 6c 69 74 65 5c 62 69 6e 5c 70 72 6f 6a 2e 64 62  lite\bin\proj.db
94f0: 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e  </b></li>..</ul>
9500: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 61 20 73 65 63  </li>..<li>a sec
9510: 6f 6e 64 20 61 74 74 65 6d 70 74 20 77 69 6c 6c  ond attempt will
9520: 20 62 65 20 6d 61 64 65 20 6f 6e 20 62 65 68 61   be made on beha
9530: 6c 66 20 6f 66 20 74 68 65 20 3c 62 3e 50 75 62  lf of the <b>Pub
9540: 6c 69 63 3c 2f 62 3e 20 66 6f 6c 64 65 72 2e 3c  lic</b> folder.<
9550: 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 45 78 61 6d 70  br>..<i><u>Examp
9560: 6c 65 3c 2f 75 3e 3c 2f 69 3e 3a 20 61 6e 20 61  le</u></i>: an a
9570: 74 74 65 6d 70 74 20 77 69 6c 6c 20 62 65 20 6d  ttempt will be m
9580: 61 64 65 20 74 6f 20 63 6f 6e 6e 65 63 74 20 3c  ade to connect <
9590: 62 3e 43 3a 5c 55 73 65 72 73 5c 50 75 62 6c 69  b>C:\Users\Publi
95a0: 63 5c 73 70 61 74 69 61 6c 69 74 65 5c 70 72 6f  c\spatialite\pro
95b0: 6a 5c 70 72 6f 6a 2e 64 62 3c 2f 62 3e 3c 2f 6c  j\proj.db</b></l
95c0: 69 3e 0d 0a 3c 6c 69 3e 61 20 74 68 69 72 64 20  i>..<li>a third 
95d0: 28 61 6e 64 20 6c 61 73 74 29 20 61 74 74 65 6d  (and last) attem
95e0: 70 74 20 77 69 6c 6c 20 62 65 20 6d 61 64 65 20  pt will be made 
95f0: 6f 6e 20 62 65 68 61 6c 66 20 6f 66 20 74 68 65  on behalf of the
9600: 20 3c 62 3e 55 73 65 72 3c 2f 62 3e 20 66 6f 6c   <b>User</b> fol
9610: 64 65 72 2e 3c 62 72 3e 0d 0a 3c 69 3e 3c 75 3e  der.<br>..<i><u>
9620: 45 78 61 6d 70 6c 65 3c 2f 69 3e 3c 2f 75 3e 3a  Example</i></u>:
9630: 20 61 6e 20 61 74 74 65 6d 70 74 20 77 69 6c 6c   an attempt will
9640: 20 62 65 20 6d 61 64 65 20 74 6f 20 63 6f 6e 6e   be made to conn
9650: 65 63 74 20 3c 62 3e 43 3a 5c 55 73 65 72 73 5c  ect <b>C:\Users\
9660: 73 61 6e 64 72 6f 5c 73 70 61 74 69 61 6c 69 74  sandro\spatialit
9670: 65 5c 70 72 6f 6a 5c 70 72 6f 6a 2e 64 62 3c 2f  e\proj\proj.db</
9680: 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 6f 6c 3e 0d 0a  b></li>..</ol>..
9690: 3c 68 33 3e 41 6e 20 75 73 65 66 75 6c 20 64 69  <h3>An useful di
96a0: 61 67 6e 6f 73 74 69 63 20 63 68 65 63 6b 3c 2f  agnostic check</
96b0: 68 33 3e 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d  h3>..<verbatim>.
96c0: 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f 47 65 74  .SELECT PROJ_Get
96d0: 44 61 74 61 62 61 73 65 50 61 74 68 28 29 3b 0d  DatabasePath();.
96e0: 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 3c 75  .</verbatim>..<u
96f0: 6c 3e 0d 0a 3c 6c 69 3e 69 66 20 3c 62 3e 4e 55  l>..<li>if <b>NU
9700: 4c 4c 3c 2f 62 3e 20 69 73 20 72 65 74 75 72 6e  LL</b> is return
9710: 65 64 2c 20 74 68 65 6e 20 50 52 4f 4a 2e 36 20  ed, then PROJ.6 
9720: 69 73 20 64 65 66 69 6e 69 74 65 6c 79 20 75 6e  is definitely un
9730: 61 62 6c 65 20 74 6f 20 63 6f 6e 6e 65 63 74 20  able to connect 
9740: 74 6f 20 69 74 73 20 6f 77 6e 20 70 72 69 76 61  to its own priva
9750: 74 65 20 53 51 4c 69 74 65 20 64 61 74 61 62 61  te SQLite databa
9760: 73 65 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62  se <b>proj.db</b
9770: 3e 3c 62 72 3e 0d 0a 59 6f 75 20 68 61 76 65 20  ><br>..You have 
9780: 74 6f 20 63 61 72 65 66 75 6c 6c 79 20 76 65 72  to carefully ver
9790: 69 66 69 79 20 74 68 61 74 20 69 74 27 73 20 72  ifiy that it's r
97a0: 65 61 6c 6c 79 20 69 6e 73 74 61 6c 6c 65 64 20  eally installed 
97b0: 6f 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 65 78  on one of the ex
97c0: 70 65 63 74 65 64 20 73 74 61 6e 64 61 72 64 20  pected standard 
97d0: 6c 6f 63 61 74 69 6f 6e 73 2e 3c 2f 6c 69 3e 0d  locations.</li>.
97e0: 0a 3c 6c 69 3e 6f 74 68 65 72 77 69 73 65 20 74  .<li>otherwise t
97f0: 68 65 20 70 61 74 68 20 6c 65 61 64 69 6e 67 20  he path leading 
9800: 74 6f 20 74 68 65 20 63 75 72 72 65 6e 74 6c 79  to the currently
9810: 20 63 6f 6e 6e 65 63 74 65 64 20 3c 62 3e 70 72   connected <b>pr
9820: 6f 6a 2e 64 62 3c 2f 62 3e 20 77 69 6c 6c 20 62  oj.db</b> will b
9830: 65 20 72 65 74 75 72 6e 65 64 2e 3c 2f 6c 69 3e  e returned.</li>
9840: 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 0d 0a 3c 2f 74  ..</ul><br>..</t
9850: 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65  d></tr>..</table
9860: 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c  ><br><br>..<tabl
9870: 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38  e cellspacing="8
9880: 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 38  " cellpadding="8
9890: 22 20 62 67 63 6f 6c 6f 72 3d 22 23 63 39 66 66  " bgcolor="#c9ff
98a0: 66 30 22 20 77 69 64 74 68 3d 22 31 30 30 25 22  f0" width="100%"
98b0: 3e 0d 0a 3c 74 72 3e 3c 74 68 3e 0d 0a 3c 68 32  >..<tr><th>..<h2
98c0: 3e 55 73 69 6e 67 20 74 68 65 20 65 6e 76 69 72  >Using the envir
98d0: 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20  onment variable 
98e0: 53 50 41 54 49 41 4c 49 54 45 5f 50 52 4f 4a 5f  SPATIALITE_PROJ_
98f0: 44 42 5f 50 41 54 48 3c 2f 68 32 3e 0d 0a 3c 2f  DB_PATH</h2>..</
9900: 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74  th></tr>..<tr><t
9910: 64 3e 0d 0a 49 66 20 74 68 65 20 65 6e 76 69 72  d>..If the envir
9920: 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20  onment variable 
9930: 3c 62 3e 53 50 41 54 49 41 4c 49 54 45 5f 50 52  <b>SPATIALITE_PR
9940: 4f 4a 5f 44 42 5f 50 41 54 48 3c 2f 62 3e 20 69  OJ_DB_PATH</b> i
9950: 73 20 73 65 74 2c 20 74 68 65 6e 20 3c 62 3e 6c  s set, then <b>l
9960: 69 62 73 70 61 74 69 61 6c 69 74 65 3c 2f 62 3e  ibspatialite</b>
9970: 20 77 69 6c 6c 20 73 69 6d 70 6c 79 20 61 74 74   will simply att
9980: 65 6d 70 74 20 74 6f 20 63 6f 6e 6e 65 63 74 20  empt to connect 
9990: 74 68 65 20 64 61 74 61 62 61 73 65 20 70 6f 69  the database poi
99a0: 6e 74 65 64 20 62 79 20 74 68 69 73 20 76 61 72  nted by this var
99b0: 69 61 62 6c 65 2e 3c 62 72 3e 0d 0a 53 75 63 68  iable.<br>..Such
99c0: 20 61 20 63 61 70 61 62 69 6c 69 74 79 20 69 73   a capability is
99d0: 20 73 75 70 70 6f 72 74 65 64 20 6e 6f 74 20 6f   supported not o
99e0: 6e 6c 79 20 6f 6e 20 57 69 6e 64 6f 77 73 20 62  nly on Windows b
99f0: 75 74 20 61 6c 73 6f 20 6f 6e 20 4c 69 6e 75 78  ut also on Linux
9a00: 20 28 61 6e 64 20 6f 6e 20 61 6e 79 20 6f 74 68   (and on any oth
9a10: 65 72 20 70 6c 61 74 66 6f 72 6d 29 2e 3c 62 72  er platform).<br
9a20: 3e 3c 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 4c 69 6e  ><br>..<i><u>Lin
9a30: 75 78 20 65 78 61 6d 70 6c 65 3c 2f 75 3e 3c 2f  ux example</u></
9a40: 69 3e 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c  i>:..<ul>..<li><
9a50: 62 3e 65 78 70 6f 72 74 20 22 53 50 41 54 49 41  b>export "SPATIA
9a60: 4c 49 54 45 5f 50 52 4f 4a 5f 44 42 5f 50 41 54  LITE_PROJ_DB_PAT
9a70: 48 3d 2f 68 6f 6d 65 2f 73 61 6e 64 72 6f 2f 61  H=/home/sandro/a
9a80: 75 78 2f 70 72 6f 6a 2e 64 62 22 3c 62 72 3e 0d  ux/proj.db"<br>.
9a90: 0a 65 63 68 6f 20 24 53 50 41 54 49 41 4c 49 54  .echo $SPATIALIT
9aa0: 45 5f 50 52 4f 4a 5f 44 42 5f 50 41 54 48 3c 62  E_PROJ_DB_PATH<b
9ab0: 72 3e 0d 0a 73 70 61 74 69 61 6c 69 74 65 3c 62  r>..spatialite<b
9ac0: 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72  ></li>..</ul><br
9ad0: 3e 3c 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 57 69 6e  ><br>..<i><u>Win
9ae0: 64 6f 77 73 20 65 78 61 6d 70 6c 65 3c 2f 75 3e  dows example</u>
9af0: 3c 2f 69 3e 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69  </i>:..<ul>..<li
9b00: 3e 3c 62 3e 53 45 54 20 53 50 41 54 49 41 4c 49  ><b>SET SPATIALI
9b10: 54 45 5f 50 52 4f 4a 5f 44 42 5f 50 41 54 48 3d  TE_PROJ_DB_PATH=
9b20: 43 3a 5c 55 73 65 72 73 5c 73 61 6e 64 72 6f 5c  C:\Users\sandro\
9b30: 61 75 78 5c 70 72 6f 6a 2e 64 62 3c 62 72 3e 0d  aux\proj.db<br>.
9b40: 0a 65 63 68 6f 20 25 53 50 41 54 49 41 4c 49 54  .echo %SPATIALIT
9b50: 45 5f 50 52 4f 4a 5f 44 42 5f 50 41 54 48 25 3c  E_PROJ_DB_PATH%<
9b60: 62 72 3e 0d 0a 73 70 61 74 69 61 6c 69 74 65 5f  br>..spatialite_
9b70: 67 75 69 3c 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75  gui<b></li>..</u
9b80: 6c 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 2f 74 68  l><br><br>..</th
9b90: 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e  ></tr>..</table>
9ba0: 3c 62 72 3e 0d 0a 3c 68 72 3e 3c 62 72 3e 0d 0a  <br>..<hr><br>..
9bb0: 3c 61 20 68 72 65 66 3d 22 68 74 74 70 73 3a 2f  <a href="https:/
9bc0: 2f 77 77 77 2e 67 61 69 61 2d 67 69 73 2e 69 74  /www.gaia-gis.it
9bd0: 2f 66 6f 73 73 69 6c 2f 6c 69 62 73 70 61 74 69  /fossil/libspati
9be0: 61 6c 69 74 65 2f 77 69 6b 69 3f 6e 61 6d 65 3d  alite/wiki?name=
9bf0: 34 2e 33 2e 30 2d 64 6f 63 22 3e 62 61 63 6b 3c  4.3.0-doc">back<
9c00: 2f 61 3e 0a 5a 20 66 35 63 65 64 36 63 36 39 30  /a>.Z f5ced6c690
9c10: 66 37 33 32 32 36 32 62 37 65 39 31 61 35 33 62  f732262b7e91a53b
9c20: 31 38 31 65 35 66 0a                             181e5f.