How to configure OrientDB to manage geospatial data, implement a Node.js importer and an Angular2+GoogleMaps frontend

1. Geospatial Graphs made easy
with

2. #OrientDB - @ldellaquila
Luigi Dell’Aquila
Core Developer and Director of Consulting
OrientDB LTD
Twitter: @ldellaquila
http://www.orientdb.com

3. #OrientDB - @ldellaquila
Summary
• Getting started with OrientDB
• OrientDB GeoSpatial API
• Importing Geo data (Node.js)
• Querying Geo data (OrientDB Studio)
• Displaying Geo data (Angular2, Google Maps)
• Adding Relationships - graph data
• Graph + Spatial queries

4. #OrientDB - @ldellaquila
What is OrientDB
• Multi-Model Database (Document, Graph and more)
• Tables Classes
• Extended SQL
• JOIN Physical Pointers
• Schema, No-Schema, Hybrid
• HTTP + Binary protocols
• Stand-alone or Embedded
• Distributed Multi-Master
• Apache 2 license

5. #OrientDB - @ldellaquila
Install
• http://www.orientdb.com/download/
• http://central.maven.org/maven2/com/orientechnologies/
orientdb-spatial/VERSION/orientdb-spatial-VERSION-dist.jar
> cd orientdb-community/bin/
> ./server.sh

6. #OrientDB - @ldellaquila
OrientDB GeoSpatial Classes
• OPoint
• OLine
• OPolygon
• OMultiPoint
• OMultiline
• OMultiPlygon

7. #OrientDB - @ldellaquila
OrientDB GeoSpatial Functions
• ST_GeomFromText(text)
• ST_Equals(geom, geom)
• ST_Contains(geom, geom)
• ST_Disjoint(geom, geom)
• ST_Intersects(geom, geom)
• ST_Distance_Sphere(geom, geom)
• and more…

8. #OrientDB - @ldellaquila
Our goal

9. #OrientDB - @ldellaquila
Our Data Model
CREATE CLASS POI EXTENDS V
CREATE PROPERTY POI.location EMBEDDED OPoint
CREATE INDEX POI.location on POI(location) SPATIAL ENGINE LUCENE
CREATE CLASS Natural EXTENDS V
CREATE PROPERTY Natural.location EMBEDDED OPolygon
CREATE INDEX Natural.location on Natural(location) SPATIAL ENGINE LUCENE
CREATE CLASS Person EXTENDS V
CREATE PROPERTY Person.location EMBEDDED OPoint
CREATE CLASS FriendOf EXTENDS E

10. #OrientDB - @ldellaquila
Now let’s import data!
> npm init
> npm install orientjs
> npm install fast-csv
> touch index.js
import files
http://www.mapcruzin.com/free-poland-maps.htm
(convert to WKT using QGis)

11. #OrientDB - @ldellaquila
Dependencies
var fs = require("fs")
var ODatabase = require("orientjs").ODatabase
var csv = require("fast-csv")

12. #OrientDB - @ldellaquila
Read from CSV
var stream = fs.createReadStream("data/poland-poi.csv");
var csvStream = csv.parse({headers: true})
.on("data", function(data){
console.log(data)
})
.on("end", function(){
console.log("Done!")
});
stream.pipe(csvStream);

