Hex Artifact Content
Not logged in

Artifact 90d3da933cfc23a5fe064797ed65a8ebb69c8dea:

Wiki page [spatialite-android-tutorial] by bradh 2012-12-09 21:51:21.
0000: 44 20 32 30 31 32 2d 31 32 2d 30 39 54 32 31 3a  D 2012-12-09T21:
0010: 35 31 3a 32 31 2e 34 32 33 0a 4c 20 73 70 61 74  51:21.423.L spat
0020: 69 61 6c 69 74 65 2d 61 6e 64 72 6f 69 64 2d 74  ialite-android-t
0030: 75 74 6f 72 69 61 6c 0a 50 20 63 36 39 32 38 38  utorial.P c69288
0040: 65 30 36 32 37 36 38 34 61 35 36 65 37 62 37 34  e0627684a56e7b74
0050: 66 34 65 64 31 32 65 30 63 37 31 65 64 64 39 33  f4ed12e0c71edd93
0060: 36 64 0a 55 20 62 72 61 64 68 0a 57 20 31 34 39  6d.U bradh.W 149
0070: 36 31 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 73 70  61.<table cellsp
0080: 61 63 69 6e 67 3d 22 31 30 22 20 63 65 6c 6c 70  acing="10" cellp
0090: 61 64 64 69 6e 67 3d 22 33 30 22 3e 3c 74 72 3e  adding="30"><tr>
00a0: 0d 0a 3c 74 64 20 77 69 64 74 68 3d 22 31 30 30  ..<td width="100
00b0: 25 22 3e 0d 0a 0d 0a 3c 68 31 3e 53 70 61 74 69  %">....<h1>Spati
00c0: 61 6c 69 74 65 20 6f 6e 20 41 6e 64 72 6f 69 64  alite on Android
00d0: 3a 20 61 20 71 75 69 63 6b 20 74 75 74 6f 72 69  : a quick tutori
00e0: 61 6c 3c 2f 68 31 3e 0d 0a 42 61 63 6b 20 74 6f  al</h1>..Back to
00f0: 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 73 3a   <a href="https:
0100: 2f 2f 77 77 77 2e 67 61 69 61 2d 67 69 73 2e 69  //www.gaia-gis.i
0110: 74 2f 66 6f 73 73 69 6c 2f 6c 69 62 73 70 61 74  t/fossil/libspat
0120: 69 61 6c 69 74 65 2f 77 69 6b 69 3f 6e 61 6d 65  ialite/wiki?name
0130: 3d 73 70 6c 69 74 65 2d 61 6e 64 72 6f 69 64 22  =splite-android"
0140: 3e 53 70 61 74 69 61 4c 69 74 65 2d 41 6e 64 72  >SpatiaLite-Andr
0150: 6f 69 64 3c 2f 61 3e 20 57 69 6b 69 20 70 61 67  oid</a> Wiki pag
0160: 65 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 74 61 62 6c  e<br><br>..<tabl
0170: 65 20 62 67 63 6f 6c 6f 72 3d 22 66 66 66 66 64  e bgcolor="ffffd
0180: 30 22 20 63 65 6c 6c 70 61 64 64 69 6e 64 3d 22  0" cellpaddind="
0190: 38 22 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22  8" cellspacing="
01a0: 38 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 69 6d  8">..<tr><td><im
01b0: 67 20 73 72 63 3d 22 68 74 74 70 3a 2f 2f 77 77  g src="http://ww
01c0: 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 2f 67 61  w.gaia-gis.it/ga
01d0: 69 61 2d 73 69 6e 73 2f 73 70 61 74 69 61 6c 69  ia-sins/spatiali
01e0: 74 65 2d 61 6e 64 72 6f 69 64 2f 73 70 6c 69 74  te-android/split
01f0: 65 2d 61 6e 64 72 6f 69 64 2e 70 6e 67 22 20 61  e-android.png" a
0200: 6c 74 3d 22 6c 6f 67 6f 22 3e 3c 2f 74 64 3e 0d  lt="logo"></td>.
0210: 0a 3c 74 64 3e 0d 0a 3c 62 3e 43 72 65 64 69 74  .<td>..<b>Credit
0220: 73 3c 2f 62 3e 3c 62 72 3e 3c 62 72 3e 0d 0a 54  s</b><br><br>..T
0230: 68 69 73 20 57 69 6b 69 20 70 61 67 65 20 68 61  his Wiki page ha
0240: 73 20 62 65 65 6e 20 6b 69 6e 64 6c 79 20 63 6f  s been kindly co
0250: 6e 74 72 69 62 75 74 65 64 20 62 79 20 3c 61 20  ntributed by <a 
0260: 68 72 65 66 3d 22 6d 61 69 6c 74 6f 3a 61 6e 64  href="mailto:and
0270: 72 65 61 2e 61 6e 74 6f 6e 65 6c 6c 6f 40 67 6d  rea.antonello@gm
0280: 61 69 6c 2e 63 6f 6d 22 3e 41 6e 64 72 65 61 20  ail.com">Andrea 
0290: 41 6e 74 6f 6e 65 6c 6c 6f 3c 2f 61 3e 2c 20 61  Antonello</a>, a
02a0: 20 73 6b 69 6c 6c 65 64 20 4a 61 76 61 20 64 65   skilled Java de
02b0: 76 6f 6c 6f 70 65 72 20 77 69 74 68 20 61 20 73  voloper with a s
02c0: 6f 75 6e 64 20 73 70 65 63 69 66 69 63 20 65 78  ound specific ex
02d0: 70 65 72 69 65 6e 63 65 20 6f 6e 20 41 6e 64 72  perience on Andr
02e0: 6f 69 64 2c 20 61 6e 64 20 61 63 74 69 76 65 6c  oid, and activel
02f0: 79 20 69 6e 76 6f 6c 76 65 64 20 69 6e 20 73 65  y involved in se
0300: 76 65 72 61 6c 20 47 46 4f 53 53 20 70 72 6f 6a  veral GFOSS proj
0310: 65 63 74 73 20 28 50 53 43 20 6d 65 6d 62 65 72  ects (PSC member
0320: 20 6f 66 20 3c 61 20 68 72 65 66 3d 22 68 74 74   of <a href="htt
0330: 70 3a 2f 2f 75 64 69 67 2e 72 65 66 72 61 63 74  p://udig.refract
0340: 69 6f 6e 73 2e 6e 65 74 2f 22 3e 75 44 69 67 3c  ions.net/">uDig<
0350: 2f 61 3e 20 61 6e 64 20 6d 61 69 6e 74 61 69 6e  /a> and maintain
0360: 65 72 20 6f 66 20 3c 61 20 68 72 65 66 3d 22 68  er of <a href="h
0370: 74 74 70 3a 2f 2f 63 6f 64 65 2e 67 6f 6f 67 6c  ttp://code.googl
0380: 65 2e 63 6f 6d 2f 70 2f 67 65 6f 70 61 70 61 72  e.com/p/geopapar
0390: 61 7a 7a 69 2f 22 3e 47 65 6f 50 61 70 61 72 61  azzi/">GeoPapara
03a0: 7a 7a 69 3c 2f 61 3e 29 2e 3c 62 72 3e 3c 62 72  zzi</a>).<br><br
03b0: 3e 0d 0a 4d 61 6e 79 20 74 68 61 6e 6b 73 20 74  >..Many thanks t
03c0: 6f 20 41 6e 64 72 65 61 20 66 6f 72 20 68 69 73  o Andrea for his
03d0: 20 74 68 6f 72 6f 75 67 68 20 64 6f 63 75 6d 65   thorough docume
03e0: 6e 74 61 74 69 6f 6e 20 65 66 66 6f 72 74 20 21  ntation effort !
03f0: 21 21 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a  !!..</td></tr>..
0400: 3c 2f 74 61 62 6c 65 3e 0d 0a 0d 0a 3c 68 32 3e  </table>....<h2>
0410: 49 6e 74 72 6f 64 75 63 74 69 6f 6e 3c 2f 68 32  Introduction</h2
0420: 3e 0d 0a 0d 0a 3c 70 3e 54 68 65 20 41 6e 64 72  >....<p>The Andr
0430: 6f 69 64 20 6f 70 65 72 61 74 69 6e 67 20 73 79  oid operating sy
0440: 73 74 65 6d 20 66 6f 72 20 6d 6f 62 69 6c 65 20  stem for mobile 
0450: 64 65 76 69 63 65 73 20 75 73 65 73 20 61 73 20  devices uses as 
0460: 69 74 73 20 64 65 66 61 75 6c 74 20 72 65 6c 61  its default rela
0470: 74 69 6f 6e 61 6c 20 64 61 74 61 62 61 73 65 20  tional database 
0480: 53 51 4c 69 74 65 2e 20 45 76 65 6e 20 69 66 20  SQLite. Even if 
0490: 73 69 6e 63 65 20 74 68 65 20 61 70 70 65 61 72  since the appear
04a0: 65 6e 63 65 20 6f 66 20 53 70 61 74 69 61 4c 69  ence of SpatiaLi
04b0: 74 65 20 69 6e 20 74 68 65 20 67 65 6f 73 70 61  te in the geospa
04c0: 74 69 61 6c 20 77 6f 72 6c 64 20 69 74 20 6c 6f  tial world it lo
04d0: 6f 6b 65 64 20 6c 69 6b 65 20 61 20 70 65 72 66  oked like a perf
04e0: 65 63 74 20 6d 61 74 63 68 20 74 6f 20 68 61 76  ect match to hav
04f0: 65 20 69 74 20 61 76 61 69 6c 61 62 6c 65 20 62  e it available b
0500: 79 20 64 65 66 61 75 6c 74 20 66 6f 72 20 74 68  y default for th
0510: 65 20 73 79 73 74 65 6d 2c 20 64 65 76 65 6c 6f  e system, develo
0520: 70 65 72 73 20 68 61 64 20 74 6f 20 77 61 69 74  pers had to wait
0530: 20 66 6f 72 20 61 20 77 68 69 6c 65 20 74 6f 20   for a while to 
0540: 75 73 65 20 73 70 61 74 69 61 6c 69 74 65 20 6f  use spatialite o
0550: 6e 20 41 6e 64 72 6f 69 64 2e 0d 0a 41 6e 64 20  n Android...And 
0560: 65 76 65 6e 20 6e 6f 77 2c 20 74 68 61 74 20 69  even now, that i
0570: 74 20 69 73 20 61 76 61 69 6c 61 62 6c 65 2c 20  t is available, 
0580: 69 74 20 69 73 20 6e 6f 74 20 69 6e 74 65 67 72  it is not integr
0590: 61 74 65 64 20 69 6e 20 74 68 65 20 6f 70 65 72  ated in the oper
05a0: 61 74 69 6e 67 20 73 79 73 74 65 6d 20 61 6e 64  ating system and
05b0: 20 69 74 20 69 73 20 6e 6f 74 20 61 63 63 65 73   it is not acces
05c0: 73 69 62 6c 65 20 74 68 72 6f 75 67 68 20 74 68  sible through th
05d0: 65 20 73 74 61 6e 64 61 72 64 20 41 6e 64 72 6f  e standard Andro
05e0: 69 64 20 70 65 72 73 69 73 74 65 6e 63 65 20 41  id persistence A
05f0: 50 49 73 2e 0d 0a 0d 0a 3c 70 3e 54 68 61 74 20  PIs.....<p>That 
0600: 73 68 6f 75 6c 64 20 6e 6f 74 20 73 63 61 72 65  should not scare
0610: 20 61 77 61 79 20 61 6e 79 20 64 65 76 65 6c 6f   away any develo
0620: 70 65 72 20 65 61 67 65 72 20 74 6f 20 70 6c 61  per eager to pla
0630: 79 20 72 65 61 6c 20 67 65 6f 73 70 61 74 69 61  y real geospatia
0640: 6c 20 6f 6e 20 41 6e 64 72 6f 69 64 20 64 65 76  l on Android dev
0650: 69 63 65 73 2e 20 54 68 65 20 3c 61 20 68 72 65  ices. The <a hre
0660: 66 3d 22 68 74 74 70 3a 2f 2f 63 6f 64 65 2e 67  f="http://code.g
0670: 6f 6f 67 6c 65 2e 63 6f 6d 2f 70 2f 73 70 61 74  oogle.com/p/spat
0680: 69 61 6c 69 74 65 2d 61 6e 64 72 6f 69 64 2f 22  ialite-android/"
0690: 3e 53 70 61 74 69 61 6c 69 74 65 2d 41 6e 64 72  >Spatialite-Andr
06a0: 6f 69 64 3c 2f 61 3e 20 70 72 6f 6a 65 63 74 20  oid</a> project 
06b0: 69 73 20 73 69 6d 70 6c 65 20 74 6f 20 75 73 65  is simple to use
06c0: 20 61 6e 64 20 73 74 61 62 6c 65 2e 20 0d 0a 0d   and stable. ...
06d0: 0a 3c 70 3e 49 6e 20 74 68 69 73 20 64 6f 63 75  .<p>In this docu
06e0: 6d 65 6e 74 20 77 65 20 77 69 6c 6c 20 68 65 6c  ment we will hel
06f0: 70 20 6e 65 77 20 64 65 76 65 6c 6f 70 65 72 73  p new developers
0700: 20 74 6f 20 67 65 74 20 73 74 61 72 74 65 64 20   to get started 
0710: 77 69 74 68 20 74 68 65 69 72 20 66 69 72 73 74  with their first
0720: 20 53 70 61 74 69 61 6c 69 74 65 20 65 6e 61 62   Spatialite enab
0730: 6c 65 64 20 61 70 70 6c 69 63 61 74 69 6f 6e 2e  led application.
0740: 20 49 74 20 69 73 20 6d 65 61 6e 74 20 66 6f 72   It is meant for
0750: 20 64 65 76 65 6c 6f 70 65 72 73 20 74 68 61 74   developers that
0760: 20 68 61 76 65 20 61 74 20 6c 65 61 73 74 20 61   have at least a
0770: 20 6d 69 6e 69 6d 61 6c 20 6b 6e 6f 77 6c 65 64   minimal knowled
0780: 67 65 20 61 62 6f 75 74 20 41 6e 64 72 6f 69 64  ge about Android
0790: 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 64 65 76   application dev
07a0: 65 6c 6f 70 6d 65 6e 74 20 28 68 61 76 69 6e 67  elopment (having
07b0: 20 62 75 69 6c 74 20 61 6e 64 20 72 75 6e 20 74   built and run t
07c0: 68 65 20 68 65 6c 6c 6f 20 77 6f 72 6c 64 20 61  he hello world a
07d0: 70 70 20 73 68 6f 75 6c 20 62 65 20 65 6e 6f 75  pp shoul be enou
07e0: 67 68 29 2e 0d 0a 0d 0a 3c 68 32 3e 41 75 74 68  gh).....<h2>Auth
07f0: 6f 72 73 20 61 6e 64 20 4c 69 63 65 6e 73 65 3c  ors and License<
0800: 2f 68 32 3e 0d 0a 0d 0a 3c 70 3e 54 68 65 20 53  /h2>....<p>The S
0810: 70 61 74 69 61 6c 69 74 65 2d 41 6e 64 72 6f 69  patialite-Androi
0820: 64 20 70 72 6f 6a 65 63 74 20 68 61 73 20 62 65  d project has be
0830: 65 6e 20 72 65 6c 65 61 73 65 64 20 62 79 20 74  en released by t
0840: 68 65 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70  he <a href="http
0850: 3a 2f 2f 77 77 77 2e 61 67 63 2e 61 72 6d 79 2e  ://www.agc.army.
0860: 6d 69 6c 22 3e 55 2e 53 2e 20 41 72 6d 79 20 47  mil">U.S. Army G
0870: 65 6f 73 70 61 74 69 61 6c 20 43 65 6e 74 65 72  eospatial Center
0880: 3c 2f 61 3e 2e 0d 0a 3c 70 3e 54 68 65 20 70 72  </a>...<p>The pr
0890: 6f 6a 65 63 74 20 69 73 20 72 65 6c 65 61 73 65  oject is release
08a0: 64 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 3a  d <a href="http:
08b0: 2f 2f 77 77 77 2e 67 61 69 61 2d 67 69 73 2e 69  //www.gaia-gis.i
08c0: 74 2f 67 61 69 61 2d 73 69 6e 73 2f 73 70 61 74  t/gaia-sins/spat
08d0: 69 61 6c 69 74 65 2d 61 6e 64 72 6f 69 64 2f 73  ialite-android/s
08e0: 70 61 74 69 61 6c 69 74 65 2d 61 6e 64 72 6f 69  patialite-androi
08f0: 64 2d 6c 69 63 65 6e 73 65 2e 74 78 74 22 3e 75  d-license.txt">u
0900: 6e 64 65 72 20 4c 47 50 4c 76 33 20 6c 69 63 65  nder LGPLv3 lice
0910: 6e 73 65 3c 2f 61 3e 2e 0d 0a 0d 0a 3c 68 32 3e  nse</a>.....<h2>
0920: 47 65 74 74 69 6e 67 20 73 74 61 72 74 65 64 3c  Getting started<
0930: 2f 68 32 3e 0d 0a 0d 0a 3c 70 3e 54 6f 20 67 65  /h2>....<p>To ge
0940: 74 20 73 74 61 72 74 65 64 20 77 65 20 6a 75 73  t started we jus
0950: 74 20 6e 65 65 64 20 74 6f 20 67 65 74 20 74 68  t need to get th
0960: 65 20 53 70 61 74 69 61 6c 69 74 65 20 6c 69 62  e Spatialite lib
0970: 72 61 72 69 65 73 20 61 6e 64 20 61 64 64 20 74  raries and add t
0980: 68 65 6d 20 74 6f 20 6f 75 72 20 6e 65 77 20 41  hem to our new A
0990: 6e 64 72 6f 69 64 20 61 70 70 6c 69 63 61 74 69  ndroid applicati
09a0: 6f 6e 20 70 72 6f 6a 65 63 74 2e 0d 0a 3c 70 3e  on project...<p>
09b0: 4f 6e 63 65 20 74 68 61 74 20 69 73 20 64 6f 6e  Once that is don
09c0: 65 2c 20 74 68 65 72 65 20 61 72 65 20 66 65 77  e, there are few
09d0: 20 73 74 65 70 73 20 74 6f 20 70 65 72 66 6f 72   steps to perfor
09e0: 6d 20 74 6f 20 67 65 74 20 74 68 69 6e 67 73 20  m to get things 
09f0: 77 6f 72 6b 69 6e 67 2e 20 54 68 65 20 41 50 49  working. The API
0a00: 20 69 73 20 76 65 72 79 20 73 6d 61 6c 6c 20 61   is very small a
0a10: 6e 64 20 73 69 6d 70 6c 65 20 61 6e 64 20 62 61  nd simple and ba
0a20: 73 69 63 61 6c 6c 79 20 62 61 73 65 73 20 6f 6e  sically bases on
0a30: 20 61 20 6d 61 6e 75 61 6c 20 62 75 69 6c 64 69   a manual buildi
0a40: 6e 67 20 6f 66 20 74 68 65 20 71 75 65 72 69 65  ng of the querie
0a50: 73 20 74 6f 20 73 65 6e 64 20 74 6f 20 74 68 65  s to send to the
0a60: 20 64 61 74 61 62 61 73 65 2e 0d 0a 3c 70 3e 4e   database...<p>N
0a70: 6f 74 65 20 74 68 61 74 20 69 74 20 77 6f 75 6c  ote that it woul
0a80: 64 20 62 65 20 70 6f 73 73 69 62 6c 65 20 74 6f  d be possible to
0a90: 20 63 72 65 61 74 65 20 61 6e 20 41 6e 64 72 6f   create an Andro
0aa0: 69 64 20 6c 69 62 72 61 72 79 20 74 6f 20 72 65  id library to re
0ab0: 66 65 72 65 6e 63 65 20 66 72 6f 6d 20 74 68 65  ference from the
0ac0: 20 70 72 6f 6a 65 63 74 2c 20 62 75 74 20 74 6f   project, but to
0ad0: 20 6b 65 65 70 20 74 68 69 73 20 74 75 74 6f 72   keep this tutor
0ae0: 69 61 6c 20 73 68 6f 72 74 2c 20 77 65 20 77 69  ial short, we wi
0af0: 6c 6c 20 6a 75 73 74 20 73 68 6f 77 20 68 6f 77  ll just show how
0b00: 20 74 6f 20 69 6e 74 65 67 72 61 74 65 20 74 68   to integrate th
0b10: 65 20 6c 69 62 72 61 72 79 20 64 69 72 65 63 74  e library direct
0b20: 6c 79 20 69 6e 74 6f 20 6f 75 72 20 6e 65 77 20  ly into our new 
0b30: 70 72 6f 6a 65 63 74 2e 0d 0a 0d 0a 3c 68 33 3e  project.....<h3>
0b40: 44 6f 77 6e 6c 6f 61 64 69 6e 67 20 74 68 65 20  Downloading the 
0b50: 6c 69 62 72 61 72 69 65 73 3c 2f 68 33 3e 0d 0a  libraries</h3>..
0b60: 0d 0a 3c 70 3e 54 68 65 79 20 63 61 6e 20 62 65  ..<p>They can be
0b70: 20 64 6f 77 6e 6c 6f 61 64 65 64 20 66 72 6f 6d   downloaded from
0b80: 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 3a 2f   <a href="http:/
0b90: 2f 77 77 77 2e 67 61 69 61 2d 67 69 73 2e 69 74  /www.gaia-gis.it
0ba0: 2f 67 61 69 61 2d 73 69 6e 73 2f 73 70 61 74 69  /gaia-sins/spati
0bb0: 61 6c 69 74 65 2d 61 6e 64 72 6f 69 64 2f 73 70  alite-android/sp
0bc0: 61 74 69 61 6c 69 74 65 2d 66 6f 72 2d 61 6e 64  atialite-for-and
0bd0: 72 6f 69 64 2d 33 2e 30 2e 31 2e 7a 69 70 22 3e  roid-3.0.1.zip">
0be0: 74 68 69 73 20 6c 69 6e 6b 3c 2f 61 3e 2e 0d 0a  this link</a>...
0bf0: 3c 70 3e 54 68 65 20 64 6f 77 6e 6c 6f 61 64 65  <p>The downloade
0c00: 64 20 61 72 63 68 69 76 65 20 63 6f 6e 74 61 69  d archive contai
0c10: 6e 73 20 32 20 62 61 73 69 63 20 63 6f 6d 70 6f  ns 2 basic compo
0c20: 6e 65 6e 74 73 20 6e 65 63 65 73 73 61 72 79 20  nents necessary 
0c30: 74 6f 20 65 6e 61 62 6c 65 20 79 6f 75 72 20 70  to enable your p
0c40: 72 6f 6a 65 63 74 20 74 6f 20 75 73 65 20 53 70  roject to use Sp
0c50: 61 74 69 61 6c 69 74 65 3a 0d 0a 3c 75 6c 3e 0d  atialite:..<ul>.
0c60: 0a 3c 6c 69 3e 3c 62 3e 74 68 65 20 6e 61 74 69  .<li><b>the nati
0c70: 76 65 20 73 70 61 74 69 61 6c 69 74 65 20 6c 69  ve spatialite li
0c80: 62 72 61 72 69 65 73 3c 2f 62 3e 3a 20 74 68 65  braries</b>: the
0c90: 79 20 61 72 65 20 70 6c 61 63 65 73 20 69 6e 20  y are places in 
0ca0: 61 20 66 6f 6c 64 65 72 20 6e 61 6d 65 64 20 3c  a folder named <
0cb0: 62 3e 6c 69 62 73 3c 2f 62 3e 3c 2f 6c 69 3e 20  b>libs</b></li> 
0cc0: 61 6e 64 20 63 6f 6e 74 61 69 6e 73 20 73 65 76  and contains sev
0cd0: 65 72 61 6c 20 66 6f 6c 64 65 72 73 20 66 6f 72  eral folders for
0ce0: 20 64 69 66 66 65 72 65 6e 74 20 70 6c 61 74 66   different platf
0cf0: 6f 72 6d 73 20 74 68 61 74 20 68 6f 6c 64 20 74  orms that hold t
0d00: 68 65 20 6d 61 69 6e 20 6c 69 62 72 61 72 79 2c  he main library,
0d10: 20 63 61 6c 6c 65 64 20 3c 62 3e 6c 69 62 73 70   called <b>libsp
0d20: 61 74 69 61 6c 69 74 65 2e 73 6f 3c 2f 62 3e 0d  atialite.so</b>.
0d30: 0a 3c 6c 69 3e 74 68 65 20 3c 62 3e 62 61 73 69  .<li>the <b>basi
0d40: 63 20 41 50 49 20 63 6c 61 73 73 65 73 3c 2f 62  c API classes</b
0d50: 3e 2c 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20  >, contained in 
0d60: 74 68 65 20 3c 62 3e 6a 73 71 6c 69 74 65 3c 2f  the <b>jsqlite</
0d70: 62 3e 20 70 61 63 6b 61 67 65 3c 2f 6c 69 3e 0d  b> package</li>.
0d80: 0a 3c 2f 75 6c 3e 0d 0a 0d 0a 3c 68 33 3e 59 6f  .</ul>....<h3>Yo
0d90: 75 72 20 66 69 72 73 74 20 53 70 61 74 69 61 6c  ur first Spatial
0da0: 69 74 65 20 65 6e 61 62 6c 65 64 20 70 72 6f 6a  ite enabled proj
0db0: 65 63 74 3c 2f 68 33 3e 0d 0a 0d 0a 3c 68 34 3e  ect</h3>....<h4>
0dc0: 50 72 65 70 61 72 65 20 61 20 64 61 74 61 73 65  Prepare a datase
0dd0: 74 3c 2f 68 34 3e 0d 0a 0d 0a 46 6f 6c 6c 6f 77  t</h4>....Follow
0de0: 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 3a 2f   <a href="http:/
0df0: 2f 77 77 77 2e 67 61 69 61 2d 67 69 73 2e 69 74  /www.gaia-gis.it
0e00: 2f 67 61 69 61 2d 73 69 6e 73 2f 73 70 61 74 69  /gaia-sins/spati
0e10: 61 6c 69 74 65 2d 63 6f 6f 6b 62 6f 6f 6b 2f 68  alite-cookbook/h
0e20: 74 6d 6c 2f 66 69 72 73 74 2d 64 62 2e 68 74 6d  tml/first-db.htm
0e30: 6c 22 3e 74 68 69 73 20 74 75 74 6f 72 69 61 6c  l">this tutorial
0e40: 3c 2f 61 3e 20 74 6f 20 63 72 65 61 74 65 20 61  </a> to create a
0e50: 20 73 70 61 74 69 61 6c 69 74 65 20 64 61 74 61   spatialite data
0e60: 62 61 73 65 20 74 68 61 74 20 63 6f 6e 74 61 69  base that contai
0e70: 6e 73 20 74 68 65 20 63 6f 6d 75 6e 69 5f 32 30  ns the comuni_20
0e80: 31 31 2e 73 68 70 20 28 66 69 6e 64 20 72 65 66  11.shp (find ref
0e90: 65 72 65 6e 63 65 73 20 74 6f 20 77 68 65 72 65  erences to where
0ea0: 20 74 6f 20 67 65 74 20 69 74 20 3c 61 20 68 72   to get it <a hr
0eb0: 65 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 67  ef="http://www.g
0ec0: 61 69 61 2d 67 69 73 2e 69 74 2f 67 61 69 61 2d  aia-gis.it/gaia-
0ed0: 73 69 6e 73 2f 73 70 61 74 69 61 6c 69 74 65 2d  sins/spatialite-
0ee0: 63 6f 6f 6b 62 6f 6f 6b 2f 68 74 6d 6c 2f 73 74  cookbook/html/st
0ef0: 61 72 74 2e 68 74 6d 6c 22 3e 68 65 72 65 3c 2f  art.html">here</
0f00: 61 3e 29 20 64 61 74 61 2e 20 43 6f 70 79 20 74  a>) data. Copy t
0f10: 68 65 20 63 72 65 61 74 65 64 20 64 61 74 61 62  he created datab
0f20: 61 73 65 20 6f 6e 20 74 68 65 20 6d 6f 62 69 6c  ase on the mobil
0f30: 65 20 64 65 76 69 63 65 27 73 20 65 78 74 65 72  e device's exter
0f40: 6e 61 6c 20 73 74 6f 72 61 67 65 20 63 61 72 64  nal storage card
0f50: 2e 0d 0a 0d 0a 3c 68 34 3e 43 72 65 61 74 65 20  .....<h4>Create 
0f60: 74 68 65 20 62 61 73 69 63 20 68 65 6c 6c 6f 20  the basic hello 
0f70: 77 6f 72 6c 64 20 70 72 6f 6a 65 63 74 3c 2f 68  world project</h
0f80: 34 3e 0d 0a 0d 0a 3c 70 3e 55 73 65 20 74 68 65  4>....<p>Use the
0f90: 20 41 6e 64 72 6f 69 64 20 65 63 6c 69 70 73 65   Android eclipse
0fa0: 20 6e 65 77 20 70 72 6f 6a 65 63 74 20 77 69 7a   new project wiz
0fb0: 61 72 64 20 74 6f 20 63 72 65 61 74 65 20 61 20  ard to create a 
0fc0: 62 61 73 69 63 20 68 65 6c 6c 6f 20 77 6f 72 6c  basic hello worl
0fd0: 64 20 65 78 61 6d 70 6c 65 20 66 6f 72 20 41 6e  d example for An
0fe0: 64 72 6f 69 64 2e 20 49 74 20 77 69 6c 6c 20 67  droid. It will g
0ff0: 65 6e 65 72 61 74 65 20 79 6f 75 20 61 20 72 65  enerate you a re
1000: 61 64 79 20 74 6f 20 75 73 65 20 41 6e 64 72 6f  ady to use Andro
1010: 69 64 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 74  id application t
1020: 68 61 74 20 73 68 6f 77 73 20 61 20 6e 69 63 65  hat shows a nice
1030: 20 56 69 65 77 20 77 69 74 68 20 3c 69 3e 48 65   View with <i>He
1040: 6c 6c 6f 20 57 6f 72 6c 64 3c 2f 69 3e 20 6f 6e  llo World</i> on
1050: 20 69 74 2e 0d 0a 0d 0a 3c 70 3e 4f 6e 63 65 20   it.....<p>Once 
1060: 74 68 65 20 68 65 6c 6c 6f 20 77 6f 72 6c 64 20  the hello world 
1070: 70 72 6f 6a 65 63 74 20 63 61 6e 20 62 65 20 72  project can be r
1080: 75 6e 2c 20 77 65 20 63 61 6e 20 73 74 61 72 74  un, we can start
1090: 20 74 6f 20 61 64 64 20 74 68 65 20 73 70 61 74   to add the spat
10a0: 69 61 6c 69 74 65 20 70 61 72 74 2e 0d 0a 0d 0a  ialite part.....
10b0: 3c 70 3e 54 68 65 20 66 69 72 73 74 20 73 74 65  <p>The first ste
10c0: 70 20 69 73 20 74 6f 20 63 6f 70 79 20 74 68 65  p is to copy the
10d0: 20 6d 61 69 6e 20 63 6f 6d 70 6f 6e 65 6e 74 73   main components
10e0: 20 6f 66 20 74 68 65 20 53 70 61 74 69 61 6c 69   of the Spatiali
10f0: 74 65 2d 41 6e 64 72 6f 69 64 20 70 72 6f 6a 65  te-Android proje
1100: 63 74 20 61 73 20 6d 65 6e 74 69 6f 6e 65 64 20  ct as mentioned 
1110: 62 65 66 6f 72 65 2e 0d 0a 0d 0a 3c 75 6c 3e 0d  before.....<ul>.
1120: 0a 3c 6c 69 3e 63 6f 70 79 20 74 68 65 20 6e 61  .<li>copy the na
1130: 74 69 76 65 20 6c 69 62 73 20 69 6e 74 6f 20 74  tive libs into t
1140: 68 65 20 72 6f 6f 74 20 6f 66 20 74 68 65 20 6e  he root of the n
1150: 65 77 6c 79 20 63 72 65 61 74 65 64 20 41 6e 64  ewly created And
1160: 72 6f 69 64 20 70 72 6f 6a 65 63 74 3c 2f 6c 69  roid project</li
1170: 3e 0d 0a 3c 6c 69 3e 63 6f 70 79 20 74 68 65 20  >..<li>copy the 
1180: 6a 61 76 61 20 70 61 63 6b 61 67 65 20 6f 66 20  java package of 
1190: 74 68 65 20 62 61 73 65 20 41 50 49 20 69 6e 74  the base API int
11a0: 6f 20 79 6f 75 20 6e 65 77 20 70 72 6f 6a 65 63  o you new projec
11b0: 74 27 73 20 73 6f 75 72 63 65 20 66 6f 6c 64 65  t's source folde
11c0: 72 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 0d  r</li>..</ul>...
11d0: 0a 3c 70 3e 41 6e 64 20 74 68 61 74 20 69 73 20  .<p>And that is 
11e0: 69 74 2e 20 59 6f 75 72 20 70 72 6f 6a 65 63 74  it. Your project
11f0: 20 69 73 20 61 6c 72 65 61 64 79 20 53 70 61 74   is already Spat
1200: 69 61 6c 69 74 65 20 65 6e 61 62 6c 65 64 2e 0d  ialite enabled..
1210: 0a 4c 65 74 27 73 20 64 6f 20 73 6f 6d 65 20 62  .Let's do some b
1220: 61 73 69 63 20 73 74 75 66 66 20 77 69 74 68 20  asic stuff with 
1230: 69 74 20 69 6e 20 74 68 65 20 6e 65 78 74 20 63  it in the next c
1240: 68 61 70 74 65 72 73 2e 0d 0a 0d 0a 3c 68 34 3e  hapters.....<h4>
1250: 4f 70 65 6e 20 61 6e 20 64 61 74 61 62 61 73 65  Open an database
1260: 3c 2f 68 34 3e 0d 0a 0d 0a 3c 70 3e 54 68 65 20  </h4>....<p>The 
1270: 66 6f 6c 6c 6f 77 69 6e 67 20 77 69 6c 6c 20 6f  following will o
1280: 70 65 6e 20 74 68 65 20 64 61 74 61 62 61 73 65  pen the database
1290: 20 6e 61 6d 65 64 20 3c 69 3e 69 74 61 6c 79 2e   named <i>italy.
12a0: 73 71 6c 69 74 65 3c 2f 69 3e 20 74 68 61 74 20  sqlite</i> that 
12b0: 69 73 20 70 6c 61 63 65 64 20 69 6e 20 79 6f 75  is placed in you
12c0: 72 20 73 64 63 61 72 64 2e 20 49 66 20 74 68 65  r sdcard. If the
12d0: 20 64 61 74 61 62 61 73 65 20 64 6f 65 73 6e 27   database doesn'
12e0: 74 20 65 78 69 73 74 2c 20 69 74 20 77 69 6c 6c  t exist, it will
12f0: 20 62 65 20 63 72 65 61 74 65 64 20 65 6d 70 74   be created empt
1300: 79 20 28 64 75 65 20 74 6f 20 74 68 65 20 53 51  y (due to the SQ
1310: 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45  LITE_OPEN_CREATE
1320: 20 66 6c 61 67 29 2e 0d 0a 0d 0a 3c 76 65 72 62   flag).....<verb
1330: 61 74 69 6d 3e 0d 0a 20 20 20 20 20 20 20 20 74  atim>..        t
1340: 72 79 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20  ry {..          
1350: 20 20 46 69 6c 65 20 73 64 63 61 72 64 44 69 72    File sdcardDir
1360: 20 3d 20 22 22 3b 20 2f 2f 20 79 6f 75 72 20 73   = ""; // your s
1370: 64 63 61 72 64 20 70 61 74 68 0d 0a 20 20 20 20  dcard path..    
1380: 20 20 20 20 20 20 20 20 46 69 6c 65 20 73 70 61          File spa
1390: 74 69 61 6c 44 62 46 69 6c 65 20 3d 20 6e 65 77  tialDbFile = new
13a0: 20 46 69 6c 65 28 73 64 63 61 72 64 44 69 72 2c   File(sdcardDir,
13b0: 20 22 69 74 61 6c 79 2e 73 71 6c 69 74 65 22 29   "italy.sqlite")
13c0: 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20  ;....           
13d0: 20 64 62 20 3d 20 6e 65 77 20 6a 73 71 6c 69 74   db = new jsqlit
13e0: 65 2e 44 61 74 61 62 61 73 65 28 29 3b 0d 0a 20  e.Database();.. 
13f0: 20 20 20 20 20 20 20 20 20 20 20 64 62 2e 6f 70             db.op
1400: 65 6e 28 73 70 61 74 69 61 6c 44 62 46 69 6c 65  en(spatialDbFile
1410: 2e 67 65 74 41 62 73 6f 6c 75 74 65 50 61 74 68  .getAbsolutePath
1420: 28 29 2c 20 6a 73 71 6c 69 74 65 2e 43 6f 6e 73  (), jsqlite.Cons
1430: 74 61 6e 74 73 2e 53 51 4c 49 54 45 5f 4f 50 45  tants.SQLITE_OPE
1440: 4e 5f 52 45 41 44 57 52 49 54 45 0d 0a 20 20 20  N_READWRITE..   
1450: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1460: 20 7c 20 6a 73 71 6c 69 74 65 2e 43 6f 6e 73 74   | jsqlite.Const
1470: 61 6e 74 73 2e 53 51 4c 49 54 45 5f 4f 50 45 4e  ants.SQLITE_OPEN
1480: 5f 43 52 45 41 54 45 29 3b 0d 0a 20 20 20 20 20  _CREATE);..     
1490: 20 20 20 7d 20 63 61 74 63 68 20 28 45 78 63 65     } catch (Exce
14a0: 70 74 69 6f 6e 20 65 29 20 7b 0d 0a 20 20 20 20  ption e) {..    
14b0: 20 20 20 20 20 20 20 20 65 2e 70 72 69 6e 74 53          e.printS
14c0: 74 61 63 6b 54 72 61 63 65 28 29 3b 0d 0a 20 20  tackTrace();..  
14d0: 20 20 20 20 20 20 7d 0d 0a 3c 2f 76 65 72 62 61        }..</verba
14e0: 74 69 6d 3e 0d 0a 0d 0a 4f 6e 63 65 20 79 6f 75  tim>....Once you
14f0: 20 68 61 76 65 20 6f 70 65 6e 65 64 20 74 68 65   have opened the
1500: 20 64 61 74 61 62 61 73 65 2c 20 79 6f 75 20 61   database, you a
1510: 72 65 20 72 65 61 64 79 20 74 6f 20 64 6f 20 73  re ready to do s
1520: 6f 6d 65 20 73 70 61 74 69 61 6c 20 6d 61 67 69  ome spatial magi
1530: 63 2e 0d 0a 0d 0a 3c 68 34 3e 47 65 74 20 76 65  c.....<h4>Get ve
1540: 72 73 69 6f 6e 73 20 6f 66 20 74 68 65 20 73 6f  rsions of the so
1550: 66 74 77 61 72 65 3c 2f 68 34 3e 0d 0a 0d 0a 54  ftware</h4>....T
1560: 6f 20 67 65 74 20 74 68 65 20 76 65 72 73 69 6f  o get the versio
1570: 6e 73 20 6f 66 20 73 70 61 74 69 61 6c 69 74 65  ns of spatialite
1580: 2c 20 67 65 6f 73 20 61 6e 64 20 70 72 6f 6a 20  , geos and proj 
1590: 74 68 61 74 20 61 72 65 20 69 6e 20 75 73 65 2c  that are in use,
15a0: 20 79 6f 75 20 63 61 6e 20 75 73 65 20 74 68 65   you can use the
15b0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 65 74 68 6f   following metho
15c0: 64 3a 0d 0a 0d 0a 3c 76 65 72 62 61 74 69 6d 3e  d:....<verbatim>
15d0: 0d 0a 20 20 20 20 70 75 62 6c 69 63 20 53 74 72  ..    public Str
15e0: 69 6e 67 20 71 75 65 72 79 56 65 72 73 69 6f 6e  ing queryVersion
15f0: 73 28 29 20 74 68 72 6f 77 73 20 45 78 63 65 70  s() throws Excep
1600: 74 69 6f 6e 20 7b 0d 0a 20 20 20 20 20 20 20 20  tion {..        
1610: 53 74 72 69 6e 67 42 75 69 6c 64 65 72 20 73 62  StringBuilder sb
1620: 20 3d 20 6e 65 77 20 53 74 72 69 6e 67 42 75 69   = new StringBui
1630: 6c 64 65 72 28 29 3b 0d 0a 20 20 20 20 20 20 20  lder();..       
1640: 20 73 62 2e 61 70 70 65 6e 64 28 22 43 68 65 63   sb.append("Chec
1650: 6b 20 76 65 72 73 69 6f 6e 73 2e 2e 2e 5c 6e 22  k versions...\n"
1660: 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 53 74  );....        St
1670: 6d 74 20 73 74 6d 74 30 31 20 3d 20 64 62 2e 70  mt stmt01 = db.p
1680: 72 65 70 61 72 65 28 22 53 45 4c 45 43 54 20 73  repare("SELECT s
1690: 70 61 74 69 61 6c 69 74 65 5f 76 65 72 73 69 6f  patialite_versio
16a0: 6e 28 29 3b 22 29 3b 0d 0a 20 20 20 20 20 20 20  n();");..       
16b0: 20 69 66 20 28 73 74 6d 74 30 31 2e 73 74 65 70   if (stmt01.step
16c0: 28 29 29 20 7b 0d 0a 20 20 20 20 20 20 20 20 20  ()) {..         
16d0: 20 20 20 73 62 2e 61 70 70 65 6e 64 28 22 5c 74     sb.append("\t
16e0: 22 29 2e 61 70 70 65 6e 64 28 22 53 50 41 54 49  ").append("SPATI
16f0: 41 4c 49 54 45 5f 56 45 52 53 49 4f 4e 3a 20 22  ALITE_VERSION: "
1700: 20 2b 20 73 74 6d 74 30 31 2e 63 6f 6c 75 6d 6e   + stmt01.column
1710: 5f 73 74 72 69 6e 67 28 30 29 29 3b 0d 0a 20 20  _string(0));..  
1720: 20 20 20 20 20 20 20 20 20 20 73 62 2e 61 70 70            sb.app
1730: 65 6e 64 28 22 5c 6e 22 29 3b 0d 0a 20 20 20 20  end("\n");..    
1740: 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20      }....       
1750: 20 73 74 6d 74 30 31 20 3d 20 64 62 2e 70 72 65   stmt01 = db.pre
1760: 70 61 72 65 28 22 53 45 4c 45 43 54 20 70 72 6f  pare("SELECT pro
1770: 6a 34 5f 76 65 72 73 69 6f 6e 28 29 3b 22 29 3b  j4_version();");
1780: 0d 0a 20 20 20 20 20 20 20 20 69 66 20 28 73 74  ..        if (st
1790: 6d 74 30 31 2e 73 74 65 70 28 29 29 20 7b 0d 0a  mt01.step()) {..
17a0: 20 20 20 20 20 20 20 20 20 20 20 20 73 62 2e 61              sb.a
17b0: 70 70 65 6e 64 28 22 5c 74 22 29 2e 61 70 70 65  ppend("\t").appe
17c0: 6e 64 28 22 50 52 4f 4a 34 5f 56 45 52 53 49 4f  nd("PROJ4_VERSIO
17d0: 4e 3a 20 22 20 2b 20 73 74 6d 74 30 31 2e 63 6f  N: " + stmt01.co
17e0: 6c 75 6d 6e 5f 73 74 72 69 6e 67 28 30 29 29 3b  lumn_string(0));
17f0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 62  ..            sb
1800: 2e 61 70 70 65 6e 64 28 22 5c 6e 22 29 3b 0d 0a  .append("\n");..
1810: 20 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20          }....   
1820: 20 20 20 20 20 73 74 6d 74 30 31 20 3d 20 64 62       stmt01 = db
1830: 2e 70 72 65 70 61 72 65 28 22 53 45 4c 45 43 54  .prepare("SELECT
1840: 20 67 65 6f 73 5f 76 65 72 73 69 6f 6e 28 29 3b   geos_version();
1850: 22 29 3b 0d 0a 20 20 20 20 20 20 20 20 69 66 20  ");..        if 
1860: 28 73 74 6d 74 30 31 2e 73 74 65 70 28 29 29 20  (stmt01.step()) 
1870: 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 73  {..            s
1880: 62 2e 61 70 70 65 6e 64 28 22 5c 74 22 29 2e 61  b.append("\t").a
1890: 70 70 65 6e 64 28 22 47 45 4f 53 5f 56 45 52 53  ppend("GEOS_VERS
18a0: 49 4f 4e 3a 20 22 20 2b 20 73 74 6d 74 30 31 2e  ION: " + stmt01.
18b0: 63 6f 6c 75 6d 6e 5f 73 74 72 69 6e 67 28 30 29  column_string(0)
18c0: 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20  );..            
18d0: 73 62 2e 61 70 70 65 6e 64 28 22 5c 6e 22 29 3b  sb.append("\n");
18e0: 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20  ..        }..   
18f0: 20 20 20 20 20 73 74 6d 74 30 31 2e 63 6c 6f 73       stmt01.clos
1900: 65 28 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20  e();....        
1910: 73 62 2e 61 70 70 65 6e 64 28 22 44 6f 6e 65 2e  sb.append("Done.
1920: 2e 2e 5c 6e 22 29 3b 0d 0a 20 20 20 20 20 20 20  ..\n");..       
1930: 20 72 65 74 75 72 6e 20 73 62 2e 74 6f 53 74 72   return sb.toStr
1940: 69 6e 67 28 29 3b 0d 0a 20 20 20 20 7d 0d 0a 3c  ing();..    }..<
1950: 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 0d 0a 0d 0a  /verbatim>......
1960: 3c 68 34 3e 43 68 65 63 6b 20 70 6c 61 69 6e 20  <h4>Check plain 
1970: 73 71 6c 69 74 65 20 71 75 65 72 69 65 73 3c 2f  sqlite queries</
1980: 68 34 3e 0d 0a 0d 0a 54 6f 20 73 65 65 20 69 66  h4>....To see if
1990: 20 69 74 20 61 6c 6c 20 77 6f 72 6b 73 2c 20 77   it all works, w
19a0: 65 20 63 61 6e 20 64 6f 20 61 20 70 6c 61 69 6e  e can do a plain
19b0: 20 73 71 6c 69 74 65 20 71 75 65 72 79 20 61 6e   sqlite query an
19c0: 64 20 73 65 65 20 69 66 20 77 65 20 68 61 76 65  d see if we have
19d0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 65   the database se
19e0: 74 75 70 20 77 69 74 68 20 74 68 65 20 64 61 74  tup with the dat
19f0: 61 2e 0d 0a 41 73 73 75 6d 69 6e 67 20 79 6f 75  a...Assuming you
1a00: 20 69 6d 70 6f 72 74 65 64 20 74 68 65 20 73 68   imported the sh
1a10: 61 70 66 69 6c 65 20 43 6f 6d 75 6e 69 5f 32 30  apfile Comuni_20
1a20: 31 31 20 69 6e 74 6f 20 61 20 74 61 62 6c 65 20  11 into a table 
1a30: 6e 61 6d 65 64 20 43 6f 6d 75 6e 69 5f 31 31 2c  named Comuni_11,
1a40: 20 77 68 69 63 68 20 68 61 73 20 61 20 66 69 65   which has a fie
1a50: 6c 64 20 63 61 6c 6c 65 64 20 4e 4f 4d 45 2c 20  ld called NOME, 
1a60: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 67 69  the following gi
1a70: 76 65 73 20 79 6f 75 20 74 68 65 20 66 69 72 73  ves you the firs
1a80: 74 20 35 20 65 6e 74 72 69 65 73 3a 0d 0a 0d 0a  t 5 entries:....
1a90: 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 20 20 20 20  <verbatim>..    
1aa0: 70 75 62 6c 69 63 20 53 74 72 69 6e 67 20 71 75  public String qu
1ab0: 65 72 79 43 6f 6d 75 6e 69 28 29 20 7b 0d 0a 20  eryComuni() {.. 
1ac0: 20 20 20 20 20 20 20 73 62 2e 61 70 70 65 6e 64         sb.append
1ad0: 28 22 51 75 65 72 79 20 43 6f 6d 75 6e 69 2e 2e  ("Query Comuni..
1ae0: 2e 5c 6e 22 29 3b 0d 0a 0d 0a 20 20 20 20 20 20  .\n");....      
1af0: 20 20 53 74 72 69 6e 67 20 71 75 65 72 79 20 3d    String query =
1b00: 20 22 53 45 4c 45 43 54 20 4e 4f 4d 45 22 20 2b   "SELECT NOME" +
1b10: 20 2f 2f 0d 0a 20 20 20 20 20 20 20 20 20 20 20   //..           
1b20: 20 20 20 20 20 22 20 66 72 6f 6d 20 43 6f 6d 75       " from Comu
1b30: 6e 69 5f 31 31 22 20 2b 20 2f 2f 0d 0a 20 20 20  ni_11" + //..   
1b40: 20 20 20 20 20 20 20 20 20 20 20 20 20 22 20 6f               " o
1b50: 72 64 65 72 20 62 79 20 4e 4f 4d 45 3b 22 3b 0d  rder by NOME;";.
1b60: 0a 20 20 20 20 20 20 20 20 73 62 2e 61 70 70 65  .        sb.appe
1b70: 6e 64 28 22 45 78 65 63 75 74 65 20 71 75 65 72  nd("Execute quer
1b80: 79 3a 20 22 29 2e 61 70 70 65 6e 64 28 71 75 65  y: ").append(que
1b90: 72 79 29 2e 61 70 70 65 6e 64 28 22 5c 6e 22 29  ry).append("\n")
1ba0: 3b 0d 0a 20 20 20 20 20 20 20 20 74 72 79 20 7b  ;..        try {
1bb0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 53 74  ..            St
1bc0: 6d 74 20 73 74 6d 74 20 3d 20 64 62 2e 70 72 65  mt stmt = db.pre
1bd0: 70 61 72 65 28 71 75 65 72 79 29 3b 0d 0a 20 20  pare(query);..  
1be0: 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 69 6e            int in
1bf0: 64 65 78 20 3d 20 30 3b 0d 0a 20 20 20 20 20 20  dex = 0;..      
1c00: 20 20 20 20 20 20 77 68 69 6c 65 28 20 73 74 6d        while( stm
1c10: 74 2e 73 74 65 70 28 29 20 29 20 7b 0d 0a 20 20  t.step() ) {..  
1c20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 74                St
1c30: 72 69 6e 67 20 6e 6f 6d 65 53 74 72 20 3d 20 73  ring nomeStr = s
1c40: 74 6d 74 2e 63 6f 6c 75 6d 6e 5f 73 74 72 69 6e  tmt.column_strin
1c50: 67 28 30 29 3b 0d 0a 20 20 20 20 20 20 20 20 20  g(0);..         
1c60: 20 20 20 20 20 20 20 73 62 2e 61 70 70 65 6e 64         sb.append
1c70: 28 22 5c 74 22 29 2e 61 70 70 65 6e 64 28 6e 6f  ("\t").append(no
1c80: 6d 65 53 74 72 29 2e 61 70 70 65 6e 64 28 22 5c  meStr).append("\
1c90: 6e 22 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20  n");..          
1ca0: 20 20 20 20 20 20 69 66 20 28 69 6e 64 65 78 2b        if (index+
1cb0: 2b 20 3e 20 35 29 20 7b 0d 0a 20 20 20 20 20 20  + > 5) {..      
1cc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72                br
1cd0: 65 61 6b 3b 0d 0a 20 20 20 20 20 20 20 20 20 20  eak;..          
1ce0: 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20        }..       
1cf0: 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20       }..        
1d00: 20 20 20 20 73 62 2e 61 70 70 65 6e 64 28 22 5c      sb.append("\
1d10: 74 2e 2e 2e 22 29 3b 0d 0a 20 20 20 20 20 20 20  t...");..       
1d20: 20 20 20 20 20 73 74 6d 74 2e 63 6c 6f 73 65 28       stmt.close(
1d30: 29 3b 0d 0a 20 20 20 20 20 20 20 20 7d 20 63 61  );..        } ca
1d40: 74 63 68 20 28 45 78 63 65 70 74 69 6f 6e 20 65  tch (Exception e
1d50: 29 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20  ) {..           
1d60: 20 65 72 72 6f 72 28 65 29 3b 0d 0a 20 20 20 20   error(e);..    
1d70: 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20      }....       
1d80: 20 73 62 2e 61 70 70 65 6e 64 28 22 44 6f 6e 65   sb.append("Done
1d90: 2e 2e 2e 5c 6e 22 29 3b 0d 0a 0d 0a 20 20 20 20  ...\n");....    
1da0: 20 20 20 20 72 65 74 75 72 6e 20 73 62 2e 74 6f      return sb.to
1db0: 53 74 72 69 6e 67 28 29 3b 0d 0a 20 20 20 20 7d  String();..    }
1dc0: 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 0d  ..</verbatim>...
1dd0: 0a 3c 68 34 3e 59 6f 75 72 20 66 69 72 73 74 20  .<h4>Your first 
1de0: 73 70 61 74 69 61 6c 20 71 75 65 72 79 3c 2f 68  spatial query</h
1df0: 34 3e 0d 0a 0d 0a 4c 65 74 27 73 20 66 69 6e 61  4>....Let's fina
1e00: 6c 6c 79 20 71 75 65 72 79 20 66 6f 72 20 74 68  lly query for th
1e10: 65 20 67 65 6f 6d 65 74 72 69 65 73 2c 20 69 66  e geometries, if
1e20: 20 74 68 65 72 65 20 61 72 65 20 61 6e 79 2e 20   there are any. 
1e30: 54 68 65 20 72 65 73 75 6c 74 69 6e 67 20 57 4b  The resulting WK
1e40: 54 20 66 6f 72 6d 61 74 20 6f 66 20 74 68 65 20  T format of the 
1e50: 67 65 6f 6d 65 74 72 69 65 73 20 69 73 20 73 68  geometries is sh
1e60: 6f 72 74 65 6e 65 64 20 69 6e 20 6f 72 64 65 72  ortened in order
1e70: 20 74 6f 20 62 65 20 70 72 69 6e 74 65 64 3a 0d   to be printed:.
1e80: 0a 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 20  ...<verbatim>.. 
1e90: 20 20 20 70 75 62 6c 69 63 20 53 74 72 69 6e 67     public String
1ea0: 20 71 75 65 72 79 43 6f 6d 75 6e 69 57 69 74 68   queryComuniWith
1eb0: 47 65 6f 6d 28 29 20 7b 0d 0a 20 20 20 20 20 20  Geom() {..      
1ec0: 20 20 73 62 2e 61 70 70 65 6e 64 28 53 45 50 29    sb.append(SEP)
1ed0: 3b 0d 0a 20 20 20 20 20 20 20 20 73 62 2e 61 70  ;..        sb.ap
1ee0: 70 65 6e 64 28 22 51 75 65 72 79 20 43 6f 6d 75  pend("Query Comu
1ef0: 6e 69 20 77 69 74 68 20 41 73 54 65 78 74 28 47  ni with AsText(G
1f00: 65 6f 6d 65 74 72 79 29 2e 2e 2e 5c 6e 22 29 3b  eometry)...\n");
1f10: 0d 0a 0d 0a 20 20 20 20 20 20 20 20 53 74 72 69  ....        Stri
1f20: 6e 67 20 71 75 65 72 79 20 3d 20 22 53 45 4c 45  ng query = "SELE
1f30: 43 54 20 4e 4f 4d 45 22 20 2b 20 2f 2f 0d 0a 20  CT NOME" + //.. 
1f40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22                 "
1f50: 20 2c 20 41 73 54 65 78 74 28 47 65 6f 6d 65 74   , AsText(Geomet
1f60: 72 79 29 22 20 2b 20 2f 2f 0d 0a 20 20 20 20 20  ry)" + //..     
1f70: 20 20 20 20 20 20 20 20 20 20 20 22 20 61 73 20             " as 
1f80: 67 65 6f 6d 20 66 72 6f 6d 20 43 6f 6d 75 6e 69  geom from Comuni
1f90: 5f 31 31 22 20 2b 20 20 2f 2f 0d 0a 20 20 20 20  _11" +  //..    
1fa0: 20 20 20 20 20 20 20 20 20 20 20 20 22 20 77 68              " wh
1fb0: 65 72 65 20 67 65 6f 6d 20 6e 6f 74 20 6e 75 6c  ere geom not nul
1fc0: 6c 3b 22 3b 0d 0a 20 20 20 20 20 20 20 20 73 62  l;";..        sb
1fd0: 2e 61 70 70 65 6e 64 28 22 45 78 65 63 75 74 65  .append("Execute
1fe0: 20 71 75 65 72 79 3a 20 22 29 2e 61 70 70 65 6e   query: ").appen
1ff0: 64 28 71 75 65 72 79 29 2e 61 70 70 65 6e 64 28  d(query).append(
2000: 22 5c 6e 22 29 3b 0d 0a 20 20 20 20 20 20 20 20  "\n");..        
2010: 74 72 79 20 7b 0d 0a 20 20 20 20 20 20 20 20 20  try {..         
2020: 20 20 20 53 74 6d 74 20 73 74 6d 74 20 3d 20 64     Stmt stmt = d
2030: 62 2e 70 72 65 70 61 72 65 28 71 75 65 72 79 29  b.prepare(query)
2040: 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 77  ;..            w
2050: 68 69 6c 65 28 20 73 74 6d 74 2e 73 74 65 70 28  hile( stmt.step(
2060: 29 20 29 20 7b 0d 0a 20 20 20 20 20 20 20 20 20  ) ) {..         
2070: 20 20 20 20 20 20 20 53 74 72 69 6e 67 20 6e 6f         String no
2080: 6d 65 53 74 72 20 3d 20 73 74 6d 74 2e 63 6f 6c  meStr = stmt.col
2090: 75 6d 6e 5f 73 74 72 69 6e 67 28 30 29 3b 0d 0a  umn_string(0);..
20a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
20b0: 53 74 72 69 6e 67 20 67 65 6f 6d 53 74 72 20 3d  String geomStr =
20c0: 20 73 74 6d 74 2e 63 6f 6c 75 6d 6e 5f 73 74 72   stmt.column_str
20d0: 69 6e 67 28 31 29 3b 0d 0a 20 20 20 20 20 20 20  ing(1);..       
20e0: 20 20 20 20 20 20 20 20 20 53 74 72 69 6e 67 20           String 
20f0: 73 75 62 73 74 72 69 6e 67 20 3d 20 67 65 6f 6d  substring = geom
2100: 53 74 72 3b 0d 0a 20 20 20 20 20 20 20 20 20 20  Str;..          
2110: 20 20 20 20 20 20 69 66 20 28 73 75 62 73 74 72        if (substr
2120: 69 6e 67 2e 6c 65 6e 67 74 68 28 29 20 3e 20 34  ing.length() > 4
2130: 30 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20  0)..            
2140: 20 20 20 20 20 20 20 20 73 75 62 73 74 72 69 6e          substrin
2150: 67 20 3d 20 67 65 6f 6d 53 74 72 2e 73 75 62 73  g = geomStr.subs
2160: 74 72 69 6e 67 28 30 2c 20 34 30 29 3b 0d 0a 20  tring(0, 40);.. 
2170: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73                 s
2180: 62 2e 61 70 70 65 6e 64 28 22 5c 74 22 29 2e 61  b.append("\t").a
2190: 70 70 65 6e 64 28 6e 6f 6d 65 53 74 72 29 2e 61  ppend(nomeStr).a
21a0: 70 70 65 6e 64 28 22 20 2d 20 22 29 2e 61 70 70  ppend(" - ").app
21b0: 65 6e 64 28 73 75 62 73 74 72 69 6e 67 29 2e 61  end(substring).a
21c0: 70 70 65 6e 64 28 22 2e 2e 2e 5c 6e 22 29 3b 0d  ppend("...\n");.
21d0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
21e0: 20 62 72 65 61 6b 3b 0d 0a 20 20 20 20 20 20 20   break;..       
21f0: 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20       }..        
2200: 20 20 20 20 73 74 6d 74 2e 63 6c 6f 73 65 28 29      stmt.close()
2210: 3b 0d 0a 20 20 20 20 20 20 20 20 7d 20 63 61 74  ;..        } cat
2220: 63 68 20 28 45 78 63 65 70 74 69 6f 6e 20 65 29  ch (Exception e)
2230: 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20   {..            
2240: 65 2e 70 72 69 6e 74 53 74 61 63 6b 54 72 61 63  e.printStackTrac
2250: 65 28 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20  e();..          
2260: 20 20 73 62 2e 61 70 70 65 6e 64 28 45 52 52 4f    sb.append(ERRO
2270: 52 29 2e 61 70 70 65 6e 64 28 65 2e 67 65 74 4c  R).append(e.getL
2280: 6f 63 61 6c 69 7a 65 64 4d 65 73 73 61 67 65 28  ocalizedMessage(
2290: 29 29 2e 61 70 70 65 6e 64 28 22 5c 6e 22 29 3b  )).append("\n");
22a0: 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20  ..        }..   
22b0: 20 20 20 20 20 73 62 2e 61 70 70 65 6e 64 28 22       sb.append("
22c0: 44 6f 6e 65 2e 2e 2e 5c 6e 22 29 3b 0d 0a 0d 0a  Done...\n");....
22d0: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 73          return s
22e0: 62 2e 74 6f 53 74 72 69 6e 67 28 29 3b 0d 0a 20  b.toString();.. 
22f0: 20 20 20 7d 0d 0a 3c 2f 76 65 72 62 61 74 69 6d     }..</verbatim
2300: 3e 0d 0a 0d 0a 3c 68 34 3e 47 65 74 20 74 68 65  >....<h4>Get the
2310: 20 61 72 65 61 20 6f 66 20 61 20 70 6f 6c 79 67   area of a polyg
2320: 6f 6e 3c 2f 68 34 3e 0d 0a 0d 0a 54 68 65 20 3c  on</h4>....The <
2330: 69 3e 53 54 5f 41 72 65 61 3c 2f 69 3e 20 66 75  i>ST_Area</i> fu
2340: 6e 63 74 69 6f 6e 20 69 73 20 61 76 61 69 6c 61  nction is availa
2350: 62 6c 65 20 74 6f 20 67 65 74 20 74 68 65 20 61  ble to get the a
2360: 72 65 61 20 66 72 6f 6d 20 61 20 67 65 6f 6d 65  rea from a geome
2370: 74 72 79 3a 0d 0a 0d 0a 3c 76 65 72 62 61 74 69  try:....<verbati
2380: 6d 3e 0d 0a 20 20 20 20 70 75 62 6c 69 63 20 53  m>..    public S
2390: 74 72 69 6e 67 20 71 75 65 72 79 43 6f 6d 75 6e  tring queryComun
23a0: 69 41 72 65 61 28 29 20 7b 0d 0a 20 20 20 20 20  iArea() {..     
23b0: 20 20 20 73 62 2e 61 70 70 65 6e 64 28 53 45 50     sb.append(SEP
23c0: 29 3b 0d 0a 20 20 20 20 20 20 20 20 73 62 2e 61  );..        sb.a
23d0: 70 70 65 6e 64 28 22 51 75 65 72 79 20 43 6f 6d  ppend("Query Com
23e0: 75 6e 69 20 61 72 65 61 20 73 75 6d 2e 2e 2e 5c  uni area sum...\
23f0: 6e 22 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20  n");....        
2400: 53 74 72 69 6e 67 20 71 75 65 72 79 20 3d 20 22  String query = "
2410: 53 45 4c 45 43 54 20 53 54 5f 41 72 65 61 28 47  SELECT ST_Area(G
2420: 65 6f 6d 65 74 72 79 29 20 2f 20 31 30 30 30 30  eometry) / 10000
2430: 30 30 2e 30 20 66 72 6f 6d 20 43 6f 6d 75 6e 69  00.0 from Comuni
2440: 5f 31 31 22 20 2b 20 20 2f 2f 0d 0a 20 20 20 20  _11" +  //..    
2450: 20 20 20 20 20 20 20 20 20 20 20 20 22 3b 22 3b              ";";
2460: 0d 0a 20 20 20 20 20 20 20 20 73 62 2e 61 70 70  ..        sb.app
2470: 65 6e 64 28 22 45 78 65 63 75 74 65 20 71 75 65  end("Execute que
2480: 72 79 3a 20 22 29 2e 61 70 70 65 6e 64 28 71 75  ry: ").append(qu
2490: 65 72 79 29 2e 61 70 70 65 6e 64 28 22 5c 6e 22  ery).append("\n"
24a0: 29 3b 0d 0a 20 20 20 20 20 20 20 20 74 72 79 20  );..        try 
24b0: 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 53  {..            S
24c0: 74 6d 74 20 73 74 6d 74 20 3d 20 64 62 2e 70 72  tmt stmt = db.pr
24d0: 65 70 61 72 65 28 71 75 65 72 79 29 3b 0d 0a 20  epare(query);.. 
24e0: 20 20 20 20 20 20 20 20 20 20 20 64 6f 75 62 6c             doubl
24f0: 65 20 74 6f 74 61 6c 41 72 65 61 20 3d 20 30 3b  e totalArea = 0;
2500: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 77 68  ..            wh
2510: 69 6c 65 28 20 73 74 6d 74 2e 73 74 65 70 28 29  ile( stmt.step()
2520: 20 29 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20   ) {..          
2530: 20 20 20 20 20 20 64 6f 75 62 6c 65 20 61 72 65        double are
2540: 61 20 3d 20 73 74 6d 74 2e 63 6f 6c 75 6d 6e 5f  a = stmt.column_
2550: 64 6f 75 62 6c 65 28 30 29 3b 0d 0a 20 20 20 20  double(0);..    
2560: 20 20 20 20 20 20 20 20 20 20 20 20 74 6f 74 61              tota
2570: 6c 41 72 65 61 20 3d 20 74 6f 74 61 6c 41 72 65  lArea = totalAre
2580: 61 20 2b 20 61 72 65 61 3b 0d 0a 20 20 20 20 20  a + area;..     
2590: 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20         }..      
25a0: 20 20 20 20 20 20 73 62 2e 61 70 70 65 6e 64 28        sb.append(
25b0: 22 5c 74 54 6f 74 61 6c 20 61 72 65 61 20 62 79  "\tTotal area by
25c0: 20 73 75 6d 6d 69 6e 67 20 65 61 63 68 20 61 72   summing each ar
25d0: 65 61 3a 20 22 29 2e 61 70 70 65 6e 64 28 74 6f  ea: ").append(to
25e0: 74 61 6c 41 72 65 61 29 2e 61 70 70 65 6e 64 28  talArea).append(
25f0: 22 4b 6d 32 5c 6e 22 29 3b 0d 0a 20 20 20 20 20  "Km2\n");..     
2600: 20 20 20 20 20 20 20 73 74 6d 74 2e 63 6c 6f 73         stmt.clos
2610: 65 28 29 3b 0d 0a 20 20 20 20 20 20 20 20 7d 20  e();..        } 
2620: 63 61 74 63 68 20 28 45 78 63 65 70 74 69 6f 6e  catch (Exception
2630: 20 65 29 20 7b 0d 0a 20 20 20 20 20 20 20 20 20   e) {..         
2640: 20 20 20 65 2e 70 72 69 6e 74 53 74 61 63 6b 54     e.printStackT
2650: 72 61 63 65 28 29 3b 0d 0a 20 20 20 20 20 20 20  race();..       
2660: 20 20 20 20 20 73 62 2e 61 70 70 65 6e 64 28 45       sb.append(E
2670: 52 52 4f 52 29 2e 61 70 70 65 6e 64 28 65 2e 67  RROR).append(e.g
2680: 65 74 4c 6f 63 61 6c 69 7a 65 64 4d 65 73 73 61  etLocalizedMessa
2690: 67 65 28 29 29 2e 61 70 70 65 6e 64 28 22 5c 6e  ge()).append("\n
26a0: 22 29 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a  ");..        }..
26b0: 20 20 20 20 20 20 20 20 73 62 2e 61 70 70 65 6e          sb.appen
26c0: 64 28 22 44 6f 6e 65 2e 2e 2e 5c 6e 22 29 3b 0d  d("Done...\n");.
26d0: 0a 0d 0a 20 20 20 20 20 20 20 20 72 65 74 75 72  ...        retur
26e0: 6e 20 73 62 2e 74 6f 53 74 72 69 6e 67 28 29 3b  n sb.toString();
26f0: 0d 0a 20 20 20 20 7d 0d 0a 3c 2f 76 65 72 62 61  ..    }..</verba
2700: 74 69 6d 3e 0d 0a 0d 0a 4f 62 76 69 6f 75 73 6c  tim>....Obviousl
2710: 79 20 79 6f 75 20 63 6f 75 6c 64 20 61 6c 73 6f  y you could also
2720: 20 64 6f 20 74 68 65 20 73 75 6d 20 64 69 72 65   do the sum dire
2730: 63 74 6c 79 20 69 6e 73 69 64 65 20 74 68 65 20  ctly inside the 
2740: 71 75 65 72 79 2e 0d 0a 0d 0a 3c 68 34 3e 53 69  query.....<h4>Si
2750: 6d 70 6c 65 20 63 6f 6f 72 64 69 6e 61 74 65 20  mple coordinate 
2760: 74 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 3c 2f  transformation</
2770: 68 34 3e 0d 0a 0d 0a 59 6f 75 20 63 61 6e 20 61  h4>....You can a
2780: 6c 73 6f 20 64 6f 20 73 6f 6d 65 20 63 6f 6f 72  lso do some coor
2790: 64 69 6e 61 74 65 20 74 72 61 6e 73 66 6f 72 6d  dinate transform
27a0: 61 74 69 6f 6e 2e 20 54 72 79 20 77 69 74 68 3a  ation. Try with:
27b0: 0d 0a 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a  ....<verbatim>..
27c0: 20 20 20 20 70 75 62 6c 69 63 20 53 74 72 69 6e      public Strin
27d0: 67 20 64 6f 53 69 6d 70 6c 65 54 72 61 6e 73 66  g doSimpleTransf
27e0: 6f 72 6d 28 29 20 7b 0d 0a 0d 0a 0d 0a 20 20 20  orm() {......   
27f0: 20 20 20 20 20 73 62 2e 61 70 70 65 6e 64 28 22       sb.append("
2800: 43 6f 6f 72 64 69 6e 61 74 65 20 74 72 61 6e 73  Coordinate trans
2810: 66 6f 72 6d 61 74 69 6f 6e 2e 2e 2e 5c 6e 22 29  formation...\n")
2820: 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 53 74 72  ;....        Str
2830: 69 6e 67 20 71 75 65 72 79 20 3d 20 22 53 45 4c  ing query = "SEL
2840: 45 43 54 20 41 73 54 65 78 74 28 54 72 61 6e 73  ECT AsText(Trans
2850: 66 6f 72 6d 28 4d 61 6b 65 50 6f 69 6e 74 28 22  form(MakePoint("
2860: 20 2b 20 54 45 53 54 5f 4c 4f 4e 20 2b 20 22 2c   + TEST_LON + ",
2870: 20 22 20 2b 20 54 45 53 54 5f 4c 41 54 20 2b 20   " + TEST_LAT + 
2880: 22 2c 20 34 33 32 36 29 2c 20 33 32 36 33 32 29  ", 4326), 32632)
2890: 29 3b 22 3b 0d 0a 20 20 20 20 20 20 20 20 73 62  );";..        sb
28a0: 2e 61 70 70 65 6e 64 28 22 45 78 65 63 75 74 65  .append("Execute
28b0: 20 71 75 65 72 79 3a 20 22 29 2e 61 70 70 65 6e   query: ").appen
28c0: 64 28 71 75 65 72 79 29 2e 61 70 70 65 6e 64 28  d(query).append(
28d0: 22 5c 6e 22 29 3b 0d 0a 20 20 20 20 20 20 20 20  "\n");..        
28e0: 74 72 79 20 7b 0d 0a 20 20 20 20 20 20 20 20 20  try {..         
28f0: 20 20 20 53 74 6d 74 20 73 74 6d 74 20 3d 20 64     Stmt stmt = d
2900: 62 2e 70 72 65 70 61 72 65 28 71 75 65 72 79 29  b.prepare(query)
2910: 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69  ;..            i
2920: 66 20 28 73 74 6d 74 2e 73 74 65 70 28 29 29 20  f (stmt.step()) 
2930: 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  {..             
2940: 20 20 20 53 74 72 69 6e 67 20 70 6f 69 6e 74 53     String pointS
2950: 74 72 20 3d 20 73 74 6d 74 2e 63 6f 6c 75 6d 6e  tr = stmt.column
2960: 5f 73 74 72 69 6e 67 28 30 29 3b 0d 0a 20 20 20  _string(0);..   
2970: 20 20 20 20 20 20 20 20 20 20 20 20 20 73 62 2e               sb.
2980: 61 70 70 65 6e 64 28 22 5c 74 22 29 2e 61 70 70  append("\t").app
2990: 65 6e 64 28 54 45 53 54 5f 4c 4f 4e 20 2b 20 22  end(TEST_LON + "
29a0: 2f 22 20 2b 20 54 45 53 54 5f 4c 41 54 20 2b 20  /" + TEST_LAT + 
29b0: 22 2f 45 50 53 47 3a 34 33 32 36 22 29 2e 61 70  "/EPSG:4326").ap
29c0: 70 65 6e 64 28 22 20 3d 20 22 29 2f 2f 0d 0a 20  pend(" = ")//.. 
29d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
29e0: 20 20 20 20 20 20 20 2e 61 70 70 65 6e 64 28 70         .append(p
29f0: 6f 69 6e 74 53 74 72 20 2b 20 22 2f 45 50 53 47  ointStr + "/EPSG
2a00: 3a 33 32 36 33 32 22 29 2e 61 70 70 65 6e 64 28  :32632").append(
2a10: 22 2e 2e 2e 5c 6e 22 29 3b 0d 0a 20 20 20 20 20  "...\n");..     
2a20: 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20         }..      
2a30: 20 20 20 20 20 20 73 74 6d 74 2e 63 6c 6f 73 65        stmt.close
2a40: 28 29 3b 0d 0a 20 20 20 20 20 20 20 20 7d 20 63  ();..        } c
2a50: 61 74 63 68 20 28 45 78 63 65 70 74 69 6f 6e 20  atch (Exception 
2a60: 65 29 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20  e) {..          
2a70: 20 20 65 2e 70 72 69 6e 74 53 74 61 63 6b 54 72    e.printStackTr
2a80: 61 63 65 28 29 3b 0d 0a 20 20 20 20 20 20 20 20  ace();..        
2a90: 20 20 20 20 73 62 2e 61 70 70 65 6e 64 28 45 52      sb.append(ER
2aa0: 52 4f 52 29 2e 61 70 70 65 6e 64 28 65 2e 67 65  ROR).append(e.ge
2ab0: 74 4c 6f 63 61 6c 69 7a 65 64 4d 65 73 73 61 67  tLocalizedMessag
2ac0: 65 28 29 29 2e 61 70 70 65 6e 64 28 22 5c 6e 22  e()).append("\n"
2ad0: 29 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20  );..        }.. 
2ae0: 20 20 20 20 20 20 20 73 62 2e 61 70 70 65 6e 64         sb.append
2af0: 28 22 44 6f 6e 65 2e 2e 2e 5c 6e 22 29 3b 0d 0a  ("Done...\n");..
2b00: 0d 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e  ..        return
2b10: 20 73 62 2e 74 6f 53 74 72 69 6e 67 28 29 3b 0d   sb.toString();.
2b20: 0a 0d 0a 20 20 20 20 7d 0d 0a 3c 2f 76 65 72 62  ...    }..</verb
2b30: 61 74 69 6d 3e 0d 0a 0d 0a 73 65 74 74 69 6e 67  atim>....setting
2b40: 20 54 45 53 54 5f 4c 4f 4e 20 20 61 6e 64 20 54   TEST_LON  and T
2b50: 45 53 54 5f 4c 41 54 20 74 6f 20 74 68 65 20 63  EST_LAT to the c
2b60: 6f 6f 72 64 69 6e 61 74 65 73 20 74 6f 20 74 72  oordinates to tr
2b70: 61 6e 73 66 6f 72 6d 2c 20 69 6e 20 74 68 65 20  ansform, in the 
2b80: 61 62 6f 76 65 20 63 61 73 65 20 66 72 6f 6d 20  above case from 
2b90: 53 52 49 44 20 34 33 32 36 20 74 6f 20 33 32 36  SRID 4326 to 326
2ba0: 33 32 2e 0d 0a 0d 0a 3c 68 34 3e 41 20 6d 6f 72  32.....<h4>A mor
2bb0: 65 20 63 6f 6d 70 6c 65 78 20 71 75 65 72 79 3c  e complex query<
2bc0: 2f 68 34 3e 0d 0a 0d 0a 3c 76 65 72 62 61 74 69  /h4>....<verbati
2bd0: 6d 3e 0d 0a 20 20 20 20 70 75 62 6c 69 63 20 53  m>..    public S
2be0: 74 72 69 6e 67 20 71 75 65 72 79 43 6f 6d 75 6e  tring queryComun
2bf0: 69 4e 65 61 72 62 79 28 29 20 7b 0d 0a 20 20 20  iNearby() {..   
2c00: 20 20 20 20 20 73 62 2e 61 70 70 65 6e 64 28 53       sb.append(S
2c10: 45 50 29 3b 0d 0a 20 20 20 20 20 20 20 20 73 62  EP);..        sb
2c20: 2e 61 70 70 65 6e 64 28 22 51 75 65 72 79 20 43  .append("Query C
2c30: 6f 6d 75 6e 69 20 6e 65 61 72 62 79 2e 2e 2e 5c  omuni nearby...\
2c40: 6e 22 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20  n");....        
2c50: 53 74 72 69 6e 67 20 71 75 65 72 79 20 3d 20 22  String query = "
2c60: 53 45 4c 45 43 54 20 48 65 78 28 53 54 5f 41 73  SELECT Hex(ST_As
2c70: 42 69 6e 61 72 79 28 53 54 5f 42 75 66 66 65 72  Binary(ST_Buffer
2c80: 28 47 65 6f 6d 65 74 72 79 2c 20 31 2e 30 29 29  (Geometry, 1.0))
2c90: 29 2c 20 53 54 5f 53 72 69 64 28 47 65 6f 6d 65  ), ST_Srid(Geome
2ca0: 74 72 79 29 2c 20 53 54 5f 47 65 6f 6d 65 74 72  try), ST_Geometr
2cb0: 79 54 79 70 65 28 47 65 6f 6d 65 74 72 79 29 20  yType(Geometry) 
2cc0: 66 72 6f 6d 20 43 6f 6d 75 6e 69 5f 31 31 22 20  from Comuni_11" 
2cd0: 2b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  +..             
2ce0: 20 20 20 22 20 77 68 65 72 65 20 4e 4f 4d 45 20     " where NOME 
2cf0: 3d 20 27 42 6f 6c 7a 61 6e 6f 27 3b 22 3b 0d 0a  = 'Bolzano';";..
2d00: 20 20 20 20 20 20 20 20 73 62 2e 61 70 70 65 6e          sb.appen
2d10: 64 28 22 45 78 65 63 75 74 65 20 71 75 65 72 79  d("Execute query
2d20: 3a 20 22 29 2e 61 70 70 65 6e 64 28 71 75 65 72  : ").append(quer
2d30: 79 29 2e 61 70 70 65 6e 64 28 22 5c 6e 22 29 3b  y).append("\n");
2d40: 0d 0a 20 20 20 20 20 20 20 20 53 74 72 69 6e 67  ..        String
2d50: 20 62 75 66 66 65 72 47 65 6f 6d 20 3d 20 22 22   bufferGeom = ""
2d60: 3b 0d 0a 20 20 20 20 20 20 20 20 53 74 72 69 6e  ;..        Strin
2d70: 67 20 62 75 66 66 65 72 47 65 6f 6d 53 68 6f 72  g bufferGeomShor
2d80: 74 20 3d 20 22 22 3b 0d 0a 20 20 20 20 20 20 20  t = "";..       
2d90: 20 74 72 79 20 7b 0d 0a 20 20 20 20 20 20 20 20   try {..        
2da0: 20 20 20 20 53 74 6d 74 20 73 74 6d 74 20 3d 20      Stmt stmt = 
2db0: 64 62 2e 70 72 65 70 61 72 65 28 71 75 65 72 79  db.prepare(query
2dc0: 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20  );..            
2dd0: 69 66 20 28 73 74 6d 74 2e 73 74 65 70 28 29 29  if (stmt.step())
2de0: 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20   {..            
2df0: 20 20 20 20 62 75 66 66 65 72 47 65 6f 6d 20 3d      bufferGeom =
2e00: 20 73 74 6d 74 2e 63 6f 6c 75 6d 6e 5f 73 74 72   stmt.column_str
2e10: 69 6e 67 28 30 29 3b 0d 0a 20 20 20 20 20 20 20  ing(0);..       
2e20: 20 20 20 20 20 20 20 20 20 53 74 72 69 6e 67 20           String 
2e30: 67 65 6f 6d 53 72 69 64 20 3d 20 73 74 6d 74 2e  geomSrid = stmt.
2e40: 63 6f 6c 75 6d 6e 5f 73 74 72 69 6e 67 28 31 29  column_string(1)
2e50: 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  ;..             
2e60: 20 20 20 53 74 72 69 6e 67 20 67 65 6f 6d 54 79     String geomTy
2e70: 70 65 20 3d 20 73 74 6d 74 2e 63 6f 6c 75 6d 6e  pe = stmt.column
2e80: 5f 73 74 72 69 6e 67 28 32 29 3b 0d 0a 20 20 20  _string(2);..   
2e90: 20 20 20 20 20 20 20 20 20 20 20 20 20 73 62 2e               sb.
2ea0: 61 70 70 65 6e 64 28 22 5c 74 54 68 65 20 73 65  append("\tThe se
2eb0: 6c 65 63 74 65 64 20 67 65 6f 6d 65 74 72 79 20  lected geometry 
2ec0: 69 73 20 6f 66 20 74 79 70 65 3a 20 22 29 2e 61  is of type: ").a
2ed0: 70 70 65 6e 64 28 67 65 6f 6d 54 79 70 65 29 2e  ppend(geomType).
2ee0: 61 70 70 65 6e 64 28 22 20 61 6e 64 20 6f 66 20  append(" and of 
2ef0: 53 52 49 44 3a 20 22 29 2e 61 70 70 65 6e 64 28  SRID: ").append(
2f00: 67 65 6f 6d 53 72 69 64 29 0d 0a 20 20 20 20 20  geomSrid)..     
2f10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2f20: 20 20 20 2e 61 70 70 65 6e 64 28 22 5c 6e 22 29     .append("\n")
2f30: 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d  ;..            }
2f40: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 62 75  ..            bu
2f50: 66 66 65 72 47 65 6f 6d 53 68 6f 72 74 20 3d 20  fferGeomShort = 
2f60: 62 75 66 66 65 72 47 65 6f 6d 3b 0d 0a 20 20 20  bufferGeom;..   
2f70: 20 20 20 20 20 20 20 20 20 69 66 20 28 62 75 66           if (buf
2f80: 66 65 72 47 65 6f 6d 2e 6c 65 6e 67 74 68 28 29  ferGeom.length()
2f90: 20 3e 20 31 30 29 0d 0a 20 20 20 20 20 20 20 20   > 10)..        
2fa0: 20 20 20 20 20 20 20 20 62 75 66 66 65 72 47 65          bufferGe
2fb0: 6f 6d 53 68 6f 72 74 20 3d 20 62 75 66 66 65 72  omShort = buffer
2fc0: 47 65 6f 6d 2e 73 75 62 73 74 72 69 6e 67 28 30  Geom.substring(0
2fd0: 2c 20 31 30 29 20 2b 20 22 2e 2e 2e 22 3b 0d 0a  , 10) + "...";..
2fe0: 20 20 20 20 20 20 20 20 20 20 20 20 73 62 2e 61              sb.a
2ff0: 70 70 65 6e 64 28 22 5c 74 42 6f 6c 7a 61 6e 6f  ppend("\tBolzano
3000: 20 70 6f 6c 79 67 6f 6e 20 62 75 66 66 65 72 20   polygon buffer 
3010: 67 65 6f 6d 65 74 72 79 20 69 6e 20 48 45 58 3a  geometry in HEX:
3020: 20 22 29 2e 61 70 70 65 6e 64 28 62 75 66 66 65   ").append(buffe
3030: 72 47 65 6f 6d 53 68 6f 72 74 29 2e 61 70 70 65  rGeomShort).appe
3040: 6e 64 28 22 5c 6e 22 29 3b 0d 0a 20 20 20 20 20  nd("\n");..     
3050: 20 20 20 20 20 20 20 73 74 6d 74 2e 63 6c 6f 73         stmt.clos
3060: 65 28 29 3b 0d 0a 20 20 20 20 20 20 20 20 7d 20  e();..        } 
3070: 63 61 74 63 68 20 28 45 78 63 65 70 74 69 6f 6e  catch (Exception
3080: 20 65 29 20 7b 0d 0a 20 20 20 20 20 20 20 20 20   e) {..         
3090: 20 20 20 65 2e 70 72 69 6e 74 53 74 61 63 6b 54     e.printStackT
30a0: 72 61 63 65 28 29 3b 0d 0a 20 20 20 20 20 20 20  race();..       
30b0: 20 20 20 20 20 73 62 2e 61 70 70 65 6e 64 28 45       sb.append(E
30c0: 52 52 4f 52 29 2e 61 70 70 65 6e 64 28 65 2e 67  RROR).append(e.g
30d0: 65 74 4c 6f 63 61 6c 69 7a 65 64 4d 65 73 73 61  etLocalizedMessa
30e0: 67 65 28 29 29 2e 61 70 70 65 6e 64 28 22 5c 6e  ge()).append("\n
30f0: 22 29 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a  ");..        }..
3100: 0d 0a 20 20 20 20 20 20 20 20 71 75 65 72 79 20  ..        query 
3110: 3d 20 22 53 45 4c 45 43 54 20 22 20 2b 20 4e 4f  = "SELECT " + NO
3120: 4d 45 20 2b 20 22 2c 20 41 73 54 65 78 74 28 53  ME + ", AsText(S
3130: 54 5f 63 65 6e 74 72 6f 69 64 28 47 65 6f 6d 65  T_centroid(Geome
3140: 74 72 79 29 29 20 66 72 6f 6d 20 22 20 2b 20 43  try)) from " + C
3150: 4f 4d 55 4e 49 54 41 42 4c 45 20 2b 20 2f 2f 0d  OMUNITABLE + //.
3160: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
3170: 20 22 20 77 68 65 72 65 20 53 54 5f 49 6e 74 65   " where ST_Inte
3180: 72 73 65 63 74 73 28 20 53 54 5f 47 65 6f 6d 46  rsects( ST_GeomF
3190: 72 6f 6d 57 4b 42 28 78 27 22 20 2b 20 62 75 66  romWKB(x'" + buf
31a0: 66 65 72 47 65 6f 6d 20 2b 20 22 27 29 20 2c 20  ferGeom + "') , 
31b0: 47 65 6f 6d 65 74 72 79 20 29 3b 22 3b 0d 0a 20  Geometry );";.. 
31c0: 20 20 20 20 20 20 20 2f 2f 20 6a 75 73 74 20 66         // just f
31d0: 6f 72 20 70 72 69 6e 74 0d 0a 20 20 20 20 20 20  or print..      
31e0: 20 20 53 74 72 69 6e 67 20 74 6d 70 51 75 65 72    String tmpQuer
31f0: 79 20 3d 20 22 53 45 4c 45 43 54 20 22 20 2b 20  y = "SELECT " + 
3200: 4e 4f 4d 45 20 2b 20 22 20 66 72 6f 6d 20 22 20  NOME + " from " 
3210: 2b 20 43 4f 4d 55 4e 49 54 41 42 4c 45 20 2b 20  + COMUNITABLE + 
3220: 2f 2f 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20  //..            
3230: 20 20 20 20 22 20 77 68 65 72 65 20 53 54 5f 49      " where ST_I
3240: 6e 74 65 72 73 65 63 74 73 28 20 53 54 5f 47 65  ntersects( ST_Ge
3250: 6f 6d 46 72 6f 6d 57 4b 42 28 78 27 22 20 2b 20  omFromWKB(x'" + 
3260: 62 75 66 66 65 72 47 65 6f 6d 53 68 6f 72 74 20  bufferGeomShort 
3270: 2b 20 22 27 29 20 2c 20 47 65 6f 6d 65 74 72 79  + "') , Geometry
3280: 20 29 3b 22 3b 0d 0a 20 20 20 20 20 20 20 20 73   );";..        s
3290: 62 2e 61 70 70 65 6e 64 28 22 45 78 65 63 75 74  b.append("Execut
32a0: 65 20 71 75 65 72 79 3a 20 22 29 2e 61 70 70 65  e query: ").appe
32b0: 6e 64 28 74 6d 70 51 75 65 72 79 29 2e 61 70 70  nd(tmpQuery).app
32c0: 65 6e 64 28 22 5c 6e 22 29 3b 0d 0a 20 20 20 20  end("\n");..    
32d0: 20 20 20 20 74 72 79 20 7b 0d 0a 20 20 20 20 20      try {..     
32e0: 20 20 20 20 20 20 20 73 62 2e 61 70 70 65 6e 64         sb.append
32f0: 28 22 5c 74 43 6f 6d 75 6e 69 20 6e 65 61 72 62  ("\tComuni nearb
3300: 79 20 42 6f 6c 7a 61 6e 6f 3a 20 5c 6e 22 29 3b  y Bolzano: \n");
3310: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 53 74  ..            St
3320: 6d 74 20 73 74 6d 74 20 3d 20 64 62 2e 70 72 65  mt stmt = db.pre
3330: 70 61 72 65 28 71 75 65 72 79 29 3b 0d 0a 20 20  pare(query);..  
3340: 20 20 20 20 20 20 20 20 20 20 77 68 69 6c 65 28            while(
3350: 20 73 74 6d 74 2e 73 74 65 70 28 29 20 29 20 7b   stmt.step() ) {
3360: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ..              
3370: 20 20 53 74 72 69 6e 67 20 6e 61 6d 65 20 3d 20    String name = 
3380: 73 74 6d 74 2e 63 6f 6c 75 6d 6e 5f 73 74 72 69  stmt.column_stri
3390: 6e 67 28 30 29 3b 0d 0a 20 20 20 20 20 20 20 20  ng(0);..        
33a0: 20 20 20 20 20 20 20 20 53 74 72 69 6e 67 20 77          String w
33b0: 6b 74 20 3d 20 73 74 6d 74 2e 63 6f 6c 75 6d 6e  kt = stmt.column
33c0: 5f 73 74 72 69 6e 67 28 31 29 3b 0d 0a 20 20 20  _string(1);..   
33d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 73 62 2e               sb.
33e0: 61 70 70 65 6e 64 28 22 5c 74 5c 74 22 29 2e 61  append("\t\t").a
33f0: 70 70 65 6e 64 28 6e 61 6d 65 29 2e 61 70 70 65  ppend(name).appe
3400: 6e 64 28 22 20 2d 20 77 69 74 68 20 63 65 6e 74  nd(" - with cent
3410: 72 6f 69 64 20 69 6e 20 22 29 2e 61 70 70 65 6e  roid in ").appen
3420: 64 28 77 6b 74 29 2e 61 70 70 65 6e 64 28 22 5c  d(wkt).append("\
3430: 6e 22 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20  n");..          
3440: 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 20 20 20    }..           
3450: 20 73 74 6d 74 2e 63 6c 6f 73 65 28 29 3b 0d 0a   stmt.close();..
3460: 20 20 20 20 20 20 20 20 7d 20 63 61 74 63 68 20          } catch 
3470: 28 45 78 63 65 70 74 69 6f 6e 20 65 29 20 7b 0d  (Exception e) {.
3480: 0a 20 20 20 20 20 20 20 20 20 20 20 20 65 2e 70  .            e.p
3490: 72 69 6e 74 53 74 61 63 6b 54 72 61 63 65 28 29  rintStackTrace()
34a0: 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 73  ;..            s
34b0: 62 2e 61 70 70 65 6e 64 28 45 52 52 4f 52 29 2e  b.append(ERROR).
34c0: 61 70 70 65 6e 64 28 65 2e 67 65 74 4c 6f 63 61  append(e.getLoca
34d0: 6c 69 7a 65 64 4d 65 73 73 61 67 65 28 29 29 2e  lizedMessage()).
34e0: 61 70 70 65 6e 64 28 22 5c 6e 22 29 3b 0d 0a 20  append("\n");.. 
34f0: 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20         }..      
3500: 20 20 73 62 2e 61 70 70 65 6e 64 28 22 44 6f 6e    sb.append("Don
3510: 65 2e 2e 2e 5c 6e 22 29 3b 0d 0a 0d 0a 20 20 20  e...\n");....   
3520: 20 20 20 20 20 72 65 74 75 72 6e 20 73 62 2e 74       return sb.t
3530: 6f 53 74 72 69 6e 67 28 29 3b 0d 0a 20 20 20 20  oString();..    
3540: 7d 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a  }..</verbatim>..
3550: 0d 0a 54 68 65 20 61 62 6f 76 65 20 77 69 6c 6c  ..The above will
3560: 20 65 78 74 72 61 63 74 20 74 68 65 20 70 6f 6c   extract the pol
3570: 79 67 6f 6e 20 6f 66 20 74 68 65 20 72 65 67 69  ygon of the regi
3580: 6f 6e 20 42 6f 6c 7a 61 6e 6f 2c 20 62 75 66 66  on Bolzano, buff
3590: 65 72 20 69 74 20 61 6e 64 20 74 68 65 6e 20 66  er it and then f
35a0: 69 6e 64 20 61 6c 6c 20 67 65 6f 6d 65 74 72 69  ind all geometri
35b0: 65 73 20 74 68 61 74 20 69 6e 74 65 72 73 65 63  es that intersec
35c0: 74 20 77 69 74 68 20 74 68 61 74 20 62 75 66 66  t with that buff
35d0: 65 72 2e 20 49 74 20 69 73 20 61 20 73 69 6d 70  er. It is a simp
35e0: 6c 65 20 77 61 79 20 74 6f 20 66 69 6e 64 20 74  le way to find t
35f0: 68 65 20 72 65 67 69 6f 6e 73 20 73 75 72 72 6f  he regions surro
3600: 75 6e 64 69 6e 67 20 42 6f 6c 7a 61 6e 6f 2e 20  unding Bolzano. 
3610: 0d 0a 0d 0a 3c 68 34 3e 43 6c 6f 73 65 20 74 68  ....<h4>Close th
3620: 65 20 64 61 74 61 62 61 73 65 3c 2f 68 34 3e 0d  e database</h4>.
3630: 0a 0d 0a 4f 6e 63 65 20 79 6f 75 20 64 6f 20 6e  ...Once you do n
3640: 6f 74 20 6e 65 65 64 20 74 68 65 20 63 6f 6e 6e  ot need the conn
3650: 65 63 74 69 6f 6e 20 74 6f 20 74 68 65 20 64 61  ection to the da
3660: 74 61 62 61 73 65 20 61 6e 79 20 6c 6f 6e 67 65  tabase any longe
3670: 72 2c 20 72 65 6d 65 6d 62 65 72 20 74 6f 20 72  r, remember to r
3680: 65 6c 65 61 73 65 20 74 68 65 20 72 65 73 6f 75  elease the resou
3690: 72 63 65 20 62 79 20 63 6c 6f 73 69 6e 67 20 74  rce by closing t
36a0: 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 3a 0d 0a  he connection:..
36b0: 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 64 62  ..<verbatim>..db
36c0: 2e 63 6c 6f 73 65 28 29 3b 0d 0a 3c 2f 76 65 72  .close();..</ver
36d0: 62 61 74 69 6d 3e 0d 0a 0d 0a 3c 68 33 3e 50 75  batim>....<h3>Pu
36e0: 74 74 69 6e 67 20 69 74 20 61 6c 6c 20 74 6f 67  tting it all tog
36f0: 65 74 68 65 72 3c 2f 68 33 3e 0d 0a 0d 0a 3c 70  ether</h3>....<p
3700: 3e 57 65 20 68 61 76 65 20 63 72 65 61 74 65 64  >We have created
3710: 20 61 20 73 69 6d 70 6c 65 20 41 6e 64 72 6f 69   a simple Androi
3720: 64 20 70 72 6f 6a 65 63 74 2c 20 77 68 69 63 68  d project, which
3730: 20 69 6d 70 6c 65 6d 65 6e 74 73 20 74 68 65 20   implements the 
3740: 73 69 6d 70 6c 65 20 71 75 65 72 69 65 73 20 73  simple queries s
3750: 65 65 6e 20 69 6e 20 74 68 65 20 61 62 6f 76 65  een in the above
3760: 20 63 68 61 70 74 65 72 73 2e 0d 0a 49 74 20 77   chapters...It w
3770: 69 6c 6c 20 68 61 76 65 20 61 20 76 69 65 77 20  ill have a view 
3780: 77 69 74 68 20 61 20 62 75 74 74 6f 6e 2c 20 77  with a button, w
3790: 68 69 63 68 2c 20 6f 6e 63 65 20 70 72 65 73 73  hich, once press
37a0: 65 64 2c 20 77 69 6c 6c 20 65 78 65 63 75 74 65  ed, will execute
37b0: 20 69 6e 20 61 20 72 6f 77 20 61 6c 6c 20 74 68   in a row all th
37c0: 65 20 71 75 65 72 69 65 73 20 61 6e 64 20 73 68  e queries and sh
37d0: 6f 77 20 74 68 65 20 72 65 73 75 6c 74 73 2e 0d  ow the results..
37e0: 0a 0d 0a 3c 68 32 3e 50 72 6f 6a 65 63 74 73 20  ...<h2>Projects 
37f0: 69 6d 70 6c 65 6d 65 6e 74 69 6e 67 20 69 74 3c  implementing it<
3800: 2f 68 32 3e 0d 0a 0d 0a 3c 68 33 3e 47 65 6f 50  /h2>....<h3>GeoP
3810: 61 70 61 72 61 7a 7a 69 3c 2f 68 33 3e 0d 0a 0d  aparazzi</h3>...
3820: 0a 3c 70 3e 54 68 65 20 3c 61 20 68 72 65 66 3d  .<p>The <a href=
3830: 22 68 74 74 70 3a 2f 2f 77 77 77 2e 67 65 6f 70  "http://www.geop
3840: 61 70 61 72 61 7a 7a 69 2e 65 75 22 3e 47 65 6f  aparazzi.eu">Geo
3850: 50 61 70 61 72 61 7a 7a 69 3c 2f 61 3e 20 70 72  Paparazzi</a> pr
3860: 6f 6a 65 63 74 20 73 75 70 70 6f 72 74 73 20 74  oject supports t
3870: 68 65 20 53 70 61 74 69 61 6c 69 74 65 2d 41 6e  he Spatialite-An
3880: 64 72 6f 69 64 20 69 6e 20 61 20 6d 6f 72 65 20  droid in a more 
3890: 63 6f 6d 70 6c 65 78 20 77 61 79 20 74 68 61 6e  complex way than
38a0: 20 64 65 73 63 72 69 62 65 64 20 69 6e 20 74 68   described in th
38b0: 69 73 20 73 68 6f 72 74 20 74 75 74 6f 72 69 61  is short tutoria
38c0: 6c 2e 0d 0a 0d 0a 3c 70 3e 47 65 6f 50 61 70 61  l.....<p>GeoPapa
38d0: 72 61 7a 7a 69 20 65 6e 61 62 6c 65 73 20 74 68  razzi enables th
38e0: 65 20 75 73 65 20 6f 66 20 73 70 61 74 69 61 6c  e use of spatial
38f0: 69 74 65 20 64 61 74 61 62 61 73 65 73 20 61 73  ite databases as
3900: 20 64 61 74 61 20 73 6f 75 72 63 65 73 20 61 6e   data sources an
3910: 64 20 76 69 73 75 61 6c 69 7a 65 73 20 74 68 65  d visualizes the
3920: 6d 20 6f 6e 20 74 68 65 20 6d 61 70 20 76 69 65  m on the map vie
3930: 77 2e 20 42 65 69 6e 67 20 74 68 65 20 6d 61 70  w. Being the map
3940: 76 69 65 77 20 66 6f 72 63 65 64 20 6f 6e 20 61  view forced on a
3950: 20 4d 65 72 63 61 74 6f 72 20 70 72 6f 6a 65 63   Mercator projec
3960: 74 69 6f 6e 2c 20 74 68 65 20 64 61 74 61 73 65  tion, the datase
3970: 74 73 20 61 72 65 20 65 78 74 72 61 63 74 65 64  ts are extracted
3980: 20 61 6e 64 20 72 65 70 72 6f 6a 65 63 74 65 64   and reprojected
3990: 20 64 69 72 65 63 74 6c 79 20 69 6e 20 73 70 61   directly in spa
39a0: 74 69 61 6c 69 74 65 2e 20 49 74 20 69 73 20 61  tialite. It is a
39b0: 6c 73 6f 20 70 6f 73 73 69 62 6c 65 20 74 6f 20  lso possible to 
39c0: 71 75 65 72 79 20 6c 61 79 65 72 73 20 62 79 20  query layers by 
39d0: 74 61 70 70 69 6e 67 20 6f 6e 20 74 68 65 20 6d  tapping on the m
39e0: 61 70 2e 20 0d 0a 0d 0a 3c 70 3e 49 66 20 79 6f  ap. ....<p>If yo
39f0: 75 20 61 72 65 20 69 6e 74 65 72 65 73 74 65 64  u are interested
3a00: 20 69 6e 20 74 68 65 20 71 75 65 72 69 65 73 20   in the queries 
3a10: 75 73 65 64 2c 20 68 61 76 65 20 61 20 6c 6f 6f  used, have a loo
3a20: 6b 20 69 6e 74 6f 20 69 74 73 20 63 6f 64 65 20  k into its code 
3a30: 6f 6e 20 74 68 65 20 68 6f 6d 65 70 61 67 65 2c  on the homepage,
3a40: 20 74 68 65 20 70 72 6f 6a 65 63 74 20 69 73 20   the project is 
3a50: 6f 70 65 6e 20 73 6f 75 72 63 65 2e 0d 0a 0d 0a  open source.....
3a60: 3c 62 72 3e 3c 68 72 3e 0d 0a 42 61 63 6b 20 74  <br><hr>..Back t
3a70: 6f 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 73  o <a href="https
3a80: 3a 2f 2f 77 77 77 2e 67 61 69 61 2d 67 69 73 2e  ://www.gaia-gis.
3a90: 69 74 2f 66 6f 73 73 69 6c 2f 6c 69 62 73 70 61  it/fossil/libspa
3aa0: 74 69 61 6c 69 74 65 2f 77 69 6b 69 3f 6e 61 6d  tialite/wiki?nam
3ab0: 65 3d 73 70 6c 69 74 65 2d 61 6e 64 72 6f 69 64  e=splite-android
3ac0: 22 3e 53 70 61 74 69 61 4c 69 74 65 2d 41 6e 64  ">SpatiaLite-And
3ad0: 72 6f 69 64 3c 2f 61 3e 20 57 69 6b 69 20 70 61  roid</a> Wiki pa
3ae0: 67 65 0d 0a 0a 5a 20 38 63 31 34 31 63 35 65 32  ge...Z 8c141c5e2
3af0: 33 66 62 39 63 36 32 36 37 66 39 36 37 31 31 34  3fb9c6267f967114
3b00: 62 36 65 61 38 34 61 0a                          b6ea84a.