Hex Artifact Content
Not logged in

Artifact ce4e33e400b1782aa87042cb94c827a85ec73646:

Wiki page [PROJ.6] by sandro 2019-04-24 18:00:48.
0000: 44 20 32 30 31 39 2d 30 34 2d 32 34 54 31 38 3a  D 2019-04-24T18:
0010: 30 30 3a 34 38 2e 34 33 30 0a 4c 20 50 52 4f 4a  00:48.430.L PROJ
0020: 2e 36 0a 50 20 32 39 66 35 32 66 66 34 37 61 35  .6.P 29f52ff47a5
0030: 32 37 62 31 31 33 37 61 63 32 35 32 63 39 34 33  27b1137ac252c943
0040: 37 61 64 35 63 30 66 38 37 38 65 32 61 0a 55 20  7ad5c0f878e2a.U 
0050: 73 61 6e 64 72 6f 0a 57 20 33 32 35 31 33 0a 3c  sandro.W 32513.<
0060: 61 20 68 72 65 66 3d 22 68 74 74 70 73 3a 2f 2f  a href="https://
0070: 77 77 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 2f  www.gaia-gis.it/
0080: 66 6f 73 73 69 6c 2f 6c 69 62 73 70 61 74 69 61  fossil/libspatia
0090: 6c 69 74 65 2f 77 69 6b 69 3f 6e 61 6d 65 3d 34  lite/wiki?name=4
00a0: 2e 33 2e 30 2d 64 6f 63 22 3e 62 61 63 6b 3c 2f  .3.0-doc">back</
00b0: 61 3e 3c 68 72 3e 3c 62 72 3e 0d 0a 3c 68 31 3e  a><hr><br>..<h1>
00c0: 49 6e 74 72 6f 64 75 63 74 69 6f 6e 3c 2f 68 31  Introduction</h1
00d0: 3e 0d 0a 3c 62 3e 50 52 4f 4a 3c 2f 62 3e 20 69  >..<b>PROJ</b> i
00e0: 73 20 61 20 77 65 6c 6c 2d 6b 6e 6f 77 6e 20 6c  s a well-known l
00f0: 69 62 72 61 72 79 20 66 6f 72 20 70 65 72 66 6f  ibrary for perfo
0100: 72 6d 69 6e 67 20 63 6f 6e 76 65 72 73 69 6f 6e  rming conversion
0110: 73 20 62 65 74 77 65 65 6e 20 63 61 72 74 6f 67  s between cartog
0120: 72 61 70 68 69 63 20 70 72 6f 6a 65 63 74 69 6f  raphic projectio
0130: 6e 73 2e 3c 62 72 3e 0d 0a 49 74 27 73 20 75 6e  ns.<br>..It's un
0140: 69 76 65 72 73 61 6c 6c 79 20 73 75 70 70 6f 72  iversally suppor
0150: 74 65 64 20 62 79 20 61 6c 6d 6f 73 74 20 61 6c  ted by almost al
0160: 6c 20 6f 70 65 6e 20 73 6f 75 72 63 65 20 47 49  l open source GI
0170: 53 2d 6f 72 69 65 6e 74 65 64 20 61 70 70 6c 69  S-oriented appli
0180: 63 61 74 69 6f 6e 73 20 61 6e 64 20 70 61 63 6b  cations and pack
0190: 61 67 65 73 2c 20 73 6f 20 74 68 65 72 65 20 69  ages, so there i
01a0: 73 20 6e 6f 20 6e 65 65 64 20 74 6f 20 77 61 73  s no need to was
01b0: 74 65 20 74 69 6d 65 20 69 6e 20 66 75 74 68 65  te time in futhe
01c0: 72 20 70 72 65 73 65 6e 74 61 74 69 6f 6e 73 2e  r presentations.
01d0: 3c 62 72 3e 0d 0a 57 65 20 6a 75 73 74 20 6e 65  <br>..We just ne
01e0: 65 64 20 61 20 62 69 74 20 6f 66 20 68 69 73 74  ed a bit of hist
01f0: 6f 72 79 20 74 6f 20 66 75 6c 6c 79 20 75 6e 64  ory to fully und
0200: 65 72 73 74 61 6e 64 20 74 68 65 20 63 75 72 72  erstand the curr
0210: 65 6e 74 20 73 74 61 74 65 2d 6f 66 2d 74 68 65  ent state-of-the
0220: 2d 61 72 74 3a 3c 62 72 3e 3c 62 72 3e 0d 0a 54  -art:<br><br>..T
0230: 69 6d 65 6c 69 6e 65 3a 0d 0a 3c 75 6c 3e 0d 0a  imeline:..<ul>..
0240: 3c 6c 69 3e 56 65 72 79 20 66 65 77 20 75 73 65  <li>Very few use
0250: 72 73 20 61 6e 64 20 64 65 76 65 6c 6f 70 65 72  rs and developer
0260: 73 20 64 6f 20 72 65 61 6c 6c 79 20 72 65 61 6c  s do really real
0270: 69 7a 65 20 68 6f 77 20 61 6e 63 69 65 6e 74 20  ize how ancient 
0280: 69 73 20 50 52 4f 4a 2c 20 61 6e 64 20 68 6f 77  is PROJ, and how
0290: 20 66 61 72 20 69 6e 20 74 69 6d 65 20 69 74 20   far in time it 
02a0: 73 74 61 72 74 65 64 20 6d 6f 76 69 6e 67 20 69  started moving i
02b0: 74 73 20 66 69 72 73 74 20 73 74 65 70 73 2e 3c  ts first steps.<
02c0: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 69 6e 20 3c 62 3e  /li>..<li>in <b>
02d0: 31 39 38 30 3c 2f 62 3e 20 28 61 62 6f 75 74 20  1980</b> (about 
02e0: 34 30 20 79 65 61 72 73 20 61 67 6f 29 20 47 65  40 years ago) Ge
02f0: 72 61 6c 64 20 45 76 65 6e 64 65 6e 20 73 74 61  rald Evenden sta
0300: 72 74 65 64 20 77 6f 72 6b 69 6e 67 20 6f 6e 20  rted working on 
0310: 74 68 65 20 76 65 72 79 20 66 69 72 73 74 20 50  the very first P
0320: 52 4f 4a 20 76 65 72 73 69 6f 6e 2c 20 61 6e 64  ROJ version, and
0330: 20 61 74 20 74 68 65 20 74 69 6d 65 20 69 74 20   at the time it 
0340: 77 61 73 20 61 20 52 61 74 66 6f 72 20 70 72 6f  was a Ratfor pro
0350: 67 72 61 6d 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e  gram.</li>..<li>
0360: 69 6e 20 3c 62 3e 31 39 38 35 3c 2f 62 3e 20 74  in <b>1985</b> t
0370: 68 65 20 63 6f 64 65 20 77 61 73 20 63 6f 6d 70  he code was comp
0380: 6c 65 74 65 6c 79 20 72 65 77 72 69 74 74 65 6e  letely rewritten
0390: 20 69 6e 20 43 20 74 6f 20 72 75 6e 20 6f 6e 20   in C to run on 
03a0: 55 4e 49 58 20 73 79 73 74 65 6d 73 2c 20 61 6e  UNIX systems, an
03b0: 64 20 69 74 20 77 61 73 20 6e 61 6d 65 64 20 3c  d it was named <
03c0: 62 3e 50 52 4f 4a 2e 32 3c 2f 62 3e 2e 3c 2f 6c  b>PROJ.2</b>.</l
03d0: 69 3e 0d 0a 3c 6c 69 3e 69 6e 20 3c 62 3e 31 39  i>..<li>in <b>19
03e0: 39 30 3c 2f 62 3e 20 77 61 73 20 72 65 6c 65 61  90</b> was relea
03f0: 73 65 64 20 61 6e 20 75 70 64 61 74 65 64 20 76  sed an updated v
0400: 65 72 73 69 6f 6e 20 6e 61 6d 65 64 20 3c 62 3e  ersion named <b>
0410: 50 52 4f 4a 2e 33 3c 2f 6c 69 3e 0d 0a 3c 6c 69  PROJ.3</li>..<li
0420: 3e 69 6e 20 3c 62 3e 31 39 39 34 3c 2f 62 3e 20  >in <b>1994</b> 
0430: 61 20 6d 6f 72 65 20 61 64 76 61 6e 63 65 64 20  a more advanced 
0440: 76 65 72 73 69 6f 6e 20 77 61 73 20 72 65 6c 65  version was rele
0450: 61 73 65 64 2c 20 61 6e 64 20 69 74 20 77 61 73  ased, and it was
0460: 20 6f 62 76 69 6f 75 73 6c 79 20 6e 61 6d 65 64   obviously named
0470: 20 3c 62 3e 50 52 4f 4a 2e 34 3c 2f 62 3e 3c 2f   <b>PROJ.4</b></
0480: 6c 69 3e 0d 0a 3c 6c 69 3e 69 6e 20 3c 62 3e 31  li>..<li>in <b>1
0490: 39 39 35 3c 2f 62 3e 20 45 76 65 6e 64 65 6e 20  995</b> Evenden 
04a0: 73 74 6f 70 70 65 64 20 61 6e 79 20 66 75 72 74  stopped any furt
04b0: 68 65 72 20 64 65 76 65 6c 6f 70 6d 65 6e 74 20  her development 
04c0: 61 63 74 69 76 69 74 79 20 61 6e 64 20 74 68 65  activity and the
04d0: 20 70 72 6f 6a 65 63 74 20 62 65 63 6f 6d 65 20   project become 
04e0: 69 6e 61 63 74 69 76 65 20 66 6f 72 20 73 65 76  inactive for sev
04f0: 65 72 61 6c 20 79 65 61 72 73 2e 3c 2f 6c 69 3e  eral years.</li>
0500: 0d 0a 3c 6c 69 3e 69 6e 20 3c 62 3e 32 30 30 30  ..<li>in <b>2000
0510: 3c 2f 62 3e 20 46 72 61 6e 6b 20 57 61 72 6d 65  </b> Frank Warme
0520: 72 64 61 6d 20 62 61 63 61 6d 65 20 74 68 65 20  rdam bacame the 
0530: 6e 65 77 20 6d 61 69 6e 74 61 69 6e 65 72 20 61  new maintainer a
0540: 6e 64 20 72 65 6c 65 61 73 65 64 20 76 65 72 73  nd released vers
0550: 69 6f 6e 20 3c 62 3e 34 2e 34 3c 2f 62 3e 3c 2f  ion <b>4.4</b></
0560: 6c 69 3e 0d 0a 3c 6c 69 3e 41 66 74 65 72 20 74  li>..<li>After t
0570: 68 69 73 20 72 65 62 6f 72 6e 20 74 68 65 20 72  his reborn the r
0580: 65 76 69 74 61 6c 69 7a 65 64 20 70 72 6f 6a 65  evitalized proje
0590: 63 74 20 63 6f 6e 74 69 6e 75 65 64 20 74 6f 20  ct continued to 
05a0: 62 65 20 72 65 67 75 6c 61 72 6c 79 20 6d 61 69  be regularly mai
05b0: 6e 74 61 69 6e 65 64 2c 20 62 75 74 20 6e 6f 20  ntained, but no 
05c0: 66 75 72 74 68 65 72 20 72 65 6c 65 76 61 6e 74  further relevant
05d0: 20 69 6d 70 72 6f 76 65 6d 65 6e 74 73 20 77 65   improvements we
05e0: 72 65 20 69 6e 74 72 6f 64 75 63 65 64 2e 3c 62  re introduced.<b
05f0: 72 3e 0d 0a 50 52 4f 4a 2e 34 20 6a 75 73 74 20  r>..PROJ.4 just 
0600: 63 6f 6e 74 69 6e 75 65 64 20 69 74 73 20 76 65  continued its ve
0610: 72 79 20 70 6c 61 63 69 64 20 65 76 6f 6c 75 74  ry placid evolut
0620: 69 6f 6e 20 69 6e 20 61 20 73 75 62 73 74 61 6e  ion in a substan
0630: 74 69 61 6c 6c 79 20 63 6f 6e 73 65 72 76 61 74  tially conservat
0640: 69 76 65 20 77 61 79 2e 3c 2f 6c 69 3e 0d 0a 3c  ive way.</li>..<
0650: 2f 75 6c 3e 3c 62 72 3e 0d 0a 3c 62 3e 3c 75 3e  /ul><br>..<b><u>
0660: 53 68 6f 72 74 20 63 6f 6e 63 6c 75 73 69 6f 6e  Short conclusion
0670: 3c 2f 75 3e 3c 2f 62 3e 3a 20 74 68 65 20 66 6f  </u></b>: the fo
0680: 75 72 74 68 20 76 65 72 73 69 6f 6e 20 6f 66 20  urth version of 
0690: 50 52 4f 4a 20 28 61 6b 61 20 3c 62 3e 50 52 4f  PROJ (aka <b>PRO
06a0: 4a 2e 34 3c 2f 62 3e 29 20 6c 61 73 74 65 64 20  J.4</b>) lasted 
06b0: 66 6f 72 20 61 62 6f 75 74 20 74 77 6f 20 64 65  for about two de
06c0: 63 61 64 65 73 2c 20 61 20 76 65 72 79 20 75 6e  cades, a very un
06d0: 63 6f 6d 6d 6f 6e 20 73 69 74 75 61 74 69 6f 6e  common situation
06e0: 2e 3c 62 72 3e 0d 0a 41 6e 64 20 61 20 66 75 6c  .<br>..And a ful
06f0: 6c 20 67 65 6e 65 72 61 74 69 6f 6e 20 6f 66 20  l generation of 
0700: 64 65 76 65 6c 6f 70 65 72 73 20 61 6e 64 20 75  developers and u
0710: 73 65 72 73 20 62 65 63 6f 6d 65 20 73 69 6e 63  sers become sinc
0720: 65 72 6c 79 20 63 6f 6e 76 69 6e 63 65 64 20 74  erly convinced t
0730: 68 61 74 20 50 52 4f 4a 2e 34 20 77 61 73 20 74  hat PROJ.4 was t
0740: 68 65 20 72 65 61 6c 20 6e 61 6d 65 20 6f 66 20  he real name of 
0750: 74 68 65 20 6c 69 62 72 61 72 79 2e 0d 0a 3c 68  the library...<h
0760: 33 3e 54 68 65 20 72 65 76 6f 6c 75 74 69 6f 6e  3>The revolution
0770: 20 63 6f 6d 65 73 3c 2f 68 33 3e 0d 0a 54 69 6d   comes</h3>..Tim
0780: 65 6c 69 6e 65 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c  eline:..<ul>..<l
0790: 69 3e 69 6e 20 3c 62 3e 32 30 31 38 3c 2f 62 3e  i>in <b>2018</b>
07a0: 20 45 76 65 6e 20 52 6f 75 61 75 6c 74 2c 20 4b   Even Rouault, K
07b0: 72 69 73 74 69 61 6e 20 45 76 65 72 73 20 61 6e  ristian Evers an
07c0: 64 20 6f 74 68 65 72 73 20 73 74 61 72 74 20 64  d others start d
07d0: 65 76 65 6c 6f 70 69 6e 67 20 61 20 72 65 76 6f  eveloping a revo
07e0: 6c 75 74 69 6f 6e 69 7a 65 64 20 50 52 4f 4a 20  lutionized PROJ 
07f0: 73 75 70 70 6f 72 74 69 6e 67 20 6d 61 6e 79 20  supporting many 
0800: 72 65 6c 65 76 61 6e 74 20 69 6e 6e 6f 76 61 74  relevant innovat
0810: 69 6f 6e 73 2e 3c 62 72 3e 0d 0a 3c 62 3e 50 52  ions.<br>..<b>PR
0820: 4f 4a 2e 35 3c 2f 62 3e 20 69 73 20 69 6e 74 65  OJ.5</b> is inte
0830: 6e 64 65 64 20 74 6f 20 62 65 20 74 68 65 20 66  nded to be the f
0840: 69 72 73 74 20 70 72 65 6c 69 6d 69 6e 61 72 79  irst preliminary
0850: 20 73 74 65 70 20 6f 66 20 61 20 6d 6f 72 65 20   step of a more 
0860: 63 6f 6d 70 6c 65 78 20 65 76 6f 6c 75 74 69 6f  complex evolutio
0870: 6e 20 73 63 68 65 6d 61 2e 3c 2f 6c 69 3e 0d 0a  n schema.</li>..
0880: 3c 6c 69 3e 6f 6e 20 3c 62 3e 4d 61 72 63 68 20  <li>on <b>March 
0890: 32 30 31 39 3c 2f 62 3e 20 61 20 6d 6f 72 65 20  2019</b> a more 
08a0: 6d 61 74 75 72 65 20 76 65 72 73 69 6f 6e 20 69  mature version i
08b0: 73 20 72 65 6c 65 61 73 65 64 2c 20 61 6e 64 20  s released, and 
08c0: 69 74 27 73 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f  it's <b>PROJ.6</
08d0: 62 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 4e 65 78  b></li>..<li>Nex
08e0: 74 20 79 65 61 72 20 28 32 30 32 30 29 20 3c 62  t year (2020) <b
08f0: 3e 50 52 4f 4a 2e 37 3c 2f 62 3e 20 69 73 20 65  >PROJ.7</b> is e
0900: 78 70 65 63 74 65 64 20 74 6f 20 62 65 20 72 65  xpected to be re
0910: 6c 65 61 73 65 64 2c 20 61 6e 64 20 69 74 20 77  leased, and it w
0920: 69 6c 6c 20 66 75 6c 6c 79 20 63 6f 6d 70 6c 65  ill fully comple
0930: 74 65 20 74 68 65 20 74 72 61 6e 73 69 74 69 6f  te the transitio
0940: 6e 20 62 65 74 77 65 65 6e 20 74 68 65 20 6f 6c  n between the ol
0950: 64 20 61 6e 64 20 6e 65 77 20 61 72 63 68 69 74  d and new archit
0960: 65 63 74 75 72 65 73 2e 3c 2f 6c 69 3e 0d 0a 3c  ectures.</li>..<
0970: 2f 75 6c 3e 0d 0a 3c 62 72 3e 0d 0a 3c 62 3e 3c  /ul>..<br>..<b><
0980: 75 3e 4e 6f 74 65 3c 2f 75 3e 3c 2f 62 3e 3a 20  u>Note</u></b>: 
0990: 74 68 65 20 77 68 6f 6c 65 20 74 72 61 6e 73 69  the whole transi
09a0: 74 69 6f 6e 20 69 6d 70 6c 69 65 73 20 6d 61 6e  tion implies man
09b0: 79 20 72 65 6c 65 76 61 6e 74 20 63 68 61 6e 67  y relevant chang
09c0: 65 73 2c 20 73 6f 20 74 68 61 74 20 61 20 64 65  es, so that a de
09d0: 65 70 6c 79 20 72 65 76 69 73 65 64 20 41 50 49  eply revised API
09e0: 20 77 69 6c 6c 20 62 65 20 72 65 71 75 69 72 65   will be require
09f0: 64 2e 0d 0a 49 6e 20 6f 74 68 65 72 20 77 6f 72  d...In other wor
0a00: 64 73 2c 20 74 68 65 20 6f 6c 64 20 3c 62 3e 50  ds, the old <b>P
0a10: 52 4f 4a 2e 34 3c 2f 62 3e 20 61 6e 64 20 74 68  ROJ.4</b> and th
0a20: 65 20 6e 65 77 20 3c 62 3e 50 52 4f 4a 2e 37 3c  e new <b>PROJ.7<
0a30: 2f 62 3e 20 77 69 6c 6c 20 73 75 70 70 6f 72 74  /b> will support
0a40: 20 74 77 6f 20 64 69 66 66 65 72 65 6e 74 20 41   two different A
0a50: 50 49 73 2c 20 74 68 75 73 20 61 62 72 75 70 74  PIs, thus abrupt
0a60: 6c 79 20 62 72 65 61 6b 69 6e 67 20 63 72 6f 73  ly breaking cros
0a70: 73 2d 76 65 72 73 69 6f 6e 20 63 6f 6d 70 61 74  s-version compat
0a80: 69 62 69 6c 69 74 79 2e 3c 62 72 3e 0d 0a 54 68  ibility.<br>..Th
0a90: 69 73 20 69 73 20 61 6e 20 75 6d 70 6c 65 61 73  is is an umpleas
0aa0: 61 6e 74 20 6e 65 77 2c 20 62 65 63 61 75 73 65  ant new, because
0ab0: 20 69 74 20 70 72 61 63 74 69 63 61 6c 6c 79 20   it practically 
0ac0: 6d 65 61 6e 73 20 74 68 61 74 20 61 6c 6c 20 73  means that all s
0ad0: 6f 66 74 77 61 72 65 20 6d 6f 64 75 6c 65 73 20  oftware modules 
0ae0: 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 50 52 4f  depending on PRO
0af0: 4a 20 28 74 68 69 73 20 69 6e 63 6c 75 64 69 6e  J (this includin
0b00: 67 20 53 70 61 74 69 61 4c 69 74 65 29 20 77 69  g SpatiaLite) wi
0b10: 6c 6c 20 72 65 71 75 69 72 65 20 61 20 6e 6f 74  ll require a not
0b20: 20 61 74 20 61 6c 6c 20 74 72 69 76 69 61 6c 20   at all trivial 
0b30: 72 65 77 72 69 74 65 20 69 6e 20 6f 72 64 65 72  rewrite in order
0b40: 20 74 6f 20 66 75 6c 66 69 6c 6c 20 74 68 65 20   to fulfill the 
0b50: 6e 65 77 20 41 50 49 20 72 65 71 75 69 72 65 6d  new API requirem
0b60: 65 6e 74 73 2e 3c 62 72 3e 0d 0a 42 75 74 20 77  ents.<br>..But w
0b70: 68 65 6e 20 79 6f 75 20 63 6f 6e 73 69 64 65 72  hen you consider
0b80: 20 74 68 61 74 27 73 20 74 68 65 20 66 69 72 73   that's the firs
0b90: 74 20 74 69 6d 65 20 69 6e 20 69 74 73 20 76 65  t time in its ve
0ba0: 72 79 20 6c 6f 6e 67 20 6c 69 66 65 20 74 68 61  ry long life tha
0bb0: 74 20 50 52 4f 4a 20 72 65 71 75 69 72 65 73 20  t PROJ requires 
0bc0: 61 6e 20 65 78 74 72 61 20 65 66 66 72 6f 74 20  an extra effrot 
0bd0: 69 6e 20 6f 72 64 65 72 20 74 6f 20 69 6e 74 72  in order to intr
0be0: 6f 64 75 63 65 20 73 6f 20 6d 61 6e 79 20 75 73  oduce so many us
0bf0: 65 66 75 6c 20 69 6e 6e 6f 76 61 74 69 6f 6e 73  eful innovations
0c00: 2c 20 74 68 69 73 20 75 6e 65 78 70 65 63 74 65  , this unexpecte
0c10: 64 20 41 50 49 20 62 72 65 61 6b 61 67 65 20 6c  d API breakage l
0c20: 6f 6f 6b 73 20 66 75 6c 6c 79 20 6a 75 73 74 69  ooks fully justi
0c30: 66 69 65 64 20 61 6e 64 20 61 62 73 6f 6c 75 74  fied and absolut
0c40: 65 6c 79 20 72 65 61 73 6f 6e 61 62 6c 65 2e 3c  ely reasonable.<
0c50: 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 3c 75 3e 4d  br><br>..<b><u>M
0c60: 6f 72 65 20 64 65 74 61 69 6c 73 20 61 62 6f 75  ore details abou
0c70: 74 20 74 68 65 20 41 50 49 20 62 72 65 61 6b 61  t the API breaka
0c80: 67 65 3c 2f 75 3e 3c 2f 62 3e 3a 0d 0a 3c 75 6c  ge</u></b>:..<ul
0c90: 3e 0d 0a 3c 6c 69 3e 3c 62 3e 50 52 4f 4a 2e 35  >..<li><b>PROJ.5
0ca0: 3c 2f 62 3e 20 73 74 61 72 74 65 64 20 69 6e 74  </b> started int
0cb0: 72 6f 64 75 63 69 6e 67 20 74 68 65 20 6e 65 77  roducing the new
0cc0: 20 41 50 49 2c 20 62 75 74 20 77 61 73 20 73 74   API, but was st
0cd0: 69 6c 6c 20 61 62 6c 65 20 74 6f 20 73 75 70 70  ill able to supp
0ce0: 6f 72 74 20 74 68 65 20 6f 6c 64 20 74 72 61 64  ort the old trad
0cf0: 69 74 69 6f 6e 61 6c 20 41 50 49 20 77 69 74 68  itional API with
0d00: 6f 75 74 20 61 6e 79 20 63 6f 6d 70 6c 61 69 6e  out any complain
0d10: 74 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e  t.</li>..<li><b>
0d20: 50 52 4f 4a 2e 36 3c 2f 62 3e 20 68 61 76 65 20  PROJ.6</b> have 
0d30: 64 65 70 72 65 63 65 74 65 64 20 74 68 65 20 6f  depreceted the o
0d40: 6c 64 20 74 72 61 64 69 74 69 6f 6e 61 6c 20 41  ld traditional A
0d50: 50 49 2e 3c 62 72 3e 0d 0a 49 74 20 73 74 69 6c  PI.<br>..It stil
0d60: 6c 20 63 6f 6e 74 69 6e 75 65 73 20 74 6f 20 62  l continues to b
0d70: 65 20 72 65 6c 75 63 74 61 6e 63 74 6c 79 20 73  e reluctanctly s
0d80: 75 70 70 6f 72 74 65 64 2c 20 62 75 74 20 74 68  upported, but th
0d90: 65 20 6c 69 62 72 61 72 79 20 72 65 71 75 69 72  e library requir
0da0: 65 73 20 74 6f 20 62 65 20 63 6f 6d 70 69 6c 65  es to be compile
0db0: 64 20 62 79 20 65 78 70 6c 69 63 69 74 6c 79 20  d by explicitly 
0dc0: 64 65 66 69 6e 69 6e 67 20 61 20 3c 62 3e 2d 44  defining a <b>-D
0dd0: 41 43 43 45 50 54 5f 55 53 45 5f 4f 46 5f 44 45  ACCEPT_USE_OF_DE
0de0: 50 52 45 43 41 54 45 44 5f 50 52 4f 4a 5f 41 50  PRECATED_PROJ_AP
0df0: 49 5f 48 3d 31 3c 2f 62 3e 20 64 69 72 65 63 74  I_H=1</b> direct
0e00: 69 76 65 20 69 6e 20 6f 72 64 65 72 20 74 6f 20  ive in order to 
0e10: 65 66 66 65 63 74 69 76 65 6c 79 20 65 6e 61 62  effectively enab
0e20: 6c 65 20 74 68 69 73 20 6f 70 74 69 6f 6e 2e 3c  le this option.<
0e30: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 61 6e 64 20 66 69  /li>..<li>and fi
0e40: 6e 61 6c 6c 79 20 74 68 65 20 6e 65 78 74 2d 74  nally the next-t
0e50: 6f 2d 63 6f 6d 65 20 3c 62 3e 50 52 4f 4a 2e 37  o-come <b>PROJ.7
0e60: 3c 2f 62 3e 20 77 69 6c 6c 20 63 6f 6d 70 6c 65  </b> will comple
0e70: 74 65 6c 79 20 67 65 74 20 72 69 64 20 6f 66 20  tely get rid of 
0e80: 74 68 65 20 6f 6c 64 20 41 50 49 2e 3c 2f 6c 69  the old API.</li
0e90: 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 62 72 3e 0d 0a  >..</ul>..<br>..
0ea0: 3c 68 72 3e 0d 0a 3c 68 31 3e 57 68 61 74 27 73  <hr>..<h1>What's
0eb0: 20 6e 65 77 20 69 6e 20 50 52 4f 4a 2e 36 3c 2f   new in PROJ.6</
0ec0: 68 31 3e 0d 0a 3c 68 33 3e 46 75 6c 6c 79 20 73  h1>..<h3>Fully s
0ed0: 75 70 70 6f 72 74 69 6e 67 20 49 53 4f 2d 31 39  upporting ISO-19
0ee0: 31 31 31 3a 32 30 31 39 20 57 4b 54 3c 2f 68 33  111:2019 WKT</h3
0ef0: 3e 0d 0a 4f 6c 64 20 76 65 72 73 69 6f 6e 73 20  >..Old versions 
0f00: 6f 66 20 50 52 4f 4a 20 28 69 6e 63 6c 75 64 69  of PROJ (includi
0f10: 6e 67 20 3c 62 3e 50 52 4f 4a 2e 34 3c 2f 62 3e  ng <b>PROJ.4</b>
0f20: 29 20 72 65 71 75 69 72 65 64 20 74 6f 20 64 65  ) required to de
0f30: 66 69 6e 65 20 65 61 63 68 20 3c 62 3e 43 52 53  fine each <b>CRS
0f40: 3c 2f 62 3e 20 28 3c 69 3e 43 6f 6f 72 64 69 6e  </b> (<i>Coordin
0f50: 61 74 65 20 52 65 66 65 72 65 6e 63 65 20 53 79  ate Reference Sy
0f60: 73 74 65 6d 3c 2f 69 3e 29 20 62 79 20 61 20 63  stem</i>) by a c
0f70: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 3c 62 3e  orresponding <b>
0f80: 70 72 6f 6a 2d 73 74 72 69 6e 67 3c 2f 62 3e 2e  proj-string</b>.
0f90: 0d 0a 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  ..The following 
0fa0: 74 61 62 6c 65 20 65 78 65 6d 70 6c 69 66 69 65  table exemplifie
0fb0: 73 20 74 68 65 20 63 61 73 65 20 6f 66 20 66 65  s the case of fe
0fc0: 77 20 43 52 53 65 73 3a 3c 62 72 3e 3c 62 72 3e  w CRSes:<br><br>
0fd0: 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61  ..<table cellspa
0fe0: 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64  cing="8" cellpad
0ff0: 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72  ding="8" bgcolor
1000: 3d 22 23 65 38 66 66 65 38 22 20 62 6f 72 64 65  ="#e8ffe8" borde
1010: 72 3d 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20  r="1">..<tr><th 
1020: 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65  bgcolor="#ffb03e
1030: 22 3e 53 52 49 44 3c 2f 74 68 3e 3c 74 68 20 62  ">SRID</th><th b
1040: 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22  gcolor="#ffb03e"
1050: 3e 43 52 53 20 4e 61 6d 65 3c 2f 74 68 3e 3c 74  >CRS Name</th><t
1060: 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30  h bgcolor="#ffb0
1070: 33 65 22 3e 70 72 6f 6a 2d 73 74 72 69 6e 67 3c  3e">proj-string<
1080: 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c  /th></tr>..<tr><
1090: 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22  td align="right"
10a0: 3e 33 30 30 33 3c 2f 74 64 3e 3c 74 64 3e 4d 6f  >3003</td><td>Mo
10b0: 6e 74 65 20 4d 61 72 69 6f 20 2f 20 49 74 61 6c  nte Mario / Ital
10c0: 79 20 7a 6f 6e 65 20 31 3c 2f 74 64 3e 0d 0a 3c  y zone 1</td>..<
10d0: 74 64 3e 2b 70 72 6f 6a 3d 74 6d 65 72 63 20 2b  td>+proj=tmerc +
10e0: 6c 61 74 5f 30 3d 30 20 2b 6c 6f 6e 5f 30 3d 39  lat_0=0 +lon_0=9
10f0: 20 2b 6b 3d 30 2e 39 39 39 36 20 2b 78 5f 30 3d   +k=0.9996 +x_0=
1100: 31 35 30 30 30 30 30 20 2b 79 5f 30 3d 30 20 2b  1500000 +y_0=0 +
1110: 65 6c 6c 70 73 3d 69 6e 74 6c 20 2b 74 6f 77 67  ellps=intl +towg
1120: 73 38 34 3d 2d 31 30 34 2e 31 2c 2d 34 39 2e 31  s84=-104.1,-49.1
1130: 2c 2d 39 2e 39 2c 30 2e 39 37 31 2c 2d 32 2e 39  ,-9.9,0.971,-2.9
1140: 31 37 2c 30 2e 37 31 34 2c 2d 31 31 2e 36 38 20  17,0.714,-11.68 
1150: 2b 75 6e 69 74 73 3d 6d 20 2b 6e 6f 5f 64 65 66  +units=m +no_def
1160: 73 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72  s</td></tr>..<tr
1170: 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 68  ><td align="righ
1180: 74 22 3e 34 33 32 36 3c 2f 74 64 3e 3c 74 64 3e  t">4326</td><td>
1190: 57 47 53 20 38 34 3c 2f 74 64 3e 0d 0a 3c 74 64  WGS 84</td>..<td
11a0: 3e 2b 70 72 6f 6a 3d 6c 6f 6e 67 6c 61 74 20 2b  >+proj=longlat +
11b0: 64 61 74 75 6d 3d 57 47 53 38 34 20 2b 6e 6f 5f  datum=WGS84 +no_
11c0: 64 65 66 73 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a  defs</td></tr>..
11d0: 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72  <tr><td align="r
11e0: 69 67 68 74 22 3e 33 32 36 33 32 3c 2f 74 64 3e  ight">32632</td>
11f0: 3c 74 64 3e 57 47 53 20 38 34 20 2f 20 55 54 4d  <td>WGS 84 / UTM
1200: 20 7a 6f 6e 65 20 33 32 4e 3c 2f 74 64 3e 0d 0a   zone 32N</td>..
1210: 3c 74 64 3e 2b 70 72 6f 6a 3d 75 74 6d 20 2b 7a  <td>+proj=utm +z
1220: 6f 6e 65 3d 33 32 20 2b 64 61 74 75 6d 3d 57 47  one=32 +datum=WG
1230: 53 38 34 20 2b 75 6e 69 74 73 3d 6d 20 2b 6e 6f  S84 +units=m +no
1240: 5f 64 65 66 73 3c 2f 74 64 3e 0d 0a 3c 2f 74 61  _defs</td>..</ta
1250: 62 6c 65 3e 0d 0a 3c 62 72 3e 0d 0a 4e 65 77 20  ble>..<br>..New 
1260: 76 65 72 73 69 6f 6e 73 20 6f 66 20 50 52 4f 4a  versions of PROJ
1270: 20 28 73 74 61 72 74 69 6e 67 20 73 69 6e 63 65   (starting since
1280: 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 29 20   <b>PROJ.6</b>) 
1290: 73 74 69 6c 6c 20 63 6f 6e 74 69 6e 75 65 20 74  still continue t
12a0: 6f 20 73 75 70 70 6f 72 74 20 74 68 65 20 6f 6c  o support the ol
12b0: 64 20 3c 62 3e 70 72 6f 6a 2d 73 74 72 69 6e 67  d <b>proj-string
12c0: 73 3c 2f 62 3e 2c 20 62 75 74 20 74 68 65 20 70  s</b>, but the p
12d0: 72 65 66 65 72 72 65 64 20 6e 6f 74 61 74 69 6f  referred notatio
12e0: 6e 20 66 6f 72 20 64 65 66 69 6e 69 6e 67 20 61  n for defining a
12f0: 6e 79 20 43 52 53 20 69 73 20 6e 6f 77 20 63 6f  ny CRS is now co
1300: 6e 66 6f 72 6d 61 6e 74 20 74 6f 20 74 68 65 20  nformant to the 
1310: 3c 62 3e 49 53 4f 2d 31 39 31 31 31 3a 32 30 31  <b>ISO-19111:201
1320: 39 3c 2f 62 3e 20 69 6e 74 65 72 6e 61 74 69 6f  9</b> internatio
1330: 6e 61 6c 20 73 74 61 6e 64 61 72 64 3c 62 72 3e  nal standard<br>
1340: 0d 0a 28 3c 69 3e 4f 47 43 20 41 62 73 74 72 61  ..(<i>OGC Abstra
1350: 63 74 20 53 70 65 63 69 66 69 63 61 74 69 6f 6e  ct Specification
1360: 20 54 6f 70 69 63 20 32 3a 20 e2 80 9c 52 65 66   Topic 2: ...Ref
1370: 65 72 65 6e 63 69 6e 67 20 42 79 20 43 6f 6f 72  erencing By Coor
1380: 64 69 6e 61 74 65 73 e2 80 9d 3c 2f 69 3e 29 2e  dinates...</i>).
1390: 3c 62 72 3e 0d 0a 54 68 65 20 66 6f 6c 6c 6f 77  <br>..The follow
13a0: 69 6e 67 20 74 61 62 6c 65 20 65 78 65 6d 70 6c  ing table exempl
13b0: 69 66 69 65 73 20 74 68 65 20 73 61 6d 65 20 43  ifies the same C
13c0: 52 53 65 73 20 61 73 20 61 62 6f 76 65 20 69 6e  RSes as above in
13d0: 20 74 68 65 20 49 53 4f 20 57 4b 54 20 6e 6f 74   the ISO WKT not
13e0: 61 74 69 6f 6e 3a 0d 0a 3c 62 72 3e 3c 62 72 3e  ation:..<br><br>
13f0: 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61  ..<table cellspa
1400: 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64  cing="8" cellpad
1410: 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72  ding="8" bgcolor
1420: 3d 22 23 65 38 66 66 65 38 22 20 62 6f 72 64 65  ="#e8ffe8" borde
1430: 72 3d 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20  r="1">..<tr><th 
1440: 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65  bgcolor="#ffb03e
1450: 22 3e 53 52 49 44 3c 2f 74 68 3e 3c 74 64 3e 33  ">SRID</th><td>3
1460: 30 30 33 3c 2f 74 64 3e 3c 74 64 3e 34 33 32 36  003</td><td>4326
1470: 3c 2f 74 64 3e 3c 74 64 3e 33 32 36 33 32 3c 2f  </td><td>32632</
1480: 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74  td></tr>..<tr><t
1490: 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30  h bgcolor="#ffb0
14a0: 33 65 22 3e 43 52 53 20 4e 61 6d 65 3c 2f 74 68  3e">CRS Name</th
14b0: 3e 3c 74 64 3e 4d 6f 6e 74 65 20 4d 61 72 69 6f  ><td>Monte Mario
14c0: 20 2f 20 49 74 61 6c 79 20 7a 6f 6e 65 20 31 3c   / Italy zone 1<
14d0: 2f 74 64 3e 3c 2f 74 64 3e 3c 74 64 3e 57 47 53  /td></td><td>WGS
14e0: 20 38 34 3c 2f 74 64 3e 3c 74 64 3e 57 47 53 20   84</td><td>WGS 
14f0: 38 34 20 2f 20 55 54 4d 20 7a 6f 6e 65 20 33 32  84 / UTM zone 32
1500: 4e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72  N</td></tr>..<tr
1510: 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66  ><th bgcolor="#f
1520: 66 62 30 33 65 22 3e 49 53 4f 2d 32 30 31 38 20  fb03e">ISO-2018 
1530: 57 4b 54 3c 2f 74 68 3e 0d 0a 3c 74 64 20 76 61  WKT</th>..<td va
1540: 6c 69 67 6e 3d 22 74 6f 70 22 3e 3c 76 65 72 62  lign="top"><verb
1550: 61 74 69 6d 3e 0d 0a 50 52 4f 4a 43 52 53 5b 22  atim>..PROJCRS["
1560: 4d 6f 6e 74 65 20 4d 61 72 69 6f 20 2f 20 49 74  Monte Mario / It
1570: 61 6c 79 20 7a 6f 6e 65 20 31 22 2c 0d 0a 20 20  aly zone 1",..  
1580: 20 20 42 41 53 45 47 45 4f 44 43 52 53 5b 22 4d    BASEGEODCRS["M
1590: 6f 6e 74 65 20 4d 61 72 69 6f 22 2c 0d 0a 20 20  onte Mario",..  
15a0: 20 20 20 20 20 20 44 41 54 55 4d 5b 22 4d 6f 6e        DATUM["Mon
15b0: 74 65 20 4d 61 72 69 6f 22 2c 3c 62 72 3e 0d 0a  te Mario",<br>..
15c0: 20 20 20 20 20 20 20 20 20 20 20 20 45 4c 4c 49              ELLI
15d0: 50 53 4f 49 44 5b 22 49 6e 74 65 72 6e 61 74 69  PSOID["Internati
15e0: 6f 6e 61 6c 20 31 39 32 34 22 2c 36 33 37 38 33  onal 1924",63783
15f0: 38 38 2c 32 39 37 2c 0d 0a 20 20 20 20 20 20 20  88,297,..       
1600: 20 20 20 20 20 20 20 20 20 4c 45 4e 47 54 48 55           LENGTHU
1610: 4e 49 54 5b 22 6d 65 74 72 65 22 2c 31 5d 5d 5d  NIT["metre",1]]]
1620: 2c 0d 0a 20 20 20 20 20 20 20 20 50 52 49 4d 45  ,..        PRIME
1630: 4d 5b 22 47 72 65 65 6e 77 69 63 68 22 2c 30 2c  M["Greenwich",0,
1640: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 41 4e  ..            AN
1650: 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 65 22  GLEUNIT["degree"
1660: 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 39 39  ,0.0174532925199
1670: 34 33 33 5d 5d 5d 2c 0d 0a 20 20 20 20 43 4f 4e  433]]],..    CON
1680: 56 45 52 53 49 4f 4e 5b 22 49 74 61 6c 79 20 7a  VERSION["Italy z
1690: 6f 6e 65 20 31 22 2c 0d 0a 20 20 20 20 20 20 20  one 1",..       
16a0: 20 4d 45 54 48 4f 44 5b 22 54 72 61 6e 73 76 65   METHOD["Transve
16b0: 72 73 65 20 4d 65 72 63 61 74 6f 72 22 2c 0d 0a  rse Mercator",..
16c0: 20 20 20 20 20 20 20 20 20 20 20 20 49 44 5b 22              ID["
16d0: 45 50 53 47 22 2c 39 38 30 37 5d 5d 2c 0d 0a 20  EPSG",9807]],.. 
16e0: 20 20 20 20 20 20 20 50 41 52 41 4d 45 54 45 52         PARAMETER
16f0: 5b 22 4c 61 74 69 74 75 64 65 20 6f 66 20 6e 61  ["Latitude of na
1700: 74 75 72 61 6c 20 6f 72 69 67 69 6e 22 2c 30 2c  tural origin",0,
1710: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 41 4e  ..            AN
1720: 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 65 22  GLEUNIT["degree"
1730: 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 39 39  ,0.0174532925199
1740: 34 33 33 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20  433],..         
1750: 20 20 20 49 44 5b 22 45 50 53 47 22 2c 38 38 30     ID["EPSG",880
1760: 31 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 41  1]],..        PA
1770: 52 41 4d 45 54 45 52 5b 22 4c 6f 6e 67 69 74 75  RAMETER["Longitu
1780: 64 65 20 6f 66 20 6e 61 74 75 72 61 6c 20 6f 72  de of natural or
1790: 69 67 69 6e 22 2c 39 2c 0d 0a 20 20 20 20 20 20  igin",9,..      
17a0: 20 20 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b        ANGLEUNIT[
17b0: 22 64 65 67 72 65 65 22 2c 30 2e 30 31 37 34 35  "degree",0.01745
17c0: 33 32 39 32 35 31 39 39 34 33 33 5d 2c 0d 0a 20  32925199433],.. 
17d0: 20 20 20 20 20 20 20 20 20 20 20 49 44 5b 22 45             ID["E
17e0: 50 53 47 22 2c 38 38 30 32 5d 5d 2c 0d 0a 20 20  PSG",8802]],..  
17f0: 20 20 20 20 20 20 50 41 52 41 4d 45 54 45 52 5b        PARAMETER[
1800: 22 53 63 61 6c 65 20 66 61 63 74 6f 72 20 61 74  "Scale factor at
1810: 20 6e 61 74 75 72 61 6c 20 6f 72 69 67 69 6e 22   natural origin"
1820: 2c 30 2e 39 39 39 36 2c 0d 0a 20 20 20 20 20 20  ,0.9996,..      
1830: 20 20 20 20 20 20 53 43 41 4c 45 55 4e 49 54 5b        SCALEUNIT[
1840: 22 75 6e 69 74 79 22 2c 31 5d 2c 0d 0a 20 20 20  "unity",1],..   
1850: 20 20 20 20 20 20 20 20 20 49 44 5b 22 45 50 53           ID["EPS
1860: 47 22 2c 38 38 30 35 5d 5d 2c 0d 0a 20 20 20 20  G",8805]],..    
1870: 20 20 20 20 50 41 52 41 4d 45 54 45 52 5b 22 46      PARAMETER["F
1880: 61 6c 73 65 20 65 61 73 74 69 6e 67 22 2c 31 35  alse easting",15
1890: 30 30 30 30 30 2c 0d 0a 20 20 20 20 20 20 20 20  00000,..        
18a0: 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22      LENGTHUNIT["
18b0: 6d 65 74 72 65 22 2c 31 5d 2c 0d 0a 20 20 20 20  metre",1],..    
18c0: 20 20 20 20 20 20 20 20 49 44 5b 22 45 50 53 47          ID["EPSG
18d0: 22 2c 38 38 30 36 5d 5d 2c 0d 0a 20 20 20 20 20  ",8806]],..     
18e0: 20 20 20 50 41 52 41 4d 45 54 45 52 5b 22 46 61     PARAMETER["Fa
18f0: 6c 73 65 20 6e 6f 72 74 68 69 6e 67 22 2c 30 2c  lse northing",0,
1900: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4c 45  ..            LE
1910: 4e 47 54 48 55 4e 49 54 5b 22 6d 65 74 72 65 22  NGTHUNIT["metre"
1920: 2c 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20  ,1],..          
1930: 20 20 49 44 5b 22 45 50 53 47 22 2c 38 38 30 37    ID["EPSG",8807
1940: 5d 5d 5d 2c 0d 0a 20 20 20 20 43 53 5b 43 61 72  ]]],..    CS[Car
1950: 74 65 73 69 61 6e 2c 32 5d 2c 0d 0a 20 20 20 20  tesian,2],..    
1960: 20 20 20 20 41 58 49 53 5b 22 65 61 73 74 69 6e      AXIS["eastin
1970: 67 20 28 58 29 22 2c 65 61 73 74 2c 0d 0a 20 20  g (X)",east,..  
1980: 20 20 20 20 20 20 20 20 20 20 4f 52 44 45 52 5b            ORDER[
1990: 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20  1],..           
19a0: 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 74   LENGTHUNIT["met
19b0: 72 65 22 2c 31 5d 5d 2c 0d 0a 20 20 20 20 20 20  re",1]],..      
19c0: 20 20 41 58 49 53 5b 22 6e 6f 72 74 68 69 6e 67    AXIS["northing
19d0: 20 28 59 29 22 2c 6e 6f 72 74 68 2c 0d 0a 20 20   (Y)",north,..  
19e0: 20 20 20 20 20 20 20 20 20 20 4f 52 44 45 52 5b            ORDER[
19f0: 32 5d 2c 3c 62 72 3e 0d 0a 20 20 20 20 20 20 20  2],<br>..       
1a00: 20 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b       LENGTHUNIT[
1a10: 22 6d 65 74 72 65 22 2c 31 5d 5d 2c 0d 0a 20 20  "metre",1]],..  
1a20: 20 20 41 52 45 41 5b 22 49 74 61 6c 79 20 2d 20    AREA["Italy - 
1a30: 77 65 73 74 20 6f 66 20 31 32 c2 b0 45 22 5d 2c  west of 12..E"],
1a40: 0d 0a 20 20 20 20 42 42 4f 58 5b 33 36 2e 35 33  ..    BBOX[36.53
1a50: 2c 35 2e 39 34 2c 34 37 2e 30 34 2c 31 32 5d 2c  ,5.94,47.04,12],
1a60: 0d 0a 20 20 20 20 49 44 5b 22 45 50 53 47 22 2c  ..    ID["EPSG",
1a70: 33 30 30 33 5d 5d 0d 0a 3c 2f 76 65 72 62 61 74  3003]]..</verbat
1a80: 69 6d 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 20 76 61  im></td>..<td va
1a90: 6c 69 67 6e 3d 22 74 6f 70 22 3e 3c 76 65 72 62  lign="top"><verb
1aa0: 61 74 69 6d 3e 0d 0a 47 45 4f 44 43 52 53 5b 22  atim>..GEODCRS["
1ab0: 57 47 53 20 38 34 22 2c 0d 0a 20 20 20 20 44 41  WGS 84",..    DA
1ac0: 54 55 4d 5b 22 57 6f 72 6c 64 20 47 65 6f 64 65  TUM["World Geode
1ad0: 74 69 63 20 53 79 73 74 65 6d 20 31 39 38 34 22  tic System 1984"
1ae0: 2c 0d 0a 20 20 20 20 20 20 20 20 45 4c 4c 49 50  ,..        ELLIP
1af0: 53 4f 49 44 5b 22 57 47 53 20 38 34 22 2c 36 33  SOID["WGS 84",63
1b00: 37 38 31 33 37 2c 32 39 38 2e 32 35 37 32 32 33  78137,298.257223
1b10: 35 36 33 2c 0d 0a 20 20 20 20 20 20 20 20 20 20  563,..          
1b20: 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65    LENGTHUNIT["me
1b30: 74 72 65 22 2c 31 5d 5d 5d 2c 0d 0a 20 20 20 20  tre",1]]],..    
1b40: 50 52 49 4d 45 4d 5b 22 47 72 65 65 6e 77 69 63  PRIMEM["Greenwic
1b50: 68 22 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 41  h",0,..        A
1b60: 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 65  NGLEUNIT["degree
1b70: 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 39  ",0.017453292519
1b80: 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20 43 53 5b  9433]],..    CS[
1b90: 65 6c 6c 69 70 73 6f 69 64 61 6c 2c 32 5d 2c 0d  ellipsoidal,2],.
1ba0: 0a 20 20 20 20 20 20 20 20 41 58 49 53 5b 22 67  .        AXIS["g
1bb0: 65 6f 64 65 74 69 63 20 6c 61 74 69 74 75 64 65  eodetic latitude
1bc0: 20 28 4c 61 74 29 22 2c 6e 6f 72 74 68 2c 0d 0a   (Lat)",north,..
1bd0: 20 20 20 20 20 20 20 20 20 20 20 20 4f 52 44 45              ORDE
1be0: 52 5b 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20  R[1],..         
1bf0: 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65     ANGLEUNIT["de
1c00: 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39  gree",0.01745329
1c10: 32 35 31 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 20  25199433]],..   
1c20: 20 20 20 20 20 41 58 49 53 5b 22 67 65 6f 64 65       AXIS["geode
1c30: 74 69 63 20 6c 6f 6e 67 69 74 75 64 65 20 28 4c  tic longitude (L
1c40: 6f 6e 29 22 2c 65 61 73 74 2c 0d 0a 20 20 20 20  on)",east,..    
1c50: 20 20 20 20 20 20 20 20 4f 52 44 45 52 5b 32 5d          ORDER[2]
1c60: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 41  ,..            A
1c70: 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 65  NGLEUNIT["degree
1c80: 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 39  ",0.017453292519
1c90: 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20 41 52 45  9433]],..    ARE
1ca0: 41 5b 22 57 6f 72 6c 64 22 5d 2c 0d 0a 20 20 20  A["World"],..   
1cb0: 20 42 42 4f 58 5b 2d 39 30 2c 2d 31 38 30 2c 39   BBOX[-90,-180,9
1cc0: 30 2c 31 38 30 5d 2c 0d 0a 20 20 20 20 49 44 5b  0,180],..    ID[
1cd0: 22 45 50 53 47 22 2c 34 33 32 36 5d 5d 0d 0a 3c  "EPSG",4326]]..<
1ce0: 2f 76 65 72 62 61 74 69 6d 3e 3c 2f 74 64 3e 0d  /verbatim></td>.
1cf0: 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70  .<td valign="top
1d00: 22 3e 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 50 52  "><verbatim>..PR
1d10: 4f 4a 43 52 53 5b 22 57 47 53 20 38 34 20 2f 20  OJCRS["WGS 84 / 
1d20: 55 54 4d 20 7a 6f 6e 65 20 33 32 4e 22 2c 0d 0a  UTM zone 32N",..
1d30: 20 20 20 20 42 41 53 45 47 45 4f 44 43 52 53 5b      BASEGEODCRS[
1d40: 22 57 47 53 20 38 34 22 2c 0d 0a 20 20 20 20 20  "WGS 84",..     
1d50: 20 20 20 44 41 54 55 4d 5b 22 57 6f 72 6c 64 20     DATUM["World 
1d60: 47 65 6f 64 65 74 69 63 20 53 79 73 74 65 6d 20  Geodetic System 
1d70: 31 39 38 34 22 2c 0d 0a 20 20 20 20 20 20 20 20  1984",..        
1d80: 20 20 20 20 45 4c 4c 49 50 53 4f 49 44 5b 22 57      ELLIPSOID["W
1d90: 47 53 20 38 34 22 2c 36 33 37 38 31 33 37 2c 32  GS 84",6378137,2
1da0: 39 38 2e 32 35 37 32 32 33 35 36 33 2c 0d 0a 20  98.257223563,.. 
1db0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 4c                 L
1dc0: 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65 74 72 65  ENGTHUNIT["metre
1dd0: 22 2c 31 5d 5d 5d 2c 0d 0a 20 20 20 20 20 20 20  ",1]]],..       
1de0: 20 50 52 49 4d 45 4d 5b 22 47 72 65 65 6e 77 69   PRIMEM["Greenwi
1df0: 63 68 22 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20  ch",0,..        
1e00: 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64      ANGLEUNIT["d
1e10: 65 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32  egree",0.0174532
1e20: 39 32 35 31 39 39 34 33 33 5d 5d 5d 2c 0d 0a 20  925199433]]],.. 
1e30: 20 20 20 43 4f 4e 56 45 52 53 49 4f 4e 5b 22 55     CONVERSION["U
1e40: 54 4d 20 7a 6f 6e 65 20 33 32 4e 22 2c 0d 0a 20  TM zone 32N",.. 
1e50: 20 20 20 20 20 20 20 4d 45 54 48 4f 44 5b 22 54         METHOD["T
1e60: 72 61 6e 73 76 65 72 73 65 20 4d 65 72 63 61 74  ransverse Mercat
1e70: 6f 72 22 2c 0d 0a 20 20 20 20 20 20 20 20 20 20  or",..          
1e80: 20 20 49 44 5b 22 45 50 53 47 22 2c 39 38 30 37    ID["EPSG",9807
1e90: 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 41 52  ]],..        PAR
1ea0: 41 4d 45 54 45 52 5b 22 4c 61 74 69 74 75 64 65  AMETER["Latitude
1eb0: 20 6f 66 20 6e 61 74 75 72 61 6c 20 6f 72 69 67   of natural orig
1ec0: 69 6e 22 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20  in",0,..        
1ed0: 20 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64      ANGLEUNIT["d
1ee0: 65 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32  egree",0.0174532
1ef0: 39 32 35 31 39 39 34 33 33 5d 2c 0d 0a 20 20 20  925199433],..   
1f00: 20 20 20 20 20 20 20 20 20 49 44 5b 22 45 50 53           ID["EPS
1f10: 47 22 2c 38 38 30 31 5d 5d 2c 0d 0a 20 20 20 20  G",8801]],..    
1f20: 20 20 20 20 50 41 52 41 4d 45 54 45 52 5b 22 4c      PARAMETER["L
1f30: 6f 6e 67 69 74 75 64 65 20 6f 66 20 6e 61 74 75  ongitude of natu
1f40: 72 61 6c 20 6f 72 69 67 69 6e 22 2c 39 2c 0d 0a  ral origin",9,..
1f50: 20 20 20 20 20 20 20 20 20 20 20 20 41 4e 47 4c              ANGL
1f60: 45 55 4e 49 54 5b 22 64 65 67 72 65 65 22 2c 30  EUNIT["degree",0
1f70: 2e 30 31 37 34 35 33 32 39 32 35 31 39 39 34 33  .017453292519943
1f80: 33 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20  3],..           
1f90: 20 49 44 5b 22 45 50 53 47 22 2c 38 38 30 32 5d   ID["EPSG",8802]
1fa0: 5d 2c 0d 0a 20 20 20 20 20 20 20 20 50 41 52 41  ],..        PARA
1fb0: 4d 45 54 45 52 5b 22 53 63 61 6c 65 20 66 61 63  METER["Scale fac
1fc0: 74 6f 72 20 61 74 20 6e 61 74 75 72 61 6c 20 6f  tor at natural o
1fd0: 72 69 67 69 6e 22 2c 30 2e 39 39 39 36 2c 0d 0a  rigin",0.9996,..
1fe0: 20 20 20 20 20 20 20 20 20 20 20 20 53 43 41 4c              SCAL
1ff0: 45 55 4e 49 54 5b 22 75 6e 69 74 79 22 2c 31 5d  EUNIT["unity",1]
2000: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 49  ,..            I
2010: 44 5b 22 45 50 53 47 22 2c 38 38 30 35 5d 5d 2c  D["EPSG",8805]],
2020: 0d 0a 20 20 20 20 20 20 20 20 50 41 52 41 4d 45  ..        PARAME
2030: 54 45 52 5b 22 46 61 6c 73 65 20 65 61 73 74 69  TER["False easti
2040: 6e 67 22 2c 35 30 30 30 30 30 2c 0d 0a 20 20 20  ng",500000,..   
2050: 20 20 20 20 20 20 20 20 20 4c 45 4e 47 54 48 55           LENGTHU
2060: 4e 49 54 5b 22 6d 65 74 72 65 22 2c 31 5d 2c 0d  NIT["metre",1],.
2070: 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 44 5b  .            ID[
2080: 22 45 50 53 47 22 2c 38 38 30 36 5d 5d 2c 0d 0a  "EPSG",8806]],..
2090: 20 20 20 20 20 20 20 20 50 41 52 41 4d 45 54 45          PARAMETE
20a0: 52 5b 22 46 61 6c 73 65 20 6e 6f 72 74 68 69 6e  R["False northin
20b0: 67 22 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 20  g",0,..         
20c0: 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d     LENGTHUNIT["m
20d0: 65 74 72 65 22 2c 31 5d 2c 0d 0a 20 20 20 20 20  etre",1],..     
20e0: 20 20 20 20 20 20 20 49 44 5b 22 45 50 53 47 22         ID["EPSG"
20f0: 2c 38 38 30 37 5d 5d 5d 2c 0d 0a 20 20 20 20 43  ,8807]]],..    C
2100: 53 5b 43 61 72 74 65 73 69 61 6e 2c 32 5d 2c 0d  S[Cartesian,2],.
2110: 0a 20 20 20 20 20 20 20 20 41 58 49 53 5b 22 28  .        AXIS["(
2120: 45 29 22 2c 65 61 73 74 2c 0d 0a 20 20 20 20 20  E)",east,..     
2130: 20 20 20 20 20 20 20 4f 52 44 45 52 5b 31 5d 2c         ORDER[1],
2140: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4c 45  ..            LE
2150: 4e 47 54 48 55 4e 49 54 5b 22 6d 65 74 72 65 22  NGTHUNIT["metre"
2160: 2c 31 5d 5d 2c 0d 0a 20 20 20 20 20 20 20 20 41  ,1]],..        A
2170: 58 49 53 5b 22 28 4e 29 22 2c 6e 6f 72 74 68 2c  XIS["(N)",north,
2180: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4f 52  ..            OR
2190: 44 45 52 5b 32 5d 2c 0d 0a 20 20 20 20 20 20 20  DER[2],..       
21a0: 20 20 20 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b       LENGTHUNIT[
21b0: 22 6d 65 74 72 65 22 2c 31 5d 5d 2c 0d 0a 20 20  "metre",1]],..  
21c0: 20 20 41 52 45 41 5b 22 57 6f 72 6c 64 20 2d 20    AREA["World - 
21d0: 4e 20 68 65 6d 69 73 70 68 65 72 65 20 2d 20 36  N hemisphere - 6
21e0: c2 b0 45 20 74 6f 20 31 32 c2 b0 45 20 2d 20 62  ..E to 12..E - b
21f0: 79 20 63 6f 75 6e 74 72 79 22 5d 2c 0d 0a 20 20  y country"],..  
2200: 20 20 42 42 4f 58 5b 30 2c 36 2c 38 34 2c 31 32    BBOX[0,6,84,12
2210: 5d 2c 0d 0a 20 20 20 20 49 44 5b 22 45 50 53 47  ],..    ID["EPSG
2220: 22 2c 33 32 36 33 32 5d 5d 0d 0a 3c 2f 76 65 72  ",32632]]..</ver
2230: 62 61 74 69 6d 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74  batim></td>..</t
2240: 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 0d 0a 3c 62  r>..</table>..<b
2250: 72 3e 0d 0a 41 73 20 79 6f 75 20 63 61 6e 20 65  r>..As you can e
2260: 61 73 69 6c 79 20 6e 6f 74 69 63 65 2c 20 74 68  asily notice, th
2270: 65 20 74 77 6f 20 6e 6f 74 61 74 69 6f 6e 73 20  e two notations 
2280: 61 72 65 20 70 72 6f 66 6f 75 6e 64 6c 79 20 64  are profoundly d
2290: 69 66 66 65 72 65 6e 74 2e 0d 0a 54 68 65 20 6f  ifferent...The o
22a0: 6c 64 20 3c 62 3e 70 72 6f 6a 2d 73 74 72 69 6e  ld <b>proj-strin
22b0: 67 3c 2f 62 3e 20 6e 6f 74 61 74 69 6f 6e 20 69  g</b> notation i
22c0: 73 20 65 78 74 72 65 6d 65 6c 79 20 63 6f 6e 63  s extremely conc
22d0: 69 73 65 20 61 6e 64 20 72 6f 75 67 68 2c 20 77  ise and rough, w
22e0: 68 69 6c 73 74 20 74 68 65 20 6e 65 77 20 3c 62  hilst the new <b
22f0: 3e 49 53 4f 2d 57 4b 54 3c 2f 62 3e 20 69 73 20  >ISO-WKT</b> is 
2300: 76 65 72 62 6f 73 65 20 62 75 74 20 65 78 68 61  verbose but exha
2310: 75 73 74 69 76 65 2c 20 64 65 74 61 69 6c 65 64  ustive, detailed
2320: 20 61 6e 64 20 70 72 65 63 69 73 65 2e 3c 62 72   and precise.<br
2330: 3e 0d 0a 54 68 65 72 65 20 69 73 20 6e 6f 20 70  >..There is no p
2340: 6f 73 73 69 62 6c 65 20 6d 61 74 63 68 3a 20 49  ossible match: I
2350: 53 4f 2d 4b 57 54 20 69 73 20 63 6c 65 61 72 6c  SO-KWT is clearl
2360: 79 20 73 75 70 65 72 69 6f 72 20 61 6e 64 20 6d  y superior and m
2370: 6f 72 65 20 73 6f 70 68 69 73 74 69 63 61 74 65  ore sophisticate
2380: 64 20 75 6e 64 65 72 20 61 6e 79 20 70 6f 73 73  d under any poss
2390: 69 62 6c 65 20 61 73 70 65 63 74 2e 3c 62 72 3e  ible aspect.<br>
23a0: 0d 0a 4e 6f 74 20 61 74 20 61 6c 6c 20 73 75 72  ..Not at all sur
23b0: 70 72 69 73 69 6e 67 6c 79 2c 20 63 6f 6f 72 64  prisingly, coord
23c0: 69 6e 61 74 65 20 74 72 61 6e 73 66 6f 72 6d 61  inate transforma
23d0: 74 69 6f 6e 73 20 62 61 73 65 64 20 6f 6e 20 49  tions based on I
23e0: 53 4f 2d 57 4b 54 20 64 65 66 69 6e 69 74 69 6f  SO-WKT definitio
23f0: 6e 73 20 28 69 6e 73 74 65 61 64 20 6f 66 20 70  ns (instead of p
2400: 72 6f 6a 2d 73 74 72 69 6e 67 73 29 20 61 72 65  roj-strings) are
2410: 20 75 73 75 61 6c 6c 79 20 65 78 70 65 63 74 65   usually expecte
2420: 64 20 74 6f 20 62 65 20 6d 6f 72 65 20 61 63 63  d to be more acc
2430: 75 72 61 74 65 2e 3c 62 72 3e 3c 62 72 3e 0d 0a  urate.<br><br>..
2440: 41 6e 64 20 74 68 61 74 27 73 20 6e 6f 74 20 61  And that's not a
2450: 6c 6c 3b 20 74 68 65 20 6f 6c 64 20 3c 62 3e 70  ll; the old <b>p
2460: 72 6f 6a 2d 73 74 72 69 6e 67 73 3c 2f 62 3e 20  roj-strings</b> 
2470: 77 65 72 65 6e 27 74 20 66 6f 72 6d 61 6c 6c 79  weren't formally
2480: 20 64 65 66 69 6e 65 64 20 62 79 20 61 6e 79 20   defined by any 
2490: 73 74 61 6e 64 61 72 64 2c 20 61 6e 64 20 6f 6e  standard, and on
24a0: 6c 79 20 50 52 4f 4a 2c 20 47 44 41 4c 20 61 6e  ly PROJ, GDAL an
24b0: 64 20 66 65 77 20 6f 74 68 65 72 20 46 4c 4f 53  d few other FLOS
24c0: 53 20 2f 20 47 46 4f 53 53 20 69 6d 70 6c 65 6d  S / GFOSS implem
24d0: 65 6e 74 61 74 69 6f 6e 73 20 63 61 6e 20 75 6e  entations can un
24e0: 64 65 72 73 74 61 6e 64 20 74 68 65 6d 2e 3c 62  derstand them.<b
24f0: 72 3e 0d 0a 41 74 20 74 68 65 20 6f 70 70 6f 73  r>..At the oppos
2500: 69 74 65 2c 20 74 68 65 20 6e 65 77 20 3c 62 3e  ite, the new <b>
2510: 49 53 4f 2d 57 4b 54 3c 2f 62 3e 20 69 73 20 66  ISO-WKT</b> is f
2520: 6f 72 6d 61 6c 6c 79 20 64 65 66 69 6e 65 64 20  ormally defined 
2530: 62 79 20 61 6e 20 69 6e 74 65 72 6e 61 74 69 6f  by an internatio
2540: 6e 61 6c 20 73 74 61 6e 64 61 72 64 2c 20 61 6e  nal standard, an
2550: 64 20 6d 61 6e 79 20 66 72 65 65 20 61 6e 64 20  d many free and 
2560: 70 72 6f 70 72 69 65 74 61 72 79 20 69 6d 70 6c  proprietary impl
2570: 65 6d 65 6e 74 61 74 69 6f 6e 73 20 63 61 6e 20  ementations can 
2580: 75 6e 64 65 72 73 74 61 6e 64 20 69 74 2e 3c 62  understand it.<b
2590: 72 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63  r><br>..<table c
25a0: 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63  ellspacing="8" c
25b0: 65 6c 6c 70 61 64 64 69 6e 67 3d 22 31 36 22 20  ellpadding="16" 
25c0: 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 39  bgcolor="#ffffe9
25d0: 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 62  ">..<tr><td>..<b
25e0: 3e 3c 75 3e 49 6d 70 6f 72 74 61 6e 74 20 6e 6f  ><u>Important no
25f0: 74 69 63 65 3c 2f 75 3e 3c 2f 62 3e 3a 20 74 68  tice</u></b>: th
2600: 65 72 65 20 61 72 65 20 73 65 76 65 72 61 6c 20  ere are several 
2610: 64 69 61 6c 65 63 74 73 20 69 6e 20 74 68 65 20  dialects in the 
2620: 57 4b 54 20 6e 6f 74 61 74 69 6f 6e 20 64 65 73  WKT notation des
2630: 63 72 69 62 69 6e 67 20 43 52 53 65 73 2e 3c 62  cribing CRSes.<b
2640: 72 3e 0d 0a 41 6c 6c 20 74 68 65 6d 20 73 68 61  r>..All them sha
2650: 72 65 20 74 68 65 20 73 61 6d 65 20 63 6f 72 65  re the same core
2660: 20 61 6e 64 20 6d 61 69 6e 6c 79 20 64 69 66 66   and mainly diff
2670: 65 72 20 69 6e 20 66 65 77 20 6d 69 6e 6f 72 20  er in few minor 
2680: 64 65 74 61 69 6c 73 2e 3c 62 72 3e 0d 0a 50 52  details.<br>..PR
2690: 4f 4a 2e 36 20 63 61 6e 20 75 6e 64 65 72 73 74  OJ.6 can underst
26a0: 61 6e 64 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e  and the followin
26b0: 67 20 64 69 61 6c 65 63 74 73 3a 0d 0a 3c 6f 6c  g dialects:..<ol
26c0: 3e 0d 0a 3c 6c 69 3e 3c 62 3e 45 53 52 49 20 57  >..<li><b>ESRI W
26d0: 4b 54 3c 2f 62 3e 3a 20 61 20 64 69 61 6c 65 63  KT</b>: a dialec
26e0: 74 20 77 69 64 65 6c 79 20 61 64 6f 70 74 65 64  t widely adopted
26f0: 20 62 79 20 45 53 52 49 20 70 72 6f 70 72 69 65   by ESRI proprie
2700: 74 61 72 79 20 73 6f 66 74 77 61 72 65 2e 3c 2f  tary software.</
2710: 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 47 44 41 4c  li>..<li><b>GDAL
2720: 20 57 4b 54 31 3c 2f 62 3e 3a 20 61 20 64 69 61   WKT1</b>: a dia
2730: 6c 65 63 74 20 68 69 73 74 6f 72 69 63 61 6c 6c  lect historicall
2740: 79 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 74  y supported by t
2750: 68 65 20 6f 70 65 6e 20 73 6f 75 72 63 65 20 47  he open source G
2760: 44 41 4c 20 6c 69 62 72 61 72 79 2e 3c 2f 6c 69  DAL library.</li
2770: 3e 0d 0a 3c 6c 69 3e 3c 62 3e 57 4b 54 32 3a 32  >..<li><b>WKT2:2
2780: 30 31 35 3c 2f 62 3e 3a 20 61 73 20 64 65 66 69  015</b>: as defi
2790: 6e 65 64 20 62 79 20 3c 62 3e 49 53 4f 20 31 39  ned by <b>ISO 19
27a0: 31 36 32 3a 32 30 31 35 3c 2f 62 3e 20 73 74 61  162:2015</b> sta
27b0: 6e 64 61 72 64 20 73 70 65 63 69 66 69 63 61 74  ndard specificat
27c0: 69 6f 6e 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e  ions.</li>..<li>
27d0: 3c 62 3e 57 4b 54 32 3a 32 30 31 38 3c 2f 62 3e  <b>WKT2:2018</b>
27e0: 3a 20 61 73 20 64 65 66 69 6e 65 64 20 62 79 20  : as defined by 
27f0: 3c 62 3e 49 53 4f 20 31 39 31 36 32 3a 32 30 31  <b>ISO 19162:201
2800: 38 3c 2f 62 3e 20 73 74 61 6e 64 61 72 64 20 73  8</b> standard s
2810: 70 65 63 69 66 69 63 61 74 69 6f 6e 73 2e 3c 2f  pecifications.</
2820: 6c 69 3e 0d 0a 3c 2f 6f 6c 3e 0d 0a 3c 2f 74 64  li>..</ol>..</td
2830: 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e  ></tr>..</table>
2840: 3c 62 72 3e 0d 0a 3c 68 33 3e 54 72 61 6e 73 66  <br>..<h3>Transf
2850: 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 6c 69 6e  ormation pipelin
2860: 65 73 3c 2f 68 33 3e 0d 0a 54 68 65 72 65 20 69  es</h3>..There i
2870: 73 20 61 20 73 65 63 6f 6e 64 20 61 73 74 6f 6e  s a second aston
2880: 69 73 68 69 6e 67 20 69 6d 70 72 6f 76 65 6d 65  ishing improveme
2890: 6e 74 20 73 75 70 70 6f 72 74 65 64 20 62 79 20  nt supported by 
28a0: 50 52 4f 4a 2e 36 2c 20 74 68 61 74 20 61 72 65  PROJ.6, that are
28b0: 20 3c 62 3e 74 72 61 6e 73 66 6f 72 6d 61 74 69   <b>transformati
28c0: 6f 6e 20 70 69 70 65 6c 69 6e 65 73 3c 2f 62 3e  on pipelines</b>
28d0: 2e 3c 62 72 3e 0d 0a 57 68 65 6e 20 75 73 69 6e  .<br>..When usin
28e0: 67 20 61 20 3c 62 3e 70 69 70 65 6c 69 6e 65 3c  g a <b>pipeline<
28f0: 2f 62 3e 20 79 6f 75 20 63 61 6e 20 66 72 65 65  /b> you can free
2900: 6c 79 20 64 65 66 69 6e 65 20 61 6e 79 20 63 6f  ly define any co
2910: 6d 70 6c 65 78 20 67 65 6f 64 65 74 69 63 20 74  mplex geodetic t
2920: 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 62 79  ransformation by
2930: 20 63 68 61 69 6e 69 6e 67 20 74 6f 67 65 74 68   chaining togeth
2940: 65 72 20 6d 61 6e 79 20 65 6c 65 6d 65 6e 74 61  er many elementa
2950: 72 79 20 73 74 65 70 73 20 73 75 63 68 20 61 73  ry steps such as
2960: 20 63 6f 6e 76 65 72 73 69 6f 6e 2c 20 74 72 61   conversion, tra
2970: 6e 73 66 6f 72 6d 61 74 69 6f 6e 2c 20 70 72 6f  nsformation, pro
2980: 6a 65 63 74 69 6f 6e 2c 20 61 78 69 73 20 73 77  jection, axis sw
2990: 61 70 20 61 6e 64 20 73 6f 20 6f 6e 2e 3c 62 72  ap and so on.<br
29a0: 3e 0d 0a 41 20 70 69 70 65 6c 69 6e 65 20 69 73  >..A pipeline is
29b0: 20 63 6f 6e 63 65 70 74 75 61 6c 6c 79 20 73 69   conceptually si
29c0: 6d 69 6c 61 72 20 74 6f 20 61 20 55 4e 49 58 20  milar to a UNIX 
29d0: 73 68 65 6c 6c 20 73 63 72 69 70 74 2c 20 77 69  shell script, wi
29e0: 74 68 20 61 20 64 61 74 61 66 6c 6f 77 20 72 65  th a dataflow re
29f0: 67 75 6c 61 72 6c 79 20 70 72 6f 63 65 64 69 6e  gularly procedin
2a00: 67 20 66 6f 72 77 61 72 64 20 66 72 6f 6d 20 73  g forward from s
2a10: 74 65 70 20 74 6f 20 73 74 65 70 20 75 6e 74 69  tep to step unti
2a20: 6c 20 70 72 6f 64 75 63 69 6e 67 20 74 68 65 20  l producing the 
2a30: 66 69 6e 61 6c 20 72 65 73 75 6c 74 2e 3c 62 72  final result.<br
2a40: 3e 0d 0a 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  >..The following
2a50: 20 69 73 20 61 20 70 72 61 63 74 69 61 6c 20 65   is a practial e
2a60: 78 61 6d 70 6c 65 20 6f 66 20 61 20 70 69 70 65  xample of a pipe
2a70: 6c 69 6e 65 20 63 6f 72 72 65 73 70 6f 6e 64 69  line correspondi
2a80: 6e 67 20 74 6f 20 61 20 74 72 61 6e 73 66 6f 72  ng to a transfor
2a90: 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 3c 62 3e 4e  mation from <b>N
2aa0: 41 44 32 37 3c 2f 62 3e 20 74 6f 20 3c 62 3e 4e  AD27</b> to <b>N
2ab0: 41 44 38 33 3c 2f 62 3e 2c 0d 0a 3c 76 65 72 62  AD83</b>,..<verb
2ac0: 61 74 69 6d 3e 0d 0a 2b 70 72 6f 6a 3d 70 69 70  atim>..+proj=pip
2ad0: 65 6c 69 6e 65 20 0d 0a 2b 73 74 65 70 20 2b 70  eline ..+step +p
2ae0: 72 6f 6a 3d 61 78 69 73 73 77 61 70 20 2b 6f 72  roj=axisswap +or
2af0: 64 65 72 3d 32 2c 31 20 0d 0a 2b 73 74 65 70 20  der=2,1 ..+step 
2b00: 2b 70 72 6f 6a 3d 75 6e 69 74 63 6f 6e 76 65 72  +proj=unitconver
2b10: 74 20 2b 78 79 5f 69 6e 3d 64 65 67 20 2b 78 79  t +xy_in=deg +xy
2b20: 5f 6f 75 74 3d 72 61 64 20 0d 0a 2b 73 74 65 70  _out=rad ..+step
2b30: 20 2b 70 72 6f 6a 3d 68 67 72 69 64 73 68 69 66   +proj=hgridshif
2b40: 74 20 2b 67 72 69 64 73 3d 63 6f 6e 75 73 20 0d  t +grids=conus .
2b50: 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 75 6e 69  .+step +proj=uni
2b60: 74 63 6f 6e 76 65 72 74 20 2b 78 79 5f 69 6e 3d  tconvert +xy_in=
2b70: 72 61 64 20 2b 78 79 5f 6f 75 74 3d 64 65 67 20  rad +xy_out=deg 
2b80: 0d 0a 2b 73 74 65 70 20 2b 70 72 6f 6a 3d 61 78  ..+step +proj=ax
2b90: 69 73 73 77 61 70 20 2b 6f 72 64 65 72 3d 32 2c  isswap +order=2,
2ba0: 31 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a  1..</verbatim>..
2bb0: 3c 68 33 3e 54 68 65 20 70 72 69 76 61 74 65 20  <h3>The private 
2bc0: 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 20  SQLite database 
2bd0: 73 75 70 70 6f 72 74 69 6e 67 20 50 52 4f 4a 2e  supporting PROJ.
2be0: 36 3c 2f 68 33 3e 0d 0a 53 74 61 72 74 69 6e 67  6</h3>..Starting
2bf0: 20 73 69 6e 63 65 20 3c 62 3e 50 52 4f 4a 2e 36   since <b>PROJ.6
2c00: 3c 2f 62 3e 20 74 68 65 20 50 52 4f 4a 20 6c 69  </b> the PROJ li
2c10: 62 72 61 72 79 20 72 65 71 75 69 72 65 73 20 61  brary requires a
2c20: 6e 20 65 78 74 65 72 6e 61 6c 20 53 51 4c 69 74  n external SQLit
2c30: 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 74 61  e database conta
2c40: 69 6e 69 6e 67 20 61 6c 6c 20 64 65 66 69 6e 69  ining all defini
2c50: 74 69 6f 6e 73 20 61 62 6f 75 74 20 73 75 70 70  tions about supp
2c60: 6f 72 74 65 64 20 43 52 53 65 73 2c 20 45 6c 6c  orted CRSes, Ell
2c70: 69 70 73 6f 69 64 73 2c 20 50 72 69 6d 65 20 4d  ipsoids, Prime M
2c80: 65 72 69 64 69 61 6e 73 2c 20 55 6e 69 74 20 6f  eridians, Unit o
2c90: 66 20 4d 65 61 73 75 72 65 2c 20 54 72 61 6e 73  f Measure, Trans
2ca0: 66 6f 72 6d 61 74 69 6f 6e 73 20 61 6e 64 20 73  formations and s
2cb0: 6f 20 6f 6e 2e 3c 62 72 3e 0d 0a 4d 61 6e 79 20  o on.<br>..Many 
2cc0: 6f 66 20 74 68 65 20 6e 65 77 20 61 64 76 61 6e  of the new advan
2cd0: 63 65 64 20 50 52 4f 4a 27 73 20 41 50 49 20 77  ced PROJ's API w
2ce0: 69 6c 6c 20 66 61 69 6c 20 69 66 20 73 75 63 68  ill fail if such
2cf0: 20 64 61 74 61 62 61 73 65 20 69 73 20 6e 6f 74   database is not
2d00: 20 61 76 61 69 6c 61 62 6c 65 2e 0d 0a 3c 62 72   available...<br
2d10: 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65  ><br>..<table ce
2d20: 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65  llspacing="8" ce
2d30: 6c 6c 70 61 64 64 69 6e 67 3d 22 38 22 20 62 67  llpadding="8" bg
2d40: 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 39 22 3e  color="#ffffe9">
2d50: 0d 0a 3c 74 72 3e 3c 74 68 3e 0d 0a 49 6e 20 6f  ..<tr><th>..In o
2d60: 72 64 65 72 20 74 6f 20 6c 65 61 72 6e 20 6d 6f  rder to learn mo
2d70: 72 65 20 61 62 6f 75 74 20 74 68 65 20 6d 61 6e  re about the man
2d80: 79 20 69 6e 74 65 72 65 73 74 69 6e 67 20 63 6f  y interesting co
2d90: 6f 6c 20 6e 65 77 20 66 65 61 74 75 72 65 73 20  ol new features 
2da0: 73 75 70 70 6f 72 74 65 64 20 62 79 20 50 52 4f  supported by PRO
2db0: 4a 2e 36 20 70 6c 65 61 73 65 20 63 6f 6e 73 75  J.6 please consu
2dc0: 6c 74 20 74 68 65 20 3c 61 20 68 72 65 66 3d 22  lt the <a href="
2dd0: 68 74 74 70 73 3a 2f 2f 70 72 6f 6a 34 2e 6f 72  https://proj4.or
2de0: 67 2f 22 3e 6f 72 69 67 69 6e 61 6c 20 64 6f 63  g/">original doc
2df0: 75 6d 65 6e 74 61 74 69 6f 6e 3c 2f 61 3e 0d 0a  umentation</a>..
2e00: 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61  </th></tr>..</ta
2e10: 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 68 72 3e 0d 0a  ble><br>..<hr>..
2e20: 3c 68 31 3e 53 70 61 74 69 61 4c 69 74 65 2d 35  <h1>SpatiaLite-5
2e30: 2e 30 2e 30 20 73 75 70 70 6f 72 74 69 6e 67 20  .0.0 supporting 
2e40: 50 52 4f 4a 2e 36 3c 2f 68 31 3e 0d 0a 3c 68 33  PROJ.6</h1>..<h3
2e50: 3e 45 78 69 73 74 69 6e 67 20 53 51 4c 20 66 75  >Existing SQL fu
2e60: 6e 63 74 69 6f 6e 73 20 61 66 66 65 63 74 65 64  nctions affected
2e70: 20 62 79 20 50 52 4f 4a 2e 36 3c 2f 68 33 3e 0d   by PROJ.6</h3>.
2e80: 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63  .<table cellspac
2e90: 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 64  ing="8" cellpadd
2ea0: 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 3d  ing="8" bgcolor=
2eb0: 22 23 65 38 66 66 65 38 22 20 62 6f 72 64 65 72  "#e8ffe8" border
2ec0: 3d 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62  ="1">..<tr><th b
2ed0: 67 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22  gcolor="#ffb03e"
2ee0: 3e 53 51 4c 20 46 75 6e 63 74 69 6f 6e 3c 2f 74  >SQL Function</t
2ef0: 68 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23  h><th bgcolor="#
2f00: 66 66 62 30 33 65 22 3e 45 78 74 65 6e 64 65 64  ffb03e">Extended
2f10: 20 73 69 67 6e 61 74 75 72 65 3c 2f 74 68 3e 3c   signature</th><
2f20: 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62  th bgcolor="#ffb
2f30: 30 33 65 22 3e 42 65 68 61 76 69 6f 72 20 75 6e  03e">Behavior un
2f40: 64 65 72 20 50 52 4f 4a 2e 36 3c 2f 74 68 3e 3c  der PROJ.6</th><
2f50: 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62  /tr>..<tr><td><b
2f60: 3e 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 29 3c  >ST_Transform()<
2f70: 2f 62 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a  /b></td>..<td>..
2f80: 3c 62 3e 53 54 5f 54 72 61 6e 73 66 6f 72 6d 3c  <b>ST_Transform<
2f90: 2f 62 3e 20 28 20 67 65 6f 6d 20 3c 69 3e 47 65  /b> ( geom <i>Ge
2fa0: 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c 20 6e 65 77  ometry</i> , new
2fb0: 53 72 69 64 20 3c 69 3e 49 6e 74 65 67 65 72 3c  Srid <i>Integer<
2fc0: 2f 69 3e 20 2c 20 61 72 65 61 20 3c 69 3e 47 65  /i> , area <i>Ge
2fd0: 6f 6d 65 74 72 79 3c 2f 69 3e 20 29 20 3a 20 3c  ometry</i> ) : <
2fe0: 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 3c 68  i>Geometry</i><h
2ff0: 72 3e 0d 0a 3c 62 3e 53 54 5f 54 72 61 6e 73 66  r>..<b>ST_Transf
3000: 6f 72 6d 3c 2f 62 3e 20 28 20 67 65 6f 6d 20 3c  orm</b> ( geom <
3010: 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c  i>Geometry</i> ,
3020: 20 6e 65 77 53 72 69 64 20 3c 69 3e 49 6e 74 65   newSrid <i>Inte
3030: 67 65 72 3c 2f 69 3e 20 2c 20 61 72 65 61 20 3c  ger</i> , area <
3040: 69 3e 47 65 6f 6d 65 74 72 79 3c 2f 69 3e 20 2c  i>Geometry</i> ,
3050: 20 6d 65 74 68 6f 64 20 3c 69 3e 54 65 78 74 3c   method <i>Text<
3060: 2f 69 3e 20 29 20 3a 20 3c 69 3e 47 65 6f 6d 65  /i> ) : <i>Geome
3070: 74 72 79 3c 2f 69 3e 3c 68 72 3e 0d 0a 3c 62 3e  try</i><hr>..<b>
3080: 53 54 5f 54 72 61 6e 73 66 6f 72 6d 3c 2f 62 3e  ST_Transform</b>
3090: 20 28 20 67 65 6f 6d 20 3c 69 3e 47 65 6f 6d 65   ( geom <i>Geome
30a0: 74 72 79 3c 2f 69 3e 20 2c 20 6e 65 77 53 72 69  try</i> , newSri
30b0: 64 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  d <i>Integer</i>
30c0: 20 2c 20 61 72 65 61 20 3c 69 3e 47 65 6f 6d 65   , area <i>Geome
30d0: 74 72 79 3c 2f 69 3e 20 2c 20 6d 65 74 68 6f 64  try</i> , method
30e0: 20 3c 69 3e 54 65 78 74 3c 2f 69 3e 20 2c 20 70   <i>Text</i> , p
30f0: 72 6f 6a 5f 73 74 72 69 6e 67 20 3c 69 3e 54 65  roj_string <i>Te
3100: 78 74 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 47 65  xt</i> ) : <i>Ge
3110: 6f 6d 65 74 72 79 3c 2f 69 3e 0d 0a 3c 2f 74 64  ometry</i>..</td
3120: 3e 0d 0a 3c 74 64 3e 0d 0a 3c 74 61 62 6c 65 20  >..<td>..<table 
3130: 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 34 22 20  cellspacing="4" 
3140: 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 34 22 20  cellpadding="4" 
3150: 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 64 30  bgcolor="#ffffd0
3160: 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 62  ">..<tr><td>..<b
3170: 3e 3c 75 3e 3c 69 3e 4e 6f 74 65 3c 2f 69 3e 3c  ><u><i>Note</i><
3180: 2f 75 3e 3c 2f 62 3e 3a 20 61 6c 6c 20 74 68 65  /u></b>: all the
3190: 73 65 20 3c 62 3e 3c 69 3e 65 78 74 65 6e 64 65  se <b><i>extende
31a0: 64 20 73 69 67 6e 61 74 75 72 65 73 3c 2f 69 3e  d signatures</i>
31b0: 3c 2f 62 3e 20 61 72 65 20 73 75 70 70 6f 72 74  </b> are support
31c0: 65 64 20 6f 6e 6c 79 20 77 68 65 6e 20 3c 62 3e  ed only when <b>
31d0: 6c 69 62 73 70 61 74 69 61 6c 69 74 65 2d 35 2e  libspatialite-5.
31e0: 30 3c 2f 62 3e 20 68 61 73 20 62 65 65 6e 20 62  0</b> has been b
31f0: 75 69 6c 74 20 6f 6e 20 74 68 65 20 74 6f 70 20  uilt on the top 
3200: 6f 66 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e  of <b>PROJ.6</b>
3210: 3c 62 72 3e 0d 0a 49 66 20 74 68 65 20 6c 69 62  <br>..If the lib
3220: 72 61 72 79 20 68 61 73 20 62 65 65 6e 20 62 75  rary has been bu
3230: 69 6c 74 20 69 6e 73 74 65 61 64 20 6f 6e 20 65  ilt instead on e
3240: 61 72 6c 69 65 72 20 76 65 72 73 69 6f 6e 73 20  arlier versions 
3250: 6f 66 20 50 52 4f 4a 20 61 6e 79 20 61 74 74 65  of PROJ any atte
3260: 6d 70 74 20 74 6f 20 63 61 6c 6c 20 74 68 65 73  mpt to call thes
3270: 65 20 65 78 74 65 6e 64 65 64 20 73 69 67 6e 61  e extended signa
3280: 74 75 72 65 73 20 77 69 6c 6c 20 6a 75 73 74 20  tures will just 
3290: 72 65 74 75 72 6e 20 61 20 3c 62 3e 77 72 6f 6e  return a <b>wron
32a0: 67 20 6e 75 6d 62 65 72 20 6f 66 20 61 72 67 75  g number of argu
32b0: 6d 65 6e 74 73 20 74 6f 20 66 75 6e 63 74 69 6f  ments to functio
32c0: 6e 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 29  n ST_Transform()
32d0: 3c 2f 62 3e 20 65 72 72 6f 72 2e 0d 0a 3c 2f 74  </b> error...</t
32e0: 64 3e 3c 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e  d><tr>..</table>
32f0: 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c  <br>..<table cel
3300: 6c 73 70 61 63 69 6e 67 3d 22 34 22 20 63 65 6c  lspacing="4" cel
3310: 6c 70 61 64 64 69 6e 67 3d 22 34 22 20 62 67 63  lpadding="4" bgc
3320: 6f 6c 6f 72 3d 22 23 66 66 64 66 64 30 22 3e 0d  olor="#ffdfd0">.
3330: 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 41 6e 79 20 69  .<tr><td>..Any i
3340: 6e 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 20  nvalid argument 
3350: 70 61 73 73 65 64 20 74 6f 20 3c 62 3e 53 54 5f  passed to <b>ST_
3360: 54 72 61 6e 73 66 6f 72 6d 28 29 3c 2f 62 3e 20  Transform()</b> 
3370: 28 3c 62 3e 3c 69 3e 65 78 74 65 6e 64 65 64 20  (<b><i>extended 
3380: 73 69 67 6e 61 74 75 72 65 73 3c 2f 69 3e 3c 2f  signatures</i></
3390: 62 3e 29 20 77 69 6c 6c 20 72 61 69 73 65 20 61  b>) will raise a
33a0: 6e 20 3c 62 3e 53 51 4c 20 45 78 63 65 70 74 69  n <b>SQL Excepti
33b0: 6f 6e 3c 2f 62 3e 2e 0d 0a 3c 2f 74 64 3e 3c 74  on</b>...</td><t
33c0: 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e  r>..</table><br>
33d0: 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 74 68 65 20  ..<ul>..<li>the 
33e0: 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e  optional argumen
33f0: 74 20 3c 62 3e 61 72 65 61 3c 2f 62 3e 20 6d 61  t <b>area</b> ma
3400: 79 20 62 65 20 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e  y be <b>NULL</b>
3410: 20 28 3c 69 3e 64 65 66 61 75 6c 74 20 73 65 74   (<i>default set
3420: 74 69 6e 67 3c 2f 69 3e 29 2e 3c 62 72 3e 0d 0a  ting</i>).<br>..
3430: 4f 74 68 65 72 77 69 73 65 20 69 74 27 73 20 65  Otherwise it's e
3440: 78 70 65 63 74 65 64 20 74 6f 20 63 6f 6e 74 61  xpected to conta
3450: 69 6e 20 61 20 76 61 6c 69 64 20 47 65 6f 6d 65  in a valid Geome
3460: 74 72 79 20 69 6e 20 3c 62 3e 53 52 49 44 3d 34  try in <b>SRID=4
3470: 33 32 36 20 28 6c 6f 6e 67 2f 6c 61 74 29 3c 2f  326 (long/lat)</
3480: 62 3e 2e 0d 0a 57 68 65 6e 20 61 6e 20 3c 62 3e  b>...When an <b>
3490: 3c 69 3e 61 72 65 61 20 6f 66 20 75 73 65 3c 2f  <i>area of use</
34a0: 69 3e 3c 2f 62 3e 20 69 73 20 65 78 70 6c 69 63  i></b> is explic
34b0: 69 74 6c 79 20 73 75 70 70 6c 69 65 64 2c 20 74  itly supplied, t
34c0: 68 65 6e 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62  hen <b>PROJ.6</b
34d0: 3e 20 6d 61 79 20 65 76 65 6e 74 75 61 6c 6c 79  > may eventually
34e0: 20 75 73 65 20 74 68 65 20 63 6f 72 72 65 73 70   use the corresp
34f0: 6f 6e 64 69 6e 67 20 3c 62 3e 42 42 4f 58 3c 2f  onding <b>BBOX</
3500: 62 3e 20 66 6f 72 20 66 69 6e 65 6c 79 20 74 75  b> for finely tu
3510: 6e 69 6e 67 20 74 68 65 20 6d 6f 72 65 20 61 63  ning the more ac
3520: 63 75 72 61 74 65 20 74 72 61 6e 73 66 6f 72 6d  curate transform
3530: 61 74 69 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69  ation.</li>..<li
3540: 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72  >the optional ar
3550: 67 75 6d 65 6e 74 20 3c 62 3e 6d 65 74 68 6f 64  gument <b>method
3560: 3c 2f 62 3e 20 69 73 20 65 78 70 65 63 74 65 64  </b> is expected
3570: 20 74 6f 20 63 6f 6e 74 61 69 6e 20 6f 6e 65 20   to contain one 
3580: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 61  the following va
3590: 6c 75 65 73 20 28 3c 62 3e 70 72 6f 6a 34 74 65  lues (<b>proj4te
35a0: 78 74 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 61  xt</b> will be a
35b0: 6c 77 61 79 73 20 61 73 73 75 6d 65 64 20 61 73  lways assumed as
35c0: 20 74 68 65 20 3c 69 3e 64 65 66 61 75 6c 74 20   the <i>default 
35d0: 73 65 74 74 69 6e 67 3c 2f 69 3e 29 3a 3c 2f 6c  setting</i>):</l
35e0: 69 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62  i>..<ul>..<li><b
35f0: 3e 70 72 6f 6a 34 74 65 78 74 3c 2f 62 3e 3a 20  >proj4text</b>: 
3600: 62 6f 74 68 20 43 52 53 65 73 20 28 6f 72 69 67  both CRSes (orig
3610: 69 6e 20 61 6e 64 20 64 65 73 74 69 6e 61 74 69  in and destinati
3620: 6f 6e 29 20 77 69 6c 6c 20 62 65 20 64 65 66 69  on) will be defi
3630: 6e 65 64 20 62 79 20 70 61 73 73 69 6e 67 20 74  ned by passing t
3640: 6f 20 50 52 4f 4a 2e 36 20 74 68 65 20 74 72 61  o PROJ.6 the tra
3650: 64 69 74 69 6f 6e 61 6c 73 20 3c 62 3e 70 72 6f  ditionals <b>pro
3660: 6a 2d 73 74 72 69 6e 67 3c 2f 62 3e 20 64 65 66  j-string</b> def
3670: 69 6e 69 74 69 6f 6e 73 20 66 6f 72 20 74 68 65  initions for the
3680: 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 53   corresponding S
3690: 52 49 44 73 20 72 65 74 72 69 65 76 65 64 20 66  RIDs retrieved f
36a0: 72 6f 6d 20 63 6f 6c 75 6d 6e 20 3c 62 3e 70 72  rom column <b>pr
36b0: 6f 6a 34 74 65 78 74 3c 2f 62 3e 20 69 6e 20 54  oj4text</b> in T
36c0: 61 62 6c 65 20 3c 62 3e 73 70 61 74 69 61 6c 5f  able <b>spatial_
36d0: 72 65 66 5f 73 79 73 3c 2f 62 3e 3c 62 72 3e 0d  ref_sys</b><br>.
36e0: 0a 54 68 69 73 20 65 78 61 63 74 6c 79 20 63 6f  .This exactly co
36f0: 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 74 68 65  rresponds to the
3700: 20 77 65 6c 6c 20 65 78 74 61 62 6c 69 73 68 65   well extablishe
3710: 64 20 74 72 61 64 69 74 69 6f 6e 61 6c 20 62 65  d traditional be
3720: 68 61 76 69 6f 72 20 6f 66 20 61 6c 6c 20 70 72  havior of all pr
3730: 65 76 69 6f 75 73 20 76 65 72 73 69 6f 6e 73 20  evious versions 
3740: 6f 66 20 3c 62 3e 6c 69 62 73 70 61 74 69 61 6c  of <b>libspatial
3750: 69 74 65 3c 2f 62 3e 20 61 6e 64 20 73 74 69 6c  ite</b> and stil
3760: 6c 20 63 6f 6e 74 69 6e 75 65 73 20 74 6f 20 62  l continues to b
3770: 65 20 73 75 70 70 6f 72 74 65 64 20 6d 61 69 6e  e supported main
3780: 6c 79 20 66 6f 72 20 68 69 73 74 6f 72 69 63 61  ly for historica
3790: 6c 20 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 2c  l compatibility,
37a0: 20 62 75 74 20 3c 62 3e 3c 75 3e 3c 69 3e 69 73   but <b><u><i>is
37b0: 6e 27 74 20 61 6e 79 20 6c 6f 6e 67 65 72 20 74  n't any longer t
37c0: 68 65 20 62 65 73 74 20 77 61 79 20 66 6f 72 20  he best way for 
37d0: 74 61 6b 69 6e 67 20 66 75 6c 6c 20 70 72 6f 66  taking full prof
37e0: 69 74 20 6f 66 20 74 68 65 20 6d 6f 72 65 20 61  it of the more a
37f0: 64 76 61 6e 63 65 64 20 63 61 70 61 62 69 6c 69  dvanced capabili
3800: 74 69 65 73 20 6f 66 20 50 52 4f 4a 2e 36 3c 2f  ties of PROJ.6</
3810: 69 3e 3c 2f 75 3e 3c 2f 62 3e 3c 2f 6c 69 3e 0d  i></u></b></li>.
3820: 0a 3c 6c 69 3e 3c 62 3e 73 72 74 65 78 74 3c 2f  .<li><b>srtext</
3830: 62 3e 3a 20 62 6f 74 68 20 43 52 53 65 73 20 28  b>: both CRSes (
3840: 6f 72 69 67 69 6e 20 61 6e 64 20 64 65 73 74 69  origin and desti
3850: 6e 61 74 69 6f 6e 29 20 77 69 6c 6c 20 62 65 20  nation) will be 
3860: 64 65 66 69 6e 65 64 20 62 79 20 70 61 73 73 69  defined by passi
3870: 6e 67 20 74 6f 20 50 52 4f 4a 2e 36 20 74 68 65  ng to PROJ.6 the
3880: 20 3c 62 3e 57 4b 54 3c 2f 62 3e 20 64 65 66 69   <b>WKT</b> defi
3890: 6e 69 74 69 6f 6e 73 20 66 6f 72 20 74 68 65 20  nitions for the 
38a0: 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 53 52  corresponding SR
38b0: 49 44 73 20 72 65 74 72 69 65 76 65 64 20 66 72  IDs retrieved fr
38c0: 6f 6d 20 63 6f 6c 75 6d 6e 20 3c 62 3e 73 72 74  om column <b>srt
38d0: 65 78 74 3c 2f 62 3e 20 69 6e 20 54 61 62 6c 65  ext</b> in Table
38e0: 20 3c 62 3e 73 70 61 74 69 61 6c 5f 72 65 66 5f   <b>spatial_ref_
38f0: 73 79 73 3c 2f 62 3e 3c 62 72 3e 0d 0a 3c 62 3e  sys</b><br>..<b>
3900: 3c 75 3e 3c 69 3e 4e 6f 74 65 3c 2f 69 3e 3c 2f  <u><i>Note</i></
3910: 75 3e 3c 2f 62 3e 3a 20 74 68 69 73 20 6d 65 74  u></b>: this met
3920: 68 6f 64 20 63 6f 75 6c 64 20 65 66 66 65 63 74  hod could effect
3930: 69 76 65 6c 79 20 74 61 6b 65 20 66 75 6c 6c 20  ively take full 
3940: 70 72 6f 66 69 74 20 6f 66 20 74 68 65 20 6d 6f  profit of the mo
3950: 72 65 20 61 64 76 61 6e 63 65 64 20 63 61 70 61  re advanced capa
3960: 62 69 6c 69 74 69 65 73 20 6f 66 20 50 52 4f 4a  bilities of PROJ
3970: 2e 36 2c 20 62 75 74 20 6f 6e 6c 79 20 69 66 20  .6, but only if 
3980: 74 68 65 20 75 6e 64 65 72 6c 61 79 69 6e 67 20  the underlaying 
3990: 73 70 61 74 69 61 6c 69 74 65 20 64 61 74 61 62  spatialite datab
39a0: 61 73 65 20 68 61 73 20 62 65 65 6e 20 63 72 65  ase has been cre
39b0: 61 74 65 64 20 77 69 74 68 20 50 52 4f 4a 2e 36  ated with PROJ.6
39c0: 20 73 75 70 70 6f 72 74 2e 3c 62 72 3e 0d 0a 42   support.<br>..B
39d0: 75 74 20 69 74 20 63 6f 75 6c 64 20 65 61 73 69  ut it could easi
39e0: 6c 79 20 62 65 20 69 6e 61 64 65 71 75 61 74 65  ly be inadequate
39f0: 20 77 68 65 6e 20 74 68 65 20 75 6e 64 65 72 6c   when the underl
3a00: 61 79 69 6e 67 20 73 70 61 74 69 61 6c 69 74 65  aying spatialite
3a10: 20 64 61 74 61 62 61 73 65 20 77 61 73 20 63 72   database was cr
3a20: 65 61 74 65 64 20 62 79 20 73 6f 6d 65 20 65 61  eated by some ea
3a30: 72 6c 69 65 72 20 76 65 72 73 69 6f 6e 20 6f 66  rlier version of
3a40: 20 73 70 61 74 69 61 6c 69 74 65 20 6c 61 63 6b   spatialite lack
3a50: 69 6e 67 20 50 52 4f 4a 2e 36 20 73 75 70 70 6f  ing PROJ.6 suppo
3a60: 72 74 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62  rt.</li>..<li><b
3a70: 3e 61 75 74 68 5f 6e 61 6d 65 3a 61 75 74 68 5f  >auth_name:auth_
3a80: 73 72 69 64 3c 2f 62 3e 3a 20 62 6f 74 68 20 43  srid</b>: both C
3a90: 52 53 65 73 20 28 6f 72 69 67 69 6e 20 61 6e 64  RSes (origin and
3aa0: 20 64 65 73 74 69 6e 61 74 69 6f 6e 29 20 77 69   destination) wi
3ab0: 6c 6c 20 62 65 20 64 65 66 69 6e 65 64 20 62 79  ll be defined by
3ac0: 20 69 67 6e 6f 72 69 6e 67 20 74 68 65 20 64 65   ignoring the de
3ad0: 66 69 6e 69 74 69 6f 6e 73 20 73 74 6f 72 65 64  finitions stored
3ae0: 20 69 6e 20 3c 62 3e 73 70 61 74 69 61 6c 5f 72   in <b>spatial_r
3af0: 65 66 5f 73 79 73 3c 2f 62 3e 20 61 6e 64 20 6c  ef_sys</b> and l
3b00: 65 61 76 69 6e 67 20 50 52 4f 4a 2e 36 20 66 72  eaving PROJ.6 fr
3b10: 65 65 20 74 6f 20 72 65 74 72 69 65 76 65 20 74  ee to retrieve t
3b20: 68 65 69 72 20 63 6f 72 72 65 73 70 6f 6e 64 69  heir correspondi
3b30: 6e 67 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 66  ng definitions f
3b40: 72 6f 6d 20 69 74 73 20 6f 77 6e 20 70 72 69 76  rom its own priv
3b50: 61 74 65 20 53 51 4c 69 74 65 20 64 61 74 61 62  ate SQLite datab
3b60: 61 73 65 2e 3c 62 72 3e 0d 0a 3c 62 3e 3c 75 3e  ase.<br>..<b><u>
3b70: 3c 69 3e 4e 6f 74 65 3c 2f 69 3e 3c 2f 75 3e 3c  <i>Note</i></u><
3b80: 2f 62 3e 3a 20 74 68 69 73 20 6d 65 74 68 6f 64  /b>: this method
3b90: 20 77 69 6c 6c 20 61 6c 77 61 79 73 20 74 61 6b   will always tak
3ba0: 65 20 66 75 6c 6c 20 70 72 6f 66 69 74 20 6f 66  e full profit of
3bb0: 20 74 68 65 20 6d 6f 72 65 20 61 64 76 61 6e 63   the more advanc
3bc0: 65 64 20 63 61 70 61 62 69 6c 69 74 69 65 73 20  ed capabilities 
3bd0: 6f 66 20 50 52 4f 4a 2e 36 3c 2f 6c 69 3e 0d 0a  of PROJ.6</li>..
3be0: 3c 6c 69 3e 3c 62 3e 70 72 6f 6a 5f 73 74 72 69  <li><b>proj_stri
3bf0: 6e 67 3c 2f 62 3e 3a 20 61 6e 20 3c 62 3e 3c 75  ng</b>: an <b><u
3c00: 3e 3c 69 3e 75 73 65 72 2d 64 65 66 69 6e 65 64  ><i>user-defined
3c10: 20 70 72 6f 6a 2d 73 74 72 69 6e 67 3c 2f 69 3e   proj-string</i>
3c20: 3c 2f 75 3e 3c 2f 62 3e 20 28 6d 61 79 20 62 65  </u></b> (may be
3c30: 20 6f 6e 65 20 64 65 66 69 6e 69 6e 69 6e 67 20   one definining 
3c40: 61 20 3c 62 3e 3c 75 3e 3c 69 3e 74 72 61 6e 73  a <b><u><i>trans
3c50: 66 6f 72 6d 61 74 69 6f 6e 20 70 69 70 65 6c 69  formation pipeli
3c60: 6e 65 3c 2f 69 3e 3c 2f 75 3e 3c 2f 62 3e 29 20  ne</i></u></b>) 
3c70: 77 69 6c 6c 20 62 65 20 70 61 73 73 65 64 20 74  will be passed t
3c80: 6f 20 50 52 4f 4a 2e 36 3b 20 74 68 69 73 20 69  o PROJ.6; this i
3c90: 73 20 61 6e 20 61 64 76 61 6e 63 65 64 20 6f 70  s an advanced op
3ca0: 74 69 6f 6e 20 72 65 73 65 72 76 65 64 20 74 6f  tion reserved to
3cb0: 20 73 6b 69 6c 6c 65 64 20 70 6f 77 65 72 20 75   skilled power u
3cc0: 73 65 72 73 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c  sers.</li>..</ul
3cd0: 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 20  ></li>..<li>the 
3ce0: 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e  optional argumen
3cf0: 74 20 3c 62 3e 70 72 6f 6a 5f 73 74 72 69 6e 67  t <b>proj_string
3d00: 3c 2f 62 3e 20 6d 61 79 20 62 65 20 3c 62 3e 4e  </b> may be <b>N
3d10: 55 4c 4c 3c 2f 62 3e 20 28 3c 69 3e 64 65 66 61  ULL</b> (<i>defa
3d20: 75 6c 74 20 73 65 74 74 69 6e 67 3c 2f 69 3e 29  ult setting</i>)
3d30: 2e 3c 62 72 3e 0d 0a 4f 74 68 65 72 77 69 73 65  .<br>..Otherwise
3d40: 20 69 74 27 73 20 65 78 70 65 63 74 65 64 20 74   it's expected t
3d50: 6f 20 63 6f 6e 74 61 69 6e 20 61 20 76 61 6c 69  o contain a vali
3d60: 64 20 3c 62 3e 50 52 4f 4a 2e 36 20 74 72 61 6e  d <b>PROJ.6 tran
3d70: 73 66 6f 72 6d 61 74 69 6f 6e 20 73 74 72 69 6e  sformation strin
3d80: 67 3c 2f 62 3e 2c 20 6d 61 79 20 77 65 6c 6c 20  g</b>, may well 
3d90: 62 65 20 64 65 66 69 6e 69 6e 67 20 61 6e 20 3c  be defining an <
3da0: 62 3e 75 73 65 72 2d 64 65 66 69 6e 65 64 20 74  b>user-defined t
3db0: 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 70 69  ransformation pi
3dc0: 70 65 6c 69 6e 65 3c 2f 62 3e 2e 3c 62 72 3e 0d  peline</b>.<br>.
3dd0: 0a 4d 65 61 6e 69 6e 67 66 75 6c 20 6f 6e 6c 79  .Meaningful only
3de0: 20 69 6e 20 74 68 65 20 63 61 73 65 20 6f 66 20   in the case of 
3df0: 3c 62 3e 6d 65 74 68 6f 64 3d 70 72 6f 6a 5f 73  <b>method=proj_s
3e00: 74 72 69 6e 67 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a  tring</b></li>..
3e10: 3c 2f 75 6c 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72  </ul>..</td></tr
3e20: 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 49 6e  >..<tr><td><b>In
3e30: 69 74 53 70 61 74 69 61 6c 4d 65 74 61 44 61 74  itSpatialMetaDat
3e40: 61 28 29 3c 2f 62 3e 3c 68 72 3e 0d 0a 3c 62 3e  a()</b><hr>..<b>
3e50: 49 6e 69 74 53 70 61 74 69 61 6c 4d 65 74 61 44  InitSpatialMetaD
3e60: 61 74 61 46 75 6c 6c 28 29 3c 2f 62 3e 3c 68 72  ataFull()</b><hr
3e70: 3e 0d 0a 3c 62 3e 49 6e 73 65 72 74 45 70 73 67  >..<b>InsertEpsg
3e80: 53 52 49 44 28 29 3c 2f 74 64 3e 3c 74 64 20 61  SRID()</td><td a
3e90: 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22 3e 3c 62  lign="center"><b
3ea0: 3e 75 6e 63 68 61 6e 67 65 64 3c 2f 62 3e 3c 2f  >unchanged</b></
3eb0: 74 64 3e 0d 0a 3c 74 64 3e 0d 0a 41 6c 6c 20 74  td>..<td>..All t
3ec0: 68 65 73 65 20 53 51 4c 20 46 75 6e 63 74 69 6f  hese SQL Functio
3ed0: 6e 73 20 64 6f 65 73 6e 27 74 20 63 68 61 6e 67  ns doesn't chang
3ee0: 65 20 74 68 65 69 72 20 73 69 67 6e 61 74 75 72  e their signatur
3ef0: 65 73 2c 20 62 75 74 20 62 65 68 61 76 65 20 69  es, but behave i
3f00: 6e 20 61 20 73 69 67 6e 69 66 69 63 61 6e 74 6c  n a significantl
3f10: 79 20 64 69 66 66 65 72 65 6e 74 20 77 61 79 20  y different way 
3f20: 77 68 65 6e 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f  when <b>PROJ.6</
3f30: 62 3e 20 73 75 70 70 6f 72 74 20 69 73 20 61 76  b> support is av
3f40: 61 69 6c 61 62 6c 65 2e 0d 0a 3c 75 6c 3e 0d 0a  ailable...<ul>..
3f50: 3c 6c 69 3e 74 72 61 64 69 74 69 6f 6e 61 6c 20  <li>traditional 
3f60: 62 65 68 61 76 69 6f 72 20 6f 6e 20 6f 6c 64 20  behavior on old 
3f70: 3c 62 3e 50 52 4f 4a 2e 34 3c 2f 62 3e 3a 20 74  <b>PROJ.4</b>: t
3f80: 68 65 20 3c 62 3e 73 70 61 74 69 61 6c 5f 72 65  he <b>spatial_re
3f90: 66 5f 73 79 73 3c 2f 62 3e 20 6d 65 74 61 64 61  f_sys</b> metada
3fa0: 74 61 20 54 61 62 6c 65 20 77 69 6c 6c 20 62 65  ta Table will be
3fb0: 20 70 6f 70 75 6c 61 74 65 64 20 62 79 20 75 73   populated by us
3fc0: 69 6e 67 20 74 68 65 20 43 52 53 65 73 20 64 65  ing the CRSes de
3fd0: 66 69 6e 69 74 69 6f 6e 73 20 69 6e 74 65 72 6e  finitions intern
3fe0: 61 6c 6c 79 20 69 6e 6c 69 6e 65 64 20 77 69 74  ally inlined wit
3ff0: 68 69 6e 20 74 68 65 20 63 6f 64 65 20 6f 66 20  hin the code of 
4000: 3c 62 3e 6c 69 62 73 70 61 74 69 61 6c 69 74 65  <b>libspatialite
4010: 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e  </b>.</li>..<li>
4020: 6e 65 77 20 62 65 68 61 76 69 6f 72 20 6f 6e 20  new behavior on 
4030: 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 3a 20 74  <b>PROJ.6</b>: t
4040: 68 65 20 3c 62 3e 73 70 61 74 69 61 6c 5f 72 65  he <b>spatial_re
4050: 66 5f 73 79 73 3c 2f 62 3e 20 6d 65 74 61 64 61  f_sys</b> metada
4060: 74 61 20 54 61 62 6c 65 20 77 69 6c 6c 20 62 65  ta Table will be
4070: 20 70 6f 70 75 6c 61 74 65 64 20 62 79 20 69 6e   populated by in
4080: 73 65 72 74 69 6e 67 20 74 68 65 20 43 52 53 65  serting the CRSe
4090: 73 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 65 78  s definitions ex
40a0: 74 72 61 63 74 65 64 20 66 72 6f 6d 20 74 68 65  tracted from the
40b0: 20 53 51 4c 69 74 65 20 70 72 69 76 61 74 65 20   SQLite private 
40c0: 64 61 74 61 62 61 73 65 20 63 75 72 72 65 6e 74  database current
40d0: 6c 79 20 63 6f 6e 6e 65 63 74 65 64 20 74 6f 20  ly connected to 
40e0: 50 52 4f 4a 2e 36 3b 20 6d 6f 72 65 20 70 72 65  PROJ.6; more pre
40f0: 63 69 73 65 6c 79 2c 20 63 6f 6c 75 6d 6e 20 3c  cisely, column <
4100: 62 3e 70 72 6f 6a 34 74 65 78 74 3c 2f 62 3e 20  b>proj4text</b> 
4110: 77 69 6c 6c 20 62 65 20 70 6f 70 75 6c 61 74 65  will be populate
4120: 64 20 62 79 20 69 6e 73 65 72 74 69 6e 67 20 74  d by inserting t
4130: 68 65 20 6e 65 77 20 3c 62 3e 70 72 6f 6a 2d 73  he new <b>proj-s
4140: 74 72 69 6e 67 73 3c 2f 62 3e 20 61 73 20 73 75  trings</b> as su
4150: 70 70 6f 72 74 65 64 20 62 79 20 50 52 4f 4a 2e  pported by PROJ.
4160: 36 2c 20 77 68 69 6c 73 74 20 63 6f 6c 75 6d 6e  6, whilst column
4170: 20 3c 62 3e 73 72 74 65 78 74 3c 2f 62 3e 20 77   <b>srtext</b> w
4180: 69 6c 6c 20 62 65 20 70 6f 70 75 6c 61 74 65 64  ill be populated
4190: 20 62 79 20 69 6e 73 65 72 74 69 6e 67 20 74 68   by inserting th
41a0: 65 20 3c 62 3e 49 53 4f 2d 32 30 31 38 20 57 4b  e <b>ISO-2018 WK
41b0: 54 3c 2f 62 3e 20 64 65 66 69 6e 69 74 69 6f 6e  T</b> definition
41c0: 73 20 61 73 20 73 75 70 70 6f 72 74 65 64 20 62  s as supported b
41d0: 79 20 50 52 4f 4a 2e 36 3c 62 72 3e 0d 0a 3c 75  y PROJ.6<br>..<u
41e0: 3e 3c 62 3e 3c 69 3e 49 6d 70 6f 72 74 61 6e 74  ><b><i>Important
41f0: 20 63 6f 6e 73 65 71 75 65 6e 63 65 3c 2f 69 3e   consequence</i>
4200: 3c 2f 62 3e 3c 2f 75 3e 3a 20 69 66 20 74 68 65  </b></u>: if the
4210: 72 65 20 69 73 20 6e 6f 20 64 61 74 61 62 61 73  re is no databas
4220: 65 20 63 75 72 72 65 6e 74 6c 79 20 63 6f 6e 6e  e currently conn
4230: 65 63 74 65 64 20 74 6f 20 50 52 4f 4a 2e 36 20  ected to PROJ.6 
4240: 74 68 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 69  the initializati
4250: 6f 6e 20 6f 66 20 3c 62 3e 73 70 61 74 69 61 6c  on of <b>spatial
4260: 5f 72 65 66 5f 73 79 73 3c 2f 62 3e 20 77 69 6c  _ref_sys</b> wil
4270: 6c 20 66 61 69 6c 2e 3c 2f 6c 69 3e 0d 0a 3c 2f  l fail.</li>..</
4280: 75 6c 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d  ul>..</td></tr>.
4290: 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 46  .</table><br>..F
42a0: 65 77 20 70 72 61 63 74 69 63 61 6c 20 53 51 4c  ew practical SQL
42b0: 20 65 78 61 6d 70 6c 65 73 3a 0d 0a 3c 76 65 72   examples:..<ver
42c0: 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 54 20 53  batim>..SELECT S
42d0: 54 5f 41 73 54 65 78 74 20 28 20 53 54 5f 54 72  T_AsText ( ST_Tr
42e0: 61 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69  ansform( MakePoi
42f0: 6e 74 28 20 31 31 2e 38 37 38 30 35 36 20 2c 20  nt( 11.878056 , 
4300: 34 33 2e 34 36 33 30 35 36 2c 20 34 33 32 36 20  43.463056, 4326 
4310: 29 2c 20 33 30 30 33 29 29 3b 20 2d 2d 20 53 52  ), 3003)); -- SR
4320: 49 44 3d 33 30 30 33 20 2d 20 64 65 66 61 75 6c  ID=3003 - defaul
4330: 74 20 73 65 74 74 69 6e 67 73 3b 20 75 73 69 6e  t settings; usin
4340: 67 20 70 72 6f 6a 2d 73 74 72 69 6e 67 73 20 66  g proj-strings f
4350: 72 6f 6d 20 73 70 61 74 69 61 6c 5f 72 65 66 5f  rom spatial_ref_
4360: 73 79 73 2e 70 72 6f 6a 34 74 65 78 74 0d 0a 2d  sys.proj4text..-
4370: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
4380: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
4390: 2d 2d 2d 2d 0d 0a 50 4f 49 4e 54 28 31 37 33 32  ----..POINT(1732
43a0: 38 33 32 2e 34 34 34 38 39 32 20 34 38 31 36 33  832.444892 48163
43b0: 35 30 2e 31 34 36 32 34 36 29 0d 0a 0d 0a 53 45  50.146246)....SE
43c0: 4c 45 43 54 20 53 54 5f 41 73 54 65 78 74 20 28  LECT ST_AsText (
43d0: 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d   ST_Transform( M
43e0: 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 38  akePoint( 11.878
43f0: 30 35 36 20 2c 20 34 33 2e 34 36 33 30 35 36 2c  056 , 43.463056,
4400: 20 34 33 32 36 20 29 2c 20 33 30 30 33 2c 20 4e   4326 ), 3003, N
4410: 55 4c 4c 2c 20 27 73 72 74 65 78 74 27 29 29 3b  ULL, 'srtext'));
4420: 20 2d 2d 20 53 52 49 44 3d 33 30 30 33 20 2d 20   -- SRID=3003 - 
4430: 4e 55 4c 4c 20 61 72 65 61 20 6f 66 20 75 73 65  NULL area of use
4440: 2c 20 75 73 69 6e 67 20 49 53 4f 2d 32 30 31 38  , using ISO-2018
4450: 20 57 4b 54 20 64 65 66 69 6e 69 74 69 6f 6e 73   WKT definitions
4460: 20 66 72 6f 6d 20 73 70 61 74 69 61 6c 5f 72 65   from spatial_re
4470: 66 5f 73 79 73 2e 73 72 74 65 78 74 0d 0a 2d 2d  f_sys.srtext..--
4480: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
4490: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
44a0: 2d 2d 2d 0d 0a 50 4f 49 4e 54 28 31 37 33 32 38  ---..POINT(17328
44b0: 35 32 2e 39 34 32 37 31 37 20 34 38 31 36 32 37  52.942717 481627
44c0: 37 2e 36 31 37 36 39 31 29 0d 0a 0d 0a 53 45 4c  7.617691)....SEL
44d0: 45 43 54 20 53 54 5f 41 73 54 65 78 74 20 28 20  ECT ST_AsText ( 
44e0: 53 54 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d 61  ST_Transform( Ma
44f0: 6b 65 50 6f 69 6e 74 28 20 31 31 2e 38 37 38 30  kePoint( 11.8780
4500: 35 36 20 2c 20 34 33 2e 34 36 33 30 35 36 2c 20  56 , 43.463056, 
4510: 34 33 32 36 20 29 2c 20 33 30 30 33 2c 20 4e 55  4326 ), 3003, NU
4520: 4c 4c 2c 20 27 61 75 74 68 5f 6e 61 6d 65 3a 61  LL, 'auth_name:a
4530: 75 74 68 5f 73 72 69 64 27 29 29 3b 20 2d 2d 20  uth_srid')); -- 
4540: 53 52 49 44 3d 33 30 30 33 20 2d 20 4e 55 4c 4c  SRID=3003 - NULL
4550: 20 61 72 65 61 20 6f 66 20 75 73 65 2c 20 69 67   area of use, ig
4560: 6e 6f 72 69 6e 67 20 73 70 61 74 69 61 6c 69 74  noring spatialit
4570: 65 5f 72 65 66 5f 73 79 73 20 61 6e 64 20 75 73  e_ref_sys and us
4580: 69 6e 67 20 74 68 65 20 50 52 4f 4a 2e 36 20 6f  ing the PROJ.6 o
4590: 77 6e 20 70 72 69 76 61 74 65 20 64 61 74 61 62  wn private datab
45a0: 61 73 65 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ase..-----------
45b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
45c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 50 4f 49 4e  ----------..POIN
45d0: 54 28 31 37 33 32 38 35 32 2e 39 34 32 37 31 37  T(1732852.942717
45e0: 20 34 38 31 36 32 37 37 2e 36 31 37 36 39 31 29   4816277.617691)
45f0: 0d 0a 0d 0a 53 45 4c 45 43 54 20 53 54 5f 41 73  ....SELECT ST_As
4600: 54 65 78 74 20 28 20 53 54 5f 54 72 61 6e 73 66  Text ( ST_Transf
4610: 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 6e 74 28 20  orm( MakePoint( 
4620: 31 31 2e 38 37 38 30 35 36 20 2c 20 34 33 2e 34  11.878056 , 43.4
4630: 36 33 30 35 36 2c 20 34 33 32 36 20 29 2c 20 33  63056, 4326 ), 3
4640: 32 36 33 32 29 29 3b 20 2d 2d 20 53 52 49 44 3d  2632)); -- SRID=
4650: 33 32 36 33 32 20 2d 20 64 65 66 61 75 6c 74 20  32632 - default 
4660: 73 65 74 74 69 6e 67 73 3b 20 75 73 69 6e 67 20  settings; using 
4670: 70 72 6f 6a 2d 73 74 72 69 6e 67 73 20 66 72 6f  proj-strings fro
4680: 6d 20 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 79  m spatial_ref_sy
4690: 73 2e 70 72 6f 6a 34 74 65 78 74 0d 0a 2d 2d 2d  s.proj4text..---
46a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
46b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
46c0: 2d 2d 0d 0a 50 4f 49 4e 54 28 37 33 32 38 32 31  --..POINT(732821
46d0: 2e 37 31 38 34 37 35 20 34 38 31 36 32 36 32 2e  .718475 4816262.
46e0: 36 33 31 32 34 35 29 0d 0a 0d 0a 53 45 4c 45 43  631245)....SELEC
46f0: 54 20 53 54 5f 41 73 54 65 78 74 20 28 20 53 54  T ST_AsText ( ST
4700: 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d 61 6b 65  _Transform( Make
4710: 50 6f 69 6e 74 28 20 31 31 2e 38 37 38 30 35 36  Point( 11.878056
4720: 20 2c 20 34 33 2e 34 36 33 30 35 36 2c 20 34 33   , 43.463056, 43
4730: 32 36 20 29 2c 20 33 32 36 33 32 2c 20 4e 55 4c  26 ), 32632, NUL
4740: 4c 2c 20 27 73 72 74 65 78 74 27 29 29 3b 20 2d  L, 'srtext')); -
4750: 2d 20 53 52 49 44 3d 33 32 36 33 32 20 2d 20 4e  - SRID=32632 - N
4760: 55 4c 4c 20 61 72 65 61 20 6f 66 20 75 73 65 2c  ULL area of use,
4770: 20 75 73 69 6e 67 20 49 53 4f 2d 32 30 31 38 20   using ISO-2018 
4780: 57 4b 54 20 64 65 66 69 6e 69 74 69 6f 6e 73 20  WKT definitions 
4790: 66 72 6f 6d 20 73 70 61 74 69 61 6c 5f 72 65 66  from spatial_ref
47a0: 5f 73 79 73 2e 73 72 74 65 78 74 0d 0a 2d 2d 2d  _sys.srtext..---
47b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
47c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
47d0: 2d 2d 0d 0a 50 4f 49 4e 54 28 37 33 32 38 32 31  --..POINT(732821
47e0: 2e 37 31 38 34 37 35 20 34 38 31 36 32 36 32 2e  .718475 4816262.
47f0: 36 33 31 32 34 35 29 0d 0a 0d 0a 53 45 4c 45 43  631245)....SELEC
4800: 54 20 53 54 5f 41 73 54 65 78 74 20 28 20 53 54  T ST_AsText ( ST
4810: 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d 61 6b 65  _Transform( Make
4820: 50 6f 69 6e 74 28 20 31 31 2e 38 37 38 30 35 36  Point( 11.878056
4830: 20 2c 20 34 33 2e 34 36 33 30 35 36 2c 20 34 33   , 43.463056, 43
4840: 32 36 20 29 2c 20 33 32 36 33 32 2c 20 4e 55 4c  26 ), 32632, NUL
4850: 4c 2c 20 27 61 75 74 68 5f 6e 61 6d 65 3a 61 75  L, 'auth_name:au
4860: 74 68 5f 73 72 69 64 27 29 29 3b 20 2d 2d 20 53  th_srid')); -- S
4870: 52 49 44 3d 33 32 36 33 32 20 2d 20 4e 55 4c 4c  RID=32632 - NULL
4880: 20 61 72 65 61 20 6f 66 20 75 73 65 2c 20 69 67   area of use, ig
4890: 6e 6f 72 69 6e 67 20 73 70 61 74 69 61 6c 69 74  noring spatialit
48a0: 65 5f 72 65 66 5f 73 79 73 20 61 6e 64 20 75 73  e_ref_sys and us
48b0: 69 6e 67 20 74 68 65 20 50 52 4f 4a 2e 36 20 6f  ing the PROJ.6 o
48c0: 77 6e 20 70 72 69 76 61 74 65 20 64 61 74 61 62  wn private datab
48d0: 61 73 65 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ase..-----------
48e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
48f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 50 4f 49 4e  ----------..POIN
4900: 54 28 37 33 32 38 32 31 2e 37 31 38 34 37 35 20  T(732821.718475 
4910: 34 38 31 36 32 36 32 2e 36 33 31 32 34 35 29 0d  4816262.631245).
4920: 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 54 68  .</verbatim>..Th
4930: 69 73 20 66 69 72 73 74 20 74 65 73 74 20 69 73  is first test is
4940: 20 62 61 73 65 64 20 6f 6e 20 61 20 6e 65 77 20   based on a new 
4950: 53 70 61 74 69 61 4c 69 74 65 20 64 61 62 61 73  SpatiaLite dabas
4960: 65 20 63 72 65 61 74 65 64 20 77 69 74 68 20 66  e created with f
4970: 75 6c 6c 20 50 52 4f 4a 2e 36 20 73 75 70 70 6f  ull PROJ.6 suppo
4980: 72 74 2e 20 41 73 20 79 6f 75 20 63 61 6e 20 65  rt. As you can e
4990: 61 73 69 6c 79 20 6e 6f 74 69 63 65 3a 0d 0a 3c  asily notice:..<
49a0: 75 6c 3e 0d 0a 3c 6c 69 3e 74 68 65 20 66 69 72  ul>..<li>the fir
49b0: 73 74 20 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f  st transformatio
49c0: 6e 20 66 72 6f 6d 20 53 52 49 44 3d 34 33 32 36  n from SRID=4326
49d0: 20 74 6f 20 53 52 49 44 3d 33 30 30 33 20 62 61   to SRID=3003 ba
49e0: 73 65 64 20 6f 6e 20 74 72 61 64 69 74 69 6f 6e  sed on tradition
49f0: 61 6c 20 3c 62 3e 70 72 6f 6a 2d 73 74 72 69 6e  al <b>proj-strin
4a00: 67 73 3c 2f 62 3e 20 72 65 74 72 69 65 76 65 64  gs</b> retrieved
4a10: 20 66 72 6f 6d 20 3c 62 3e 73 70 61 74 69 61 6c   from <b>spatial
4a20: 5f 72 65 66 5f 73 79 73 2e 70 72 6f 6a 34 74 65  _ref_sys.proj4te
4a30: 78 74 3c 2f 62 3e 20 72 61 74 68 65 72 20 73 75  xt</b> rather su
4a40: 72 70 72 69 73 69 6e 67 6c 79 20 73 69 67 6e 69  rprisingly signi
4a50: 66 69 63 61 6e 74 6c 79 20 64 69 66 66 65 72 73  ficantly differs
4a60: 20 66 72 6f 6d 20 74 68 65 20 6f 74 68 65 72 20   from the other 
4a70: 74 77 6f 20 72 65 73 75 6c 74 73 2e 3c 2f 6c 69  two results.</li
4a80: 3e 0d 0a 3c 6c 69 3e 62 75 74 20 61 6c 6c 20 74  >..<li>but all t
4a90: 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 73 20 66  ransformations f
4aa0: 72 6f 6d 20 53 52 49 44 3d 34 33 32 36 20 74 6f  rom SRID=4326 to
4ab0: 20 53 52 49 44 3d 33 32 36 33 32 20 72 65 74 75   SRID=32632 retu
4ac0: 72 6e 20 69 64 65 6e 74 69 63 61 6c 20 72 65 73  rn identical res
4ad0: 75 6c 74 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e  ults.</li>..<li>
4ae0: 74 68 69 73 20 69 73 20 61 20 64 69 72 65 63 74  this is a direct
4af0: 20 63 6f 6e 66 69 72 6d 61 74 69 6f 6e 20 74 68   confirmation th
4b00: 61 74 20 73 74 69 6c 6c 20 63 6f 6e 74 69 6e 75  at still continu
4b10: 69 6e 67 20 74 6f 20 75 73 65 20 74 68 65 20 74  ing to use the t
4b20: 72 61 64 69 74 69 6f 6e 61 6c 20 61 70 70 72 6f  raditional appro
4b30: 61 63 68 20 6f 66 20 74 72 61 6e 73 66 6f 72 6d  ach of transform
4b40: 61 74 69 6f 6e 73 20 64 72 69 76 65 6e 20 62 79  ations driven by
4b50: 20 70 72 6f 6a 2d 73 74 72 69 6e 67 73 20 3c 62   proj-strings <b
4b60: 3e 3c 75 3e 3c 69 3e 64 65 66 69 6e 69 74 65 6c  ><u><i>definitel
4b70: 79 20 69 73 6e 27 74 20 74 68 65 20 6f 70 74 69  y isn't the opti
4b80: 6d 61 6c 20 6d 65 74 68 6f 64 20 66 6f 72 20 75  mal method for u
4b90: 73 69 6e 67 20 50 52 4f 4a 2e 36 3c 2f 69 3e 3c  sing PROJ.6</i><
4ba0: 2f 75 3e 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f  /u></b></li>..</
4bb0: 75 6c 3e 3c 62 72 3e 0d 0a 3c 76 65 72 62 61 74  ul><br>..<verbat
4bc0: 69 6d 3e 0d 0a 53 45 4c 45 43 54 20 53 54 5f 41  im>..SELECT ST_A
4bd0: 73 54 65 78 74 20 28 20 53 54 5f 54 72 61 6e 73  sText ( ST_Trans
4be0: 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69 6e 74 28  form( MakePoint(
4bf0: 20 31 31 2e 38 37 38 30 35 36 20 2c 20 34 33 2e   11.878056 , 43.
4c00: 34 36 33 30 35 36 2c 20 34 33 32 36 20 29 2c 20  463056, 4326 ), 
4c10: 33 30 30 33 29 29 3b 20 2d 2d 20 53 52 49 44 3d  3003)); -- SRID=
4c20: 33 30 30 33 20 2d 20 64 65 66 61 75 6c 74 20 73  3003 - default s
4c30: 65 74 74 69 6e 67 73 3b 20 75 73 69 6e 67 20 70  ettings; using p
4c40: 72 6f 6a 2d 73 74 72 69 6e 67 73 20 66 72 6f 6d  roj-strings from
4c50: 20 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73   spatial_ref_sys
4c60: 2e 70 72 6f 6a 34 74 65 78 74 0d 0a 2d 2d 2d 2d  .proj4text..----
4c70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
4c80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
4c90: 2d 0d 0a 50 4f 49 4e 54 28 31 37 33 32 38 35 32  -..POINT(1732852
4ca0: 2e 39 34 32 37 31 37 20 34 38 31 36 32 37 37 2e  .942717 4816277.
4cb0: 36 31 37 36 39 31 29 0d 0a 0d 0a 53 45 4c 45 43  617691)....SELEC
4cc0: 54 20 53 54 5f 41 73 54 65 78 74 20 28 20 53 54  T ST_AsText ( ST
4cd0: 5f 54 72 61 6e 73 66 6f 72 6d 28 20 4d 61 6b 65  _Transform( Make
4ce0: 50 6f 69 6e 74 28 20 31 31 2e 38 37 38 30 35 36  Point( 11.878056
4cf0: 20 2c 20 34 33 2e 34 36 33 30 35 36 2c 20 34 33   , 43.463056, 43
4d00: 32 36 20 29 2c 20 33 30 30 33 2c 20 4e 55 4c 4c  26 ), 3003, NULL
4d10: 2c 20 27 73 72 74 65 78 74 27 29 29 3b 20 2d 2d  , 'srtext')); --
4d20: 20 53 52 49 44 3d 33 30 30 33 20 2d 20 4e 55 4c   SRID=3003 - NUL
4d30: 4c 20 61 72 65 61 20 6f 66 20 75 73 65 2c 20 75  L area of use, u
4d40: 73 69 6e 67 20 49 53 4f 2d 32 30 31 38 20 57 4b  sing ISO-2018 WK
4d50: 54 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 66 72  T definitions fr
4d60: 6f 6d 20 73 70 61 74 69 61 6c 5f 72 65 66 5f 73  om spatial_ref_s
4d70: 79 73 2e 73 72 74 65 78 74 0d 0a 2d 2d 2d 2d 2d  ys.srtext..-----
4d80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
4d90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
4da0: 0d 0a 50 4f 49 4e 54 28 31 37 33 32 38 35 32 2e  ..POINT(1732852.
4db0: 39 34 32 37 31 37 20 34 38 31 36 32 37 37 2e 36  942717 4816277.6
4dc0: 31 37 36 39 31 29 0d 0a 0d 0a 53 45 4c 45 43 54  17691)....SELECT
4dd0: 20 53 54 5f 41 73 54 65 78 74 20 28 20 53 54 5f   ST_AsText ( ST_
4de0: 54 72 61 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 50  Transform( MakeP
4df0: 6f 69 6e 74 28 20 31 31 2e 38 37 38 30 35 36 20  oint( 11.878056 
4e00: 2c 20 34 33 2e 34 36 33 30 35 36 2c 20 34 33 32  , 43.463056, 432
4e10: 36 20 29 2c 20 33 30 30 33 2c 20 4e 55 4c 4c 2c  6 ), 3003, NULL,
4e20: 20 27 61 75 74 68 5f 6e 61 6d 65 3a 61 75 74 68   'auth_name:auth
4e30: 5f 73 72 69 64 27 29 29 3b 20 2d 2d 20 53 52 49  _srid')); -- SRI
4e40: 44 3d 33 30 30 33 20 2d 20 4e 55 4c 4c 20 61 72  D=3003 - NULL ar
4e50: 65 61 20 6f 66 20 75 73 65 2c 20 69 67 6e 6f 72  ea of use, ignor
4e60: 69 6e 67 20 73 70 61 74 69 61 6c 69 74 65 5f 72  ing spatialite_r
4e70: 65 66 5f 73 79 73 20 61 6e 64 20 75 73 69 6e 67  ef_sys and using
4e80: 20 74 68 65 20 50 52 4f 4a 2e 36 20 6f 77 6e 20   the PROJ.6 own 
4e90: 70 72 69 76 61 74 65 20 64 61 74 61 62 61 73 65  private database
4ea0: 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ..--------------
4eb0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
4ec0: 2d 2d 2d 2d 2d 2d 2d 0d 0a 50 4f 49 4e 54 28 31  -------..POINT(1
4ed0: 37 33 32 38 35 32 2e 39 34 32 37 31 37 20 34 38  732852.942717 48
4ee0: 31 36 32 37 37 2e 36 31 37 36 39 31 29 0d 0a 0d  16277.617691)...
4ef0: 0a 53 45 4c 45 43 54 20 53 54 5f 41 73 54 65 78  .SELECT ST_AsTex
4f00: 74 20 28 20 53 54 5f 54 72 61 6e 73 66 6f 72 6d  t ( ST_Transform
4f10: 28 20 4d 61 6b 65 50 6f 69 6e 74 28 20 31 31 2e  ( MakePoint( 11.
4f20: 38 37 38 30 35 36 20 2c 20 34 33 2e 34 36 33 30  878056 , 43.4630
4f30: 35 36 2c 20 34 33 32 36 20 29 2c 20 33 32 36 33  56, 4326 ), 3263
4f40: 32 29 29 3b 20 2d 2d 20 53 52 49 44 3d 33 32 36  2)); -- SRID=326
4f50: 33 32 20 2d 20 64 65 66 61 75 6c 74 20 73 65 74  32 - default set
4f60: 74 69 6e 67 73 3b 20 75 73 69 6e 67 20 70 72 6f  tings; using pro
4f70: 6a 2d 73 74 72 69 6e 67 73 20 66 72 6f 6d 20 73  j-strings from s
4f80: 70 61 74 69 61 6c 5f 72 65 66 5f 73 79 73 2e 70  patial_ref_sys.p
4f90: 72 6f 6a 34 74 65 78 74 0d 0a 2d 2d 2d 2d 2d 2d  roj4text..------
4fa0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
4fb0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d  ---------------.
4fc0: 0a 50 4f 49 4e 54 28 37 33 32 38 32 31 2e 37 31  .POINT(732821.71
4fd0: 38 34 37 35 20 34 38 31 36 32 36 32 2e 36 33 31  8475 4816262.631
4fe0: 32 34 35 29 0d 0a 0d 0a 53 45 4c 45 43 54 20 53  245)....SELECT S
4ff0: 54 5f 41 73 54 65 78 74 20 28 20 53 54 5f 54 72  T_AsText ( ST_Tr
5000: 61 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69  ansform( MakePoi
5010: 6e 74 28 20 31 31 2e 38 37 38 30 35 36 20 2c 20  nt( 11.878056 , 
5020: 34 33 2e 34 36 33 30 35 36 2c 20 34 33 32 36 20  43.463056, 4326 
5030: 29 2c 20 33 32 36 33 32 2c 20 4e 55 4c 4c 2c 20  ), 32632, NULL, 
5040: 27 73 72 74 65 78 74 27 29 29 3b 20 2d 2d 20 53  'srtext')); -- S
5050: 52 49 44 3d 33 32 36 33 32 20 2d 20 4e 55 4c 4c  RID=32632 - NULL
5060: 20 61 72 65 61 20 6f 66 20 75 73 65 2c 20 75 73   area of use, us
5070: 69 6e 67 20 49 53 4f 2d 32 30 31 38 20 57 4b 54  ing ISO-2018 WKT
5080: 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 66 72 6f   definitions fro
5090: 6d 20 73 70 61 74 69 61 6c 5f 72 65 66 5f 73 79  m spatial_ref_sy
50a0: 73 2e 73 72 74 65 78 74 0d 0a 2d 2d 2d 2d 2d 2d  s.srtext..------
50b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
50c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d  ---------------.
50d0: 0a 50 4f 49 4e 54 28 37 33 32 38 32 31 2e 37 31  .POINT(732821.71
50e0: 38 34 37 35 20 34 38 31 36 32 36 32 2e 36 33 31  8475 4816262.631
50f0: 32 34 35 29 0d 0a 0d 0a 53 45 4c 45 43 54 20 53  245)....SELECT S
5100: 54 5f 41 73 54 65 78 74 20 28 20 53 54 5f 54 72  T_AsText ( ST_Tr
5110: 61 6e 73 66 6f 72 6d 28 20 4d 61 6b 65 50 6f 69  ansform( MakePoi
5120: 6e 74 28 20 31 31 2e 38 37 38 30 35 36 20 2c 20  nt( 11.878056 , 
5130: 34 33 2e 34 36 33 30 35 36 2c 20 34 33 32 36 20  43.463056, 4326 
5140: 29 2c 20 33 32 36 33 32 2c 20 4e 55 4c 4c 2c 20  ), 32632, NULL, 
5150: 27 61 75 74 68 5f 6e 61 6d 65 3a 61 75 74 68 5f  'auth_name:auth_
5160: 73 72 69 64 27 29 29 3b 20 2d 2d 20 53 52 49 44  srid')); -- SRID
5170: 3d 33 32 36 33 32 20 2d 20 4e 55 4c 4c 20 61 72  =32632 - NULL ar
5180: 65 61 20 6f 66 20 75 73 65 2c 20 69 67 6e 6f 72  ea of use, ignor
5190: 69 6e 67 20 73 70 61 74 69 61 6c 69 74 65 5f 72  ing spatialite_r
51a0: 65 66 5f 73 79 73 20 61 6e 64 20 75 73 69 6e 67  ef_sys and using
51b0: 20 74 68 65 20 50 52 4f 4a 2e 36 20 6f 77 6e 20   the PROJ.6 own 
51c0: 70 72 69 76 61 74 65 20 64 61 74 61 62 61 73 65  private database
51d0: 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ..--------------
51e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
51f0: 2d 2d 2d 2d 2d 2d 2d 0d 0a 50 4f 49 4e 54 28 37  -------..POINT(7
5200: 33 32 38 32 31 2e 37 31 38 34 37 35 20 34 38 31  32821.718475 481
5210: 36 32 36 32 2e 36 33 31 32 34 35 29 0d 0a 3c 2f  6262.631245)..</
5220: 76 65 72 62 61 74 69 6d 3e 0d 0a 54 68 69 73 20  verbatim>..This 
5230: 73 65 63 6f 6e 64 20 74 65 73 74 20 69 73 20 62  second test is b
5240: 61 73 65 64 20 69 6e 73 74 65 61 64 20 6f 6e 20  ased instead on 
5250: 61 20 6c 65 67 61 63 79 20 53 70 61 74 69 61 4c  a legacy SpatiaL
5260: 69 74 65 20 64 61 74 61 62 61 73 65 20 63 72 65  ite database cre
5270: 61 74 65 64 20 62 79 20 73 6f 6d 65 20 65 61 72  ated by some ear
5280: 6c 69 65 72 20 76 65 72 73 69 6f 6e 20 6c 61 63  lier version lac
5290: 6b 69 6e 67 20 50 52 4f 4a 2e 36 20 73 75 70 70  king PROJ.6 supp
52a0: 6f 72 74 2e 3c 62 72 3e 0d 0a 49 6e 20 74 68 69  ort.<br>..In thi
52b0: 73 20 73 70 65 63 69 66 69 63 20 63 61 73 65 20  s specific case 
52c0: 74 68 65 72 65 20 69 73 20 6e 6f 20 64 69 66 66  there is no diff
52d0: 65 72 65 6e 63 65 20 69 6e 20 74 68 65 20 72 65  erence in the re
52e0: 73 75 6c 74 73 20 72 65 74 75 72 6e 65 64 20 62  sults returned b
52f0: 79 20 64 69 66 66 65 72 65 6e 74 20 6d 65 74 68  y different meth
5300: 6f 64 73 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62  ods.<br><br>..<b
5310: 3e 3c 75 3e 4d 69 73 74 65 72 79 20 75 6e 76 65  ><u>Mistery unve
5320: 69 6c 65 64 3c 2f 75 3e 3c 2f 62 3e 3a 20 6a 75  iled</u></b>: ju
5330: 73 74 20 61 20 71 75 69 63 6b 20 67 6c 61 6e 63  st a quick glanc
5340: 65 20 74 6f 20 74 68 65 20 6f 6c 64 20 61 6e 64  e to the old and
5350: 20 6e 65 77 20 3c 62 3e 70 72 6f 6a 2d 73 74 72   new <b>proj-str
5360: 69 6e 67 73 3c 2f 62 3e 3a 0d 0a 3c 75 6c 3e 0d  ings</b>:..<ul>.
5370: 0a 3c 6c 69 3e 53 52 49 44 3d 33 30 30 33 20 70  .<li>SRID=3003 p
5380: 72 6f 6a 2d 73 74 72 69 6e 67 20 61 73 20 64 65  roj-string as de
5390: 66 69 6e 65 64 20 62 79 20 6f 6c 64 20 50 52 4f  fined by old PRO
53a0: 4a 2e 34 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e  J.4:..<ul>..<li>
53b0: 3c 62 3e 2b 70 72 6f 6a 3d 74 6d 65 72 63 20 2b  <b>+proj=tmerc +
53c0: 6c 61 74 5f 30 3d 30 20 2b 6c 6f 6e 5f 30 3d 39  lat_0=0 +lon_0=9
53d0: 20 2b 6b 3d 30 2e 39 39 39 36 20 2b 78 5f 30 3d   +k=0.9996 +x_0=
53e0: 31 35 30 30 30 30 30 20 2b 79 5f 30 3d 30 20 2b  1500000 +y_0=0 +
53f0: 65 6c 6c 70 73 3d 69 6e 74 6c 20 2b 74 6f 77 67  ellps=intl +towg
5400: 73 38 34 3d 2d 31 30 34 2e 31 2c 2d 34 39 2e 31  s84=-104.1,-49.1
5410: 2c 2d 39 2e 39 2c 30 2e 39 37 31 2c 2d 32 2e 39  ,-9.9,0.971,-2.9
5420: 31 37 2c 30 2e 37 31 34 2c 2d 31 31 2e 36 38 20  17,0.714,-11.68 
5430: 2b 75 6e 69 74 73 3d 6d 20 2b 6e 6f 5f 64 65 66  +units=m +no_def
5440: 73 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c  s</b></li>..</ul
5450: 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 53 52 49 44  ></li>..<li>SRID
5460: 3d 33 30 30 33 20 70 72 6f 6a 2d 73 74 72 69 6e  =3003 proj-strin
5470: 67 20 61 73 20 64 65 66 69 6e 65 64 20 62 79 20  g as defined by 
5480: 6e 65 77 20 50 52 4f 4a 2e 36 3a 0d 0a 3c 75 6c  new PROJ.6:..<ul
5490: 3e 0d 0a 3c 6c 69 3e 3c 62 3e 2b 70 72 6f 6a 3d  >..<li><b>+proj=
54a0: 74 6d 65 72 63 20 2b 6c 61 74 5f 30 3d 30 20 2b  tmerc +lat_0=0 +
54b0: 6c 6f 6e 5f 30 3d 39 20 2b 6b 3d 30 2e 39 39 39  lon_0=9 +k=0.999
54c0: 36 20 2b 78 5f 30 3d 31 35 30 30 30 30 30 20 2b  6 +x_0=1500000 +
54d0: 79 5f 30 3d 30 20 2b 65 6c 6c 70 73 3d 69 6e 74  y_0=0 +ellps=int
54e0: 6c 20 2b 75 6e 69 74 73 3d 6d 20 2b 6e 6f 5f 64  l +units=m +no_d
54f0: 65 66 73 20 2b 74 79 70 65 3d 63 72 73 3c 2f 62  efs +type=crs</b
5500: 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c  ></li>..</ul></l
5510: 69 3e 0d 0a 41 73 20 79 6f 75 20 63 61 6e 20 65  i>..As you can e
5520: 61 73 69 6c 79 20 6e 6f 74 69 63 65 2c 20 74 68  asily notice, th
5530: 65 72 65 20 69 73 20 6e 6f 20 3c 62 3e 2b 74 6f  ere is no <b>+to
5540: 77 67 73 38 34 3c 2f 62 3e 20 74 65 72 6d 20 64  wgs84</b> term d
5550: 65 66 69 6e 65 64 20 69 6e 20 6e 65 77 20 50 52  efined in new PR
5560: 4f 4a 2e 36 2c 20 61 6e 64 20 74 68 69 73 20 66  OJ.6, and this f
5570: 75 6c 6c 79 20 65 78 70 6c 61 69 6e 73 20 61 6c  ully explains al
5580: 6c 2e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 68 33 3e 4e  l...</ul>..<h3>N
5590: 65 77 20 61 75 78 69 6c 69 61 72 79 20 53 51 4c  ew auxiliary SQL
55a0: 20 66 75 6e 63 74 69 6f 6e 73 20 73 70 65 63 69   functions speci
55b0: 66 69 63 61 6c 6c 79 20 73 75 70 70 6f 72 74 69  fically supporti
55c0: 6e 67 20 50 52 4f 4a 2e 36 3c 2f 68 33 3e 0d 0a  ng PROJ.6</h3>..
55d0: 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61 63 69  <table cellspaci
55e0: 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64 64 69  ng="8" cellpaddi
55f0: 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72 3d 22  ng="8" bgcolor="
5600: 23 65 38 66 66 65 38 22 20 62 6f 72 64 65 72 3d  #e8ffe8" border=
5610: 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 68 20 62 67  "1">..<tr><th bg
5620: 63 6f 6c 6f 72 3d 22 23 66 66 62 30 33 65 22 3e  color="#ffb03e">
5630: 53 51 4c 20 46 75 6e 63 74 69 6f 6e 3c 2f 74 68  SQL Function</th
5640: 3e 3c 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66  ><th bgcolor="#f
5650: 66 62 30 33 65 22 3e 53 75 70 70 6f 72 74 65 64  fb03e">Supported
5660: 20 61 72 67 75 6d 65 6e 74 73 3c 2f 74 68 3e 3c   arguments</th><
5670: 74 68 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 62  th bgcolor="#ffb
5680: 30 33 65 22 3e 44 65 73 63 72 69 70 74 69 6f 6e  03e">Description
5690: 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e  </th></tr>..<tr>
56a0: 3c 74 64 3e 3c 62 3e 48 61 73 50 72 6f 6a 36 3c  <td><b>HasProj6<
56b0: 2f 62 3e 28 20 3c 69 3e 76 6f 69 64 3c 2f 69 3e  /b>( <i>void</i>
56c0: 20 29 20 3a 20 3c 69 3e 42 6f 6f 6c 65 61 6e 3c   ) : <i>Boolean<
56d0: 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4e 6f  /i></td>..<td>No
56e0: 6e 65 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c  ne</td>..<td>Wil
56f0: 6c 20 72 65 74 75 72 6e 20 3c 62 3e 31 3c 2f 62  l return <b>1</b
5700: 3e 20 28 3c 62 3e 54 52 55 45 3c 2f 62 3e 29 20  > (<b>TRUE</b>) 
5710: 69 66 20 74 68 65 20 6c 69 62 72 61 72 79 20 68  if the library h
5720: 61 73 20 62 65 65 6e 20 62 75 69 6c 74 20 6f 6e  as been built on
5730: 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 20 28   <b>PROJ.6</b> (
5740: 6f 72 20 61 6e 79 20 6c 61 74 65 72 20 76 65 72  or any later ver
5750: 73 69 6f 6e 29 2c 20 6f 74 68 65 72 77 69 73 65  sion), otherwise
5760: 20 3c 62 3e 30 3c 2f 62 3e 20 28 3c 62 3e 46 41   <b>0</b> (<b>FA
5770: 4c 53 45 3c 2f 62 3e 29 2e 3c 2f 74 64 3e 3c 2f  LSE</b>).</td></
5780: 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e  tr>..<tr><td><b>
5790: 50 52 4f 4a 5f 47 65 74 4c 61 73 74 45 72 72 6f  PROJ_GetLastErro
57a0: 72 4d 73 67 3c 2f 62 3e 28 20 3c 69 3e 76 6f 69  rMsg</b>( <i>voi
57b0: 64 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 53 74 72  d</i> ) : <i>Str
57c0: 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e 0d 0a 3c 74  ing</i></td>..<t
57d0: 64 3e 4e 6f 6e 65 3c 2f 74 64 3e 0d 0a 3c 74 64  d>None</td>..<td
57e0: 3e 57 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 65  >Will return the
57f0: 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 65 72 72   most recent err
5800: 6f 72 20 6d 65 73 73 61 67 65 20 72 65 74 75 72  or message retur
5810: 6e 65 64 20 62 79 20 50 52 4f 4a 20 28 69 66 20  ned by PROJ (if 
5820: 61 6e 79 29 2e 3c 62 72 3e 0d 0a 3c 62 3e 4e 55  any).<br>..<b>NU
5830: 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72  LL</b> will be r
5840: 65 74 75 72 6e 65 64 20 69 66 20 74 68 65 72 65  eturned if there
5850: 20 69 73 20 6e 6f 20 63 75 72 65 6e 74 6c 79 20   is no curently 
5860: 70 65 6e 64 69 6e 67 20 50 52 4f 4a 20 65 72 72  pending PROJ err
5870: 6f 72 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c  or.</td></tr>..<
5880: 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f 47  tr><td><b>PROJ_G
5890: 65 74 44 61 74 61 62 61 73 65 50 61 74 68 3c 2f  etDatabasePath</
58a0: 62 3e 28 20 3c 69 3e 76 6f 69 64 3c 2f 69 3e 20  b>( <i>void</i> 
58b0: 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 29  : <i>String</i>)
58c0: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4e 6f 6e 65 3c  </td>..<td>None<
58d0: 2f 74 64 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 72  /td>..<td>Will r
58e0: 65 74 75 72 6e 20 74 68 65 20 63 75 72 72 65 6e  eturn the curren
58f0: 74 6c 79 20 73 65 74 20 70 61 74 68 6e 61 6d 65  tly set pathname
5900: 20 6c 65 61 64 69 6e 67 20 74 6f 20 74 68 65 20   leading to the 
5910: 70 72 69 76 61 74 65 20 50 52 4f 4a 27 73 20 53  private PROJ's S
5920: 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 2e 3c  QLite database.<
5930: 62 72 3e 0d 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e  br>..<b>NULL</b>
5940: 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65   will be returne
5950: 64 20 69 66 20 74 68 65 72 65 20 69 73 20 6e 6f  d if there is no
5960: 20 70 72 69 76 61 74 65 20 50 52 4f 4a 27 73 20   private PROJ's 
5970: 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 20  SQLite database 
5980: 63 75 72 72 65 6e 74 6c 79 20 63 6f 6e 6e 65 63  currently connec
5990: 74 65 64 2e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a  ted.</td></tr>..
59a0: 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f  <tr><td><b>PROJ_
59b0: 53 65 74 44 61 74 61 62 61 73 65 50 61 74 68 3c  SetDatabasePath<
59c0: 2f 62 3e 20 28 20 6e 65 77 5f 70 61 74 68 20 3c  /b> ( new_path <
59d0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a  i>String</i> ) :
59e0: 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f   <i>String</i></
59f0: 74 64 3e 0d 0a 3c 74 64 3e 0d 0a 3c 75 6c 3e 0d  td>..<td>..<ul>.
5a00: 0a 3c 6c 69 3e 3c 62 3e 6e 65 77 5f 70 61 74 68  .<li><b>new_path
5a10: 3c 2f 62 3e 3a 20 61 20 72 65 6c 61 74 69 76 65  </b>: a relative
5a20: 20 6f 72 20 61 62 73 6f 6c 75 74 65 20 70 61 74   or absolute pat
5a30: 68 6e 61 6d 65 20 6c 65 61 64 69 6e 67 20 74 6f  hname leading to
5a40: 20 61 20 76 61 6c 69 64 20 50 52 4f 4a 27 73 20   a valid PROJ's 
5a50: 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 2e  SQLite database.
5a60: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 74 64  </li>..</ul></td
5a70: 3e 0d 0a 3c 74 64 3e 57 69 6c 6c 20 63 68 61 6e  >..<td>Will chan
5a80: 67 65 20 74 68 65 20 63 75 72 72 65 6e 74 6c 79  ge the currently
5a90: 20 73 65 74 20 70 61 74 68 6e 61 6d 65 20 6c 65   set pathname le
5aa0: 61 64 69 6e 67 20 74 6f 20 74 68 65 20 70 72 69  ading to the pri
5ab0: 76 61 74 65 20 50 52 4f 4a 27 73 20 53 51 4c 69  vate PROJ's SQLi
5ac0: 74 65 20 64 61 74 61 62 61 73 65 2e 3c 62 72 3e  te database.<br>
5ad0: 0d 0a 3c 62 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69  ..<b>NULL</b> wi
5ae0: 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 69  ll be returned i
5af0: 66 20 74 68 65 20 70 61 73 73 65 64 20 70 61 74  f the passed pat
5b00: 68 20 69 73 20 69 6e 76 61 6c 69 64 2c 20 6f 74  h is invalid, ot
5b10: 68 65 72 77 69 73 65 20 74 68 65 20 70 61 74 68  herwise the path
5b20: 20 6f 66 20 74 68 65 20 63 75 72 72 65 6e 74 6c   of the currentl
5b30: 79 20 73 65 74 20 70 72 69 76 61 74 65 20 50 52  y set private PR
5b40: 4f 4a 27 73 20 53 51 4c 69 74 65 20 64 61 74 61  OJ's SQLite data
5b50: 62 61 73 65 20 77 69 6c 6c 20 62 65 20 72 65 74  base will be ret
5b60: 75 72 6e 65 64 2e 3c 2f 74 64 3e 3c 2f 74 72 3e  urned.</td></tr>
5b70: 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 50 52 4f  ..<tr><td><b>PRO
5b80: 4a 5f 41 73 57 4b 54 3c 2f 62 3e 20 28 20 61 75  J_AsWKT</b> ( au
5b90: 74 68 5f 6e 61 6d 65 20 3c 69 3e 53 74 72 69 6e  th_name <i>Strin
5ba0: 67 3c 2f 69 3e 20 2c 20 61 75 74 68 5f 73 72 69  g</i> , auth_sri
5bb0: 64 20 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e  d <i>Integer</i>
5bc0: 20 29 20 3a 20 3c 69 3e 53 74 72 69 6e 67 3c 2f   ) : <i>String</
5bd0: 69 3e 3c 68 72 3e 0d 0a 3c 62 3e 50 52 4f 4a 5f  i><hr>..<b>PROJ_
5be0: 41 73 57 4b 54 3c 2f 62 3e 20 28 20 61 75 74 68  AsWKT</b> ( auth
5bf0: 5f 6e 61 6d 65 20 3c 69 3e 53 74 72 69 6e 67 3c  _name <i>String<
5c00: 2f 69 3e 20 2c 20 61 75 74 68 5f 73 72 69 64 20  /i> , auth_srid 
5c10: 3c 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 20 2c  <i>Integer</i> ,
5c20: 20 77 6b 74 5f 73 74 79 6c 65 20 3c 69 3e 53 74   wkt_style <i>St
5c30: 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e  ring</i> ) : <i>
5c40: 53 74 72 69 6e 67 3c 2f 69 3e 3c 68 72 3e 0d 0a  String</i><hr>..
5c50: 3c 62 3e 50 52 4f 4a 5f 41 73 57 4b 54 3c 2f 62  <b>PROJ_AsWKT</b
5c60: 3e 20 28 20 61 75 74 68 5f 6e 61 6d 65 20 3c 69  > ( auth_name <i
5c70: 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20 61 75  >String</i> , au
5c80: 74 68 5f 73 72 69 64 20 3c 69 3e 49 6e 74 65 67  th_srid <i>Integ
5c90: 65 72 3c 2f 69 3e 20 2c 20 77 6b 74 5f 73 74 79  er</i> , wkt_sty
5ca0: 6c 65 20 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e  le <i>String</i>
5cb0: 20 2c 20 69 6e 64 65 6e 74 65 64 20 3c 69 3e 42   , indented <i>B
5cc0: 6f 6f 6c 65 61 6e 3c 2f 69 3e 20 29 20 3a 20 3c  oolean</i> ) : <
5cd0: 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 68 72 3e  i>String</i><hr>
5ce0: 0d 0a 3c 62 3e 50 52 4f 4a 5f 41 73 57 4b 54 3c  ..<b>PROJ_AsWKT<
5cf0: 2f 62 3e 20 28 20 61 75 74 68 5f 6e 61 6d 65 20  /b> ( auth_name 
5d00: 3c 69 3e 53 74 72 69 6e 67 3c 2f 69 3e 20 2c 20  <i>String</i> , 
5d10: 61 75 74 68 5f 73 72 69 64 20 3c 69 3e 49 6e 74  auth_srid <i>Int
5d20: 65 67 65 72 3c 2f 69 3e 20 2c 20 77 6b 74 5f 73  eger</i> , wkt_s
5d30: 74 79 6c 65 20 3c 69 3e 53 74 72 69 6e 67 3c 2f  tyle <i>String</
5d40: 69 3e 20 2c 20 69 6e 64 65 6e 74 65 64 20 3c 69  i> , indented <i
5d50: 3e 42 6f 6f 6c 65 61 6e 3c 2f 69 3e 20 2c 20 69  >Boolean</i> , i
5d60: 6e 64 65 6e 74 61 74 69 6f 6e 20 3c 69 3e 49 6e  ndentation <i>In
5d70: 74 65 67 65 72 3c 2f 69 3e 20 29 20 3a 20 3c 69  teger</i> ) : <i
5d80: 3e 53 74 72 69 6e 67 3c 2f 69 3e 3c 2f 74 64 3e  >String</i></td>
5d90: 0d 0a 3c 74 64 3e 3c 75 6c 3e 0d 0a 3c 6c 69 3e  ..<td><ul>..<li>
5da0: 3c 62 3e 61 75 74 68 5f 6e 61 6d 65 3c 2f 62 3e  <b>auth_name</b>
5db0: 20 61 6e 64 20 3c 62 3e 61 75 74 68 5f 73 72 69   and <b>auth_sri
5dc0: 64 3c 2f 62 3e 20 69 64 65 6e 74 69 66 79 20 74  d</b> identify t
5dd0: 68 65 20 69 6e 74 65 6e 64 65 64 20 43 52 53 2e  he intended CRS.
5de0: 3c 62 72 3e 0d 0a 3c 62 3e 61 75 74 68 5f 6e 61  <br>..<b>auth_na
5df0: 6d 65 3c 2f 62 3e 20 63 61 6e 20 62 65 20 3c 62  me</b> can be <b
5e00: 3e 4e 55 4c 4c 3c 2f 62 3e 2c 20 61 6e 64 20 69  >NULL</b>, and i
5e10: 6e 20 74 68 69 73 20 63 61 73 65 20 3c 62 3e 45  n this case <b>E
5e20: 50 53 47 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20  PSG</b> will be 
5e30: 61 73 73 75 6d 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c  assumed.</li>..<
5e40: 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20  li>the optional 
5e50: 61 72 67 75 6d 65 6e 74 20 3c 62 3e 73 74 79 6c  argument <b>styl
5e60: 65 3c 2f 62 3e 20 64 65 74 65 72 6d 69 6e 65 73  e</b> determines
5e70: 20 77 68 69 63 68 20 73 70 65 63 69 66 69 63 20   which specific 
5e80: 57 4b 54 20 66 6f 72 6d 61 74 20 73 68 6f 75 6c  WKT format shoul
5e90: 64 20 62 65 20 61 64 6f 70 74 65 64 2c 20 61 6e  d be adopted, an
5ea0: 64 20 6d 75 73 74 20 62 65 20 6f 6e 65 20 62 65  d must be one be
5eb0: 74 77 65 65 6e 20 3c 62 3e 47 44 41 4c 3c 2f 62  tween <b>GDAL</b
5ec0: 3e 2c 20 3c 62 3e 45 53 52 49 3c 2f 62 3e 2c 20  >, <b>ESRI</b>, 
5ed0: 3c 62 3e 49 53 4f 2d 32 30 31 35 3c 2f 62 3e 20  <b>ISO-2015</b> 
5ee0: 6f 72 20 3c 62 3e 49 53 4f 2d 32 30 31 38 3c 2f  or <b>ISO-2018</
5ef0: 62 3e 20 28 74 68 69 73 20 6c 61 74 74 65 72 20  b> (this latter 
5f00: 62 65 69 6e 67 20 74 68 65 20 64 65 66 61 75 6c  being the defaul
5f10: 74 20 73 65 74 74 69 6e 67 29 2e 3c 2f 6c 69 3e  t setting).</li>
5f20: 0d 0a 3c 6c 69 3e 74 68 65 20 6f 70 74 69 6f 6e  ..<li>the option
5f30: 61 6c 20 61 72 67 75 6d 65 6e 74 20 3c 62 3e 69  al argument <b>i
5f40: 6e 64 65 6e 74 65 64 3c 2f 62 3e 20 69 66 20 73  ndented</b> if s
5f50: 65 74 20 74 6f 20 3c 62 3e 54 52 55 45 3c 2f 62  et to <b>TRUE</b
5f60: 3e 20 77 69 6c 6c 20 6e 69 63 65 6c 79 20 66 6f  > will nicely fo
5f70: 72 6d 61 74 20 61 20 6d 75 6c 74 69 6c 69 6e 65  rmat a multiline
5f80: 20 57 4b 54 20 65 78 70 72 65 73 73 69 6f 6e 2c   WKT expression,
5f90: 20 6f 74 68 65 72 77 69 73 65 20 61 20 73 69 6e   otherwise a sin
5fa0: 67 6c 65 20 6d 6f 6e 6f 6c 69 74 68 69 63 20 6c  gle monolithic l
5fb0: 69 6e 65 20 6c 61 63 6b 69 6e 67 20 61 6e 79 20  ine lacking any 
5fc0: 77 68 69 74 65 2d 73 70 61 63 65 20 6f 72 20 6e  white-space or n
5fd0: 65 77 2d 6c 69 6e 65 20 77 69 6c 6c 20 62 65 20  ew-line will be 
5fe0: 70 72 69 6e 74 65 64 20 28 74 68 65 20 64 65 66  printed (the def
5ff0: 61 75 6c 74 20 69 73 20 3c 62 3e 54 52 55 45 3c  ault is <b>TRUE<
6000: 2f 62 3e 29 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e  /b>).</li>..<li>
6010: 74 68 65 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67  the optional arg
6020: 75 6d 65 6e 74 20 3c 62 3e 69 6e 64 65 6e 74 61  ument <b>indenta
6030: 74 69 6f 6e 3c 2f 62 3e 20 64 65 74 65 72 6d 69  tion</b> determi
6040: 6e 65 73 20 68 6f 77 20 6d 61 6e 79 20 77 68 69  nes how many whi
6050: 74 65 2d 73 70 61 63 65 73 20 61 72 65 20 74 6f  te-spaces are to
6060: 20 62 65 20 75 73 65 64 20 66 6f 72 20 69 6e 64   be used for ind
6070: 65 6e 74 69 6e 67 20 28 6f 6e 6c 79 20 6d 65 61  enting (only mea
6080: 6e 69 6e 67 66 75 6c 20 69 66 20 3c 62 3e 3c 69  ningful if <b><i
6090: 3e 69 6e 64 65 6e 74 65 64 3d 54 52 55 45 3c 2f  >indented=TRUE</
60a0: 69 3e 3c 2f 62 3e 3b 20 74 68 65 20 64 65 66 61  i></b>; the defa
60b0: 75 6c 74 20 76 61 6c 75 65 73 20 69 73 20 3c 62  ult values is <b
60c0: 3e 34 3c 2f 62 3e 29 2e 3c 2f 6c 69 3e 0d 0a 3c  >4</b>).</li>..<
60d0: 2f 75 6c 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 57  /ul></td>..<td>W
60e0: 69 6c 6c 20 72 65 74 75 72 6e 20 74 68 65 20 57  ill return the W
60f0: 4b 54 20 65 78 70 72 65 73 73 69 6f 6e 20 63 6f  KT expression co
6100: 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 61  rresponding to a
6110: 20 67 69 76 65 6e 20 43 52 53 3b 20 74 68 65 20   given CRS; the 
6120: 64 65 66 69 6e 69 74 69 6f 6e 73 20 77 69 6c 6c  definitions will
6130: 20 62 65 20 74 61 6b 65 6e 20 64 69 72 65 63 74   be taken direct
6140: 6c 79 20 66 72 6f 6d 20 74 68 65 20 70 72 69 76  ly from the priv
6150: 61 74 65 20 50 52 4f 4a 27 73 20 6f 77 6e 20 64  ate PROJ's own d
6160: 61 74 61 62 61 73 65 2e 3c 62 72 3e 0d 0a 3c 62  atabase.<br>..<b
6170: 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 62  >NULL</b> will b
6180: 65 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 66 61  e returned on fa
6190: 69 6c 75 72 65 20 6f 72 20 6f 6e 20 69 6e 76 61  ilure or on inva
61a0: 6c 69 64 20 61 72 67 75 6d 65 6e 74 73 2e 3c 2f  lid arguments.</
61b0: 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74  td></tr>..<tr><t
61c0: 64 3e 3c 62 3e 50 52 4f 4a 5f 47 75 65 73 73 53  d><b>PROJ_GuessS
61d0: 72 69 64 46 72 6f 6d 57 4b 54 3c 2f 62 3e 20 28  ridFromWKT</b> (
61e0: 20 77 6b 74 5f 65 78 70 72 20 3c 69 3e 53 74 72   wkt_expr <i>Str
61f0: 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c 69 3e 49  ing</i> ) : <i>I
6200: 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74 64 3e 0d  nteger</i></td>.
6210: 0a 3c 74 64 3e 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c  .<td><ul>..<li><
6220: 62 3e 77 6b 74 5f 65 78 70 72 3c 2f 62 3e 3a 20  b>wkt_expr</b>: 
6230: 74 68 65 20 57 4b 54 20 65 78 70 72 65 73 73 69  the WKT expressi
6240: 6f 6e 20 74 6f 20 62 65 20 65 76 61 6c 75 61 74  on to be evaluat
6250: 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c  ed.</li>..</ul><
6260: 2f 74 64 3e 0d 0a 3c 74 64 3e 0d 0a 57 69 6c 6c  /td>..<td>..Will
6270: 20 70 6f 73 73 69 62 6c 79 20 72 65 74 75 72 6e   possibly return
6280: 20 74 68 65 20 3c 62 3e 53 52 49 44 20 76 61 6c   the <b>SRID val
6290: 75 65 3c 2f 62 3e 20 63 6f 72 72 65 73 70 6f 6e  ue</b> correspon
62a0: 64 69 6e 67 20 74 6f 20 61 20 67 69 76 65 6e 20  ding to a given 
62b0: 57 4b 54 20 65 78 70 72 65 73 73 69 6f 6e 20 64  WKT expression d
62c0: 65 66 69 6e 69 6e 67 20 61 20 43 52 53 2e 3c 62  efining a CRS.<b
62d0: 72 3e 0d 0a 3c 62 3e 2d 31 3c 2f 62 3e 20 77 69  r>..<b>-1</b> wi
62e0: 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 69  ll be returned i
62f0: 66 20 6e 6f 20 43 52 53 20 73 75 70 70 6f 72 74  f no CRS support
6300: 65 64 20 62 79 20 50 52 4f 4a 2e 36 20 6d 61 74  ed by PROJ.6 mat
6310: 63 68 65 73 20 74 68 65 20 57 4b 54 20 65 78 70  ches the WKT exp
6320: 72 65 73 73 69 6f 6e 2e 3c 62 72 3e 0d 0a 3c 62  ression.<br>..<b
6330: 3e 4e 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 62  >NULL</b> will b
6340: 65 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 69 6e  e returned on in
6350: 76 61 6c 69 64 20 61 72 67 75 6d 65 6e 74 2e 0d  valid argument..
6360: 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72  .</td></tr>..<tr
6370: 3e 3c 74 64 3e 3c 62 3e 50 52 4f 4a 5f 47 75 65  ><td><b>PROJ_Gue
6380: 73 73 53 72 69 64 46 72 6f 6d 53 48 50 3c 2f 62  ssSridFromSHP</b
6390: 3e 20 28 20 66 69 6c 65 6e 61 6d 65 20 3c 69 3e  > ( filename <i>
63a0: 53 74 72 69 6e 67 3c 2f 69 3e 20 29 20 3a 20 3c  String</i> ) : <
63b0: 69 3e 49 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 74  i>Integer</i></t
63c0: 64 3e 0d 0a 3c 74 64 3e 3c 75 6c 3e 0d 0a 3c 6c  d>..<td><ul>..<l
63d0: 69 3e 3c 62 3e 66 69 6c 65 6e 61 6d 65 3c 2f 62  i><b>filename</b
63e0: 3e 3a 20 74 68 65 20 61 62 73 6f 6c 75 74 65 20  >: the absolute 
63f0: 6f 72 20 72 65 6c 61 74 69 76 65 20 70 61 74 68  or relative path
6400: 20 6c 65 61 64 69 6e 67 20 74 6f 20 73 6f 6d 65   leading to some
6410: 20 53 68 61 70 65 66 69 6c 65 2e 3c 62 72 3e 0d   Shapefile.<br>.
6420: 0a 4e 6f 74 65 3a 20 65 78 61 63 74 6c 65 79 20  .Note: exactley 
6430: 61 73 20 72 65 71 75 69 72 65 64 20 62 79 20 3c  as required by <
6440: 62 3e 3c 69 3e 49 6d 70 6f 72 74 53 48 50 3c 2f  b><i>ImportSHP</
6450: 69 3e 3c 2f 62 3e 28 29 20 3c 62 3e 3c 69 3e 66  i></b>() <b><i>f
6460: 69 6c 65 6e 61 6d 65 3c 2f 69 3e 3c 2f 62 3e 20  ilename</i></b> 
6470: 6d 75 73 74 20 6f 6d 69 74 20 61 6e 79 20 3c 62  must omit any <b
6480: 3e 2e 73 68 70 3c 2f 62 3e 2c 20 3c 62 3e 2e 73  >.shp</b>, <b>.s
6490: 68 78 3c 2f 62 3e 2c 20 3c 62 3e 2e 64 62 66 3c  hx</b>, <b>.dbf<
64a0: 2f 62 3e 20 6f 72 20 3c 62 3e 2e 70 72 6a 3c 2f  /b> or <b>.prj</
64b0: 62 3e 20 73 75 66 66 69 78 2e 3c 2f 6c 69 3e 0d  b> suffix.</li>.
64c0: 0a 3c 2f 75 6c 3e 3c 2f 74 64 3e 0d 0a 3c 74 64  .</ul></td>..<td
64d0: 3e 0d 0a 57 69 6c 6c 20 70 6f 73 73 69 62 6c 79  >..Will possibly
64e0: 20 72 65 74 75 72 6e 20 74 68 65 20 3c 62 3e 53   return the <b>S
64f0: 52 49 44 20 76 61 6c 75 65 3c 2f 62 3e 20 63 6f  RID value</b> co
6500: 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 74  rresponding to t
6510: 68 65 20 43 52 53 20 64 65 66 69 6e 65 64 20 62  he CRS defined b
6520: 79 20 74 68 65 20 2e 50 52 4a 20 6d 65 6d 62 65  y the .PRJ membe
6530: 72 20 6f 66 20 74 68 65 20 53 68 61 70 65 66 69  r of the Shapefi
6540: 6c 65 2e 3c 62 72 3e 0d 0a 3c 62 3e 2d 31 3c 2f  le.<br>..<b>-1</
6550: 62 3e 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72  b> will be retur
6560: 6e 65 64 20 69 66 20 6e 6f 20 43 52 53 20 73 75  ned if no CRS su
6570: 70 70 6f 72 74 65 64 20 62 79 20 50 52 4f 4a 2e  pported by PROJ.
6580: 36 20 6d 61 74 63 68 65 73 20 50 52 4a 20 6d 65  6 matches PRJ me
6590: 6d 62 65 72 20 6f 66 20 74 68 65 20 53 68 61 70  mber of the Shap
65a0: 65 66 69 6c 65 2e 3c 62 72 3e 0d 0a 3c 62 3e 4e  efile.<br>..<b>N
65b0: 55 4c 4c 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20  ULL</b> will be 
65c0: 72 65 74 75 72 6e 65 64 20 6f 6e 20 69 6e 76 61  returned on inva
65d0: 6c 69 64 20 61 72 67 75 6d 65 6e 74 2e 3c 68 72  lid argument.<hr
65e0: 3e 0d 0a 3c 75 3e 50 6c 65 61 73 65 20 6e 6f 74  >..<u>Please not
65f0: 65 20 77 65 6c 6c 3c 2f 75 3e 3a 20 74 68 69 73  e well</u>: this
6600: 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 6f 70   SQL function op
6610: 65 6e 64 20 74 68 65 20 64 6f 6f 72 20 74 6f 20  end the door to 
6620: 6d 61 6e 79 20 70 6f 74 65 6e 74 69 61 6c 20 73  many potential s
6630: 65 63 75 72 69 74 79 20 69 73 73 75 65 73 2c 20  ecurity issues, 
6640: 61 6e 64 20 74 68 75 73 20 69 73 20 61 6c 77 61  and thus is alwa
6650: 79 73 20 3c 69 3e 64 69 73 61 62 6c 65 64 20 62  ys <i>disabled b
6660: 79 20 64 65 66 61 75 6c 74 3c 2f 69 3e 2e 3c 62  y default</i>.<b
6670: 72 3e 0d 0a 45 78 70 6c 69 63 69 74 6c 79 20 73  r>..Explicitly s
6680: 65 74 74 69 6e 67 20 74 68 65 20 65 6e 76 69 72  etting the envir
6690: 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20  onment variable 
66a0: 3c 62 3e 53 50 41 54 49 41 4c 49 54 45 5f 53 45  <b>SPATIALITE_SE
66b0: 43 55 52 49 54 59 3d 72 65 6c 61 78 65 64 3c 2f  CURITY=relaxed</
66c0: 62 3e 20 69 73 20 61 62 73 6f 6c 75 74 65 6c 79  b> is absolutely
66d0: 20 72 65 71 75 69 72 65 64 20 69 6e 20 6f 72 64   required in ord
66e0: 65 72 20 74 6f 20 65 6e 61 62 6c 65 20 74 68 69  er to enable thi
66f0: 73 20 66 75 6e 63 74 69 6f 6e 2e 0d 0a 3c 2f 74  s function...</t
6700: 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65  d></tr>..</table
6710: 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63 65  ><br>..<table ce
6720: 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63 65  llspacing="8" ce
6730: 6c 6c 70 61 64 64 69 6e 67 3d 22 31 36 22 20 62  llpadding="16" b
6740: 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 65 39 22  gcolor="#ffffe9"
6750: 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d 0a 3c 62 3e  >..<tr><td>..<b>
6760: 3c 75 3e 4e 6f 74 65 3c 2f 75 3e 3c 2f 62 3e 3a  <u>Note</u></b>:
6770: 20 61 6c 6c 20 74 68 65 20 61 62 6f 76 65 20 53   all the above S
6780: 51 4c 20 46 75 6e 63 74 69 6f 6e 73 20 77 69 6c  QL Functions wil
6790: 6c 20 62 65 20 61 76 61 69 6c 61 62 6c 65 20 6f  l be available o
67a0: 6e 6c 79 20 77 68 65 6e 20 53 70 61 74 69 61 6c  nly when Spatial
67b0: 69 74 65 2d 35 2e 30 2e 30 20 68 61 73 20 62 65  ite-5.0.0 has be
67c0: 65 6e 20 62 75 69 6c 74 20 61 67 61 69 6e 73 74  en built against
67d0: 20 3c 62 3e 50 52 4f 4a 2e 36 3c 2f 62 3e 20 28   <b>PROJ.6</b> (
67e0: 6f 72 20 61 6e 79 20 73 75 62 73 65 71 75 65 6e  or any subsequen
67f0: 74 20 76 65 72 73 69 6f 6e 29 2e 3c 62 72 3e 0d  t version).<br>.
6800: 0a 49 66 20 53 70 61 74 69 61 4c 69 74 65 2d 35  .If SpatiaLite-5
6810: 2e 30 2e 30 20 68 61 73 20 62 65 65 6e 20 62 75  .0.0 has been bu
6820: 69 6c 74 20 69 6e 73 74 65 61 64 20 61 67 61 69  ilt instead agai
6830: 6e 73 74 20 61 6e 79 20 70 72 65 76 69 6f 73 75  nst any previosu
6840: 73 20 76 65 72 73 69 6f 6e 20 28 61 73 20 65 2e  s version (as e.
6850: 67 2e 20 3c 62 3e 50 52 4f 4a 2e 34 3c 2f 62 3e  g. <b>PROJ.4</b>
6860: 29 20 61 6e 79 20 61 74 74 65 6d 70 74 20 74 6f  ) any attempt to
6870: 20 63 61 6c 6c 20 6f 6e 65 20 6f 66 20 74 68 65   call one of the
6880: 73 65 20 53 51 4c 20 46 75 6e 63 74 69 6f 6e 73  se SQL Functions
6890: 20 77 69 6c 6c 20 73 69 6d 70 6c 79 20 72 65 74   will simply ret
68a0: 75 72 6e 20 61 20 3c 62 3e 3c 69 3e 3c 75 3e 6e  urn a <b><i><u>n
68b0: 6f 20 73 75 63 68 20 66 75 6e 63 74 69 6f 6e 3c  o such function<
68c0: 2f 75 3e 3c 2f 69 3e 3c 2f 62 3e 20 53 51 4c 20  /u></i></b> SQL 
68d0: 65 72 72 6f 72 2e 0d 0a 3c 2f 74 64 3e 3c 2f 74  error...</td></t
68e0: 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e  r>..</table><br>
68f0: 0d 0a 3c 62 3e 50 72 61 63 74 69 63 61 6c 20 65  ..<b>Practical e
6900: 78 61 6d 70 6c 65 73 3a 3c 2f 62 3e 0d 0a 3c 76  xamples:</b>..<v
6910: 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 54  erbatim>..SELECT
6920: 20 50 52 4f 4a 5f 47 65 74 44 61 74 61 62 61 73   PROJ_GetDatabas
6930: 65 50 61 74 68 28 29 3b 20 20 2d 2d 20 72 65 74  ePath();  -- ret
6940: 72 69 65 76 69 6e 67 20 74 68 65 20 63 75 72 72  rieving the curr
6950: 65 6e 74 6c 79 20 73 65 74 20 50 52 4f 4a 27 73  ently set PROJ's
6960: 20 6f 77 6e 20 64 61 74 61 62 61 73 65 0d 0a 2d   own database..-
6970: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
6980: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 2f  -------------../
6990: 75 73 72 2f 6c 6f 63 61 6c 2f 73 68 61 72 65 2f  usr/local/share/
69a0: 70 72 6f 6a 2f 70 72 6f 6a 2e 64 62 0d 0a 0d 0a  proj/proj.db....
69b0: 53 45 4c 45 43 54 20 50 52 4f 4a 5f 53 65 74 44  SELECT PROJ_SetD
69c0: 61 74 61 62 61 73 65 50 61 74 68 28 27 2f 68 6f  atabasePath('/ho
69d0: 6d 65 2f 73 61 6e 64 72 6f 2f 6e 6f 74 5f 65 78  me/sandro/not_ex
69e0: 69 73 74 69 6e 67 5f 70 72 6f 6a 2e 64 62 27 29  isting_proj.db')
69f0: 3b 20 2d 2d 20 6e 6f 6e 20 65 78 69 73 74 69 6e  ; -- non existin
6a00: 67 20 64 61 74 61 62 61 73 65 0d 0a 2d 2d 2d 2d  g database..----
6a10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
6a20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 4e 55 4c 4c  ----------..NULL
6a30: 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f  ....SELECT PROJ_
6a40: 47 65 74 4c 61 73 74 45 72 72 6f 72 4d 73 67 28  GetLastErrorMsg(
6a50: 29 3b 20 2d 2d 20 72 65 74 72 69 65 76 69 6e 67  ); -- retrieving
6a60: 20 74 68 65 20 66 61 69 6c 75 72 65 20 63 61 75   the failure cau
6a70: 73 65 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  se..------------
6a80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
6a90: 2d 2d 0d 0a 70 72 6f 6a 5f 63 6f 6e 74 65 78 74  --..proj_context
6aa0: 5f 73 65 74 5f 64 61 74 61 62 61 73 65 5f 70 61  _set_database_pa
6ab0: 74 68 3a 20 4f 70 65 6e 20 6f 66 20 2f 68 6f 6d  th: Open of /hom
6ac0: 65 2f 73 61 6e 64 72 6f 2f 6e 6f 74 5f 65 78 69  e/sandro/not_exi
6ad0: 73 74 69 6e 67 5f 70 72 6f 6a 2e 64 62 20 66 61  sting_proj.db fa
6ae0: 69 6c 65 64 0d 0a 0d 0a 53 45 4c 45 43 54 20 50  iled....SELECT P
6af0: 52 4f 4a 5f 53 65 74 44 61 74 61 62 61 73 65 50  ROJ_SetDatabaseP
6b00: 61 74 68 28 27 2f 68 6f 6d 65 2f 73 61 6e 64 72  ath('/home/sandr
6b10: 6f 2f 76 61 6c 69 64 5f 70 72 6f 6a 2e 64 62 27  o/valid_proj.db'
6b20: 29 3b 20 2d 2d 20 76 61 6c 69 64 20 64 61 74 61  ); -- valid data
6b30: 62 61 73 65 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  base..----------
6b40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
6b50: 2d 2d 2d 2d 0d 0a 2f 68 6f 6d 65 2f 73 61 6e 64  ----../home/sand
6b60: 72 6f 2f 76 61 6c 69 64 5f 70 72 6f 6a 2e 64 62  ro/valid_proj.db
6b70: 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f  ....SELECT PROJ_
6b80: 41 73 57 4b 54 28 27 45 50 53 47 27 2c 20 34 33  AsWKT('EPSG', 43
6b90: 32 36 29 3b 20 2d 2d 20 64 65 66 61 75 6c 74 20  26); -- default 
6ba0: 73 65 74 74 69 6e 67 73 3a 20 49 53 4f 2d 32 30  settings: ISO-20
6bb0: 31 38 20 73 74 79 6c 65 2c 20 69 6e 64 65 6e 74  18 style, indent
6bc0: 65 64 20 77 69 74 68 20 69 6e 64 65 6e 74 61 74  ed with indentat
6bd0: 69 6f 6e 20 34 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d  ion 4..---------
6be0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
6bf0: 2d 2d 2d 2d 2d 0d 0a 47 45 4f 44 43 52 53 5b 22  -----..GEODCRS["
6c00: 57 47 53 20 38 34 22 2c 0d 0a 20 20 20 20 44 41  WGS 84",..    DA
6c10: 54 55 4d 5b 22 57 6f 72 6c 64 20 47 65 6f 64 65  TUM["World Geode
6c20: 74 69 63 20 53 79 73 74 65 6d 20 31 39 38 34 22  tic System 1984"
6c30: 2c 0d 0a 20 20 20 20 20 20 20 20 45 4c 4c 49 50  ,..        ELLIP
6c40: 53 4f 49 44 5b 22 57 47 53 20 38 34 22 2c 36 33  SOID["WGS 84",63
6c50: 37 38 31 33 37 2c 32 39 38 2e 32 35 37 32 32 33  78137,298.257223
6c60: 35 36 33 2c 0d 0a 20 20 20 20 20 20 20 20 20 20  563,..          
6c70: 20 20 4c 45 4e 47 54 48 55 4e 49 54 5b 22 6d 65    LENGTHUNIT["me
6c80: 74 72 65 22 2c 31 5d 5d 5d 2c 0d 0a 20 20 20 20  tre",1]]],..    
6c90: 50 52 49 4d 45 4d 5b 22 47 72 65 65 6e 77 69 63  PRIMEM["Greenwic
6ca0: 68 22 2c 30 2c 0d 0a 20 20 20 20 20 20 20 20 41  h",0,..        A
6cb0: 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 65  NGLEUNIT["degree
6cc0: 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 39  ",0.017453292519
6cd0: 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20 43 53 5b  9433]],..    CS[
6ce0: 65 6c 6c 69 70 73 6f 69 64 61 6c 2c 32 5d 2c 0d  ellipsoidal,2],.
6cf0: 0a 20 20 20 20 20 20 20 20 41 58 49 53 5b 22 67  .        AXIS["g
6d00: 65 6f 64 65 74 69 63 20 6c 61 74 69 74 75 64 65  eodetic latitude
6d10: 20 28 4c 61 74 29 22 2c 6e 6f 72 74 68 2c 0d 0a   (Lat)",north,..
6d20: 20 20 20 20 20 20 20 20 20 20 20 20 4f 52 44 45              ORDE
6d30: 52 5b 31 5d 2c 0d 0a 20 20 20 20 20 20 20 20 20  R[1],..         
6d40: 20 20 20 41 4e 47 4c 45 55 4e 49 54 5b 22 64 65     ANGLEUNIT["de
6d50: 67 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39  gree",0.01745329
6d60: 32 35 31 39 39 34 33 33 5d 5d 2c 0d 0a 20 20 20  25199433]],..   
6d70: 20 20 20 20 20 41 58 49 53 5b 22 67 65 6f 64 65       AXIS["geode
6d80: 74 69 63 20 6c 6f 6e 67 69 74 75 64 65 20 28 4c  tic longitude (L
6d90: 6f 6e 29 22 2c 65 61 73 74 2c 0d 0a 20 20 20 20  on)",east,..    
6da0: 20 20 20 20 20 20 20 20 4f 52 44 45 52 5b 32 5d          ORDER[2]
6db0: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 41  ,..            A
6dc0: 4e 47 4c 45 55 4e 49 54 5b 22 64 65 67 72 65 65  NGLEUNIT["degree
6dd0: 22 2c 30 2e 30 31 37 34 35 33 32 39 32 35 31 39  ",0.017453292519
6de0: 39 34 33 33 5d 5d 2c 0d 0a 20 20 20 20 41 52 45  9433]],..    ARE
6df0: 41 5b 22 57 6f 72 6c 64 22 5d 2c 0d 0a 20 20 20  A["World"],..   
6e00: 20 42 42 4f 58 5b 2d 39 30 2c 2d 31 38 30 2c 39   BBOX[-90,-180,9
6e10: 30 2c 31 38 30 5d 2c 0d 0a 20 20 20 20 49 44 5b  0,180],..    ID[
6e20: 22 45 50 53 47 22 2c 34 33 32 36 5d 5d 0d 0a 0d  "EPSG",4326]]...
6e30: 0a 53 45 4c 45 43 54 20 50 52 4f 4a 5f 41 73 57  .SELECT PROJ_AsW
6e40: 4b 54 28 27 45 50 53 47 27 2c 20 34 33 32 36 2c  KT('EPSG', 4326,
6e50: 20 27 45 53 52 49 27 2c 20 30 2c 20 30 29 3b 20   'ESRI', 0, 0); 
6e60: 2d 2d 20 45 53 52 49 20 73 74 79 6c 65 2c 20 6d  -- ESRI style, m
6e70: 6f 6e 6f 6c 69 74 68 69 63 20 6c 69 6e 65 0d 0a  onolithic line..
6e80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
6e90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a  --------------..
6ea0: 47 45 4f 47 43 53 5b 22 47 43 53 5f 57 47 53 5f  GEOGCS["GCS_WGS_
6eb0: 31 39 38 34 22 2c 44 41 54 55 4d 5b 22 44 5f 57  1984",DATUM["D_W
6ec0: 47 53 5f 31 39 38 34 22 2c 53 50 48 45 52 4f 49  GS_1984",SPHEROI
6ed0: 44 5b 22 57 47 53 5f 31 39 38 34 22 2c 36 33 37  D["WGS_1984",637
6ee0: 38 31 33 37 2e 30 2c 32 39 38 2e 32 35 37 32 32  8137.0,298.25722
6ef0: 33 35 36 33 5d 5d 2c 50 52 49 4d 45 4d 5b 22 47  3563]],PRIMEM["G
6f00: 72 65 65 6e 77 69 63 68 22 2c 30 2e 30 5d 2c 55  reenwich",0.0],U
6f10: 4e 49 54 5b 22 44 65 67 72 65 65 22 2c 30 2e 30  NIT["Degree",0.0
6f20: 31 37 34 35 33 32 39 32 35 31 39 39 34 33 33 5d  174532925199433]
6f30: 5d 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52 4f 4a  ]....SELECT PROJ
6f40: 5f 47 75 65 73 73 53 72 69 64 46 72 6f 6d 57 4b  _GuessSridFromWK
6f50: 54 28 27 47 45 4f 47 43 53 5b 22 47 43 53 5f 4d  T('GEOGCS["GCS_M
6f60: 6f 6e 74 65 5f 4d 61 72 69 6f 5f 52 6f 6d 65 22  onte_Mario_Rome"
6f70: 2c 44 41 54 55 4d 5b 22 44 5f 4d 6f 6e 74 65 5f  ,DATUM["D_Monte_
6f80: 4d 61 72 69 6f 22 2c 53 50 48 45 52 4f 49 44 5b  Mario",SPHEROID[
6f90: 22 49 6e 74 65 72 6e 61 74 69 6f 6e 61 6c 5f 31  "International_1
6fa0: 39 32 34 22 2c 36 33 37 38 33 38 38 2e 30 2c 32  924",6378388.0,2
6fb0: 39 37 2e 30 5d 5d 2c 50 52 49 4d 45 4d 5b 22 52  97.0]],PRIMEM["R
6fc0: 6f 6d 65 22 2c 31 32 2e 34 35 32 33 33 33 33 33  ome",12.45233333
6fd0: 33 33 33 33 33 5d 2c 55 4e 49 54 5b 22 44 65 67  33333],UNIT["Deg
6fe0: 72 65 65 22 2c 30 2e 30 31 37 34 35 33 32 39 32  ree",0.017453292
6ff0: 35 31 39 39 34 33 33 5d 5d 27 29 3b 20 0d 0a 2d  5199433]]'); ..-
7000: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
7010: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 34  -------------..4
7020: 38 30 36 0d 0a 0d 0a 53 45 4c 45 43 54 20 50 52  806....SELECT PR
7030: 4f 4a 5f 47 75 65 73 73 53 72 69 64 46 72 6f 6d  OJ_GuessSridFrom
7040: 53 48 50 28 27 2f 68 6f 6d 65 2f 73 61 6e 64 72  SHP('/home/sandr
7050: 6f 2f 74 75 73 63 61 6e 79 5f 73 68 70 2f 70 72  o/tuscany_shp/pr
7060: 6f 76 32 30 31 31 27 29 3b 20 2d 2d 20 72 65 6d  ov2011'); -- rem
7070: 65 6d 62 65 72 3a 20 72 65 71 75 69 72 65 73 20  ember: requires 
7080: 74 6f 20 65 78 70 6c 69 63 69 74 6c 79 20 73 65  to explicitly se
7090: 74 20 53 50 41 54 49 41 4c 49 54 45 5f 53 45 43  t SPATIALITE_SEC
70a0: 55 52 49 54 59 3d 72 65 6c 61 78 65 64 0d 0a 2d  URITY=relaxed..-
70b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
70c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 33  -------------..3
70d0: 30 30 33 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e  003..</verbatim>
70e0: 0d 0a 3c 62 72 3e 0d 0a 3c 68 72 3e 3c 62 72 3e  ..<br>..<hr><br>
70f0: 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70 61  ..<table cellspa
7100: 63 69 6e 67 3d 22 38 22 20 63 65 6c 6c 70 61 64  cing="8" cellpad
7110: 64 69 6e 67 3d 22 38 22 20 62 67 63 6f 6c 6f 72  ding="8" bgcolor
7120: 3d 22 23 66 66 65 30 65 39 22 20 77 69 64 74 68  ="#ffe0e9" width
7130: 3d 22 31 30 30 25 22 3e 0d 0a 3c 74 72 3e 3c 74  ="100%">..<tr><t
7140: 68 3e 0d 0a 3c 68 31 3e 49 6d 70 6f 72 74 61 6e  h>..<h1>Importan
7150: 74 20 6e 6f 74 69 63 65 20 66 6f 72 20 57 69 6e  t notice for Win
7160: 64 6f 77 73 20 75 73 65 72 73 3c 2f 68 31 3e 0d  dows users</h1>.
7170: 0a 3c 2f 74 68 3e 3c 2f 74 72 3e 0d 0a 3c 74 72  .</th></tr>..<tr
7180: 3e 3c 74 64 3e 0d 0a 3c 62 3e 50 52 4f 4a 2e 36  ><td>..<b>PROJ.6
7190: 3c 2f 62 3e 20 63 72 69 74 69 63 61 6c 6c 79 20  </b> critically 
71a0: 64 65 70 65 6e 64 73 20 6f 6e 20 69 74 73 20 6f  depends on its o
71b0: 77 6e 20 70 72 69 76 61 74 65 20 53 51 4c 69 74  wn private SQLit
71c0: 65 20 64 61 74 61 62 61 73 65 20 28 3c 62 3e 70  e database (<b>p
71d0: 72 6f 6a 2e 64 62 3c 2f 62 3e 29 20 63 6f 6e 74  roj.db</b>) cont
71e0: 61 69 6e 69 6e 67 20 61 6c 6c 20 72 65 6c 65 76  aining all relev
71f0: 61 6e 74 20 64 65 66 69 6e 69 74 69 6f 6e 73 20  ant definitions 
7200: 61 62 6f 75 74 20 45 6c 6c 69 70 73 6f 69 64 73  about Ellipsoids
7210: 2c 20 50 72 69 6d 65 20 4d 65 72 69 64 69 61 6e  , Prime Meridian
7220: 73 2c 20 43 52 53 65 73 2c 20 54 72 61 6e 73 66  s, CRSes, Transf
7230: 6f 72 6d 61 74 69 6f 6e 73 20 61 6e 64 20 61 6c  ormations and al
7240: 69 6b 65 2e 3c 62 72 3e 0d 0a 49 66 20 50 52 4f  ike.<br>..If PRO
7250: 4a 2e 36 20 69 73 20 75 6e 61 62 6c 65 20 74 6f  J.6 is unable to
7260: 20 63 6f 72 72 65 63 74 6c 79 20 65 73 74 61 62   correctly estab
7270: 6c 69 73 68 20 61 20 63 6f 6e 6e 65 63 74 69 6f  lish a connectio
7280: 6e 20 74 6f 20 74 68 69 73 20 64 61 74 61 62 61  n to this databa
7290: 73 65 20 69 74 20 77 69 6c 6c 20 62 65 20 73 65  se it will be se
72a0: 76 65 72 65 6c 79 20 6c 69 6d 69 74 65 64 20 61  verely limited a
72b0: 6e 64 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 61  nd will not be a
72c0: 62 6c 65 20 74 6f 20 63 6f 72 72 65 63 74 6c 79  ble to correctly
72d0: 20 62 65 68 61 76 65 20 61 73 20 65 78 70 65 63   behave as expec
72e0: 74 65 64 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 75  ted.<br><br>..<u
72f0: 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 3c 75 3e 3c 69  l>..<li><b><u><i
7300: 3e 53 68 6f 72 74 20 63 6f 6e 63 6c 75 73 69 6f  >Short conclusio
7310: 6e 3c 2f 69 3e 3c 2f 75 3e 3c 2f 62 3e 3a 20 69  n</i></u></b>: i
7320: 6e 73 74 61 6c 6c 69 6e 67 20 74 68 65 20 73 6f  nstalling the so
7330: 66 74 77 61 72 65 20 61 6c 6f 6e 65 20 69 73 20  ftware alone is 
7340: 6e 6f 74 20 65 6e 6f 75 67 68 2e 3c 62 72 3e 0d  not enough.<br>.
7350: 0a 54 68 65 20 50 52 4f 4a 2e 36 20 70 72 69 76  .The PROJ.6 priv
7360: 61 74 65 20 64 61 74 61 62 61 73 65 20 3c 62 3e  ate database <b>
7370: 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20 6d 75 73 74  proj.db</b> must
7380: 20 62 65 20 70 72 6f 70 65 72 6c 79 20 69 6e 73   be properly ins
7390: 74 61 6c 6c 65 64 20 61 73 20 77 65 6c 6c 2c 20  talled as well, 
73a0: 69 6e 20 6f 72 64 65 72 20 74 6f 20 65 6e 73 75  in order to ensu
73b0: 72 65 20 74 68 61 74 20 61 6e 79 74 68 69 6e 67  re that anything
73c0: 20 72 75 6e 73 20 73 6d 6f 6f 74 68 6c 79 2e 3c   runs smoothly.<
73d0: 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 0d  /li>..</ul><br>.
73e0: 0a 54 68 69 73 20 69 73 6e 27 74 20 75 73 75 61  .This isn't usua
73f0: 6c 6c 79 20 61 20 62 69 67 20 69 73 73 75 65 20  lly a big issue 
7400: 6f 6e 20 4c 69 6e 75 78 20 61 6e 64 20 55 6e 69  on Linux and Uni
7410: 78 2d 6c 69 6b 65 20 70 6c 61 74 66 6f 72 6d 73  x-like platforms
7420: 2c 20 77 68 65 72 65 20 61 20 72 61 74 69 6f 6e  , where a ration
7430: 61 6c 20 61 6e 64 20 76 65 72 79 20 63 6c 65 61  al and very clea
7440: 72 20 66 69 6c 65 73 79 73 74 65 6d 20 6c 61 79  r filesystem lay
7450: 6f 75 74 20 65 78 69 73 74 73 2e 3c 62 72 3e 0d  out exists.<br>.
7460: 0a 4f 6e 20 74 68 65 73 65 20 6f 70 65 72 61 74  .On these operat
7470: 69 6e 67 20 73 79 73 74 65 6d 73 20 74 68 65 20  ing systems the 
7480: 70 61 63 6b 61 67 65 20 6d 61 6e 61 67 65 72 20  package manager 
7490: 28 6f 72 20 3c 62 3e 6d 61 6b 65 20 69 6e 73 74  (or <b>make inst
74a0: 61 6c 6c 3c 2f 62 3e 29 20 77 69 6c 6c 20 61 75  all</b>) will au
74b0: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 74 61 6b 65  tomatically take
74c0: 20 63 61 72 65 20 74 6f 20 69 6e 73 74 61 6c 6c   care to install
74d0: 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20   <b>proj.db</b> 
74e0: 6f 6e 20 74 68 65 20 6d 6f 73 74 20 61 70 70 72  on the most appr
74f0: 6f 70 72 69 61 74 65 20 64 69 72 65 63 74 6f 72  opriate director
7500: 79 20 28 75 73 75 61 6c 6c 79 20 61 73 20 3c 62  y (usually as <b
7510: 3e 2f 75 73 72 2f 73 68 61 72 65 2f 70 72 6f 6a  >/usr/share/proj
7520: 2f 70 72 6f 6a 2e 64 62 3c 2f 62 3e 20 6f 72 20  /proj.db</b> or 
7530: 61 73 20 3c 62 3e 2f 75 73 72 2f 6c 6f 63 61 6c  as <b>/usr/local
7540: 2f 73 68 61 72 65 2f 70 72 6f 6a 2f 70 72 6f 6a  /share/proj/proj
7550: 2e 64 62 3c 2f 62 3e 29 20 61 6e 64 20 74 68 61  .db</b>) and tha
7560: 74 27 73 20 61 6c 6c 2e 3c 62 72 3e 3c 62 72 3e  t's all.<br><br>
7570: 0d 0a 54 68 69 6e 67 73 20 61 72 65 20 75 6e 68  ..Things are unh
7580: 61 70 70 69 6c 79 20 61 20 6c 69 74 74 6c 65 20  appily a little 
7590: 62 69 74 20 6d 6f 72 65 20 64 69 66 66 69 63 75  bit more difficu
75a0: 6c 74 73 20 6f 6e 20 57 69 6e 64 6f 77 73 20 70  lts on Windows p
75b0: 6c 61 74 66 6f 72 6d 73 2e 0d 0a 54 68 65 20 75  latforms...The u
75c0: 73 65 72 20 69 74 73 65 6c 66 20 69 73 20 72 65  ser itself is re
75d0: 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 70 72  sponsible for pr
75e0: 6f 70 65 72 6c 79 20 69 6e 73 74 61 6c 6c 69 6e  operly installin
75f0: 67 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e  g <b>proj.db</b>
7600: 0d 0a 53 6f 20 69 74 20 62 65 63 6f 6d 65 73 20  ..So it becomes 
7610: 63 72 69 74 69 63 61 6c 20 75 6e 64 65 72 73 74  critical underst
7620: 61 6e 64 69 6e 67 20 74 68 65 20 62 61 73 69 63  anding the basic
7630: 20 72 75 6c 65 73 20 61 64 6f 70 74 65 64 20 62   rules adopted b
7640: 79 20 3c 62 3e 6c 69 62 73 70 61 74 69 61 6c 69  y <b>libspatiali
7650: 74 65 3c 2f 62 3e 20 69 6e 20 6f 72 64 65 72 20  te</b> in order 
7660: 74 6f 20 70 72 6f 70 65 72 6c 79 20 6c 6f 63 61  to properly loca
7670: 74 65 20 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62  te <b>proj.db</b
7680: 3e 20 6f 6e 20 57 69 6e 64 6f 77 73 2e 0d 0a 3c  > on Windows...<
7690: 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c  /td></tr>..<tr><
76a0: 74 68 3e 0d 0a 3c 68 32 3e 57 68 65 72 65 20 70  th>..<h2>Where p
76b0: 72 6f 6a 2e 64 62 20 69 73 20 65 78 70 65 63 74  roj.db is expect
76c0: 65 64 20 74 6f 20 62 65 20 66 6f 75 6e 64 20 6f  ed to be found o
76d0: 6e 20 57 69 6e 64 6f 77 73 3c 2f 68 32 3e 0d 0a  n Windows</h2>..
76e0: 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e  </td></tr>..<tr>
76f0: 3c 74 64 3e 0d 0a 3c 6f 6c 3e 0d 0a 3c 6c 69 3e  <td>..<ol>..<li>
7700: 74 68 65 20 66 69 72 73 74 20 70 6c 61 63 65 20  the first place 
7710: 77 68 65 72 65 20 3c 62 3e 70 72 6f 6a 2e 64 62  where <b>proj.db
7720: 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 73 65 61  </b> will be sea
7730: 72 63 68 65 64 20 69 73 20 74 68 65 20 73 61 6d  rched is the sam
7740: 65 20 66 6f 6c 64 65 72 20 66 6f 72 6d 20 77 68  e folder form wh
7750: 65 72 65 20 74 68 65 20 3c 62 3e 45 58 45 3c 2f  ere the <b>EXE</
7760: 62 3e 20 62 69 6e 61 72 79 20 77 61 73 20 69 6e  b> binary was in
7770: 69 74 69 61 6c 6c 79 20 6c 6f 61 64 65 64 2e 3c  itially loaded.<
7780: 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 45 78 61 6d 70  br>..<i><u>Examp
7790: 6c 65 3c 2f 69 3e 3c 2f 75 3e 3a 20 61 73 73 75  le</i></u>: assu
77a0: 6d 69 6e 67 20 74 68 61 74 20 79 6f 75 20 61 72  ming that you ar
77b0: 65 20 63 75 72 72 65 6e 74 6c 79 20 65 78 65 63  e currently exec
77c0: 75 74 69 6e 67 20 3c 62 3e 43 3a 5c 6d 79 70 72  uting <b>C:\mypr
77d0: 6f 67 73 5c 73 70 61 74 69 61 6c 69 74 65 5c 62  ogs\spatialite\b
77e0: 69 6e 5c 73 70 61 74 69 61 6c 69 74 65 2e 65 78  in\spatialite.ex
77f0: 65 3c 2f 62 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69  e</b>..<ul>..<li
7800: 3e 74 68 65 6e 20 61 6e 20 61 74 74 65 6d 70 74  >then an attempt
7810: 20 77 69 6c 6c 20 62 65 20 6d 61 64 65 20 74 6f   will be made to
7820: 20 63 6f 6e 6e 65 63 74 20 3c 62 3e 43 3a 5c 6d   connect <b>C:\m
7830: 79 70 72 6f 67 73 5c 73 70 61 74 69 61 6c 69 74  yprogs\spatialit
7840: 65 5c 62 69 6e 5c 70 72 6f 6a 2e 64 62 3c 2f 62  e\bin\proj.db</b
7850: 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c  ></li>..</ul></l
7860: 69 3e 0d 0a 3c 6c 69 3e 61 20 73 65 63 6f 6e 64  i>..<li>a second
7870: 20 61 74 74 65 6d 70 74 20 77 69 6c 6c 20 62 65   attempt will be
7880: 20 6d 61 64 65 20 6f 6e 20 62 65 68 61 6c 66 20   made on behalf 
7890: 6f 66 20 74 68 65 20 3c 62 3e 50 75 62 6c 69 63  of the <b>Public
78a0: 3c 2f 62 3e 20 66 6f 6c 64 65 72 2e 3c 62 72 3e  </b> folder.<br>
78b0: 0d 0a 3c 69 3e 3c 75 3e 45 78 61 6d 70 6c 65 3c  ..<i><u>Example<
78c0: 2f 75 3e 3c 2f 69 3e 3a 20 61 6e 20 61 74 74 65  /u></i>: an atte
78d0: 6d 70 74 20 77 69 6c 6c 20 62 65 20 6d 61 64 65  mpt will be made
78e0: 20 74 6f 20 63 6f 6e 6e 65 63 74 20 3c 62 3e 43   to connect <b>C
78f0: 3a 5c 55 73 65 72 73 5c 50 75 62 6c 69 63 5c 73  :\Users\Public\s
7900: 70 61 74 69 61 6c 69 74 65 5c 70 72 6f 6a 5c 70  patialite\proj\p
7910: 72 6f 6a 2e 64 62 3c 2f 62 3e 3c 2f 6c 69 3e 0d  roj.db</b></li>.
7920: 0a 3c 6c 69 3e 61 20 74 68 69 72 64 20 28 61 6e  .<li>a third (an
7930: 64 20 6c 61 73 74 29 20 61 74 74 65 6d 70 74 20  d last) attempt 
7940: 77 69 6c 6c 20 62 65 20 6d 61 64 65 20 6f 6e 20  will be made on 
7950: 62 65 68 61 6c 66 20 6f 66 20 74 68 65 20 3c 62  behalf of the <b
7960: 3e 55 73 65 72 3c 2f 62 3e 20 66 6f 6c 64 65 72  >User</b> folder
7970: 2e 3c 62 72 3e 0d 0a 3c 69 3e 3c 75 3e 45 78 61  .<br>..<i><u>Exa
7980: 6d 70 6c 65 3c 2f 69 3e 3c 2f 75 3e 3a 20 61 6e  mple</i></u>: an
7990: 20 61 74 74 65 6d 70 74 20 77 69 6c 6c 20 62 65   attempt will be
79a0: 20 6d 61 64 65 20 74 6f 20 63 6f 6e 6e 65 63 74   made to connect
79b0: 20 3c 62 3e 43 3a 5c 55 73 65 72 73 5c 73 61 6e   <b>C:\Users\san
79c0: 64 72 6f 5c 73 70 61 74 69 61 6c 69 74 65 5c 70  dro\spatialite\p
79d0: 72 6f 6a 5c 70 72 6f 6a 2e 64 62 3c 2f 62 3e 3c  roj\proj.db</b><
79e0: 2f 6c 69 3e 0d 0a 3c 2f 6f 6c 3e 0d 0a 3c 68 33  /li>..</ol>..<h3
79f0: 3e 41 6e 20 75 73 65 66 75 6c 20 64 69 61 67 6e  >An useful diagn
7a00: 6f 73 74 69 63 20 63 68 65 63 6b 3c 2f 68 33 3e  ostic check</h3>
7a10: 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45  ..<verbatim>..SE
7a20: 4c 45 43 54 20 50 52 4f 4a 5f 47 65 74 44 61 74  LECT PROJ_GetDat
7a30: 61 62 61 73 65 50 61 74 68 28 29 3b 0d 0a 3c 2f  abasePath();..</
7a40: 76 65 72 62 61 74 69 6d 3e 0d 0a 3c 75 6c 3e 0d  verbatim>..<ul>.
7a50: 0a 3c 6c 69 3e 69 66 20 3c 62 3e 4e 55 4c 4c 3c  .<li>if <b>NULL<
7a60: 2f 62 3e 20 69 73 20 72 65 74 75 72 6e 65 64 2c  /b> is returned,
7a70: 20 74 68 65 6e 20 50 52 4f 4a 2e 36 20 69 73 20   then PROJ.6 is 
7a80: 64 65 66 69 6e 69 74 65 6c 79 20 75 6e 61 62 6c  definitely unabl
7a90: 65 20 74 6f 20 63 6f 6e 6e 65 63 74 20 74 6f 20  e to connect to 
7aa0: 69 74 73 20 6f 77 6e 20 70 72 69 76 61 74 65 20  its own private 
7ab0: 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 20  SQLite database 
7ac0: 3c 62 3e 70 72 6f 6a 2e 64 62 3c 2f 62 3e 3c 62  <b>proj.db</b><b
7ad0: 72 3e 0d 0a 59 6f 75 20 68 61 76 65 20 74 6f 20  r>..You have to 
7ae0: 63 61 72 65 66 75 6c 6c 79 20 76 65 72 69 66 69  carefully verifi
7af0: 79 20 74 68 61 74 20 69 74 27 73 20 72 65 61 6c  y that it's real
7b00: 6c 79 20 69 6e 73 74 61 6c 6c 65 64 20 6f 6e 20  ly installed on 
7b10: 6f 6e 65 20 6f 66 20 74 68 65 20 65 78 70 65 63  one of the expec
7b20: 74 65 64 20 73 74 61 6e 64 61 72 64 20 6c 6f 63  ted standard loc
7b30: 61 74 69 6f 6e 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c  ations.</li>..<l
7b40: 69 3e 6f 74 68 65 72 77 69 73 65 20 74 68 65 20  i>otherwise the 
7b50: 70 61 74 68 20 6c 65 61 64 69 6e 67 20 74 6f 20  path leading to 
7b60: 74 68 65 20 63 75 72 72 65 6e 74 6c 79 20 63 6f  the currently co
7b70: 6e 6e 65 63 74 65 64 20 3c 62 3e 70 72 6f 6a 2e  nnected <b>proj.
7b80: 64 62 3c 2f 62 3e 20 77 69 6c 6c 20 62 65 20 72  db</b> will be r
7b90: 65 74 75 72 6e 65 64 2e 3c 2f 6c 69 3e 0d 0a 3c  eturned.</li>..<
7ba0: 2f 75 6c 3e 3c 62 72 3e 0d 0a 3c 2f 74 64 3e 3c  /ul><br>..</td><
7bb0: 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62  /tr>..</table><b
7bc0: 72 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c 65 20 63  r><br>..<table c
7bd0: 65 6c 6c 73 70 61 63 69 6e 67 3d 22 38 22 20 63  ellspacing="8" c
7be0: 65 6c 6c 70 61 64 64 69 6e 67 3d 22 38 22 20 62  ellpadding="8" b
7bf0: 67 63 6f 6c 6f 72 3d 22 23 63 39 66 66 66 30 22  gcolor="#c9fff0"
7c00: 20 77 69 64 74 68 3d 22 31 30 30 25 22 3e 0d 0a   width="100%">..
7c10: 3c 74 72 3e 3c 74 68 3e 0d 0a 3c 68 32 3e 55 73  <tr><th>..<h2>Us
7c20: 69 6e 67 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d  ing the environm
7c30: 65 6e 74 20 76 61 72 69 61 62 6c 65 20 53 50 41  ent variable SPA
7c40: 54 49 41 4c 49 54 45 5f 50 52 4f 4a 5f 44 42 5f  TIALITE_PROJ_DB_
7c50: 50 41 54 48 3c 2f 68 32 3e 0d 0a 3c 2f 74 68 3e  PATH</h2>..</th>
7c60: 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 0d  </tr>..<tr><td>.
7c70: 0a 49 66 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d  .If the environm
7c80: 65 6e 74 20 76 61 72 69 61 62 6c 65 20 3c 62 3e  ent variable <b>
7c90: 53 50 41 54 49 41 4c 49 54 45 5f 50 52 4f 4a 5f  SPATIALITE_PROJ_
7ca0: 44 42 5f 50 41 54 48 3c 2f 62 3e 20 69 73 20 73  DB_PATH</b> is s
7cb0: 65 74 2c 20 74 68 65 6e 20 3c 62 3e 6c 69 62 73  et, then <b>libs
7cc0: 70 61 74 69 61 6c 69 74 65 3c 2f 62 3e 20 77 69  patialite</b> wi
7cd0: 6c 6c 20 73 69 6d 70 6c 79 20 61 74 74 65 6d 70  ll simply attemp
7ce0: 74 20 74 6f 20 63 6f 6e 6e 65 63 74 20 74 68 65  t to connect the
7cf0: 20 64 61 74 61 62 61 73 65 20 70 6f 69 6e 74 65   database pointe
7d00: 64 20 62 79 20 74 68 69 73 20 76 61 72 69 61 62  d by this variab
7d10: 6c 65 2e 3c 62 72 3e 0d 0a 53 75 63 68 20 61 20  le.<br>..Such a 
7d20: 63 61 70 61 62 69 6c 69 74 79 20 69 73 20 73 75  capability is su
7d30: 70 70 6f 72 74 65 64 20 6e 6f 74 20 6f 6e 6c 79  pported not only
7d40: 20 6f 6e 20 57 69 6e 64 6f 77 73 20 62 75 74 20   on Windows but 
7d50: 61 6c 73 6f 20 6f 6e 20 4c 69 6e 75 78 20 28 61  also on Linux (a
7d60: 6e 64 20 6f 6e 20 61 6e 79 20 6f 74 68 65 72 20  nd on any other 
7d70: 70 6c 61 74 66 6f 72 6d 29 2e 3c 62 72 3e 3c 62  platform).<br><b
7d80: 72 3e 0d 0a 3c 69 3e 3c 75 3e 4c 69 6e 75 78 20  r>..<i><u>Linux 
7d90: 65 78 61 6d 70 6c 65 3c 2f 75 3e 3c 2f 69 3e 3a  example</u></i>:
7da0: 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 65  ..<ul>..<li><b>e
7db0: 78 70 6f 72 74 20 22 53 50 41 54 49 41 4c 49 54  xport "SPATIALIT
7dc0: 45 5f 50 52 4f 4a 5f 44 42 5f 50 41 54 48 3d 2f  E_PROJ_DB_PATH=/
7dd0: 68 6f 6d 65 2f 73 61 6e 64 72 6f 2f 61 75 78 2f  home/sandro/aux/
7de0: 70 72 6f 6a 2e 64 62 22 3c 62 72 3e 0d 0a 65 63  proj.db"<br>..ec
7df0: 68 6f 20 24 53 50 41 54 49 41 4c 49 54 45 5f 50  ho $SPATIALITE_P
7e00: 52 4f 4a 5f 44 42 5f 50 41 54 48 3c 62 72 3e 0d  ROJ_DB_PATH<br>.
7e10: 0a 73 70 61 74 69 61 6c 69 74 65 3c 62 3e 3c 2f  .spatialite<b></
7e20: 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 62 72 3e 3c 62  li>..</ul><br><b
7e30: 72 3e 0d 0a 3c 69 3e 3c 75 3e 57 69 6e 64 6f 77  r>..<i><u>Window
7e40: 73 20 65 78 61 6d 70 6c 65 3c 2f 75 3e 3c 2f 69  s example</u></i
7e50: 3e 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62  >:..<ul>..<li><b
7e60: 3e 53 45 54 20 53 50 41 54 49 41 4c 49 54 45 5f  >SET SPATIALITE_
7e70: 50 52 4f 4a 5f 44 42 5f 50 41 54 48 3d 43 3a 5c  PROJ_DB_PATH=C:\
7e80: 55 73 65 72 73 5c 73 61 6e 64 72 6f 5c 61 75 78  Users\sandro\aux
7e90: 5c 70 72 6f 6a 2e 64 62 3c 62 72 3e 0d 0a 65 63  \proj.db<br>..ec
7ea0: 68 6f 20 25 53 50 41 54 49 41 4c 49 54 45 5f 50  ho %SPATIALITE_P
7eb0: 52 4f 4a 5f 44 42 5f 50 41 54 48 25 3c 62 72 3e  ROJ_DB_PATH%<br>
7ec0: 0d 0a 73 70 61 74 69 61 6c 69 74 65 5f 67 75 69  ..spatialite_gui
7ed0: 3c 62 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c  <b></li>..</ul><
7ee0: 62 72 3e 3c 62 72 3e 0d 0a 3c 2f 74 68 3e 3c 2f  br><br>..</th></
7ef0: 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72  tr>..</table><br
7f00: 3e 0d 0a 3c 68 72 3e 3c 62 72 3e 0d 0a 3c 61 20  >..<hr><br>..<a 
7f10: 68 72 65 66 3d 22 68 74 74 70 73 3a 2f 2f 77 77  href="https://ww
7f20: 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 2f 66 6f  w.gaia-gis.it/fo
7f30: 73 73 69 6c 2f 6c 69 62 73 70 61 74 69 61 6c 69  ssil/libspatiali
7f40: 74 65 2f 77 69 6b 69 3f 6e 61 6d 65 3d 34 2e 33  te/wiki?name=4.3
7f50: 2e 30 2d 64 6f 63 22 3e 62 61 63 6b 3c 2f 61 3e  .0-doc">back</a>
7f60: 0a 5a 20 31 63 61 61 32 65 36 39 64 39 66 33 64  .Z 1caa2e69d9f3d
7f70: 64 33 36 36 33 39 33 65 35 37 36 31 65 65 32 31  d366393e5761ee21
7f80: 61 66 62 0a                                      afb.