]> git.openstreetmap.org Git - nominatim.git/blob - lib/Geocode.php
Merge remote-tracking branch 'upstream/master'
[nominatim.git] / lib / Geocode.php
1 <?php
2
3 namespace Nominatim;
4
5 require_once(CONST_BasePath.'/lib/NearPoint.php');
6 require_once(CONST_BasePath.'/lib/PlaceLookup.php');
7 require_once(CONST_BasePath.'/lib/ReverseGeocode.php');
8
9 class Geocode
10 {
11     protected $oDB;
12
13     protected $aLangPrefOrder = array();
14
15     protected $bIncludeAddressDetails = false;
16     protected $bIncludeExtraTags = false;
17     protected $bIncludeNameDetails = false;
18
19     protected $bIncludePolygonAsPoints = false;
20     protected $bIncludePolygonAsText = false;
21     protected $bIncludePolygonAsGeoJSON = false;
22     protected $bIncludePolygonAsKML = false;
23     protected $bIncludePolygonAsSVG = false;
24     protected $fPolygonSimplificationThreshold = 0.0;
25
26     protected $aExcludePlaceIDs = array();
27     protected $bDeDupe = true;
28     protected $bReverseInPlan = true;
29
30     protected $iLimit = 20;
31     protected $iFinalLimit = 10;
32     protected $iOffset = 0;
33     protected $bFallback = false;
34
35     protected $aCountryCodes = false;
36
37     protected $bBoundedSearch = false;
38     protected $aViewBox = false;
39     protected $sViewboxCentreSQL = false;
40     protected $sViewboxSmallSQL = false;
41     protected $sViewboxLargeSQL = false;
42
43     protected $iMaxRank = 20;
44     protected $iMinAddressRank = 0;
45     protected $iMaxAddressRank = 30;
46     protected $aAddressRankList = array();
47     protected $exactMatchCache = array();
48
49     protected $sAllowedTypesSQLList = false;
50
51     protected $sQuery = false;
52     protected $aStructuredQuery = false;
53
54     protected $oNormalizer = null;
55
56
57     public function __construct(&$oDB)
58     {
59         $this->oDB =& $oDB;
60         $this->oNormalizer = \Transliterator::createFromRules(CONST_Term_Normalization_Rules);
61     }
62
63     private function normTerm($sTerm)
64     {
65         if ($this->oNormalizer === null) {
66             return $sTerm;
67         }
68
69         return $this->oNormalizer->transliterate($sTerm);
70     }
71
72     public function setReverseInPlan($bReverse)
73     {
74         $this->bReverseInPlan = $bReverse;
75     }
76
77     public function setLanguagePreference($aLangPref)
78     {
79         $this->aLangPrefOrder = $aLangPref;
80     }
81
82     public function getMoreUrlParams()
83     {
84         if ($this->aStructuredQuery) {
85             $aParams = $this->aStructuredQuery;
86         } else {
87             $aParams = array('q' => $this->sQuery);
88         }
89
90         if ($this->aExcludePlaceIDs) {
91             $aParams['exclude_place_ids'] = implode(',', $this->aExcludePlaceIDs);
92         }
93
94         if ($this->bIncludeAddressDetails) $aParams['addressdetails'] = '1';
95         if ($this->bIncludeExtraTags) $aParams['extratags'] = '1';
96         if ($this->bIncludeNameDetails) $aParams['namedetails'] = '1';
97
98         if ($this->bIncludePolygonAsPoints) $aParams['polygon'] = '1';
99         if ($this->bIncludePolygonAsText) $aParams['polygon_text'] = '1';
100         if ($this->bIncludePolygonAsGeoJSON) $aParams['polygon_geojson'] = '1';
101         if ($this->bIncludePolygonAsKML) $aParams['polygon_kml'] = '1';
102         if ($this->bIncludePolygonAsSVG) $aParams['polygon_svg'] = '1';
103
104         if ($this->fPolygonSimplificationThreshold > 0.0) {
105             $aParams['polygon_threshold'] = $this->fPolygonSimplificationThreshold;
106         }
107
108         if ($this->bBoundedSearch) $aParams['bounded'] = '1';
109         if (!$this->bDeDupe) $aParams['dedupe'] = '0';
110
111         if ($this->aCountryCodes) {
112             $aParams['countrycodes'] = implode(',', $this->aCountryCodes);
113         }
114
115         if ($this->aViewBox) {
116             $aParams['viewbox'] = $this->aViewBox[0].','.$this->aViewBox[3]
117                                   .','.$this->aViewBox[2].','.$this->aViewBox[1];
118         }
119
120         return $aParams;
121     }
122
123     public function setIncludePolygonAsPoints($b = true)
124     {
125         $this->bIncludePolygonAsPoints = $b;
126     }
127
128     public function setIncludePolygonAsText($b = true)
129     {
130         $this->bIncludePolygonAsText = $b;
131     }
132
133     public function setIncludePolygonAsGeoJSON($b = true)
134     {
135         $this->bIncludePolygonAsGeoJSON = $b;
136     }
137
138     public function setIncludePolygonAsKML($b = true)
139     {
140         $this->bIncludePolygonAsKML = $b;
141     }
142
143     public function setIncludePolygonAsSVG($b = true)
144     {
145         $this->bIncludePolygonAsSVG = $b;
146     }
147
148     public function setPolygonSimplificationThreshold($f)
149     {
150         $this->fPolygonSimplificationThreshold = $f;
151     }
152
153     public function setLimit($iLimit = 10)
154     {
155         if ($iLimit > 50) $iLimit = 50;
156         if ($iLimit < 1) $iLimit = 1;
157
158         $this->iFinalLimit = $iLimit;
159         $this->iLimit = $iLimit + min($iLimit, 10);
160     }
161
162     public function setFeatureType($sFeatureType)
163     {
164         switch ($sFeatureType) {
165             case 'country':
166                 $this->setRankRange(4, 4);
167                 break;
168             case 'state':
169                 $this->setRankRange(8, 8);
170                 break;
171             case 'city':
172                 $this->setRankRange(14, 16);
173                 break;
174             case 'settlement':
175                 $this->setRankRange(8, 20);
176                 break;
177         }
178     }
179
180     public function setRankRange($iMin, $iMax)
181     {
182         $this->iMinAddressRank = $iMin;
183         $this->iMaxAddressRank = $iMax;
184     }
185
186     public function setRoute($aRoutePoints, $fRouteWidth)
187     {
188         $this->aViewBox = false;
189
190         $this->sViewboxCentreSQL = "ST_SetSRID('LINESTRING(";
191         $sSep = '';
192         foreach ($aRoutePoints as $aPoint) {
193             $fPoint = (float)$aPoint;
194             $this->sViewboxCentreSQL .= $sSep.$fPoint;
195             $sSep = ($sSep == ' ') ? ',' : ' ';
196         }
197         $this->sViewboxCentreSQL .= ")'::geometry,4326)";
198
199         $this->sViewboxSmallSQL = 'ST_BUFFER('.$this->sViewboxCentreSQL;
200         $this->sViewboxSmallSQL .= ','.($fRouteWidth/69).')';
201
202         $this->sViewboxLargeSQL = 'ST_BUFFER('.$this->sViewboxCentreSQL;
203         $this->sViewboxLargeSQL .= ','.($fRouteWidth/30).')';
204     }
205
206     public function setViewbox($aViewbox)
207     {
208         $this->aViewBox = array_map('floatval', $aViewbox);
209
210         $this->aViewBox[0] = max(-180.0, min(180, $this->aViewBox[0]));
211         $this->aViewBox[1] = max(-90.0, min(90, $this->aViewBox[1]));
212         $this->aViewBox[2] = max(-180.0, min(180, $this->aViewBox[2]));
213         $this->aViewBox[3] = max(-90.0, min(90, $this->aViewBox[3]));
214
215         if (abs($this->aViewBox[0] - $this->aViewBox[2]) < 0.000000001
216             || abs($this->aViewBox[1] - $this->aViewBox[3]) < 0.000000001
217         ) {
218             userError("Bad parameter 'viewbox'. Not a box.");
219         }
220
221         $fHeight = $this->aViewBox[0] - $this->aViewBox[2];
222         $fWidth = $this->aViewBox[1] - $this->aViewBox[3];
223         $aBigViewBox[0] = $this->aViewBox[0] + $fHeight;
224         $aBigViewBox[2] = $this->aViewBox[2] - $fHeight;
225         $aBigViewBox[1] = $this->aViewBox[1] + $fWidth;
226         $aBigViewBox[3] = $this->aViewBox[3] - $fWidth;
227
228         $this->sViewboxCentreSQL = false;
229         $this->sViewboxSmallSQL = sprintf(
230             'ST_SetSRID(ST_MakeBox2D(ST_Point(%F,%F),ST_Point(%F,%F)),4326)',
231             $this->aViewBox[0],
232             $this->aViewBox[1],
233             $this->aViewBox[2],
234             $this->aViewBox[3]
235         );
236         $this->sViewboxLargeSQL = sprintf(
237             'ST_SetSRID(ST_MakeBox2D(ST_Point(%F,%F),ST_Point(%F,%F)),4326)',
238             $aBigViewBox[0],
239             $aBigViewBox[1],
240             $aBigViewBox[2],
241             $aBigViewBox[3]
242         );
243     }
244
245     public function setQuery($sQueryString)
246     {
247         $this->sQuery = $sQueryString;
248         $this->aStructuredQuery = false;
249     }
250
251     public function getQueryString()
252     {
253         return $this->sQuery;
254     }
255
256
257     public function loadParamArray($oParams)
258     {
259         $this->bIncludeAddressDetails
260          = $oParams->getBool('addressdetails', $this->bIncludeAddressDetails);
261         $this->bIncludeExtraTags
262          = $oParams->getBool('extratags', $this->bIncludeExtraTags);
263         $this->bIncludeNameDetails
264          = $oParams->getBool('namedetails', $this->bIncludeNameDetails);
265
266         $this->bBoundedSearch = $oParams->getBool('bounded', $this->bBoundedSearch);
267         $this->bDeDupe = $oParams->getBool('dedupe', $this->bDeDupe);
268
269         $this->setLimit($oParams->getInt('limit', $this->iFinalLimit));
270         $this->iOffset = $oParams->getInt('offset', $this->iOffset);
271
272         $this->bFallback = $oParams->getBool('fallback', $this->bFallback);
273
274         // List of excluded Place IDs - used for more acurate pageing
275         $sExcluded = $oParams->getStringList('exclude_place_ids');
276         if ($sExcluded) {
277             foreach ($sExcluded as $iExcludedPlaceID) {
278                 $iExcludedPlaceID = (int)$iExcludedPlaceID;
279                 if ($iExcludedPlaceID)
280                     $aExcludePlaceIDs[$iExcludedPlaceID] = $iExcludedPlaceID;
281             }
282
283             if (isset($aExcludePlaceIDs))
284                 $this->aExcludePlaceIDs = $aExcludePlaceIDs;
285         }
286
287         // Only certain ranks of feature
288         $sFeatureType = $oParams->getString('featureType');
289         if (!$sFeatureType) $sFeatureType = $oParams->getString('featuretype');
290         if ($sFeatureType) $this->setFeatureType($sFeatureType);
291
292         // Country code list
293         $sCountries = $oParams->getStringList('countrycodes');
294         if ($sCountries) {
295             foreach ($sCountries as $sCountryCode) {
296                 if (preg_match('/^[a-zA-Z][a-zA-Z]$/', $sCountryCode)) {
297                     $aCountries[] = strtolower($sCountryCode);
298                 }
299             }
300             if (isset($aCountries))
301                 $this->aCountryCodes = $aCountries;
302         }
303
304         $aViewbox = $oParams->getStringList('viewboxlbrt');
305         if ($aViewbox) {
306             if (count($aViewbox) != 4) {
307                 userError("Bad parmater 'viewboxlbrt'. Expected 4 coordinates.");
308             }
309             $this->setViewbox($aViewbox);
310         } else {
311             $aViewbox = $oParams->getStringList('viewbox');
312             if ($aViewbox) {
313                 if (count($aViewbox) != 4) {
314                     userError("Bad parmater 'viewbox'. Expected 4 coordinates.");
315                 }
316                 $this->setViewBox($aViewbox);
317             } else {
318                 $aRoute = $oParams->getStringList('route');
319                 $fRouteWidth = $oParams->getFloat('routewidth');
320                 if ($aRoute && $fRouteWidth) {
321                     $this->setRoute($aRoute, $fRouteWidth);
322                 }
323             }
324         }
325     }
326
327     public function setQueryFromParams($oParams)
328     {
329         // Search query
330         $sQuery = $oParams->getString('q');
331         if (!$sQuery) {
332             $this->setStructuredQuery(
333                 $oParams->getString('amenity'),
334                 $oParams->getString('street'),
335                 $oParams->getString('city'),
336                 $oParams->getString('county'),
337                 $oParams->getString('state'),
338                 $oParams->getString('country'),
339                 $oParams->getString('postalcode')
340             );
341             $this->setReverseInPlan(false);
342         } else {
343             $this->setQuery($sQuery);
344         }
345     }
346
347     public function loadStructuredAddressElement($sValue, $sKey, $iNewMinAddressRank, $iNewMaxAddressRank, $aItemListValues)
348     {
349         $sValue = trim($sValue);
350         if (!$sValue) return false;
351         $this->aStructuredQuery[$sKey] = $sValue;
352         if ($this->iMinAddressRank == 0 && $this->iMaxAddressRank == 30) {
353             $this->iMinAddressRank = $iNewMinAddressRank;
354             $this->iMaxAddressRank = $iNewMaxAddressRank;
355         }
356         if ($aItemListValues) $this->aAddressRankList = array_merge($this->aAddressRankList, $aItemListValues);
357         return true;
358     }
359
360     public function setStructuredQuery($sAmenity = false, $sStreet = false, $sCity = false, $sCounty = false, $sState = false, $sCountry = false, $sPostalCode = false)
361     {
362         $this->sQuery = false;
363
364         // Reset
365         $this->iMinAddressRank = 0;
366         $this->iMaxAddressRank = 30;
367         $this->aAddressRankList = array();
368
369         $this->aStructuredQuery = array();
370         $this->sAllowedTypesSQLList = False;
371
372         $this->loadStructuredAddressElement($sAmenity, 'amenity', 26, 30, false);
373         $this->loadStructuredAddressElement($sStreet, 'street', 26, 30, false);
374         $this->loadStructuredAddressElement($sCity, 'city', 14, 24, false);
375         $this->loadStructuredAddressElement($sCounty, 'county', 9, 13, false);
376         $this->loadStructuredAddressElement($sState, 'state', 8, 8, false);
377         $this->loadStructuredAddressElement($sPostalCode, 'postalcode', 5, 11, array(5, 11));
378         $this->loadStructuredAddressElement($sCountry, 'country', 4, 4, false);
379
380         if (sizeof($this->aStructuredQuery) > 0) {
381             $this->sQuery = join(', ', $this->aStructuredQuery);
382             if ($this->iMaxAddressRank < 30) {
383                 $this->sAllowedTypesSQLList = '(\'place\',\'boundary\')';
384             }
385         }
386     }
387
388     public function fallbackStructuredQuery()
389     {
390         if (!$this->aStructuredQuery) return false;
391
392         $aParams = $this->aStructuredQuery;
393
394         if (sizeof($aParams) == 1) return false;
395
396         $aOrderToFallback = array('postalcode', 'street', 'city', 'county', 'state');
397
398         foreach ($aOrderToFallback as $sType) {
399             if (isset($aParams[$sType])) {
400                 unset($aParams[$sType]);
401                 $this->setStructuredQuery(@$aParams['amenity'], @$aParams['street'], @$aParams['city'], @$aParams['county'], @$aParams['state'], @$aParams['country'], @$aParams['postalcode']);
402                 return true;
403             }
404         }
405
406         return false;
407     }
408
409     public function getDetails($aPlaceIDs)
410     {
411         //$aPlaceIDs is an array with key: placeID and value: tiger-housenumber, if found, else -1
412         if (sizeof($aPlaceIDs) == 0) return array();
413
414         $sLanguagePrefArraySQL = "ARRAY[".join(',', array_map("getDBQuoted", $this->aLangPrefOrder))."]";
415
416         // Get the details for display (is this a redundant extra step?)
417         $sPlaceIDs = join(',', array_keys($aPlaceIDs));
418
419         $sImportanceSQL = '';
420         $sImportanceSQLGeom = '';
421         if ($this->sViewboxSmallSQL) {
422             $sImportanceSQL .= " CASE WHEN ST_Contains($this->sViewboxSmallSQL, ST_Collect(centroid)) THEN 1 ELSE 0.75 END * ";
423             $sImportanceSQLGeom .= " CASE WHEN ST_Contains($this->sViewboxSmallSQL, geometry) THEN 1 ELSE 0.75 END * ";
424         }
425         if ($this->sViewboxLargeSQL) {
426             $sImportanceSQL .= " CASE WHEN ST_Contains($this->sViewboxLargeSQL, ST_Collect(centroid)) THEN 1 ELSE 0.75 END * ";
427             $sImportanceSQLGeom .= " CASE WHEN ST_Contains($this->sViewboxLargeSQL, geometry) THEN 1 ELSE 0.75 END * ";
428         }
429
430         $sSQL  = "SELECT ";
431         $sSQL .= "    osm_type,";
432         $sSQL .= "    osm_id,";
433         $sSQL .= "    class,";
434         $sSQL .= "    type,";
435         $sSQL .= "    admin_level,";
436         $sSQL .= "    rank_search,";
437         $sSQL .= "    rank_address,";
438         $sSQL .= "    min(place_id) AS place_id, ";
439         $sSQL .= "    min(parent_place_id) AS parent_place_id, ";
440         $sSQL .= "    country_code, ";
441         $sSQL .= "    get_address_by_language(place_id, -1, $sLanguagePrefArraySQL) AS langaddress,";
442         $sSQL .= "    get_name_by_language(name, $sLanguagePrefArraySQL) AS placename,";
443         $sSQL .= "    get_name_by_language(name, ARRAY['ref']) AS ref,";
444         if ($this->bIncludeExtraTags) $sSQL .= "hstore_to_json(extratags)::text AS extra,";
445         if ($this->bIncludeNameDetails) $sSQL .= "hstore_to_json(name)::text AS names,";
446         $sSQL .= "    avg(ST_X(centroid)) AS lon, ";
447         $sSQL .= "    avg(ST_Y(centroid)) AS lat, ";
448         $sSQL .= "    ".$sImportanceSQL."COALESCE(importance,0.75-(rank_search::float/40)) AS importance, ";
449         $sSQL .= "    ( ";
450         $sSQL .= "       SELECT max(p.importance*(p.rank_address+2))";
451         $sSQL .= "       FROM ";
452         $sSQL .= "         place_addressline s, ";
453         $sSQL .= "         placex p";
454         $sSQL .= "       WHERE s.place_id = min(CASE WHEN placex.rank_search < 28 THEN placex.place_id ELSE placex.parent_place_id END)";
455         $sSQL .= "         AND p.place_id = s.address_place_id ";
456         $sSQL .= "         AND s.isaddress ";
457         $sSQL .= "         AND p.importance is not null ";
458         $sSQL .= "    ) AS addressimportance, ";
459         $sSQL .= "    (extratags->'place') AS extra_place ";
460         $sSQL .= " FROM placex";
461         $sSQL .= " WHERE place_id in ($sPlaceIDs) ";
462         $sSQL .= "   AND (";
463         $sSQL .= "            placex.rank_address between $this->iMinAddressRank and $this->iMaxAddressRank ";
464         if (14 >= $this->iMinAddressRank && 14 <= $this->iMaxAddressRank) {
465             $sSQL .= "        OR (extratags->'place') = 'city'";
466         }
467         if ($this->aAddressRankList) {
468             $sSQL .= "        OR placex.rank_address in (".join(',', $this->aAddressRankList).")";
469         }
470         $sSQL .= "       ) ";
471         if ($this->sAllowedTypesSQLList) {
472             $sSQL .= "AND placex.class in $this->sAllowedTypesSQLList ";
473         }
474         $sSQL .= "    AND linked_place_id is null ";
475         $sSQL .= " GROUP BY ";
476         $sSQL .= "     osm_type, ";
477         $sSQL .= "     osm_id, ";
478         $sSQL .= "     class, ";
479         $sSQL .= "     type, ";
480         $sSQL .= "     admin_level, ";
481         $sSQL .= "     rank_search, ";
482         $sSQL .= "     rank_address, ";
483         $sSQL .= "     country_code, ";
484         $sSQL .= "     importance, ";
485         if (!$this->bDeDupe) $sSQL .= "place_id,";
486         $sSQL .= "     langaddress, ";
487         $sSQL .= "     placename, ";
488         $sSQL .= "     ref, ";
489         if ($this->bIncludeExtraTags) $sSQL .= "extratags, ";
490         if ($this->bIncludeNameDetails) $sSQL .= "name, ";
491         $sSQL .= "     extratags->'place' ";
492
493         // postcode table
494         $sSQL .= "UNION ";
495         $sSQL .= "SELECT";
496         $sSQL .= "  'P' as osm_type,";
497         $sSQL .= "  (SELECT osm_id from placex p WHERE p.place_id = lp.parent_place_id) as osm_id,";
498         $sSQL .= "  'place' as class, 'postcode' as type,";
499         $sSQL .= "  null as admin_level, rank_search, rank_address,";
500         $sSQL .= "  place_id, parent_place_id, country_code,";
501         $sSQL .= "  get_address_by_language(place_id, -1, $sLanguagePrefArraySQL) AS langaddress,";
502         $sSQL .= "  postcode as placename,";
503         $sSQL .= "  postcode as ref,";
504         if ($this->bIncludeExtraTags) $sSQL .= "null AS extra,";
505         if ($this->bIncludeNameDetails) $sSQL .= "null AS names,";
506         $sSQL .= "  ST_x(st_centroid(geometry)) AS lon, ST_y(st_centroid(geometry)) AS lat,";
507         $sSQL .=    $sImportanceSQLGeom."(0.75-(rank_search::float/40)) AS importance, ";
508         $sSQL .= "  (";
509         $sSQL .= "     SELECT max(p.importance*(p.rank_address+2))";
510         $sSQL .= "     FROM ";
511         $sSQL .= "       place_addressline s, ";
512         $sSQL .= "       placex p";
513         $sSQL .= "     WHERE s.place_id = lp.parent_place_id";
514         $sSQL .= "       AND p.place_id = s.address_place_id ";
515         $sSQL .= "       AND s.isaddress";
516         $sSQL .= "       AND p.importance is not null";
517         $sSQL .= "  ) AS addressimportance, ";
518         $sSQL .= "  null AS extra_place ";
519         $sSQL .= "FROM location_postcode lp";
520         $sSQL .= " WHERE place_id in ($sPlaceIDs) ";
521
522         if (30 >= $this->iMinAddressRank && 30 <= $this->iMaxAddressRank) {
523             // only Tiger housenumbers and interpolation lines need to be interpolated, because they are saved as lines
524             // with start- and endnumber, the common osm housenumbers are usually saved as points
525             $sHousenumbers = "";
526             $i = 0;
527             $length = count($aPlaceIDs);
528             foreach ($aPlaceIDs as $placeID => $housenumber) {
529                 $i++;
530                 $sHousenumbers .= "(".$placeID.", ".$housenumber.")";
531                 if ($i<$length) $sHousenumbers .= ", ";
532             }
533
534             if (CONST_Use_US_Tiger_Data) {
535                 // Tiger search only if a housenumber was searched and if it was found (i.e. aPlaceIDs[placeID] = housenumber != -1) (realized through a join)
536                 $sSQL .= " union";
537                 $sSQL .= " SELECT ";
538                 $sSQL .= "     'T' AS osm_type, ";
539                 $sSQL .= "     (SELECT osm_id from placex p WHERE p.place_id=min(blub.parent_place_id)) as osm_id, ";
540                 $sSQL .= "     'place' AS class, ";
541                 $sSQL .= "     'house' AS type, ";
542                 $sSQL .= "     null AS admin_level, ";
543                 $sSQL .= "     30 AS rank_search, ";
544                 $sSQL .= "     30 AS rank_address, ";
545                 $sSQL .= "     min(place_id) AS place_id, ";
546                 $sSQL .= "     min(parent_place_id) AS parent_place_id, ";
547                 $sSQL .= "     'us' AS country_code, ";
548                 $sSQL .= "     get_address_by_language(place_id, housenumber_for_place, $sLanguagePrefArraySQL) AS langaddress,";
549                 $sSQL .= "     null AS placename, ";
550                 $sSQL .= "     null AS ref, ";
551                 if ($this->bIncludeExtraTags) $sSQL .= "null AS extra,";
552                 if ($this->bIncludeNameDetails) $sSQL .= "null AS names,";
553                 $sSQL .= "     avg(st_x(centroid)) AS lon, ";
554                 $sSQL .= "     avg(st_y(centroid)) AS lat,";
555                 $sSQL .= "     ".$sImportanceSQL."-1.15 AS importance, ";
556                 $sSQL .= "     (";
557                 $sSQL .= "        SELECT max(p.importance*(p.rank_address+2))";
558                 $sSQL .= "        FROM ";
559                 $sSQL .= "          place_addressline s, ";
560                 $sSQL .= "          placex p";
561                 $sSQL .= "        WHERE s.place_id = min(blub.parent_place_id)";
562                 $sSQL .= "          AND p.place_id = s.address_place_id ";
563                 $sSQL .= "          AND s.isaddress";
564                 $sSQL .= "          AND p.importance is not null";
565                 $sSQL .= "     ) AS addressimportance, ";
566                 $sSQL .= "     null AS extra_place ";
567                 $sSQL .= " FROM (";
568                 $sSQL .= "     SELECT place_id, ";    // interpolate the Tiger housenumbers here
569                 $sSQL .= "         ST_LineInterpolatePoint(linegeo, (housenumber_for_place-startnumber::float)/(endnumber-startnumber)::float) AS centroid, ";
570                 $sSQL .= "         parent_place_id, ";
571                 $sSQL .= "         housenumber_for_place";
572                 $sSQL .= "     FROM (";
573                 $sSQL .= "            location_property_tiger ";
574                 $sSQL .= "            JOIN (values ".$sHousenumbers.") AS housenumbers(place_id, housenumber_for_place) USING(place_id)) ";
575                 $sSQL .= "     WHERE ";
576                 $sSQL .= "         housenumber_for_place>=0";
577                 $sSQL .= "         AND 30 between $this->iMinAddressRank AND $this->iMaxAddressRank";
578                 $sSQL .= " ) AS blub"; //postgres wants an alias here
579                 $sSQL .= " GROUP BY";
580                 $sSQL .= "      place_id, ";
581                 $sSQL .= "      housenumber_for_place"; //is this group by really needed?, place_id + housenumber (in combination) are unique
582                 if (!$this->bDeDupe) $sSQL .= ", place_id ";
583             }
584             // osmline
585             // interpolation line search only if a housenumber was searched and if it was found (i.e. aPlaceIDs[placeID] = housenumber != -1) (realized through a join)
586             $sSQL .= " UNION ";
587             $sSQL .= "SELECT ";
588             $sSQL .= "  'W' AS osm_type, ";
589             $sSQL .= "  osm_id, ";
590             $sSQL .= "  'place' AS class, ";
591             $sSQL .= "  'house' AS type, ";
592             $sSQL .= "  null AS admin_level, ";
593             $sSQL .= "  30 AS rank_search, ";
594             $sSQL .= "  30 AS rank_address, ";
595             $sSQL .= "  min(place_id) as place_id, ";
596             $sSQL .= "  min(parent_place_id) AS parent_place_id, ";
597             $sSQL .= "  country_code, ";
598             $sSQL .= "  get_address_by_language(place_id, housenumber_for_place, $sLanguagePrefArraySQL) AS langaddress, ";
599             $sSQL .= "  null AS placename, ";
600             $sSQL .= "  null AS ref, ";
601             if ($this->bIncludeExtraTags) $sSQL .= "null AS extra, ";
602             if ($this->bIncludeNameDetails) $sSQL .= "null AS names, ";
603             $sSQL .= "  AVG(st_x(centroid)) AS lon, ";
604             $sSQL .= "  AVG(st_y(centroid)) AS lat, ";
605             $sSQL .= "  ".$sImportanceSQL."-0.1 AS importance, ";  // slightly smaller than the importance for normal houses with rank 30, which is 0
606             $sSQL .= "  (";
607             $sSQL .= "     SELECT ";
608             $sSQL .= "       MAX(p.importance*(p.rank_address+2)) ";
609             $sSQL .= "     FROM";
610             $sSQL .= "       place_addressline s, ";
611             $sSQL .= "       placex p";
612             $sSQL .= "     WHERE s.place_id = min(blub.parent_place_id) ";
613             $sSQL .= "       AND p.place_id = s.address_place_id ";
614             $sSQL .= "       AND s.isaddress ";
615             $sSQL .= "       AND p.importance is not null";
616             $sSQL .= "  ) AS addressimportance,";
617             $sSQL .= "  null AS extra_place ";
618             $sSQL .= "  FROM (";
619             $sSQL .= "     SELECT ";
620             $sSQL .= "         osm_id, ";
621             $sSQL .= "         place_id, ";
622             $sSQL .= "         country_code, ";
623             $sSQL .= "         CASE ";             // interpolate the housenumbers here
624             $sSQL .= "           WHEN startnumber != endnumber ";
625             $sSQL .= "           THEN ST_LineInterpolatePoint(linegeo, (housenumber_for_place-startnumber::float)/(endnumber-startnumber)::float) ";
626             $sSQL .= "           ELSE ST_LineInterpolatePoint(linegeo, 0.5) ";
627             $sSQL .= "         END as centroid, ";
628             $sSQL .= "         parent_place_id, ";
629             $sSQL .= "         housenumber_for_place ";
630             $sSQL .= "     FROM (";
631             $sSQL .= "            location_property_osmline ";
632             $sSQL .= "            JOIN (values ".$sHousenumbers.") AS housenumbers(place_id, housenumber_for_place) USING(place_id)";
633             $sSQL .= "          ) ";
634             $sSQL .= "     WHERE housenumber_for_place>=0 ";
635             $sSQL .= "       AND 30 between $this->iMinAddressRank AND $this->iMaxAddressRank";
636             $sSQL .= "  ) as blub"; //postgres wants an alias here
637             $sSQL .= "  GROUP BY ";
638             $sSQL .= "    osm_id, ";
639             $sSQL .= "    place_id, ";
640             $sSQL .= "    housenumber_for_place, ";
641             $sSQL .= "    country_code "; //is this group by really needed?, place_id + housenumber (in combination) are unique
642             if (!$this->bDeDupe) $sSQL .= ", place_id ";
643
644             if (CONST_Use_Aux_Location_data) {
645                 $sSQL .= " UNION ";
646                 $sSQL .= "  SELECT ";
647                 $sSQL .= "     'L' AS osm_type, ";
648                 $sSQL .= "     place_id AS osm_id, ";
649                 $sSQL .= "     'place' AS class,";
650                 $sSQL .= "     'house' AS type, ";
651                 $sSQL .= "     null AS admin_level, ";
652                 $sSQL .= "     0 AS rank_search,";
653                 $sSQL .= "     0 AS rank_address, ";
654                 $sSQL .= "     min(place_id) AS place_id,";
655                 $sSQL .= "     min(parent_place_id) AS parent_place_id, ";
656                 $sSQL .= "     'us' AS country_code, ";
657                 $sSQL .= "     get_address_by_language(place_id, -1, $sLanguagePrefArraySQL) AS langaddress, ";
658                 $sSQL .= "     null AS placename, ";
659                 $sSQL .= "     null AS ref, ";
660                 if ($this->bIncludeExtraTags) $sSQL .= "null AS extra, ";
661                 if ($this->bIncludeNameDetails) $sSQL .= "null AS names, ";
662                 $sSQL .= "     avg(ST_X(centroid)) AS lon, ";
663                 $sSQL .= "     avg(ST_Y(centroid)) AS lat, ";
664                 $sSQL .= "     ".$sImportanceSQL."-1.10 AS importance, ";
665                 $sSQL .= "     ( ";
666                 $sSQL .= "       SELECT max(p.importance*(p.rank_address+2))";
667                 $sSQL .= "       FROM ";
668                 $sSQL .= "          place_addressline s, ";
669                 $sSQL .= "          placex p";
670                 $sSQL .= "       WHERE s.place_id = min(location_property_aux.parent_place_id)";
671                 $sSQL .= "         AND p.place_id = s.address_place_id ";
672                 $sSQL .= "         AND s.isaddress";
673                 $sSQL .= "         AND p.importance is not null";
674                 $sSQL .= "     ) AS addressimportance, ";
675                 $sSQL .= "     null AS extra_place ";
676                 $sSQL .= "  FROM location_property_aux ";
677                 $sSQL .= "  WHERE place_id in ($sPlaceIDs) ";
678                 $sSQL .= "    AND 30 between $this->iMinAddressRank and $this->iMaxAddressRank ";
679                 $sSQL .= "  GROUP BY ";
680                 $sSQL .= "     place_id, ";
681                 if (!$this->bDeDupe) $sSQL .= "place_id, ";
682                 $sSQL .= "     get_address_by_language(place_id, -1, $sLanguagePrefArraySQL) ";
683             }
684         }
685
686         $sSQL .= " order by importance desc";
687         if (CONST_Debug) {
688             echo "<hr>";
689             var_dump($sSQL);
690         }
691         $aSearchResults = chksql(
692             $this->oDB->getAll($sSQL),
693             "Could not get details for place."
694         );
695
696         return $aSearchResults;
697     }
698
699     public function getGroupedSearches($aSearches, $aPhraseTypes, $aPhrases, $aValidTokens, $aWordFrequencyScores, $bStructuredPhrases, $sNormQuery)
700     {
701         /*
702              Calculate all searches using aValidTokens i.e.
703              'Wodsworth Road, Sheffield' =>
704
705              Phrase Wordset
706              0      0       (wodsworth road)
707              0      1       (wodsworth)(road)
708              1      0       (sheffield)
709
710              Score how good the search is so they can be ordered
711          */
712         $iGlobalRank = 0;
713
714         foreach ($aPhrases as $iPhrase => $aPhrase) {
715             $aNewPhraseSearches = array();
716             if ($bStructuredPhrases) $sPhraseType = $aPhraseTypes[$iPhrase];
717             else $sPhraseType = '';
718
719             foreach ($aPhrase['wordsets'] as $iWordSet => $aWordset) {
720                 // Too many permutations - too expensive
721                 if ($iWordSet > 120) break;
722
723                 $aWordsetSearches = $aSearches;
724
725                 // Add all words from this wordset
726                 foreach ($aWordset as $iToken => $sToken) {
727                     //echo "<br><b>$sToken</b>";
728                     $aNewWordsetSearches = array();
729
730                     foreach ($aWordsetSearches as $aCurrentSearch) {
731                         //echo "<i>";
732                         //var_dump($aCurrentSearch);
733                         //echo "</i>";
734
735                         // If the token is valid
736                         if (isset($aValidTokens[' '.$sToken])) {
737                             // TODO variable should go into aCurrentSearch
738                             $bHavePostcode = false;
739                             foreach ($aValidTokens[' '.$sToken] as $aSearchTerm) {
740                                 $aSearch = $aCurrentSearch;
741                                 $aSearch['iSearchRank']++;
742                                 if (($sPhraseType == '' || $sPhraseType == 'country') && !empty($aSearchTerm['country_code']) && $aSearchTerm['country_code'] != '0') {
743                                     if ($aSearch['sCountryCode'] === false) {
744                                         $aSearch['sCountryCode'] = strtolower($aSearchTerm['country_code']);
745                                         // Country is almost always at the end of the string - increase score for finding it anywhere else (optimisation)
746                                         if (($iToken+1 != sizeof($aWordset) || $iPhrase+1 != sizeof($aPhrases))) {
747                                             $aSearch['iSearchRank'] += 5;
748                                         }
749                                         if ($aSearch['iSearchRank'] < $this->iMaxRank) $aNewWordsetSearches[] = $aSearch;
750                                         // If it is at the beginning, we can be almost sure that this is the wrong order
751                                         // Increase score for all searches.
752                                         if ($iToken == 0 && $iPhrase == 0) {
753                                             $iGlobalRank++;
754                                         }
755                                     }
756                                 } elseif (($sPhraseType == '' || $sPhraseType == 'postalcode') && $aSearchTerm['class'] == 'place' && $aSearchTerm['type'] == 'postcode') {
757                                     // We need to try the case where the postal code is the primary element (i.e. no way to tell if it is (postalcode, city) OR (city, postalcode) so try both
758                                     if ($aSearch['sPostcode'] === '' &&
759                                         isset($aSearchTerm['word']) && $aSearchTerm['word'] && strpos($sNormQuery, $this->normTerm($aSearchTerm['word'])) !== false) {
760                                         // If we have structured search or this is the first term,
761                                         // make the postcode the primary search element.
762                                         if (!$bHavePostcode && $aSearch['sOperator'] === '' && ($sPhraseType == 'postalcode' || ($iToken == 0 && $iPhrase == 0))) {
763                                             $aNewSearch = $aSearch;
764                                             $aNewSearch['sOperator'] = 'postcode';
765                                             $aNewSearch['aAddress'] = array_merge($aNewSearch['aAddress'], $aNewSearch['aName']);
766                                             $aNewSearch['aName'] = array($aSearchTerm['word_id'] => $aSearchTerm['word']);
767                                             if ($aSearch['iSearchRank'] < $this->iMaxRank) $aNewWordsetSearches[] = $aNewSearch;
768                                             $bHavePostcode = true;
769                                         }
770
771                                         // If we have a structured search or this is not the first term,
772                                         // add the postcode as an addendum.
773                                         if ($aSearch['sOperator'] !== 'postcode' && ($sPhraseType == 'postalcode' || sizeof($aSearch['aName']))) {
774                                             $aSearch['sPostcode'] = $aSearchTerm['word'];
775                                             if ($aSearch['iSearchRank'] < $this->iMaxRank) $aNewWordsetSearches[] = $aSearch;
776                                         }
777                                     }
778                                 } elseif (($sPhraseType == '' || $sPhraseType == 'street') && $aSearchTerm['class'] == 'place' && $aSearchTerm['type'] == 'house') {
779                                     if ($aSearch['sHouseNumber'] === '' && $aSearch['sOperator'] !== 'postcode') {
780                                         $aSearch['sHouseNumber'] = $sToken;
781                                         // sanity check: if the housenumber is not mainly made
782                                         // up of numbers, add a penalty
783                                         if (preg_match_all("/[^0-9]/", $sToken, $aMatches) > 2) $aSearch['iSearchRank']++;
784                                         // also must not appear in the middle of the address
785                                         if ($aSearch['aAddress'] || $aSearch['aAddressNonSearch']) $aSearch['iSearchRank'] += 1;
786                                         if ($aSearch['iSearchRank'] < $this->iMaxRank) $aNewWordsetSearches[] = $aSearch;
787                                         /*
788                                         // Fall back to not searching for this item (better than nothing)
789                                         $aSearch = $aCurrentSearch;
790                                         $aSearch['iSearchRank'] += 1;
791                                         if ($aSearch['iSearchRank'] < $this->iMaxRank) $aNewWordsetSearches[] = $aSearch;
792                                          */
793                                     }
794                                 } elseif ($sPhraseType == '' && $aSearchTerm['class'] !== '' && $aSearchTerm['class'] !== null) {
795                                     // require a normalized exact match of the term
796                                     // if we have the normalizer version of the query
797                                     // available
798                                     if ($aSearch['sOperator'] === ''
799                                         && ($sNormQuery === null || !($aSearchTerm['word'] && strpos($sNormQuery, $aSearchTerm['word']) === false))) {
800                                         $aSearch['sClass'] = $aSearchTerm['class'];
801                                         $aSearch['sType'] = $aSearchTerm['type'];
802                                         if ($aSearchTerm['operator'] == '') {
803                                             $aSearch['sOperator'] = sizeof($aSearch['aName']) ? 'name' :  'near';
804                                             $aSearch['iSearchRank'] += 2;
805                                         } else {
806                                             $aSearch['sOperator'] = 'near'; // near = in for the moment
807                                         }
808
809                                         if ($aSearch['iSearchRank'] < $this->iMaxRank) $aNewWordsetSearches[] = $aSearch;
810                                     }
811                                 } elseif (isset($aSearchTerm['word_id']) && $aSearchTerm['word_id']) {
812                                     if (sizeof($aSearch['aName'])) {
813                                         if ((!$bStructuredPhrases || $iPhrase > 0) && $sPhraseType != 'country' && (!isset($aValidTokens[$sToken]) || strpos($sToken, ' ') !== false)) {
814                                             $aSearch['aAddress'][$aSearchTerm['word_id']] = $aSearchTerm['word_id'];
815                                         } else {
816                                             $aCurrentSearch['aFullNameAddress'][$aSearchTerm['word_id']] = $aSearchTerm['word_id'];
817                                             $aSearch['iSearchRank'] += 1000; // skip;
818                                         }
819                                     } else {
820                                         $aSearch['aName'][$aSearchTerm['word_id']] = $aSearchTerm['word_id'];
821                                         //$aSearch['iNamePhrase'] = $iPhrase;
822                                     }
823                                     if ($aSearch['iSearchRank'] < $this->iMaxRank) $aNewWordsetSearches[] = $aSearch;
824                                 }
825                             }
826                         }
827                         // Look for partial matches.
828                         // Note that there is no point in adding country terms here
829                         // because country are omitted in the address.
830                         if (isset($aValidTokens[$sToken]) && $sPhraseType != 'country') {
831                             // Allow searching for a word - but at extra cost
832                             foreach ($aValidTokens[$sToken] as $aSearchTerm) {
833                                 if (isset($aSearchTerm['word_id']) && $aSearchTerm['word_id']) {
834                                     if ((!$bStructuredPhrases || $iPhrase > 0) && sizeof($aCurrentSearch['aName']) && strpos($sToken, ' ') === false) {
835                                         $aSearch = $aCurrentSearch;
836                                         $aSearch['iSearchRank'] += 1;
837                                         if ($aWordFrequencyScores[$aSearchTerm['word_id']] < CONST_Max_Word_Frequency) {
838                                             $aSearch['aAddress'][$aSearchTerm['word_id']] = $aSearchTerm['word_id'];
839                                             if ($aSearch['iSearchRank'] < $this->iMaxRank) $aNewWordsetSearches[] = $aSearch;
840                                         } elseif (isset($aValidTokens[' '.$sToken])) { // revert to the token version?
841                                             $aSearch['aAddressNonSearch'][$aSearchTerm['word_id']] = $aSearchTerm['word_id'];
842                                             $aSearch['iSearchRank'] += 1;
843                                             if ($aSearch['iSearchRank'] < $this->iMaxRank) $aNewWordsetSearches[] = $aSearch;
844                                             foreach ($aValidTokens[' '.$sToken] as $aSearchTermToken) {
845                                                 if (empty($aSearchTermToken['country_code'])
846                                                     && empty($aSearchTermToken['lat'])
847                                                     && empty($aSearchTermToken['class'])
848                                                 ) {
849                                                     $aSearch = $aCurrentSearch;
850                                                     $aSearch['iSearchRank'] += 1;
851                                                     $aSearch['aAddress'][$aSearchTermToken['word_id']] = $aSearchTermToken['word_id'];
852                                                     if ($aSearch['iSearchRank'] < $this->iMaxRank) $aNewWordsetSearches[] = $aSearch;
853                                                 }
854                                             }
855                                         } else {
856                                             $aSearch['aAddressNonSearch'][$aSearchTerm['word_id']] = $aSearchTerm['word_id'];
857                                             if (preg_match('#^[0-9]+$#', $sToken)) $aSearch['iSearchRank'] += 2;
858                                             if ($aSearch['iSearchRank'] < $this->iMaxRank) $aNewWordsetSearches[] = $aSearch;
859                                         }
860                                     }
861
862                                     if ((!$aCurrentSearch['sPostcode'] && !$aCurrentSearch['aAddress'] && !$aCurrentSearch['aAddressNonSearch'])
863                                         && (!sizeof($aCurrentSearch['aName']) || $aCurrentSearch['iNamePhrase'] == $iPhrase)) {
864                                         $aSearch = $aCurrentSearch;
865                                         $aSearch['iSearchRank'] += 1;
866                                         if (!sizeof($aCurrentSearch['aName'])) $aSearch['iSearchRank'] += 1;
867                                         if (preg_match('#^[0-9]+$#', $sToken)) $aSearch['iSearchRank'] += 2;
868                                         if ($aWordFrequencyScores[$aSearchTerm['word_id']] < CONST_Max_Word_Frequency) {
869                                             $aSearch['aName'][$aSearchTerm['word_id']] = $aSearchTerm['word_id'];
870                                         } else {
871                                             $aSearch['aNameNonSearch'][$aSearchTerm['word_id']] = $aSearchTerm['word_id'];
872                                         }
873                                         $aSearch['iNamePhrase'] = $iPhrase;
874                                         if ($aSearch['iSearchRank'] < $this->iMaxRank) $aNewWordsetSearches[] = $aSearch;
875                                     }
876                                 }
877                             }
878                         } else {
879                             // Allow skipping a word - but at EXTREAM cost
880                             //$aSearch = $aCurrentSearch;
881                             //$aSearch['iSearchRank']+=100;
882                             //$aNewWordsetSearches[] = $aSearch;
883                         }
884                     }
885                     // Sort and cut
886                     usort($aNewWordsetSearches, 'bySearchRank');
887                     $aWordsetSearches = array_slice($aNewWordsetSearches, 0, 50);
888                 }
889                 //var_Dump('<hr>',sizeof($aWordsetSearches)); exit;
890
891                 $aNewPhraseSearches = array_merge($aNewPhraseSearches, $aNewWordsetSearches);
892                 usort($aNewPhraseSearches, 'bySearchRank');
893
894                 $aSearchHash = array();
895                 foreach ($aNewPhraseSearches as $iSearch => $aSearch) {
896                     $sHash = serialize($aSearch);
897                     if (isset($aSearchHash[$sHash])) unset($aNewPhraseSearches[$iSearch]);
898                     else $aSearchHash[$sHash] = 1;
899                 }
900
901                 $aNewPhraseSearches = array_slice($aNewPhraseSearches, 0, 50);
902             }
903
904             // Re-group the searches by their score, junk anything over 20 as just not worth trying
905             $aGroupedSearches = array();
906             foreach ($aNewPhraseSearches as $aSearch) {
907                 if ($aSearch['iSearchRank'] < $this->iMaxRank) {
908                     if (!isset($aGroupedSearches[$aSearch['iSearchRank']])) $aGroupedSearches[$aSearch['iSearchRank']] = array();
909                     $aGroupedSearches[$aSearch['iSearchRank']][] = $aSearch;
910                 }
911             }
912             ksort($aGroupedSearches);
913
914             $iSearchCount = 0;
915             $aSearches = array();
916             foreach ($aGroupedSearches as $iScore => $aNewSearches) {
917                 $iSearchCount += sizeof($aNewSearches);
918                 $aSearches = array_merge($aSearches, $aNewSearches);
919                 if ($iSearchCount > 50) break;
920             }
921
922             //if (CONST_Debug) _debugDumpGroupedSearches($aGroupedSearches, $aValidTokens);
923         }
924
925         // Revisit searches, giving penalty to unlikely combinations
926         $aGroupedSearches = array();
927         foreach ($aSearches as $aSearch) {
928             if (!$aSearch['aName']) {
929                 if ($aSearch['sHouseNumber']) {
930                     continue;
931                 }
932             }
933             $aSearch['iSearchRank'] += $iGlobalRank;
934             $aGroupedSearches[$aSearch['iSearchRank']][] = $aSearch;
935         }
936         ksort($aGroupedSearches);
937
938         return $aGroupedSearches;
939     }
940
941     /* Perform the actual query lookup.
942
943         Returns an ordered list of results, each with the following fields:
944             osm_type: type of corresponding OSM object
945                         N - node
946                         W - way
947                         R - relation
948                         P - postcode (internally computed)
949             osm_id: id of corresponding OSM object
950             class: general object class (corresponds to tag key of primary OSM tag)
951             type: subclass of object (corresponds to tag value of primary OSM tag)
952             admin_level: see http://wiki.openstreetmap.org/wiki/Admin_level
953             rank_search: rank in search hierarchy
954                         (see also http://wiki.openstreetmap.org/wiki/Nominatim/Development_overview#Country_to_street_level)
955             rank_address: rank in address hierarchy (determines orer in address)
956             place_id: internal key (may differ between different instances)
957             country_code: ISO country code
958             langaddress: localized full address
959             placename: localized name of object
960             ref: content of ref tag (if available)
961             lon: longitude
962             lat: latitude
963             importance: importance of place based on Wikipedia link count
964             addressimportance: cumulated importance of address elements
965             extra_place: type of place (for admin boundaries, if there is a place tag)
966             aBoundingBox: bounding Box
967             label: short description of the object class/type (English only)
968             name: full name (currently the same as langaddress)
969             foundorder: secondary ordering for places with same importance
970     */
971
972
973     public function lookup()
974     {
975         if (!$this->sQuery && !$this->aStructuredQuery) return array();
976
977         $sNormQuery = $this->normTerm($this->sQuery);
978         $sLanguagePrefArraySQL = "ARRAY[".join(',', array_map("getDBQuoted", $this->aLangPrefOrder))."]";
979         $sCountryCodesSQL = false;
980         if ($this->aCountryCodes) {
981             $sCountryCodesSQL = join(',', array_map('addQuotes', $this->aCountryCodes));
982         }
983
984         $sQuery = $this->sQuery;
985         if (!preg_match('//u', $sQuery)) {
986             userError("Query string is not UTF-8 encoded.");
987         }
988
989         // Conflicts between US state abreviations and various words for 'the' in different languages
990         if (isset($this->aLangPrefOrder['name:en'])) {
991             $sQuery = preg_replace('/(^|,)\s*il\s*(,|$)/', '\1illinois\2', $sQuery);
992             $sQuery = preg_replace('/(^|,)\s*al\s*(,|$)/', '\1alabama\2', $sQuery);
993             $sQuery = preg_replace('/(^|,)\s*la\s*(,|$)/', '\1louisiana\2', $sQuery);
994         }
995
996         $bBoundingBoxSearch = $this->bBoundedSearch && $this->sViewboxSmallSQL;
997         if ($this->sViewboxCentreSQL) {
998             // For complex viewboxes (routes) precompute the bounding geometry
999             $sGeom = chksql(
1000                 $this->oDB->getOne("select ".$this->sViewboxSmallSQL),
1001                 "Could not get small viewbox"
1002             );
1003             $this->sViewboxSmallSQL = "'".$sGeom."'::geometry";
1004
1005             $sGeom = chksql(
1006                 $this->oDB->getOne("select ".$this->sViewboxLargeSQL),
1007                 "Could not get large viewbox"
1008             );
1009             $this->sViewboxLargeSQL = "'".$sGeom."'::geometry";
1010         }
1011
1012         // Do we have anything that looks like a lat/lon pair?
1013         $oNearPoint = false;
1014         if ($aLooksLike = NearPoint::extractFromQuery($sQuery)) {
1015             $oNearPoint = $aLooksLike['pt'];
1016             $sQuery = $aLooksLike['query'];
1017         }
1018
1019         $aSearchResults = array();
1020         if ($sQuery || $this->aStructuredQuery) {
1021             // Start with a blank search
1022             $aSearches = array(
1023                           array(
1024                            'iSearchRank' => 0,
1025                            'iNamePhrase' => -1,
1026                            'sCountryCode' => false,
1027                            'aName' => array(),
1028                            'aAddress' => array(),
1029                            'aFullNameAddress' => array(),
1030                            'aNameNonSearch' => array(),
1031                            'aAddressNonSearch' => array(),
1032                            'sOperator' => '',
1033                            'aFeatureName' => array(),
1034                            'sClass' => '',
1035                            'sType' => '',
1036                            'sHouseNumber' => '',
1037                            'sPostcode' => '',
1038                            'oNear' => $oNearPoint
1039                           )
1040                          );
1041
1042             // Any 'special' terms in the search?
1043             $bSpecialTerms = false;
1044             preg_match_all('/\\[([\\w_]*)=([\\w_]*)\\]/', $sQuery, $aSpecialTermsRaw, PREG_SET_ORDER);
1045             foreach ($aSpecialTermsRaw as $aSpecialTerm) {
1046                 $sQuery = str_replace($aSpecialTerm[0], ' ', $sQuery);
1047                 if (!$bSpecialTerms) {
1048                     $aNewSearches = array();
1049                     foreach ($aSearches as $aSearch) {
1050                         $aNewSearch = $aSearch;
1051                         $aNewSearch['sClass'] = $aSpecialTerm[1];
1052                         $aNewSearch['sType'] = $aSpecialTerm[2];
1053                         $aNewSearches[] = $aNewSearch;
1054                     }
1055
1056                     $aSearches = $aNewSearches;
1057                     $bSpecialTerms = true;
1058                 }
1059             }
1060
1061             preg_match_all('/\\[([\\w ]*)\\]/u', $sQuery, $aSpecialTermsRaw, PREG_SET_ORDER);
1062             if (isset($this->aStructuredQuery['amenity']) && $this->aStructuredQuery['amenity']) {
1063                 $aSpecialTermsRaw[] = array('['.$this->aStructuredQuery['amenity'].']', $this->aStructuredQuery['amenity']);
1064                 unset($this->aStructuredQuery['amenity']);
1065             }
1066
1067             foreach ($aSpecialTermsRaw as $aSpecialTerm) {
1068                 $sQuery = str_replace($aSpecialTerm[0], ' ', $sQuery);
1069                 if ($bSpecialTerms) {
1070                     continue;
1071                 }
1072
1073                 $sToken = chksql($this->oDB->getOne("SELECT make_standard_name('".pg_escape_string($aSpecialTerm[1])."') AS string"));
1074                 $sSQL = 'SELECT * ';
1075                 $sSQL .= 'FROM ( ';
1076                 $sSQL .= '   SELECT word_id, word_token, word, class, type, country_code, operator';
1077                 $sSQL .= '   FROM word ';
1078                 $sSQL .= '   WHERE word_token in (\' '.$sToken.'\')';
1079                 $sSQL .= ') AS x ';
1080                 $sSQL .= ' WHERE (class is not null AND class not in (\'place\'))';
1081                 if (CONST_Debug) var_Dump($sSQL);
1082                 $aSearchWords = chksql($this->oDB->getAll($sSQL));
1083                 $aNewSearches = array();
1084                 foreach ($aSearches as $aSearch) {
1085                     foreach ($aSearchWords as $aSearchTerm) {
1086                         $aNewSearch = $aSearch;
1087                         $aNewSearch['sClass'] = $aSearchTerm['class'];
1088                         $aNewSearch['sType'] = $aSearchTerm['type'];
1089                         $aNewSearches[] = $aNewSearch;
1090                         $bSpecialTerms = true;
1091                     }
1092                 }
1093                 $aSearches = $aNewSearches;
1094             }
1095
1096             // Split query into phrases
1097             // Commas are used to reduce the search space by indicating where phrases split
1098             if ($this->aStructuredQuery) {
1099                 $aPhrases = $this->aStructuredQuery;
1100                 $bStructuredPhrases = true;
1101             } else {
1102                 $aPhrases = explode(',', $sQuery);
1103                 $bStructuredPhrases = false;
1104             }
1105
1106             // Convert each phrase to standard form
1107             // Create a list of standard words
1108             // Get all 'sets' of words
1109             // Generate a complete list of all
1110             $aTokens = array();
1111             foreach ($aPhrases as $iPhrase => $sPhrase) {
1112                 $aPhrase = chksql(
1113                     $this->oDB->getRow("SELECT make_standard_name('".pg_escape_string($sPhrase)."') as string"),
1114                     "Cannot normalize query string (is it a UTF-8 string?)"
1115                 );
1116                 if (trim($aPhrase['string'])) {
1117                     $aPhrases[$iPhrase] = $aPhrase;
1118                     $aPhrases[$iPhrase]['words'] = explode(' ', $aPhrases[$iPhrase]['string']);
1119                     $aPhrases[$iPhrase]['wordsets'] = getWordSets($aPhrases[$iPhrase]['words'], 0);
1120                     $aTokens = array_merge($aTokens, getTokensFromSets($aPhrases[$iPhrase]['wordsets']));
1121                 } else {
1122                     unset($aPhrases[$iPhrase]);
1123                 }
1124             }
1125
1126             // Reindex phrases - we make assumptions later on that they are numerically keyed in order
1127             $aPhraseTypes = array_keys($aPhrases);
1128             $aPhrases = array_values($aPhrases);
1129
1130             if (sizeof($aTokens)) {
1131                 // Check which tokens we have, get the ID numbers
1132                 $sSQL = 'SELECT word_id, word_token, word, class, type, country_code, operator, search_name_count';
1133                 $sSQL .= ' FROM word ';
1134                 $sSQL .= ' WHERE word_token in ('.join(',', array_map("getDBQuoted", $aTokens)).')';
1135
1136                 if (CONST_Debug) var_Dump($sSQL);
1137
1138                 $aValidTokens = array();
1139                 $aDatabaseWords = chksql(
1140                     $this->oDB->getAll($sSQL),
1141                     "Could not get word tokens."
1142                 );
1143                 $aPossibleMainWordIDs = array();
1144                 $aWordFrequencyScores = array();
1145                 foreach ($aDatabaseWords as $aToken) {
1146                     // Very special case - require 2 letter country param to match the country code found
1147                     if ($bStructuredPhrases && $aToken['country_code'] && !empty($this->aStructuredQuery['country'])
1148                         && strlen($this->aStructuredQuery['country']) == 2 && strtolower($this->aStructuredQuery['country']) != $aToken['country_code']
1149                     ) {
1150                         continue;
1151                     }
1152
1153                     if (isset($aValidTokens[$aToken['word_token']])) {
1154                         $aValidTokens[$aToken['word_token']][] = $aToken;
1155                     } else {
1156                         $aValidTokens[$aToken['word_token']] = array($aToken);
1157                     }
1158                     if (!$aToken['class'] && !$aToken['country_code']) $aPossibleMainWordIDs[$aToken['word_id']] = 1;
1159                     $aWordFrequencyScores[$aToken['word_id']] = $aToken['search_name_count'] + 1;
1160                 }
1161                 if (CONST_Debug) var_Dump($aPhrases, $aValidTokens);
1162
1163                 // US ZIP+4 codes - if there is no token, merge in the 5-digit ZIP code
1164                 foreach ($aTokens as $sToken) {
1165                     if (!isset($aValidTokens[$sToken]) && preg_match('/^([0-9]{5}) [0-9]{4}$/', $sToken, $aData)) {
1166                         if (isset($aValidTokens[$aData[1]])) {
1167                             foreach ($aValidTokens[$aData[1]] as $aToken) {
1168                                 if (!$aToken['class']) {
1169                                     if (isset($aValidTokens[$sToken])) {
1170                                         $aValidTokens[$sToken][] = $aToken;
1171                                     } else {
1172                                         $aValidTokens[$sToken] = array($aToken);
1173                                     }
1174                                 }
1175                             }
1176                         }
1177                     }
1178                 }
1179
1180                 foreach ($aTokens as $sToken) {
1181                     // Unknown single word token with a number - assume it is a house number
1182                     if (!isset($aValidTokens[' '.$sToken]) && strpos($sToken, ' ') === false && preg_match('/[0-9]/', $sToken)) {
1183                         $aValidTokens[' '.$sToken] = array(array('class' => 'place', 'type' => 'house'));
1184                     }
1185                 }
1186
1187                 // Any words that have failed completely?
1188                 // TODO: suggestions
1189
1190                 // Start the search process
1191                 // array with: placeid => -1 | tiger-housenumber
1192                 $aResultPlaceIDs = array();
1193
1194                 $aGroupedSearches = $this->getGroupedSearches($aSearches, $aPhraseTypes, $aPhrases, $aValidTokens, $aWordFrequencyScores, $bStructuredPhrases, $sNormQuery);
1195
1196                 if ($this->bReverseInPlan) {
1197                     // Reverse phrase array and also reverse the order of the wordsets in
1198                     // the first and final phrase. Don't bother about phrases in the middle
1199                     // because order in the address doesn't matter.
1200                     $aPhrases = array_reverse($aPhrases);
1201                     $aPhrases[0]['wordsets'] = getInverseWordSets($aPhrases[0]['words'], 0);
1202                     if (sizeof($aPhrases) > 1) {
1203                         $aFinalPhrase = end($aPhrases);
1204                         $aPhrases[sizeof($aPhrases)-1]['wordsets'] = getInverseWordSets($aFinalPhrase['words'], 0);
1205                     }
1206                     $aReverseGroupedSearches = $this->getGroupedSearches($aSearches, null, $aPhrases, $aValidTokens, $aWordFrequencyScores, false, $sNormQuery);
1207
1208                     foreach ($aGroupedSearches as $aSearches) {
1209                         foreach ($aSearches as $aSearch) {
1210                             if ($aSearch['iSearchRank'] < $this->iMaxRank) {
1211                                 if (!isset($aReverseGroupedSearches[$aSearch['iSearchRank']])) $aReverseGroupedSearches[$aSearch['iSearchRank']] = array();
1212                                 $aReverseGroupedSearches[$aSearch['iSearchRank']][] = $aSearch;
1213                             }
1214                         }
1215                     }
1216
1217                     $aGroupedSearches = $aReverseGroupedSearches;
1218                     ksort($aGroupedSearches);
1219                 }
1220             } else {
1221                 // Re-group the searches by their score, junk anything over 20 as just not worth trying
1222                 $aGroupedSearches = array();
1223                 foreach ($aSearches as $aSearch) {
1224                     if ($aSearch['iSearchRank'] < $this->iMaxRank) {
1225                         if (!isset($aGroupedSearches[$aSearch['iSearchRank']])) $aGroupedSearches[$aSearch['iSearchRank']] = array();
1226                         $aGroupedSearches[$aSearch['iSearchRank']][] = $aSearch;
1227                     }
1228                 }
1229                 ksort($aGroupedSearches);
1230             }
1231
1232             if (CONST_Search_TryDroppedAddressTerms && sizeof($this->aStructuredQuery) > 0) {
1233                 $aCopyGroupedSearches = $aGroupedSearches;
1234                 foreach ($aCopyGroupedSearches as $iGroup => $aSearches) {
1235                     foreach ($aSearches as $iSearch => $aSearch) {
1236                         $aReductionsList = array($aSearch['aAddress']);
1237                         $iSearchRank = $aSearch['iSearchRank'];
1238                         while (sizeof($aReductionsList) > 0) {
1239                             $iSearchRank += 5;
1240                             if ($iSearchRank > iMaxRank) break 3;
1241                             $aNewReductionsList = array();
1242                             foreach ($aReductionsList as $aReductionsWordList) {
1243                                 for ($iReductionWord = 0; $iReductionWord < sizeof($aReductionsWordList); $iReductionWord++) {
1244                                     $aReductionsWordListResult = array_merge(array_slice($aReductionsWordList, 0, $iReductionWord), array_slice($aReductionsWordList, $iReductionWord+1));
1245                                     $aReverseSearch = $aSearch;
1246                                     $aSearch['aAddress'] = $aReductionsWordListResult;
1247                                     $aSearch['iSearchRank'] = $iSearchRank;
1248                                     $aGroupedSearches[$iSearchRank][] = $aReverseSearch;
1249                                     if (sizeof($aReductionsWordListResult) > 0) {
1250                                         $aNewReductionsList[] = $aReductionsWordListResult;
1251                                     }
1252                                 }
1253                             }
1254                             $aReductionsList = $aNewReductionsList;
1255                         }
1256                     }
1257                 }
1258                 ksort($aGroupedSearches);
1259             }
1260
1261             // Filter out duplicate searches
1262             $aSearchHash = array();
1263             foreach ($aGroupedSearches as $iGroup => $aSearches) {
1264                 foreach ($aSearches as $iSearch => $aSearch) {
1265                     $sHash = serialize($aSearch);
1266                     if (isset($aSearchHash[$sHash])) {
1267                         unset($aGroupedSearches[$iGroup][$iSearch]);
1268                         if (sizeof($aGroupedSearches[$iGroup]) == 0) unset($aGroupedSearches[$iGroup]);
1269                     } else {
1270                         $aSearchHash[$sHash] = 1;
1271                     }
1272                 }
1273             }
1274
1275             if (CONST_Debug) _debugDumpGroupedSearches($aGroupedSearches, $aValidTokens);
1276
1277             $iGroupLoop = 0;
1278             $iQueryLoop = 0;
1279             foreach ($aGroupedSearches as $iGroupedRank => $aSearches) {
1280                 $iGroupLoop++;
1281                 foreach ($aSearches as $aSearch) {
1282                     $iQueryLoop++;
1283                     $searchedHousenumber = -1;
1284
1285                     if (CONST_Debug) echo "<hr><b>Search Loop, group $iGroupLoop, loop $iQueryLoop</b>";
1286                     if (CONST_Debug) _debugDumpGroupedSearches(array($iGroupedRank => array($aSearch)), $aValidTokens);
1287
1288                     if ($sCountryCodesSQL && $aSearch['sCountryCode'] && !in_array($aSearch['sCountryCode'], $this->aCountryCodes)) {
1289                         continue;
1290                     }
1291
1292                     // No location term?
1293                     if (!sizeof($aSearch['aName']) && !sizeof($aSearch['aAddress'])) {
1294                         if ($aSearch['sCountryCode'] && !$aSearch['sClass'] && !$aSearch['sHouseNumber'] && !$aSearch['oNear']) {
1295                             // Just looking for a country by code - look it up
1296                             if (4 >= $this->iMinAddressRank && 4 <= $this->iMaxAddressRank) {
1297                                 $sSQL = "SELECT place_id FROM placex WHERE country_code='".$aSearch['sCountryCode']."' AND rank_search = 4";
1298                                 if ($bBoundingBoxSearch)
1299                                     $sSQL .= " AND _st_intersects($this->sViewboxSmallSQL, geometry)";
1300                                 $sSQL .= " ORDER BY st_area(geometry) DESC LIMIT 1";
1301                                 if (CONST_Debug) var_dump($sSQL);
1302                                 $aPlaceIDs = chksql($this->oDB->getCol($sSQL));
1303                             } else {
1304                                 $aPlaceIDs = array();
1305                             }
1306                         } else {
1307                             if (!$bBoundingBoxSearch && !$aSearch['oNear']) continue;
1308                             if (!$aSearch['sClass']) continue;
1309
1310                             $sSQL = "SELECT COUNT(*) FROM pg_tables WHERE tablename = 'place_classtype_".$aSearch['sClass']."_".$aSearch['sType']."'";
1311                             if (chksql($this->oDB->getOne($sSQL))) {
1312                                 $sSQL = "SELECT place_id FROM place_classtype_".$aSearch['sClass']."_".$aSearch['sType']." ct";
1313                                 if ($sCountryCodesSQL) $sSQL .= " JOIN placex USING (place_id)";
1314                                 if ($aSearch['oNear']) {
1315                                     $sSQL .= " WHERE ".$aSearch['oNear']->withinSQL('ct.centroid');
1316                                 } else {
1317                                     $sSQL .= " WHERE st_contains($this->sViewboxSmallSQL, ct.centroid)";
1318                                 }
1319                                 if ($sCountryCodesSQL) $sSQL .= " AND country_code in ($sCountryCodesSQL)";
1320                                 if (sizeof($this->aExcludePlaceIDs)) {
1321                                     $sSQL .= " AND place_id not in (".join(',', $this->aExcludePlaceIDs).")";
1322                                 }
1323                                 if ($this->sViewboxCentreSQL) {
1324                                     $sSQL .= " ORDER BY ST_Distance($this->sViewboxCentreSQL, ct.centroid) ASC";
1325                                 } elseif ($aSearch['oNear']) {
1326                                     $sSQL .= " ORDER BY ".$aSearch['oNear']->distanceSQL('ct.centroid').' ASC';
1327                                 }
1328                                 $sSQL .= " limit $this->iLimit";
1329                                 if (CONST_Debug) var_dump($sSQL);
1330                                 $aPlaceIDs = chksql($this->oDB->getCol($sSQL));
1331                             } else if ($aSearch['oNear']) {
1332                                 $sSQL = "SELECT place_id ";
1333                                 $sSQL .= "FROM placex ";
1334                                 $sSQL .= "WHERE class='".$aSearch['sClass']."' ";
1335                                 $sSQL .= "  AND type='".$aSearch['sType']."'";
1336                                 $sSQL .= "  AND ".$aSearch['oNear']->withinSQL('geometry');
1337                                 $sSQL .= "  AND linked_place_id is null";
1338                                 if ($sCountryCodesSQL) $sSQL .= " AND country_code in ($sCountryCodesSQL)";
1339                                 $sSQL .= " ORDER BY ".$aSearch['oNear']->distanceSQL('centroid')." ASC";
1340                                 $sSQL .= " LIMIT $this->iLimit";
1341                                 if (CONST_Debug) var_dump($sSQL);
1342                                 $aPlaceIDs = chksql($this->oDB->getCol($sSQL));
1343                             }
1344                         }
1345                     } elseif ($aSearch['oNear'] && !sizeof($aSearch['aName']) && !sizeof($aSearch['aAddress']) && !$aSearch['sClass']) {
1346                         // If a coordinate is given, the search must either
1347                         // be for a name or a special search. Ignore everythin else.
1348                         $aPlaceIDs = array();
1349                     } elseif ($aSearch['sOperator'] == 'postcode') {
1350                         $sSQL  = "SELECT p.place_id FROM location_postcode p ";
1351                         if (sizeof($aSearch['aAddress'])) {
1352                             $sSQL .= ", search_name s ";
1353                             $sSQL .= "WHERE s.place_id = p.parent_place_id ";
1354                             $sSQL .= "AND array_cat(s.nameaddress_vector, s.name_vector) @> ARRAY[".join($aSearch['aAddress'], ",")."] AND ";
1355                         } else {
1356                             $sSQL .= " WHERE ";
1357                         }
1358                         $sSQL .= "p.postcode = '".pg_escape_string(reset($aSearch['aName']))."'";
1359                         if ($aSearch['sCountryCode']) {
1360                             $sSQL .= " AND p.country_code = '".$aSearch['sCountryCode']."'";
1361                         } elseif ($sCountryCodesSQL) {
1362                             $sSQL .= " AND p.country_code in ($sCountryCodesSQL)";
1363                         }
1364                         $sSQL .= " LIMIT $this->iLimit";
1365                         if (CONST_Debug) var_dump($sSQL);
1366                         $aPlaceIDs = chksql($this->oDB->getCol($sSQL));
1367                     } else {
1368                         $aPlaceIDs = array();
1369
1370                         // First we need a position, either aName or fLat or both
1371                         $aTerms = array();
1372                         $aOrder = array();
1373
1374                         if ($aSearch['sHouseNumber'] && sizeof($aSearch['aAddress'])) {
1375                             $sHouseNumberRegex = '\\\\m'.$aSearch['sHouseNumber'].'\\\\M';
1376                             $aOrder[] = "";
1377                             $aOrder[0] = "  (";
1378                             $aOrder[0] .= "   EXISTS(";
1379                             $aOrder[0] .= "     SELECT place_id ";
1380                             $aOrder[0] .= "     FROM placex ";
1381                             $aOrder[0] .= "     WHERE parent_place_id = search_name.place_id";
1382                             $aOrder[0] .= "       AND transliteration(housenumber) ~* E'".$sHouseNumberRegex."' ";
1383                             $aOrder[0] .= "     LIMIT 1";
1384                             $aOrder[0] .= "   ) ";
1385                             // also housenumbers from interpolation lines table are needed
1386                             $aOrder[0] .= "   OR EXISTS(";
1387                             $aOrder[0] .= "     SELECT place_id ";
1388                             $aOrder[0] .= "     FROM location_property_osmline ";
1389                             $aOrder[0] .= "     WHERE parent_place_id = search_name.place_id";
1390                             $aOrder[0] .= "       AND startnumber is not NULL";
1391                             $aOrder[0] .= "       AND ".intval($aSearch['sHouseNumber']).">=startnumber ";
1392                             $aOrder[0] .= "       AND ".intval($aSearch['sHouseNumber'])."<=endnumber ";
1393                             $aOrder[0] .= "     LIMIT 1";
1394                             $aOrder[0] .= "   )";
1395                             $aOrder[0] .= " )";
1396                             $aOrder[0] .= " DESC";
1397                         }
1398
1399                         // TODO: filter out the pointless search terms (2 letter name tokens and less)
1400                         // they might be right - but they are just too darned expensive to run
1401                         if (sizeof($aSearch['aName'])) $aTerms[] = "name_vector @> ARRAY[".join($aSearch['aName'], ",")."]";
1402                         //if (sizeof($aSearch['aNameNonSearch'])) $aTerms[] = "array_cat(name_vector,ARRAY[]::integer[]) @> ARRAY[".join($aSearch['aNameNonSearch'], ",")."]";
1403                         if (sizeof($aSearch['aAddress']) && $aSearch['aName'] != $aSearch['aAddress']) {
1404                             // For infrequent name terms disable index usage for address
1405                             if (CONST_Search_NameOnlySearchFrequencyThreshold
1406                                 && sizeof($aSearch['aName']) == 1
1407                                 && $aWordFrequencyScores[$aSearch['aName'][reset($aSearch['aName'])]] < CONST_Search_NameOnlySearchFrequencyThreshold
1408                             ) {
1409                                 //$aTerms[] = "array_cat(nameaddress_vector,ARRAY[]::integer[]) @> ARRAY[".join(array_merge($aSearch['aAddress'], $aSearch['aAddressNonSearch']), ",")."]";
1410                                 $aTerms[] = "array_cat(nameaddress_vector,ARRAY[]::integer[]) @> ARRAY[".join($aSearch['aAddress'],",")."]";
1411                             } else {
1412                                 $aTerms[] = "nameaddress_vector @> ARRAY[".join($aSearch['aAddress'], ",")."]";
1413                                 /*if (sizeof($aSearch['aAddressNonSearch'])) {
1414                                     $aTerms[] = "array_cat(nameaddress_vector,ARRAY[]::integer[]) @> ARRAY[".join($aSearch['aAddressNonSearch'], ",")."]";
1415                                 }*/
1416                             }
1417                         }
1418                         if ($aSearch['sCountryCode']) $aTerms[] = "country_code = '".pg_escape_string($aSearch['sCountryCode'])."'";
1419                         if ($aSearch['sHouseNumber']) {
1420                             $aTerms[] = "address_rank between 16 and 27";
1421                         } elseif (!$aSearch['sClass'] || $aSearch['sOperator'] == 'name') {
1422                             if ($this->iMinAddressRank > 0) {
1423                                 $aTerms[] = "address_rank >= ".$this->iMinAddressRank;
1424                             }
1425                             if ($this->iMaxAddressRank < 30) {
1426                                 $aTerms[] = "address_rank <= ".$this->iMaxAddressRank;
1427                             }
1428                         }
1429                         if ($aSearch['oNear']) {
1430                             $aTerms[] = $aSearch['oNear']->withinSQL('centroid');
1431
1432                             $aOrder[] = $aSearch['oNear']->distanceSQL('centroid');
1433                         } elseif ($aSearch['sPostcode']) {
1434                             if (!sizeof($aSearch['aAddress'])) {
1435                                 $aTerms[] = "EXISTS(SELECT place_id FROM location_postcode p WHERE p.postcode = '".$aSearch['sPostcode']."' AND ST_DWithin(search_name.centroid, p.geometry, 0.1))";
1436                             } else {
1437                                 $aOrder[] = "(SELECT min(ST_Distance(search_name.centroid, p.geometry)) FROM location_postcode p WHERE p.postcode = '".$aSearch['sPostcode']."')";
1438                             }
1439                         }
1440                         if (sizeof($this->aExcludePlaceIDs)) {
1441                             $aTerms[] = "place_id not in (".join(',', $this->aExcludePlaceIDs).")";
1442                         }
1443                         if ($sCountryCodesSQL) {
1444                             $aTerms[] = "country_code in ($sCountryCodesSQL)";
1445                         }
1446
1447                         if ($bBoundingBoxSearch) $aTerms[] = "centroid && $this->sViewboxSmallSQL";
1448                         if ($oNearPoint) {
1449                             $aOrder[] = $oNearPoint->distanceSQL('centroid');
1450                         }
1451
1452                         if ($aSearch['sHouseNumber']) {
1453                             $sImportanceSQL = '- abs(26 - address_rank) + 3';
1454                         } else {
1455                             $sImportanceSQL = '(CASE WHEN importance = 0 OR importance IS NULL THEN 0.75-(search_rank::float/40) ELSE importance END)';
1456                         }
1457                         if ($this->sViewboxSmallSQL) $sImportanceSQL .= " * CASE WHEN ST_Contains($this->sViewboxSmallSQL, centroid) THEN 1 ELSE 0.5 END";
1458                         if ($this->sViewboxLargeSQL) $sImportanceSQL .= " * CASE WHEN ST_Contains($this->sViewboxLargeSQL, centroid) THEN 1 ELSE 0.5 END";
1459
1460                         $aOrder[] = "$sImportanceSQL DESC";
1461                         if (sizeof($aSearch['aFullNameAddress'])) {
1462                             $sExactMatchSQL = ' ( ';
1463                             $sExactMatchSQL .= '   SELECT count(*) FROM ( ';
1464                             $sExactMatchSQL .= '      SELECT unnest(ARRAY['.join($aSearch['aFullNameAddress'], ",").']) ';
1465                             $sExactMatchSQL .= '      INTERSECT ';
1466                             $sExactMatchSQL .= '      SELECT unnest(nameaddress_vector)';
1467                             $sExactMatchSQL .= '   ) s';
1468                             $sExactMatchSQL .= ') as exactmatch';
1469                             $aOrder[] = 'exactmatch DESC';
1470                         } else {
1471                             $sExactMatchSQL = '0::int as exactmatch';
1472                         }
1473
1474                         if (sizeof($aTerms)) {
1475                             $sSQL = "SELECT place_id, ";
1476                             $sSQL .= $sExactMatchSQL;
1477                             $sSQL .= " FROM search_name";
1478                             $sSQL .= " WHERE ".join(' and ', $aTerms);
1479                             $sSQL .= " ORDER BY ".join(', ', $aOrder);
1480                             if ($aSearch['sHouseNumber'] || $aSearch['sClass']) {
1481                                 $sSQL .= " LIMIT 20";
1482                             } elseif (!sizeof($aSearch['aName']) && !sizeof($aSearch['aAddress']) && $aSearch['sClass']) {
1483                                 $sSQL .= " LIMIT 1";
1484                             } else {
1485                                 $sSQL .= " LIMIT ".$this->iLimit;
1486                             }
1487
1488                             if (CONST_Debug) var_dump($sSQL);
1489                             $aViewBoxPlaceIDs = chksql(
1490                                 $this->oDB->getAll($sSQL),
1491                                 "Could not get places for search terms."
1492                             );
1493                             //var_dump($aViewBoxPlaceIDs);
1494                             // Did we have an viewbox matches?
1495                             $aPlaceIDs = array();
1496                             $bViewBoxMatch = false;
1497                             foreach ($aViewBoxPlaceIDs as $aViewBoxRow) {
1498                                 //if ($bViewBoxMatch == 1 && $aViewBoxRow['in_small'] == 'f') break;
1499                                 //if ($bViewBoxMatch == 2 && $aViewBoxRow['in_large'] == 'f') break;
1500                                 //if ($aViewBoxRow['in_small'] == 't') $bViewBoxMatch = 1;
1501                                 //else if ($aViewBoxRow['in_large'] == 't') $bViewBoxMatch = 2;
1502                                 $aPlaceIDs[] = $aViewBoxRow['place_id'];
1503                                 $this->exactMatchCache[$aViewBoxRow['place_id']] = $aViewBoxRow['exactmatch'];
1504                             }
1505                         }
1506                         //var_Dump($aPlaceIDs);
1507                         //exit;
1508
1509                         //now search for housenumber, if housenumber provided
1510                         if ($aSearch['sHouseNumber'] && sizeof($aPlaceIDs)) {
1511                             $searchedHousenumber = intval($aSearch['sHouseNumber']);
1512                             $aRoadPlaceIDs = $aPlaceIDs;
1513                             $sPlaceIDs = join(',', $aPlaceIDs);
1514
1515                             // Now they are indexed, look for a house attached to a street we found
1516                             $sHouseNumberRegex = '\\\\m'.$aSearch['sHouseNumber'].'\\\\M';
1517                             $sSQL = "SELECT place_id FROM placex ";
1518                             $sSQL .= "WHERE parent_place_id in (".$sPlaceIDs.") and transliteration(housenumber) ~* E'".$sHouseNumberRegex."'";
1519                             if (sizeof($this->aExcludePlaceIDs)) {
1520                                 $sSQL .= " AND place_id not in (".join(',', $this->aExcludePlaceIDs).")";
1521                             }
1522                             $sSQL .= " LIMIT $this->iLimit";
1523                             if (CONST_Debug) var_dump($sSQL);
1524                             $aPlaceIDs = chksql($this->oDB->getCol($sSQL));
1525
1526                             // if nothing found, search in the interpolation line table
1527                             if (!sizeof($aPlaceIDs)) {
1528                                 // do we need to use transliteration and the regex for housenumbers???
1529                                 //new query for lines, not housenumbers anymore
1530                                 $sSQL = "SELECT distinct place_id FROM location_property_osmline";
1531                                 $sSQL .= " WHERE startnumber is not NULL and parent_place_id in (".$sPlaceIDs.") and (";
1532                                 if ($searchedHousenumber%2 == 0) {
1533                                     //if housenumber is even, look for housenumber in streets with interpolationtype even or all
1534                                     $sSQL .= "interpolationtype='even'";
1535                                 } else {
1536                                     //look for housenumber in streets with interpolationtype odd or all
1537                                     $sSQL .= "interpolationtype='odd'";
1538                                 }
1539                                 $sSQL .= " or interpolationtype='all') and ";
1540                                 $sSQL .= $searchedHousenumber.">=startnumber and ";
1541                                 $sSQL .= $searchedHousenumber."<=endnumber";
1542
1543                                 if (sizeof($this->aExcludePlaceIDs)) {
1544                                     $sSQL .= " AND place_id not in (".join(',', $this->aExcludePlaceIDs).")";
1545                                 }
1546                                 //$sSQL .= " limit $this->iLimit";
1547                                 if (CONST_Debug) var_dump($sSQL);
1548                                 //get place IDs
1549                                 $aPlaceIDs = chksql($this->oDB->getCol($sSQL, 0));
1550                             }
1551
1552                             // If nothing found try the aux fallback table
1553                             if (CONST_Use_Aux_Location_data && !sizeof($aPlaceIDs)) {
1554                                 $sSQL = "SELECT place_id FROM location_property_aux ";
1555                                 $sSQL .= " WHERE parent_place_id in (".$sPlaceIDs.") ";
1556                                 $sSQL .= " AND housenumber = '".pg_escape_string($aSearch['sHouseNumber'])."'";
1557                                 if (sizeof($this->aExcludePlaceIDs)) {
1558                                     $sSQL .= " AND parent_place_id not in (".join(',', $this->aExcludePlaceIDs).")";
1559                                 }
1560                                 //$sSQL .= " limit $this->iLimit";
1561                                 if (CONST_Debug) var_dump($sSQL);
1562                                 $aPlaceIDs = chksql($this->oDB->getCol($sSQL));
1563                             }
1564
1565                             //if nothing was found in placex or location_property_aux, then search in Tiger data for this housenumber(location_property_tiger)
1566                             if (CONST_Use_US_Tiger_Data && !sizeof($aPlaceIDs)) {
1567                                 $sSQL = "SELECT distinct place_id FROM location_property_tiger";
1568                                 $sSQL .= " WHERE parent_place_id in (".$sPlaceIDs.") and (";
1569                                 if ($searchedHousenumber%2 == 0) {
1570                                     $sSQL .= "interpolationtype='even'";
1571                                 } else {
1572                                     $sSQL .= "interpolationtype='odd'";
1573                                 }
1574                                 $sSQL .= " or interpolationtype='all') and ";
1575                                 $sSQL .= $searchedHousenumber.">=startnumber and ";
1576                                 $sSQL .= $searchedHousenumber."<=endnumber";
1577
1578                                 if (sizeof($this->aExcludePlaceIDs)) {
1579                                     $sSQL .= " AND place_id not in (".join(',', $this->aExcludePlaceIDs).")";
1580                                 }
1581                                 //$sSQL .= " limit $this->iLimit";
1582                                 if (CONST_Debug) var_dump($sSQL);
1583                                 //get place IDs
1584                                 $aPlaceIDs = chksql($this->oDB->getCol($sSQL, 0));
1585                             }
1586
1587                             // Fallback to the road (if no housenumber was found)
1588                             if (!sizeof($aPlaceIDs) && preg_match('/[0-9]+/', $aSearch['sHouseNumber'])
1589                                 && ($aSearch['aAddress'] || $aSearch['sCountryCode'])) {
1590                                 $aPlaceIDs = $aRoadPlaceIDs;
1591                                 //set to -1, if no housenumbers were found
1592                                 $searchedHousenumber = -1;
1593                             }
1594                             //else: housenumber was found, remains saved in searchedHousenumber
1595                         }
1596
1597
1598                         if ($aSearch['sClass'] && sizeof($aPlaceIDs)) {
1599                             $sPlaceIDs = join(',', $aPlaceIDs);
1600                             $aClassPlaceIDs = array();
1601
1602                             if (!$aSearch['sOperator'] || $aSearch['sOperator'] == 'name') {
1603                                 // If they were searching for a named class (i.e. 'Kings Head pub') then we might have an extra match
1604                                 $sSQL = "SELECT place_id ";
1605                                 $sSQL .= " FROM placex ";
1606                                 $sSQL .= " WHERE place_id in ($sPlaceIDs) ";
1607                                 $sSQL .= "   AND class='".$aSearch['sClass']."' ";
1608                                 $sSQL .= "   AND type='".$aSearch['sType']."'";
1609                                 $sSQL .= "   AND linked_place_id is null";
1610                                 if ($sCountryCodesSQL) $sSQL .= " AND country_code in ($sCountryCodesSQL)";
1611                                 $sSQL .= " ORDER BY rank_search ASC ";
1612                                 $sSQL .= " LIMIT $this->iLimit";
1613                                 if (CONST_Debug) var_dump($sSQL);
1614                                 $aClassPlaceIDs = chksql($this->oDB->getCol($sSQL));
1615                             }
1616
1617                             if (!$aSearch['sOperator'] || $aSearch['sOperator'] == 'near') { // & in
1618                                 $sClassTable = 'place_classtype_'.$aSearch['sClass'].'_'.$aSearch['sType'];
1619                                 $sSQL = "SELECT count(*) FROM pg_tables ";
1620                                 $sSQL .= "WHERE tablename = '$sClassTable'";
1621                                 $bCacheTable = chksql($this->oDB->getOne($sSQL));
1622
1623                                 $sSQL = "SELECT min(rank_search) FROM placex WHERE place_id in ($sPlaceIDs)";
1624
1625                                 if (CONST_Debug) var_dump($sSQL);
1626                                 $this->iMaxRank = ((int)chksql($this->oDB->getOne($sSQL)));
1627
1628                                 // For state / country level searches the normal radius search doesn't work very well
1629                                 $sPlaceGeom = false;
1630                                 if ($this->iMaxRank < 9 && $bCacheTable) {
1631                                     // Try and get a polygon to search in instead
1632                                     $sSQL = "SELECT geometry ";
1633                                     $sSQL .= " FROM placex";
1634                                     $sSQL .= " WHERE place_id in ($sPlaceIDs)";
1635                                     $sSQL .= "   AND rank_search < $this->iMaxRank + 5";
1636                                     $sSQL .= "   AND ST_Geometrytype(geometry) in ('ST_Polygon','ST_MultiPolygon')";
1637                                     $sSQL .= " ORDER BY rank_search ASC ";
1638                                     $sSQL .= " LIMIT 1";
1639                                     if (CONST_Debug) var_dump($sSQL);
1640                                     $sPlaceGeom = chksql($this->oDB->getOne($sSQL));
1641                                 }
1642
1643                                 if ($sPlaceGeom) {
1644                                     $sPlaceIDs = false;
1645                                 } else {
1646                                     $this->iMaxRank += 5;
1647                                     $sSQL = "SELECT place_id FROM placex WHERE place_id in ($sPlaceIDs) and rank_search < $this->iMaxRank";
1648                                     if (CONST_Debug) var_dump($sSQL);
1649                                     $aPlaceIDs = chksql($this->oDB->getCol($sSQL));
1650                                     $sPlaceIDs = join(',', $aPlaceIDs);
1651                                 }
1652
1653                                 if ($sPlaceIDs || $sPlaceGeom) {
1654                                     $fRange = 0.01;
1655                                     if ($bCacheTable) {
1656                                         // More efficient - can make the range bigger
1657                                         $fRange = 0.05;
1658
1659                                         $sOrderBySQL = '';
1660                                         if ($oNearPoint) {
1661                                             $sOrderBySQL = $oNearPoint->distanceSQL('l.centroid');
1662                                         } elseif ($sPlaceIDs) {
1663                                             $sOrderBySQL = "ST_Distance(l.centroid, f.geometry)";
1664                                         } elseif ($sPlaceGeom) {
1665                                             $sOrderBySQL = "ST_Distance(st_centroid('".$sPlaceGeom."'), l.centroid)";
1666                                         }
1667
1668                                         $sSQL = "select distinct i.place_id".($sOrderBySQL?', i.order_term':'')." from (";
1669                                         $sSQL .= "select l.place_id".($sOrderBySQL?','.$sOrderBySQL.' as order_term':'')." from ".$sClassTable." as l";
1670                                         if ($sCountryCodesSQL) $sSQL .= " join placex as lp using (place_id)";
1671                                         if ($sPlaceIDs) {
1672                                             $sSQL .= ",placex as f where ";
1673                                             $sSQL .= "f.place_id in ($sPlaceIDs) and ST_DWithin(l.centroid, f.centroid, $fRange) ";
1674                                         }
1675                                         if ($sPlaceGeom) {
1676                                             $sSQL .= " where ";
1677                                             $sSQL .= "ST_Contains('".$sPlaceGeom."', l.centroid) ";
1678                                         }
1679                                         if (sizeof($this->aExcludePlaceIDs)) {
1680                                             $sSQL .= " and l.place_id not in (".join(',', $this->aExcludePlaceIDs).")";
1681                                         }
1682                                         if ($sCountryCodesSQL) $sSQL .= " and lp.country_code in ($sCountryCodesSQL)";
1683                                         $sSQL .= 'limit 300) i ';
1684                                         if ($sOrderBySQL) $sSQL .= "order by order_term asc";
1685                                         if ($this->iOffset) $sSQL .= " offset $this->iOffset";
1686                                         $sSQL .= " limit $this->iLimit";
1687                                         if (CONST_Debug) var_dump($sSQL);
1688                                         $aClassPlaceIDs = array_merge($aClassPlaceIDs, chksql($this->oDB->getCol($sSQL)));
1689                                     } else {
1690                                         if ($aSearch['oNear']) {
1691                                             $fRange = $aSearch['oNear']->radius();
1692                                         }
1693
1694                                         $sOrderBySQL = '';
1695                                         if ($oNearPoint) {
1696                                             $sOrderBySQL = $oNearPoint->distanceSQL('l.geometry');
1697                                         } else {
1698                                             $sOrderBySQL = "ST_Distance(l.geometry, f.geometry)";
1699                                         }
1700
1701                                         $sSQL = "SELECT distinct l.place_id".($sOrderBySQL?','.$sOrderBySQL:'');
1702                                         $sSQL .= " FROM placex as l, placex as f ";
1703                                         $sSQL .= " WHERE f.place_id in ($sPlaceIDs) ";
1704                                         $sSQL .= "  AND ST_DWithin(l.geometry, f.centroid, $fRange) ";
1705                                         $sSQL .= "  AND l.class='".$aSearch['sClass']."' ";
1706                                         $sSQL .= "  AND l.type='".$aSearch['sType']."' ";
1707                                         if (sizeof($this->aExcludePlaceIDs)) {
1708                                             $sSQL .= " AND l.place_id not in (".join(',', $this->aExcludePlaceIDs).")";
1709                                         }
1710                                         if ($sCountryCodesSQL) $sSQL .= " AND l.country_code in ($sCountryCodesSQL)";
1711                                         if ($sOrderBySQL) $sSQL .= "ORDER BY ".$sOrderBySQL." ASC";
1712                                         if ($this->iOffset) $sSQL .= " OFFSET $this->iOffset";
1713                                         $sSQL .= " limit $this->iLimit";
1714                                         if (CONST_Debug) var_dump($sSQL);
1715                                         $aClassPlaceIDs = array_merge($aClassPlaceIDs, chksql($this->oDB->getCol($sSQL)));
1716                                     }
1717                                 }
1718                             }
1719                             $aPlaceIDs = $aClassPlaceIDs;
1720                         }
1721                     }
1722
1723                     if (CONST_Debug) {
1724                         echo "<br><b>Place IDs:</b> ";
1725                         var_Dump($aPlaceIDs);
1726                     }
1727
1728                     if (sizeof($aPlaceIDs) && $aSearch['sPostcode']) {
1729                         $sSQL = 'SELECT place_id FROM placex';
1730                         $sSQL .= ' WHERE place_id in ('.join(',', $aPlaceIDs).')';
1731                         $sSQL .= " AND postcode = '".pg_escape_string($aSearch['sPostcode'])."'";
1732                         if (CONST_Debug) var_dump($sSQL);
1733                         $aFilteredPlaceIDs = chksql($this->oDB->getCol($sSQL));
1734                         if ($aFilteredPlaceIDs) {
1735                             $aPlaceIDs = $aFilteredPlaceIDs;
1736                             if (CONST_Debug) {
1737                                 echo "<br><b>Place IDs after postcode filtering:</b> ";
1738                                 var_Dump($aPlaceIDs);
1739                             }
1740                         }
1741                     }
1742
1743                     foreach ($aPlaceIDs as $iPlaceID) {
1744                         // array for placeID => -1 | Tiger housenumber
1745                         $aResultPlaceIDs[$iPlaceID] = $searchedHousenumber;
1746                     }
1747                     if ($iQueryLoop > 20) break;
1748                 }
1749
1750                 if (isset($aResultPlaceIDs) && sizeof($aResultPlaceIDs) && ($this->iMinAddressRank != 0 || $this->iMaxAddressRank != 30)) {
1751                     // Need to verify passes rank limits before dropping out of the loop (yuk!)
1752                     // reduces the number of place ids, like a filter
1753                     // rank_address is 30 for interpolated housenumbers
1754                     $sWherePlaceId = 'WHERE place_id in (';
1755                     $sWherePlaceId .= join(',', array_keys($aResultPlaceIDs)).') ';
1756
1757                     $sSQL = "SELECT place_id ";
1758                     $sSQL .= "FROM placex ".$sWherePlaceId;
1759                     $sSQL .= "  AND (";
1760                     $sSQL .= "         placex.rank_address between $this->iMinAddressRank and $this->iMaxAddressRank ";
1761                     if (14 >= $this->iMinAddressRank && 14 <= $this->iMaxAddressRank) {
1762                         $sSQL .= "     OR (extratags->'place') = 'city'";
1763                     }
1764                     if ($this->aAddressRankList) {
1765                         $sSQL .= "     OR placex.rank_address in (".join(',', $this->aAddressRankList).")";
1766                     }
1767                     $sSQL .= "  ) UNION ";
1768                     $sSQL .= " SELECT place_id FROM location_postcode lp ".$sWherePlaceId;
1769                     $sSQL .= "  AND (lp.rank_address between $this->iMinAddressRank and $this->iMaxAddressRank ";
1770                     if ($this->aAddressRankList) {
1771                         $sSQL .= "     OR lp.rank_address in (".join(',', $this->aAddressRankList).")";
1772                     }
1773                     $sSQL .= ") ";
1774                     if (CONST_Use_US_Tiger_Data && $this->iMaxAddressRank == 30) {
1775                         $sSQL .= "UNION ";
1776                         $sSQL .= "  SELECT place_id ";
1777                         $sSQL .= "  FROM location_property_tiger ".$sWherePlaceId;
1778                     }
1779                     if ($this->iMaxAddressRank == 30) {
1780                         $sSQL .= "UNION ";
1781                         $sSQL .= "  SELECT place_id ";
1782                         $sSQL .= "  FROM location_property_osmline ".$sWherePlaceId;
1783                     }
1784                     if (CONST_Debug) var_dump($sSQL);
1785                     $aFilteredPlaceIDs = chksql($this->oDB->getCol($sSQL));
1786                     $tempIDs = array();
1787                     foreach ($aFilteredPlaceIDs as $placeID) {
1788                         $tempIDs[$placeID] = $aResultPlaceIDs[$placeID];  //assign housenumber to placeID
1789                     }
1790                     $aResultPlaceIDs = $tempIDs;
1791                 }
1792
1793                 //exit;
1794                 if (isset($aResultPlaceIDs) && sizeof($aResultPlaceIDs)) break;
1795                 if ($iGroupLoop > 4) break;
1796                 if ($iQueryLoop > 30) break;
1797             }
1798
1799             // Did we find anything?
1800             if (isset($aResultPlaceIDs) && sizeof($aResultPlaceIDs)) {
1801                 $aSearchResults = $this->getDetails($aResultPlaceIDs);
1802             }
1803         } else {
1804             // Just interpret as a reverse geocode
1805             $oReverse = new ReverseGeocode($this->oDB);
1806             $oReverse->setZoom(18);
1807
1808             $aLookup = $oReverse->lookup(
1809                 $oNearPoint->lat(),
1810                 $oNearPoint->lon(),
1811                 false
1812             );
1813
1814             if (CONST_Debug) var_dump("Reverse search", $aLookup);
1815
1816             if ($aLookup['place_id']) {
1817                 $aSearchResults = $this->getDetails(array($aLookup['place_id'] => -1));
1818                 $aResultPlaceIDs[$aLookup['place_id']] = -1;
1819             } else {
1820                 $aSearchResults = array();
1821             }
1822         }
1823
1824         // No results? Done
1825         if (!sizeof($aSearchResults)) {
1826             if ($this->bFallback) {
1827                 if ($this->fallbackStructuredQuery()) {
1828                     return $this->lookup();
1829                 }
1830             }
1831
1832             return array();
1833         }
1834
1835         $aClassType = getClassTypesWithImportance();
1836         $aRecheckWords = preg_split('/\b[\s,\\-]*/u', $sQuery);
1837         foreach ($aRecheckWords as $i => $sWord) {
1838             if (!preg_match('/[\pL\pN]/', $sWord)) unset($aRecheckWords[$i]);
1839         }
1840
1841         if (CONST_Debug) {
1842             echo '<i>Recheck words:<\i>';
1843             var_dump($aRecheckWords);
1844         }
1845
1846         $oPlaceLookup = new PlaceLookup($this->oDB);
1847         $oPlaceLookup->setIncludePolygonAsPoints($this->bIncludePolygonAsPoints);
1848         $oPlaceLookup->setIncludePolygonAsText($this->bIncludePolygonAsText);
1849         $oPlaceLookup->setIncludePolygonAsGeoJSON($this->bIncludePolygonAsGeoJSON);
1850         $oPlaceLookup->setIncludePolygonAsKML($this->bIncludePolygonAsKML);
1851         $oPlaceLookup->setIncludePolygonAsSVG($this->bIncludePolygonAsSVG);
1852         $oPlaceLookup->setPolygonSimplificationThreshold($this->fPolygonSimplificationThreshold);
1853
1854         foreach ($aSearchResults as $iResNum => $aResult) {
1855             // Default
1856             $fDiameter = getResultDiameter($aResult);
1857
1858             $aOutlineResult = $oPlaceLookup->getOutlines($aResult['place_id'], $aResult['lon'], $aResult['lat'], $fDiameter/2);
1859             if ($aOutlineResult) {
1860                 $aResult = array_merge($aResult, $aOutlineResult);
1861             }
1862             
1863             if ($aResult['extra_place'] == 'city') {
1864                 $aResult['class'] = 'place';
1865                 $aResult['type'] = 'city';
1866                 $aResult['rank_search'] = 16;
1867             }
1868
1869             // Is there an icon set for this type of result?
1870             if (isset($aClassType[$aResult['class'].':'.$aResult['type']]['icon'])
1871                 && $aClassType[$aResult['class'].':'.$aResult['type']]['icon']
1872             ) {
1873                 $aResult['icon'] = CONST_Website_BaseURL.'images/mapicons/'.$aClassType[$aResult['class'].':'.$aResult['type']]['icon'].'.p.20.png';
1874             }
1875
1876             if (isset($aClassType[$aResult['class'].':'.$aResult['type'].':'.$aResult['admin_level']]['label'])
1877                 && $aClassType[$aResult['class'].':'.$aResult['type'].':'.$aResult['admin_level']]['label']
1878             ) {
1879                 $aResult['label'] = $aClassType[$aResult['class'].':'.$aResult['type'].':'.$aResult['admin_level']]['label'];
1880             } elseif (isset($aClassType[$aResult['class'].':'.$aResult['type']]['label'])
1881                 && $aClassType[$aResult['class'].':'.$aResult['type']]['label']
1882             ) {
1883                 $aResult['label'] = $aClassType[$aResult['class'].':'.$aResult['type']]['label'];
1884             }
1885             // if tag '&addressdetails=1' is set in query
1886             if ($this->bIncludeAddressDetails) {
1887                 // getAddressDetails() is defined in lib.php and uses the SQL function get_addressdata in functions.sql
1888                 $aResult['address'] = getAddressDetails($this->oDB, $sLanguagePrefArraySQL, $aResult['place_id'], $aResult['country_code'], $aResultPlaceIDs[$aResult['place_id']]);
1889                 if ($aResult['extra_place'] == 'city' && !isset($aResult['address']['city'])) {
1890                     $aResult['address'] = array_merge(array('city' => array_values($aResult['address'])[0]), $aResult['address']);
1891                 }
1892             }
1893
1894             if ($this->bIncludeExtraTags) {
1895                 if ($aResult['extra']) {
1896                     $aResult['sExtraTags'] = json_decode($aResult['extra']);
1897                 } else {
1898                     $aResult['sExtraTags'] = (object) array();
1899                 }
1900             }
1901
1902             if ($this->bIncludeNameDetails) {
1903                 if ($aResult['names']) {
1904                     $aResult['sNameDetails'] = json_decode($aResult['names']);
1905                 } else {
1906                     $aResult['sNameDetails'] = (object) array();
1907                 }
1908             }
1909
1910             // Adjust importance for the number of exact string matches in the result
1911             $aResult['importance'] = max(0.001, $aResult['importance']);
1912             $iCountWords = 0;
1913             $sAddress = $aResult['langaddress'];
1914             foreach ($aRecheckWords as $i => $sWord) {
1915                 if (stripos($sAddress, $sWord)!==false) {
1916                     $iCountWords++;
1917                     if (preg_match("/(^|,)\s*".preg_quote($sWord, '/')."\s*(,|$)/", $sAddress)) $iCountWords += 0.1;
1918                 }
1919             }
1920
1921             $aResult['importance'] = $aResult['importance'] + ($iCountWords*0.1); // 0.1 is a completely arbitrary number but something in the range 0.1 to 0.5 would seem right
1922
1923             $aResult['name'] = $aResult['langaddress'];
1924             // secondary ordering (for results with same importance (the smaller the better):
1925             // - approximate importance of address parts
1926             $aResult['foundorder'] = -$aResult['addressimportance']/10;
1927             // - number of exact matches from the query
1928             if (isset($this->exactMatchCache[$aResult['place_id']])) {
1929                 $aResult['foundorder'] -= $this->exactMatchCache[$aResult['place_id']];
1930             } elseif (isset($this->exactMatchCache[$aResult['parent_place_id']])) {
1931                 $aResult['foundorder'] -= $this->exactMatchCache[$aResult['parent_place_id']];
1932             }
1933             // - importance of the class/type
1934             if (isset($aClassType[$aResult['class'].':'.$aResult['type']]['importance'])
1935                 && $aClassType[$aResult['class'].':'.$aResult['type']]['importance']
1936             ) {
1937                 $aResult['foundorder'] += 0.0001 * $aClassType[$aResult['class'].':'.$aResult['type']]['importance'];
1938             } else {
1939                 $aResult['foundorder'] += 0.01;
1940             }
1941             if (CONST_Debug) var_dump($aResult);
1942             $aSearchResults[$iResNum] = $aResult;
1943         }
1944         uasort($aSearchResults, 'byImportance');
1945
1946         $aOSMIDDone = array();
1947         $aClassTypeNameDone = array();
1948         $aToFilter = $aSearchResults;
1949         $aSearchResults = array();
1950
1951         $bFirst = true;
1952         foreach ($aToFilter as $iResNum => $aResult) {
1953             $this->aExcludePlaceIDs[$aResult['place_id']] = $aResult['place_id'];
1954             if ($bFirst) {
1955                 $fLat = $aResult['lat'];
1956                 $fLon = $aResult['lon'];
1957                 if (isset($aResult['zoom'])) $iZoom = $aResult['zoom'];
1958                 $bFirst = false;
1959             }
1960             if (!$this->bDeDupe || (!isset($aOSMIDDone[$aResult['osm_type'].$aResult['osm_id']])
1961                 && !isset($aClassTypeNameDone[$aResult['osm_type'].$aResult['class'].$aResult['type'].$aResult['name'].$aResult['admin_level']]))
1962             ) {
1963                 $aOSMIDDone[$aResult['osm_type'].$aResult['osm_id']] = true;
1964                 $aClassTypeNameDone[$aResult['osm_type'].$aResult['class'].$aResult['type'].$aResult['name'].$aResult['admin_level']] = true;
1965                 $aSearchResults[] = $aResult;
1966             }
1967
1968             // Absolute limit on number of results
1969             if (sizeof($aSearchResults) >= $this->iFinalLimit) break;
1970         }
1971
1972         return $aSearchResults;
1973     } // end lookup()
1974 } // end class