dietrichmax/docker-staticmaps

어떤 프로젝트인가요?

핵심 기능

• 01정적 지도에 마커, 다각형, 원, 폴리라인, 텍스트 오버레이를 렌더링
• 02OpenStreetMap, Esri, Carto 베이스맵과 사용자 지정 타일 서버 지원
• 03Terrarium 인코딩 DEM 타일을 활용한 힐셰이드 오버레이 옵션 제공
• 04타일과 생성된 이미지 캐시
• 05IP별 요청 제한 적용 및 선택적 API 키 인증 지원
• 06브라우저 기반 플레이그라운드가 포함된 Docker 이미지 제공

활용 사례

• JavaScript 지도를 불러오지 않고 이메일, 보고서, 알림에 지도 미리보기 삽입
• 대시보드나 서버 사이드 렌더링 페이지에 사용할 위치 이미지 생성
• 경로, 영역 또는 여러 지점을 보여 주는 목록용 지도 썸네일 제작
• 자체 인프라에서 비공개 정적 지도 서비스 운영

빠른 시작

1. 1

   Docker로 API 실행하기

   docker run -p '3000:3000/tcp' mxdcodes/docker-staticmaps:latest
2. 2

   샘플 지도 이미지 요청하기

   curl "http://localhost:3000/api/staticmaps?width=1000&height=1000&center=-18.2871,147.6992&zoom=9&basemap=satellite"
3. 3

   브라우저에서 인터랙티브 플레이그라운드 열기

사용 전 알아둘 점

• !소스 코드는 AGPL-3.0+ 라이선스를 따르며, 수정한 뒤 호스팅할 경우 강력한 카피레프트 요건이 적용됩니다.

포함된 컬렉션

토픽

자주 묻는 질문

docker-staticmaps은(는) 무엇인가요?

마커, 다각형, 원, 폴리라인, 텍스트 오버레이를 표시하는 셀프 호스팅 가능한 정적 지도 이미지 렌더링 REST API입니다. Docker Static Maps API는 REST 엔드포인트를 통해 정적 지도 이미지를 생성하는 셀프 호스팅 서비스입니다. 요청 시 쿼리 문자열로 크기, 중심 좌표, 줌 수준, 베이스맵을 지정하고, 렌더링된 이미지에 마커, 다각형, 원, 폴리라인, 텍스트 오버레이를 추가할 수 있습니다.

docker-staticmaps은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

docker-staticmaps은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

docker-staticmaps은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. docker-staticmaps의 마지막 커밋은 2026년 11월 6일입니다.

docker-staticmaps은(는) 어디에 사용할 수 있나요?

JavaScript 지도를 불러오지 않고 이메일, 보고서, 알림에 지도 미리보기 삽입 대시보드나 서버 사이드 렌더링 페이지에 사용할 위치 이미지 생성 경로, 영역 또는 여러 지점을 보여 주는 목록용 지도 썸네일 제작 자체 인프라에서 비공개 정적 지도 서비스 운영

docker-staticmaps는 어떻게 설치하나요?

Docker로 API 실행하기: docker run -p '3000:3000/tcp' mxdcodes/docker-staticmaps:latest 샘플 지도 이미지 요청하기: curl "http://localhost:3000/api/staticmaps?width=1000&height=1000&center=-18.2871,147.6992&zoom=9&basemap=satellite" 브라우저에서 인터랙티브 플레이그라운드 열기

docker-staticmaps은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/dietrichmax/docker-staticmaps