Hallo, Entdecker! An dieser Seite wird aktiv gearbeitet, oder sie wird noch übersetzt. Die neuesten und genauesten Informationen finden Sie in unserer englischsprachigen Dokumentation.

Diese Version von GitHub Enterprise wird eingestellt am Diese Version von GitHub Enterprise wurde eingestellt am 2020-01-22. Es wird keine Patch-Freigabe vorgenommen, auch nicht für kritische Sicherheitsprobleme. Für eine bessere Leistung, verbesserte Sicherheit und neue Features nehmen Sie ein Upgrade auf die neueste Version von GitHub Enterprise vor. Wenden Sie sich an den GitHub Enterprise-Support, um Hilfe beim Upgrade zu erhalten.

GeoJSON-Dateien auf GitHub zuordnen

Inhalt dieses Artikels

GitHub Enterprise unterstützt die Zuordnung von geoJSON- und topoJSON-Daten in GitHub Enterprise-Repositorys. Committen Sie die Datei einfach wie gewohnt, und verwenden Sie die Erweiterung .geojson oder .topojson. Dateien mit der Erweiterung .json werden auch unterstützt, aber nur wenn type auf FeatureCollection, GeometryCollection oder topology festgelegt ist. Navigieren Sie dann zum Pfad der geoJSON-Datei auf GitHub.com.

Wenn Sie rechts auf das Papiersymbol klicken, sehen Sie auch die Änderungen, die als Teil eines Commits an dieser Datei vorgenommen wurden.

Screenshot von Quellen-Anzeigeauswahl

Geometrie-Typen

Karten auf GitHub Enterprise verwenden Leaflet.js und unterstützen alle Geometrie-Typen, die in der geJSON-Spezifikation genannt sind (Punkt, Linie, Polygon, MultiPoint, MultiLineString, MultiPolygon und GeometryCollection). TopoJSON-Dateien müssen den Typ „Topology“ aufweisen und der topoJSON-Spezifikation entsprechen.

Stil-Features

Sie können anpassen, wie Features angezeigt werden – z. B. eine bestimmte Farbe festlegen oder ein beschreibendes Symbol hinzufügen –, indem Sie zusätzliche Metadaten in den Eigenschaften des geoJSON-Objekts übergeben. Folgende Optionen sind verfügbar:

  • marker-size – Größe der Markierung: small (klein), medium (mittel) oder large (groß)
  • marker-color – Farbe der Markierung: eine gültige RGB-Farbe im Hexadezimalformat
  • marker-symbol – Symbol für Markierung: eine Symbol-ID vom Maki-Projekt oder ein einzelnes alphanumerisches Zeichen (A–Z oder 0–9).
  • stroke – Farbe eines Polygon-Rands oder einer Linie (RGB)
  • stroke-opacity – Opazität eines Polygon-Rands oder einer Linie (0,0–1,0)
  • stroke-width – Breite eines Polygon-Rands oder einer Linie
  • fill – die Farbe im Inneren eines Polygons (RGB)
  • fill-opacity – die Opazität im Inneren eines Polygons (0,0–1,0)

Weitere Informationen finden Sie in Version 1.1.0 der Open-Simplestyle-Spezifikation.

Ihre Karte an anderer Stelle einbinden

Möchten Sie Ihre geoJSON-Karte an anderer Stelle als GitHub Enterprise bereitstellen? Passen Sie einfach diese Vorlage an, und integrieren Sie sie in eine HTML-Seite, die JavaScript unterstützt (z. B. GitHub Pages):

<script src="https://embed.github.com/view/geojson/<username>/<repo>/<ref>/<path_to_file>"></script>

Wenn z. B. die URL Ihrer Karte github.com/benbalter/dc-wifi-social/blob/master/bars.geojson lautet, ist Ihr Einbettungscode:

<script src="https://embed.github.com/view/geojson/benbalter/dc-wifi-social/master/bars.geojson"></script>

Standardmäßig ist die eingebettete Karte 420 Pixel breit und 620 Pixel hoch. Sie können die Ausgabe jedoch anpassen, indem Sie Höhen- und Breitenvariablen als Parameter am Ende angeben, beispielsweise ?height=300&width=500.

Hinweis: ref kann ein Branch sein (wie master) oder der Hash für einen einzelnen Commit (wie 2391ae).

Clustering

Wenn Ihre Karte eine große Anzahl an Markierungen (ungefähr mehr als 750) enthält, bündelt GitHub benachbarte Markierungen automatisch in größeren Zoomstufen. Klicken Sie einfach auf den Cluster oder zoomen Sie heran, um einzelne Markierungen zu sehen.

Mit der zugrunde liegenden Karte stimmt etwas nicht

Die zugrunde liegenden Kartendaten (Straßennamen, Wege etc.) stammen von OpenStreetMap, einem Gemeinschaftsprojekt zur Erstellung einer kostenlosen bearbeitbaren Karte der ganzen Welt. Wenn Sie einen Fehler bemerken, können Sie – da es sich um ein Open-Source-Projekt handelt – sich einfach anmelden und den Fehler korrigieren.

Problemlösungen

Wenn Sie Probleme beim Rendern von geJSON-Dateien haben, überprüfen Sie, ob Sie eine gültige geoJSON-Datei vorliegen haben, indem Sie den geoJSON-Linter über die Datei laufen lassen. Wenn Ihre Punkte an anderer Stelle angezeigt werden als erwartet (z. B. mitten im Meer), befinden sich die Daten wahrscheinlich in einer Projektion, die derzeit nicht unterstützt wird. Aktuell unterstützt GitHub Enterprise nur die Projektion urn:ogc:def:crs:OGC:1.3:CRS84.

Wenn Ihre .geojson-Datei besonders groß ist (über 10 MB), kann sie außerdem nicht im Browser dargestellt werden. Wenn dies der Fall ist, wird im Allgemeinen eine ähnliche Mitteilung wie die folgende angezeigt:

Große Datei

Möglicherweise können Sie die Daten dennoch darstellen, indem Sie die .geojson-Datei in TopoJSON umwandeln, ein komprimiertes Format, das die Dateigröße in einigen Fällen um bis zu 80 Prozent verringern kann. Natürlich können Sie immer die Datei in kleinere Abschnitte aufteilen (z. B. nach Land oder Jahr) und die Daten in Form von mehreren Dateien im Repository speichern.

Zusätzliche Ressourcen

Menschliche Unterstützung einholen

Sie können das Gesuchte nicht finden?

Kontakt