diff options
Diffstat (limited to 'engine/lib')
| -rw-r--r-- | engine/lib/entities.php | 51 | ||||
| -rw-r--r-- | engine/lib/location.php | 94 |
2 files changed, 145 insertions, 0 deletions
diff --git a/engine/lib/entities.php b/engine/lib/entities.php index 99c8bdca6..b645fc372 100644 --- a/engine/lib/entities.php +++ b/engine/lib/entities.php @@ -17,6 +17,9 @@ /// Cache subtype searches $SUBTYPE_CACHE = NULL; + /// Require the locatable interface TODO: Move this into start.php? + require_once('location.php'); + /** * ElggEntity The elgg entity superclass * This class holds methods for accessing the main entities table. @@ -27,6 +30,7 @@ */ abstract class ElggEntity implements Notable, // Calendar interface + Locatable, // Geocoding interface Exportable, // Allow export of data Importable, // Allow import of data Loggable, // Can events related to this object class be logged @@ -711,6 +715,53 @@ return $res; } + // LOCATABLE INTERFACE ///////////////////////////////////////////////////////////// + + /** Interface to set the location */ + public function setLocation($location) + { + $location = sanitise_string($location); + + $this->location = $location; + + return true; + } + + /** + * Set latitude and longitude tags for a given entity. + * + * @param float $lat + * @param float $long + */ + public function setLatLong($lat, $long) + { + $lat = sanitise_string($lat); + $long = sanitise_string($long); + + $this->set('geo:lat', $lat); + $this->set('geo:long', $long); + + return true; + } + + /** + * Get the contents of the ->geo:lat field. + * + */ + public function getLatitude() { return $this->get('geo:lat'); } + + /** + * Get the contents of the ->geo:lat field. + * + */ + public function getLongitude() { return $this->get('geo:long'); } + + /** + * Get the ->location metadata. + * + */ + public function getLocation() { return $this->get('location'); } + // NOTABLE INTERFACE /////////////////////////////////////////////////////////////// /** diff --git a/engine/lib/location.php b/engine/lib/location.php new file mode 100644 index 000000000..eec665234 --- /dev/null +++ b/engine/lib/location.php @@ -0,0 +1,94 @@ +<?php + + /** + * Elgg geo-location tagging library. + * + * @package Elgg + * @subpackage Core + * @license http://www.gnu.org/licenses/old-licenses/gpl-2.0.html GNU Public License version 2 + * @author Curverider Ltd + * @copyright Curverider Ltd 2008 + * @link http://elgg.org/ + */ + + /** + * Define an interface for geo-tagging entities. + * + */ + interface Locatable + { + /** Set a location text */ + public function setLocation($location); + + /** + * Set latitude and longitude tags for a given entity. + * + * @param float $lat + * @param float $long + */ + public function setLatLong($lat, $long); + + /** + * Get the contents of the ->geo:lat field. + * + */ + public function getLatitude(); + + /** + * Get the contents of the ->geo:lat field. + * + */ + public function getLongitude(); + + /** + * Get the ->location metadata. + * + */ + public function getLocation(); + } + + /** + * Encode a location into a latitude and longitude, caching the result. + * + * Works by triggering the 'geocode' 'location' plugin hook, and requires a geocoding module to be installed + * activated in order to work. + * + * @param String $location The location, e.g. "London", or "24 Foobar Street, Gotham City" + */ + function elgg_geocode_location($location) + { + global $CONFIG; + + $location = sanitise_string($location); + + // Look for cached version + $cached_location = get_data_row("SELECT * from {$CONFIG->dbprefix}geocode_cache WHERE location='$location'"); + + // Trigger geocode event + $return = false; + $return = trigger_plugin_hook('geocode', 'location', array('location' => $location, $return)); + + // If returned, cache and return value + if (($return) && (is_array($return))) + { + $lat = (int)$return['lat']; + $long = (int)$return['long']; + + // Put into cache at the end of the page since we don't really care that much + execute_delayed_write_query("INSERT DELAYED INTO {$CONFIG->dbprefix}geocode_cache (lat, long) VALUES ({$lat}, {$long}) ON DUPLICATE KEY UPDATE lat={$lat} long={$long}"); + } + + return $return; + } + + // Some distances in degrees (approximate) + define("MILE", 0.01515); + define("KILOMETER", 0.00932); + + + // TODO: get objects within x miles by entities, metadata and relationship + + // TODO: List + + +?>
\ No newline at end of file |