ユーザーガイド
서비스
この章は現在韓国語のみで提供しています。
TASTEGEO 는 OGC 서비스 네 가지와 GeoServer 꼴의 REST API 를 냅니다. 기본 주소는 http://127.0.0.1:8081 이고, 다른 컴퓨터에 내보낼 때는 역방향 프록시 주소를 처음 켜기의 online_resource 에 적어 Capabilities 문서에 맞는 주소가 나오게 합니다.
모든 서비스는 부분 지원입니다. 주요 요청은 검증했지만 GeoServer 의 모든 선택 기능을 갖추지는 않았습니다. 기능별 호환 수준은 TASTEGEO 문서의 호환성 표에서 볼 수 있습니다.
주소
| 주소 | 내용 |
|---|---|
/ows | 서비스 공용 입구(SERVICE= 로 고름) |
/wms | WMS |
/wfs | WFS |
/gwc/service/wmts | WMTS(KVP 와 REST 타일 주소) |
/wcs | WCS |
/rest/... | 카탈로그 · 설정 REST API |
/health/live, /health/ready | 상태 점검(인증 없이) |
/metrics | Prometheus 형식 지표 |
WMS
- 판: 1.1.1, 1.3.0
- 요청:
GetCapabilities,GetMap,GetFeatureInfo,DescribeLayer,GetLegendGraphic - 스타일: SLD · SE(부분 지원)
관리 화면의 운영 › 지도 미리보기에서 워크스페이스 · 레이어 · 스타일을 골라 지도를 보고, 지도를 누르면 GetFeatureInfo 결과가 나옵니다.
WFS
- 판: 1.0.0, 1.1.0, 2.0.0
- 요청:
GetCapabilities,DescribeFeatureType,GetFeature,GetPropertyValue, 저장된 질의(stored query),Transaction,LockFeature,GetFeatureWithLock - WFS 2.0.2 프로필은 따로 켭니다(서버 환경에
GEOSERVER_RS_WFS_202=true). - 쓰기(Transaction)는 쓰기를 허용하는 저장소(PostGIS)에서만 됩니다. GeoPackage · Shapefile 은 읽기 전용입니다.
WMTS
- 판: 1.0.0
GetCapabilities,GetTile과 REST 타일 주소- 만든 타일은 타일 캐시 폴더에 남습니다. 타일 하나의 최대 크기(기본 4 MiB)와 캐시 전체 크기(기본 1 GiB)는 서버 환경
GEOSERVER_RS_TILE_CACHE_MAX_TILE_BYTES,GEOSERVER_RS_TILE_CACHE_MAX_TOTAL_BYTES로 바꿉니다.
WCS
- 판: 1.0.0(2.0.1 Capabilities 일부 포함)
- GeoTIFF · COG 커버리지를 냅니다.
REST API
GeoServer 와 같은 주소 꼴(/rest/...)로 카탈로그와 서비스 설정을 다룹니다. 응답은 .json 과 .xml 둘 다 됩니다.
| 대상 | 주소 예 | 할 수 있는 일 |
|---|---|---|
| 워크스페이스 · 네임스페이스 | /rest/workspaces, /rest/namespaces | 보기 · 만들기 · 수정 · 삭제 |
| 데이터스토어 · 피처 타입 | /rest/workspaces/<ws>/datastores/<ds>/featuretypes | 보기 · 만들기 · 수정 · 삭제 |
| 커버리지스토어 · 커버리지 | /rest/workspaces/<ws>/coveragestores/<cs>/coverages | 보기 · 만들기 · 수정 · 삭제 |
| 레이어 | /rest/layers, /rest/workspaces/<ws>/layers | 보기 · 수정 · 삭제(새로 만들기는 피처 타입 · 커버리지를 만들 때 함께) |
| 스타일 | /rest/styles, /rest/workspaces/<ws>/styles | SLD 로 보기 · 올리기 · 수정 · 삭제 |
| 레이어 그룹 | /rest/layergroups | 보기 · 만들기 · 수정 · 삭제 |
| 서비스 설정 | /rest/services/{wms,wfs,wmts,wcs}/settings | 보기 · 수정 |
| 서버 정보 | /rest/about/version, /rest/about/status, /rest/about/system-status | 보기 |
| 기타 | /rest/settings, /rest/logging, /rest/security/... 등 | 보기 |
| 운영 | /rest/reload, /rest/reset | 카탈로그 다시 읽기(Reload) · 초기 기준으로 되돌리기(Reset) |
REST 로 바꾼 내용이 다시 시작한 뒤에도 남으려면 상태 파일이 있어야 합니다. 설치 패키지는 이미 켜 두었습니다 (상태 저장과 복구).
REST 를 부르려면 관리자 권한이 필요합니다(인증과 보안). 브라우저 다른 사이트에서 보내는 쓰기 요청(Origin 머리글이 붙은 POST · PUT · PATCH · DELETE)은 거절합니다.
관리 화면에서 다루기
왼쪽 연결 트리의 워크스페이스 아래 화면들이 REST API 를 대신 부릅니다. 목록에서 항목을 고르면 상세(JSON)가 나오고, 등록 · 수정은 JSON(스타일은 SLD/XML, 파일로 올리기 가능)으로, 삭제는 이름을 한 번 더 입력해 확인합니다. 트리 노드를 오른쪽 단추로 눌러 바로 새로 만들기 · 수정 · 삭제 창을 열 수도 있습니다. 서비스 노드에서 서비스별 설정을 바꾸고 Capabilities 를 확인합니다.
다른 TASTEGEO · GeoServer 를 연결해 두면 같은 화면으로 그 서버의 카탈로그도 다룹니다(처음 켜기의 연결 관리).
상태 점검과 지표
/health/live— 프로세스가 살아 있는지/health/ready— 요청을 받을 준비가 되었는지(카탈로그를 읽었는지)/metrics— 요청 수 등 Prometheus 지표
서버 실행 파일로도 점검할 수 있습니다.
tastegeo-server --health-check준비되었으면 0 으로 끝납니다.