tiffany
1.0.0
Una herramienta de línea de comandos para renderizar en TIFF cualquier imagen de Google Static Maps
tiffany descarga, georreferencia y etiqueta cualquier imagen de satélite de Google Static Maps (API). Puede utilizar esto para preparar datos etiquetados para tareas posteriores, como en visión por computadora (detección de objetos, segmentación semántica, etc.)
Descargue imágenes de Google Static Maps directamente desde la línea de comandos
Georreferenciar automáticamente imágenes GSM descargadas (SRID: EPSG:4326 )
Cree etiquetas de entrenamiento para las imágenes recortando un ESRI Shapefile
Con un solo comando,
$ tiffany 14.546943935986324 121.01974525389744
puede generar los siguientes resultados para una imagen centrada en (14.54694524, 121.0197543253) . Tenga en cuenta que el indicador --with-labels requiere una entrada ESRI Shapefile, preferiblemente de OpenStreetMap (OSM).
| imagen original | Georreferenciado | Con etiquetas |
|---|---|---|
 |  |  |
--without-reference | por defecto | --with-labels |
Puede obtener los archivos binarios más recientes en nuestra pestaña Lanzamientos. Asegúrese de descargar el compatible con su sistema. Por ahora, sólo compilamos en arquitecturas AMD64:
| Linux (amd64) | Darwin (amd64) | ventanas (amd64) | |
|---|---|---|---|
| El último | tiffany-último-linux-amd64 | tiffany-ultimo-darwin-amd64 | tiffany-últimas-ventanas-amd64 |
| Nocturno | tiffany-nightly-linux-amd64 | tiffany-nightly-darwin-amd64 | tiffany-nightly-windows-amd64 |
Alternativamente, puedes compilar tiffany desde la fuente. Necesita go1.11 y GDAL>=2.0.0 para crear compilaciones exitosas. Primero, clona el repositorio e ingresa en él:
$ git clon [email protected]:thinkingmachines/tiffany.git $ cd tiffany
Luego obtenga las dependencias y construya el proyecto:
$ ir a buscar $ ir a construir.
Opcionalmente, también puedes instalar tiffany dentro de tu sistema.
$ ir a instalar
Tiffany requiere una clave API de Google Static Maps. Para grandes cantidades de solicitudes, Tiffany también requiere una clave secreta para firmar la URL. Genera y guárdalos dentro de un archivo .tiffany.env en el directorio de tu proyecto:
# .tiffany.envAPI_KEY="<tu clave API aquí>"SECRET_KEY="<tu clave secreta aquí"
Para obtener imágenes, simplemente llame tiffany y pásele su latitud y longitud:
$ tiffany 14.546943935986324 121.01974525389744
Puede proporcionar el archivo .tiffany.env pasando la ruta del archivo al parámetro --env . De forma predeterminada, se busca desde la raíz de su proyecto:
$ tiffany 14.546943935986324 121.01974525389744 --env=ruta/a/.tiffany.env
El comando anterior generará un directorio, tiffany.out , donde se encuentra un *.png y su correspondiente archivo *.tiff .
En caso de que no desee imágenes georreferenciadas y prefiera imágenes PNG antiguas, simplemente pase la bandera --without-reference :
$ tiffany 14.546943935986324 121.01974525389744 --sin-referencia
Por último, puede recortar etiquetas para su imagen georreferenciada desde un ESRI Shapefile. Esto es útil para tareas posteriores, como en el aprendizaje automático:
$ tiffany 14.546943935986324 121.01974525389744 --with-labels=ruta/a/gis_osm_buildings_free_1.shp
En lugar de invocar un bucle for, también es posible obtener varias imágenes pasando un archivo CSV que contenga la latitud y longitud de los puntos de interés en el comando batch . Este método es más eficiente y relativamente más rápido:
# coordinates.csv latitude,longitude 14.546943935986324,121.01974525389744 14.438494843958949,121.84324983413455 14.879847197948529,121.81851791571952
Y luego,
$ coordenadas por lotes tiffany.csv
¡Simplemente bifurque este repositorio y haga una solicitud de extracción! Estamos abiertos a cualquier tipo de contribución, pero definitivamente apreciaríamos:
Implementación de nuevas características.
Redacción de documentación
Pruebas
Además, tenemos un CONTRIBUTING.md y un Código de conducta, ¡así que compruébalo!
Los datos de OSM tienen derechos de autor de los contribuyentes de OpenStreetMap y están bajo licencia de Open Database License.
El uso de Google Static Maps se rige por sus Términos de uso y Términos de servicio adicionales. Aún necesita adquirir una clave API para poder utilizar este servicio.
El logotipo de Tiffany se inspiró en el logotipo de Twitch y se basó en el tipo de fuente creado por MaxiGamer. El color está basado en Gopher Blue ( #00ADD8 ) según el libro de la marca Golang.
Licencia MIT (c) 2019, Ciencia de datos de Thinking Machines
