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