http://gis.inf.elte.hu/giswiki/api.php?action=feedcontributions&feedformat=atom&user=Laczk%C3%B3+D%C3%B3raGIS Wiki - Szerkesztő közreműködései [hu]2026-05-09T17:59:04ZSzerkesztő közreműködéseiMediaWiki 1.31.7http://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=554Spatial4J2017-05-16T11:44:54Z<p>Laczkó Dóra: </p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár ([http://www.apache.org/licenses/LICENSE-2.0.html ASL] license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása [http://geojson.org/ '''GeoJSON'''] és [https://en.wikipedia.org/wiki/Well-known_text '''WKT'''](Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket <code>SpatialContext</code> osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre ''SpatialContext'' példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a <code>SpatialContextFactory</code> segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy <code>.property</code> fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk. Ezt a <code>SpatialContextFactory</code> osztály statikus metódusával tehetjük meg:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor az első két módon lehetőség van a JTS-re épülő megfelelőket használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
A konstruktorok használata nincs megtiltva, azonban mégsem ajánlott, kivéve a <code>SpatialContextFactory</code> esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a ''SpatialContext'' példányokon keresztül érhetőek el.<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont (DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
A Spatial4J-ben használható alakzatok: Point, Code, Rectangle, LineString, Polygon, ShapeCollection. Alakzatokat a <code>ShapeFactory</code> segítségével tudunk létrehozni:<br />
<br />
<syntaxhighlight lang="java"><br />
<br />
JtsSpatialContext ctx= JtsSpatialContext.GEO;<br />
<br />
Point point = ctx.getShapeFactory().pointXY(10,10);<br />
<br />
Circle circle = ctx.getShapeFactory().circle(point, 15); // vagy .circle(10,10,0)<br />
<br />
Rectangle r = ctx.getShapeFactory().rectangle(point1, point2); //vagy .rectangle(0,0,10,10)<br />
<br />
Shape lineString = ctx.getShapeFactory().lineString()<br />
.pointXY(0,1)<br />
.pointXY(2,3)<br />
.build();<br />
<br />
Shape shapeCollection = ctx.getShapeFactory().multiShape(Shape.class)<br />
.add(p)<br />
.add(circle)<br />
.build();<br />
<br />
Shape polygon = globalContext.getShapeFactory().polygon()<br />
.pointXY(0,0)<br />
.pointXY(2,3)<br />
.pointXY(10,5)<br />
.build();<br />
<br />
</syntaxhighlight><br />
<br />
====Terület és távolság számítás====<br />
<br />
==Alakzatok írása/olvasása szöveges formátumokból==<br />
<br />
A Spatial4j segítségével nagyon egyszerűen lehet szöveges formátumokból beolvasni, illetve a különböző alakzatokat ilyen formátumokba kiírni.<br />
Az olvasáshoz egy <code>ShapeReader</code> interface-t megvalósító osztály egy példányára lesz szükségünk. Ilyen osztályok, a <code>GeoJSONReader</code>, <code>WKTReader</code> és <code>PolyshapeReader</code>, amik rendre GeoJSON, WKT és Polyshape formátumok olvasására alkalmasa. Az írás hasonlóan működik, ekkor a <code>ShapeWriter</code> interface példányaira van szükség.<br />
<br />
A beolvasott adatokból a megfelelő <code>Shape</code> objektumok állnak elő. Íráskor pedig a különböző alakzatainkat tudjuk adott formátumban kiírni.<br />
<br />
Az olvasást a <code>ShapeReader</code> által adott ''read'' művelettel tudjuk megtenni, aminek vagy egy <code>Obejct</code> vagy egy <code>Reader</code> (java.io.Reader) típusú paramétert vár.<br />
<br />
<br />
<code>ShapeReader</code> objektumokat kétféleképpen érjük el a ''SpatialContextből''<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeReader shapeReader1 = ctx.getFormats().getReader(ShapeIO.GeoJSON);<br />
<br />
ShapeReader shapeReader2 = ctx.getFormats().getGeoJsonReader();<br />
</syntaxhighlight><br />
<br />
Illetve ha írni szeretnénk, akkor hasonlóan jutunk egy <code>ShapeWriter</code> objektumhoz:<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeWriter shapeWriter1= ctx.getFormats().getWriter(ShapeIO.GeoJSON);<br />
<br />
ShapeWriter shapeWriter2 = ctx.getFormats().getGeoJsonWriter();<br />
</syntaxhighlight><br />
<br />
====Példa egy WKT formátumú fájl beolvasására ====<br />
A fájl tartalma például legyen a következő:<br />
<syntaxhighlight lang="wkt"><br />
POINT (19.797752 47.171645)<br />
</syntaxhighlight><br />
<br />
A beolvasás pedig így működik:<br />
<syntaxhighlight lang="java"><br />
<br />
try(FileReader reader = new FileReader(path)){<br />
<br />
SpatialContext ctx = SpatialContext.GEO;<br />
ShapeReader shapeReader = ctx.getFormats().getWktReader();<br />
Shape shape = shapeReader.read(reader);<br />
/*<br />
Ha kiíratjuk, látszik, hogy a beolvasott alakzatunk egy pont:<br />
System.out.println(shape);<br />
Pt(x=19.797752,y=47.171645)<br />
*/<br />
}catch (Exception ex){<br />
//handle<br />
}<br />
<br />
</syntaxhighlight><br />
<br />
====Példa egy alakzat kiírására GeoJSONben====<br />
<syntaxhighlight lang="java"><br />
<br />
SpatialContext ctx = SpatiaContext.GEO;<br />
ShapeWriter shapeWriter = ctx.getFormats().getGeoJsonWriter();<br />
<br />
Point point = ctx.getShapeFactory().pointXY(18.967123,47.643696);<br />
<br />
try(FileWriter writer = new FileWriter("path")) {<br />
<br />
shapeWriter.write(writer, shape);<br />
<br />
} catch (IOException e) {<br />
// handle exception <br />
}<br />
</syntaxhighlight><br />
<br />
Ezek után a fájlunk tartalma a következő kell legyen:<br />
<syntaxhighlight lang="json"><br />
{"type":"Point","coordinates":[18.967123,47.643696]}<br />
</syntaxhighlight><br />
<br />
==Geohash==<br />
<br />
<br />
<code>GeohashUtils</code> osztály segítségével lehetőségünk van koordináták geohashbe kódolására, valamint geohashből is dekódolhatunk koordinátákat.<br />
<br />
A geohash lényege, hogy a Földön található koordinátákat egy rövidebb alakba kódolja. Célja, hogy egy olyan karakter sort kapunk, amivel egyértelműen és kényelmesebben hivatkozhatunk a koordinátákra. Bővebben lásd: [https://en.wikipedia.org/wiki/Geohash Geohash Wikipedia]<br />
<br />
<syntaxhighlight lang="java"><br />
GeohashUtils.encodeLatLon(47.64369627,18.96712353); //u2mrp972wh8q<br />
GeohashUtils.decode("u2mrp972wh8q"); //Pt(x=18.9671235345304,y=47.64369626529515)<br />
GeohasUtils.decodeBoundary("u2mrp972wh8q"); //Rect(minX=18.967123366892338,maxX=18.967123702168465,minY=47.643696181476116,maxY=47.64369634911418)<br />
</syntaxhighlight></div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=553Spatial4J2017-05-16T11:19:06Z<p>Laczkó Dóra: /* Alapok */</p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása [http://geojson.org/ '''GeoJSON'''] és [https://en.wikipedia.org/wiki/Well-known_text '''WKT'''](Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket <code>SpatialContext</code> osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre ''SpatialContext'' példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a <code>SpatialContextFactory</code> segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy <code>.property</code> fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk. Ezt a <code>SpatialContextFactory</code> osztály statikus metódusával tehetjük meg:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor az első két módon lehetőség van a JTS-re épülő megfelelőket használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
A konstruktorok használata nincs megtiltva, azonban mégsem ajánlott, kivéve a <code>SpatialContextFactory</code> esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a ''SpatialContext'' példányokon keresztül érhetőek el.<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont (DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
A Spatial4J-ben használható alakzatok: Point, Code, Rectangle, LineString, Polygon, ShapeCollection. Alakzatokat a <code>ShapeFactory</code> segítségével tudunk létrehozni:<br />
<br />
<syntaxhighlight lang="java"><br />
<br />
JtsSpatialContext ctx= JtsSpatialContext.GEO;<br />
<br />
Point point = ctx.getShapeFactory().pointXY(10,10);<br />
<br />
Circle circle = ctx.getShapeFactory().circle(point, 15); // vagy .circle(10,10,0)<br />
<br />
Rectangle r = ctx.getShapeFactory().rectangle(point1, point2); //vagy .rectangle(0,0,10,10)<br />
<br />
Shape lineString = ctx.getShapeFactory().lineString()<br />
.pointXY(0,1)<br />
.pointXY(2,3)<br />
.build();<br />
<br />
Shape shapeCollection = ctx.getShapeFactory().multiShape(Shape.class)<br />
.add(p)<br />
.add(circle)<br />
.build();<br />
<br />
Shape polygon = globalContext.getShapeFactory().polygon()<br />
.pointXY(0,0)<br />
.pointXY(2,3)<br />
.pointXY(10,5)<br />
.build();<br />
<br />
</syntaxhighlight><br />
<br />
====Terület és távolság számítás====<br />
<br />
==Alakzatok írása/olvasása szöveges formátumokból==<br />
<br />
A Spatial4j segítségével nagyon egyszerűen lehet szöveges formátumokból beolvasni, illetve a különböző alakzatokat ilyen formátumokba kiírni.<br />
Az olvasáshoz egy <code>ShapeReader</code> interface-t megvalósító osztály egy példányára lesz szükségünk. Ilyen osztályok, a <code>GeoJSONReader</code>, <code>WKTReader</code> és <code>PolyshapeReader</code>, amik rendre GeoJSON, WKT és Polyshape formátumok olvasására alkalmasa. Az írás hasonlóan működik, ekkor a <code>ShapeWriter</code> interface példányaira van szükség.<br />
<br />
A beolvasott adatokból a megfelelő <code>Shape</code> objektumok állnak elő. Íráskor pedig a különböző alakzatainkat tudjuk adott formátumban kiírni.<br />
<br />
Az olvasást a <code>ShapeReader</code> által adott ''read'' művelettel tudjuk megtenni, aminek vagy egy <code>Obejct</code> vagy egy <code>Reader</code> (java.io.Reader) típusú paramétert vár.<br />
<br />
<br />
<code>ShapeReader</code> objektumokat kétféleképpen érjük el a ''SpatialContextből''<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeReader shapeReader1 = ctx.getFormats().getReader(ShapeIO.GeoJSON);<br />
<br />
ShapeReader shapeReader2 = ctx.getFormats().getGeoJsonReader();<br />
</syntaxhighlight><br />
<br />
Illetve ha írni szeretnénk, akkor hasonlóan jutunk egy <code>ShapeWriter</code> objektumhoz:<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeWriter shapeWriter1= ctx.getFormats().getWriter(ShapeIO.GeoJSON);<br />
<br />
ShapeWriter shapeWriter2 = ctx.getFormats().getGeoJsonWriter();<br />
</syntaxhighlight><br />
<br />
====Példa egy WKT formátumú fájl beolvasására ====<br />
A fájl tartalma például legyen a következő:<br />
<syntaxhighlight lang="wkt"><br />
POINT (19.797752 47.171645)<br />
</syntaxhighlight><br />
<br />
A beolvasás pedig így működik:<br />
<syntaxhighlight lang="java"><br />
<br />
try(FileReader reader = new FileReader(path)){<br />
<br />
SpatialContext ctx = SpatialContext.GEO;<br />
ShapeReader shapeReader = ctx.getFormats().getWktReader();<br />
Shape shape = shapeReader.read(reader);<br />
/*<br />
Ha kiíratjuk, látszik, hogy a beolvasott alakzatunk egy pont:<br />
System.out.println(shape);<br />
Pt(x=19.797752,y=47.171645)<br />
*/<br />
}catch (Exception ex){<br />
//handle<br />
}<br />
<br />
</syntaxhighlight><br />
<br />
====Példa egy alakzat kiírására GeoJSONben====<br />
<syntaxhighlight lang="java"><br />
<br />
SpatialContext ctx = SpatiaContext.GEO;<br />
ShapeWriter shapeWriter = ctx.getFormats().getGeoJsonWriter();<br />
<br />
Point point = ctx.getShapeFactory().pointXY(18.967123,47.643696);<br />
<br />
try(FileWriter writer = new FileWriter("path")) {<br />
<br />
shapeWriter.write(writer, shape);<br />
<br />
} catch (IOException e) {<br />
// handle exception <br />
}<br />
</syntaxhighlight><br />
<br />
Ezek után a fájlunk tartalma a következő kell legyen:<br />
<syntaxhighlight lang="json"><br />
{"type":"Point","coordinates":[18.967123,47.643696]}<br />
</syntaxhighlight><br />
<br />
==Geohash==<br />
<br />
<br />
<code>GeohashUtils</code> osztály segítségével lehetőségünk van koordináták geohashbe kódolására, valamint geohashből is dekódolhatunk koordinátákat.<br />
<br />
A geohash lényege, hogy a Földön található koordinátákat egy rövidebb alakba kódolja. Célja, hogy egy olyan karakter sort kapunk, amivel egyértelműen és kényelmesebben hivatkozhatunk a koordinátákra. Bővebben lásd: [https://en.wikipedia.org/wiki/Geohash Geohash Wikipedia]<br />
<br />
<syntaxhighlight lang="java"><br />
GeohashUtils.encodeLatLon(47.64369627,18.96712353); //u2mrp972wh8q<br />
GeohashUtils.decode("u2mrp972wh8q"); //Pt(x=18.9671235345304,y=47.64369626529515)<br />
GeohasUtils.decodeBoundary("u2mrp972wh8q"); //Rect(minX=18.967123366892338,maxX=18.967123702168465,minY=47.643696181476116,maxY=47.64369634911418)<br />
</syntaxhighlight></div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=542Spatial4J2017-05-15T19:54:46Z<p>Laczkó Dóra: /* Alakzatok */</p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása [http://geojson.org/ '''GeoJSON'''] és [https://en.wikipedia.org/wiki/Well-known_text '''WKT'''](Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket <code>SpatialContext</code> osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre ''SpatialContext'' példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a <code>SpatialContextFactory</code> segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy <code>.property</code> fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk. Ezt a <code>SpatialContextFactory</code> osztály statikus metódusával tehetjük meg:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor az első két módon lehetőség van a JTS-re épülő megfelelőket használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
Habár a konstruktorok használata nincs megtiltva, azok használata általában mégsem ajánlott, kivéve a <code>SpatialContextFactory</code> esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a ''SpatialContext'' példányokon keresztül érhetőek el.<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont (DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
A Spatial4J-ben használható alakzatok: Point, Code, Rectangle, LineString, Polygon, ShapeCollection. Alakzatokat a <code>ShapeFactory</code> segítségével tudunk létrehozni:<br />
<br />
<syntaxhighlight lang="java"><br />
<br />
JtsSpatialContext ctx= JtsSpatialContext.GEO;<br />
<br />
Point point = ctx.getShapeFactory().pointXY(10,10);<br />
<br />
Circle circle = ctx.getShapeFactory().circle(point, 15); // vagy .circle(10,10,0)<br />
<br />
Rectangle r = ctx.getShapeFactory().rectangle(point1, point2); //vagy .rectangle(0,0,10,10)<br />
<br />
Shape lineString = ctx.getShapeFactory().lineString()<br />
.pointXY(0,1)<br />
.pointXY(2,3)<br />
.build();<br />
<br />
Shape shapeCollection = ctx.getShapeFactory().multiShape(Shape.class)<br />
.add(p)<br />
.add(circle)<br />
.build();<br />
<br />
Shape polygon = globalContext.getShapeFactory().polygon()<br />
.pointXY(0,0)<br />
.pointXY(2,3)<br />
.pointXY(10,5)<br />
.build();<br />
<br />
</syntaxhighlight><br />
<br />
====Terület és távolság számítás====<br />
<br />
==Alakzatok írása/olvasása szöveges formátumokból==<br />
<br />
A Spatial4j segítségével nagyon egyszerűen lehet szöveges formátumokból beolvasni, illetve a különböző alakzatokat ilyen formátumokba kiírni.<br />
Az olvasáshoz egy <code>ShapeReader</code> interface-t megvalósító osztály egy példányára lesz szükségünk. Ilyen osztályok, a <code>GeoJSONReader</code>, <code>WKTReader</code> és <code>PolyshapeReader</code>, amik rendre GeoJSON, WKT és Polyshape formátumok olvasására alkalmasa. Az írás hasonlóan működik, ekkor a <code>ShapeWriter</code> interface példányaira van szükség.<br />
<br />
A beolvasott adatokból a megfelelő <code>Shape</code> objektumok állnak elő. Íráskor pedig a különböző alakzatainkat tudjuk adott formátumban kiírni.<br />
<br />
Az olvasást a <code>ShapeReader</code> által adott ''read'' művelettel tudjuk megtenni, aminek vagy egy <code>Obejct</code> vagy egy <code>Reader</code> (java.io.Reader) típusú paramétert vár.<br />
<br />
<br />
<code>ShapeReader</code> objektumokat kétféleképpen érjük el a ''SpatialContextből''<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeReader shapeReader1 = ctx.getFormats().getReader(ShapeIO.GeoJSON);<br />
<br />
ShapeReader shapeReader2 = ctx.getFormats().getGeoJsonReader();<br />
</syntaxhighlight><br />
<br />
Illetve ha írni szeretnénk, akkor hasonlóan jutunk egy <code>ShapeWriter</code> objektumhoz:<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeWriter shapeWriter1= ctx.getFormats().getWriter(ShapeIO.GeoJSON);<br />
<br />
ShapeWriter shapeWriter2 = ctx.getFormats().getGeoJsonWriter();<br />
</syntaxhighlight><br />
<br />
====Példa egy WKT formátumú fájl beolvasására ====<br />
A fájl tartalma például legyen a következő:<br />
<syntaxhighlight lang="wkt"><br />
POINT (19.797752 47.171645)<br />
</syntaxhighlight><br />
<br />
A beolvasás pedig így működik:<br />
<syntaxhighlight lang="java"><br />
<br />
try(FileReader reader = new FileReader(path)){<br />
<br />
SpatialContext ctx = SpatialContext.GEO;<br />
ShapeReader shapeReader = ctx.getFormats().getWktReader();<br />
Shape shape = shapeReader.read(reader);<br />
/*<br />
Ha kiíratjuk, látszik, hogy a beolvasott alakzatunk egy pont:<br />
System.out.println(shape);<br />
Pt(x=19.797752,y=47.171645)<br />
*/<br />
}catch (Exception ex){<br />
//handle<br />
}<br />
<br />
</syntaxhighlight><br />
<br />
====Példa egy alakzat kiírására GeoJSONben====<br />
<syntaxhighlight lang="java"><br />
<br />
SpatialContext ctx = SpatiaContext.GEO;<br />
ShapeWriter shapeWriter = ctx.getFormats().getGeoJsonWriter();<br />
<br />
Point point = ctx.getShapeFactory().pointXY(18.967123,47.643696);<br />
<br />
try(FileWriter writer = new FileWriter("path")) {<br />
<br />
shapeWriter.write(writer, shape);<br />
<br />
} catch (IOException e) {<br />
// handle exception <br />
}<br />
</syntaxhighlight><br />
<br />
Ezek után a fájlunk tartalma a következő kell legyen:<br />
<syntaxhighlight lang="json"><br />
{"type":"Point","coordinates":[18.967123,47.643696]}<br />
</syntaxhighlight><br />
<br />
==Geohash==<br />
<br />
<br />
<code>GeohashUtils</code> osztály segítségével lehetőségünk van koordináták geohashbe kódolására, valamint geohashből is dekódolhatunk koordinátákat.<br />
<br />
A geohash lényege, hogy a Földön található koordinátákat egy rövidebb alakba kódolja. Célja, hogy egy olyan karakter sort kapunk, amivel egyértelműen és kényelmesebben hivatkozhatunk a koordinátákra. Bővebben lásd: [https://en.wikipedia.org/wiki/Geohash Geohash Wikipedia]<br />
<br />
<syntaxhighlight lang="java"><br />
GeohashUtils.encodeLatLon(47.64369627,18.96712353); //u2mrp972wh8q<br />
GeohashUtils.decode("u2mrp972wh8q"); //Pt(x=18.9671235345304,y=47.64369626529515)<br />
GeohasUtils.decodeBoundary("u2mrp972wh8q"); //Rect(minX=18.967123366892338,maxX=18.967123702168465,minY=47.643696181476116,maxY=47.64369634911418)<br />
</syntaxhighlight></div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=541Spatial4J2017-05-15T19:51:26Z<p>Laczkó Dóra: /* Geohash */</p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása [http://geojson.org/ '''GeoJSON'''] és [https://en.wikipedia.org/wiki/Well-known_text '''WKT'''](Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket <code>SpatialContext</code> osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre ''SpatialContext'' példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a <code>SpatialContextFactory</code> segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy <code>.property</code> fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk. Ezt a <code>SpatialContextFactory</code> osztály statikus metódusával tehetjük meg:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor az első két módon lehetőség van a JTS-re épülő megfelelőket használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
Habár a konstruktorok használata nincs megtiltva, azok használata általában mégsem ajánlott, kivéve a <code>SpatialContextFactory</code> esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a ''SpatialContext'' példányokon keresztül érhetőek el.<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont (DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
A Spatial4J-ben használható alakzatok: Point, Code, Rectangle, LineString, Polygon, ShapeCollection. Alakzatokat a <code>ShapeFactory</code> segítségével tudunk létrehozni:<br />
<br />
<syntaxhighlight lang="java"><br />
<br />
JtsSpatialContext ctx= JtsSpatialContext.GEO;<br />
<br />
Point point = ctx.getShapeFactory().pointXY(10,10);<br />
<br />
Circle circle = ctx.getShapeFactory().circle(point, 15); // vagy .circle(10,10,0)<br />
<br />
Rectangle r = ctx.getShapeFactory().rectangle(point1, point2); //vagy .rectangle(0,0,10,10)<br />
<br />
Shape lineString = ctx.getShapeFactory().lineString()<br />
.pointXY(0,1)<br />
.pointXY(2,3)<br />
.build();<br />
<br />
Shape shapeCollection = ctx.getShapeFactory().multiShape(Shape.class)<br />
.add(p)<br />
.add(circle)<br />
.build();<br />
<br />
Shape polygon = globalContext.getShapeFactory().polygon()<br />
.pointXY(0,0)<br />
.pointXY(2,3)<br />
.pointXY(10,5)<br />
.build();<br />
<br />
</syntaxhighlight><br />
<br />
==Alakzatok írása/olvasása szöveges formátumokból==<br />
<br />
A Spatial4j segítségével nagyon egyszerűen lehet szöveges formátumokból beolvasni, illetve a különböző alakzatokat ilyen formátumokba kiírni.<br />
Az olvasáshoz egy <code>ShapeReader</code> interface-t megvalósító osztály egy példányára lesz szükségünk. Ilyen osztályok, a <code>GeoJSONReader</code>, <code>WKTReader</code> és <code>PolyshapeReader</code>, amik rendre GeoJSON, WKT és Polyshape formátumok olvasására alkalmasa. Az írás hasonlóan működik, ekkor a <code>ShapeWriter</code> interface példányaira van szükség.<br />
<br />
A beolvasott adatokból a megfelelő <code>Shape</code> objektumok állnak elő. Íráskor pedig a különböző alakzatainkat tudjuk adott formátumban kiírni.<br />
<br />
Az olvasást a <code>ShapeReader</code> által adott ''read'' művelettel tudjuk megtenni, aminek vagy egy <code>Obejct</code> vagy egy <code>Reader</code> (java.io.Reader) típusú paramétert vár.<br />
<br />
<br />
<code>ShapeReader</code> objektumokat kétféleképpen érjük el a ''SpatialContextből''<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeReader shapeReader1 = ctx.getFormats().getReader(ShapeIO.GeoJSON);<br />
<br />
ShapeReader shapeReader2 = ctx.getFormats().getGeoJsonReader();<br />
</syntaxhighlight><br />
<br />
Illetve ha írni szeretnénk, akkor hasonlóan jutunk egy <code>ShapeWriter</code> objektumhoz:<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeWriter shapeWriter1= ctx.getFormats().getWriter(ShapeIO.GeoJSON);<br />
<br />
ShapeWriter shapeWriter2 = ctx.getFormats().getGeoJsonWriter();<br />
</syntaxhighlight><br />
<br />
====Példa egy WKT formátumú fájl beolvasására ====<br />
A fájl tartalma például legyen a következő:<br />
<syntaxhighlight lang="wkt"><br />
POINT (19.797752 47.171645)<br />
</syntaxhighlight><br />
<br />
A beolvasás pedig így működik:<br />
<syntaxhighlight lang="java"><br />
<br />
try(FileReader reader = new FileReader(path)){<br />
<br />
SpatialContext ctx = SpatialContext.GEO;<br />
ShapeReader shapeReader = ctx.getFormats().getWktReader();<br />
Shape shape = shapeReader.read(reader);<br />
/*<br />
Ha kiíratjuk, látszik, hogy a beolvasott alakzatunk egy pont:<br />
System.out.println(shape);<br />
Pt(x=19.797752,y=47.171645)<br />
*/<br />
}catch (Exception ex){<br />
//handle<br />
}<br />
<br />
</syntaxhighlight><br />
<br />
====Példa egy alakzat kiírására GeoJSONben====<br />
<syntaxhighlight lang="java"><br />
<br />
SpatialContext ctx = SpatiaContext.GEO;<br />
ShapeWriter shapeWriter = ctx.getFormats().getGeoJsonWriter();<br />
<br />
Point point = ctx.getShapeFactory().pointXY(18.967123,47.643696);<br />
<br />
try(FileWriter writer = new FileWriter("path")) {<br />
<br />
shapeWriter.write(writer, shape);<br />
<br />
} catch (IOException e) {<br />
// handle exception <br />
}<br />
</syntaxhighlight><br />
<br />
Ezek után a fájlunk tartalma a következő kell legyen:<br />
<syntaxhighlight lang="json"><br />
{"type":"Point","coordinates":[18.967123,47.643696]}<br />
</syntaxhighlight><br />
<br />
==Geohash==<br />
<br />
<br />
<code>GeohashUtils</code> osztály segítségével lehetőségünk van koordináták geohashbe kódolására, valamint geohashből is dekódolhatunk koordinátákat.<br />
<br />
A geohash lényege, hogy a Földön található koordinátákat egy rövidebb alakba kódolja. Célja, hogy egy olyan karakter sort kapunk, amivel egyértelműen és kényelmesebben hivatkozhatunk a koordinátákra. Bővebben lásd: [https://en.wikipedia.org/wiki/Geohash Geohash Wikipedia]<br />
<br />
<syntaxhighlight lang="java"><br />
GeohashUtils.encodeLatLon(47.64369627,18.96712353); //u2mrp972wh8q<br />
GeohashUtils.decode("u2mrp972wh8q"); //Pt(x=18.9671235345304,y=47.64369626529515)<br />
GeohasUtils.decodeBoundary("u2mrp972wh8q"); //Rect(minX=18.967123366892338,maxX=18.967123702168465,minY=47.643696181476116,maxY=47.64369634911418)<br />
</syntaxhighlight></div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=539Spatial4J2017-05-15T19:44:45Z<p>Laczkó Dóra: </p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása [http://geojson.org/ '''GeoJSON'''] és [https://en.wikipedia.org/wiki/Well-known_text '''WKT'''](Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket <code>SpatialContext</code> osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre ''SpatialContext'' példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a <code>SpatialContextFactory</code> segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy <code>.property</code> fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk. Ezt a <code>SpatialContextFactory</code> osztály statikus metódusával tehetjük meg:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor az első két módon lehetőség van a JTS-re épülő megfelelőket használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
Habár a konstruktorok használata nincs megtiltva, azok használata általában mégsem ajánlott, kivéve a <code>SpatialContextFactory</code> esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a ''SpatialContext'' példányokon keresztül érhetőek el.<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont (DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
A Spatial4J-ben használható alakzatok: Point, Code, Rectangle, LineString, Polygon, ShapeCollection. Alakzatokat a <code>ShapeFactory</code> segítségével tudunk létrehozni:<br />
<br />
<syntaxhighlight lang="java"><br />
<br />
JtsSpatialContext ctx= JtsSpatialContext.GEO;<br />
<br />
Point point = ctx.getShapeFactory().pointXY(10,10);<br />
<br />
Circle circle = ctx.getShapeFactory().circle(point, 15); // vagy .circle(10,10,0)<br />
<br />
Rectangle r = ctx.getShapeFactory().rectangle(point1, point2); //vagy .rectangle(0,0,10,10)<br />
<br />
Shape lineString = ctx.getShapeFactory().lineString()<br />
.pointXY(0,1)<br />
.pointXY(2,3)<br />
.build();<br />
<br />
Shape shapeCollection = ctx.getShapeFactory().multiShape(Shape.class)<br />
.add(p)<br />
.add(circle)<br />
.build();<br />
<br />
Shape polygon = globalContext.getShapeFactory().polygon()<br />
.pointXY(0,0)<br />
.pointXY(2,3)<br />
.pointXY(10,5)<br />
.build();<br />
<br />
</syntaxhighlight><br />
<br />
==Alakzatok írása/olvasása szöveges formátumokból==<br />
<br />
A Spatial4j segítségével nagyon egyszerűen lehet szöveges formátumokból beolvasni, illetve a különböző alakzatokat ilyen formátumokba kiírni.<br />
Az olvasáshoz egy <code>ShapeReader</code> interface-t megvalósító osztály egy példányára lesz szükségünk. Ilyen osztályok, a <code>GeoJSONReader</code>, <code>WKTReader</code> és <code>PolyshapeReader</code>, amik rendre GeoJSON, WKT és Polyshape formátumok olvasására alkalmasa. Az írás hasonlóan működik, ekkor a <code>ShapeWriter</code> interface példányaira van szükség.<br />
<br />
A beolvasott adatokból a megfelelő <code>Shape</code> objektumok állnak elő. Íráskor pedig a különböző alakzatainkat tudjuk adott formátumban kiírni.<br />
<br />
Az olvasást a <code>ShapeReader</code> által adott ''read'' művelettel tudjuk megtenni, aminek vagy egy <code>Obejct</code> vagy egy <code>Reader</code> (java.io.Reader) típusú paramétert vár.<br />
<br />
<br />
<code>ShapeReader</code> objektumokat kétféleképpen érjük el a ''SpatialContextből''<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeReader shapeReader1 = ctx.getFormats().getReader(ShapeIO.GeoJSON);<br />
<br />
ShapeReader shapeReader2 = ctx.getFormats().getGeoJsonReader();<br />
</syntaxhighlight><br />
<br />
Illetve ha írni szeretnénk, akkor hasonlóan jutunk egy <code>ShapeWriter</code> objektumhoz:<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeWriter shapeWriter1= ctx.getFormats().getWriter(ShapeIO.GeoJSON);<br />
<br />
ShapeWriter shapeWriter2 = ctx.getFormats().getGeoJsonWriter();<br />
</syntaxhighlight><br />
<br />
====Példa egy WKT formátumú fájl beolvasására ====<br />
A fájl tartalma például legyen a következő:<br />
<syntaxhighlight lang="wkt"><br />
POINT (19.797752 47.171645)<br />
</syntaxhighlight><br />
<br />
A beolvasás pedig így működik:<br />
<syntaxhighlight lang="java"><br />
<br />
try(FileReader reader = new FileReader(path)){<br />
<br />
SpatialContext ctx = SpatialContext.GEO;<br />
ShapeReader shapeReader = ctx.getFormats().getWktReader();<br />
Shape shape = shapeReader.read(reader);<br />
/*<br />
Ha kiíratjuk, látszik, hogy a beolvasott alakzatunk egy pont:<br />
System.out.println(shape);<br />
Pt(x=19.797752,y=47.171645)<br />
*/<br />
}catch (Exception ex){<br />
//handle<br />
}<br />
<br />
</syntaxhighlight><br />
<br />
====Példa egy alakzat kiírására GeoJSONben====<br />
<syntaxhighlight lang="java"><br />
<br />
SpatialContext ctx = SpatiaContext.GEO;<br />
ShapeWriter shapeWriter = ctx.getFormats().getGeoJsonWriter();<br />
<br />
Point point = ctx.getShapeFactory().pointXY(18.967123,47.643696);<br />
<br />
try(FileWriter writer = new FileWriter("path")) {<br />
<br />
shapeWriter.write(writer, shape);<br />
<br />
} catch (IOException e) {<br />
// handle exception <br />
}<br />
</syntaxhighlight><br />
<br />
Ezek után a fájlunk tartalma a következő kell legyen:<br />
<syntaxhighlight lang="json"><br />
{"type":"Point","coordinates":[18.967123,47.643696]}<br />
</syntaxhighlight><br />
<br />
==Geohash==<br />
<code>GeohashUtils</code> osztály segítségével lehetőségünk van koordináták geohashbe kódolására, valamint geohashből is dekódolhatunk koordinátákat.<br />
<syntaxhighlight lang="java"><br />
GeohashUtils.encodeLatLon(47.64369627,18.96712353); //u2mrp972wh8q<br />
GeohashUtils.decodeLatLon("u2mrp972wh8q"); //Pt(x=18.9671235345304,y=47.64369626529515)<br />
</syntaxhiglight></div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=538Spatial4J2017-05-15T19:38:02Z<p>Laczkó Dóra: /* Alakzatok írása/olvasása szöveges formátumokból */</p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása [http://geojson.org/ '''GeoJSON'''] és [https://en.wikipedia.org/wiki/Well-known_text '''WKT'''](Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket <code>SpatialContext</code> osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre ''SpatialContext'' példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a <code>SpatialContextFactory</code> segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy <code>.property</code> fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk. Ezt a <code>SpatialContextFactory</code> osztály statikus metódusával tehetjük meg:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor az első két módon lehetőség van a JTS-re épülő megfelelőket használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
Habár a konstruktorok használata nincs megtiltva, azok használata általában mégsem ajánlott, kivéve a <code>SpatialContextFactory</code> esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a ''SpatialContext'' példányokon keresztül érhetőek el.<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont (DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
A Spatial4J-ben használható alakzatok: Point, Code, Rectangle, LineString, Polygon, ShapeCollection. Alakzatokat a <code>ShapeFactory</code> segítségével tudunk létrehozni:<br />
<br />
<syntaxhighlight lang="java"><br />
<br />
JtsSpatialContext ctx= JtsSpatialContext.GEO;<br />
<br />
Point point = ctx.getShapeFactory().pointXY(10,10);<br />
<br />
Circle circle = ctx.getShapeFactory().circle(point, 15); // vagy .circle(10,10,0)<br />
<br />
Rectangle r = ctx.getShapeFactory().rectangle(point1, point2); //vagy .rectangle(0,0,10,10)<br />
<br />
Shape lineString = ctx.getShapeFactory().lineString()<br />
.pointXY(0,1)<br />
.pointXY(2,3)<br />
.build();<br />
<br />
Shape shapeCollection = ctx.getShapeFactory().multiShape(Shape.class)<br />
.add(p)<br />
.add(circle)<br />
.build();<br />
<br />
Shape polygon = globalContext.getShapeFactory().polygon()<br />
.pointXY(0,0)<br />
.pointXY(2,3)<br />
.pointXY(10,5)<br />
.build();<br />
<br />
</syntaxhighlight><br />
<br />
==Alakzatok írása/olvasása szöveges formátumokból==<br />
<br />
A Spatial4j segítségével nagyon egyszerűen lehet szöveges formátumokból beolvasni, illetve a különböző alakzatokat ilyen formátumokba kiírni.<br />
Az olvasáshoz egy <code>ShapeReader</code> interface-t megvalósító osztály egy példányára lesz szükségünk. Ilyen osztályok, a <code>GeoJSONReader</code>, <code>WKTReader</code> és <code>PolyshapeReader</code>, amik rendre GeoJSON, WKT és Polyshape formátumok olvasására alkalmasa. Az írás hasonlóan működik, ekkor a <code>ShapeWriter</code> interface példányaira van szükség.<br />
<br />
A beolvasott adatokból a megfelelő <code>Shape</code> objektumok állnak elő. Íráskor pedig a különböző alakzatainkat tudjuk adott formátumban kiírni.<br />
<br />
Az olvasást a <code>ShapeReader</code> által adott ''read'' művelettel tudjuk megtenni, aminek vagy egy <code>Obejct</code> vagy egy <code>Reader</code> (java.io.Reader) típusú paramétert vár.<br />
<br />
<br />
<code>ShapeReader</code> objektumokat kétféleképpen érjük el a ''SpatialContextből''<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeReader shapeReader1 = ctx.getFormats().getReader(ShapeIO.GeoJSON);<br />
<br />
ShapeReader shapeReader2 = ctx.getFormats().getGeoJsonReader();<br />
</syntaxhighlight><br />
<br />
Illetve ha írni szeretnénk, akkor hasonlóan jutunk egy <code>ShapeWriter</code> objektumhoz:<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeWriter shapeWriter1= ctx.getFormats().getWriter(ShapeIO.GeoJSON);<br />
<br />
ShapeWriter shapeWriter2 = ctx.getFormats().getGeoJsonWriter();<br />
</syntaxhighlight><br />
<br />
====Példa egy WKT formátumú fájl beolvasására ====<br />
A fájl tartalma például legyen a következő:<br />
<syntaxhighlight lang="wkt"><br />
POINT (19.797752 47.171645)<br />
</syntaxhighlight><br />
<br />
A beolvasás pedig így működik:<br />
<syntaxhighlight lang="java"><br />
<br />
try(FileReader reader = new FileReader(path)){<br />
<br />
SpatialContext ctx = SpatialContext.GEO;<br />
ShapeReader shapeReader = ctx.getFormats().getWktReader();<br />
Shape shape = shapeReader.read(reader);<br />
/*<br />
Ha kiíratjuk, látszik, hogy a beolvasott alakzatunk egy pont:<br />
System.out.println(shape);<br />
Pt(x=19.797752,y=47.171645)<br />
*/<br />
}catch (Exception ex){<br />
//handle<br />
}<br />
<br />
</syntaxhighlight><br />
<br />
====Példa egy alakzat kiírására GeoJSONben====<br />
<syntaxhighlight lang="java"><br />
<br />
SpatialContext ctx = SpatiaContext.GEO;<br />
ShapeWriter shapeWriter = ctx.getFormats().getGeoJsonWriter();<br />
<br />
Point point = ctx.getShapeFactory().pointXY(18.967123,47.643696);<br />
<br />
try(FileWriter writer = new FileWriter("path")) {<br />
<br />
shapeWriter.write(writer, shape);<br />
<br />
} catch (IOException e) {<br />
// handle exception <br />
}<br />
</syntaxhighlight><br />
<br />
Ezek után a fájlunk tartalma a következő kell legyen:<br />
<syntaxhighlight lang="json"><br />
{"type":"Point","coordinates":[18.967123,47.643696]}<br />
</syntaxhighlight></div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=527Spatial4J2017-05-14T19:52:46Z<p>Laczkó Dóra: /* Alakzatok */</p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása [http://geojson.org/ '''GeoJSON'''] és [https://en.wikipedia.org/wiki/Well-known_text '''WKT'''](Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket <code>SpatialContext</code> osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre ''SpatialContext'' példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a <code>SpatialContextFactory</code> segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy <code>.property</code> fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk. Ezt a <code>SpatialContextFactory</code> osztály statikus metódusával tehetjük meg:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor az első két módon lehetőség van a JTS-re épülő megfelelőket használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
Habár a konstruktorok használata nincs megtiltva, azok használata általában mégsem ajánlott, kivéve a <code>SpatialContextFactory</code> esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a ''SpatialContext'' példányokon keresztül érhetőek el.<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont (DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
A Spatial4J-ben használható alakzatok: Point, Code, Rectangle, LineString, Polygon, ShapeCollection. Alakzatokat a <code>ShapeFactory</code> segítségével tudunk létrehozni:<br />
<br />
<syntaxhighlight lang="java"><br />
<br />
JtsSpatialContext ctx= JtsSpatialContext.GEO;<br />
<br />
Point point = ctx.getShapeFactory().pointXY(10,10);<br />
<br />
Circle circle = ctx.getShapeFactory().circle(point, 15); // vagy .circle(10,10,0)<br />
<br />
Rectangle r = ctx.getShapeFactory().rectangle(point1, point2); //vagy .rectangle(0,0,10,10)<br />
<br />
Shape lineString = ctx.getShapeFactory().lineString()<br />
.pointXY(0,1)<br />
.pointXY(2,3)<br />
.build();<br />
<br />
Shape shapeCollection = ctx.getShapeFactory().multiShape(Shape.class)<br />
.add(p)<br />
.add(circle)<br />
.build();<br />
<br />
Shape polygon = globalContext.getShapeFactory().polygon()<br />
.pointXY(0,0)<br />
.pointXY(2,3)<br />
.pointXY(10,5)<br />
.build();<br />
<br />
</syntaxhighlight><br />
<br />
==Alakzatok írása/olvasása szöveges formátumokból==<br />
<br />
A Spatial4j segítségével nagyon egyszerűen lehet szöveges formátumokból beolvasni, illetve a különböző alakzatokat ilyen formátumokba kiírni.<br />
Az olvasáshoz egy <code>ShapeReader</code> interface-t megvalósító osztály egy példányára lesz szükségünk. Ilyen osztályok, a <code>GeoJSONReader</code>, <code>WKTReader</code> és <code>PolyshapeReader</code>, amik rendre GeoJSON, WKT és Polyshape formátumok olvasására alkalmasa. Az írás hasonlóan működik, ekkor a <code>ShapeWriter</code> interface példányaira van szükség.<br />
<br />
A beolvasott adatokból a megfelelő <code>Shape</code> objektumok állnak elő. Íráskor pedig a különböző alakzatainkat tudjuk adott formátumban kiírni.<br />
<br />
Az olvasást a <code>ShapeReader</code> által adott ''read'' művelettel tudjuk megtenni, aminek vagy egy <code>Obejct</code> vagy egy <code>Reader</code> (java.io.Reader) típusú paramétert vár.<br />
<br />
<br />
<code>ShapeReader</code> objektumokat kétféleképpen érjük el a ''SpatialContextből''<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeReader shapeReader1 = ctx.getFormats().getReader(ShapeIO.GeoJSON);<br />
<br />
ShapeReader shapeReader2 = ctx.getFormats().getGeoJsonReader();<br />
</syntaxhighlight><br />
<br />
Illetve ha írni szeretnénk, akkor hasonlóan jutunk egy ShapeWriter objektumhoz:<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeWriter shapeWriter1= ctx.getFormats().getWriter(ShapeIO.GeoJSON);<br />
<br />
ShapeWriter shapeWriter2 = ctx.getFormats().getGeoJsonWriter();<br />
</syntaxhighlight><br />
<br />
====Példa egy WKT formátumú fájl beolvasására ====<br />
A fájl tartalma például legyen a következő:<br />
<syntaxhighlight lang="wkt"><br />
POINT (19.797752 47.171645)<br />
</syntaxhighlight><br />
<br />
A beolvasás pedig így működik:<br />
<syntaxhighlight lang="java"><br />
<br />
try(FileReader reader = new FileReader(path)){<br />
<br />
SpatialContext ctx = SpatialContext.GEO;<br />
ShapeReader shapeReader = ctx.getFormats().getWktReader();<br />
Shape shape = shapeReader.read(reader);<br />
/*<br />
Ha kiíratjuk, látszik, hogy a beolvasott alakzatunk egy pont:<br />
System.out.println(shape);<br />
Pt(x=19.797752,y=47.171645)<br />
*/<br />
}catch (Exception ex){<br />
//handle<br />
}<br />
<br />
</syntaxhighlight><br />
<br />
====Példa egy alakzat kiírására GeoJSONben====<br />
<syntaxhighlight lang="java"><br />
<br />
SpatialContext ctx = SpatiaContext.GEO;<br />
ShapeWriter shapeWriter = ctx.getFormats().getGeoJsonWriter();<br />
<br />
Point point = ctx.getShapeFactory().pointXY(18.967123,47.643696);<br />
<br />
try(FileWriter writer = new FileWriter("path")) {<br />
<br />
shapeWriter.write(writer, shape);<br />
<br />
} catch (IOException e) {<br />
// handle exception <br />
}<br />
</syntaxhighlight><br />
<br />
Ezek után a fájlunk tartalma a következő kell legyen:<br />
<syntaxhighlight lang="json"><br />
{"type":"Point","coordinates":[18.967123,47.643696]}<br />
</syntaxhighlight></div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=526Spatial4J2017-05-14T18:21:43Z<p>Laczkó Dóra: </p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása [http://geojson.org/ '''GeoJSON'''] és [https://en.wikipedia.org/wiki/Well-known_text '''WKT'''](Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket <code>SpatialContext</code> osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre ''SpatialContext'' példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a <code>SpatialContextFactory</code> segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy <code>.property</code> fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk. Ezt a <code>SpatialContextFactory</code> osztály statikus metódusával tehetjük meg:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor az első két módon lehetőség van a JTS-re épülő megfelelőket használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
Habár a konstruktorok használata nincs megtiltva, azok használata általában mégsem ajánlott, kivéve a <code>SpatialContextFactory</code> esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a ''SpatialContext'' példányokon keresztül érhetőek el.<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont (DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
A Spatial4J-ben használható alakzatok: Point, Code, Rectangle, LineString, Polygon, ShapeCollection. Alakzatokat a <code>ShapeFactory</code> segítségével tudunk létrehozni:<br />
<br />
<syntaxhighlight lang="java"><br />
Point point = ctx.getShapeFactory().pointXY(10,10);<br />
<br />
Circle circle = ctx.getShapeFactory().circle(point, 15); // vagy .circle(10,10,0)<br />
<br />
Rectangle r = ctx.getShapeFactory().rectangle(point1, point2); //vagy .rectangle(0,0,10,10)<br />
<br />
Shape lineString = ctx.getShapeFactory().lineString()<br />
.pointXY(0,1)<br />
.pointXY(2,3)<br />
.build();<br />
<br />
Shape shapeCollection = ctx.getShapeFactory().multiShape(Shape.class)<br />
.add(p)<br />
.add(circle)<br />
.build();<br />
<br />
Shape polygon = globalContext.getShapeFactory().polygon()<br />
.pointXY(0,0)<br />
.pointXY(2,3)<br />
.pointXY(10,5)<br />
.build();<br />
<br />
</syntaxhighlight><br />
<br />
==Alakzatok írása/olvasása szöveges formátumokból==<br />
<br />
A Spatial4j segítségével nagyon egyszerűen lehet szöveges formátumokból beolvasni, illetve a különböző alakzatokat ilyen formátumokba kiírni.<br />
Az olvasáshoz egy <code>ShapeReader</code> interface-t megvalósító osztály egy példányára lesz szükségünk. Ilyen osztályok, a <code>GeoJSONReader</code>, <code>WKTReader</code> és <code>PolyshapeReader</code>, amik rendre GeoJSON, WKT és Polyshape formátumok olvasására alkalmasa. Az írás hasonlóan működik, ekkor a <code>ShapeWriter</code> interface példányaira van szükség.<br />
<br />
A beolvasott adatokból a megfelelő <code>Shape</code> objektumok állnak elő. Íráskor pedig a különböző alakzatainkat tudjuk adott formátumban kiírni.<br />
<br />
Az olvasást a <code>ShapeReader</code> által adott ''read'' művelettel tudjuk megtenni, aminek vagy egy <code>Obejct</code> vagy egy <code>Reader</code> (java.io.Reader) típusú paramétert vár.<br />
<br />
<br />
<code>ShapeReader</code> objektumokat kétféleképpen érjük el a ''SpatialContextből''<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeReader shapeReader1 = ctx.getFormats().getReader(ShapeIO.GeoJSON);<br />
<br />
ShapeReader shapeReader2 = ctx.getFormats().getGeoJsonReader();<br />
</syntaxhighlight><br />
<br />
Illetve ha írni szeretnénk, akkor hasonlóan jutunk egy ShapeWriter objektumhoz:<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeWriter shapeWriter1= ctx.getFormats().getWriter(ShapeIO.GeoJSON);<br />
<br />
ShapeWriter shapeWriter2 = ctx.getFormats().getGeoJsonWriter();<br />
</syntaxhighlight><br />
<br />
====Példa egy WKT formátumú fájl beolvasására ====<br />
A fájl tartalma például legyen a következő:<br />
<syntaxhighlight lang="wkt"><br />
POINT (19.797752 47.171645)<br />
</syntaxhighlight><br />
<br />
A beolvasás pedig így működik:<br />
<syntaxhighlight lang="java"><br />
<br />
try(FileReader reader = new FileReader(path)){<br />
<br />
SpatialContext ctx = SpatialContext.GEO;<br />
ShapeReader shapeReader = ctx.getFormats().getWktReader();<br />
Shape shape = shapeReader.read(reader);<br />
/*<br />
Ha kiíratjuk, látszik, hogy a beolvasott alakzatunk egy pont:<br />
System.out.println(shape);<br />
Pt(x=19.797752,y=47.171645)<br />
*/<br />
}catch (Exception ex){<br />
//handle<br />
}<br />
<br />
</syntaxhighlight><br />
<br />
====Példa egy alakzat kiírására GeoJSONben====<br />
<syntaxhighlight lang="java"><br />
<br />
SpatialContext ctx = SpatiaContext.GEO;<br />
ShapeWriter shapeWriter = ctx.getFormats().getGeoJsonWriter();<br />
<br />
Point point = ctx.getShapeFactory().pointXY(18.967123,47.643696);<br />
<br />
try(FileWriter writer = new FileWriter("path")) {<br />
<br />
shapeWriter.write(writer, shape);<br />
<br />
} catch (IOException e) {<br />
// handle exception <br />
}<br />
</syntaxhighlight><br />
<br />
Ezek után a fájlunk tartalma a következő kell legyen:<br />
<syntaxhighlight lang="json"><br />
{"type":"Point","coordinates":[18.967123,47.643696]}<br />
</syntaxhighlight></div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=525Spatial4J2017-05-14T18:17:41Z<p>Laczkó Dóra: </p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása '''GeoJSON''' és '''WKT'''(Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket <code>SpatialContext</code> osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre ''SpatialContext'' példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a <code>SpatialContextFactory</code> segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy <code>.property</code> fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk. Ezt a <code>SpatialContextFactory</code> osztály statikus metódusával tehetjük meg:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor az első két módon lehetőség van a JTS-re épülő megfelelőket használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
Habár a konstruktorok használata nincs megtiltva, azok használata általában mégsem ajánlott, kivéve a <code>SpatialContextFactory</code> esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a ''SpatialContext'' példányokon keresztül érhetőek el.<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont (DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
A Spatial4J-ben használható alakzatok: Point, Code, Rectangle, LineString, Polygon, ShapeCollection. Alakzatokat a <code>ShapeFactory</code> segítségével tudunk létrehozni:<br />
<br />
<syntaxhighlight lang="java"><br />
Point point = ctx.getShapeFactory().pointXY(10,10);<br />
<br />
Circle circle = ctx.getShapeFactory().circle(point, 15); // vagy .circle(10,10,0)<br />
<br />
Rectangle r = ctx.getShapeFactory().rectangle(point1, point2); //vagy .rectangle(0,0,10,10)<br />
<br />
Shape lineString = ctx.getShapeFactory().lineString()<br />
.pointXY(0,1)<br />
.pointXY(2,3)<br />
.build();<br />
<br />
Shape shapeCollection = ctx.getShapeFactory().multiShape(Shape.class)<br />
.add(p)<br />
.add(circle)<br />
.build();<br />
<br />
Shape polygon = globalContext.getShapeFactory().polygon()<br />
.pointXY(0,0)<br />
.pointXY(2,3)<br />
.pointXY(10,5)<br />
.build();<br />
<br />
</syntaxhighlight><br />
<br />
==Alakzatok írása/olvasása szöveges formátumokból==<br />
<br />
A Spatial4j segítségével nagyon egyszerűen lehet szöveges formátumokból beolvasni, illetve a különböző alakzatokat ilyen formátumokba kiírni.<br />
Az olvasáshoz egy <code>ShapeReader</code> interface-t megvalósító osztály egy példányára lesz szükségünk. Ilyen osztályok, a <code>GeoJSONReader</code>, <code>WKTReader</code> és <code>PolyshapeReader</code>, amik rendre GeoJSON, WKT és Polyshape formátumok olvasására alkalmasa. Az írás hasonlóan működik, ekkor a <code>ShapeWriter</code> interface példányaira van szükség.<br />
<br />
A beolvasott adatokból a megfelelő <code>Shape</code> objektumok állnak elő. Íráskor pedig a különböző alakzatainkat tudjuk adott formátumban kiírni.<br />
<br />
Az olvasást a <code>ShapeReader</code> által adott ''read'' művelettel tudjuk megtenni, aminek vagy egy <code>Obejct</code> vagy egy <code>Reader</code> (java.io.Reader) típusú paramétert vár.<br />
<br />
<br />
<code>ShapeReader</code> objektumokat kétféleképpen érjük el a ''SpatialContextből''<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeReader shapeReader1 = ctx.getFormats().getReader(ShapeIO.GeoJSON);<br />
<br />
ShapeReader shapeReader2 = ctx.getFormats().getGeoJsonReader();<br />
</syntaxhighlight><br />
<br />
Illetve ha írni szeretnénk, akkor hasonlóan jutunk egy ShapeWriter objektumhoz:<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeWriter shapeWriter1= ctx.getFormats().getWriter(ShapeIO.GeoJSON);<br />
<br />
ShapeWriter shapeWriter2 = ctx.getFormats().getGeoJsonWriter();<br />
</syntaxhighlight><br />
<br />
====Példa egy WKT formátumú fájl beolvasására ====<br />
A fájl tartalma például legyen a következő:<br />
<syntaxhighlight lang="wkt"><br />
POINT (19.797752 47.171645)<br />
</syntaxhighlight><br />
<br />
A beolvasás pedig így működik:<br />
<syntaxhighlight lang="java"><br />
<br />
try(FileReader reader = new FileReader(path)){<br />
<br />
SpatialContext ctx = SpatialContext.GEO;<br />
ShapeReader shapeReader = ctx.getFormats().getWktReader();<br />
Shape shape = shapeReader.read(reader);<br />
/*<br />
Ha kiíratjuk, látszik, hogy a beolvasott alakzatunk egy pont:<br />
System.out.println(shape);<br />
Pt(x=19.797752,y=47.171645)<br />
*/<br />
}catch (Exception ex){<br />
//handle<br />
}<br />
<br />
</syntaxhighlight><br />
<br />
====Példa egy alakzat kiírására GEOJsonben====<br />
<syntaxhighlight lang="java"><br />
<br />
SpatialContext ctx = SpatiaContext.GEO;<br />
ShapeWriter shapeWriter = ctx.getFormats().getGeoJsonWriter();<br />
<br />
Point point = ctx.getShapeFactory().pointXY(18.967123,47.643696);<br />
<br />
try(FileWriter writer = new FileWriter("path")) {<br />
<br />
shapeWriter.write(writer, shape);<br />
<br />
} catch (IOException e) {<br />
// handle exception <br />
}<br />
</syntaxhighlight><br />
<br />
Ezek után a fájlunk tartalma a következő kell legyen:<br />
<syntaxhighlight lang="json"><br />
{"type":"Point","coordinates":[18.967123,47.643696]}<br />
</syntaxhighlight></div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=524Spatial4J2017-05-14T18:13:28Z<p>Laczkó Dóra: </p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása '''GeoJSON''' és '''WKT'''(Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket <code>SpatialContext</code> osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre ''SpatialContext'' példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a <code>SpatialContextFactory</code> segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy <code>.property</code> fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk. Ezt a <code>SpatialContextFactory</code> osztály statikus metódusával tehetjük meg:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor az első két módon lehetőség van a JTS-re épülő megfelelőket használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
Habár a konstruktorok használata nincs megtiltva, azok használata általában mégsem ajánlott, kivéve a <code>SpatialContextFactory</code> esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a ''SpatialContext'' példányokon keresztül érhetőek el.<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont (DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
A Spatial4J-ben használható alakzatok: Point, Code, Rectangle, LineString, Polygon, ShapeCollection. Alakzatokat a <code>ShapeFactory</code> segítségével tudunk létrehozni:<br />
<br />
<syntaxhighlight lang="java"><br />
Point point = ctx.getShapeFactory().pointXY(10,10);<br />
<br />
Circle circle = ctx.getShapeFactory().circle(point, 15); // vagy .circle(10,10,0)<br />
<br />
Rectangle r = ctx.getShapeFactory().rectangle(point1, point2); //vagy .rectangle(0,0,10,10)<br />
<br />
Shape lineString = ctx.getShapeFactory().lineString()<br />
.pointXY(0,1)<br />
.pointXY(2,3)<br />
.build();<br />
<br />
Shape shapeCollection = ctx.getShapeFactory().multiShape(Shape.class)<br />
.add(p)<br />
.add(circle)<br />
.build();<br />
<br />
Shape polygon = globalContext.getShapeFactory().polygon()<br />
.pointXY(0,0)<br />
.pointXY(2,3)<br />
.pointXY(10,5)<br />
.build();<br />
<br />
</syntaxhighlight><br />
<br />
==Alakzatok írása/olvasása szöveges formátumokból==<br />
<br />
A Spatial4j segítségével nagyon egyszerűen lehet szöveges formátumokból beolvasni, illetve a különböző alakzatokat ilyen formátumokba kiírni.<br />
Az olvasáshoz egy <code>ShapeReader</code> interface-t megvalósító osztály egy példányára lesz szükségünk. Ilyen osztályok, a <code>GeoJSONReader</code>, <code>WKTReader</code> és <code>PolyshapeReader</code>, amik rendre GeoJSON, WKT és Polyshape formátumok olvasására alkalmasa. Az írás hasonlóan működik, ekkor a <code>ShapeWriter</code> interface példányaira van szükség.<br />
<br />
A beolvasott adatokból a megfelelő <code>Shape</code> objektumok állnak elő. Íráskor pedig a különböző alakzatainkat tudjuk adott formátumban kiírni.<br />
<br />
Az olvasást a <code>ShapeReader</code> által adott ''read'' művelettel tudjuk megtenni, aminek vagy egy <code>Obejct</code> vagy egy <code>Reader</code> (java.io.Reader) típusú paramétert vár.<br />
<br />
<br />
<code>ShapeReader</code> objektumokat kétféleképpen érjük el a ''SpatialContextből''<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeReader shapeReader1 = ctx.getFormats().getReader(ShapeIO.GeoJSON);<br />
<br />
ShapeReader shapeReader2 = ctx.getFormats().getGeoJsonReader();<br />
</syntaxhighlight><br />
<br />
Illetve ha írni szeretnénk, akkor hasonlóan jutunk egy ShapeWriter objektumhoz:<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeWriter shapeWriter1= ctx.getFormats().getWriter(ShapeIO.GeoJSON);<br />
<br />
ShapeWriter shapeWriter2 = ctx.getFormats().getGeoJsonWriter();<br />
</syntaxhighlight><br />
<br />
====Példa egy WKT formátumú fájl beolvasására ====<br />
A fájl tartalma például legyen a következő:<br />
<syntaxhighlight lang="wkt"><br />
POINT (19.797752 47.171645)<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="java"><br />
<br />
try(FileReader reader = new FileReader(path)){<br />
<br />
SpatialContext ctx = SpatialContext.GEO;<br />
ShapeReader shapeReader = ctx.getFormats().getWktReader();<br />
Shape shape = shapeReader.read(reader);<br />
/*<br />
Ha kiíratjuk, látszik, hogy a beolvasott alakzatunk egy pont:<br />
System.out.println(shape);<br />
Pt(x=19.797752,y=47.171645)<br />
*/<br />
}catch (Exception ex){<br />
//handle<br />
}<br />
<br />
</syntaxhighlight><br />
<br />
====Példa egy alakzat kiírására GEOJsonben====<br />
<syntaxhighlight lang="java"><br />
<br />
SpatialContext ctx = SpatiaContext.GEO;<br />
ShapeWriter shapeWriter = ctx.getFormats().getGeoJsonWriter();<br />
<br />
Point point = ctx.getShapeFactory().pointXY(18.967123,47.643696);<br />
<br />
try(FileWriter writer = new FileWriter("path")) {<br />
<br />
shapeWriter.write(writer, shape);<br />
<br />
} catch (IOException e) {<br />
// handle exception <br />
}<br />
</syntaxhighlight><br />
<br />
Ezek után a fájlunk tartalma a következő kell legyen:<br />
<syntaxhighlight lang="json"><br />
{"type":"Point","coordinates":[18.967123,47.643696]}<br />
</syntaxhighlight></div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=523Spatial4J2017-05-14T17:58:05Z<p>Laczkó Dóra: /* GeoJSON */</p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása '''GeoJSON''' és '''WKT'''(Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket <code>SpatialContext</code> osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre ''SpatialContext'' példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a <code>SpatialContextFactory</code> segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy <code>.property</code> fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk. Ezt a <code>SpatialContextFactory</code> osztály statikus metódusával tehetjük meg:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor az első két módon lehetőség van a JTS-re épülő megfelelőket használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
Habár a konstruktorok használata nincs megtiltva, azok használata általában mégsem ajánlott, kivéve a <code>SpatialContextFactory</code> esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a ''SpatialContext'' példányokon keresztül érhetőek el.<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont (DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
A Spatial4J-ben használható alakzatok: Point, Code, Rectangle, LineString, Polygon, ShapeCollection. Alakzatokat a <code>ShapeFactory</code> segítségével tudunk létrehozni:<br />
<br />
<syntaxhighlight lang="java"><br />
Point point = ctx.getShapeFactory().pointXY(10,10);<br />
<br />
Circle circle = ctx.getShapeFactory().circle(point, 15); // vagy .circle(10,10,0)<br />
<br />
Rectangle r = ctx.getShapeFactory().rectangle(point1, point2); //vagy .rectangle(0,0,10,10)<br />
<br />
Shape lineString = ctx.getShapeFactory().lineString()<br />
.pointXY(0,1)<br />
.pointXY(2,3)<br />
.build();<br />
<br />
Shape shapeCollection = ctx.getShapeFactory().multiShape(Shape.class)<br />
.add(p)<br />
.add(circle)<br />
.build();<br />
<br />
Shape polygon = globalContext.getShapeFactory().polygon()<br />
.pointXY(0,0)<br />
.pointXY(2,3)<br />
.pointXY(10,5)<br />
.build();<br />
<br />
</syntaxhighlight><br />
<br />
==Alakzatok írása/olvasása szöveges formátumokból==<br />
<br />
A Spatial4j segítségével nagyon egyszerűen lehet szöveges formátumokból beolvasni, illetve a különböző alakzatokat ilyen formátumokba kiírni.<br />
Az olvasáshoz egy <code>ShapeReader</code> interface-t megvalósító osztály egy példányára lesz szükségünk. Ilyen osztályok, a <code>GeoJSONReader</code>, <code>WKTReader</code> és <code>PolyshapeReader</code>, amik rendre GeoJSON, WKT és Polyshape formátumok olvasására alkalmasa. Az írás hasonlóan működik, ekkor a <code>ShapeWriter</code> interface példányaira van szükség.<br />
<br />
A beolvasott adatokból a megfelelő <code>Shape</code> objektumok állnak elő. Íráskor pedig a különböző alakzatainkat tudjuk adott formátumban kiírni.<br />
<br />
Az olvasást a <code>ShpaeReader</code> által adott ''read'' művelettel tudjuk megtenni, aminek vagy egy <code>Obejct</code> vagy egy <code>Reader</code> (java.io.Reader) típusú paramétert vár.<br />
<br />
<br />
<code>ShapeReader</code> objektumokat kétféleképpen érjük el a ''SpatialContextből''<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeReader shapeReader1 = ctx.getFormats().getReader(ShapeIO.GeoJSON);<br />
<br />
ShapeReader shapeReader2 = ctx.getFormats().getGeoJsonReader();<br />
</syntaxhighlight><br />
<br />
Illetve ha írni szeretnénk, akkor hasonlóan jutunk egy ShapeWriter objektumhoz:<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeWriter shapeWriter1= ctx.getFormats().getWriter(ShapeIO.GeoJSON);<br />
<br />
ShapeWriter shapeWriter2 = ctx.getFormats().getGeoJsonWriter();<br />
</syntaxhighlight><br />
<br />
Példa egy pont kiírására:<br />
<syntaxhighlight lang="java"><br />
<br />
SpatialContext ctx = SpatiaContext.GEO;<br />
ShapeWriter shapeWriter = ctx.getFormats().getGeoJsonWriter();<br />
<br />
Point point = ctx.getShapeFactory().pointXY(18.967123,47.643696);<br />
<br />
try(FileWriter writer = new FileWriter("path")) {<br />
<br />
shapeWriter.write(writer, shape);<br />
<br />
} catch (IOException e) {<br />
// handle exception <br />
}<br />
</syntaxhighlight><br />
<br />
Ezek után a fájlunk tartalma a következő kell legyen:<br />
<syntaxhighlight lang="json"><br />
{"type":"Point","coordinates":[18.967123,47.643696]}<br />
</syntaxhighlight><br />
<br />
=== WKT ===</div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=522Spatial4J2017-05-14T17:24:12Z<p>Laczkó Dóra: /* Alakzatok */</p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása '''GeoJSON''' és '''WKT'''(Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket <code>SpatialContext</code> osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre ''SpatialContext'' példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a <code>SpatialContextFactory</code> segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy <code>.property</code> fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk. Ezt a <code>SpatialContextFactory</code> osztály statikus metódusával tehetjük meg:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor az első két módon lehetőség van a JTS-re épülő megfelelőket használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
Habár a konstruktorok használata nincs megtiltva, azok használata általában mégsem ajánlott, kivéve a <code>SpatialContextFactory</code> esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a ''SpatialContext'' példányokon keresztül érhetőek el.<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont (DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
A Spatial4J-ben használható alakzatok: Point, Code, Rectangle, LineString, Polygon, ShapeCollection. Alakzatokat a <code>ShapeFactory</code> segítségével tudunk létrehozni:<br />
<br />
<syntaxhighlight lang="java"><br />
Point point = ctx.getShapeFactory().pointXY(10,10);<br />
<br />
Circle circle = ctx.getShapeFactory().circle(point, 15); // vagy .circle(10,10,0)<br />
<br />
Rectangle r = ctx.getShapeFactory().rectangle(point1, point2); //vagy .rectangle(0,0,10,10)<br />
<br />
Shape lineString = ctx.getShapeFactory().lineString()<br />
.pointXY(0,1)<br />
.pointXY(2,3)<br />
.build();<br />
<br />
Shape shapeCollection = ctx.getShapeFactory().multiShape(Shape.class)<br />
.add(p)<br />
.add(circle)<br />
.build();<br />
<br />
Shape polygon = globalContext.getShapeFactory().polygon()<br />
.pointXY(0,0)<br />
.pointXY(2,3)<br />
.pointXY(10,5)<br />
.build();<br />
<br />
</syntaxhighlight><br />
<br />
==Alakzatok írása/olvasása szöveges formátumokból==<br />
<br />
A Spatial4j segítségével nagyon egyszerűen lehet szöveges formátumokból beolvasni, illetve a különböző alakzatokat ilyen formátumokba kiírni.<br />
Az olvasáshoz egy <code>ShapeReader</code> interface-t megvalósító osztály egy példányára lesz szükségünk. Ilyen osztályok, a <code>GeoJSONReader</code>, <code>WKTReader</code> és <code>PolyshapeReader</code>, amik rendre GeoJSON, WKT és Polyshape formátumok olvasására alkalmasa. Az írás hasonlóan működik, ekkor a <code>ShapeWriter</code> interface példányaira van szükség.<br />
<br />
A beolvasott adatokból a megfelelő <code>Shape</code> objektumok állnak elő. Íráskor pedig a különböző alakzatainkat tudjuk adott formátumban kiírni.<br />
<br />
Az olvasást a <code>ShpaeReader</code> által adott ''read'' művelettel tudjuk megtenni, aminek vagy egy <code>Obejct</code> vagy egy <code>Reader</code> (java.io.Reader) típusú paramétert vár.<br />
<br />
=== GeoJSON ===<br />
<code>GeoJSONReader</code> objektumot (és általában a <code>ShapeReader</code> objektumokat) kétféleképpen érjük el a ''SpatialContextből''<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeReader shapeReader1 = ctx.getFormats().getReader(ShapeIO.GeoJSON);<br />
<br />
ShapeReader shapeReader2 = ctx.getFormats().getGeoJsonReader();<br />
</syntaxhighlight><br />
<br />
<br />
<br />
=== WKT ===</div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=521Spatial4J2017-05-13T21:27:27Z<p>Laczkó Dóra: /* Alakzatok */</p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása '''GeoJSON''' és '''WKT'''(Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket <code>SpatialContext</code> osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre ''SpatialContext'' példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a <code>SpatialContextFactory</code> segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy <code>.property</code> fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk. Ezt a <code>SpatialContextFactory</code> osztály statikus metódusával tehetjük meg:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor az első két módon lehetőség van a JTS-re épülő megfelelőket használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
Habár a konstruktorok használata nincs megtiltva, azok használata általában mégsem ajánlott, kivéve a <code>SpatialContextFactory</code> esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a ''SpatialContext'' példányokon keresztül érhetőek el.<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont(DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
A Spatial4J-ben használható alakzatok: Point, Code, Rectangle, LineString, Polygon, ShapeCollection. Alakzatokat a <code>ShapeFactory</code> segítségével tudunk létrehozni:<br />
<br />
<syntaxhighlight lang="java"><br />
Point point = ctx.getShapeFactory().pointXY(10,10);<br />
<br />
Circle circle = ctx.getShapeFactory().circle(point, 0); // vagy .circle(10,10,0)<br />
<br />
Rectangle r = ctx.getShapeFactory().rectangle(point1, point2); //vagy .rectangle(0,0,10,10)<br />
<br />
Shape lineString = ctx.getShapeFactory().lineString()<br />
.pointXY(0,1)<br />
.pointXY(2,3)<br />
.build();<br />
<br />
Shape shapeCollection = ctx.getShapeFactory().multiShape(Shape.class)<br />
.add(p)<br />
.add(circle)<br />
.build();<br />
<br />
Shape polygon = globalContext.getShapeFactory().polygon()<br />
.pointXY(0,0)<br />
.pointXY(2,3)<br />
.pointXY(10,5)<br />
.build();<br />
<br />
</syntaxhighlight><br />
<br />
==Alakzatok írása/olvasása szöveges formátumokból==<br />
<br />
A Spatial4j segítségével nagyon egyszerűen lehet szöveges formátumokból beolvasni, illetve a különböző alakzatokat ilyen formátumokba kiírni.<br />
Az olvasáshoz egy <code>ShapeReader</code> interface-t megvalósító osztály egy példányára lesz szükségünk. Ilyen osztályok, a <code>GeoJSONReader</code>, <code>WKTReader</code> és <code>PolyshapeReader</code>, amik rendre GeoJSON, WKT és Polyshape formátumok olvasására alkalmasa. Az írás hasonlóan működik, ekkor a <code>ShapeWriter</code> interface példányaira van szükség.<br />
<br />
A beolvasott adatokból a megfelelő <code>Shape</code> objektumok állnak elő. Íráskor pedig a különböző alakzatainkat tudjuk adott formátumban kiírni.<br />
<br />
Az olvasást a <code>ShpaeReader</code> által adott ''read'' művelettel tudjuk megtenni, aminek vagy egy <code>Obejct</code> vagy egy <code>Reader</code> (java.io.Reader) típusú paramétert vár.<br />
<br />
=== GeoJSON ===<br />
<code>GeoJSONReader</code> objektumot (és általában a <code>ShapeReader</code> objektumokat) kétféleképpen érjük el a ''SpatialContextből''<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeReader shapeReader1 = ctx.getFormats().getReader(ShapeIO.GeoJSON);<br />
<br />
ShapeReader shapeReader2 = ctx.getFormats().getGeoJsonReader();<br />
</syntaxhighlight><br />
<br />
<br />
<br />
=== WKT ===</div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=520Spatial4J2017-05-13T21:18:30Z<p>Laczkó Dóra: </p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása '''GeoJSON''' és '''WKT'''(Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket <code>SpatialContext</code> osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre ''SpatialContext'' példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a <code>SpatialContextFactory</code> segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy <code>.property</code> fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk. Ezt a <code>SpatialContextFactory</code> osztály statikus metódusával tehetjük meg:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor az első két módon lehetőség van a JTS-re épülő megfelelőket használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
Habár a konstruktorok használata nincs megtiltva, azok használata általában mégsem ajánlott, kivéve a <code>SpatialContextFactory</code> esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a ''SpatialContext'' példányokon keresztül érhetőek el.<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont(DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
A Spatial4J-ben használható alakzatok: Point, Code, Rectangle, LineString, Polygon, ShapeCollection. Alakzatok a <code>ShapeFactory</code> segítségével tudunk létrehozni:<br />
<br />
<syntaxhighlight lang="java"><br />
Point point = ctx.getShapeFactory().pointXY(10,10);<br />
<br />
Circle circle = ctx.getShapeFactory().circle(point, 0); // vagy .circle(10,10,0)<br />
<br />
</syntaxhighlight><br />
<br />
==Alakzatok írása/olvasása szöveges formátumokból==<br />
<br />
A Spatial4j segítségével nagyon egyszerűen lehet szöveges formátumokból beolvasni, illetve a különböző alakzatokat ilyen formátumokba kiírni.<br />
Az olvasáshoz egy <code>ShapeReader</code> interface-t megvalósító osztály egy példányára lesz szükségünk. Ilyen osztályok, a <code>GeoJSONReader</code>, <code>WKTReader</code> és <code>PolyshapeReader</code>, amik rendre GeoJSON, WKT és Polyshape formátumok olvasására alkalmasa. Az írás hasonlóan működik, ekkor a <code>ShapeWriter</code> interface példányaira van szükség.<br />
<br />
A beolvasott adatokból a megfelelő <code>Shape</code> objektumok állnak elő. Íráskor pedig a különböző alakzatainkat tudjuk adott formátumban kiírni.<br />
<br />
Az olvasást a <code>ShpaeReader</code> által adott ''read'' művelettel tudjuk megtenni, aminek vagy egy <code>Obejct</code> vagy egy <code>Reader</code> (java.io.Reader) típusú paramétert vár.<br />
<br />
=== GeoJSON ===<br />
<code>GeoJSONReader</code> objektumot (és általában a <code>ShapeReader</code> objektumokat) kétféleképpen érjük el a ''SpatialContextből''<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeReader shapeReader1 = ctx.getFormats().getReader(ShapeIO.GeoJSON);<br />
<br />
ShapeReader shapeReader2 = ctx.getFormats().getGeoJsonReader();<br />
</syntaxhighlight><br />
<br />
<br />
<br />
=== WKT ===</div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=519Spatial4J2017-05-13T18:48:01Z<p>Laczkó Dóra: </p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása '''GeoJSON''' és '''WKT'''(Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket <code>SpatialContext</code> osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre ''SpatialContext'' példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a <code>SpatialContextFactory</code> segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy <code>.property</code> fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk. Ezt a <code>SpatialContextFactory</code> osztály statikus metódusával tehetjük meg:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor az első két módon lehetőség van a JTS-re épülő megfelelőket használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
Habár a konstruktorok használata nincs megtiltva, azok használata általában mégsem ajánlott, kivéve a <code>SpatialContextFactory</code> esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a ''SpatialContext'' példányokon keresztül érhetőek el.<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont(DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
Alakzatok használata: A SpatialContext make metódusaival hozhatunk létre alakzatokat (pl. makePoint, makeRectangle, stb.)<br />
<br />
==Alakzatok írása/olvasása szöveges formátumokból==<br />
<br />
A Spatial4j segítségével nagyon egyszerűen lehet szöveges formátumokból beolvasni, illetve a különböző alakzatokat ilyen formátumokba kiírni.<br />
Az olvasáshoz egy <code>ShapeReader</code> interface-t megvalósító osztály egy példányára lesz szükségünk. Ilyen osztályok, a <code>GeoJSONReader</code>, <code>WKTReader</code> és <code>PolyshapeReader</code>, amik rendre GeoJSON, WKT és Polyshape formátumok olvasására alkalmasa. Az írás hasonlóan működik, ekkor a <code>ShapeWriter</code> interface példányaira van szükség.<br />
<br />
A beolvasott adatokból a megfelelő <code>Shape</code> objektumok állnak elő. Íráskor pedig a különböző alakzatainkat tudjuk adott formátumban kiírni.<br />
<br />
=== GeoJSON ===<br />
<code>GeoJSONReader</code> objektumot (és általában a <code>ShapeReader</code> objektumokat) kétféleképpen érjük el a ''SpatialContextből''<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeReader shapeReader1 = ctx.getFormats().getReader(ShapeIO.GeoJSON);<br />
<br />
ShapeReader shapeReader2 = ctx.getFormats().getGeoJsonReader();<br />
</syntaxhighlight><br />
A ShapeReader <br />
<br />
<br />
=== WKT ===</div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=518Spatial4J2017-05-13T18:46:13Z<p>Laczkó Dóra: </p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása '''GeoJSON''' és '''WKT'''(Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket <code>SpatialContext</code> osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre ''SpatialContext'' példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a <code>SpatialContextFactory</code> segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy <code>.property</code> fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk. Ezt a <code>SpatialContextFactory</code> osztály statikus metódusával tehetjük meg:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor az első két módon lehetőség van a JTS-re épülő megfelelőket használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
Habár a konstruktorok használata nincs megtiltva, azok használata általában mégsem ajánlott, kivéve a <code>SpatialContextFactory</code> esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a ''SpatialContext'' példányokon keresztül érhetőek el.<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont(DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
Alakzatok használata: A SpatialContext make metódusaival hozhatunk létre alakzatokat (pl. makePoint, makeRectangle, stb.)<br />
<br />
==Alakzatok írása/olvasása szöveges formátumokból==<br />
<br />
A Spatial4j segítségével nagyon egyszerűen lehet szöveges formátumokból beolvasni, illetve a különböző alakzatokat ilyen formátumokba kiírni.<br />
Az olvasáshoz egy <code>ShapeReader</code> interface-t megvalósító osztály egy példányára lesz szükségünk. Ilyen osztályok, a <code>GeoJSONReader</code>, <code>WKTReader</code> és <code>PolyshapeReader</code>, amik rendre GeoJSON, WKT és Polyshape formátumok olvasására alkalmasa. Az írás hasonlóan működik, ekkor a <code>ShapeWriter</code> interface példányaira van szükség.<br />
<br />
=== GeoJSON ===<br />
<code>GeoJSONReader</code> objektumot (és általában a <code>ShapeReader</code> objektumokat) kétféleképpen érjük el a ''SpatialContextből''<br />
<br />
<syntaxhighlight lang="java"><br />
ShapeReader shapeReader1 = ctx.getFormats().getReader(ShapeIO.GeoJSON);<br />
<br />
ShapeReader shapeReader2 = ctx.getFormats().getGeoJsonReader();<br />
</syntaxhighlight><br />
A ShapeReader <br />
<br />
<br />
=== WKT ===</div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=517Spatial4J2017-05-13T18:09:26Z<p>Laczkó Dóra: /* GeoJSON műveletek */</p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása '''GeoJSON''' és '''WKT'''(Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket <code>SpatialContext</code> osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre ''SpatialContext'' példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a <code>SpatialContextFactory</code> segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy <code>.property</code> fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk. Ezt a <code>SpatialContextFactory</code> osztály statikus metódusával tehetjük meg:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor az első két módon lehetőség van a JTS-re épülő megfelelőket használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
Habár a konstruktorok használata nincs megtiltva, azok használata általában mégsem ajánlott, kivéve a <code>SpatialContextFactory</code> esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a ''SpatialContext'' példányokon keresztül érhetőek el.<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont(DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
Alakzatok használata: A SpatialContext make metódusaival hozhatunk létre alakzatokat (pl. makePoint, makeRectangle, stb.)<br />
<br />
<br />
== GeoJSON műveletek ==<br />
A Spatial4j segítségével nagyon egyszerűen lehet GeoJSON formátumból beolvasni, illetve a különböző alakzatokat ilyen formátumba kiírni.<br />
Az olvasáshoz egy ShapeReader típusú objektumra lesz szükségünk:<br />
<br />
== WKT műveletek ==</div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=391Spatial4J2017-04-24T17:47:24Z<p>Laczkó Dóra: /* Alapok */</p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása '''GeoJSON''' és '''WKT'''(Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket <code>SpatialContext</code> osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre ''SpatialContext'' példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a <code>SpatialContextFactory</code> segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy <code>.property</code> fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk. Ezt a <code>SpatialContextFactory</code> osztály statikus metódusával tehetjük meg:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor az első két módon lehetőség van a JTS-re épülő megfelelőket használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
Habár a konstruktorok használata nincs megtiltva, azok használata általában mégsem ajánlott, kivéve a <code>SpatialContextFactory</code> esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a ''SpatialContext'' példányokon keresztül érhetőek el.<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont(DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
Alakzatok használata: A SpatialContext make metódusaival hozhatunk létre alakzatokat (pl. makePoint, makeRectangle, stb.)<br />
<br />
<br />
== GeoJSON műveletek ==<br />
<br />
== WKT műveletek ==</div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=390Spatial4J2017-04-24T17:46:29Z<p>Laczkó Dóra: /* Alapok */</p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása '''GeoJSON''' és '''WKT'''(Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket <code>SpatialContext</code> osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre ''SpatialContext'' példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a <code>SpatialContextFactory</code> segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy <code>.property</code> fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk. Ezt a <code>SpatialContextFactory</code> osztály statikus metódusával tehetjük meg:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor az első két módon lehetőség van a JTS-re épülő megfelelőket használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
Habár a konstruktorok használata nincs megtiltva, azok használata általában mégsem ajánlott, kivéve a SpatialContextFactory esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a SpatialContext példányokon keresztül érhetőek el.<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont(DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
Alakzatok használata: A SpatialContext make metódusaival hozhatunk létre alakzatokat (pl. makePoint, makeRectangle, stb.)<br />
<br />
<br />
== GeoJSON műveletek ==<br />
<br />
== WKT műveletek ==</div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=389Spatial4J2017-04-24T17:37:47Z<p>Laczkó Dóra: /* Alapok */</p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása '''GeoJSON''' és '''WKT'''(Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket <code>SpatialContext</code> osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre ''SpatialContext'' példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a <code>SpatialContextFactory</code> segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy <code>.property</code> fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk. Ezt a <code>SpatialContextFactory</code> osztály statikus metódusával tehetjük meg:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor mindkét esetben lehetőség van a JTS-ben levő megfelelőjét használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
Habár a konstruktorok használata nincs megtiltva, azok használata általában mégsem ajánlott, kivéve a SpatialContextFactory esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a SpatialContext példányokon keresztül érhetőek el. Ezek me<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont(DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
Alakzatok használata: A SpatialContext make metódusaival hozhatunk létre alakzatokat (pl. makePoint, makeRectangle, stb.)<br />
<br />
<br />
== GeoJSON műveletek ==<br />
<br />
== WKT műveletek ==</div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=388Spatial4J2017-04-24T17:32:59Z<p>Laczkó Dóra: </p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása '''GeoJSON''' és '''WKT'''(Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket ''SpatialContext'' osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre SpatialContext példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
<syntaxhighlight lang="java"><br />
SpatialContext globalContext = SpatialContext.GEO;<br />
</syntaxhighlight><br />
<br />
A másik esetben pedig a SpatialContextFactory segítségével hozunk létre egy új context példányt:<br />
<syntaxhighlight lang="java"><br />
SpatialContext nonGeodesicContext = new SpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
A harmadik lehetőséggel létrehozásnál megadhatunk név-érték párokat (ezeket akár egy ''.property'' fájlból is felolvashatjuk), melyekkel inicializálódik a ''SpatialContext'' példányunk:<br />
<syntaxhighlight lang="java"><br />
SpatialContext propertiesContext = SpatialContextFactory.makeSpatialContext(map, classLoader);<br />
</syntaxhighlight><br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor mindkét esetben lehetőség van a JTS-ben levő megfelelőjét használni:<br />
<syntaxhighlight lang="java"><br />
JtsSpatialContext polygonGlobalContext = JtsSpatialContext.GEO;<br />
JtsSpatialContext nonGeodesicPolygonContext = new JtsSpatialContextFactory().newSpatialContext();<br />
</syntaxhighlight><br />
<br />
<br />
Habár a konstruktorok használata nincs megtiltva, azok használata általában mégsem ajánlott, kivéve a SpatialContextFactory esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a SpatialContext példányokon keresztül érhetőek el. Ezek me<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont(DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
Alakzatok használata: A SpatialContext make metódusaival hozhatunk létre alakzatokat (pl. makePoint, makeRectangle, stb.)<br />
<br />
<br />
== GeoJSON műveletek ==<br />
<br />
== WKT műveletek ==</div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=315Spatial4J2017-04-03T19:12:17Z<p>Laczkó Dóra: /* Alapok */</p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása '''GeoJSON''' és '''WKT'''(Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
A könyvtár által nyújtott lehetőségeket ''SpatialContext'' osztály példányain keresztül érhetjük el. Háromféle módon hozhatunk létre SpatialContext példányokat. Ez egyik, hogy globális, singleton példányt használunk:<br />
<br />
A másik esetben pedig a SpatialContextFactory segítségével hozunk létre egy új context példányt:<br />
<br />
A harmadik:<br />
<br />
<br />
Ha poligonokat is akarunk használni, akkor mindkét esetben lehetőség van a JTS-ben levő megfelelőjét használni:<br />
<br />
<br />
Habár a konstruktorok használata nincs megtiltva, azok használata általában mégsem ajánlott, kivéve a SpatialContextFactory esetében. Konstruktorok helyett a különböző factory objektumokat használjuk, melyek a SpatialContext példányokon keresztül érhetőek el. Ezek me<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont(DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
Alakzatok használata: A SpatialContext make metódusaival hozhatunk létre alakzatokat (pl. makePoint, makeRectangle, stb.)<br />
<br />
<br />
== GeoJSON műveletek ==<br />
<br />
== WKT műveletek ==</div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=305Spatial4J2017-03-28T11:21:32Z<p>Laczkó Dóra: </p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása '''GeoJSON''' és '''WKT'''(Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
<br />
== Alakzatok ==<br />
A Spatial4J legnagyobb részét az alakzatok teszik ki. Az alakzatok különböző vetületekben is rendelkezésre állnak:<br />
<br />
A poligonok a JTS Geometry osztályának csomagolásával vannak megvalósítva. Jelenleg nincs lehetőség a pólusokon levő poligonokkal dolgozni, de tervezik ennek megvalósítását a jövőben.<br />
Az alakzatok mindegyike rendelkezik a következő tulajdonságokkal:<br />
* bounding box kiszámítása<br />
* terület kiszámítása (néhány alakzatnál ez inkább csak becslés)<br />
* tartalmaz-e egy adott pontot<br />
* milyen kapcsolatban áll egy téglalappal: tartalmazza az adott téglalapot (CONTAINS), benne van-e az adott alakzatban (WITHIN), nincs közös pont(DISJOINT). Az érintésre nincs számítás a Spatial4j-ben<br />
<br />
Alakzatok használata: A SpatialContext make metódusaival hozhatunk létre alakzatokat (pl. makePoint, makeRectangle, stb.)<br />
<br />
<br />
== GeoJSON műveletek ==<br />
<br />
== WKT műveletek ==</div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=304Spatial4J2017-03-28T11:04:23Z<p>Laczkó Dóra: </p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása '''GeoJSON''' és '''WKT'''(Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.<br />
<br />
== Alapok ==<br />
<br />
== Alakzatok ==<br />
<br />
== GeoJSON műveletek ==<br />
<br />
== WKT műveletek ==</div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=303Spatial4J2017-03-28T10:59:25Z<p>Laczkó Dóra: </p>
<hr />
<div>A '''Spatial4j''' egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása '''GeoJSON''' és '''WKT'''(Well Known Text) formátumokból .<br />
<br />
== Történet ==<br />
Eredetileg '''Lucene Spatial Playgroundként (LSP)''' volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a '''LocationTech'''-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a '''JTS API''' is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). '''GeoJSON''' feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.</div>Laczkó Dórahttp://gis.inf.elte.hu/giswiki/index.php?title=Spatial4J&diff=302Spatial4J2017-03-28T10:55:51Z<p>Laczkó Dóra: Új oldal, tartalma: „A Spatial4j egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi …”</p>
<hr />
<div>A Spatial4j egy általános térinformatikai, open source Java könyvtár (ASL license). A könyvtár 3 területen ad segítséget: közönséges alakzatok euklideszi és geodéziai modellekhez, távolság és egyéb számítások, alakzatok írása/olvasása.<br />
<br />
== Történet ==<br />
Eredetileg Lucene Spatial Playgroundként (LSP) volt ismert a projekt, később ebből vált ki a Spatial4j, ami már teljes független a Lucene-től. Az LSP többi része a Lucene ill. Solr projektekbe olvadtak bele, vagy átkerültek a Spatial Solr Sandboxba. 2016 februárjától a Spatial4j a LocationTech-hez került (Eclipse).<br />
<br />
== Függőségek ==<br />
A könyvtár használatához legalább a Java 1.7-es verziója szükséges. Ha poligonokat és [https://sourceforge.net/projects/jts-topo-suite/ JTS] alapú osztályokat (nevük Jts prefixszel kezdődik) szeretnénk használni, akkor ezen felül szükséges a JTS API is (2 dimenziós alakzatok modellezésére és manipulálására szolgál). GeoJSON feldolgozásához pedig a [https://github.com/yonik/noggit Noggit JSON] elemző könyvtárra is szükség lesz.</div>Laczkó Dóra