lib/ReverseGeocode.php

   1 <?php
   2         class ReverseGeocode
   3         {
   4                 protected $oDB;
   5
   6                 protected $fLat;
   7                 protected $fLon;
   8                 protected $iMaxRank = 28;
   9
  10                 protected $aLangPrefOrder = array();
  11
  12                 protected $bIncludePolygonAsPoints = false;
  13                 protected $bIncludePolygonAsText = false;
  14                 protected $bIncludePolygonAsGeoJSON = false;
  15                 protected $bIncludePolygonAsKML = false;
  16                 protected $bIncludePolygonAsSVG = false;
  17                 protected $fPolygonSimplificationThreshold = 0.0;
  18
  19
  20                 function ReverseGeocode(&$oDB)
  21                 {
  22                         $this->oDB =& $oDB;
  23                 }
  24
  25                 function setLanguagePreference($aLangPref)
  26                 {
  27                         $this->aLangPrefOrder = $aLangPref;
  28                 }
  29
  30                 function setLatLon($fLat, $fLon)
  31                 {
  32                         $this->fLat = (float)$fLat;
  33                         $this->fLon = (float)$fLon;
  34                 }
  35
  36                 function setRank($iRank)
  37                 {
  38                         $this->iMaxRank = $iRank;
  39                 }
  40
  41                 function setZoom($iZoom)
  42                 {
  43                         // Zoom to rank, this could probably be calculated but a lookup gives fine control
  44                         $aZoomRank = array(
  45                                 0 => 2, // Continent / Sea
  46                                 1 => 2,
  47                                 2 => 2,
  48                                 3 => 4, // Country
  49                                 4 => 4,
  50                                 5 => 8, // State
  51                                 6 => 10, // Region
  52                                 7 => 10,
  53                                 8 => 12, // County
  54                                 9 => 12,
  55                                 10 => 17, // City
  56                                 11 => 17,
  57                                 12 => 18, // Town / Village
  58                                 13 => 18,
  59                                 14 => 22, // Suburb
  60                                 15 => 22,
  61                                 16 => 26, // Street, TODO: major street?
  62                                 17 => 26,
  63                                 18 => 30, // or >, Building
  64                                 19 => 30, // or >, Building
  65                                 );
  66                         $this->iMaxRank = (isset($iZoom) && isset($aZoomRank[$iZoom]))?$aZoomRank[$iZoom]:28;
  67                 }
  68
  69                                 function setIncludePolygonAsPoints($b = true)
  70                 {
  71                         $this->bIncludePolygonAsPoints = $b;
  72                 }
  73
  74                 function getIncludePolygonAsPoints()
  75                 {
  76                         return $this->bIncludePolygonAsPoints;
  77                 }
  78
  79                 function setIncludePolygonAsText($b = true)
  80                 {
  81                         $this->bIncludePolygonAsText = $b;
  82                 }
  83
  84                 function getIncludePolygonAsText()
  85                 {
  86                         return $this->bIncludePolygonAsText;
  87                 }
  88
  89                 function setIncludePolygonAsGeoJSON($b = true)
  90                 {
  91                         $this->bIncludePolygonAsGeoJSON = $b;
  92                 }
  93
  94                 function setIncludePolygonAsKML($b = true)
  95                 {
  96                         $this->bIncludePolygonAsKML = $b;
  97                 }
  98
  99                 function setIncludePolygonAsSVG($b = true)
 100                 {
 101                         $this->bIncludePolygonAsSVG = $b;
 102                 }
 103
 104                 function setPolygonSimplificationThreshold($f)
 105                 {
 106                         $this->fPolygonSimplificationThreshold = $f;
 107                 }
 108
 109                 // returns { place_id =>, type => '(osm|tiger)' }
 110                 // fails if no place was found
 111                 function lookup()
 112                 {
 113                         $sPointSQL = 'ST_SetSRID(ST_Point('.$this->fLon.','.$this->fLat.'),4326)';
 114                         $iMaxRank = $this->iMaxRank;
 115                         $iMaxRank_orig = $this->iMaxRank;
 116
 117                         // Find the nearest point
 118                         $fSearchDiam = 0.0004;
 119                         $iPlaceID = null;
 120                         $aArea = false;
 121                         $fMaxAreaDistance = 1;
 122                         $bIsInUnitedStates = false;
 123                         $bPlaceIsTiger = false;
 124                         $bPlaceIsLine = false;
 125                         while(!$iPlaceID && $fSearchDiam < $fMaxAreaDistance)
 126                         {
 127                                 $fSearchDiam = $fSearchDiam * 2;
 128
 129                                 // If we have to expand the search area by a large amount then we need a larger feature
 130                                 // then there is a limit to how small the feature should be
 131                                 if ($fSearchDiam > 2 && $iMaxRank > 4) $iMaxRank = 4;
 132                                 if ($fSearchDiam > 1 && $iMaxRank > 9) $iMaxRank = 8;
 133                                 if ($fSearchDiam > 0.8 && $iMaxRank > 10) $iMaxRank = 10;
 134                                 if ($fSearchDiam > 0.6 && $iMaxRank > 12) $iMaxRank = 12;
 135                                 if ($fSearchDiam > 0.2 && $iMaxRank > 17) $iMaxRank = 17;
 136                                 if ($fSearchDiam > 0.1 && $iMaxRank > 18) $iMaxRank = 18;
 137                                 if ($fSearchDiam > 0.008 && $iMaxRank > 22) $iMaxRank = 22;
 138                                 if ($fSearchDiam > 0.001 && $iMaxRank > 26) $iMaxRank = 26;
 139
 140                                 $sSQL = 'select place_id,parent_place_id,rank_search,calculated_country_code';
 141                                 $sSQL .= ' FROM placex';
 142                                 $sSQL .= ' WHERE ST_DWithin('.$sPointSQL.', geometry, '.$fSearchDiam.')';
 143                                 $sSQL .= ' and rank_search != 28 and rank_search >= '.$iMaxRank;
 144                                 $sSQL .= ' and (name is not null or housenumber is not null)';
 145                                 $sSQL .= ' and class not in (\'waterway\',\'railway\',\'tunnel\',\'bridge\',\'man_made\')';
 146                                 $sSQL .= ' and indexed_status = 0 ';
 147                                 $sSQL .= ' and (ST_GeometryType(geometry) not in (\'ST_Polygon\',\'ST_MultiPolygon\') ';
 148                                 $sSQL .= ' OR ST_DWithin('.$sPointSQL.', centroid, '.$fSearchDiam.'))';
 149                                 $sSQL .= ' ORDER BY ST_distance('.$sPointSQL.', geometry) ASC limit 1';
 150                                 if (CONST_Debug) var_dump($sSQL);
 151                                 $aPlace = $this->oDB->getRow($sSQL);
 152                                 if (PEAR::IsError($aPlace))
 153                                 {
 154                                         failInternalError("Could not determine closest place.", $sSQL, $aPlace);
 155                                 }
 156                                 $iPlaceID = $aPlace['place_id'];
 157                                 $iParentPlaceID = $aPlace['parent_place_id'];
 158                                 $bIsInUnitedStates = ($aPlace['calculated_country_code'] == 'us');
 159                         }
 160                         // if a street or house was found, look in interpolation lines table
 161                         if ($iMaxRank_orig >= 28 && $aPlace && $aPlace['rank_search'] >= 26)
 162                         {
 163                                 // if a house was found, search the interpolation line that is at least as close as the house
 164                                 $sSQL = 'SELECT place_id, parent_place_id, 30 as rank_search, ST_line_locate_point(linegeo,'.$sPointSQL.') as fraction';
 165                                 $sSQL .= ' FROM location_property_osmline';
 166                                 $sSQL .= ' WHERE ST_DWithin('.$sPointSQL.', linegeo, '.$fSearchDiam.')';
 167                                 $sSQL .= ' and indexed_status = 0 ';
 168                                 $sSQL .= ' ORDER BY ST_distance('.$sPointSQL.', linegeo) ASC limit 1';
 169
 170                                 if (CONST_Debug)
 171                                 {
 172                                         $sSQL = preg_replace('/limit 1/', 'limit 100', $sSQL);
 173                                         var_dump($sSQL);
 174
 175                                         $aAllHouses = $this->oDB->getAll($sSQL);
 176                                         foreach($aAllHouses as $i)
 177                                         {
 178                                                 echo $i['housenumber'] . ' | ' . $i['distance'] * 1000 . ' | ' . $i['lat'] . ' | ' . $i['lon']. ' | '. "<br>\n";
 179                                         }
 180                                 }
 181                                 $aPlaceLine = $this->oDB->getRow($sSQL);
 182                                 if (PEAR::IsError($aPlaceLine))
 183                                 {
 184                                         failInternalError("Could not determine closest housenumber on an osm interpolation line.", $sSQL, $aPlaceLine);
 185                                 }
 186                                 if ($aPlaceLine)
 187                                 {
 188                                         if (CONST_Debug) var_dump('found housenumber in interpolation lines table', $aPlaceLine);
 189                                         if ($aPlace['rank_search'] == 30)
 190                                         {
 191                                                 // if a house was already found in placex, we have to find out,
 192                                                 // if the placex house or the interpolated house are closer to the searched point
 193                                                 // distance between point and placex house
 194                                                 $sSQL = 'SELECT ST_distance('.$sPointSQL.', house.geometry) as distance FROM placex as house WHERE house.place_id='.$iPlaceID;
 195                                                 $aDistancePlacex = $this->oDB->getRow($sSQL);
 196                                                 if (PEAR::IsError($aDistancePlacex))
 197                                                 {
 198                                                         failInternalError("Could not determine distance between searched point and placex house.", $sSQL, $aDistancePlacex);
 199                                                 }
 200                                                 $fDistancePlacex = $aDistancePlacex['distance'];
 201                                                 // distance between point and interpolated house (fraction on interpolation line)
 202                                                 $sSQL = 'SELECT ST_distance('.$sPointSQL.', ST_LineInterpolatePoint(linegeo, '.$aPlaceLine['fraction'].')) as distance';
 203                                                 $sSQL .= ' FROM location_property_osmline WHERE place_id = '.$aPlaceLine['place_id'];
 204                                                 $aDistanceInterpolation = $this->oDB->getRow($sSQL);
 205                                                 if (PEAR::IsError($aDistanceInterpolation))
 206                                                 {
 207                                                         failInternalError("Could not determine distance between searched point and interpolated house.", $sSQL, $aDistanceInterpolation);
 208                                                 }
 209                                                 $fDistanceInterpolation = $aDistanceInterpolation['distance'];
 210                                                 if ($fDistanceInterpolation < $fDistancePlacex)
 211                                                 {
 212                                                         // interpolation is closer to point than placex house
 213                                                         $bPlaceIsLine = true;
 214                                                         $aPlace = $aPlaceLine;
 215                                                         $iPlaceID = $aPlaceLine['place_id'];
 216                                                         $iParentPlaceID = $aPlaceLine['parent_place_id']; // the street
 217                                                         $fFraction = $aPlaceLine['fraction'];
 218                                                 }
 219                                                 // else: nothing to do, take placex house from above
 220                                         }
 221                                         else
 222                                         {
 223                                                 $bPlaceIsLine = true;
 224                                                 $aPlace = $aPlaceLine;
 225                                                 $iPlaceID = $aPlaceLine['place_id'];
 226                                                 $iParentPlaceID = $aPlaceLine['parent_place_id']; // the street
 227                                                 $fFraction = $aPlaceLine['fraction'];
 228                                         }
 229                                 }
 230                         }
 231
 232                         // Only street found? If it's in the US we can check TIGER data for nearest housenumber
 233                         if (CONST_Use_US_Tiger_Data && $bIsInUnitedStates && $iMaxRank_orig >= 28 && $iPlaceID && ($aPlace['rank_search'] == 26 || $aPlace['rank_search'] == 27 ))
 234                         {
 235                                 $fSearchDiam = 0.001;
 236                                 $sSQL = 'SELECT place_id,parent_place_id,30 as rank_search, ST_line_locate_point(linegeo,'.$sPointSQL.') as fraction';
 237                                 //if (CONST_Debug) { $sSQL .= ', housenumber, ST_distance('.$sPointSQL.', centroid) as distance, st_y(centroid) as lat, st_x(centroid) as lon'; }
 238                                 $sSQL .= ' FROM location_property_tiger WHERE parent_place_id = '.$iPlaceID;
 239                                 $sSQL .= ' AND ST_DWithin('.$sPointSQL.', linegeo, '.$fSearchDiam.')';  //no centroid anymore in Tiger data, now we have lines
 240                                 $sSQL .= ' ORDER BY ST_distance('.$sPointSQL.', linegeo) ASC limit 1';
 241
 242                                 if (CONST_Debug)
 243                                 {
 244                                         $sSQL = preg_replace('/limit 1/', 'limit 100', $sSQL);
 245                                         var_dump($sSQL);
 246
 247                                         $aAllHouses = $this->oDB->getAll($sSQL);
 248                                         foreach($aAllHouses as $i)
 249                                         {
 250                                                 echo $i['housenumber'] . ' | ' . $i['distance'] * 1000 . ' | ' . $i['lat'] . ' | ' . $i['lon']. ' | '. "<br>\n";
 251                                         }
 252                                 }
 253
 254                                 $aPlaceTiger = $this->oDB->getRow($sSQL);
 255                                 if (PEAR::IsError($aPlaceTiger))
 256                                 {
 257                                         failInternalError("Could not determine closest Tiger place.", $sSQL, $aPlaceTiger);
 258                                 }
 259                                 if ($aPlaceTiger)
 260                                 {
 261                                         if (CONST_Debug) var_dump('found Tiger housenumber', $aPlaceTiger);
 262                                         $bPlaceIsTiger = true;
 263                                         $aPlace = $aPlaceTiger;
 264                                         $iPlaceID = $aPlaceTiger['place_id'];
 265                                         $iParentPlaceID = $aPlaceTiger['parent_place_id']; // the street
 266                                         $fFraction = $aPlaceTiger['fraction'];
 267                                 }
 268                         }
 269
 270                         // The point we found might be too small - use the address to find what it is a child of
 271                         if ($iPlaceID && $iMaxRank < 28)
 272                         {
 273                                 if (($aPlace['rank_search'] > 28 || $bPlaceIsTiger || $bPlaceIsLine) && $iParentPlaceID)
 274                                 {
 275                                         $iPlaceID = $iParentPlaceID;
 276                                 }
 277                                 $sSQL  = 'select address_place_id';
 278                                 $sSQL .= ' FROM place_addressline';
 279                                 $sSQL .= " WHERE place_id = $iPlaceID";
 280                                 $sSQL .= " ORDER BY abs(cached_rank_address - $iMaxRank) asc,cached_rank_address desc,isaddress desc,distance desc";
 281                                 $sSQL .= ' LIMIT 1';
 282                                 $iPlaceID = $this->oDB->getOne($sSQL);
 283                                 if (PEAR::IsError($iPlaceID))
 284                                 {
 285                                         failInternalError("Could not get parent for place.", $sSQL, $iPlaceID);
 286                                 }
 287                                 if (!$iPlaceID)
 288                                 {
 289                                         $iPlaceID = $aPlace['place_id'];
 290                                 }
 291                         }
 292                         return array('place_id' => $iPlaceID,
 293                                                 'type' => $bPlaceIsTiger ? 'tiger' : $bPlaceIsLine ? 'interpolation' : 'osm',
 294                                                 'fraction' => ($bPlaceIsTiger || $bPlaceIsLine) ? $fFraction : -1);
 295                 }
 296
 297         }
 298 ?>