libgd-gis의 핵심 렌더링 API는 이제 안정화되어 프로덕션 환경에서 정적 지도 생성 워크플로우에 활용될 수 있습니다. 다음은 지리 데이터를 래스터 이미지로 렌더링하는 표준적인 방식의 주요 메서드들입니다.
핵심 렌더링 API 메서드
add_geojson: GeoJSON 파일을 순서가 지정된 레이어로 렌더링합니다. 각 호출은 새로운 레이어를 추가하며, 스타일링은 활성 YAML 스타일 파일로 제어됩니다. Point, LineString, Polygon 지오메트리를 지원합니다.- 레이어 순서는 명시적이고 결정적입니다.
- 스타일링은 활성 YAML 스타일로 완벽하게 제어됩니다.
- 지원되는 지오메트리는 Point, LineString, Polygon입니다.
add_lines: GPS 트랙, 경로, 분석 오버레이와 같은 프로그램적인 선 지오메트리를 렌더링합니다.- GPS 트랙
- 경로 및 패스
- 분석 오버레이
add_polygons: 구성 가능한 채우기 및 스트로크를 사용하여 다각형 영역을 렌더링합니다. 알파 투명도를 지원하며, 지오메트리는 좌표 배열로 직접 표현됩니다. 동적 또는 계산된 영역에 적합합니다.- 알파 투명도를 지원합니다.
- 지오메트리는 좌표 배열로 직접 표현됩니다.
- 동적 또는 계산된 영역에 사용됩니다.
add_points: POI(관심 지점), 레이블, 마커와 같은 점 기반 데이터를 렌더링합니다. 람다 기반 필드 매핑, 선택적 아이콘 및 레이블, 명시적 글꼴 처리를 제공합니다.- 람다 기반 필드 매핑
- 선택적 아이콘 및 레이블
- 명시적 글꼴 처리
지도 렌더링 및 후처리
모든 레이어와 오버레이가 정의되면 렌더링은 한 번만 수행됩니다. 렌더링 후, map.image 메서드를 통해 기본 GD::Image 객체에 접근하여 추가적인 이미지 조작이 가능합니다. 이는 제목 및 브랜딩 추가, 범례 및 주석, 워터마크 및 오버레이, 그리고 ruby-libgd가 지원하는 모든 이미지 작업에 활용될 수 있습니다.
애니메이션 지원 (알파-1)
애니메이션 맵 렌더링(예: 경로 재생, GIF 생성, 시뮬레이션된 지리 위치 추적)은 여전히 알파-1 단계의 실험적인 개발 중입니다. 애니메이션 관련 API는 아직 동결되지 않았으며, 성능, 메모리 사용량 및 렌더링 전략이 개선됨에 따라 변경될 수 있습니다.