3 * StatusNet, the distributed open-source microblogging tool
9 * LICENCE: This program is free software: you can redistribute it and/or modify
10 * it under the terms of the GNU Affero General Public License as published by
11 * the Free Software Foundation, either version 3 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU Affero General Public License for more details.
19 * You should have received a copy of the GNU Affero General Public License
20 * along with this program. If not, see <http://www.gnu.org/licenses/>.
24 * @author Evan Prodromou <evan@status.net>
25 * @copyright 2009 StatusNet, Inc.
26 * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
27 * @link http://status.net/
30 if (!defined('STATUSNET') && !defined('LACONICA')) {
37 * These are stored in the DB as part of notice and profile records,
38 * but since they're about the same in both, we have a separate class
43 * @author Evan Prodromou <evan@status.net>
44 * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
45 * @link http://status.net/
58 * Constructor that makes a Location from a string name
60 * @param string $name Human-readable name (any kind)
61 * @param string $language Language, default = common_language()
63 * @return Location Location with that name (or null if not found)
66 static function fromName($name, $language=null)
68 if (is_null($language)) {
69 $language = common_language();
74 // Let a third-party handle it
76 Event::handle('LocationFromName', array($name, $language, &$location));
82 * Constructor that makes a Location from an ID
84 * @param integer $id Identifier ID
85 * @param integer $ns Namespace of the identifier
86 * @param string $language Language to return name in (default is common)
88 * @return Location The location with this ID (or null if none)
91 static function fromId($id, $ns, $language=null)
95 // Let a third-party handle it
97 Event::handle('LocationFromId', array($id, $ns, $language, &$location));
103 * Constructor that finds the nearest location to a lat/lon pair
105 * @param float $lat Latitude
106 * @param float $lon Longitude
107 * @param string $language Language for results, default = current
109 * @return Location the location found, or null if none found
112 static function fromLatLon($lat, $lon, $language=null)
114 if (is_null($language)) {
115 $language = common_language();
120 // Let a third-party handle it
122 if (Event::handle('LocationFromLatLon',
123 array($lat, $lon, $language, &$location))) {
124 // Default is just the lat/lon pair
126 $location = new Location();
128 $location->lat = $lat;
129 $location->lon = $lon;
136 * Get the name for this location in the given language
138 * @param string $language language to use, default = current
140 * @return string location name or null if not found
143 function getName($language=null)
145 if (is_null($language)) {
146 $language = common_language();
149 if (array_key_exists($language, $this->names)) {
150 return $this->names[$language];
153 Event::handle('LocationNameLanguage', array($this, $language, &$name));
155 $this->names[$language] = $name;