lib-php/AddressDetails.php

   1 <?php
   2
   3 namespace Nominatim;
   4
   5 require_once(CONST_LibDir.'/ClassTypes.php');
   6
   7 /**
   8  * Detailed list of address parts for a single result
   9  */
  10 class AddressDetails
  11 {
  12     private $iPlaceID;
  13     private $aAddressLines;
  14
  15     public function __construct(&$oDB, $iPlaceID, $sHousenumber, $mLangPref)
  16     {
  17         $this->iPlaceID = $iPlaceID;
  18
  19         if (is_array($mLangPref)) {
  20             $mLangPref = $oDB->getArraySQL($oDB->getDBQuotedList($mLangPref));
  21         }
  22
  23         if (!isset($sHousenumber)) {
  24             $sHousenumber = -1;
  25         }
  26
  27         $sSQL = 'SELECT *,';
  28         $sSQL .= ' get_name_by_language(name,'.$mLangPref.') as localname';
  29         $sSQL .= ' FROM get_addressdata('.$iPlaceID.','.$sHousenumber.')';
  30         $sSQL .= ' ORDER BY rank_address DESC, isaddress DESC';
  31
  32         $this->aAddressLines = $oDB->getAll($sSQL);
  33     }
  34
  35     private static function isAddress($aLine)
  36     {
  37         return $aLine['isaddress'] || $aLine['type'] == 'country_code';
  38     }
  39
  40     public function getAddressDetails($bAll = false)
  41     {
  42         if ($bAll) {
  43             return $this->aAddressLines;
  44         }
  45
  46         return array_filter($this->aAddressLines, array(__CLASS__, 'isAddress'));
  47     }
  48
  49     public function getLocaleAddress()
  50     {
  51         $aParts = array();
  52         $sPrevResult = '';
  53
  54         foreach ($this->aAddressLines as $aLine) {
  55             if ($aLine['isaddress'] && $sPrevResult != $aLine['localname']) {
  56                 $sPrevResult = $aLine['localname'];
  57                 $aParts[] = $sPrevResult;
  58             }
  59         }
  60
  61         return join(', ', $aParts);
  62     }
  63
  64     public function getAddressNames()
  65     {
  66         $aAddress = array();
  67
  68         foreach ($this->aAddressLines as $aLine) {
  69             if (!self::isAddress($aLine)) {
  70                 continue;
  71             }
  72
  73             $sTypeLabel = ClassTypes\getLabelTag($aLine);
  74
  75             $sName = null;
  76             if (isset($aLine['localname']) && $aLine['localname']!=='') {
  77                 $sName = $aLine['localname'];
  78             } elseif (isset($aLine['housenumber']) && $aLine['housenumber']!=='') {
  79                 $sName = $aLine['housenumber'];
  80             }
  81
  82             if (isset($sName)
  83                 && (!isset($aAddress[$sTypeLabel])
  84                     || $aLine['class'] == 'place')
  85             ) {
  86                 $aAddress[$sTypeLabel] = $sName;
  87             }
  88         }
  89
  90         return $aAddress;
  91     }
  92
  93     /**
  94      * Annotates the given json with geocodejson address information fields.
  95      *
  96      * @param array  $aJson  Json hash to add the fields to.
  97      *
  98      * Geocodejson has the following fields:
  99      *  street, locality, postcode, city, district,
 100      *  county, state, country
 101      *
 102      * Postcode and housenumber are added by type, district is not used.
 103      * All other fields are set according to address rank.
 104      */
 105     public function addGeocodeJsonAddressParts(&$aJson)
 106     {
 107         foreach (array_reverse($this->aAddressLines) as $aLine) {
 108             if (!$aLine['isaddress']) {
 109                 continue;
 110             }
 111
 112             if (!isset($aLine['localname']) || $aLine['localname'] == '') {
 113                 continue;
 114             }
 115
 116             if ($aLine['type'] == 'postcode' || $aLine['type'] == 'postal_code') {
 117                 $aJson['postcode'] = $aLine['localname'];
 118                 continue;
 119             }
 120
 121             if ($aLine['type'] == 'house_number') {
 122                 $aJson['housenumber'] = $aLine['localname'];
 123                 continue;
 124             }
 125
 126             if ($this->iPlaceID == $aLine['place_id']) {
 127                 continue;
 128             }
 129
 130             $iRank = (int)$aLine['rank_address'];
 131
 132             if ($iRank > 25 && $iRank < 28) {
 133                 $aJson['street'] = $aLine['localname'];
 134             } elseif ($iRank >= 22 && $iRank <= 25) {
 135                 $aJson['locality'] = $aLine['localname'];
 136             } elseif ($iRank >= 17 && $iRank <= 21) {
 137                 $aJson['district'] = $aLine['localname'];
 138             } elseif ($iRank >= 13 && $iRank <= 16) {
 139                 $aJson['city'] = $aLine['localname'];
 140             } elseif ($iRank >= 10 && $iRank <= 12) {
 141                 $aJson['county'] = $aLine['localname'];
 142             } elseif ($iRank >= 5 && $iRank <= 9) {
 143                 $aJson['state'] = $aLine['localname'];
 144             } elseif ($iRank == 4) {
 145                 $aJson['country'] = $aLine['localname'];
 146             }
 147         }
 148     }
 149
 150     public function getAdminLevels()
 151     {
 152         $aAddress = array();
 153         foreach (array_reverse($this->aAddressLines) as $aLine) {
 154             if (self::isAddress($aLine)
 155                 && isset($aLine['admin_level'])
 156                 && $aLine['admin_level'] < 15
 157                 && !isset($aAddress['level'.$aLine['admin_level']])
 158             ) {
 159                 $aAddress['level'.$aLine['admin_level']] = $aLine['localname'];
 160             }
 161         }
 162         return $aAddress;
 163     }
 164
 165     public function debugInfo()
 166     {
 167         return $this->aAddressLines;
 168     }
 169 }