tiffany

Un outil de ligne de commande pour restituer au format TIFF n'importe quelle image de Google Static Maps

tiffany télécharge, géoréférence et étiquette n'importe quelle image satellite à partir de Google Static Maps (API). Vous pouvez l'utiliser pour préparer des données étiquetées pour des tâches en aval telles que la vision par ordinateur (détection d'objets, segmentation sémantique, etc.)

Caractéristiques

• Téléchargez des images Google Static Maps directement à partir de la ligne de commande

• Géoréférencement automatique des images GSM téléchargées (SRID : EPSG:4326 )

• Créez des étiquettes de formation pour les images en découpant un fichier Shapefile ESRI

Avec une seule commande,

 $ tiffany 14,546943935986324 121,01974525389744

vous pouvez générer les sorties suivantes pour une image centrée sur (14.54694524, 121.0197543253) . Notez que l'indicateur --with-labels nécessite un fichier Shapefile ESRI d'entrée, de préférence provenant d'OpenStreetMap (OSM).

Image originale	Géoréférencé	Avec des étiquettes
--without-reference	défaut	--with-labels

Installation

Obtenir les binaires

Vous pouvez obtenir les derniers binaires depuis notre onglet Releases. Assurez-vous de télécharger celui compatible avec votre système. Pour l'instant, nous compilons uniquement sur les architectures amd64 :

	Linux (amd64)	Darwin (amd64)	Windows (amd64)
Dernier	tiffany-dernier-linux-amd64	tiffany-dernier-darwin-amd64	tiffany-dernières-windows-amd64
Chaque nuit	tiffany-nightly-linux-amd64	tiffany-nightly-darwin-amd64	tiffany-nightly-windows-amd64

Compilation à partir des sources

Alternativement, vous pouvez compiler tiffany à partir des sources. Vous avez besoin de go1.11 et GDAL>=2.0.0 pour créer des builds réussis. Tout d'abord, clonez le référentiel et saisissez-le :

 $ git clone [email protected]:thinkingmachines/tiffany.git
$ cd tiffany

Ensuite, récupérez les dépendances et construisez le projet :

 $ va chercher
$ allez construire .

En option, vous pouvez également installer tiffany dans votre système

 $ allez installer

Usage

Authentification

Tiffany nécessite une clé API Google Static Maps. Pour un grand nombre de demandes, Tiffany a également besoin d'une clé secrète pour signer l'URL. Générez-les, stockez-les dans un fichier .tiffany.env dans le répertoire de votre projet :

 # .tiffany.envAPI_KEY="<votre clé API ici>"SECRET_KEY="<votre clé secrète ici"

Obtenir des images

Pour obtenir des images, appelez simplement tiffany et transmettez-lui votre latitude et votre longitude :

 $ tiffany 14,546943935986324 121,01974525389744

Vous pouvez fournir le fichier .tiffany.env en transmettant le chemin du fichier au paramètre --env . Par défaut, la recherche est effectuée à partir de la racine de votre projet :

 $ tiffany 14.546943935986324 121.01974525389744 --env=chemin/vers/.tiffany.env

La commande ci-dessus générera un répertoire, tiffany.out où se trouvent un *.png et son fichier *.tiff correspondant.

Si vous ne voulez pas d'images géoréférencées et préférez les anciennes images PNG, passez simplement l'indicateur --without-reference :

 $ tiffany 14.546943935986324 121.01974525389744 --sans référence

Enfin, vous pouvez découper les étiquettes de votre image géoréférencée à partir d'un Shapefile ESRI. Ceci est utile pour les tâches en aval telles que dans l'apprentissage automatique :

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

Obtenir plusieurs images

Plutôt que d'invoquer une boucle for, il est également possible d'obtenir plusieurs images en passant un fichier CSV contenant la latitude et la longitude des points d'intérêt dans la commande batch . Cette méthode est plus efficace et relativement plus rapide :

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

Et puis,

 $ coordonnées du lot Tiffany.csv 

Contribuer

Créez simplement ce référentiel et faites une Pull Request ! Nous sommes ouverts à tout type de contribution, mais nous apprécierions certainement :

• Implémentation de nouvelles fonctionnalités

• Rédaction de documentation

• Essai

De plus, nous avons un CONTRIBUTING.md et un code de conduite, alors veuillez vérifier celui-là !

Remerciements

• Les données OSM sont protégées par les droits d'auteur des contributeurs d'OpenStreetMap et sous licence Open Database License.

• L'utilisation de Google Static Maps est régie par ses conditions d'utilisation et ses conditions de service supplémentaires. Vous devez toujours acquérir une clé API pour pouvoir utiliser ce service.

• Le logo Tiffany a été inspiré du logo Twitch et basé sur le type de police créé par MaxiGamer. La couleur est basée sur Gopher Blue ( #00ADD8 ) basée sur le livre Golang Brand.

Licence

Licence MIT (c) 2019, Thinking Machines Data Science