GitHub Enterprise Server 支持在 GitHub Enterprise Server 仓库中渲染 geoJSON 和 topoJSON 地图文件。 只需像平常一样提交扩展名为 .geojson
或 .topojson
的文件。 也支持扩展名为 .json
的文件,但仅当 type
设置为 FeatureCollection
、GeometryCollection
或 topology
时才支持。 然后导航到 GitHub.com 上 geoJSON 文件的路径。
单击右侧的纸张图标时,您还会看到在提交时对该文件的更改。
几何类型
GitHub Enterprise Server 上的地图使用 Leaflet.js,并且支持 geoJSON 规格中列出的所有几何类型(Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygon 和 GeometryCollection)。 TopoJSON 文件类型应为 "Topology"(拓扑),并且遵守 topoJSON 规格。
样式功能
您可以传递 geoJSON 对象属性中的其他元数据,自定义功能显示的方式,例如指定特定的颜色或添加描述性图标。 选项包括:
marker-size
-small
、medium
或large
marker-color
- 有效的 RGB 十六进制颜色marker-symbol
- Maki 项目中的图标 ID 或单一英数字符(a-z 或 0-9)。stroke
- 多边形的边或线的颜色 (RGB)stroke-opacity
- 多边形的边或线的不透明度 (0.0 - 1.0)stroke-width
- 多边形的边或线的宽度fill
- 多边形内部的颜色 (GRB)fill-opacity
- 多边形内部的不透明度 (0.0-1.0)
更多信息请参阅开放简单样式规格 1.1.0 版。
在其他位置嵌入您的地图
想让您的 geoJSON 地图用在 GitHub Enterprise Server 以外的地方? 只需修改此模板,并将其放在任何支持 javascript 的 HTML 页面上(如 GitHub Pages):
<script src="https://embed.github.com/view/geojson/<username>/<repo>/<ref>/<path_to_file>"></script>
例如,如果地图的 URL 是 github.com/benbalter/dc-wifi-social/blob/master/bars.geojson,则嵌入的代码是:
<script src="https://embed.github.com/view/geojson/benbalter/dc-wifi-social/master/bars.geojson"></script>
默认情况下,嵌入的地图是 420 像素 x 620 像素,但您可以在结束时将高度和宽度变量作为参数传递,以自定义输出,如 ?height=300&width=500
。
注:ref
可以是分支或个别提交的哈希(如 2391ae
)。
集群
如果地图包含大量标记(大约超过 750 个),GitHub 将自动以较高的缩放比例集群附近的标记。 只需单击群集或放大便可查看个别标记。
关于底层地图
底层地图(街道名称、道路等)由 OpenStreetMap 驱动,这是一个协作性项目,用于创建可自由编辑的世界地图。 如果您发现什么不正确,只需注册并提交修复,因为它是开源项目。
疑难解答
如果在渲染 geoJSON 文件时遇到问题,请通过 geoJSON 语法检查运行 geoJSON 文件,确认该文件有效。 如果您的地点没有出现在预期的位置(例如在海洋中间),可能是数据在规划中,目前不受支持。 目前,GitHub Enterprise Server 只支持 urn:ogc:def:crs:OGC:1.3:CRS84
规划。
此外,如果您的 .geojson
文件特别大(超过 10 MB),则无法在浏览器中渲染。 在这种情况下,您一般会看到一条类似以下的消息:
如果将 .geojson
文件转换为 TopoJSON,可能还是能够渲染数据,TopoJSON 是一种压缩格式,有时能将文件减小 80%。 当然,您始终可以将文件分解为更小的数据块(例如按州或年分解),并将数据在仓库中存储为多个文件。