Скачать tiffany - скачать исходный код tiffany

tiffany

Другой исходный код

1.0.0

Скачать

Инструмент командной строки для рендеринга в TIFF любого изображения из статических карт Google.

tiffany загружает, геопривязывает и маркирует любые спутниковые изображения из статических карт Google (API). Вы можете использовать это для подготовки помеченных данных для последующих задач, таких как компьютерное зрение (обнаружение объектов, семантическая сегментация и т. д.).

Функции

Загрузите изображения статических карт Google прямо из командной строки.
Автоматическая географическая привязка загруженных изображений GSM (SRID: EPSG:4326 ).
Создайте обучающие метки для изображений, вырезав шейп-файл ESRI.

С помощью одной команды,

 $ Тиффани 14.546943935986324 121.01974525389744

вы можете сгенерировать следующие выходные данные для изображения с центром в (14.54694524, 121.0197543253) . Обратите внимание, что для флага --with-labels требуется входной шейп-файл ESRI, желательно из OpenStreetMap (OSM).

Исходное изображение	с географической привязкой	С этикетками

`--without-reference`	по умолчанию	`--with-labels`

Установка

Получение двоичных файлов

Вы можете получить последние двоичные файлы на вкладке «Релизы». Обязательно загрузите тот, который совместим с вашей системой. На данный момент мы компилируем только на архитектурах amd64:

	Линукс (amd64)	Дарвин (amd64)	Windows (amd64)
Последний	Тиффани-последний-Linux-amd64	Тиффани-последний-Дарвин-AMD64	Тиффани-последние-Windows-amd64
Ночью	Тиффани-ночь-Linux-amd64	Тиффани-найтли-дарвин-amd64	Тиффани-ночь-окна-amd64

Компиляция из исходников

Альтернативно, вы можете скомпилировать tiffany из исходников. Для создания успешных сборок вам нужны go1.11 и GDAL>=2.0.0. Сначала клонируйте репозиторий и войдите в него:

 $ git clone [email protected]:thinkingmachines/tiffany.git
$ компакт-диск Тиффани

Затем получите зависимости и соберите проект:

 $ иди возьми
$ иди строй.

При желании вы также можете установить tiffany внутри своей системы.

 $ пойти установить

Использование

Аутентификация

Для Tiffany требуется ключ API статических карт Google. Для больших объемов запросов Tiffany также требуется секретный ключ для подписи URL-адреса. Создайте и сохраните их в файле .tiffany.env в каталоге вашего проекта:

 # .tiffany.envAPI_KEY="<ваш ключ API здесь>"SECRET_KEY="<ваш секретный ключ здесь"

Получение изображений

Чтобы получить изображения, просто позвоните tiffany и передайте ему свою широту и долготу:

 $ Тиффани 14.546943935986324 121.01974525389744

Вы можете предоставить файл .tiffany.env , передав путь к файлу в параметре --env . По умолчанию поиск осуществляется в корне вашего проекта:

 $ Тиффани 14.546943935986324 121.01974525389744 --env=path/to/.tiffany.env

Приведенная выше команда создаст каталог tiffany.out , в котором находится файл *.png и соответствующий ему файл *.tiff .

Если вам не нужны изображения с географической привязкой и вы предпочитаете обычные PNG-изображения, просто передайте флаг --without-reference :

 $ Тиффани 14.546943935986324 121.01974525389744 --без ссылки

Наконец, вы можете вырезать метки для изображения с географической привязкой из шейп-файла ESRI. Это полезно для последующих задач, таких как машинное обучение:

 $ Тиффани 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 и лицензируются по лицензии Open Database License.
Использование Статических карт Google регулируется Условиями использования и Дополнительными условиями обслуживания. Чтобы использовать эту услугу, вам все равно необходимо получить ключ API.
Логотип Tiffany был вдохновлен логотипом Twitch и основан на шрифте, созданном MaxiGamer. Цвет основан на Gopher Blue ( #00ADD8 ) из книги брендов Golang.