tiffany

Alat baris perintah untuk merender ke TIFF gambar apa pun dari Google Static Maps

tiffany mengunduh, georeferensi, dan memberi label pada citra satelit apa pun dari Google Static Maps (API). Anda dapat menggunakan ini untuk menyiapkan data berlabel untuk tugas hilir seperti dalam visi komputer (deteksi objek, segmentasi semantik, dll.)

Fitur

• Unduh Gambar Google Static Maps langsung dari baris perintah

• Secara otomatis melakukan georeferensi gambar GSM yang diunduh (SRID: EPSG:4326 )

• Buat label pelatihan untuk gambar dengan memotong ESRI Shapefile

Dengan satu perintah,

 $tiffany14.546943935986324 121.01974525389744

Anda dapat menghasilkan output berikut untuk gambar yang berpusat di (14.54694524, 121.0197543253) . Perhatikan bahwa flag --with-labels memerlukan input ESRI Shapefile, sebaiknya dari OpenStreetMap (OSM).

Gambar asli	Bergeoreferensi	Dengan label
--without-reference	bawaan	--with-labels

Instalasi

Mendapatkan binari

Anda dapat memperoleh binari terbaru dari tab Rilis kami. Pastikan untuk mengunduh yang kompatibel dengan sistem Anda. Saat ini, kami hanya mengkompilasi pada arsitektur amd64:

	Linux (amd64)	Darwin (amd64)	jendela (amd64)
Terbaru	tiffany-terbaru-linux-amd64	tiffany-terbaru-darwin-amd64	tiffany-windows-terbaru-amd64
Malam	tiffany-nightly-linux-amd64	tiffany-nightly-darwin-amd64	tiffany-nightly-windows-amd64

Kompilasi dari sumber

Alternatifnya, Anda dapat mengkompilasi tiffany dari sumber. Anda memerlukan go1.11 dan GDAL>=2.0.0 untuk membuat build yang berhasil. Pertama, kloning repositori dan masukkan:

 $ git clone [email protected]:mesin berpikir/tiffany.git
$cdtiffany

Kemudian dapatkan dependensi dan bangun proyek:

 $ pergi ambil
$ pergi membangun.

Secara opsional, Anda juga dapat menginstal tiffany di dalam sistem Anda

 $ pergi instal

Penggunaan

Otentikasi

Tiffany memerlukan Kunci API Google Static Maps. Untuk request dalam jumlah besar, Tiffany juga membutuhkan Secret Key untuk menandatangani urlnya. Hasilkan menyimpannya di dalam file .tiffany.env di direktori proyek Anda:

 # .tiffany.envAPI_KEY="<kunci API Anda di sini>"SECRET_KEY="<kunci Rahasia Anda di sini"

Mendapatkan gambar

Untuk mendapatkan gambar, cukup panggil tiffany , lalu berikan lintang dan bujur Anda:

 $tiffany14.546943935986324 121.01974525389744

Anda dapat menyediakan file .tiffany.env dengan meneruskan jalur file ke parameter --env . Secara default, ini dicari dari root proyek Anda:

 $ tiffany 14.546943935986324 121.01974525389744 --env=jalur/ke/.tiffany.env

Perintah di atas akan menghasilkan direktori, tiffany.out di mana *.png dan file *.tiff terkait berada.

Jika Anda tidak menginginkan gambar yang memiliki georeferensi dan lebih memilih gambar PNG biasa, cukup berikan tanda --without-reference :

 $ tiffany 14.546943935986324 121.01974525389744 --tanpa referensi

Terakhir, Anda dapat membuat klip label untuk gambar yang direferensikan secara geografis dari ESRI Shapefile. Ini berguna untuk tugas-tugas hilir seperti dalam pembelajaran mesin:

 $ tiffany 14.546943935986324 121.01974525389744 --with-labels=path/ke/gis_osm_buildings_free_1.shp

Mendapatkan banyak gambar

Daripada menjalankan for-loop, Anda juga bisa mendapatkan banyak gambar dengan meneruskan file CSV yang berisi garis lintang dan bujur dari tempat menarik dalam perintah batch . Cara ini lebih efisien dan relatif lebih cepat:

# coordinates.csv
latitude,longitude
14.546943935986324,121.01974525389744
14.438494843958949,121.84324983413455
14.879847197948529,121.81851791571952

Kemudian,

 $ koordinat kumpulan tiffany.csv 

Berkontribusi

Cukup fork repositori ini dan buat Permintaan Tarik! Kami terbuka terhadap kontribusi apa pun, namun kami sangat menghargai:

• Implementasi fitur-fitur baru

• Menulis dokumentasi

• Pengujian

Selain itu, kami memiliki CONTRIBUTING.md dan Kode Etik, jadi silakan periksa yang itu!

Ucapan Terima Kasih

• Hak cipta data OSM kontributor OpenStreetMap dan berlisensi Open Database License

• Penggunaan Google Static Maps diatur oleh Ketentuan Penggunaan dan Ketentuan Layanan Tambahannya. Anda masih perlu mendapatkan kunci API untuk menggunakan layanan ini.

• Logo tiffany terinspirasi dari logo Twitch, dan didasarkan pada jenis font yang dibuat oleh MaxiGamer. Warnanya berdasarkan Gopher Blue ( #00ADD8 ) berdasarkan buku Golang Brand

Lisensi

Lisensi MIT (c) 2019, Ilmu Data Mesin Berpikir