Skip to content

Commit c67b0cb

Browse files
Daniel BerthereauDaniel Berthereau
authored andcommitted
Updated readme.
1 parent 01e72f2 commit c67b0cb

1 file changed

Lines changed: 19 additions & 17 deletions

File tree

README.md

Lines changed: 19 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -59,9 +59,8 @@ composer install --no-dev
5959
MySql does not support all geographic queries, for example to [search a point in a polygon for a sphere],
6060
so it is disabled by default in the config.
6161

62-
Queries are limited to geographic data, not geometric ones for now.
63-
64-
Because MariaDB [supports only geometric queries], search is disabled when it is used.
62+
For MariaDB, because it [supports only geometric queries], geographic search is
63+
disabled when it is used.
6564

6665
### Omeka database or external database [work in progress]
6766

@@ -178,32 +177,34 @@ A geometric position is a `x,y` pair: `2,48`.
178177

179178
In the user interface, this value is composed with two positive integer values,
180179
separated by a `,`. In the database, it is stored the same and as a geometric
181-
WKT point. In the api, the value is an object with the two keys (see below),
182-
that can be used with the w3c geolocation api. The values are presented as
183-
strings to avoid issues with json implementations of clients.
180+
WKT point. This point is based on bottom left corner, so the y is inversed.
181+
182+
In the api, the value is an object with the two keys (see below), that can be
183+
used with the w3c geolocation api. The values are presented as strings to avoid
184+
issues with json implementations of clients.
184185

185186
### JSON-LD and GeoJSON
186187

187188
According to the [discussion] on the working group of JSON-LD and GeoJSON, the
188-
GeoJson cannot be used in all cases inside a JSON-LD. So the representation uses
189-
the data type `http://www.opengis.net/ont/geosparql#wktLiteral` of the [OGC standard].
190-
The deprecated datatype `http://geovocab.org/geometry#asWKT` is no more used.
191-
For coordinates and positions, the data type is the api one, `geography:coordinates`,
192-
`geometry:coordinates`, `geometry:position`.
189+
GeoJson cannot be used in all cases inside a JSON-LD.
190+
191+
So the representation uses Omeka types and appends the data type `http://www.opengis.net/ont/geosparql#wktLiteral`
192+
of the [OGC standard]. The deprecated datatype `http://geovocab.org/geometry#asWKT`
193+
is no more used. For coordinates and position, no "@type" is appended
193194

194195
```json
195196
{
196197
"dcterms:spatial": [
197198
{
199+
"type': "geography",
198200
"@type": "http://www.opengis.net/ont/geosparql#wktLiteral",
199-
"@value": "POINT (2.294497 48.858252)",
200-
201+
"@value": "POINT (2.294497 48.858252)"
201202
},
202203
{
203-
"@type": "geography:coordinates",
204+
"type": "geography:coordinates",
204205
"@value": {
205-
"latitude": "48.858252",
206-
"longitude": "2.294497"
206+
"latitude": 48.858252,
207+
"longitude": 2.294497
207208
}
208209
}
209210
]
@@ -221,7 +222,7 @@ TODO
221222
- [ ] Upgrade terraformer to terraformer.js (need a precompiled js).
222223
- [x] Rename api keys to "geometry", "geography", "geography:coordinates" for Omeka S v4.
223224
- [ ] Support complex forms (multipoint, multiline, multipolygon)
224-
- [ ] Improve support of various srid for geography and enable search for geometry.
225+
- [x] Improve support of various srid for geography and enable search for geometry.
225226
- [ ] Store the srid in geography directly.
226227
- [ ] Fix parsing check for doctrine and terraformer, for example with an open polygon.
227228

@@ -292,6 +293,7 @@ sociales [EHESS]. The improvements were developed for the digital library of the
292293
[Omeka S]: https://omeka.org/s
293294
[WKT]: https://wikipedia.org/wiki/Well-known_text
294295
[Annotate Cartography]: https://gitlab.com/Daniel-KM/Omeka-S-module-Cartography
296+
[Mapping]: https://github.com/Omeka-S-modules/Mapping
295297
[Installing a module]: https://omeka.org/s/docs/user-manual/modules/#installing-modules
296298
[mySql 5.6.1]: https://dev.mysql.com/doc/relnotes/mysql/5.6/en/news-5-6-1.html
297299
[MariaDB 5.3.3]: https://mariadb.com/kb/en/library/mariadb-533-release-notes/

0 commit comments

Comments
 (0)