我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

此版本的 GitHub Enterprise 已停止服务 2021-03-02. 即使针对重大安全问题,也不会发布补丁。 要获得更好的性能、改进的安全性和新功能,请升级到 GitHub Enterprise 的最新版本。 如需升级方面的帮助,请联系 GitHub Enterprise 支持

GitHub 上的地图 geoJSON 文件

本文内容

GitHub Enterprise Server 支持在 GitHub Enterprise Server 仓库中渲染 geoJSON 和 topoJSON 地图文件。 只需像平常一样提交扩展名为 .geojson.topojson 的文件。 也支持扩展名为 .json 的文件,但仅当 type 设置为 FeatureCollectionGeometryCollectiontopology 时才支持。 然后导航到 GitHub.com 上 geoJSON 文件的路径。

单击右侧的纸张图标时,您还会看到在提交时对该文件的更改。

源渲染切换屏幕截图

几何类型

GitHub Enterprise Server 上的地图使用 Leaflet.js,并且支持 geoJSON 规格中列出的所有几何类型(Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygon 和 GeometryCollection)。 TopoJSON 文件类型应为 "Topology"(拓扑),并且遵守 topoJSON 规格

样式功能

您可以传递 geoJSON 对象属性中的其他元数据,自定义功能显示的方式,例如指定特定的颜色或添加描述性图标。 选项包括:

  • marker-size - smallmediumlarge
  • 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%。 当然,您始终可以将文件分解为更小的数据块(例如按州或年分解),并将数据在仓库中存储为多个文件。

其他资源