Übersicht:
Favoritenliste:
Favoritenseiten
| Ihre Favoritenliste enthält derzeit keine Seiten. Sie fügen dieser Liste Seiten hinzu, indem Sie im Menü Extras der angezeigten Seite Favorit selektieren. |
Seitenhistorie
...
Die folgende Anleitung erklärt, wie Sie die Daten des envVisio Service ansehen und downloaden können, ohne Programmierkenntnisse oder eine zusätzliche Software zu verwenden.
Um dieser Ableitung Anleitung zu folgen, benötigen Sie:
Einen beliebigen modernen Browser (z.B. Firefox, Chrome, Safari, Microsoft EdgEdge, Opera)
- Gegebenenfalls ein Browser-Plugin, um JSON strukturiert und übersichtlich anschauen zu können. (Firefox braucht kein Plugin)
Zugangsdaten zum envVisio Service (Name und Passwort) / für den Hackathon nicht benötigt
Hinweis für den Hackathon:
Für den Hackathon wird eine andere Basis - URL benötigt als hier beschrieben.
(https://db01.simplex4data.de/hackathon/envvisioservice)
Übersicht
- Schritt 1: Anmeldung und Scenario
- Schritt 2: Collections oder „Was für Daten hat stellt der Dienst bereit und wo finde ich sie?“
- Schritt 3: Features oder die Datenzentrale
- Schritt 4: Download in verschiedenen Formaten
- 4.1 Download als JSON
- 4.2 Download als GeoJSON
- 4.3 Download als Shapefile
- Schritt 5: Filtern der Ergebnisse
- Schritt 6: Visualisierungstools
- Schritt 7: Verbindungen
Schritt 1: Anmeldung und Scenario
...
Zunächst öffnet sich ein Fenster, dort geben Sie Ihre Zugangsdaten ein.
Nun ist die Detailseite zu Szenario 1 sichtbar.
| Info |
|---|
Exkurs: Detailseiten vs. Listenseiten Im envVisio Service gibt es v.a. zwei Arten von Seiten. Detailseiten enthalten ein einzelnes Objekt: Die Seite https://db01.simplex4data.de/envvisioservice/scenarios/1 enthält Informationen zu dem Scenario mit der ID 1. Sie sind in der Hierarchie immer unter den Listenseiten angeordnet. Listenseiten enthalten Informationen zu vielen Objekten der gleichen Art: Die Seite https://db01.simplex4data.de/envvisioservice/scenarios enthält Informationen zu allen Scenarios, die im Dienst vorhanden sind. (Die anderen Szenarien sind für diese Anleitung allerdings irrelevant). Listenseiten können mithilfe verschiedener Parameter gefiltert werden, um nur bestimmte Objekte zu erhalten. |
...
Der letzte Link führt zu https://db01.simplex4data.de/envvisioservice/scenarios/1/collections.
Schritt 2: Collections oder "Was für Daten
...
stellt der Dienst bereit und wo finde ich sie?"
Die Listenseite https://db01.simplex4data.de/envvisioservice/scenarios/1/collections zeigt alle Collections an, die der Dienst anbietet.
...
2) Unter extendfinden sich informationen zur geographischen Verortung der Collection. Eine BeoundingBounding-Box definiert einen Rahmen, in dem sich alle Objekte der Collection befinden, die ein oder mehrere Geometrieattribute haben. Siehe auch 4-2)
3) Unter properties finden sich Metadaten zu den Objekten der Collection. Hier werden alle Attribute der Objekte aufgeführt und beschrieben.
Schritt 3: Features oder "die Datenzentrale"
...
- numberReturned gibt an, wie viele Features der Dienst Ihnen geliefert hat. In diesem Fall 10 Features, d.h. 10 Stadtteile, was nicht überrascht, da wir mit "limit=10" genau diese Anzahl an Features angefordert haben.
- numberMatched gibt an, wie viele Features der Dienst findet, wenn er die in den Parametern angegebenen Filterbedingungen berücksichtigt. Da „limit“ als einziger Parameter dieser Anfrage keine inhaltliche Bedingung ist, sagt die Zahl 64 ind idesem in diesem Fall aus, dass der Dienst insgesamt 64 Features liefern könnte. Damit ist nu nun bekannt, dass die Collection 64 Stadtteile (=64 Features) enthält.
2) Details der Features
...
Die einzelnen Attribute der Features wurden auf der Seite der Collection, der sie angehören, definiert (siehe Schritt 2). Mithilfe dieser Metadaten können wir u.a. folgende Informationen aus dem ersten Feature entnehmen:
- das Feature trägt (siehe "key") den Wert "01" des Fachschlüssels, den die Stadt Dresden ihren Stadtteilen zuweist (Ein passender Wert, da es sich hier um die "innere Altstadt" (siehe "description") handelt).
- das Feature hat eine Flächengröße (siehe "Flächengröße") von 0,8324 km²
- Das Feld "type" kann genutzt werden, um die Features zu differenzieren
- Die hier ungenutzten Felder "beg" und "fin" sind vorgesehen, um (als Datumsangaben formatiert) den Beginn und das Ende der Lebenszeit eines Objekts zu beschreiben
- Das komplexe JSON-Objekt "Flächengeometrie" enthält ein Geometrieattribut
Schritt 4: Download in verschiedenen Formaten
...
Da JSON das Standardformat des Dienstes ist, sind keine zusätzlichen Parameter nötig, um JSON vom Dienst zu erhalten.
Viele Browser (hier zu sehen: Firefox) können JSON erkennen und bieten direkt eine Speicheroption an.
Bei anderen Browsern (in den Abbildungen: Microsoft Edge) muss der rohe Inhalt per Copy-Paste in einen Editor übertragen werden. Im Editor kann das Dokument mithilfe der Endung „.json“ als JSON-Dokument gespeichert werden.
4.2 Download als GeoJSON
...
Sie werden am Beispiel der collection "öffentliche Einrichtungen" durchgegangen.
Allgemeine Syntaxregeln:
- Die Parameter werden an die "/items"-URL angehängt
- Vor dem ersten Parameter muss ein "?" an die URL gehängt werden, alle weiteren sind mit einem "&" zu ergänzen.
- Die Reihenfolge der Parameter spielt keine Rolle.
| Name | Erklärung | Beispiel | Erläuterung des Beispiels | |
|---|---|---|---|---|
| Anzahl der Features | ||||
| limit | Anzahl an Features der Collection, die der Dienst liefern soll. Wenn es nicht angegeben ist, wird als default der Wert von 10 angenommen. | https://db01.simplex4data.de/envvisioservice/scenarios/1/collections/1-1-100/items?limit=10 | Die ersten 10 Features der Collection. | |
| startindex | Legt fest, ab dem wievielten Feature der Dienst liefern soll (ermöglicht in Kombination mit "limit" ein schrittweises Iterieren über große Mengen an |
Features). | https://db01.simplex4data.de/envvisioservice/scenarios/1/collections/1-1-100/items?startindex=10&limit=10 | Das 11. bis 20. Feature der Collection. |
| Features nach Eigenschaften filtern | Hinweis: Das Filtern geschieht als Textsuche d.h. es werden auch Werte gefunden, die länger sind als das Suchwort (siehe Beispiele) | |||
| type | Filtern nach dem Attribut "type" | https://db01.simplex4data.de/envvisioservice/scenarios/1/collections/1-1-100/items?type=pflege | Alle Features, deren "type"-Attribut die Buchstabenfolge "pflege" enthält (z.B. "Seniorentagespflege", "Kurzzeitpflege") | |
| name | Filtern nach dem Attribut "title" | https://db01.simplex4data.de/envvisioservice/scenarios/1/collections/1-1-100/items?name=alt | Alle features, deren "title"-Attribut die Buchtsabenfolge "alt" enthält | |
| key | Filtern nach dem Attribut "key" | https://db01.simplex4data.de/envvisioservice/scenarios/1/collections/1-1-100/items?key=162 | Alle Features, deren "key"-Attribut die Buchstabenfolge "162" enthält (z.B. "21162", "21620") |
Schritt 6: Visualisierungstools
...
https://db01.simplex4data.de/geodjango/graph/
Schritt 7: Verbindungen
Das envVisio-Datenmodell legt einen großen Wert auf Verbindungen. Diese sind mithilfe der Parameter "neighbours" und "links" über den envVisio Service zugänglich.
Dazu betrachten wir im Folgenden die collection "Gemeinden" mit der CollectionId 4-1-101.
links
Der Parameter links stellt Metadaten über die Verbindungen bereit.
Die URL https://db01.simplex4data.de/envvisioservice/scenarios/1/collections/4-1-101/links liefert folgendes Ergebnis:
Daraus lässt sich ablesen, dass die Collection "Gemeinden" mit drei weiteren Collections verbunden ist. Mittels der angegebenen Links kann direkt in diese Collection gewechselt werden.
Die Features der Collection (hier die Gemeinden) können demnach verbunden sein mit Features der Collection "Bauwerk", "ÖPNV-Stop"und "Kreis".
neighbours
Der Parameter neighbours liefert alle über Verbindungen erreichbaren Entitäten auf.
Betrachten wir dies für die Gemeinde Detmold mit der Feature Id 4-101-13788 unter der URL:
Mit dem einzelnen Feature "Gemeinde Detmold" sind 723 Features aus anderen Collections verbunden. Durch die letzte Abfrage wissen wir, dass diese 723 Features sich auf die Collections "Bauwerke", "ÖPNV-Stops"und "Kreise" verteilen. Im Screenshot sehen wir bereits einen Kreis und ein Bauwerk.
Auf der Ebene der neighbours können diesselben Filtermachanismen angewandt werden wie in Schritt 5 für "/items" vorgeführt.
So können z.B. nur die Bauwerke angefragt werden:
Oder die ÖPNV-Stops, die "Detmold" im Namen tragen:
Weiterführendes
- Überblick über den envVisio Service
- Technische Dokumentation des Dienstes in allen Details
Überblick
Inhalte
Aktivität