GeoShare

From Tygron Support wiki
Revision as of 12:13, 1 February 2024 by Frank@tygron.nl (talk | contribs) (→‎Viewers)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

The GeoShare is a shared central repository for files and (geographical) data, hosted on the Tygron Engine. It is linked to an individual Domain, but exists separate from active Sessions. This allows for the sharing of data, either input data or results from calculations, without the overhead of a full Project's data or a running Session. In addition to geographical data, the GeoShare can also host other files which can be used as assets in a Project.

The GeoShare supports uploading, downloading, renaming and deleting files, as well as setting up a file structure to organize them.

The GeoShare can be accessed directly from the main menu. All users with Editor rights can access and update all files on the GeoShare.

Access

Files uploaded to the GeoShare can be accessed via a url. The url allows anyone to access the file at any time. The url can be used in a webbrowser to initiate a download of the file (or provide an in-browser overview of the contents of a directory).

On a per-file and per-directory basis, it is possible to set a required access token. Although to access a file or directory a url must be known in the first place, requiring an access token provides an additional secret which must be known in order to access the data.

When a directory is accessed in a web browser, all direct contents of the directory are displayed, including those which actually also require an access token. However, only contents which do not require an access token can be directly accessed from that overview.

Public Share

There is also a public section on the GeoShare that is accessible for all users in all domains. The public GeoShare can for example be used to share publicly available default Indicators or example files. Please contact Tygron support to submit proposals for new content on the public GeoShare.

The public GeoShare can be accessed via the toggle button in the upper right corner of the GeoShare panel.

Files

The GeoShare is primarily intended to host geographical data, either for the purpose of standardized input for the creation of Projects, or to host the results of performed calculations in an easily accessible way without the need to keep a Session active or even a complete Project. However, other files can be hosted on the GeoShare as well, with a focus on files which can be used as assets in a Project such as Excels.

The GeoShare supports the following filetypes:

Filetype Name Type of data Input Output
.cityjson GeoJSON 3D visualization data Import as Custom Geometries for Buildings
.csv CSV Text-based list of values
.docx Document
.dxf DXF AutoCAD exchange format Import as Buildings, Areas, etc
.geojson GeoJSON 2D Vector data Import as Buildings, Areas, etc Export of Vector data
.gif Animated image Recorded GIF animation
.gml XML data
.jpeg Image
.jpg Image
.json GeoJSON 2D and 3D Vector data Import as Buildings, Areas, etc
.pdf Document
.png Image Screenshot
.slpk SLPK 3D visualization data Import as Custom Geometries for Buildings
.tif GeoTIFF Grid data GeoTIFF Overlay, Elevation model, other grid data
.tiff GeoTIFF Grid data GeoTIFF Overlay, Elevation model, other grid data Export of Grid Overlay
.txt Text
.xlsx Excel Excel Assets for Indicators, Panels, etc
.xml XML data

Viewers

Main article: GeoShare Viewer

Besides the ability to serve "raw" files, it is possible to create a "viewer" on the GeoShare. Viewers allow for a user-friendly way to share geographical data such as GeoJSONs and GeoTIFFs. They form a type of asset distinctly separate from conventional files and directories. Accessing a viewer in the browser shows a simple web-based interface in which the data of the viewer is visualized. The extent of the viewer is based on the extent of the data which is part of it.


Notes

  • The url for any file, directory, or viewer, contains the name of the file and the name of the domain in which the original file was uploaded.
  • To reset the access token for any file, disable and re-enable the token for the file. A new token will be generated.

How-to's

Videos

Integrating data using the GeoShare and Geo Plugins. (In dutch)
Webinar Tygron Platform LTS release 2023: Public GeoShare and more. (In dutch)

See also

  • Geo Plugin: Files with geographical data can be imported directly into a Project automatically via Geo Plugins.
  • Indicators on the Public Share
  • Panels on the Public Share