LightRod - Open Source Augmented Reality Server

From LightRod

Jump to: navigation, search


Introduction

Welcome to LightRod.org, the open source augmented reality server, or POI (Point of Interest) search.

The software started out life as MobileMaps from 1998-2009, written in Perl, and has now been converted into PHP. Given the proliferation of geo-websites, geo-data, geo-browsers (Firefox 3.5 and the iphone Safari browser) and now augmented reality phone browsers, the need arose for an open source geographic search engine, or proximity search. In its simplest form, it takes a database of points with latitude/longitude, and a search request at a given latitude/longitude, and returns the points sorted by distance.

The software is scalable to any number of records, and uses 'peano codes', or space filling curves to find the nearest results, no matter what distance they are from the request. Read more on why this is important.

The engine can be seen in 3D augmented reality at

  • Thundre Layar local product finder using the advanced keyword geo-search, with over 500 million location based keywords (the keyword functionality is not currently included in LightRod, but is available as a service). Search for 'thundre' in the Layar browser in the UK, or see a video at Thundre.
  • NakdReality which lets you use the LightRod admin panel in a live testbed, and create your own hosted layer

and on the Web at

  • Padz global rental real estate site
  • AskTheLocal using a postcode search on the same database as the Thundre product finder
  • Alien Goggles global product search built for Firefox 3.5

This complements Google Maps and other online mapping tools, by allowing nearby search results to be found, and then plotted on the map or in the browser. Because it runs on your own server, you can choose to keep your data private.

New: Create your 3D layar with a GUI editor or import from a spreadsheet.

Enter your email address to subscribe to AtomJump news about LightRod.


New: Beta integration with Layar. See LightRod Layar API.

New: Beta Location Browser. See LightRod Location Browser.

New: GUI install and admin panel. Edit your POIs immediately or import from a spreadsheet to create your first location-activated website and 3D Layar.



Contents

Getting started

Download, unpack the source PHP file into your project directory on your web server. Then run the index.php file within your browser to install the package on your server. If you want to code using the API follow the instructions in our Getting Started section to carry out a search on your own data.


What does the code look like?



$bg = new clsBasicGeosearch();
$params = array('latitude' => 50.00,			//Latitude in decimal degrees of center of search
	        'longitude' => 120.00,			//Longitude in decimal degrees of center of search
		'table_name' => "tbl_points",		//Main table name that is being searched on
		'id_field' => "int_point_id",		//Unique reference to each point in the table
		'latitude_field' => "dec_latitude",	//Field in table that has the latitude in decimal
		'longitude_field' => "dec_longitude",	//Field in table that has the longitude in decimal
		'peano_field_header' => "int_peano"	//First letters of fields in table that hold 
				 			//peano integers E.g. 'int_peano', which gets 
				 			//appended to create 'int_peano1, int_peano2,
                                                        //int_peano1iv, int_peano2iv'	
		);
$results_array = $bg->proximity_finder($params);



Source code

Source code is available under GIT version control from here


API

See the API Reference.


For assistance

Please send us feedback on our feedback form, or post to our open forum


Forum

Our open forum is the best place for queries from the community. Installation problems, feature requests, development ideas.


Useful links

  • To create an AR layer without setting up a server see NakdReality. Note: the authors are affiliated with this business.
  • For promoting your developed layers see AllYourLayarsAreBelongToUs. Note: we have no affiliation with this site.


Getting started on this Wiki

Consult the User's Guide for information on using the wiki software.


Personal tools