tiffany
1.0.0
用于将 Google 静态地图中的任何图像渲染为 TIFF的命令行工具
tiffany从 Google 静态地图 (API) 下载、地理参考和标记任何卫星图像。您可以使用它为下游任务准备标记数据，例如计算机视觉（对象检测、语义分割等）
直接从命令行下载 Google 静态地图图像
自动地理配准下载的 GSM 图像（SRID： EPSG:4326 ）
通过剪切 ESRI Shapefile 为图像创建训练标签
只需一个命令，
$ 蒂芙尼 14.546943935986324 121.01974525389744
您可以为以(14.54694524, 121.0197543253)为中心的图像生成以下输出。请注意， --with-labels标志需要输入 ESRI Shapefile，最好来自 OpenStreetMap (OSM)。
| 原图 | 地理参考 | 带标签 |
|---|---|---|
 |  |  |
--without-reference | 默认 | --with-labels |
您可以从我们的“发布”选项卡获取最新的二进制文件。确保下载与您的系统兼容的版本。截至目前，我们仅在 amd64 架构上进行编译：
| Linux（AMD64） | 达尔文 (amd64) | Windows（AMD64） | |
|---|---|---|---|
| 最新的 | 蒂芙尼-最新-linux-amd64 | 蒂芙尼-最新-达尔文-amd64 | 蒂芙尼-最新-Windows-AMD64 |
| 每晚 | tiffany-nightly-linux-amd64 | 蒂芙尼-每晚-达尔文-amd64 | 蒂芙尼-Nightly-Windows-AMD64 |
或者，您可以从源代码编译tiffany 。您需要 go1.11 和 GDAL>=2.0.0 才能创建成功的构建。首先，克隆存储库并输入：
$ git克隆 [email protected]:thinkingmachines/tiffany.git $ CD 蒂芙尼
然后获取依赖项并构建项目：
$ 去获取 $ 去构建 .
或者，您也可以在系统中安装tiffany
$ 去安装
Tiffany 需要 Google 静态地图 API 密钥。对于大量请求，Tiffany 还需要一个 Secret Key 来对 URL 进行签名。生成将它们存储在项目目录中的.tiffany.env文件中：
# .tiffany.envAPI_KEY="<此处为您的 API 密钥>"SECRET_KEY="<此处为您的密钥"
要获取图像，只需调用tiffany ，并向其传递您的纬度和经度：
$ 蒂芙尼 14.546943935986324 121.01974525389744
您可以通过将文件路径传递给--env参数来提供.tiffany.env文件。默认情况下，从项目根目录搜索它：
$ 蒂芙尼 14.546943935986324 121.01974525389744 --env=path/to/.tiffany.env
上面的命令将生成一个目录tiffany.out ，其中包含*.png及其相应的*.tiff文件。
如果您不想要地理参考图像并且更喜欢普通的 PNG 图像，那么只需传递--without-reference标志即可：
$ 蒂芙尼 14.546943935986324 121.01974525389744 --无参考
最后，您可以从 ESRI Shapefile 中剪辑地理参考图像的标签。这对于机器学习等下游任务很有用：
$ 蒂芙尼 14.546943935986324 121.01974525389744 --with-labels=path/to/gis_osm_buildings_free_1.shp
除了调用 for 循环之外，还可以通过在batch命令中传递包含感兴趣点的纬度和经度的 CSV 文件来获取多个图像。这种方法效率更高，速度也相对更快：
# coordinates.csv latitude,longitude 14.546943935986324,121.01974525389744 14.438494843958949,121.84324983413455 14.879847197948529,121.81851791571952
进而，
$ 蒂芙尼批次坐标.csv
只需分叉此存储库并发出拉取请求即可！我们对任何形式的贡献都持开放态度，但我们绝对会感激：
新功能的实施
编写文档
测试
此外，我们还有 CONTRIBUTING.md 和行为准则，所以请检查一下！
OSM 数据版权归 OpenStreetMap 贡献者所有，并根据开放数据库许可证获得许可
Google 静态地图的使用受其使用条款和附加服务条款的约束。您仍然需要获取 API 密钥才能使用此服务。
蒂芙尼徽标的灵感来自于 Twitch 徽标，并基于 MaxiGamer 创建的字体类型。颜色基于 Gopher Blue ( #00ADD8 )，来自 Golang 品牌手册
麻省理工学院许可证 (c) 2019，思维机器数据科学
