Changes for page kg-spatial-search

Last modified by oschmid on 2023/08/22 11:23

From version 8.1
edited by oschmid
on 2023/08/22 09:25
Change comment: There is no comment for this version
To version 11.1
edited by oschmid
on 2023/08/22 09:26
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -28,9 +28,8 @@
28 28  
29 29  Simply use the API endpoint at [[https:~~/~~/spatial.kg.ebrains.eu/api/>>https://spatial.kg.ebrains.eu/api/]] by running queries according to the following examples:
30 30  
31 +== Get started: Query by a "bounding box" (hyperrectangle) ==
31 31  
32 -==== Get started: Query by a "bounding box" (hyperrectangle) ====
33 -
34 34  {{code language="bash" layout="LINENUMBERS"}}
35 35  curl -X 'POST' \
36 36   'https://spatial.kg.ebrains.eu/spatial-search/cores/ebrains/spatial_objects' \
... ... @@ -43,9 +43,8 @@
43 43  
44 44  As you can see, you're sending a POST request to the endpoint at **https:~/~/spatial.kg.ebrains.eu/spatial-search/cores/ebrains/spatial_objects  **with a payload defining a geometry of interest. In this case, we're looking for all objects that are **inside **a **hyperrectangle **defined by its lowest and highest point in the coordinate system of the coordinate space **AMB-CCF_v3-RAS**. This query will return you an array of ids of the objects located within the geometry which you then can use to conveniently query the KG either through the [[Instance API>>https://core.kg.ebrains.eu/swagger-ui/index.html#/2%20Advanced/getInstancesByIds]] or the [[Query API>>https://core.kg.ebrains.eu/swagger-ui/index.html#/1%20Basic/runDynamicQuery]] to access detailed meta information.
45 45  
45 +== Query by hypersphere ==
46 46  
47 -==== Query by hypersphere ====
48 -
49 49  Alongside the possibility to use hyperrectangles for querying the spatial search, you can also use hyperspheres:
50 50  
51 51  {{code language="javascript" layout="LINENUMBERS"}}
... ... @@ -56,10 +56,8 @@
56 56  
57 57  It is defined by the center of the sphere with its coordinates, the radius in coordinate units and the coordinate space of the given coordinates (in this case again AMB-CCF_v3-RAS)
58 58  
57 +== Advanced use: Union geometries for complex queries ==
59 59  
60 -
61 -==== Advanced use: Union geometries for complex queries ====
62 -
63 63  To build arbitrarily complex geometries, it is possible to combine hyperrectangles and hyperspheres via (nested) unions:
64 64  
65 65  {{code language="javascript" layout="LINENUMBERS"}}