tiffany

用於將 Google 靜態地圖中的任何影像渲染為 TIFF的命令列工具

tiffany從 Google 靜態地圖 (API) 下載、地理參考和標記任何衛星圖像。您可以使用它為下游任務準備標記數據，例如電腦視覺（物件檢測、語義分割等）

特徵

• 直接從命令列下載 Google 靜態地圖圖像

• 自動地理配準下載的 GSM 影像（SRID： EPSG:4326 ）

• 透過剪切 ESRI Shapefile 為圖像建立訓練標籤

只需一個命令，

 $ 蒂芬妮 14.546943935986324 121.01974525389744

您可以為以(14.54694524, 121.0197543253)為中心的影像產生下列輸出。請注意， --with-labels標誌需要輸入 ESRI Shapefile，最好來自 OpenStreetMap (OSM)。

原圖	地理參考	帶標籤
--without-reference	預設	--with-labels

安裝

取得二進位文件

您可以從我們的「發布」標籤取得最新的二進位檔案。確保下載與您的系統相容的版本。截至目前，我們僅在 amd64 架構上進行編譯：

	Linux（AMD64）	達爾文 (amd64)	Windows（AMD64）
最新的	蒂芬妮-最新-linux-amd64	蒂芬妮-最新-達爾文-amd64	蒂芬妮-最新-Windows-AMD64
每晚	tiffany-nightly-linux-amd64	蒂芬妮-每晚-達爾文-amd64	蒂芬妮-Nightly-Windows-AMD64

從原始碼編譯

或者，您可以從原始碼編譯tiffany 。您需要 go1.11 和 GDAL>=2.0.0 才能建立成功的建置。首先，克隆儲存庫並輸入：

 $ git克隆 [email protected]:thinkingmachines/tiffany.git
$ CD 蒂芙尼

然後獲取依賴項並建置專案：

 $ 去獲取
$ 去建構 .

或者，您也可以在系統中安裝tiffany

 $ 去安裝

用法

驗證

Tiffany 需要 Google 靜態地圖 API 金鑰。對於大量請求，Tiffany 還需要一個 Secret Key 來對 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

上面的指令將產生一個目錄tiffany.out ，其中包含*.png及其對應的*.tiff檔。

如果您不想要地理參考圖像並且更喜歡普通的 PNG 圖像，那麼只需傳遞--without-reference標誌即可：

 $ 蒂芙尼 14.546943935986324 121.01974525389744 --無參考

最後，您可以從 ESRI Shapefile 剪輯地理參考影像的標籤。這對於機器學習等下游任務很有用：

 $ 蒂芬妮 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 貢獻者所有，並根據開放資料庫授權

• Google 靜態地圖的使用受其使用條款和附加服務條款的約束。您仍然需要取得 API 金鑰才能使用此服務。

• 蒂芙尼徽標的靈感來自於 Twitch 徽標，並基於 MaxiGamer 創建的字體類型。顏色基於 Gopher Blue ( #00ADD8 )，來自 Golang 品牌手冊

執照

麻省理工學院許可證 (c) 2019，思維機器資料科學