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