Geo Data: Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(217 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{{stub}}
Geographical data or geo data is data which have a location component. Almost all data is linked to a location or a place and are, therefore, geo data. Geo data can be, for example, a paper map, a digital web map or just a simple text file with coordinates. Geo datasets is either '''vector data''' (that is, features which are points, lines or polygons) or '''raster data''' (that is, data in grid cells). The features in vector data can have multiple attributes with values. Raster data mostly consist of a value and a color.
{{technical}}


{{learned|what is GEO Data|how GEO Data relates to the Tygron Engine|what GEO Data courses are used|when to use GEO Data}}
==How do Geo datasets relate to the {{software}}==
[[File:Generate_3D_world_databases.png|Load data from databases|thumb|400px|left|Tygron Platform loading screen showing several of the data connections]]
The {{software}} uses Geo data (vector and raster data) for building up a new [[project]]. For this, the {{software}} automatically connects to (Open) [[Project_Sources#Sources_connected_to_the_Tygron_Platform|Datasets]], based on the availability of the data for the chosen location of the project. For example the Base Registers in the Netherlands and Open Street Maps worldwide.
A principle that generally applies: if your project lacks certain information, then it is not available in the used datasets. <br> For more information on which data is used for your generating your project, see the [[Project_Sources#Sources_connected_to_the_Tygron_Platform|project sources]] page.
To add missing Geo data you can add additional Geo data manually (see below for options).
<br clear=all>


==What is the API?==
==When to use your own data==
An API (Application Programmers Interface) is a feature in software which allows external parties to create applications to interact with the software. Where human users make use of a graphical interface, applications can send and receive data packages directly, in some form, when communicating via an API. An API is most useful to technical users, as the ability to create or configure your own software is implicitly required.
* The project takes place in a location for which there are no data sources available to create the project
* The default data sources are not accurate or up-to-date enough
* The default datasets are not detailed enough
* To do a more extended analysis in the {{software}}
* To use in combination with an Excel Indicator or Panel
* For creating more overview in your project, for example by highlighting areas
In these situations, it might be useful to overwrite or import data.


==How does the API relate to the Tygron Engine?==
==View Geo data==
The Tygron Engine consists of two essential components: server software and a client application. When you use the Tygron Engine installer, you actually only install the client application of the Tygron Engine. Clicking buttons to create projects, start session, place buildings, or perform other tasks, actually sends instructions to the server software, where the actual session is (or will be) hosted. The client application then receives data from the server to display to the user, graphically. The API is part of the server software, and allows a user to write their own application to send instructions and/or display data. This means that the API can be used to automate tasks, such as the generation of new projects, or the placement or buildings, and can be used to analyse the data present on the server.
To show Geo data in other software, such as a GIS, options are:
* the [[Overlay]]s can be obtained through a [[WMS]] URL. See the [[WMS]] page for more information and steps.
* the [[Buildings]] can be obtained through a [[WFS]] URL. See the [[WFS]] page for more information and steps.


The API for the Tygron Engine can be reached by appending the URL for the Tygron Engine with "/api/". For example: {{url|link=true|protocol=true|append=/api/}}
==See also==
* [[Import_Geo_data|Import Geo data]]
* [[Export_Geo_data|Export Geo data]]


==When to use the API?==
{{Template:GeoDataOverview}}
The API is meant for technical users. Specifically, software developers will be able to make the best use of the API. For most users, it is recommended to use the client application. The client application has been made user-friendly, and is the preferred method of interacting with the Tygron Engine in most use-cases.
 
There are a number of more technical tasks which do require the API to be used, and which expand the usability of the Tygron Engine greatly. Tasks for which the API can be used include:
* Automated data analysis, such as building density analysis during a session.
* Automated interactions, such as measures activated under specific circumstances.
* (Automated) data entry from a database or program into the Tygron Engine, such as possible function types.
* Automated data extraction, such as taking the spatial results from a session to use as input for other data analysis programs.
* [[indicators#API indicators|API indicators]], which allow showing the results of a complex calculation as an indicator score.
 
==Structure==
The API is structured in such a way that from the root url of the API, it is possible to reach all parts of the API, provided you have sufficient credentials. The first section is related to data and operations related to the Tygron Engine itself, such as user and project management. It also provides access to a second section, which relates to specific projects currently running on the server. The credentials strictly required for these sections differ.

Latest revision as of 16:22, 27 January 2023

Geographical data or geo data is data which have a location component. Almost all data is linked to a location or a place and are, therefore, geo data. Geo data can be, for example, a paper map, a digital web map or just a simple text file with coordinates. Geo datasets is either vector data (that is, features which are points, lines or polygons) or raster data (that is, data in grid cells). The features in vector data can have multiple attributes with values. Raster data mostly consist of a value and a color.

How do Geo datasets relate to the Tygron Platform

Tygron Platform loading screen showing several of the data connections

The Tygron Platform uses Geo data (vector and raster data) for building up a new project. For this, the Tygron Platform automatically connects to (Open) Datasets, based on the availability of the data for the chosen location of the project. For example the Base Registers in the Netherlands and Open Street Maps worldwide. A principle that generally applies: if your project lacks certain information, then it is not available in the used datasets.
For more information on which data is used for your generating your project, see the project sources page. To add missing Geo data you can add additional Geo data manually (see below for options).

When to use your own data

  • The project takes place in a location for which there are no data sources available to create the project
  • The default data sources are not accurate or up-to-date enough
  • The default datasets are not detailed enough
  • To do a more extended analysis in the Tygron Platform
  • To use in combination with an Excel Indicator or Panel
  • For creating more overview in your project, for example by highlighting areas

In these situations, it might be useful to overwrite or import data.

View Geo data

To show Geo data in other software, such as a GIS, options are:

  • the Overlays can be obtained through a WMS URL. See the WMS page for more information and steps.
  • the Buildings can be obtained through a WFS URL. See the WFS page for more information and steps.

See also

Geo Data
Project Sources
Open data sources • GeoShare • Custom Geometry
Web
WFS • WMS • WCS • CSW • Map service
File
CityGML • DXF • GeoJSON • GeoTIFF • SLPK
Import
Vector • Raster • 2D spatial plan • 3D model (I3S, CityGML)
Export
Vector • Raster • GeoShare Viewer


Retrieved from "https://previewsupport.tygron.com/w/index.php?title=Geo_Data&oldid=50484"