tiffany

Uma ferramenta de linha de comando para renderizar em TIFF qualquer imagem do Google Static Maps

tiffany baixa, georreferencia e rotula qualquer imagem de satélite do Google Static Maps (API). Você pode usar isso para preparar dados rotulados para tarefas posteriores, como visão computacional (detecção de objetos, segmentação semântica, etc.)

Características

• Baixe imagens estáticas do Google Maps diretamente da linha de comando

• Georreferenciar automaticamente imagens GSM baixadas (SRID: EPSG:4326 )

• Crie rótulos de treinamento para as imagens recortando um ESRI Shapefile

Com um único comando,

 $tiffany 14.546943935986324 121.01974525389744

você pode gerar as seguintes saídas para uma imagem centralizada em (14.54694524, 121.0197543253) . Observe que o sinalizador --with-labels requer um Shapefile ESRI de entrada, preferencialmente do OpenStreetMap (OSM).

Imagem original	Georreferenciado	Com rótulos
--without-reference	padrão	--with-labels

Instalação

Obtendo os binários

Você pode obter os binários mais recentes em nossa guia Releases. Certifique-se de baixar aquele compatível com o seu sistema. No momento, compilamos apenas em arquiteturas AMD64:

	Linux (amd64)	Darwin (amd64)	Janelas (amd64)
Mais recente	tiffany-mais recente-linux-amd64	tiffany-mais recente-darwin-amd64	tiffany-mais recente-windows-amd64
Todas as noites	tiffany-nightly-linux-amd64	tiffany-nightly-darwin-amd64	tiffany-nightly-windows-amd64

Compilando da fonte

Alternativamente, você pode compilar tiffany a partir do código-fonte. Você precisa de go1.11 e GDAL>=2.0.0 para criar compilações bem-sucedidas. Primeiro, clone o repositório e entre nele:

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

Em seguida, pegue as dependências e construa o projeto:

 $ vá buscar
$ vá construir.

Opcionalmente, você também pode instalar tiffany dentro do seu sistema

 $ vá instalar

Uso

Autenticação

A Tiffany requer uma chave de API do Google Static Maps. Para grandes quantidades de solicitações, a Tiffany também exige uma chave secreta para assinar o URL. Gere e armazene-os dentro de um arquivo .tiffany.env no diretório do seu projeto:

 # .tiffany.envAPI_KEY="<sua chave de API aqui>"SECRET_KEY="<sua chave secreta aqui"

Obtendo imagens

Para obter imagens, basta ligar para tiffany e passar sua latitude e longitude:

 $tiffany 14.546943935986324 121.01974525389744

Você pode fornecer o arquivo .tiffany.env passando o caminho do arquivo para o parâmetro --env . Por padrão, ele é pesquisado na raiz do seu projeto:

 $ tiffany 14.546943935986324 121.01974525389744 --env=caminho/para/.tiffany.env

O comando acima irá gerar um diretório, tiffany.out , onde um *.png e seu arquivo *.tiff correspondente estão localizados.

Caso você não queira imagens georreferenciadas e prefira imagens PNG antigas, basta passar o sinalizador --without-reference :

 $ tiffany 14.546943935986324 121.01974525389744 --sem referência

Por último, você pode recortar rótulos para sua imagem georreferenciada a partir de um ESRI Shapefile. Isso é útil para tarefas posteriores, como aprendizado de máquina:

 $ tiffany 14.546943935986324 121.01974525389744 --with-labels=caminho/para/gis_osm_buildings_free_1.shp

Obtendo várias imagens

Em vez de invocar um loop for, também é possível obter várias imagens passando um arquivo CSV contendo a latitude e longitude dos pontos de interesse no comando batch . Este método é mais eficiente e relativamente mais rápido:

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

E então,

 $ coordenadas de lote tiffany.csv 

Contribuindo

Simplesmente bifurque este repositório e faça um Pull Request! Estamos abertos a qualquer tipo de contribuição, mas definitivamente apreciaríamos:

• Implementação de novos recursos

• Escrevendo documentação

• Teste

Além disso, temos um CONTRIBUTING.md e um Código de Conduta, então dê uma olhada!

Agradecimentos

• Direitos autorais dos dados OSM, contribuidores do OpenStreetMap e licenciados sob Open Database License

• O uso do Google Static Maps é regido por seus Termos de Uso e Termos de Serviço Adicionais. Você ainda precisa adquirir uma chave API para usar este serviço.

• O logotipo tiffany foi inspirado no logotipo do Twitch e foi baseado no tipo de fonte criado pela MaxiGamer. A cor é baseada em Gopher Blue ( #00ADD8 ) baseada no livro da marca Golang

Licença

Licença MIT (c) 2019, Thinking Machines Data Science