aboutsummaryrefslogtreecommitdiff
path: root/engine/lib/location.php
diff options
context:
space:
mode:
authormarcus <marcus@36083f99-b078-4883-b0ff-0f9b5a30f544>2008-11-25 20:09:14 +0000
committermarcus <marcus@36083f99-b078-4883-b0ff-0f9b5a30f544>2008-11-25 20:09:14 +0000
commit53d085f513d5e29af160991739e7ad1b515090a7 (patch)
treead7ca627fbf2656653edbc40f05e2c192da31078 /engine/lib/location.php
parentbf9e9feefa7e1f3af12a534999817eae9bca24ca (diff)
downloadelgg-53d085f513d5e29af160991739e7ad1b515090a7.tar.gz
elgg-53d085f513d5e29af160991739e7ad1b515090a7.tar.bz2
Hook for future geocoding library added.
git-svn-id: https://code.elgg.org/elgg/trunk@2488 36083f99-b078-4883-b0ff-0f9b5a30f544
Diffstat (limited to 'engine/lib/location.php')
-rw-r--r--engine/lib/location.php94
1 files changed, 94 insertions, 0 deletions
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