13. #OrientDB - @ldellaquila
DB connection
var db = new ODatabase({
host: "localhost",
port: 2424,
username: "admin",
password: "admin",
name: "geo"
})
db.open().then(function(){
}

14. #OrientDB - @ldellaquila
Insert
var insertElement = function(data){
db.insert().into(className).set(
{
name: data.name,
type: data.type,
location: db.rawExpression("ST_GeomFromText('"+data.WKT+"')")
}
).one().then(function(){})
}

15. #OrientDB - @ldellaquila
Is it done?
Not yet :-(
Node.js… asynchronous… promises…
Final version:
https://github.com/luigidellaquila/wkt-to-orient

16. #OrientDB - @ldellaquila
Querying geo data
We are here:
(52.231807953759706, 21.013154983520508)
(lat, lon)

17. #OrientDB - @ldellaquila
Front-End!

18. #OrientDB - @ldellaquila
Clone the scaffolding
> git clone https://github.com/luigidellaquila/geospatial-demo
> git checkout warsaw_demo_step0
> cd geospatial-demo
> npm install
(it’s a clone of https://github.com/angular/quickstart)
> npm start

19. #OrientDB - @ldellaquila
Clone the scaffolding
> git clone https://github.com/luigidellaquila/geospatial-demo
> git checkout warsaw_demo_step0
> cd geospatial-demo
> npm install
(it’s a clone of https://github.com/angular/quickstart)
> npm start
> cd <orientdb-home>/www
> ln -s <quickstart-path>
> tsc -w

20. #OrientDB - @ldellaquila
We need Google Maps
<script src=“https://maps.googleapis.com/maps/api/js?key=API_KEY"
async defer></script>

21. #OrientDB - @ldellaquila
Let’s display a map (app.html)
<div class=“container">
<div class="row">
<div class="col-md-12" id="map" style=“height:600px"></div>
</div>
</div>

22. #OrientDB - @ldellaquila
Draw the map
drawMap(){
var controller = this;
let mapProp = {
center: new google.maps.LatLng(52.231807953759706, 21.013154983520508),
zoom: 16,
mapTypeId: google.maps.MapTypeId.ROADMAP
};
controller.map = new google.maps.Map(document.getElementById("map"), mapProp);
controller.map.addListener("click", function(point: any){
controller.zone.run(()=> {
controller.lat = point.latLng.lat();
controller.lon = point.latLng.lng();
});
});
}

23. #OrientDB - @ldellaquila
Create a Person
createPerson(): void{
var location = {
// the location object
}
var queryString = ””; // OrientDB statement
this.orient.command(
queryString,
(result) => { /* Success callback */ },
(error) => { /* Error callback */ }
);
}

24. #OrientDB - @ldellaquila
Create a Person
createPerson(): void{
var location = {
"@class": "OPoint",
coordinates: [this.lon, this.lat]
}
var queryString = ””; // OrientDB statement
this.orient.command(
queryString,
(result) => { /* Success callback */ },
(error) => { /* Error callback */ }
);}

25. #OrientDB - @ldellaquila
Create a Person
createPerson(): void{
var location = {
"@class": "OPoint",
coordinates: [this.lon, this.lat]
}
var queryString = `insert into Person
set name = '${this.personName}',
location = ${JSON.stringify(location)}`;
this.orient.command(
queryString,
(result) => { /* Success callback */ },
(error) => { /* Error callback */ }
);
}

26. #OrientDB - @ldellaquila
Create a Person
createPerson(): void{
var location = {
"@class": "OPoint",
coordinates: [this.lon, this.lat]
}
var queryString = `insert into Person
set name = '${this.personName}',
location = ${JSON.stringify(location)}`;
this.orient.command(
queryString,
(res) => {
let body = res.json();
let person = body.result[0];
this.addPersonToMap(person)
},
(e) => { console.log(e) });
}

27. #OrientDB - @ldellaquila
Add Person Vertex to Orient via REST API
command(statement: string, success: (data: any) => void, error: (err: any) => void): void{
var url = this.url + "sql/-/-1"
var headers = new Headers();
headers.append("Authorization", "Basic " + btoa(this.username+":"+this.password));
this.http.post( // HTTP POST
url, // the URL
JSON.stringify({
"command": statement // the SQL command
}),
{headers: headers} // the authentication data
).toPromise()
.then(success)
.catch(error);
}

28. #OrientDB - @ldellaquila
Add Person to the Map
addPersonToMap(personData:any){
let location = personData.location;
let coordinates = location.coordinates;
let controller = this;
let marker = new google.maps.Marker({
position: {lat:coordinates[1], lng:coordinates[0]},
map: this.map,
title: personData.name,
rid: personData["@rid"]
});
google.maps.event.addListener(marker, 'click', function() {
controller.onMarkerClick(marker);
});
}

29. #OrientDB - @ldellaquila
Add an edge between people
(FriendOf)
createEdge(from:any, to:any): void{
this.orient.command(
`create edge FriendOf from ${from.rid} to ${to.rid}`,
(x)=>{console.log(x)},
(x)=>{console.log(x)}
)
this.addEdgeBetweenMarkersToMap(from, to);
}

30. #OrientDB - @ldellaquila
Query the
Geospatial Graph
(DEMO)

31. #OrientDB - @ldellaquila
Thank you!