lib/Geocode.php

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