0000: 44 20 32 30 31 35 2d 31 32 2d 30 38 54 31 39 3a D 2015-12-08T19:
0010: 33 37 3a 35 37 2e 31 30 32 0a 4c 20 4b 4e 4e 0a 37:57.102.L KNN.
0020: 50 20 64 38 38 33 31 38 61 63 65 33 35 34 64 38 P d88318ace354d8
0030: 65 36 33 33 30 38 61 39 61 32 31 64 65 39 32 61 e63308a9a21de92a
0040: 64 62 62 65 30 30 30 36 61 30 0a 55 20 73 61 6e dbbe0006a0.U san
0050: 64 72 6f 0a 57 20 31 36 32 30 31 0a 3c 74 61 62 dro.W 16201.<tab
0060: 6c 65 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 le cellspacing="
0070: 31 32 22 20 77 69 64 74 68 3d 22 31 30 30 25 22 12" width="100%"
0080: 3e 0d 0a 3c 74 72 3e 3c 74 64 20 63 6f 6c 73 70 >..<tr><td colsp
0090: 61 6e 3d 22 32 22 3e 0d 0a 3c 74 61 62 6c 65 20 an="2">..<table
00a0: 77 69 64 74 68 3d 22 31 30 30 25 22 20 62 67 63 width="100%" bgc
00b0: 6f 6c 6f 72 3d 22 23 66 30 66 30 66 38 22 3e 0d olor="#f0f0f8">.
00c0: 0a 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 .<tr><td align="
00d0: 63 65 6e 74 65 72 22 3e 0d 0a 3c 68 31 3e 56 69 center">..<h1>Vi
00e0: 72 74 75 61 6c 4b 4e 4e 3a 20 61 20 71 75 69 63 rtualKNN: a quic
00f0: 6b 20 69 6e 74 72 6f 3c 2f 68 31 3e 0d 0a 3c 2f k intro</h1>..</
0100: 74 64 3e 3c 2f 74 72 3e 3c 2f 74 61 62 6c 65 3e td></tr></table>
0110: 0d 0a 3c 74 61 62 6c 65 20 77 69 64 74 68 3d 22 ..<table width="
0120: 31 30 30 25 22 3e 3c 74 72 3e 0d 0a 3c 74 64 20 100%"><tr>..<td
0130: 77 69 64 74 68 3d 22 33 33 25 22 20 61 6c 69 67 width="33%" alig
0140: 6e 3d 22 6c 65 66 74 22 3e 3c 2f 74 64 3e 0d 0a n="left"></td>..
0150: 3c 74 64 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65 <td align="cente
0160: 72 22 3e 3c 61 20 68 72 65 66 3d 22 68 74 74 70 r"><a href="http
0170: 73 3a 2f 2f 77 77 77 2e 67 61 69 61 2d 67 69 73 s://www.gaia-gis
0180: 2e 69 74 2f 66 6f 73 73 69 6c 2f 6c 69 62 73 70 .it/fossil/libsp
0190: 61 74 69 61 6c 69 74 65 2f 77 69 6b 69 3f 6e 61 atialite/wiki?na
01a0: 6d 65 3d 6d 69 73 63 2d 64 6f 63 73 22 3e 62 61 me=misc-docs">ba
01b0: 63 6b 20 74 6f 20 69 6e 64 65 78 3c 2f 61 3e 3c ck to index</a><
01c0: 2f 74 64 3e 0d 0a 3c 74 64 20 77 69 64 74 68 3d /td>..<td width=
01d0: 22 33 33 25 22 20 61 6c 69 67 6e 3d 22 72 69 67 "33%" align="rig
01e0: 68 74 22 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e ht"></td>..</tr>
01f0: 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 74 </table><br>..<t
0200: 61 62 6c 65 20 62 67 63 6f 6c 6f 72 3d 22 23 64 able bgcolor="#d
0210: 30 65 30 66 66 22 20 77 69 64 74 68 3d 22 31 30 0e0ff" width="10
0220: 30 25 22 3e 0d 0a 3c 74 72 3e 3c 74 64 20 61 6c 0%">..<tr><td al
0230: 69 67 6e 3d 22 63 65 6e 74 65 72 22 3e 0d 0a 3c ign="center">..<
0240: 62 3e 43 72 65 64 69 74 73 3c 2f 62 3e 3c 62 72 b>Credits</b><br
0250: 3e 0d 0a 44 65 76 65 6c 6f 70 6d 65 6e 74 20 6f >..Development o
0260: 66 20 3c 62 3e 3c 69 3e 56 69 72 74 75 61 6c 4b f <b><i>VirtualK
0270: 4e 4e 3c 2f 69 3e 3c 2f 62 3e 20 68 61 73 20 62 NN</i></b> has b
0280: 65 65 6e 20 65 6e 74 69 65 72 65 6c 79 20 66 75 een entierely fu
0290: 6e 64 65 64 20 62 79 0d 0a 3c 61 20 68 72 65 66 nded by..<a href
02a0: 3d 22 68 74 74 70 3a 2f 2f 65 6e 2e 77 69 6b 69 ="http://en.wiki
02b0: 70 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 54 pedia.org/wiki/T
02c0: 75 73 63 61 6e 79 22 3e 54 75 73 63 61 6e 79 20 uscany">Tuscany
02d0: 52 65 67 69 6f 6e 3c 2f 61 3e 20 2d 20 54 65 72 Region</a> - Ter
02e0: 72 69 74 6f 72 69 61 6c 20 61 6e 64 20 45 6e 76 ritorial and Env
02f0: 69 72 6f 6e 6d 65 6e 74 61 6c 20 49 6e 66 6f 72 ironmental Infor
0300: 6d 61 74 69 6f 6e 20 53 79 73 74 65 6d 3c 62 72 mation System<br
0310: 3e 0d 0a 3c 61 20 68 72 65 66 3d 22 68 74 74 70 >..<a href="http
0320: 3a 2f 2f 77 77 77 2e 72 65 67 69 6f 6e 65 2e 74 ://www.regione.t
0330: 6f 73 63 61 6e 61 2e 69 74 2f 61 6d 62 69 65 6e oscana.it/ambien
0340: 74 65 65 74 65 72 72 69 74 6f 72 69 6f 2f 67 65 teeterritorio/ge
0350: 6f 67 72 61 66 69 61 67 65 6f 6c 6f 67 69 61 2f ografiageologia/
0360: 69 6e 64 65 78 2e 68 74 6d 6c 22 3e 52 65 67 69 index.html">Regi
0370: 6f 6e 65 20 54 6f 73 63 61 6e 61 3c 2f 61 3e 20 one Toscana</a>
0380: 2d 20 53 65 74 74 6f 72 65 20 53 69 73 74 65 6d - Settore Sistem
0390: 61 20 49 6e 66 6f 72 6d 61 74 69 76 6f 20 54 65 a Informativo Te
03a0: 72 72 69 74 6f 72 69 61 6c 65 20 65 64 20 41 6d rritoriale ed Am
03b0: 62 69 65 6e 74 61 6c 65 2e 0d 0a 3c 2f 74 64 3e bientale...</td>
03c0: 3c 2f 74 72 3e 3c 2f 74 61 62 6c 65 3e 3c 62 72 </tr></table><br
03d0: 3e 0d 0a 3c 68 72 3e 3c 62 72 3e 0d 0a 3c 74 61 >..<hr><br>..<ta
03e0: 62 6c 65 20 77 69 64 74 68 3d 22 31 30 30 25 22 ble width="100%"
03f0: 20 62 67 63 6f 6c 6f 72 3d 22 23 66 66 66 66 64 bgcolor="#ffffd
0400: 66 22 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 f" cellspacing="
0410: 34 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 4" cellpadding="
0420: 38 22 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 8">..<tr><td><b>
0430: 57 68 61 74 20 69 73 20 74 68 65 20 4b 4e 4e 20 What is the KNN
0440: 28 3c 69 3e 4b 2d 4e 65 61 72 65 73 74 20 4e 65 (<i>K-Nearest Ne
0450: 69 67 68 62 6f 72 73 3c 2f 69 3e 29 20 70 72 6f ighbors</i>) pro
0460: 62 6c 65 6d 20 3f 3c 2f 62 3e 3c 2f 74 64 3e 3c blem ?</b></td><
0470: 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 49 6d /tr>..<tr><td>Im
0480: 61 67 69 6e 65 20 61 20 73 65 74 20 6f 66 20 61 agine a set of a
0490: 72 62 69 74 72 61 72 79 20 67 65 6f 6d 65 74 72 rbitrary geometr
04a0: 69 65 73 3b 20 6d 61 79 20 77 65 6c 6c 20 62 65 ies; may well be
04b0: 2c 20 61 20 72 65 61 6c 6c 79 20 68 75 67 65 20 , a really huge
04c0: 64 61 74 61 73 65 74 20 63 6f 6e 74 61 69 6e 69 dataset containi
04d0: 6e 67 20 73 6f 6d 65 20 6d 69 6c 6c 69 6f 6e 20 ng some million
04e0: 66 65 61 74 75 72 65 73 2e 3c 62 72 3e 0d 0a 4e features.<br>..N
04f0: 6f 77 20 69 6d 61 67 69 6e 65 20 74 68 61 74 20 ow imagine that
0500: 66 6f 72 20 61 6e 79 20 67 6f 6f 64 20 72 65 61 for any good rea
0510: 73 6f 6e 20 79 6f 75 20 61 72 65 20 69 6e 74 65 son you are inte
0520: 72 65 73 74 65 64 20 69 6e 20 71 75 69 63 6b 6c rested in quickl
0530: 79 20 69 64 65 6e 74 69 66 79 69 6e 67 20 61 6c y identifying al
0540: 6c 20 66 65 61 74 75 72 65 73 20 6c 61 79 69 6e l features layin
0550: 67 20 69 6e 20 63 6c 6f 73 65 20 73 70 61 74 69 g in close spati
0560: 61 6c 20 70 72 6f 78 69 6d 69 74 79 20 74 6f 20 al proximity to
0570: 61 6e 20 61 72 62 69 74 72 61 72 79 20 6c 6f 63 an arbitrary loc
0580: 61 74 69 6f 6e 2e 3c 62 72 3e 0d 0a 54 68 69 73 ation.<br>..This
0590: 20 69 73 20 74 68 65 20 74 79 70 69 63 61 6c 20 is the typical
05a0: 63 61 73 65 20 6f 66 20 61 20 3c 62 3e 4b 4e 4e case of a <b>KNN
05b0: 3c 2f 62 3e 20 70 72 6f 62 6c 65 6d 2e 3c 2f 74 </b> problem.</t
05c0: 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 d></tr>..<tr><td
05d0: 3e 4a 75 73 74 20 66 65 77 20 70 72 61 63 74 69 >Just few practi
05e0: 63 61 6c 20 72 65 61 6c 20 77 6f 72 6c 64 20 65 cal real world e
05f0: 78 61 6d 70 6c 65 73 3a 0d 0a 3c 75 6c 3e 0d 0a xamples:..<ul>..
0600: 3c 6c 69 3e 53 75 70 70 6f 73 65 20 61 20 73 6d <li>Suppose a sm
0610: 61 72 74 70 68 6f 6e 65 20 61 70 70 3a 20 79 6f artphone app: yo
0620: 75 72 20 63 75 72 72 65 6e 74 20 67 65 6f 67 72 ur current geogr
0630: 61 70 68 69 63 73 20 6c 6f 63 61 74 69 6f 6e 20 aphics location
0640: 69 73 20 77 65 6c 6c 20 6b 6e 6f 77 6e 20 62 79 is well known by
0650: 20 74 68 65 20 69 6e 74 65 67 72 61 74 65 64 20 the integrated
0660: 47 50 53 20 73 65 6e 73 6f 72 2c 20 73 6f 20 79 GPS sensor, so y
0670: 6f 75 20 61 72 65 20 73 69 6d 70 6c 79 20 65 78 ou are simply ex
0680: 70 65 63 74 69 6e 67 20 74 68 61 74 20 74 68 65 pecting that the
0690: 20 61 70 70 20 77 69 6c 6c 20 69 6d 6d 65 64 69 app will immedi
06a0: 61 74 65 6c 79 20 74 65 6c 6c 20 79 6f 75 20 77 ately tell you w
06b0: 68 69 63 68 20 61 72 65 20 28 61 6e 64 20 77 68 hich are (and wh
06c0: 65 72 65 20 74 68 65 79 20 61 72 65 20 65 78 61 ere they are exa
06d0: 63 74 65 6c 79 20 6c 6f 63 61 74 65 64 29 20 74 ctely located) t
06e0: 68 65 20 6e 65 61 72 65 73 74 20 66 75 65 6c 20 he nearest fuel
06f0: 73 74 61 74 69 6f 6e 73 20 28 6f 72 20 6d 61 79 stations (or may
0700: 62 65 20 68 6f 74 65 6c 73 2c 20 72 65 73 74 61 be hotels, resta
0710: 75 72 61 6e 74 73 20 6f 72 20 77 68 61 74 65 76 urants or whatev
0720: 65 72 20 65 6c 73 65 29 2e 3c 2f 6c 69 3e 0d 0a er else).</li>..
0730: 3c 6c 69 3e 53 75 70 70 6f 73 65 20 61 20 7a 6f <li>Suppose a zo
0740: 6f 6c 6f 67 69 63 61 6c 2f 65 63 68 6f 6c 6f 67 ological/echolog
0750: 69 63 61 6c 20 73 74 75 64 79 3a 20 79 6f 75 20 ical study: you
0760: 6b 6e 6f 77 20 77 68 65 72 65 20 61 72 65 20 6c know where are l
0770: 6f 63 61 74 65 64 20 74 68 65 20 6e 65 73 74 69 ocated the nesti
0780: 6e 67 20 61 72 65 61 73 20 6f 66 20 73 6f 6d 65 ng areas of some
0790: 20 72 61 72 65 20 77 61 74 65 72 20 62 69 72 64 rare water bird
07a0: 20 73 70 65 63 69 65 73 2c 20 61 6e 64 20 79 6f species, and yo
07b0: 75 20 6b 6e 6f 77 20 77 68 65 72 65 20 61 72 65 u know where are
07c0: 20 6c 6f 63 61 74 65 64 20 61 6c 6c 20 72 69 76 located all riv
07d0: 65 72 73 2c 20 6c 61 6b 65 73 2c 20 70 6f 6e 64 ers, lakes, pond
07e0: 73 20 61 6e 64 20 6d 61 72 73 68 6c 61 6e 64 73 s and marshlands
07f0: 20 69 6e 20 74 68 65 20 72 65 67 69 6f 6e 20 6f in the region o
0800: 66 20 79 6f 75 72 20 69 6e 74 65 72 65 73 65 74 f your intereset
0810: 2e 3c 62 72 3e 0d 0a 4e 6f 77 20 79 6f 75 20 61 .<br>..Now you a
0820: 72 65 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f re attempting to
0830: 20 67 65 74 20 61 20 72 65 61 73 6f 6e 61 62 6c get a reasonabl
0840: 65 20 61 73 73 6f 63 69 61 74 69 6f 6e 20 62 65 e association be
0850: 74 77 65 65 6e 20 6e 65 73 74 69 6e 67 20 61 72 tween nesting ar
0860: 65 61 73 20 61 6e 64 20 66 65 65 64 69 6e 67 20 eas and feeding
0870: 7a 6f 6e 65 73 20 62 61 73 65 64 20 6f 6e 20 6d zones based on m
0880: 69 6e 69 6d 61 6c 20 64 69 73 74 61 6e 63 65 20 inimal distance
0890: 63 72 69 74 65 72 69 61 2e 3c 2f 6c 69 3e 0d 0a criteria.</li>..
08a0: 3c 2f 75 6c 3e 0d 0a 3c 2f 74 64 3e 3c 2f 74 72 </ul>..</td></tr
08b0: 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 3c 62 3e 4e 6f >..<tr><td><b>No
08c0: 74 65 3c 2f 62 3e 3a 20 69 6e 20 62 6f 74 68 20 te</b>: in both
08d0: 63 61 73 65 73 20 79 6f 75 20 63 61 6e 27 74 20 cases you can't
08e0: 73 61 66 65 6c 79 20 69 64 65 6e 74 69 66 79 20 safely identify
08f0: 61 20 72 65 61 73 6f 6e 61 62 6c 65 20 3c 69 3e a reasonable <i>
0900: 3c 75 3e 6d 69 6e 69 6d 61 6c 20 72 61 64 69 75 <u>minimal radiu
0910: 73 3c 2f 75 3e 3c 2f 69 3e 20 73 6f 20 74 6f 20 s</u></i> so to
0920: 75 73 65 66 75 6c 6c 79 20 72 65 73 74 72 69 63 usefully restric
0930: 74 20 79 6f 75 72 20 73 65 61 72 63 68 2c 20 73 t your search, s
0940: 69 6d 70 6c 79 20 62 65 63 61 75 73 65 20 79 6f imply because yo
0950: 75 20 63 61 6e 27 74 20 6d 61 6b 65 20 61 6e 79 u can't make any
0960: 20 76 61 6c 69 64 20 61 73 73 75 6d 70 74 69 6f valid assumptio
0970: 6e 20 61 62 6f 75 74 20 74 68 65 20 67 65 6f 67 n about the geog
0980: 72 61 70 68 69 63 20 64 69 73 74 72 69 62 75 74 raphic distribut
0990: 69 6f 6e 20 6f 66 20 79 6f 75 72 20 74 61 72 67 ion of your targ
09a0: 65 74 73 2e 3c 62 72 3e 0d 0a 54 68 65 20 64 69 ets.<br>..The di
09b0: 73 74 61 6e 63 65 73 20 6d 61 79 20 6e 6f 74 69 stances may noti
09c0: 63 65 61 62 6c 79 20 76 61 72 79 20 66 72 6f 6d ceably vary from
09d0: 20 63 61 73 65 20 74 6f 20 63 61 73 65 2c 20 61 case to case, a
09e0: 6e 64 20 79 6f 75 20 68 61 76 65 6e 27 74 20 61 nd you haven't a
09f0: 6e 79 20 69 64 65 61 20 61 62 6f 75 74 20 74 68 ny idea about th
0a00: 69 73 20 62 65 63 61 75 73 65 20 69 74 20 73 74 is because it st
0a10: 72 69 63 74 6c 79 20 64 65 70 65 6e 64 73 20 6f rictly depends o
0a20: 6e 20 74 68 65 20 61 63 74 75 61 6c 20 6c 6f 63 n the actual loc
0a30: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 65 61 ation of the sea
0a40: 72 63 68 20 6f 72 69 67 69 6e 20 61 6e 64 20 6f rch origin and o
0a50: 6e 20 74 68 65 20 73 74 61 74 69 73 74 69 63 61 n the statistica
0a60: 6c 20 64 69 73 70 65 72 73 69 6f 6e 20 6f 66 20 l dispersion of
0a70: 74 68 65 20 74 61 72 67 65 74 73 20 74 6f 20 62 the targets to b
0a80: 65 20 73 65 61 72 63 68 65 64 2e 3c 2f 74 64 3e e searched.</td>
0a90: 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c </tr>..</table><
0aa0: 62 72 3e 0d 0a 3c 68 72 3e 3c 62 72 3e 0d 0a 3c br>..<hr><br>..<
0ab0: 74 61 62 6c 65 20 77 69 64 74 68 3d 22 31 30 30 table width="100
0ac0: 25 22 3e 0d 0a 3c 74 72 3e 3c 74 64 20 76 61 6c %">..<tr><td val
0ad0: 69 67 6e 3d 22 6d 69 64 64 6c 65 22 3e 0d 0a 59 ign="middle">..Y
0ae0: 6f 75 20 63 61 6e 20 65 76 65 6e 74 75 61 6c 6c ou can eventuall
0af0: 79 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 73 y <a href="https
0b00: 3a 2f 2f 77 77 77 2e 67 61 69 61 2d 67 69 73 2e ://www.gaia-gis.
0b10: 69 74 2f 67 61 69 61 2d 73 69 6e 73 2f 6b 6e 6e it/gaia-sins/knn
0b20: 2f 61 69 72 70 6f 72 74 73 2e 37 7a 22 3e 64 6f /airports.7z">do
0b30: 77 6e 6c 6f 61 64 3c 2f 61 3e 20 61 20 73 61 6d wnload</a> a sam
0b40: 70 6c 65 20 64 62 2d 66 69 6c 65 20 65 78 61 63 ple db-file exac
0b50: 74 6c 79 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e tly correspondin
0b60: 67 20 74 6f 20 74 68 65 20 70 72 61 63 74 69 63 g to the practic
0b70: 61 6c 20 65 78 61 6d 70 6c 65 73 20 77 65 27 6c al examples we'l
0b80: 6c 20 75 73 65 20 69 6e 20 74 68 69 73 20 66 69 l use in this fi
0b90: 72 73 74 20 74 75 74 6f 72 69 61 6c 2e 3c 62 72 rst tutorial.<br
0ba0: 3e 3c 62 72 3e 0d 0a 54 68 69 73 20 64 61 74 61 ><br>..This data
0bb0: 73 65 74 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 set corresponds
0bc0: 74 6f 20 61 20 63 6f 6c 6c 65 63 74 69 6f 6e 20 to a collection
0bd0: 6f 66 20 61 62 6f 75 74 20 3c 62 3e 33 30 2e 30 of about <b>30.0
0be0: 30 30 20 61 69 72 70 6f 72 74 73 3c 2f 62 3e 20 00 airports</b>
0bf0: 73 63 61 74 74 65 72 65 64 20 61 6c 6c 20 6f 76 scattered all ov
0c00: 65 72 20 74 68 65 20 77 6f 72 6c 64 3b 20 74 68 er the world; th
0c10: 65 20 6f 72 69 67 69 6e 61 6c 20 69 6e 70 75 74 e original input
0c20: 20 73 68 61 70 65 66 69 6c 65 20 77 61 73 20 64 shapefile was d
0c30: 6f 77 6e 6c 6f 61 64 65 64 20 66 72 6f 6d 20 3c ownloaded from <
0c40: 61 20 68 72 65 66 3d 22 68 74 74 70 73 3a 2f 2f a href="https://
0c50: 77 77 77 2e 73 68 61 72 65 67 65 6f 2e 61 63 2e www.sharegeo.ac.
0c60: 75 6b 2f 68 61 6e 64 6c 65 2f 31 30 36 37 32 2f uk/handle/10672/
0c70: 33 30 33 22 3e 68 65 72 65 3c 2f 61 3e 3c 62 72 303">here</a><br
0c80: 3e 0d 0a 54 68 65 20 72 65 66 65 72 65 6e 63 65 >..The reference
0c90: 20 73 79 73 74 65 6d 20 69 73 20 3c 62 3e 34 33 system is <b>43
0ca0: 32 36 20 57 47 53 38 34 3c 2f 62 3e 20 28 62 61 26 WGS84</b> (ba
0cb0: 73 65 64 20 6f 6e 20 3c 69 3e 6c 6f 6e 67 69 74 sed on <i>longit
0cc0: 75 65 64 3c 2f 69 3e 20 61 6e 64 20 3c 69 3e 6c ued</i> and <i>l
0cd0: 61 74 69 74 75 64 65 3c 2f 69 3e 20 61 6e 67 6c atitude</i> angl
0ce0: 65 73 29 2e 0d 0a 3c 62 72 3e 3c 62 72 3e 3c 62 es)...<br><br><b
0cf0: 72 3e 3c 62 72 3e 0d 0a 54 68 65 20 6d 61 70 20 r><br>..The map
0d00: 6f 6e 20 74 68 65 20 72 69 67 68 74 20 73 68 6f on the right sho
0d10: 77 73 20 74 68 65 20 67 65 6f 67 72 61 70 68 69 ws the geographi
0d20: 63 20 63 6f 6e 74 65 78 74 20 6f 66 20 74 68 69 c context of thi
0d30: 73 20 66 69 72 73 74 20 4b 4e 4e 20 71 75 65 72 s first KNN quer
0d40: 79 2e 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 3c 69 6d y.</td>..<td><im
0d50: 67 20 73 72 63 3d 22 68 74 74 70 73 3a 2f 2f 77 g src="https://w
0d60: 77 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 2f 67 ww.gaia-gis.it/g
0d70: 61 69 61 2d 73 69 6e 73 2f 6b 6e 6e 2f 74 79 72 aia-sins/knn/tyr
0d80: 72 68 65 6e 69 61 6e 2d 73 65 61 2e 70 6e 67 22 rhenian-sea.png"
0d90: 20 61 6c 74 3d 22 54 79 72 72 68 65 6e 69 61 6e alt="Tyrrhenian
0da0: 20 53 65 61 22 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 Sea"></td>..</t
0db0: 61 62 6c 65 3e 3c 62 72 3e 0d 0a 3c 68 32 3e 41 able><br>..<h2>A
0dc0: 20 66 69 72 73 74 20 6e 61 69 76 65 20 28 61 6e first naive (an
0dd0: 64 20 76 65 72 79 20 69 6e 65 66 66 69 63 69 65 d very inefficie
0de0: 6e 74 29 20 61 70 70 72 6f 61 63 68 3c 2f 68 32 nt) approach</h2
0df0: 3e 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 >..<verbatim>..S
0e00: 45 4c 45 43 54 20 67 65 6f 6e 61 6d 65 69 64 2c ELECT geonameid,
0e10: 20 6e 61 6d 65 2c 20 63 6f 75 6e 74 72 79 2c 20 name, country,
0e20: 0d 0a 20 20 20 20 4d 69 6e 28 53 54 5f 44 69 73 .. Min(ST_Dis
0e30: 74 61 6e 63 65 28 4d 61 6b 65 50 6f 69 6e 74 28 tance(MakePoint(
0e40: 31 30 2c 20 34 33 29 2c 20 67 65 6f 6d 2c 20 31 10, 43), geom, 1
0e50: 29 29 20 2f 20 31 30 30 30 2e 30 20 41 53 20 64 )) / 1000.0 AS d
0e60: 69 73 74 5f 6b 6d 0d 0a 46 52 4f 4d 20 61 69 72 ist_km..FROM air
0e70: 70 6f 72 74 73 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d ports;..--------
0e80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0e90: 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 36 32 39 39 36 32 --------..629962
0ea0: 33 09 7c 20 4d 61 72 69 6e 61 20 44 69 20 43 61 3.| Marina Di Ca
0eb0: 6d 70 6f 20 7c 20 49 54 20 7c 20 33 33 2e 30 34 mpo | IT | 33.04
0ec0: 33 33 32 30 0d 0a 0d 0a 53 45 4c 45 43 54 20 67 3320....SELECT g
0ed0: 65 6f 6e 61 6d 65 69 64 2c 20 6e 61 6d 65 2c 20 eonameid, name,
0ee0: 63 6f 75 6e 74 72 79 2c 20 0d 0a 20 20 20 20 4d country, .. M
0ef0: 69 6e 28 53 54 5f 44 69 73 74 61 6e 63 65 28 4d in(ST_Distance(M
0f00: 61 6b 65 50 6f 69 6e 74 28 31 30 2c 20 34 33 29 akePoint(10, 43)
0f10: 2c 20 67 65 6f 6d 2c 20 31 29 29 20 2f 20 31 30 , geom, 1)) / 10
0f20: 30 30 2e 30 20 41 53 20 64 69 73 74 5f 6b 6d 0d 00.0 AS dist_km.
0f30: 0a 46 52 4f 4d 20 61 69 72 70 6f 72 74 73 0d 0a .FROM airports..
0f40: 57 48 45 52 45 20 67 65 6f 6e 61 6d 65 69 64 20 WHERE geonameid
0f50: 4e 4f 54 20 49 4e 20 28 36 32 39 39 36 32 33 29 NOT IN (6299623)
0f60: 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ;..-------------
0f70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0f80: 2d 2d 2d 2d 0d 0a 36 32 39 39 33 39 32 20 7c 20 ----..6299392 |
0f90: 42 61 73 74 69 61 2d 50 6f 72 65 74 74 61 20 7c Bastia-Poretta |
0fa0: 20 46 52 20 7c 20 36 35 2e 32 32 36 35 37 33 0d FR | 65.226573.
0fb0: 0a 0d 0a 53 45 4c 45 43 54 20 67 65 6f 6e 61 6d ...SELECT geonam
0fc0: 65 69 64 2c 20 6e 61 6d 65 2c 20 63 6f 75 6e 74 eid, name, count
0fd0: 72 79 2c 0d 0a 20 20 20 20 4d 69 6e 28 53 54 5f ry,.. Min(ST_
0fe0: 44 69 73 74 61 6e 63 65 28 4d 61 6b 65 50 6f 69 Distance(MakePoi
0ff0: 6e 74 28 31 30 2c 20 34 33 29 2c 20 67 65 6f 6d nt(10, 43), geom
1000: 2c 20 31 29 29 20 2f 20 31 30 30 30 2e 30 20 41 , 1)) / 1000.0 A
1010: 53 20 64 69 73 74 5f 6b 6d 0d 0a 46 52 4f 4d 20 S dist_km..FROM
1020: 61 69 72 70 6f 72 74 73 0d 0a 57 48 45 52 45 20 airports..WHERE
1030: 67 65 6f 6e 61 6d 65 69 64 20 4e 4f 54 20 49 4e geonameid NOT IN
1040: 20 28 36 32 39 39 36 32 33 2c 20 36 32 39 39 33 (6299623, 62993
1050: 39 32 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 92);..----------
1060: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1070: 2d 2d 2d 2d 2d 2d 2d 0d 0a 36 32 39 39 36 32 38 -------..6299628
1080: 20 7c 20 50 69 73 61 20 2f 20 53 2e 20 47 69 75 | Pisa / S. Giu
1090: 73 74 6f 20 7c 20 49 54 09 7c 20 38 32 2e 33 38 sto | IT.| 82.38
10a0: 37 30 31 34 0d 0a 0d 0a 53 45 4c 45 43 54 20 67 7014....SELECT g
10b0: 65 6f 6e 61 6d 65 69 64 2c 20 6e 61 6d 65 2c 20 eonameid, name,
10c0: 63 6f 75 6e 74 72 79 2c 20 0d 0a 20 20 20 20 4d country, .. M
10d0: 69 6e 28 53 54 5f 44 69 73 74 61 6e 63 65 28 4d in(ST_Distance(M
10e0: 61 6b 65 50 6f 69 6e 74 28 31 30 2c 20 34 33 29 akePoint(10, 43)
10f0: 2c 20 67 65 6f 6d 2c 20 31 29 29 20 2f 20 31 30 , geom, 1)) / 10
1100: 30 30 2e 30 20 41 53 20 64 69 73 74 5f 6b 6d 0d 00.0 AS dist_km.
1110: 0a 46 52 4f 4d 20 61 69 72 70 6f 72 74 73 0d 0a .FROM airports..
1120: 57 48 45 52 45 20 67 65 6f 6e 61 6d 65 69 64 20 WHERE geonameid
1130: 4e 4f 54 20 49 4e 20 28 36 32 39 39 36 32 33 2c NOT IN (6299623,
1140: 20 36 32 39 39 33 39 32 2c 20 36 32 39 39 36 32 6299392, 629962
1150: 38 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 8);..-----------
1160: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1170: 2d 2d 2d 2d 2d 2d 0d 0a 36 32 39 39 36 33 30 20 ------..6299630
1180: 7c 20 47 72 6f 73 73 65 74 6f 20 41 69 72 70 6f | Grosseto Airpo
1190: 72 74 20 7c 20 49 54 20 7c 20 39 31 2e 35 34 39 rt | IT | 91.549
11a0: 37 37 33 0d 0a 0d 0a 53 45 4c 45 43 54 20 67 65 773....SELECT ge
11b0: 6f 6e 61 6d 65 69 64 2c 20 6e 61 6d 65 2c 20 63 onameid, name, c
11c0: 6f 75 6e 74 72 79 2c 20 0d 0a 20 20 20 20 4d 69 ountry, .. Mi
11d0: 6e 28 53 54 5f 44 69 73 74 61 6e 63 65 28 4d 61 n(ST_Distance(Ma
11e0: 6b 65 50 6f 69 6e 74 28 31 30 2c 20 34 33 29 2c kePoint(10, 43),
11f0: 20 67 65 6f 6d 2c 20 31 29 29 20 2f 20 31 30 30 geom, 1)) / 100
1200: 30 2e 30 20 41 53 20 64 69 73 74 5f 6b 6d 0d 0a 0.0 AS dist_km..
1210: 46 52 4f 4d 20 61 69 72 70 6f 72 74 73 0d 0a 57 FROM airports..W
1220: 48 45 52 45 20 67 65 6f 6e 61 6d 65 69 64 20 4e HERE geonameid N
1230: 4f 54 20 49 4e 20 28 36 32 39 39 36 32 33 2c 20 OT IN (6299623,
1240: 36 32 39 39 33 39 32 2c 20 36 32 39 39 36 32 38 6299392, 6299628
1250: 2c 20 36 32 39 39 36 33 30 29 3b 0d 0a 2d 2d 2d , 6299630);..---
1260: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1270: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a --------------..
1280: 36 36 39 34 34 39 35 20 7c 20 43 6f 72 74 65 20 6694495 | Corte
1290: 7c 20 46 52 20 7c 20 31 30 32 2e 38 31 39 37 37 | FR | 102.81977
12a0: 38 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 8..</verbatim>..
12b0: 57 65 20 63 6f 75 6c 64 20 65 66 66 65 63 74 69 We could effecti
12c0: 76 65 6c 79 20 65 78 65 63 75 74 65 20 61 20 66 vely execute a f
12d0: 69 72 73 74 20 53 51 4c 20 71 75 65 72 79 20 75 irst SQL query u
12e0: 73 69 6e 67 20 74 68 65 20 3c 62 3e 4d 69 6e 28 sing the <b>Min(
12f0: 29 3c 2f 62 3e 20 61 67 67 72 65 67 61 74 65 20 )</b> aggregate
1300: 66 75 6e 63 74 69 6f 6e 20 69 6e 20 6f 72 64 65 function in orde
1310: 72 20 74 6f 20 69 64 65 6e 74 69 66 79 20 74 68 r to identify th
1320: 65 20 63 6c 6f 73 65 73 74 20 61 69 72 70 6f 72 e closest airpor
1330: 74 20 74 6f 20 61 6e 20 61 72 62 69 74 72 61 72 t to an arbitrar
1340: 79 20 70 6f 73 69 74 69 6f 6e 20 28 3c 69 3e 6c y position (<i>l
1350: 61 74 69 74 75 64 65 3c 2f 69 3e 3d 3c 62 3e 34 atitude</i>=<b>4
1360: 33 2e 30 3c 2f 62 3e 2c 20 3c 69 3e 6c 6f 6e 67 3.0</b>, <i>long
1370: 69 74 75 64 65 3c 2f 69 3e 3d 3c 62 3e 31 30 2e itude</i>=<b>10.
1380: 30 3c 2f 62 3e 29 20 6c 6f 63 61 74 65 64 20 69 0</b>) located i
1390: 6e 74 6f 20 74 68 65 20 6d 69 64 64 6c 65 20 6f nto the middle o
13a0: 66 20 74 68 65 20 54 79 72 72 68 65 6e 69 61 6e f the Tyrrhenian
13b0: 20 53 65 61 2e 3c 62 72 3e 0d 0a 54 68 65 6e 20 Sea.<br>..Then
13c0: 77 65 20 63 6f 75 6c 64 20 65 76 65 6e 74 75 61 we could eventua
13d0: 6c 6c 79 20 72 65 70 65 61 74 20 6d 6f 72 65 20 lly repeat more
13e0: 74 69 6d 65 73 20 74 68 65 20 73 61 6d 65 20 69 times the same i
13f0: 64 65 6e 74 69 63 61 6c 20 71 75 65 72 79 2c 20 dentical query,
1400: 65 61 63 68 20 74 69 6d 65 20 65 78 63 6c 75 64 each time exclud
1410: 69 6e 67 20 61 6c 6c 20 61 69 72 70 6f 72 74 73 ing all airports
1420: 20 77 65 27 76 65 20 61 6c 72 65 61 64 79 20 69 we've already i
1430: 64 65 6e 74 69 66 69 65 64 20 69 6e 20 74 68 65 dentified in the
1440: 20 70 72 65 76 69 6f 75 73 20 70 72 6f 63 65 73 previous proces
1450: 73 69 6e 67 20 73 74 65 70 73 2e 3c 62 72 3e 0d sing steps.<br>.
1460: 0a 54 68 65 20 66 69 6e 61 6c 20 72 65 73 75 6c .The final resul
1470: 74 20 77 69 6c 6c 20 62 65 20 74 68 65 20 66 75 t will be the fu
1480: 6c 6c 20 6c 69 73 74 20 6f 66 20 74 68 65 20 66 ll list of the f
1490: 69 72 73 74 20 66 69 76 65 20 61 69 72 70 6f 72 irst five airpor
14a0: 74 73 20 63 6c 6f 73 65 73 74 20 74 6f 20 74 68 ts closest to th
14b0: 65 20 72 65 66 65 72 65 6e 63 65 20 6c 6f 63 61 e reference loca
14c0: 74 69 6f 6e 20 6f 72 64 65 72 65 64 20 62 79 20 tion ordered by
14d0: 69 6e 63 72 65 61 73 69 6e 67 20 64 69 73 74 61 increasing dista
14e0: 6e 63 65 2e 0d 0a 3c 62 72 3e 3c 62 72 3e 0d 0a nce...<br><br>..
14f0: 3c 74 61 62 6c 65 20 62 67 63 6f 6c 6f 72 3d 22 <table bgcolor="
1500: 23 64 30 66 66 62 30 22 20 63 65 6c 6c 73 70 61 #d0ffb0" cellspa
1510: 63 69 6e 67 3d 22 34 22 20 63 65 6c 6c 70 61 64 cing="4" cellpad
1520: 64 69 6e 67 3d 22 34 22 20 62 6f 72 64 65 72 3d ding="4" border=
1530: 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 64 20 62 67 "1">..<tr><td bg
1540: 63 6f 6c 6f 72 3d 22 23 63 30 64 64 61 6f 22 3e color="#c0ddao">
1550: 3c 62 3e 72 61 6e 6b 3c 2f 62 3e 3c 2f 74 64 3e <b>rank</b></td>
1560: 3c 74 64 20 62 67 63 6f 6c 6f 72 3d 22 23 63 30 <td bgcolor="#c0
1570: 64 64 61 6f 22 3e 3c 62 3e 67 65 6f 6e 61 6d 65 ddao"><b>geoname
1580: 69 64 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 64 20 62 id</b></td><td b
1590: 67 63 6f 6c 6f 72 3d 22 23 63 30 64 64 61 6f 22 gcolor="#c0ddao"
15a0: 3e 3c 62 3e 6e 61 6d 65 3c 2f 62 3e 3c 2f 74 64 ><b>name</b></td
15b0: 3e 3c 74 64 20 62 67 63 6f 6c 6f 72 3d 22 23 63 ><td bgcolor="#c
15c0: 30 64 64 61 6f 22 3e 3c 62 3e 63 6f 75 6e 74 72 0ddao"><b>countr
15d0: 79 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 64 20 62 67 y</b></td><td bg
15e0: 63 6f 6c 6f 72 3d 22 23 63 30 64 64 61 6f 22 3e color="#c0ddao">
15f0: 3c 62 3e 64 69 73 74 5f 6b 6d 3c 2f 62 3e 3c 2f <b>dist_km</b></
1600: 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 td></tr>..<tr><t
1610: 64 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e d align="right">
1620: 31 3c 2f 74 64 3e 3c 74 64 20 61 6c 69 67 6e 3d 1</td><td align=
1630: 22 72 69 67 68 74 22 3e 36 32 39 39 36 32 33 3c "right">6299623<
1640: 2f 74 64 3e 3c 74 64 3e 4d 61 72 69 6e 61 20 44 /td><td>Marina D
1650: 69 20 43 61 6d 70 6f 3c 2f 74 64 3e 3c 74 64 3e i Campo</td><td>
1660: 49 54 3c 2f 74 64 3e 3c 74 64 20 61 6c 69 67 6e IT</td><td align
1670: 3d 22 72 69 67 68 74 22 3e 33 33 2e 30 34 33 33 ="right">33.0433
1680: 32 30 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 20</td></tr>..<t
1690: 72 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 r><td align="rig
16a0: 68 74 22 3e 32 3c 2f 74 64 3e 3c 74 64 20 61 6c ht">2</td><td al
16b0: 69 67 6e 3d 22 72 69 67 68 74 22 3e 36 32 39 39 ign="right">6299
16c0: 33 39 32 3c 2f 74 64 3e 3c 74 64 3e 42 61 73 74 392</td><td>Bast
16d0: 69 61 2d 50 6f 72 65 74 74 61 3c 2f 74 64 3e 3c ia-Poretta</td><
16e0: 74 64 3e 46 52 3c 2f 74 64 3e 3c 74 64 20 61 6c td>FR</td><td al
16f0: 69 67 6e 3d 22 72 69 67 68 74 22 3e 36 35 2e 32 ign="right">65.2
1700: 32 36 35 37 33 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 26573</td></tr>.
1710: 0a 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 .<tr><td align="
1720: 72 69 67 68 74 22 3e 33 3c 2f 74 64 3e 3c 74 64 right">3</td><td
1730: 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 36 align="right">6
1740: 32 39 39 36 32 38 3c 2f 74 64 3e 3c 74 64 3e 50 299628</td><td>P
1750: 69 73 61 20 2f 20 53 2e 20 47 69 75 73 74 6f 3c isa / S. Giusto<
1760: 2f 74 64 3e 3c 74 64 3e 49 54 3c 2f 74 64 3e 3c /td><td>IT</td><
1770: 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 td align="right"
1780: 3e 38 32 2e 33 38 37 30 31 34 3c 2f 74 64 3e 3c >82.387014</td><
1790: 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 20 61 6c /tr>..<tr><td al
17a0: 69 67 6e 3d 22 72 69 67 68 74 22 3e 34 3c 2f 74 ign="right">4</t
17b0: 64 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 d><td align="rig
17c0: 68 74 22 3e 36 32 39 39 36 33 30 3c 2f 74 64 3e ht">6299630</td>
17d0: 3c 74 64 3e 47 72 6f 73 73 65 74 6f 20 41 69 72 <td>Grosseto Air
17e0: 70 6f 72 74 3c 2f 74 64 3e 3c 74 64 3e 49 54 3c port</td><td>IT<
17f0: 2f 74 64 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72 /td><td align="r
1800: 69 67 68 74 22 3e 39 31 2e 35 34 39 37 37 33 3c ight">91.549773<
1810: 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c /td></tr>..<tr><
1820: 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 td align="right"
1830: 3e 35 3c 2f 74 64 3e 3c 74 64 20 61 6c 69 67 6e >5</td><td align
1840: 3d 22 72 69 67 68 74 22 3e 36 36 39 34 34 39 35 ="right">6694495
1850: 3c 2f 74 64 3e 3c 74 64 3e 43 6f 72 74 65 3c 2f </td><td>Corte</
1860: 74 64 3e 3c 74 64 3e 46 52 3c 2f 74 64 3e 3c 74 td><td>FR</td><t
1870: 64 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e d align="right">
1880: 31 30 32 2e 38 31 39 37 37 38 3c 2f 74 64 3e 3c 102.819778</td><
1890: 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 /tr>..</table><b
18a0: 72 3e 0d 0a 53 75 63 68 20 61 20 6e 61 69 76 65 r>..Such a naive
18b0: 20 61 70 70 72 6f 61 63 68 20 77 69 6c 6c 20 73 approach will s
18c0: 75 72 65 6c 79 20 62 65 20 68 69 67 68 6c 79 20 urely be highly
18d0: 69 6d 70 72 61 63 74 69 63 61 6c 2c 20 62 65 63 impractical, bec
18e0: 61 75 73 65 20 69 74 20 73 74 72 69 63 74 6c 79 ause it strictly
18f0: 20 72 65 71 75 69 72 65 73 20 74 6f 20 68 61 6e requires to han
1900: 64 2d 77 72 69 74 65 20 73 65 76 65 72 61 6c 20 d-write several
1910: 3c 69 3e 61 64 20 68 6f 63 3c 2f 69 3e 20 53 51 <i>ad hoc</i> SQ
1920: 4c 20 71 75 65 72 69 65 73 20 6f 6e 65 20 62 79 L queries one by
1930: 20 6f 6e 65 2e 3c 62 72 3e 0d 0a 57 72 69 74 69 one.<br>..Writi
1940: 6e 67 20 61 20 66 75 6c 6c 79 20 61 75 74 6f 6d ng a fully autom
1950: 61 74 65 64 20 53 51 4c 20 73 63 72 69 70 74 20 ated SQL script
1960: 69 73 6e 27 74 20 61 74 20 61 6c 6c 20 61 20 73 isn't at all a s
1970: 69 6d 70 6c 65 20 74 61 73 6b 2c 20 61 6e 64 20 imple task, and
1980: 73 6f 6d 65 20 6b 69 6e 64 20 6f 66 20 68 69 67 some kind of hig
1990: 68 65 72 20 6c 65 76 65 6c 20 73 63 72 69 70 74 her level script
19a0: 69 6e 67 20 28 65 2e 67 2e 20 50 79 74 68 6f 6e ing (e.g. Python
19b0: 29 20 77 6f 75 6c 64 20 62 65 20 65 61 73 69 6c ) would be easil
19c0: 79 20 72 65 71 75 69 72 65 64 20 69 6e 20 61 6e y required in an
19d0: 79 20 72 65 61 6c 69 73 74 69 63 20 73 63 65 6e y realistic scen
19e0: 61 72 69 6f 2e 3c 62 72 3e 0d 0a 41 6e 79 77 61 ario.<br>..Anywa
19f0: 79 20 61 75 74 6f 6d 61 74 69 6e 67 20 73 6f 6d y automating som
1a00: 65 77 61 79 20 61 6c 6c 20 72 65 71 75 69 72 65 eway all require
1a10: 64 20 53 51 4c 20 71 75 65 72 69 65 73 20 69 73 d SQL queries is
1a20: 6e 27 74 20 74 68 65 20 6d 6f 73 74 20 63 72 69 n't the most cri
1a30: 74 69 63 61 6c 20 69 73 73 75 65 20 77 65 20 68 tical issue we h
1a40: 61 76 65 20 74 6f 20 66 61 63 65 3b 20 74 68 65 ave to face; the
1a50: 20 72 65 61 6c 20 63 72 69 74 69 63 61 6c 20 62 real critical b
1a60: 6f 74 74 6c 65 20 6e 65 63 6b 20 69 6e 20 74 68 ottle neck in th
1a70: 69 73 20 74 6f 6f 20 6d 75 63 68 20 6e 61 69 76 is too much naiv
1a80: 65 20 61 70 70 72 6f 61 63 68 20 69 73 20 74 68 e approach is th
1a90: 61 74 20 65 61 63 68 20 73 69 6e 67 6c 65 20 71 at each single q
1aa0: 75 65 72 79 20 77 69 6c 6c 20 6e 65 63 65 73 73 uery will necess
1ab0: 61 72 69 6c 79 20 70 65 72 66 6f 72 6d 20 61 6e arily perform an
1ac0: 20 61 77 66 75 6c 6c 20 3c 61 20 68 72 65 66 3d awfull <a href=
1ad0: 22 68 74 74 70 73 3a 2f 2f 65 6e 2e 77 69 6b 69 "https://en.wiki
1ae0: 70 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 46 pedia.org/wiki/F
1af0: 75 6c 6c 5f 74 61 62 6c 65 5f 73 63 61 6e 22 3e ull_table_scan">
1b00: 66 75 6c 6c 20 74 61 62 6c 65 20 73 63 61 6e 3c full table scan<
1b10: 2f 61 3e 3c 62 72 3e 0d 0a 54 68 69 73 20 77 69 /a><br>..This wi
1b20: 6c 6c 20 64 69 72 65 63 74 6c 79 20 63 61 75 73 ll directly caus
1b30: 65 20 62 61 72 65 6c 79 20 74 6f 6c 65 72 61 62 e barely tolerab
1b40: 6c 65 20 73 6c 75 67 67 69 73 68 20 70 65 72 66 le sluggish perf
1b50: 6f 72 6d 61 6e 63 65 73 2c 20 61 6e 64 20 74 68 ormances, and th
1b60: 65 20 6f 76 65 72 61 6c 6c 20 70 65 72 66 6f 72 e overall perfor
1b70: 6d 61 6e 63 65 20 77 69 6c 6c 20 71 75 69 63 6b mance will quick
1b80: 6c 79 20 64 65 67 72 61 64 61 74 65 20 61 73 20 ly degradate as
1b90: 74 68 65 20 64 61 74 61 73 65 74 20 73 69 7a 65 the dataset size
1ba0: 20 77 69 6c 6c 20 70 72 6f 67 72 65 73 73 69 76 will progressiv
1bb0: 65 6c 79 20 69 6e 63 72 65 61 73 65 2e 3c 62 72 ely increase.<br
1bc0: 3e 3c 62 72 3e 0d 0a 3c 62 3e 43 6f 6e 63 6c 75 ><br>..<b>Conclu
1bd0: 73 69 6f 6e 3c 2f 62 3e 3a 3c 62 72 3e 0d 0a 53 sion</b>:<br>..S
1be0: 6f 6d 65 20 73 69 6d 70 6c 65 72 20 61 6e 64 20 ome simpler and
1bf0: 73 6d 61 72 74 65 72 20 61 70 70 72 6f 61 63 68 smarter approach
1c00: 20 69 73 20 73 75 72 65 6c 79 20 72 65 71 75 69 is surely requi
1c10: 72 65 64 3a 20 70 6f 73 73 69 62 6c 79 20 6f 6e red: possibly on
1c20: 65 20 74 61 6b 69 6e 67 20 66 75 6c 6c 20 70 72 e taking full pr
1c30: 6f 66 69 74 20 66 72 6f 6d 20 61 6e 20 3c 62 3e ofit from an <b>
1c40: 52 2a 54 52 65 65 20 53 70 61 74 69 61 6c 20 49 R*TRee Spatial I
1c50: 6e 64 65 78 3c 2f 62 3e 20 73 75 70 70 6f 72 74 ndex</b> support
1c60: 69 6e 67 20 74 68 65 20 47 65 6f 6d 65 74 72 69 ing the Geometri
1c70: 65 73 20 74 6f 20 62 65 20 73 65 61 72 63 68 65 es to be searche
1c80: 64 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 68 72 3e d.<br><br>..<hr>
1c90: 0d 0a 3c 68 32 3e 56 69 72 74 75 61 6c 4b 4e 4e ..<h2>VirtualKNN
1ca0: 3c 2f 68 32 3e 0d 0a 53 74 61 72 74 69 6e 67 20 </h2>..Starting
1cb0: 73 69 6e 63 65 20 76 65 72 73 69 6f 6e 20 3c 62 since version <b
1cc0: 3e 34 2e 34 2e 30 3c 2f 62 3e 20 53 70 61 74 69 >4.4.0</b> Spati
1cd0: 61 4c 69 74 65 20 73 75 70 70 6f 72 74 73 20 61 aLite supports a
1ce0: 20 3c 62 3e 56 69 72 74 75 61 6c 4b 4e 4e 3c 2f <b>VirtualKNN</
1cf0: 62 3e 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 b> <a href="http
1d00: 73 3a 2f 2f 77 77 77 2e 73 71 6c 69 74 65 2e 6f s://www.sqlite.o
1d10: 72 67 2f 76 74 61 62 2e 68 74 6d 6c 22 3e 56 69 rg/vtab.html">Vi
1d20: 72 74 75 61 6c 20 54 61 62 6c 65 3c 2f 61 3e 20 rtual Table</a>
1d30: 73 70 65 63 69 66 69 63 61 6c 6c 79 20 69 6e 74 specifically int
1d40: 65 6e 64 65 64 20 61 73 20 61 20 63 6f 6d 70 6c ended as a compl
1d50: 65 74 65 20 61 6e 64 20 68 69 67 68 6c 79 20 65 ete and highly e
1d60: 66 66 69 63 69 65 6e 74 20 73 6f 6c 75 74 69 6f fficient solutio
1d70: 6e 20 74 6f 20 74 68 65 20 3c 62 3e 4b 4e 4e 3c n to the <b>KNN<
1d80: 2f 62 3e 20 70 72 6f 62 6c 65 6d 2e 0d 0a 3c 76 /b> problem...<v
1d90: 65 72 62 61 74 69 6d 3e 0d 0a 43 52 45 41 54 45 erbatim>..CREATE
1da0: 20 56 49 52 54 55 41 4c 20 54 41 42 4c 45 20 6b VIRTUAL TABLE k
1db0: 6e 6e 20 55 53 49 4e 47 20 56 69 72 74 75 61 6c nn USING Virtual
1dc0: 4b 4e 4e 28 29 3b 0d 0a 3c 2f 76 65 72 62 61 74 KNN();..</verbat
1dd0: 69 6d 3e 0d 0a 45 76 65 72 79 20 6e 65 77 20 64 im>..Every new d
1de0: 62 2d 66 69 6c 65 20 62 65 69 6e 67 20 63 72 65 b-file being cre
1df0: 61 74 65 64 20 62 79 20 3c 62 3e 34 2e 34 2e 30 ated by <b>4.4.0
1e00: 3c 2f 62 3e 20 69 74 73 65 6c 66 20 77 69 6c 6c </b> itself will
1e10: 20 61 6c 77 61 79 73 20 61 75 74 6f 6d 61 74 69 always automati
1e20: 63 61 6c 6c 79 20 64 65 66 69 6e 65 20 61 20 3c cally define a <
1e30: 62 3e 4b 4e 4e 3c 2f 62 3e 20 76 69 72 74 75 61 b>KNN</b> virtua
1e40: 6c 20 74 61 62 6c 65 2e 3c 62 72 3e 0d 0a 59 6f l table.<br>..Yo
1e50: 75 20 63 6f 75 6c 64 20 65 76 65 6e 74 75 61 6c u could eventual
1e60: 6c 79 20 61 64 64 20 66 75 6c 6c 20 4b 4e 4e 20 ly add full KNN
1e70: 73 75 70 70 6f 72 74 20 74 6f 20 61 6e 79 20 64 support to any d
1e80: 62 2d 66 69 6c 65 20 63 72 65 61 74 65 64 20 62 b-file created b
1e90: 79 20 61 6e 79 20 65 61 72 6c 69 65 72 20 76 65 y any earlier ve
1ea0: 72 73 69 6f 6e 20 6f 66 20 53 70 61 74 69 61 4c rsion of SpatiaL
1eb0: 69 74 65 20 62 79 20 6d 61 6e 75 61 6c 6c 79 20 ite by manually
1ec0: 65 78 65 63 75 74 69 6e 67 20 74 68 65 20 61 62 executing the ab
1ed0: 6f 76 65 20 53 51 4c 20 73 74 61 74 65 6d 65 6e ove SQL statemen
1ee0: 74 2e 3c 62 72 3e 0d 0a 3c 62 3e 4e 6f 74 65 3c t.<br>..<b>Note<
1ef0: 2f 62 3e 3a 20 56 69 72 74 75 61 6c 4b 4e 4e 20 /b>: VirtualKNN
1f00: 6e 65 63 65 73 73 61 72 69 6c 79 20 72 65 71 75 necessarily requ
1f10: 69 72 65 73 20 34 2e 34 2e 30 20 62 69 6e 61 72 ires 4.4.0 binar
1f20: 79 20 73 75 70 70 6f 72 74 2c 20 73 6f 20 61 6e y support, so an
1f30: 79 20 61 74 74 65 6d 70 74 20 74 6f 20 6f 70 65 y attempt to ope
1f40: 6e 20 61 20 64 62 2d 66 69 6c 65 20 69 6e 63 6c n a db-file incl
1f50: 75 64 69 6e 67 20 61 20 56 69 72 74 75 61 6c 4b uding a VirtualK
1f60: 4e 4e 20 74 61 62 6c 65 20 62 79 20 75 73 69 6e NN table by usin
1f70: 67 20 73 6f 6d 65 20 70 72 65 76 69 6f 79 73 20 g some previoys
1f80: 76 65 72 73 69 6f 6e 20 28 3c 3d 20 3c 62 3e 34 version (<= <b>4
1f90: 2e 33 2e 30 61 3c 2f 62 3e 29 20 77 69 6c 6c 20 .3.0a</b>) will
1fa0: 73 75 72 65 6c 79 20 72 61 69 73 65 20 61 6e 20 surely raise an
1fb0: 65 72 72 6f 72 20 63 6f 6e 64 69 74 69 6f 6e 2e error condition.
1fc0: 0d 0a 3c 68 33 3e 41 20 66 69 72 73 74 20 62 61 ..<h3>A first ba
1fd0: 73 69 63 61 6c 6c 79 20 73 69 6d 70 6c 65 20 4b sically simple K
1fe0: 4e 4e 20 71 75 65 72 79 3c 2f 68 33 3e 0d 0a 3c NN query</h3>..<
1ff0: 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 verbatim>..SELEC
2000: 54 20 2a 20 46 52 4f 4d 20 6b 6e 6e 0d 0a 57 48 T * FROM knn..WH
2010: 45 52 45 20 66 5f 74 61 62 6c 65 5f 6e 61 6d 65 ERE f_table_name
2020: 20 3d 20 27 61 69 72 70 6f 72 74 73 27 20 41 4e = 'airports' AN
2030: 44 20 72 65 66 5f 67 65 6f 6d 65 74 72 79 20 3d D ref_geometry =
2040: 20 4d 61 6b 65 50 6f 69 6e 74 28 31 30 2c 20 34 MakePoint(10, 4
2050: 33 29 3b 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 3);..</verbatim>
2060: 0d 0a 3c 74 61 62 6c 65 20 62 67 63 6f 6c 6f 72 ..<table bgcolor
2070: 3d 22 23 64 30 66 66 62 30 22 20 63 65 6c 6c 73 ="#d0ffb0" cells
2080: 70 61 63 69 6e 67 3d 22 34 22 20 63 65 6c 6c 70 pacing="4" cellp
2090: 61 64 64 69 6e 67 3d 22 34 22 20 62 6f 72 64 65 adding="4" borde
20a0: 72 3d 22 31 22 3e 0d 0a 3c 74 72 3e 3c 74 64 20 r="1">..<tr><td
20b0: 62 67 63 6f 6c 6f 72 3d 22 23 63 30 64 64 61 6f bgcolor="#c0ddao
20c0: 22 3e 3c 62 3e 66 5f 74 61 62 6c 65 5f 6e 61 6d "><b>f_table_nam
20d0: 65 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 64 20 62 67 e</b></td><td bg
20e0: 63 6f 6c 6f 72 3d 22 23 63 30 64 64 61 6f 22 3e color="#c0ddao">
20f0: 3c 62 3e 66 5f 67 65 6f 6d 65 74 72 79 5f 63 6f <b>f_geometry_co
2100: 6c 75 6d 6e 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 64 lumn</b></td><td
2110: 20 62 67 63 6f 6c 6f 72 3d 22 23 63 30 64 64 61 bgcolor="#c0dda
2120: 6f 22 3e 3c 62 3e 72 65 66 5f 67 65 6f 6d 65 74 o"><b>ref_geomet
2130: 72 79 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 64 20 62 ry</b></td><td b
2140: 67 63 6f 6c 6f 72 3d 22 23 63 30 64 64 61 6f 22 gcolor="#c0ddao"
2150: 3e 3c 62 3e 6d 61 78 5f 69 74 65 6d 73 3c 2f 62 ><b>max_items</b
2160: 3e 3c 2f 74 64 3e 3c 74 64 20 62 67 63 6f 6c 6f ></td><td bgcolo
2170: 72 3d 22 23 63 30 64 64 61 6f 22 3e 3c 62 3e 70 r="#c0ddao"><b>p
2180: 6f 73 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 64 20 62 os</b></td><td b
2190: 67 63 6f 6c 6f 72 3d 22 23 63 30 64 64 61 6f 22 gcolor="#c0ddao"
21a0: 3e 3c 62 3e 66 69 64 3c 2f 62 3e 3c 2f 74 64 3e ><b>fid</b></td>
21b0: 3c 74 64 20 62 67 63 6f 6c 6f 72 3d 22 23 63 30 <td bgcolor="#c0
21c0: 64 64 61 6f 22 3e 3c 62 3e 64 69 73 74 61 6e 63 ddao"><b>distanc
21d0: 65 3c 2f 62 3e 3c 2f 74 64 3e 3c 2f 74 72 3e 0d e</b></td></tr>.
21e0: 0a 3c 74 72 3e 3c 74 64 3e 61 69 72 70 6f 72 74 .<tr><td>airport
21f0: 73 3c 2f 74 64 3e 3c 74 64 3e 67 65 6f 6d 3c 2f s</td><td>geom</
2200: 74 64 3e 3c 74 64 3e 42 4c 4f 42 20 73 7a 3d 36 td><td>BLOB sz=6
2210: 30 20 47 45 4f 4d 45 54 52 59 3c 2f 74 64 3e 3c 0 GEOMETRY</td><
2220: 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 td align="right"
2230: 3e 33 3c 2f 74 64 3e 3c 74 64 20 61 6c 69 67 6e >3</td><td align
2240: 3d 22 72 69 67 68 74 22 3e 31 3c 2f 74 64 3e 3c ="right">1</td><
2250: 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 td align="right"
2260: 3e 36 32 39 39 36 32 33 3c 2f 74 64 3e 3c 74 64 >6299623</td><td
2270: 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 33 align="right">3
2280: 33 30 34 33 2e 33 31 39 35 32 30 3c 2f 74 64 3e 3043.319520</td>
2290: 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 3e 61 </tr>..<tr><td>a
22a0: 69 72 70 6f 72 74 73 3c 2f 74 64 3e 3c 74 64 3e irports</td><td>
22b0: 67 65 6f 6d 3c 2f 74 64 3e 3c 74 64 3e 42 4c 4f geom</td><td>BLO
22c0: 42 20 73 7a 3d 36 30 20 47 45 4f 4d 45 54 52 59 B sz=60 GEOMETRY
22d0: 3c 2f 74 64 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 </td><td align="
22e0: 72 69 67 68 74 22 3e 33 3c 2f 74 64 3e 3c 74 64 right">3</td><td
22f0: 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 32 align="right">2
2300: 3c 2f 74 64 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 </td><td align="
2310: 72 69 67 68 74 22 3e 36 32 39 39 33 39 32 3c 2f right">6299392</
2320: 74 64 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72 69 td><td align="ri
2330: 67 68 74 22 3e 36 35 32 32 36 2e 35 37 33 31 34 ght">65226.57314
2340: 39 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 9</td></tr>..<tr
2350: 3e 3c 74 64 3e 61 69 72 70 6f 72 74 73 3c 2f 74 ><td>airports</t
2360: 64 3e 3c 74 64 3e 67 65 6f 6d 3c 2f 74 64 3e 3c d><td>geom</td><
2370: 74 64 3e 42 4c 4f 42 20 73 7a 3d 36 30 20 47 45 td>BLOB sz=60 GE
2380: 4f 4d 45 54 52 59 3c 2f 74 64 3e 3c 74 64 20 61 OMETRY</td><td a
2390: 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 33 3c 2f lign="right">3</
23a0: 74 64 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72 69 td><td align="ri
23b0: 67 68 74 22 3e 33 3c 2f 74 64 3e 3c 74 64 20 61 ght">3</td><td a
23c0: 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 36 32 39 lign="right">629
23d0: 39 36 32 38 3c 2f 74 64 3e 3c 74 64 20 61 6c 69 9628</td><td ali
23e0: 67 6e 3d 22 72 69 67 68 74 22 3e 38 32 33 38 37 gn="right">82387
23f0: 2e 30 31 34 30 32 38 3c 2f 74 64 3e 3c 2f 74 72 .014028</td></tr
2400: 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d >..</table><br>.
2410: 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 61 20 56 69 72 .<ul>..<li>a Vir
2420: 74 75 61 6c 4b 4e 4e 20 71 75 65 72 79 20 63 6c tualKNN query cl
2430: 6f 73 65 6c 79 20 72 65 73 65 6d 62 6c 65 73 20 osely resembles
2440: 61 20 56 69 72 74 75 61 6c 53 70 61 74 69 61 6c a VirtualSpatial
2450: 49 6e 64 65 78 20 71 75 65 72 79 2e 0d 0a 54 68 Index query...Th
2460: 69 73 20 73 68 6f 75 6c 64 20 6e 6f 74 20 73 75 is should not su
2470: 72 70 72 69 73 65 20 74 6f 6f 20 6d 75 63 68 2c rprise too much,
2480: 20 62 65 63 61 75 73 65 20 62 6f 74 68 20 74 68 because both th
2490: 65 6d 20 61 72 65 20 69 6e 74 65 6e 64 65 64 20 em are intended
24a0: 74 6f 20 62 65 20 77 72 61 70 70 65 64 20 61 72 to be wrapped ar
24b0: 6f 75 6e 64 20 61 6e 20 75 6e 64 65 72 6c 79 69 ound an underlyi
24c0: 6e 67 20 3c 62 3e 52 2a 54 72 65 65 20 53 70 61 ng <b>R*Tree Spa
24d0: 74 69 61 6c 20 49 6e 64 65 78 3c 2f 62 3e 2e 3c tial Index</b>.<
24e0: 2f 6c 69 3e 20 0d 0a 3c 6c 69 3e 41 6e 79 20 76 /li> ..<li>Any v
24f0: 61 6c 69 64 20 56 69 72 74 75 61 6c 4b 4e 4e 20 alid VirtualKNN
2500: 71 75 65 72 79 20 73 68 6f 75 6c 64 20 6e 65 63 query should nec
2510: 65 73 73 61 72 69 6c 79 20 68 61 76 65 20 61 20 essarily have a
2520: 66 6f 72 6d 20 6c 69 6b 65 3a 0d 0a 3c 62 3e 57 form like:..<b>W
2530: 48 45 52 45 20 3c 69 3e 6b 6e 6e 2d 63 6f 6c 75 HERE <i>knn-colu
2540: 6d 6e 3c 2f 69 3e 20 3d 20 3c 69 3e 76 61 6c 75 mn</i> = <i>valu
2550: 65 3c 2f 69 3e 20 41 4e 44 20 3c 69 3e 6b 6e 6e e</i> AND <i>knn
2560: 2d 63 6f 6c 75 6d 6e 3c 2f 69 3e 20 3d 20 3c 69 -column</i> = <i
2570: 3e 76 61 6c 75 65 3c 2f 69 3e 20 2e 2e 2e 3c 2f >value</i> ...</
2580: 62 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74 68 65 b></li>..<li>the
2590: 20 69 6e 70 75 74 20 63 6f 6c 75 6d 6e 73 20 28 input columns (
25a0: 74 68 65 20 6f 6e 65 73 20 79 6f 75 20 63 61 6e the ones you can
25b0: 20 72 65 66 65 72 65 6e 63 65 20 69 6e 74 6f 20 reference into
25c0: 61 20 3c 62 3e 57 48 45 52 45 3c 2f 62 3e 20 63 a <b>WHERE</b> c
25d0: 6c 61 75 73 65 29 20 61 72 65 3a 0d 0a 3c 75 6c lause) are:..<ul
25e0: 3e 0d 0a 3c 6c 69 3e 3c 62 3e 66 5f 74 61 62 6c >..<li><b>f_tabl
25f0: 65 5f 6e 61 6d 65 3c 2f 62 3e 20 28 3c 69 3e 6d e_name</b> (<i>m
2600: 61 6e 64 61 74 6f 72 79 3c 2f 69 3e 29 3c 62 72 andatory</i>)<br
2610: 3e 0d 0a 6e 61 6d 65 20 6f 66 20 74 68 65 20 47 >..name of the G
2620: 65 6f 54 61 62 6c 65 20 63 6f 6e 74 61 69 6e 69 eoTable containi
2630: 6e 67 20 74 68 65 20 47 65 6f 6d 65 74 72 69 65 ng the Geometrie
2640: 73 20 74 6f 20 62 65 20 73 65 61 72 63 68 65 64 s to be searched
2650: 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 66 .</li>..<li><b>f
2660: 5f 67 65 6f 6d 65 74 72 79 5f 63 6f 6c 75 6d 6e _geometry_column
2670: 3c 2f 62 3e 20 28 3c 69 3e 6f 70 74 69 6f 6e 61 </b> (<i>optiona
2680: 6c 3c 2f 69 3e 29 3c 62 72 3e 0d 0a 6e 61 6d 65 l</i>)<br>..name
2690: 20 6f 66 20 74 68 65 20 63 6f 6c 75 6d 6e 20 6f of the column o
26a0: 66 20 74 68 65 20 61 62 6f 76 65 20 74 61 62 6c f the above tabl
26b0: 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 e containing the
26c0: 20 47 65 6f 6d 65 74 72 69 65 73 20 74 6f 20 62 Geometries to b
26d0: 65 20 73 65 61 72 63 68 65 64 2e 0d 0a 3c 6f 6c e searched...<ol
26e0: 3e 0d 0a 3c 6c 69 3e 49 66 20 74 68 65 20 74 61 >..<li>If the ta
26f0: 62 6c 65 20 69 64 65 6e 74 69 66 69 65 64 20 62 ble identified b
2700: 79 20 3c 62 3e 66 5f 74 61 62 6c 65 5f 6e 61 6d y <b>f_table_nam
2710: 65 3c 2f 62 3e 20 6a 75 73 74 20 63 6f 6e 74 61 e</b> just conta
2720: 69 6e 73 20 61 20 73 69 6e 67 6c 65 20 47 65 6f ins a single Geo
2730: 6d 65 74 72 79 20 63 6f 6c 75 6d 6e 20 79 6f 75 metry column you
2740: 20 63 61 6e 20 73 61 66 65 6c 79 20 6f 6d 69 74 can safely omit
2750: 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 65 20 to specify the
2760: 3c 62 3e 66 5f 67 65 6f 6d 65 74 72 79 5f 63 6f <b>f_geometry_co
2770: 6c 75 6d 6e 3c 2f 62 3e 20 61 72 67 75 6d 65 6e lumn</b> argumen
2780: 74 20 28 69 74 20 77 69 6c 6c 20 62 65 20 61 75 t (it will be au
2790: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 73 65 74 29 tomatically set)
27a0: 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 49 66 20 69 .</li>..<li>If i
27b0: 6e 73 74 65 61 64 20 74 68 65 20 74 61 62 6c 65 nstead the table
27c0: 20 69 64 65 6e 74 69 66 69 65 64 20 62 79 20 3c identified by <
27d0: 62 3e 66 5f 74 61 62 6c 65 5f 6e 61 6d 65 3c 2f b>f_table_name</
27e0: 62 3e 20 63 6f 6e 74 61 69 6e 73 20 74 77 6f 20 b> contains two
27f0: 28 6f 72 20 6d 6f 72 65 29 20 47 65 6f 6d 65 74 (or more) Geomet
2800: 72 79 20 63 6f 6c 75 6d 6e 73 20 65 78 70 6c 69 ry columns expli
2810: 63 69 74 6c 79 20 73 70 65 63 69 66 79 69 6e 67 citly specifying
2820: 20 74 68 65 20 3c 62 3e 66 5f 67 65 6f 6d 65 74 the <b>f_geomet
2830: 72 79 5f 63 6f 6c 75 6d 6e 3c 2f 62 3e 20 61 72 ry_column</b> ar
2840: 67 75 6d 65 6e 74 20 69 73 20 73 74 72 69 63 74 gument is strict
2850: 6c 79 20 72 65 71 75 69 72 65 64 2c 20 73 6f 20 ly required, so
2860: 74 6f 20 67 65 74 20 61 6e 20 75 6e 61 6d 62 69 to get an unambi
2870: 67 75 6f 73 20 64 65 66 69 6e 69 74 69 6f 6e 20 guos definition
2880: 6f 66 20 74 68 65 20 69 6e 74 65 6e 64 65 64 20 of the intended
2890: 73 65 61 72 63 68 20 63 6f 6e 74 65 78 74 2e 3c search context.<
28a0: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 49 6e 20 61 6e 79 /li>..<li>In any
28b0: 20 63 61 73 65 20 3c 62 3e 66 5f 74 61 62 6c 65 case <b>f_table
28c0: 5f 6e 61 6d 65 3c 2f 62 3e 20 61 6e 64 20 3c 62 _name</b> and <b
28d0: 3e 66 5f 67 65 6f 6d 65 74 72 79 5f 63 6f 6c 75 >f_geometry_colu
28e0: 6d 6e 3c 2f 62 3e 20 6d 75 73 74 20 65 78 65 63 mn</b> must exec
28f0: 74 6c 79 20 6d 61 74 63 68 20 61 20 70 72 6f 70 tly match a prop
2900: 65 72 6c 79 20 64 65 66 69 6e 65 64 20 47 65 6f erly defined Geo
2910: 6d 65 74 72 79 20 63 6f 6c 75 6d 6e 20 73 75 70 metry column sup
2920: 70 6f 72 74 65 64 20 62 79 20 61 20 63 6f 72 72 ported by a corr
2930: 65 73 70 6f 6e 64 69 6e 67 20 53 70 61 74 69 61 esponding Spatia
2940: 6c 20 49 6e 64 65 78 2e 3c 2f 6c 69 3e 0d 0a 3c l Index.</li>..<
2950: 2f 6f 6c 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c /ol></li>..<li><
2960: 62 3e 72 65 66 5f 67 65 6f 6d 65 74 72 79 3c 2f b>ref_geometry</
2970: 62 3e 20 28 3c 69 3e 6d 61 6e 64 61 74 6f 72 79 b> (<i>mandatory
2980: 3c 2f 69 3e 29 3c 62 72 3e 0d 0a 61 6e 79 20 61 </i>)<br>..any a
2990: 72 62 69 74 72 61 72 79 20 47 65 6f 6d 65 74 72 rbitrary Geometr
29a0: 79 20 28 3c 62 3e 50 4f 49 4e 54 3c 2f 62 3e 2c y (<b>POINT</b>,
29b0: 20 3c 62 3e 4c 49 4e 45 53 54 52 49 4e 47 3c 2f <b>LINESTRING</
29c0: 62 3e 2c 20 3c 62 3e 50 4f 4c 59 47 4f 4e 3c 2f b>, <b>POLYGON</
29d0: 62 3e 20 6f 72 20 77 68 61 74 65 76 65 72 20 65 b> or whatever e
29e0: 6c 73 65 29 20 69 6e 74 65 6e 64 65 64 20 74 6f lse) intended to
29f0: 20 72 65 70 72 65 73 65 6e 74 20 74 68 65 20 6f represent the o
2a00: 72 69 67 69 6e 20 6f 66 20 74 68 65 20 4b 4e 4e rigin of the KNN
2a10: 20 73 65 61 72 63 68 2e 3c 62 72 3e 0d 0a 53 68 search.<br>..Sh
2a20: 6f 75 6c 64 20 6e 65 63 65 73 73 61 72 69 6c 79 ould necessarily
2a30: 20 62 65 20 69 6e 20 74 68 65 20 73 61 6d 65 20 be in the same
2a40: 53 52 49 44 20 6f 66 20 74 68 65 20 74 61 72 67 SRID of the targ
2a50: 65 74 20 47 65 6f 6d 65 74 72 69 65 73 20 74 6f et Geometries to
2a60: 20 62 65 20 73 65 61 72 63 68 65 64 2e 3c 2f 6c be searched.</l
2a70: 69 3e 0d 0a 3c 6c 69 3e 3c 62 3e 6d 61 78 5f 69 i>..<li><b>max_i
2a80: 74 65 6d 73 3c 2f 62 3e 20 28 3c 69 3e 6f 70 74 tems</b> (<i>opt
2a90: 69 6f 6e 61 6c 3c 2f 69 3e 29 3c 62 72 3e 0d 0a ional</i>)<br>..
2aa0: 6d 61 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f maximum number o
2ab0: 66 20 72 6f 77 73 20 74 6f 20 62 65 20 72 65 74 f rows to be ret
2ac0: 75 72 6e 65 64 20 69 6e 74 6f 20 74 68 65 20 72 urned into the r
2ad0: 65 73 75 6c 74 73 65 74 2e 3c 62 72 3e 0d 0a 54 esultset.<br>..T
2ae0: 68 65 20 76 61 6c 69 64 20 72 61 6e 67 65 20 69 he valid range i
2af0: 73 20 66 72 6f 6d 20 3c 62 3e 31 3c 2f 62 3e 20 s from <b>1</b>
2b00: 74 6f 20 3c 62 3e 31 30 32 34 3c 2f 62 3e 20 28 to <b>1024</b> (
2b10: 68 69 67 68 65 72 20 76 61 6c 75 65 73 20 77 69 higher values wi
2b20: 6c 6c 20 72 65 71 75 69 72 65 20 61 20 6c 6f 6e ll require a lon
2b30: 67 65 72 20 74 69 6d 65 20 74 6f 20 62 65 20 70 ger time to be p
2b40: 72 6f 63 65 73 73 65 64 29 2e 3c 62 72 3e 0d 0a rocessed).<br>..
2b50: 42 79 20 64 65 66 61 75 6c 74 20 6f 6e 6c 79 20 By default only
2b60: 74 68 65 20 66 69 72 73 74 20 3c 62 3e 33 3c 2f the first <b>3</
2b70: 62 3e 20 6e 65 61 72 65 73 74 20 47 65 6f 6d 65 b> nearest Geome
2b80: 74 72 69 65 73 20 77 69 6c 6c 20 62 65 20 69 64 tries will be id
2b90: 65 6e 74 69 66 69 65 64 2e 3c 2f 6c 69 3e 0d 0a entified.</li>..
2ba0: 3c 2f 75 6c 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e </ul></li>..<li>
2bb0: 74 68 65 20 6f 75 74 70 75 74 20 63 6f 6c 75 6d the output colum
2bc0: 6e 73 20 28 74 68 65 20 6f 6e 65 73 20 63 6f 6e ns (the ones con
2bd0: 74 61 69 6e 69 6e 67 20 76 61 6c 75 65 73 20 72 taining values r
2be0: 65 74 72 69 65 76 65 64 20 62 79 20 74 68 65 20 etrieved by the
2bf0: 4b 4e 4e 20 73 65 61 72 63 68 29 20 61 72 65 3a KNN search) are:
2c00: 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 3c 62 3e 70 ..<ul>..<li><b>p
2c10: 6f 73 3c 2f 62 3e 20 28 3c 69 3e 49 4e 54 45 47 os</b> (<i>INTEG
2c20: 45 52 3c 2f 69 3e 29 3c 62 72 3e 0d 0a 72 65 6c ER</i>)<br>..rel
2c30: 61 74 69 76 65 20 72 61 6e 6b 3a 20 74 68 65 20 ative rank: the
2c40: 63 6c 6f 73 65 73 74 20 69 74 65 6d 20 77 69 6c closest item wil
2c50: 6c 20 62 65 20 3c 62 3e 23 31 3c 2f 62 3e 2c 20 l be <b>#1</b>,
2c60: 74 68 65 20 73 65 63 6f 6e 64 20 63 6c 6f 73 65 the second close
2c70: 73 74 20 69 74 65 6d 20 77 69 6c 6c 20 62 65 20 st item will be
2c80: 3c 62 3e 23 32 3c 2f 62 3e 20 61 6e 64 20 73 6f <b>#2</b> and so
2c90: 20 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c on.</li>..<li><
2ca0: 62 3e 66 69 64 3c 2f 62 3e 20 28 3c 69 3e 49 4e b>fid</b> (<i>IN
2cb0: 54 45 47 45 52 3c 2f 69 3e 29 3c 62 72 3e 0d 0a TEGER</i>)<br>..
2cc0: 74 68 65 20 75 6e 69 71 75 65 20 3c 62 3e 52 4f the unique <b>RO
2cd0: 57 49 44 3c 2f 62 3e 20 76 61 6c 75 65 20 6f 66 WID</b> value of
2ce0: 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 the correspondi
2cf0: 6e 67 20 66 65 61 74 75 72 65 20 69 6e 74 6f 20 ng feature into
2d00: 74 68 65 20 73 65 61 72 63 68 65 64 20 47 65 6f the searched Geo
2d10: 54 61 62 6c 65 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 Table.</li>..<li
2d20: 3e 3c 62 3e 64 69 73 74 61 6e 63 65 3c 2f 62 3e ><b>distance</b>
2d30: 20 28 3c 69 3e 44 4f 55 42 4c 45 3c 2f 69 3e 29 (<i>DOUBLE</i>)
2d40: 3c 62 72 3e 0d 0a 74 68 65 20 6d 69 6e 69 6d 75 <br>..the minimu
2d50: 6d 20 64 69 73 74 61 6e 63 65 20 69 6e 74 65 72 m distance inter
2d60: 63 75 72 72 69 6e 67 20 62 65 74 77 65 65 6e 20 curring between
2d70: 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e the correspondin
2d80: 67 20 66 65 61 74 75 72 65 20 69 6e 74 6f 20 74 g feature into t
2d90: 68 65 20 73 65 61 72 63 68 65 64 20 47 65 6f 54 he searched GeoT
2da0: 61 62 6c 65 20 61 6e 64 20 74 68 65 20 6f 72 69 able and the ori
2db0: 67 69 6e 20 64 65 66 69 6e 65 64 20 62 79 20 3c gin defined by <
2dc0: 62 3e 72 65 66 5f 67 65 6f 6d 65 74 72 79 3c 2f b>ref_geometry</
2dd0: 62 3e 2e 0d 0a 3c 6f 6c 3e 0d 0a 3c 6c 69 3e 54 b>...<ol>..<li>T
2de0: 68 65 20 75 6e 69 74 20 6d 65 61 73 75 72 65 20 he unit measure
2df0: 66 6f 72 20 61 6c 6c 20 64 69 73 74 61 6e 63 65 for all distance
2e00: 73 20 77 69 6c 6c 20 61 6c 77 61 79 73 20 62 65 s will always be
2e10: 20 74 68 65 20 6f 6e 65 20 64 65 63 6c 61 72 65 the one declare
2e20: 64 20 62 79 20 74 68 65 20 63 6f 72 72 65 73 70 d by the corresp
2e30: 6f 6e 64 69 6e 67 20 53 52 49 44 20 64 65 66 69 onding SRID defi
2e40: 6e 69 74 69 6f 6e 2c 20 69 66 20 74 68 69 73 20 nition, if this
2e50: 6f 6e 65 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 one corresponds
2e60: 74 6f 20 73 6f 6d 65 20 3c 62 3e 70 6c 61 6e 61 to some <b>plana
2e70: 72 3c 2f 62 3e 20 28 61 6b 61 20 3c 62 3e 70 72 r</b> (aka <b>pr
2e80: 6f 6a 65 63 74 65 64 3c 2f 62 3e 29 20 72 65 66 ojected</b>) ref
2e90: 65 72 65 6e 63 65 20 73 79 73 74 65 6d 2e 3c 2f erence system.</
2ea0: 6c 69 3e 0d 0a 3c 6c 69 3e 49 66 20 69 6e 73 74 li>..<li>If inst
2eb0: 65 61 64 20 74 68 65 20 63 6f 72 72 65 73 70 6f ead the correspo
2ec0: 6e 64 69 6e 67 20 53 52 49 44 20 64 65 66 69 6e nding SRID defin
2ed0: 69 74 69 6f 6e 20 69 73 20 6f 66 20 74 68 65 20 ition is of the
2ee0: 3c 62 3e 67 65 6f 67 72 61 70 68 69 63 3c 2f 62 <b>geographic</b
2ef0: 3e 20 74 79 70 65 20 28 3c 69 3e 6c 6f 6e 67 69 > type (<i>longi
2f00: 74 75 64 65 3c 2f 69 3e 20 61 6e 64 20 3c 69 3e tude</i> and <i>
2f10: 6c 61 74 69 74 75 64 65 3c 2f 69 3e 20 61 6e 67 latitude</i> ang
2f20: 6c 65 73 29 20 61 6c 6c 20 64 69 73 74 61 6e 63 les) all distanc
2f30: 65 73 20 77 69 6c 6c 20 61 6c 77 61 79 73 20 62 es will always b
2f40: 65 20 6d 65 61 73 75 72 65 64 20 69 6e 20 3c 62 e measured in <b
2f50: 3e 6d 65 74 72 65 73 3c 2f 62 3e 2c 20 61 6e 64 >metres</b>, and
2f60: 20 74 68 65 20 6d 6f 73 74 20 70 72 65 63 69 73 the most precis
2f70: 65 20 67 65 6f 64 65 74 69 63 20 66 6f 72 6d 75 e geodetic formu
2f80: 6c 61 73 20 77 69 6c 6c 20 62 65 20 61 75 74 6f las will be auto
2f90: 6d 61 74 69 63 61 6c 6c 79 20 61 70 70 6c 69 65 matically applie
2fa0: 64 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 6f 6c 3e 3c 2f d.</li>..</ol></
2fb0: 6c 69 3e 0d 0a 3c 2f 75 6c 3e 3c 2f 6c 69 3e 0d li>..</ul></li>.
2fc0: 0a 3c 2f 75 6c 3e 3c 62 72 3e 0d 0a 3c 68 72 3e .</ul><br>..<hr>
2fd0: 0d 0a 3c 68 33 3e 41 20 73 65 63 6f 6e 64 20 65 ..<h3>A second e
2fe0: 78 61 6d 70 6c 65 20 6f 66 20 61 20 6d 6f 72 65 xample of a more
2ff0: 20 73 6f 70 68 69 73 74 69 63 61 72 64 20 4b 4e sophisticard KN
3000: 4e 20 71 75 65 72 79 3c 2f 68 33 3e 0d 0a 3c 76 N query</h3>..<v
3010: 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c 45 43 54 erbatim>..SELECT
3020: 20 61 2e 70 6f 73 2c 20 62 2e 6e 61 6d 65 2c 20 a.pos, b.name,
3030: 62 2e 63 6f 75 6e 74 72 79 2c 20 61 2e 64 69 73 b.country, a.dis
3040: 74 61 6e 63 65 20 2f 20 31 30 30 30 2e 30 20 41 tance / 1000.0 A
3050: 53 20 64 69 73 74 5f 6b 6d 0d 0a 46 52 4f 4d 20 S dist_km..FROM
3060: 6b 6e 6e 20 41 53 20 61 0d 0a 4a 4f 49 4e 20 61 knn AS a..JOIN a
3070: 69 72 70 6f 72 74 73 20 41 53 20 62 20 4f 4e 20 irports AS b ON
3080: 28 62 2e 67 65 6f 6e 61 6d 65 69 64 20 3d 20 61 (b.geonameid = a
3090: 2e 66 69 64 29 0d 0a 57 48 45 52 45 20 66 5f 74 .fid)..WHERE f_t
30a0: 61 62 6c 65 5f 6e 61 6d 65 20 3d 20 27 61 69 72 able_name = 'air
30b0: 70 6f 72 74 73 27 20 41 4e 44 20 72 65 66 5f 67 ports' AND ref_g
30c0: 65 6f 6d 65 74 72 79 20 3d 20 4d 61 6b 65 50 6f eometry = MakePo
30d0: 69 6e 74 28 31 30 2c 20 34 33 29 20 41 4e 44 20 int(10, 43) AND
30e0: 6d 61 78 5f 69 74 65 6d 73 20 3d 20 35 3b 0d 0a max_items = 5;..
30f0: 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 3c 74 61 </verbatim>..<ta
3100: 62 6c 65 20 62 67 63 6f 6c 6f 72 3d 22 23 64 30 ble bgcolor="#d0
3110: 66 66 62 30 22 20 63 65 6c 6c 73 70 61 63 69 6e ffb0" cellspacin
3120: 67 3d 22 34 22 20 63 65 6c 6c 70 61 64 64 69 6e g="4" cellpaddin
3130: 67 3d 22 34 22 20 62 6f 72 64 65 72 3d 22 31 22 g="4" border="1"
3140: 3e 0d 0a 3c 74 72 3e 3c 74 64 20 62 67 63 6f 6c >..<tr><td bgcol
3150: 6f 72 3d 22 23 63 30 64 64 61 6f 22 3e 3c 62 3e or="#c0ddao"><b>
3160: 72 61 6e 6b 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 64 rank</b></td><td
3170: 20 62 67 63 6f 6c 6f 72 3d 22 23 63 30 64 64 61 bgcolor="#c0dda
3180: 6f 22 3e 3c 62 3e 67 65 6f 6e 61 6d 65 69 64 3c o"><b>geonameid<
3190: 2f 62 3e 3c 2f 74 64 3e 3c 74 64 20 62 67 63 6f /b></td><td bgco
31a0: 6c 6f 72 3d 22 23 63 30 64 64 61 6f 22 3e 3c 62 lor="#c0ddao"><b
31b0: 3e 6e 61 6d 65 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 >name</b></td><t
31c0: 64 20 62 67 63 6f 6c 6f 72 3d 22 23 63 30 64 64 d bgcolor="#c0dd
31d0: 61 6f 22 3e 3c 62 3e 63 6f 75 6e 74 72 79 3c 2f ao"><b>country</
31e0: 62 3e 3c 2f 74 64 3e 3c 74 64 20 62 67 63 6f 6c b></td><td bgcol
31f0: 6f 72 3d 22 23 63 30 64 64 61 6f 22 3e 3c 62 3e or="#c0ddao"><b>
3200: 64 69 73 74 5f 6b 6d 3c 2f 62 3e 3c 2f 74 64 3e dist_km</b></td>
3210: 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 20 61 </tr>..<tr><td a
3220: 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 31 3c 2f lign="right">1</
3230: 74 64 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72 69 td><td align="ri
3240: 67 68 74 22 3e 36 32 39 39 36 32 33 3c 2f 74 64 ght">6299623</td
3250: 3e 3c 74 64 3e 4d 61 72 69 6e 61 20 44 69 20 43 ><td>Marina Di C
3260: 61 6d 70 6f 3c 2f 74 64 3e 3c 74 64 3e 49 54 3c ampo</td><td>IT<
3270: 2f 74 64 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72 /td><td align="r
3280: 69 67 68 74 22 3e 33 33 2e 30 34 33 33 32 30 3c ight">33.043320<
3290: 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c /td></tr>..<tr><
32a0: 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 td align="right"
32b0: 3e 32 3c 2f 74 64 3e 3c 74 64 20 61 6c 69 67 6e >2</td><td align
32c0: 3d 22 72 69 67 68 74 22 3e 36 32 39 39 33 39 32 ="right">6299392
32d0: 3c 2f 74 64 3e 3c 74 64 3e 42 61 73 74 69 61 2d </td><td>Bastia-
32e0: 50 6f 72 65 74 74 61 3c 2f 74 64 3e 3c 74 64 3e Poretta</td><td>
32f0: 46 52 3c 2f 74 64 3e 3c 74 64 20 61 6c 69 67 6e FR</td><td align
3300: 3d 22 72 69 67 68 74 22 3e 36 35 2e 32 32 36 35 ="right">65.2265
3310: 37 33 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 73</td></tr>..<t
3320: 72 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 r><td align="rig
3330: 68 74 22 3e 33 3c 2f 74 64 3e 3c 74 64 20 61 6c ht">3</td><td al
3340: 69 67 6e 3d 22 72 69 67 68 74 22 3e 36 32 39 39 ign="right">6299
3350: 36 32 38 3c 2f 74 64 3e 3c 74 64 3e 50 69 73 61 628</td><td>Pisa
3360: 20 2f 20 53 2e 20 47 69 75 73 74 6f 3c 2f 74 64 / S. Giusto</td
3370: 3e 3c 74 64 3e 49 54 3c 2f 74 64 3e 3c 74 64 20 ><td>IT</td><td
3380: 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 38 32 align="right">82
3390: 2e 33 38 37 30 31 34 3c 2f 74 64 3e 3c 2f 74 72 .387014</td></tr
33a0: 3e 0d 0a 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e >..<tr><td align
33b0: 3d 22 72 69 67 68 74 22 3e 34 3c 2f 74 64 3e 3c ="right">4</td><
33c0: 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 td align="right"
33d0: 3e 36 32 39 39 36 33 30 3c 2f 74 64 3e 3c 74 64 >6299630</td><td
33e0: 3e 47 72 6f 73 73 65 74 6f 20 41 69 72 70 6f 72 >Grosseto Airpor
33f0: 74 3c 2f 74 64 3e 3c 74 64 3e 49 54 3c 2f 74 64 t</td><td>IT</td
3400: 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 68 ><td align="righ
3410: 74 22 3e 39 31 2e 35 34 39 37 37 33 3c 2f 74 64 t">91.549773</td
3420: 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c 74 64 20 ></tr>..<tr><td
3430: 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 35 3c align="right">5<
3440: 2f 74 64 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72 /td><td align="r
3450: 69 67 68 74 22 3e 36 36 39 34 34 39 35 3c 2f 74 ight">6694495</t
3460: 64 3e 3c 74 64 3e 43 6f 72 74 65 3c 2f 74 64 3e d><td>Corte</td>
3470: 3c 74 64 3e 46 52 3c 2f 74 64 3e 3c 74 64 20 61 <td>FR</td><td a
3480: 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 31 30 32 lign="right">102
3490: 2e 38 31 39 37 37 38 3c 2f 74 64 3e 3c 2f 74 72 .819778</td></tr
34a0: 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 3c 62 72 3e 0d >..</table><br>.
34b0: 0a 54 68 69 73 20 73 65 63 6f 6e 64 20 4b 4e 4e .This second KNN
34c0: 20 71 75 65 72 79 20 77 69 6c 6c 20 72 65 74 75 query will retu
34d0: 72 6e 20 74 68 65 20 73 61 6d 65 20 69 64 65 6e rn the same iden
34e0: 74 69 63 61 6c 20 72 65 73 75 6c 74 73 20 77 65 tical results we
34f0: 20 61 6c 72 65 61 64 79 20 67 6f 74 20 62 65 66 already got bef
3500: 6f 72 65 20 62 79 20 75 73 69 6e 67 20 74 68 65 ore by using the
3510: 20 73 69 6c 6c 79 20 6e 61 69 76 65 20 61 70 70 silly naive app
3520: 72 6f 61 63 68 2e 3c 62 72 3e 0d 0a 54 68 65 20 roach.<br>..The
3530: 73 74 72 69 6b 69 6e 67 20 64 69 66 66 65 72 65 striking differe
3540: 6e 63 65 20 69 73 20 74 68 61 74 20 74 68 69 73 nce is that this
3550: 20 4b 4e 4e 20 71 75 65 72 79 20 73 75 63 63 65 KNN query succe
3560: 73 66 75 6c 6c 79 20 63 6f 6d 70 6c 65 74 65 64 sfully completed
3570: 20 69 6e 20 6a 75 73 74 20 61 20 66 72 61 63 74 in just a fract
3580: 69 6f 6e 20 6f 66 20 61 20 73 65 63 6f 6e 64 2c ion of a second,
3590: 20 77 69 68 6c 73 74 20 65 78 65 63 79 74 69 6e wihlst execytin
35a0: 67 20 74 68 65 20 6e 61 69 76 65 20 71 75 65 72 g the naive quer
35b0: 69 65 73 20 63 6f 6d 70 6c 65 78 69 76 65 6c 79 ies complexively
35c0: 20 72 65 71 75 69 72 65 64 20 6d 61 6e 79 20 73 required many s
35d0: 65 63 6f 6e 64 73 20 28 61 6e 64 20 70 6c 65 61 econds (and plea
35e0: 73 65 20 63 6f 6e 73 69 64 65 72 20 74 68 61 74 se consider that
35f0: 20 74 68 69 73 20 6f 6e 65 20 69 73 20 61 20 72 this one is a r
3600: 65 6c 61 74 69 76 65 6c 79 20 73 6d 61 6c 6c 20 elatively small
3610: 64 61 74 61 73 65 74 29 2e 3c 62 72 3e 3c 62 72 dataset).<br><br
3620: 3e 0d 0a 3c 62 3e 4c 65 73 73 6f 6e 20 74 6f 20 >..<b>Lesson to
3630: 6c 65 61 72 6e 3c 2f 62 3e 3a 20 4b 4e 4e 20 71 learn</b>: KNN q
3640: 75 65 72 69 65 73 20 61 72 65 20 72 65 61 6c 6c ueries are reall
3650: 79 20 65 66 66 69 63 69 65 6e 74 20 61 6e 64 20 y efficient and
3660: 66 61 73 74 2c 20 62 65 63 61 75 73 65 20 74 68 fast, because th
3670: 65 79 20 64 69 72 65 63 74 6c 79 20 69 6e 74 65 ey directly inte
3680: 72 61 63 74 20 77 69 74 68 20 74 68 65 20 6c 6f ract with the lo
3690: 77 65 72 6d 6f 73 74 20 6c 65 76 65 6c 73 20 6f wermost levels o
36a0: 66 20 74 68 65 20 52 2a 54 72 65 65 20 53 70 61 f the R*Tree Spa
36b0: 74 69 61 6c 20 49 6e 64 65 78 20 69 6d 70 6c 65 tial Index imple
36c0: 6d 65 6e 74 61 74 69 6f 6e 2e 3c 62 72 3e 3c 62 mentation.<br><b
36d0: 72 3e 0d 0a 3c 68 72 3e 0d 0a 3c 68 33 3e 41 20 r>..<hr>..<h3>A
36e0: 74 68 69 72 64 20 65 78 61 6d 70 6c 65 20 6f 66 third example of
36f0: 20 4b 4e 4e 20 71 75 65 72 79 3c 2f 68 33 3e 0d KNN query</h3>.
3700: 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c .<verbatim>..SEL
3710: 45 43 54 20 61 2e 70 6f 73 20 41 53 20 72 61 6e ECT a.pos AS ran
3720: 6b 2c 20 62 2e 67 65 6f 6e 61 6d 65 69 64 2c 20 k, b.geonameid,
3730: 62 2e 6e 61 6d 65 2c 20 62 2e 63 6f 75 6e 74 72 b.name, b.countr
3740: 79 2c 20 61 2e 64 69 73 74 61 6e 63 65 20 2f 20 y, a.distance /
3750: 31 30 30 30 2e 30 20 41 53 20 64 69 73 74 5f 6b 1000.0 AS dist_k
3760: 6d 0d 0a 46 52 4f 4d 20 6b 6e 6e 20 41 53 20 61 m..FROM knn AS a
3770: 0d 0a 4a 4f 49 4e 20 61 69 72 70 6f 72 74 73 20 ..JOIN airports
3780: 41 53 20 62 20 4f 4e 20 28 62 2e 67 65 6f 6e 61 AS b ON (b.geona
3790: 6d 65 69 64 20 3d 20 61 2e 66 69 64 29 0d 0a 57 meid = a.fid)..W
37a0: 48 45 52 45 20 66 5f 74 61 62 6c 65 5f 6e 61 6d HERE f_table_nam
37b0: 65 20 3d 20 27 61 69 72 70 6f 72 74 73 27 20 41 e = 'airports' A
37c0: 4e 44 20 72 65 66 5f 67 65 6f 6d 65 74 72 79 20 ND ref_geometry
37d0: 3d 20 4d 61 6b 65 50 6f 69 6e 74 28 2d 31 37 2e = MakePoint(-17.
37e0: 33 2c 20 2d 34 34 29 20 41 4e 44 20 6d 61 78 5f 3, -44) AND max_
37f0: 69 74 65 6d 73 20 3d 20 35 3b 0d 0a 3c 2f 76 65 items = 5;..</ve
3800: 72 62 61 74 69 6d 3e 0d 0a 3c 74 61 62 6c 65 20 rbatim>..<table
3810: 62 67 63 6f 6c 6f 72 3d 22 23 64 30 66 66 62 30 bgcolor="#d0ffb0
3820: 22 20 63 65 6c 6c 73 70 61 63 69 6e 67 3d 22 34 " cellspacing="4
3830: 22 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 22 34 " cellpadding="4
3840: 22 20 62 6f 72 64 65 72 3d 22 31 22 3e 0d 0a 3c " border="1">..<
3850: 74 72 3e 3c 74 64 20 62 67 63 6f 6c 6f 72 3d 22 tr><td bgcolor="
3860: 23 63 30 64 64 61 6f 22 3e 3c 62 3e 72 61 6e 6b #c0ddao"><b>rank
3870: 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 64 20 62 67 63 </b></td><td bgc
3880: 6f 6c 6f 72 3d 22 23 63 30 64 64 61 6f 22 3e 3c olor="#c0ddao"><
3890: 62 3e 67 65 6f 6e 61 6d 65 69 64 3c 2f 62 3e 3c b>geonameid</b><
38a0: 2f 74 64 3e 3c 74 64 20 62 67 63 6f 6c 6f 72 3d /td><td bgcolor=
38b0: 22 23 63 30 64 64 61 6f 22 3e 3c 62 3e 6e 61 6d "#c0ddao"><b>nam
38c0: 65 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 64 20 62 67 e</b></td><td bg
38d0: 63 6f 6c 6f 72 3d 22 23 63 30 64 64 61 6f 22 3e color="#c0ddao">
38e0: 3c 62 3e 63 6f 75 6e 74 72 79 3c 2f 62 3e 3c 2f <b>country</b></
38f0: 74 64 3e 3c 74 64 20 62 67 63 6f 6c 6f 72 3d 22 td><td bgcolor="
3900: 23 63 30 64 64 61 6f 22 3e 3c 62 3e 64 69 73 74 #c0ddao"><b>dist
3910: 5f 6b 6d 3c 2f 62 3e 3c 2f 74 64 3e 3c 2f 74 72 _km</b></td></tr
3920: 3e 0d 0a 3c 74 72 3e 3c 74 64 20 61 6c 69 67 6e >..<tr><td align
3930: 3d 22 72 69 67 68 74 22 3e 31 3c 2f 74 64 3e 3c ="right">1</td><
3940: 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 td align="right"
3950: 3e 37 36 36 38 34 33 33 3c 2f 74 64 3e 3c 74 64 >7668433</td><td
3960: 3e 43 61 62 6f 20 46 72 69 6f 20 41 69 72 70 6f >Cabo Frio Airpo
3970: 72 74 3c 2f 74 64 3e 3c 74 64 3e 42 52 3c 2f 74 rt</td><td>BR</t
3980: 64 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 d><td align="rig
3990: 68 74 22 3e 33 32 35 36 2e 35 38 39 39 36 34 3c ht">3256.589964<
39a0: 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c /td></tr>..<tr><
39b0: 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 td align="right"
39c0: 3e 32 3c 2f 74 64 3e 3c 74 64 20 61 6c 69 67 6e >2</td><td align
39d0: 3d 22 72 69 67 68 74 22 3e 33 33 35 39 30 30 31 ="right">3359001
39e0: 3c 2f 74 64 3e 3c 74 64 3e 59 6f 75 6e 67 73 66 </td><td>Youngsf
39f0: 69 65 6c 64 3c 2f 74 64 3e 3c 74 64 3e 5a 41 3c ield</td><td>ZA<
3a00: 2f 74 64 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72 /td><td align="r
3a10: 69 67 68 74 22 3e 33 32 36 32 2e 32 37 31 30 32 ight">3262.27102
3a20: 37 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 7</td></tr>..<tr
3a30: 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 68 ><td align="righ
3a40: 74 22 3e 33 3c 2f 74 64 3e 3c 74 64 20 61 6c 69 t">3</td><td ali
3a50: 67 6e 3d 22 72 69 67 68 74 22 3e 37 37 33 30 31 gn="right">77301
3a60: 35 33 3c 2f 74 64 3e 3c 74 64 3e 55 6d 62 65 72 53</td><td>Umber
3a70: 74 6f 20 4d 6f 64 69 61 6e 6f 20 41 69 72 70 6f to Modiano Airpo
3a80: 72 74 3c 2f 74 64 3e 3c 74 64 3e 42 52 3c 2f 74 rt</td><td>BR</t
3a90: 64 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 d><td align="rig
3aa0: 68 74 22 3e 33 32 36 32 2e 36 39 33 30 33 32 3c ht">3262.693032<
3ab0: 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 3c /td></tr>..<tr><
3ac0: 74 64 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 td align="right"
3ad0: 3e 34 3c 2f 74 64 3e 3c 74 64 20 61 6c 69 67 6e >4</td><td align
3ae0: 3d 22 72 69 67 68 74 22 3e 33 33 36 32 33 35 35 ="right">3362355
3af0: 3c 2f 74 64 3e 3c 74 64 3e 52 6f 62 62 65 6e 20 </td><td>Robben
3b00: 49 73 6c 61 6e 64 3c 2f 74 64 3e 3c 74 64 3e 5a Island</td><td>Z
3b10: 41 3c 2f 74 64 3e 3c 74 64 20 61 6c 69 67 6e 3d A</td><td align=
3b20: 22 72 69 67 68 74 22 3e 33 32 36 35 2e 33 30 32 "right">3265.302
3b30: 35 36 38 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 568</td></tr>..<
3b40: 74 72 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72 69 tr><td align="ri
3b50: 67 68 74 22 3e 35 3c 2f 74 64 3e 3c 74 64 20 61 ght">5</td><td a
3b60: 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 36 33 30 lign="right">630
3b70: 30 36 32 32 3c 2f 74 64 3e 3c 74 64 3e 53 2e 20 0622</td><td>S.
3b80: 50 2e 20 41 6c 64 65 69 61 20 41 65 72 6f 64 72 P. Aldeia Aerodr
3b90: 6f 6d 65 3c 2f 74 64 3e 3c 74 64 3e 42 52 3c 2f ome</td><td>BR</
3ba0: 74 64 3e 3c 74 64 20 61 6c 69 67 6e 3d 22 72 69 td><td align="ri
3bb0: 67 68 74 22 3e 33 32 36 37 2e 32 33 34 31 34 32 ght">3267.234142
3bc0: 3c 2f 74 64 3e 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 </td></tr>..</ta
3bd0: 62 6c 65 3e 3c 62 72 3e 0d 0a 54 68 69 73 20 6c ble><br>..This l
3be0: 61 73 74 20 4b 4e 4e 20 71 75 65 72 79 20 69 73 ast KNN query is
3bf0: 20 76 65 72 79 20 73 69 6d 69 6c 61 72 20 74 6f very similar to
3c00: 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 6f 6e the previous on
3c10: 65 2e 3c 62 72 3e 0d 0a 54 68 69 73 20 74 69 6d e.<br>..This tim
3c20: 65 20 77 65 27 76 65 20 70 6c 61 63 65 64 20 74 e we've placed t
3c30: 68 65 20 6f 72 69 67 69 6e 20 6c 6f 63 61 74 69 he origin locati
3c40: 6f 6e 20 73 6f 6d 65 77 68 65 72 65 20 69 6e 74 on somewhere int
3c50: 6f 20 74 68 65 20 53 6f 75 74 68 20 41 74 6c 61 o the South Atla
3c60: 6e 74 69 63 20 62 6c 75 65 20 64 65 65 70 20 77 ntic blue deep w
3c70: 61 74 65 72 73 20 28 6d 6f 72 65 20 6f 72 20 6c aters (more or l
3c80: 65 73 73 20 6d 69 64 77 61 79 20 66 72 6f 6d 20 ess midway from
3c90: 62 6f 74 68 20 42 72 61 7a 69 6c 20 61 6e 64 20 both Brazil and
3ca0: 53 6f 75 74 68 20 41 66 72 69 63 61 29 20 61 6e South Africa) an
3cb0: 64 20 63 6f 6e 73 65 71 75 6e 74 6c 79 20 74 68 d consequntly th
3cc0: 65 20 6e 65 61 72 65 73 74 20 61 69 72 70 6f 72 e nearest airpor
3cd0: 74 73 20 61 72 65 20 6e 6f 74 20 72 65 61 6c 6c ts are not reall
3ce0: 79 20 73 6f 20 6e 65 61 72 2c 20 62 65 63 61 75 y so near, becau
3cf0: 73 65 20 74 68 65 79 20 61 72 65 20 6c 6f 63 61 se they are loca
3d00: 74 65 64 20 6d 61 6e 79 20 74 68 6f 75 73 61 6e ted many thousan
3d10: 64 73 20 4b 6d 20 61 77 61 79 2e 0d 0a 41 73 20 ds Km away...As
3d20: 79 6f 75 20 63 61 6e 20 65 61 73 69 6c 79 20 63 you can easily c
3d30: 68 65 63 6b 20 61 20 4b 4e 4e 20 71 75 65 72 79 heck a KNN query
3d40: 20 77 69 6c 6c 20 62 72 69 6c 6c 69 61 6e 74 6c will brilliantl
3d50: 79 20 70 65 72 66 6f 72 6d 20 65 76 65 6e 20 75 y perform even u
3d60: 6e 64 65 72 20 73 75 63 68 20 75 6e 75 73 75 61 nder such unusua
3d70: 6c 20 63 6f 6e 64 69 74 69 6f 6e 73 2e 3c 62 72 l conditions.<br
3d80: 3e 3c 62 72 3e 0d 0a 3c 69 6d 67 20 73 72 63 3d ><br>..<img src=
3d90: 22 68 74 74 70 73 3a 2f 2f 77 77 77 2e 67 61 69 "https://www.gai
3da0: 61 2d 67 69 73 2e 69 74 2f 67 61 69 61 2d 73 69 a-gis.it/gaia-si
3db0: 6e 73 2f 6b 6e 6e 2f 73 6f 75 74 68 2d 61 74 6c ns/knn/south-atl
3dc0: 61 6e 74 69 63 2e 70 6e 67 22 20 61 6c 74 3d 22 antic.png" alt="
3dd0: 53 6f 75 74 68 20 41 74 6c 61 6e 74 69 63 22 3e South Atlantic">
3de0: 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 62 3e 4c 65 73 <br><br>..<b>Les
3df0: 73 6f 6e 20 74 6f 20 6c 65 61 72 6e 3c 2f 62 3e son to learn</b>
3e00: 3a 20 4b 4e 4e 20 71 75 65 72 69 65 73 20 6e 65 : KNN queries ne
3e10: 76 65 72 20 61 73 73 75 6d 65 20 61 6e 79 20 70 ver assume any p
3e20: 72 65 64 65 66 69 6e 65 64 20 64 69 73 74 72 69 redefined distri
3e30: 62 75 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 65 bution of the se
3e40: 61 72 63 68 65 64 20 69 74 65 6d 73 2c 20 61 6e arched items, an
3e50: 64 20 63 61 6e 20 61 75 74 6f 6d 61 74 69 63 61 d can automatica
3e60: 6c 6c 79 20 61 64 61 70 74 20 69 6e 20 61 20 76 lly adapt in a v
3e70: 65 72 79 20 65 66 66 69 63 69 65 6e 74 20 77 61 ery efficient wa
3e80: 79 20 74 6f 20 74 68 65 20 6d 6f 73 74 20 69 72 y to the most ir
3e90: 72 65 67 75 6c 61 72 20 73 61 6d 70 6c 65 20 64 regular sample d
3ea0: 69 73 74 72 69 62 75 74 69 6f 6e 73 2e 3c 62 72 istributions.<br
3eb0: 3e 3c 62 72 3e 0d 0a 3c 68 72 3e 0d 0a 0d 0a 3c ><br>..<hr>....<
3ec0: 74 61 62 6c 65 20 77 69 64 74 68 3d 22 31 30 30 table width="100
3ed0: 25 22 3e 3c 74 72 3e 0d 0a 3c 74 64 20 77 69 64 %"><tr>..<td wid
3ee0: 74 68 3d 22 33 33 25 22 20 61 6c 69 67 6e 3d 22 th="33%" align="
3ef0: 6c 65 66 74 22 3e 3c 2f 74 64 3e 0d 0a 3c 74 64 left"></td>..<td
3f00: 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22 3e align="center">
3f10: 3c 61 20 68 72 65 66 3d 22 68 74 74 70 73 3a 2f <a href="https:/
3f20: 2f 77 77 77 2e 67 61 69 61 2d 67 69 73 2e 69 74 /www.gaia-gis.it
3f30: 2f 66 6f 73 73 69 6c 2f 6c 69 62 73 70 61 74 69 /fossil/libspati
3f40: 61 6c 69 74 65 2f 77 69 6b 69 3f 6e 61 6d 65 3d alite/wiki?name=
3f50: 6d 69 73 63 2d 64 6f 63 73 22 3e 62 61 63 6b 20 misc-docs">back
3f60: 74 6f 20 69 6e 64 65 78 3c 2f 61 3e 3c 2f 74 64 to index</a></td
3f70: 3e 0d 0a 3c 74 64 20 77 69 64 74 68 3d 22 33 33 >..<td width="33
3f80: 25 22 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 %" align="right"
3f90: 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 3c 2f 74 ></td>..</tr></t
3fa0: 61 62 6c 65 3e 0a 5a 20 66 38 30 64 66 34 35 62 able>.Z f80df45b
3fb0: 61 66 61 61 66 32 36 39 34 36 62 33 32 63 37 64 afaaf26946b32c7d
3fc0: 37 35 30 32 30 64 63 32 0a 75020dc2.