tiffanyダウンロード - tiffanyソースコードのダウンロード

tiffany

その他のソースコード

1.0.0

ダウンロード

Google Static Maps の画像をTIFFにレンダリングするためのコマンドラインツール

tiffany Google Static Maps (API) から衛星画像をダウンロードし、地理参照し、ラベルを付けます。これを使用して、コンピュータービジョン (オブジェクト検出、セマンティックセグメンテーションなど) などの下流タスク用にラベル付きデータを準備できます。

特徴

コマンドラインから直接 Google 静的マップ画像をダウンロードする
ダウンロードされた GSM 画像を自動的に地理参照します (SRID: EPSG:4326 )
ESRI シェープファイルをクリップして画像のトレーニングラベルを作成する

たった一つのコマンドで、

 $ ティファニー 14.546943935986324 121.01974525389744

(14.54694524, 121.0197543253)を中心とする画像に対して次の出力を生成できます。 --with-labelsフラグには、できれば OpenStreetMap (OSM) からの入力 ESRI シェープファイルが必要であることに注意してください。

元の画像	地理参照	ラベル付き

`--without-reference`	デフォルト	`--with-labels`

インストール

バイナリの取得

最新のバイナリは「リリース」タブから入手できます。必ずお使いのシステムと互換性のあるものをダウンロードしてください。現時点では、amd64 アーキテクチャでのみコンパイルします。

	Linux (amd64)	ダーウィン (amd64)	Windows (amd64)
最新	ティファニー-最新-linux-amd64	ティファニー-最新-ダーウィン-amd64	ティファニー-最新-windows-amd64
毎晩	ティファニー-ナイトリー-linux-amd64	ティファニー-ナイトリー-ダーウィン-amd64	ティファニー-ナイトリー-windows-amd64

ソースからコンパイルする

あるいは、ソースからtiffanyをコンパイルすることもできます。ビルドを正常に作成するには、go1.11 および GDAL>=2.0.0 が必要です。まず、リポジトリのクローンを作成し、次のように入力します。

 $ git clone [email protected]: Thinkingmachines/tiffany.git
$cdティファニー

次に、依存関係を取得してプロジェクトをビルドします。

 $ 取りに行きます
$ ビルドに進みます。

オプションで、システム内にtiffanyをインストールすることもできます

$ インストールに行く

使用法

認証

Tiffany には Google Static Maps API キーが必要です。大量のリクエストの場合、ティファニーは 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

上記のコマンドは*.pngとそれに対応する*.tiffファイルが配置されるディレクトリtiffany.outを生成します。

地理参照された画像が不要で、従来の PNG 画像を好む場合は、単に--without-referenceフラグを渡します。

 $ ティファニー 14.546943935986324 121.01974525389744 --参照なし

最後に、ESRI シェープファイルから地理参照画像のラベルをクリップできます。これは、機械学習などの下流タスクに役立ちます。

 $ ティファニー 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 の寄稿者にあり、Open Database License に基づいてライセンスされています
Google Static Maps の使用には、その利用規約と追加利用規約が適用されます。このサービスを利用するには、引き続き API キーを取得する必要があります。
ティファニーのロゴは Twitch ロゴからインスピレーションを得たもので、MaxiGamer によって作成されたフォントタイプに基づいています。カラーはGolangブランドブックよりGopher Blue( #00ADD8 )をベースにしています