Google 정적 지도의 이미지를 TIFF 로 렌더링하기 위한 명령줄 도구
tiffany
Google Static Maps(API)에서 모든 위성 이미지를 다운로드하고 지리 참조를 지정하며 라벨을 지정합니다. 이를 사용하여 컴퓨터 비전(객체 감지, 의미론적 분할 등)과 같은 다운스트림 작업을 위한 레이블이 지정된 데이터를 준비할 수 있습니다.
명령줄에서 바로 Google 정적 지도 이미지를 다운로드하세요.
다운로드된 GSM 이미지 자동 지리 참조(SRID: EPSG:4326
)
ESRI Shapefile을 클리핑하여 이미지에 대한 훈련 라벨 생성
단 하나의 명령으로,
$ 티파니 14.546943935986324 121.01974525389744
(14.54694524, 121.0197543253)
중심의 이미지에 대해 다음 출력을 생성할 수 있습니다. --with-labels
플래그에는 가급적 OpenStreetMap(OSM)의 입력 ESRI Shapefile이 필요합니다.
원본 이미지 | 지리적 참조 | 라벨 포함 |
---|---|---|
--without-reference | 기본 | --with-labels |
릴리스 탭에서 최신 바이너리를 얻을 수 있습니다. 시스템에 호환되는 것을 다운로드하십시오. 현재로서는 amd64 아키텍처에서만 컴파일합니다.
리눅스(amd64) | 다윈(amd64) | 윈도우(amd64) | |
---|---|---|---|
최신 | 티파니-최신-linux-amd64 | 티파니-최신-다윈-amd64 | 티파니-최신-windows-amd64 |
야간 | 티파니-나이틀리-리눅스-amd64 | 티파니-나이틀리-다윈-amd64 | 티파니-나이틀리-windows-amd64 |
또는 소스에서 tiffany
컴파일할 수도 있습니다. 성공적인 빌드를 생성하려면 go1.11 및 GDAL>=2.0.0이 필요합니다. 먼저 저장소를 복제하고 입력합니다.
$ git clone [email protected]:thinkingmachines/tiffany.git $ CD 티파니
그런 다음 종속성을 가져오고 프로젝트를 빌드합니다.
$ 가서 가져와 $ 가서 빌드하세요.
선택적으로 시스템 내부에 tiffany
설치할 수도 있습니다.
$ 설치하러 가기
Tiffany에는 Google Static Maps API 키가 필요합니다. 대량 요청의 경우 Tiffany는 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
위의 명령은 *.png
및 해당 *.tiff
파일이 있는 tiffany.out
디렉토리를 생성합니다.
지리참조 이미지를 원하지 않고 기존 PNG 이미지를 선호하는 경우 --without-reference
플래그를 전달하기만 하면 됩니다.
$ 티파니 14.546943935986324 121.01974525389744 --참조 없음
마지막으로 ESRI Shapefile에서 지리적 참조 이미지에 대한 레이블을 클리핑할 수 있습니다. 이는 기계 학습과 같은 다운스트림 작업에 유용합니다.
$ 티파니 14.546943935986324 121.01974525389744 --with-labels=path/to/gis_osm_buildings_free_1.shp
for 루프를 호출하는 대신 관심 지점의 위도와 경도가 포함된 CSV 파일을 batch
명령에 전달하여 여러 이미지를 얻을 수도 있습니다. 이 방법은 더 효율적이고 상대적으로 빠릅니다.
# 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 키를 획득해야 합니다.
티파니 로고는 트위치 로고에서 영감을 얻었으며, 맥시게이머(MaxiGamer)가 만든 글꼴 유형을 기반으로 했습니다. 색상은 Golang 브랜드 도서를 기반으로 한 Gopher Blue( #00ADD8
)를 기반으로 합니다.
MIT 라이센스 (c) 2019, Thinking Machines 데이터 과학