]> git.openstreetmap.org Git - nominatim.git/blob - lib/PlaceLookup.php
Gives preference to special terms like postcode and housenumber
[nominatim.git] / lib / PlaceLookup.php
1 <?php
2
3 namespace Nominatim;
4
5 require_once(CONST_BasePath.'/lib/Result.php');
6
7 class PlaceLookup
8 {
9     protected $oDB;
10
11     protected $aLangPrefOrderSql = "''";
12
13     protected $bAddressDetails = false;
14     protected $bExtraTags = false;
15     protected $bNameDetails = false;
16
17     protected $bIncludePolygonAsPoints = false;
18     protected $bIncludePolygonAsText = false;
19     protected $bIncludePolygonAsGeoJSON = false;
20     protected $bIncludePolygonAsKML = false;
21     protected $bIncludePolygonAsSVG = false;
22     protected $fPolygonSimplificationThreshold = 0.0;
23
24     protected $sAnchorSql = null;
25     protected $sAddressRankListSql = null;
26     protected $sAllowedTypesSQLList = null;
27     protected $bDeDupe = true;
28
29
30     public function __construct(&$oDB)
31     {
32         $this->oDB =& $oDB;
33     }
34
35     public function doDeDupe()
36     {
37         return $this->bDeDupe;
38     }
39
40     public function setIncludePolygonAsPoints($b = true)
41     {
42         $this->bIncludePolygonAsPoints = $b;
43     }
44
45     public function loadParamArray($oParams, $sGeomType = null)
46     {
47         $aLangs = $oParams->getPreferredLanguages();
48         $this->aLangPrefOrderSql =
49             'ARRAY['.join(',', array_map('getDBQuoted', $aLangs)).']';
50
51         $this->bAddressDetails = $oParams->getBool('addressdetails', true);
52         $this->bExtraTags = $oParams->getBool('extratags', false);
53         $this->bNameDetails = $oParams->getBool('namedetails', false);
54
55         $this->bDeDupe = $oParams->getBool('dedupe', $this->bDeDupe);
56
57         if ($sGeomType === null || $sGeomType == 'text') {
58             $this->bIncludePolygonAsText = $oParams->getBool('polygon_text');
59         }
60         if ($sGeomType === null || $sGeomType == 'geojson') {
61             $this->bIncludePolygonAsGeoJSON = $oParams->getBool('polygon_geojson');
62         }
63         if ($sGeomType === null || $sGeomType == 'kml') {
64             $this->bIncludePolygonAsKML = $oParams->getBool('polygon_kml');
65         }
66         if ($sGeomType === null || $sGeomType == 'svg') {
67             $this->bIncludePolygonAsSVG = $oParams->getBool('polygon_svg');
68         }
69         $this->fPolygonSimplificationThreshold
70             = $oParams->getFloat('polygon_threshold', 0.0);
71
72         $iWantedTypes =
73             ($this->bIncludePolygonAsText ? 1 : 0) +
74             ($this->bIncludePolygonAsGeoJSON ? 1 : 0) +
75             ($this->bIncludePolygonAsKML ? 1 : 0) +
76             ($this->bIncludePolygonAsSVG ? 1 : 0);
77         if ($iWantedTypes > CONST_PolygonOutput_MaximumTypes) {
78             if (CONST_PolygonOutput_MaximumTypes) {
79                 userError('Select only '.CONST_PolygonOutput_MaximumTypes.' polgyon output option');
80             } else {
81                 userError('Polygon output is disabled');
82             }
83         }
84     }
85
86     public function getMoreUrlParams()
87     {
88         $aParams = array();
89
90         if ($this->bAddressDetails) $aParams['addressdetails'] = '1';
91         if ($this->bExtraTags) $aParams['extratags'] = '1';
92         if ($this->bNameDetails) $aParams['namedetails'] = '1';
93
94         if ($this->bIncludePolygonAsPoints) $aParams['polygon'] = '1';
95         if ($this->bIncludePolygonAsText) $aParams['polygon_text'] = '1';
96         if ($this->bIncludePolygonAsGeoJSON) $aParams['polygon_geojson'] = '1';
97         if ($this->bIncludePolygonAsKML) $aParams['polygon_kml'] = '1';
98         if ($this->bIncludePolygonAsSVG) $aParams['polygon_svg'] = '1';
99
100         if ($this->fPolygonSimplificationThreshold > 0.0) {
101             $aParams['polygon_threshold'] = $this->fPolygonSimplificationThreshold;
102         }
103
104         if (!$this->bDeDupe) $aParams['dedupe'] = '0';
105
106         return $aParams;
107     }
108
109     public function setAnchorSql($sPoint)
110     {
111         $this->sAnchorSql = $sPoint;
112     }
113
114     public function setAddressRankList($aList)
115     {
116         $this->sAddressRankListSql = '('.join(',', $aList).')';
117     }
118
119     public function setAllowedTypesSQLList($sSql)
120     {
121         $this->sAllowedTypesSQLList = $sSql;
122     }
123
124     public function setLanguagePreference($aLangPrefOrder)
125     {
126         $this->aLangPrefOrderSql =
127             'ARRAY['.join(',', array_map('getDBQuoted', $aLangPrefOrder)).']';
128     }
129
130     public function setIncludeAddressDetails($bAddressDetails = true)
131     {
132         $this->bAddressDetails = $bAddressDetails;
133     }
134
135     private function addressImportanceSql($sGeometry, $sPlaceId)
136     {
137         if ($this->sAnchorSql) {
138             $sSQL = 'ST_Distance('.$this->sAnchorSql.','.$sGeometry.')';
139         } else {
140             $sSQL = '(SELECT max(ai_p.importance * (ai_p.rank_address + 2))';
141             $sSQL .= '   FROM place_addressline ai_s, placex ai_p';
142             $sSQL .= '   WHERE ai_s.place_id = '.$sPlaceId;
143             $sSQL .= '     AND ai_p.place_id = ai_s.address_place_id ';
144             $sSQL .= '     AND ai_s.isaddress ';
145             $sSQL .= '     AND ai_p.importance is not null)';
146         }
147
148         return $sSQL.' AS addressimportance,';
149     }
150
151     private function langAddressSql($sHousenumber)
152     {
153         return 'get_address_by_language(place_id,'.$sHousenumber.','.$this->aLangPrefOrderSql.') AS langaddress,';
154     }
155
156     public function lookupOSMID($sType, $iID)
157     {
158         $sSQL = "select place_id from placex where osm_type = '".$sType."' and osm_id = ".$iID;
159         $iPlaceID = chksql($this->oDB->getOne($sSQL));
160
161         if (!$iPlaceID) {
162             return null;
163         }
164
165         $aResults = $this->lookup(array($iPlaceID => new Result($iPlaceID)));
166
167         return sizeof($aResults) ? reset($aResults) : null;
168     }
169
170     public function lookup($aResults, $iMinRank = 0, $iMaxRank = 30)
171     {
172         if (!sizeof($aResults)) {
173             return array();
174         }
175         $aSubSelects = array();
176
177         $sPlaceIDs = Result::joinIdsByTable($aResults, Result::TABLE_PLACEX);
178         if (CONST_Debug) var_dump('PLACEX', $sPlaceIDs);
179         if ($sPlaceIDs) {
180             $sSQL  = 'SELECT ';
181             $sSQL .= '    osm_type,';
182             $sSQL .= '    osm_id,';
183             $sSQL .= '    class,';
184             $sSQL .= '    type,';
185             $sSQL .= '    admin_level,';
186             $sSQL .= '    rank_search,';
187             $sSQL .= '    rank_address,';
188             $sSQL .= '    min(place_id) AS place_id,';
189             $sSQL .= '    min(parent_place_id) AS parent_place_id,';
190             $sSQL .= '    -1 as housenumber,';
191             $sSQL .= '    country_code,';
192             $sSQL .= $this->langAddressSql('-1');
193             $sSQL .= '    get_name_by_language(name,'.$this->aLangPrefOrderSql.') AS placename,';
194             $sSQL .= "    get_name_by_language(name, ARRAY['ref']) AS ref,";
195             if ($this->bExtraTags) {
196                 $sSQL .= 'hstore_to_json(extratags)::text AS extra,';
197             }
198             if ($this->bNameDetails) {
199                 $sSQL .= 'hstore_to_json(name)::text AS names,';
200             }
201             $sSQL .= '    avg(ST_X(centroid)) AS lon, ';
202             $sSQL .= '    avg(ST_Y(centroid)) AS lat, ';
203             $sSQL .= '    COALESCE(importance,0.75-(rank_search::float/40)) AS importance, ';
204             $sSQL .= $this->addressImportanceSql(
205                 'ST_Collect(centroid)',
206                 'min(CASE WHEN placex.rank_search < 28 THEN placex.place_id ELSE placex.parent_place_id END)'
207             );
208             $sSQL .= "    (extratags->'place') AS extra_place ";
209             $sSQL .= ' FROM placex';
210             $sSQL .= " WHERE place_id in ($sPlaceIDs) ";
211             $sSQL .= '   AND (';
212             $sSQL .= "        placex.rank_address between $iMinRank and $iMaxRank ";
213             if (14 >= $iMinRank && 14 <= $iMaxRank) {
214                 $sSQL .= "    OR (extratags->'place') = 'city'";
215             }
216             if ($this->sAddressRankListSql) {
217                 $sSQL .= '    OR placex.rank_address in '.$this->sAddressRankListSql;
218             }
219             $sSQL .= '       ) ';
220             if ($this->sAllowedTypesSQLList) {
221                 $sSQL .= 'AND placex.class in '.$this->sAllowedTypesSQLList;
222             }
223             $sSQL .= '    AND linked_place_id is null ';
224             $sSQL .= ' GROUP BY ';
225             $sSQL .= '     osm_type, ';
226             $sSQL .= '     osm_id, ';
227             $sSQL .= '     class, ';
228             $sSQL .= '     type, ';
229             $sSQL .= '     admin_level, ';
230             $sSQL .= '     rank_search, ';
231             $sSQL .= '     rank_address, ';
232             $sSQL .= '     housenumber,';
233             $sSQL .= '     country_code, ';
234             $sSQL .= '     importance, ';
235             if (!$this->bDeDupe) $sSQL .= 'place_id,';
236             $sSQL .= '     langaddress, ';
237             $sSQL .= '     placename, ';
238             $sSQL .= '     ref, ';
239             if ($this->bExtraTags) $sSQL .= 'extratags, ';
240             if ($this->bNameDetails) $sSQL .= 'name, ';
241             $sSQL .= "     extratags->'place' ";
242
243             $aSubSelects[] = $sSQL;
244         }
245
246         // postcode table
247         $sPlaceIDs = Result::joinIdsByTable($aResults, Result::TABLE_POSTCODE);
248         if ($sPlaceIDs) {
249             $sSQL = 'SELECT';
250             $sSQL .= "  'P' as osm_type,";
251             $sSQL .= '  (SELECT osm_id from placex p WHERE p.place_id = lp.parent_place_id) as osm_id,';
252             $sSQL .= "  'place' as class, 'postcode' as type,";
253             $sSQL .= '  null as admin_level, rank_search, rank_address,';
254             $sSQL .= '  place_id, parent_place_id,';
255             $sSQL .= '  null as housenumber,';
256             $sSQL .= '  country_code,';
257             $sSQL .= $this->langAddressSql('-1');
258             $sSQL .= '  postcode as placename,';
259             $sSQL .= '  postcode as ref,';
260             if ($this->bExtraTags) $sSQL .= 'null AS extra,';
261             if ($this->bNameDetails) $sSQL .= 'null AS names,';
262             $sSQL .= '  ST_x(geometry) AS lon, ST_y(geometry) AS lat,';
263             $sSQL .= '  (0.75-(rank_search::float/40)) AS importance, ';
264             $sSQL .= $this->addressImportanceSql('geometry', 'lp.parent_place_id');
265             $sSQL .= '  null AS extra_place ';
266             $sSQL .= 'FROM location_postcode lp';
267             $sSQL .= " WHERE place_id in ($sPlaceIDs) ";
268             $sSQL .= "   AND lp.rank_address between $iMinRank and $iMaxRank";
269
270             $aSubSelects[] = $sSQL;
271         }
272
273         // All other tables are rank 30 only.
274         if ($iMaxRank == 30) {
275             // TIGER table
276             if (CONST_Use_US_Tiger_Data) {
277                 $sPlaceIDs = Result::joinIdsByTable($aResults, Result::TABLE_TIGER);
278                 if ($sPlaceIDs) {
279                     $sHousenumbers = Result::sqlHouseNumberTable($aResults, Result::TABLE_TIGER);
280                     // Tiger search only if a housenumber was searched and if it was found
281                     // (realized through a join)
282                     $sSQL = ' SELECT ';
283                     $sSQL .= "     'T' AS osm_type, ";
284                     $sSQL .= '     (SELECT osm_id from placex p WHERE p.place_id=blub.parent_place_id) as osm_id, ';
285                     $sSQL .= "     'place' AS class, ";
286                     $sSQL .= "     'house' AS type, ";
287                     $sSQL .= '     null AS admin_level, ';
288                     $sSQL .= '     30 AS rank_search, ';
289                     $sSQL .= '     30 AS rank_address, ';
290                     $sSQL .= '     place_id, ';
291                     $sSQL .= '     parent_place_id, ';
292                     $sSQL .= '     housenumber_for_place as housenumber,';
293                     $sSQL .= "     'us' AS country_code, ";
294                     $sSQL .= $this->langAddressSql('housenumber_for_place');
295                     $sSQL .= '     null AS placename, ';
296                     $sSQL .= '     null AS ref, ';
297                     if ($this->bExtraTags) $sSQL .= 'null AS extra,';
298                     if ($this->bNameDetails) $sSQL .= 'null AS names,';
299                     $sSQL .= '     st_x(centroid) AS lon, ';
300                     $sSQL .= '     st_y(centroid) AS lat,';
301                     $sSQL .= '     -1.15 AS importance, ';
302                     $sSQL .= $this->addressImportanceSql('centroid', 'blub.parent_place_id');
303                     $sSQL .= '     null AS extra_place ';
304                     $sSQL .= ' FROM (';
305                     $sSQL .= '     SELECT place_id, ';    // interpolate the Tiger housenumbers here
306                     $sSQL .= '         ST_LineInterpolatePoint(linegeo, (housenumber_for_place-startnumber::float)/(endnumber-startnumber)::float) AS centroid, ';
307                     $sSQL .= '         parent_place_id, ';
308                     $sSQL .= '         housenumber_for_place';
309                     $sSQL .= '     FROM (';
310                     $sSQL .= '            location_property_tiger ';
311                     $sSQL .= '            JOIN (values '.$sHousenumbers.') AS housenumbers(place_id, housenumber_for_place) USING(place_id)) ';
312                     $sSQL .= '     WHERE ';
313                     $sSQL .= '         housenumber_for_place >= startnumber';
314                     $sSQL .= '         AND housenumber_for_place <= endnumber';
315                     $sSQL .= ' ) AS blub'; //postgres wants an alias here
316
317                     $aSubSelects[] = $sSQL;
318                 }
319             }
320
321             // osmline - interpolated housenumbers
322             $sPlaceIDs = Result::joinIdsByTable($aResults, Result::TABLE_OSMLINE);
323             if ($sPlaceIDs) {
324                 $sHousenumbers = Result::sqlHouseNumberTable($aResults, Result::TABLE_OSMLINE);
325                 // interpolation line search only if a housenumber was searched
326                 // (realized through a join)
327                 $sSQL = 'SELECT ';
328                 $sSQL .= "  'W' AS osm_type, ";
329                 $sSQL .= '  osm_id, ';
330                 $sSQL .= "  'place' AS class, ";
331                 $sSQL .= "  'house' AS type, ";
332                 $sSQL .= '  15 AS admin_level, ';
333                 $sSQL .= '  30 AS rank_search, ';
334                 $sSQL .= '  30 AS rank_address, ';
335                 $sSQL .= '  place_id, ';
336                 $sSQL .= '  parent_place_id, ';
337                 $sSQL .= '  housenumber_for_place as housenumber,';
338                 $sSQL .= '  country_code, ';
339                 $sSQL .= $this->langAddressSql('housenumber_for_place');
340                 $sSQL .= '  null AS placename, ';
341                 $sSQL .= '  null AS ref, ';
342                 if ($this->bExtraTags) $sSQL .= 'null AS extra, ';
343                 if ($this->bNameDetails) $sSQL .= 'null AS names, ';
344                 $sSQL .= '  st_x(centroid) AS lon, ';
345                 $sSQL .= '  st_y(centroid) AS lat, ';
346                 // slightly smaller than the importance for normal houses
347                 $sSQL .= '  -0.1 AS importance, ';
348                 $sSQL .= $this->addressImportanceSql('centroid', 'blub.parent_place_id');
349                 $sSQL .= '  null AS extra_place ';
350                 $sSQL .= '  FROM (';
351                 $sSQL .= '     SELECT ';
352                 $sSQL .= '         osm_id, ';
353                 $sSQL .= '         place_id, ';
354                 $sSQL .= '         country_code, ';
355                 $sSQL .= '         CASE ';             // interpolate the housenumbers here
356                 $sSQL .= '           WHEN startnumber != endnumber ';
357                 $sSQL .= '           THEN ST_LineInterpolatePoint(linegeo, (housenumber_for_place-startnumber::float)/(endnumber-startnumber)::float) ';
358                 $sSQL .= '           ELSE ST_LineInterpolatePoint(linegeo, 0.5) ';
359                 $sSQL .= '         END as centroid, ';
360                 $sSQL .= '         parent_place_id, ';
361                 $sSQL .= '         housenumber_for_place ';
362                 $sSQL .= '     FROM (';
363                 $sSQL .= '            location_property_osmline ';
364                 $sSQL .= '            JOIN (values '.$sHousenumbers.') AS housenumbers(place_id, housenumber_for_place) USING(place_id)';
365                 $sSQL .= '          ) ';
366                 $sSQL .= '     WHERE housenumber_for_place >= 0 ';
367                 $sSQL .= '  ) as blub'; //postgres wants an alias here
368
369                 $aSubSelects[] = $sSQL;
370             }
371
372             if (CONST_Use_Aux_Location_data) {
373                 $sPlaceIDs = Result::joinIdsByTable($aResults, Result::TABLE_AUX);
374                 if ($sPlaceIDs) {
375                     $sHousenumbers = Result::sqlHouseNumberTable($aResults, Result::TABLE_AUX);
376                     $sSQL = '  SELECT ';
377                     $sSQL .= "     'L' AS osm_type, ";
378                     $sSQL .= '     place_id AS osm_id, ';
379                     $sSQL .= "     'place' AS class,";
380                     $sSQL .= "     'house' AS type, ";
381                     $sSQL .= '     null AS admin_level, ';
382                     $sSQL .= '     30 AS rank_search,';
383                     $sSQL .= '     30 AS rank_address, ';
384                     $sSQL .= '     place_id,';
385                     $sSQL .= '     parent_place_id, ';
386                     $sSQL .= '     housenumber,';
387                     $sSQL .= "     'us' AS country_code, ";
388                     $sSQL .= $this->langAddressSql('-1');
389                     $sSQL .= '     null AS placename, ';
390                     $sSQL .= '     null AS ref, ';
391                     if ($this->bExtraTags) $sSQL .= 'null AS extra, ';
392                     if ($this->bNameDetails) $sSQL .= 'null AS names, ';
393                     $sSQL .= '     ST_X(centroid) AS lon, ';
394                     $sSQL .= '     ST_Y(centroid) AS lat, ';
395                     $sSQL .= '     -1.10 AS importance, ';
396                     $sSQL .= $this->addressImportanceSql(
397                         'centroid',
398                         'location_property_aux.parent_place_id'
399                     );
400                     $sSQL .= '     null AS extra_place ';
401                     $sSQL .= '  FROM location_property_aux ';
402                     $sSQL .= "  WHERE place_id in ($sPlaceIDs) ";
403
404                     $aSubSelects[] = $sSQL;
405                 }
406             }
407         }
408
409         if (CONST_Debug) var_dump($aSubSelects);
410
411         if (!sizeof($aSubSelects)) {
412             return array();
413         }
414
415         $aPlaces = chksql(
416             $this->oDB->getAll(join(' UNION ', $aSubSelects)),
417             'Could not lookup place'
418         );
419
420         $aClassType = getClassTypes();
421         foreach ($aPlaces as &$aPlace) {
422             if ($this->bAddressDetails) {
423                 // to get addressdetails for tiger data, the housenumber is needed
424                 $aPlace['aAddress'] = $this->getAddressNames(
425                     $aPlace['place_id'],
426                     $aPlace['housenumber']
427                 );
428             }
429
430             if ($this->bExtraTags) {
431                 if ($aPlace['extra']) {
432                     $aPlace['sExtraTags'] = json_decode($aPlace['extra']);
433                 } else {
434                     $aPlace['sExtraTags'] = (object) array();
435                 }
436             }
437
438             if ($this->bNameDetails) {
439                 if ($aPlace['names']) {
440                     $aPlace['sNameDetails'] = json_decode($aPlace['names']);
441                 } else {
442                     $aPlace['sNameDetails'] = (object) array();
443                 }
444             }
445
446             $sAddressType = '';
447             $sClassType = $aPlace['class'].':'.$aPlace['type'].':'.$aPlace['admin_level'];
448             if (isset($aClassType[$sClassType]) && isset($aClassType[$sClassType]['simplelabel'])) {
449                 $sAddressType = $aClassType[$aClassType]['simplelabel'];
450             } else {
451                 $sClassType = $aPlace['class'].':'.$aPlace['type'];
452                 if (isset($aClassType[$sClassType]) && isset($aClassType[$sClassType]['simplelabel']))
453                     $sAddressType = $aClassType[$sClassType]['simplelabel'];
454                 else $sAddressType = $aPlace['class'];
455             }
456
457             $aPlace['addresstype'] = $sAddressType;
458         }
459
460         if (CONST_Debug) var_dump($aPlaces);
461
462         return $aPlaces;
463     }
464
465     private function getAddressDetails($iPlaceID, $bAll, $sHousenumber)
466     {
467         $sSQL = 'SELECT *,';
468         $sSQL .= '  get_name_by_language(name,'.$this->aLangPrefOrderSql.') as localname';
469         $sSQL .= ' FROM get_addressdata('.$iPlaceID.','.$sHousenumber.')';
470         if (!$bAll) {
471             $sSQL .= " WHERE isaddress OR type = 'country_code'";
472         }
473         $sSQL .= ' ORDER BY rank_address desc,isaddress DESC';
474
475         return chksql($this->oDB->getAll($sSQL));
476     }
477
478     public function getAddressNames($iPlaceID, $sHousenumber = null)
479     {
480         $aAddressLines = $this->getAddressDetails(
481             $iPlaceID,
482             false,
483             $sHousenumber === null ? -1 : $sHousenumber
484         );
485
486         $aAddress = array();
487         $aFallback = array();
488         $aClassType = getClassTypes();
489         foreach ($aAddressLines as $aLine) {
490             $bFallback = false;
491             $aTypeLabel = false;
492             if (isset($aClassType[$aLine['class'].':'.$aLine['type'].':'.$aLine['admin_level']])) {
493                 $aTypeLabel = $aClassType[$aLine['class'].':'.$aLine['type'].':'.$aLine['admin_level']];
494             } elseif (isset($aClassType[$aLine['class'].':'.$aLine['type']])) {
495                 $aTypeLabel = $aClassType[$aLine['class'].':'.$aLine['type']];
496             } elseif (isset($aClassType['boundary:administrative:'.((int)($aLine['rank_address']/2))])) {
497                 $aTypeLabel = $aClassType['boundary:administrative:'.((int)($aLine['rank_address']/2))];
498                 $bFallback = true;
499             } else {
500                 $aTypeLabel = array('simplelabel' => 'address'.$aLine['rank_address']);
501                 $bFallback = true;
502             }
503             if ($aTypeLabel && ((isset($aLine['localname']) && $aLine['localname']) || (isset($aLine['housenumber']) && $aLine['housenumber']))) {
504                 $sTypeLabel = strtolower(isset($aTypeLabel['simplelabel'])?$aTypeLabel['simplelabel']:$aTypeLabel['label']);
505                 $sTypeLabel = str_replace(' ', '_', $sTypeLabel);
506                 if (!isset($aAddress[$sTypeLabel]) || (isset($aFallback[$sTypeLabel]) && $aFallback[$sTypeLabel]) || $aLine['class'] == 'place') {
507                     $aAddress[$sTypeLabel] = $aLine['localname']?$aLine['localname']:$aLine['housenumber'];
508                 }
509                 $aFallback[$sTypeLabel] = $bFallback;
510             }
511         }
512         return $aAddress;
513     }
514
515
516
517     /* returns an array which will contain the keys
518      *   aBoundingBox
519      * and may also contain one or more of the keys
520      *   asgeojson
521      *   askml
522      *   assvg
523      *   astext
524      *   lat
525      *   lon
526      */
527
528
529     public function getOutlines($iPlaceID, $fLon = null, $fLat = null, $fRadius = null)
530     {
531
532         $aOutlineResult = array();
533         if (!$iPlaceID) return $aOutlineResult;
534
535         if (CONST_Search_AreaPolygons) {
536             // Get the bounding box and outline polygon
537             $sSQL  = 'select place_id,0 as numfeatures,st_area(geometry) as area,';
538             $sSQL .= 'ST_Y(centroid) as centrelat,ST_X(centroid) as centrelon,';
539             $sSQL .= 'ST_YMin(geometry) as minlat,ST_YMax(geometry) as maxlat,';
540             $sSQL .= 'ST_XMin(geometry) as minlon,ST_XMax(geometry) as maxlon';
541             if ($this->bIncludePolygonAsGeoJSON) $sSQL .= ',ST_AsGeoJSON(geometry) as asgeojson';
542             if ($this->bIncludePolygonAsKML) $sSQL .= ',ST_AsKML(geometry) as askml';
543             if ($this->bIncludePolygonAsSVG) $sSQL .= ',ST_AsSVG(geometry) as assvg';
544             if ($this->bIncludePolygonAsText || $this->bIncludePolygonAsPoints) $sSQL .= ',ST_AsText(geometry) as astext';
545             $sFrom = ' from placex where place_id = '.$iPlaceID;
546             if ($this->fPolygonSimplificationThreshold > 0) {
547                 $sSQL .= ' from (select place_id,centroid,ST_SimplifyPreserveTopology(geometry,'.$this->fPolygonSimplificationThreshold.') as geometry'.$sFrom.') as plx';
548             } else {
549                 $sSQL .= $sFrom;
550             }
551
552             $aPointPolygon = chksql($this->oDB->getRow($sSQL), 'Could not get outline');
553
554             if ($aPointPolygon['place_id']) {
555                 if ($aPointPolygon['centrelon'] !== null && $aPointPolygon['centrelat'] !== null) {
556                     $aOutlineResult['lat'] = $aPointPolygon['centrelat'];
557                     $aOutlineResult['lon'] = $aPointPolygon['centrelon'];
558                 }
559
560                 if ($this->bIncludePolygonAsGeoJSON) $aOutlineResult['asgeojson'] = $aPointPolygon['asgeojson'];
561                 if ($this->bIncludePolygonAsKML) $aOutlineResult['askml'] = $aPointPolygon['askml'];
562                 if ($this->bIncludePolygonAsSVG) $aOutlineResult['assvg'] = $aPointPolygon['assvg'];
563                 if ($this->bIncludePolygonAsText) $aOutlineResult['astext'] = $aPointPolygon['astext'];
564                 if ($this->bIncludePolygonAsPoints) $aOutlineResult['aPolyPoints'] = geometryText2Points($aPointPolygon['astext'], $fRadius);
565
566
567                 if (abs($aPointPolygon['minlat'] - $aPointPolygon['maxlat']) < 0.0000001) {
568                     $aPointPolygon['minlat'] = $aPointPolygon['minlat'] - $fRadius;
569                     $aPointPolygon['maxlat'] = $aPointPolygon['maxlat'] + $fRadius;
570                 }
571
572                 if (abs($aPointPolygon['minlon'] - $aPointPolygon['maxlon']) < 0.0000001) {
573                     $aPointPolygon['minlon'] = $aPointPolygon['minlon'] - $fRadius;
574                     $aPointPolygon['maxlon'] = $aPointPolygon['maxlon'] + $fRadius;
575                 }
576
577                 $aOutlineResult['aBoundingBox'] = array(
578                                                    (string)$aPointPolygon['minlat'],
579                                                    (string)$aPointPolygon['maxlat'],
580                                                    (string)$aPointPolygon['minlon'],
581                                                    (string)$aPointPolygon['maxlon']
582                                                   );
583             }
584         }
585
586         // as a fallback we generate a bounding box without knowing the size of the geometry
587         if ((!isset($aOutlineResult['aBoundingBox'])) && isset($fLon)) {
588             //
589             if ($this->bIncludePolygonAsPoints) {
590                 $sGeometryText = 'POINT('.$fLon.','.$fLat.')';
591                 $aOutlineResult['aPolyPoints'] = geometryText2Points($sGeometryText, $fRadius);
592             }
593
594             $aBounds = array();
595             $aBounds['minlat'] = $fLat - $fRadius;
596             $aBounds['maxlat'] = $fLat + $fRadius;
597             $aBounds['minlon'] = $fLon - $fRadius;
598             $aBounds['maxlon'] = $fLon + $fRadius;
599
600             $aOutlineResult['aBoundingBox'] = array(
601                                                (string)$aBounds['minlat'],
602                                                (string)$aBounds['maxlat'],
603                                                (string)$aBounds['minlon'],
604                                                (string)$aBounds['maxlon']
605                                               );
606         }
607         return $aOutlineResult;
608     }
609 }