Eyesis Panorama Database
Contents
- 1 About
- 1.1 MySQL DB Structure
- 1.2 PHP Methods
- 1.2.1 Implemented
- 1.2.2 Array GetRouteData (int $ID)
- 1.2.3 AddNode (Array $Data)
- 1.2.4 AddRoute (Array $Data)
- 1.2.5 GetNodeCount($RouteID = null)
- 1.2.6 void AddNodeToRoute (int $NodeID, int $RouteID)
- 1.2.7 void ImportKML (String $KMLfile, int $RouteID)
- 1.2.8 Float GetNodeDistance ($Node1ID, $Node1ID)
- 1.2.9 Array GetNodesAt ($LatMin, $LatMax, $LongMin, $LongMax, $Limit = 100)
- 1.2.10 Array GetNodesByRoute($RouteID)
- 1.2.11 void DeleteRoute($RouteID)
- 1.2.12 Array DeleteNode($NodeID)
- 1.2.13 void RemoveNodeFromRoute($NodeID, $RouteID)
- 1.2.14 void UpdateNode($Parameters[])
- 1.2.15 TODO
- 1.3 Glossary
- 1.4 Process Definitions
- 1.5 Notes
About
This project contains a set of PHP functions and requires a MySQL database. It is a framework for storing, accessing and altering a large set of geotagged panorama images in a database. This simplifies the process of building Streetview-like panorama viewers.
MySQL DB Structure
Nodes Table:
ID Name Description OriginalDataLongitude OriginalDataLatitude OriginalDataAltitude OriginalDataHeading OriginalDataTilt OriginalDataRoll Longitude Latitude Timestamp TimeStampMilliseconds // Since MySQL's own timestamp format is accurate only down to 1 second we store Milliseconds in a separate field Altitude Heading Tilt Roll Panorama URL Visibility3D - list of ranges [from,to] - which nodes are visible from the current one. from, to are both relative to the current node, so merging several segments should not break visibility (not so easy in the map that is not linear path, but we'll think of something - adding new nodes (importing KML) should not change the relative sequence of indices (kml "name" tag).
Routes Table:
ID Name Description
Nodes_Routes Table:
Nodes Routes Order
PHP Methods
Implemented
The following functions are already working. The return value is put in front of the function (C-like Systax, even though it does not exist in that way in PHP which this framework is written in)
Array GetNodeData (int $ID)
Returns all database fields of a specific Node ID as array
Return value
On success: Returns the Node data as array with the following fields:
$return['ID'] $return['Name'] $return['Description'] $return['OriginalDataLongitude'] $return['OriginalDataLatitude'] $return['OriginalDataAltitude'] $return['OriginalDataHeading'] $return['OriginalDataTilt'] $return['OriginalDataRoll'] $return['Longitude'] $return['Latitude'] $return['Timestamp'] $return['TimeStampMilliseconds'] $return['Altitude'] $return['Heading'] $return['Tilt'] $return['Roll'] $return['PanoramaURL'] $return['Visibility3D']
On an error:
$return['error'] = "ID not found";
Array GetRouteData (int $ID)
Returns all database fields of a specific Route ID as array
Return value
On success: Returns the Route data as array with the following fields:
$return['ID'] $return['Name'] $return['Description']
On an error:
$return['error'] = "ID not found";
AddNode (Array $Data)
Save a new Node to the DB supplying the following database fields:
$Data['Name'] $Data['Description'] $Data['OriginalDataLongitude'] $Data['OriginalDataLatitude'] $Data['OriginalDataAltitude'] $Data['OriginalDataHeading'] $Data['OriginalDataTilt'] $Data['OriginalDataRoll'] $Data['Longitude'] $Data['Latitude'] $Data['Timestamp'] $Data['TimeStampMilliseconds'] $Data['Altitude'] $Data['Heading'] $Data['Tilt'] $Data['Roll'] $Data['PanoramaURL'] $Data['Visibility3D']
Return value
On success:
Returns the ID of the newly created Node
On an error:
$return['error'] = "Entry with same Coordinates already exists";
AddRoute (Array $Data)
Save a new Route to the DB supplying the following database fields:
Return value
On success:
Returns the ID of the newly created Route
On an error:
$return['error'] = "Entry already exists";
GetNodeCount($RouteID = null)
Returns the number of Nodes stored in the DB, if you supply a $RouteID parameter you get the number of Nodes associated with a specific Route.
Return value
Number of Nodes
void AddNodeToRoute (int $NodeID, int $RouteID)
Adds one Node to a Route. Both have to exist already.
Return value
On success:
$return['success'] = "done";
On an error:
$return['error'] = "Route with supplied ID does not exist"; $return['error'] = "Node with supplied ID does not exist"; $return['error'] = "Entry already exists";
void ImportKML (String $KMLfile, int $RouteID)
Works just like AddNode but can import a high number of nodes with a single function - read from a KML file, if you supply a RouteID all new Nodes will automatically be added to an existing route.
Return value
On success:
$return['success'] = "done"; $return['Entries'] // Number of entries imported from the KML
On an error:
// TODO
Float GetNodeDistance ($Node1ID, $Node1ID)
Returns the distance between 2 nodes in metres.
To calculate this distance assume that the 2 Nodes have no big altitude difference and calculate the distance based on their longitude and latitude on the earth sphere surface.
Return value
On success:
distance in meters as Float
On an error:
$return['error'] = "Node 1: ".$node1['error']; $return['error'] = "Node 1: ".$node2['error'];
Array GetNodesAt ($LatMin, $LatMax, $LongMin, $LongMax, $Limit = 100)
Find an array of nodes that are in the area of the supplied coordinates (LatMin, LatMax, LongMin, LongMax). To prevent a huge number of results there is the limit parameter with a default value of 100. The results are not returned in a particular order.
Return value
On success:
Array of Nodes
On an error (no Nodes found in the specified area):
empty Array
Array GetNodesByRoute($RouteID)
Returns all Nodes associated with a Route ordered by the routes_nodes 'order' column in a multidimensional array
Return value
On success:
Array of Nodes
On an error:
$return['error'] = "Route with ID: ".$RouteID." not found";
void DeleteRoute($RouteID)
Delete Route and all Nodes associated with it.
Return value
On success:
$return['success'] = "done"; $return['entries'] // number of deleted associated Nodes
On an error:
$return['error'] = "Route with RouteID: ".$RouteID." does not exist";
Array DeleteNode($NodeID)
Delete a single Node
Return value
On success:
$return['success'] = "done";
On an error:
$return['error'] = "Entry with NodeID: ".$NodeID." does not exist";
void RemoveNodeFromRoute($NodeID, $RouteID)
Removes a Node from a Route, does not delete the actual Node, just removes the relationship between Route and this Node.
Since this function is intended for clean-up it does not check if the Node or Route to delete still exists.
Return value
On success:
$return['success'] = "done";
On an error:
$return['error'] = "Entry with NodeID: ".$NodeID." and RouteID: ".$RouteID." does not exist";
void UpdateNode($Parameters[])
This function can be used to edit existing node data. The node has to exist already.
The parameter has to be an array with the following fields:
$Parameters['ID'] = 1;
The ID field is mandatory to identify which Node to edit, all the following fields are optional:
$Parameters['Name'] = "changed"; $Parameters['Description'] = "changed"; $Parameters['Longitude'] = "0"; $Parameters['Latitude'] = "0"; $Parameters['Timestamp'] = "0"; $Parameters['TimeStampMilliseconds'] = "0"; $Parameters['Altitude'] = "0"; $Parameters['Heading'] = "0"; $Parameters['Tilt'] = "0"; $Parameters['Roll'] = "0"; $Parameters['PanoramaURL'] = "changed"; $Parameters['Visibility3D'] = "changed";
UpdateNode($Parameters));
Note that fields like "OriginalDataLongitude" or "OriginalDataRoll" cannot be overwritten.
Return value
On success:
$return['error'] = "success";
On an error:
$return['error'] = "Node with ID: ".$Parameters['ID']." not found";
TODO
int GetNextNodeinRoute (int $NodeID)
Routes are a sequence of nodes, The order is set by an "order" field in the routes_nodes table. Next node means higher order value.
int GetPreviousNodeinRoute (int $NodeID)
Routes are a sequence of nodes, The order is set by an "order" field in the routes_nodes table. Previous node means lower order value.
void UpdateRoute($Parameters[])
Glossary
Node One full 360 degree panorama with metadata.
Route Sequence of multiple panoramas
Tile A panorama image is split up into multiple tiles for performance reasons.
Process Definitions
Upload of panorama images
- upload all images to an "upload" directory via FTP/SSH/etc.
- you start the import script by providing a KML
- the PHP script moves one image after the other to a different folder with NodeID as folder name for example and adds it to the DB
- the PHP script deletes the KML or does not save it at all in the first place
Notes
KML file format example
<?xml version="1.0" encoding="UTF-8"?> <kml xmlns="http://earth.google.com/kml/2.2"> <Document> <PhotoOverlay> <name>0</name> <shape>rectangle</shape> <TimeStamp> <when>2011-04-22T20:55:09.926681Z</when> </TimeStamp> <Camera> <longitude>-110.80748065628902</longitude> <latitude>38.59026617490507</latitude> <altitude>1536</altitude> <heading>162.60471534016946</heading> <tilt>71.2006112797243</tilt> <roll>14.082961141415383</roll> </Camera> <Icon> <href>http://community.elphel.com/files/eyesis/webgl-pano/3/panos_lwhc/result_1303527309_926681-000001.jpeg</href> </Icon> <ExtendedData> <OriginalData> <longitude>-110.817908</longitude> <latitude>38.58143</latitude> <altitude>1516.2</altitude> <heading>0</heading> <tilt>90</tilt> <roll>0</roll> </OriginalData> <Visibility3d> <v3Range><to>15</to></v3Range> // (no "from") means "from -infinity to +35" - this is not a distance but means from all nodes before until +15 nodes in the sequence <v3Range><from>21</from><to>21</to></v3Range> <v3Range><from>24</from><to>25</to></v3Range> <v3Range><from>27</from><to>41</to></v3Range> </Visibility3d> </ExtendedData> <description>Start</description> <visibility>1</visibility> </PhotoOverlay> <PhotoOverlay> ... </PhotoOverlay> ... </Document> </kml>