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/
59 * Constructor that makes a Location from a string name
61 * @param string $name Human-readable name (any kind)
62 * @param string $language Language, default = common_language()
64 * @return Location Location with that name (or null if not found)
67 static function fromName($name, $language=null)
69 if (is_null($language)) {
70 $language = common_language();
75 // Let a third-party handle it
77 Event::handle('LocationFromName', array($name, $language, &$location));
83 * Constructor that makes a Location from an ID
85 * @param integer $id Identifier ID
86 * @param integer $ns Namespace of the identifier
87 * @param string $language Language to return name in (default is common)
89 * @return Location The location with this ID (or null if none)
92 static function fromId($id, $ns, $language=null)
94 if (is_null($language)) {
95 $language = common_language();
100 // Let a third-party handle it
102 Event::handle('LocationFromId', array($id, $ns, $language, &$location));
108 * Constructor that finds the nearest location to a lat/lon pair
110 * @param float $lat Latitude
111 * @param float $lon Longitude
112 * @param string $language Language for results, default = current
114 * @return Location the location found, or null if none found
117 static function fromLatLon($lat, $lon, $language=null)
119 if (is_null($language)) {
120 $language = common_language();
125 // Let a third-party handle it
127 if (Event::handle('LocationFromLatLon',
128 array($lat, $lon, $language, &$location))) {
129 // Default is just the lat/lon pair
131 $location = new Location();
133 $location->lat = $lat;
134 $location->lon = $lon;
141 * Get the name for this location in the given language
143 * @param string $language language to use, default = current
145 * @return string location name or null if not found
148 function getName($language=null)
150 if (is_null($language)) {
151 $language = common_language();
154 if (array_key_exists($language, $this->names)) {
155 return $this->names[$language];
158 Event::handle('LocationNameLanguage', array($this, $language, &$name));
160 $this->names[$language] = $name;
167 * Get an URL suitable for this location
169 * @return string URL for this location or NULL
176 if (is_string($this->_url)) {
182 Event::handle('LocationUrl', array($this, &$url));