GeoJSON-Dateien auf GitHub zuordnen
Inhalt dieses Artikels
- Geometrie-Typen
- Stil-Features
- Ihre Karte an anderer Stelle einbinden
- Clustering
- Mit der zugrunde liegenden Karte stimmt etwas nicht
- Problemlösungen
- Zusätzliche Ressourcen
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.
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) oderlarge(groß)marker-color– Farbe der Markierung: eine gültige RGB-Farbe im Hexadezimalformatmarker-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 Liniefill– 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:
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.