3.1. 기본 사항

이 장에서는 서비스들이 공통적으로 공유하는 개념과 파라미터를 설명합니다. 이들 가운데 일부는 OGC 사양 표준으로 정의되어 있지만 일부는 QGIS 서버에 매우 특화되어 있습니다.

표준 개념:

개념

설명

SERVICE

서비스 이름

REQUEST

요청 이름

판매자 개념:

개념

설명

MAP

QGIS 프로젝트 파일

FILE_NAME

다운로드한 파일의 파일명

단축명

단축명 정의

3.1.1. SERVICE

이 표준 파라미터를 통해 특정 요청 에 대해 사용할 서비스의 이름을 지정할 수 있습니다. 파라미터 서식은 SERVICE=NAME 과 같아야 합니다.

다음은 WMS 서비스의 URL 예시입니다:

http://localhost/qgisserver?
SERVICE=WMS
&...

참고

WFS3 (OGC 피처 API) 같은 REST 기반 서비스에는 사용할 수 없습니다.

3.1.2. REQUEST

이 표준 파라미터를 통해 특정 서비스 에 대해 실행할 요청의 이름을 지정할 수 있습니다. 파라미터 서식은 REQUEST=RequestName 과 같아야 합니다.

다음은 GetCapabilities 요청의 URL 예시입니다:

http://localhost/qgisserver?
REQUEST=GetCapabilities
&...

참고

WFS3 (OGC 피처 API) 같은 REST 기반 서비스에는 사용할 수 없습니다.

3.1.3. MAP

이 판매자 파라미터를 통해 사용할 QGIS 프로젝트 파일을 정의할 수 있습니다. 절대 경로로 정의할 수도 있고, 서버의 qgis_mapserv.fcgi 실행 파일 위치를 기준으로 하는 상대 경로로 정의할 수도 있습니다. 기본적으로, MAP 은 필수적으로 정의해야 합니다. 요청이 실제로 작동하려면 QGIS 프로젝트가 필요하기 때문입니다. 하지만 기본 QGIS 프로젝트를 정의하는 데 QGIS_PROJECT_FILE 환경 변수가 쓰일 수도 있습니다. 이런 특정한 경우, MAP 은 더 이상 필수적인 파라미터가 아닙니다. 더 자세한 정보는 고급 환경 설정 장을 참조하세요.

URL 예시:

http://localhost/qgisserver?
MAP=/tmp/QGIS-Training-Data/exercise_data/qgis-server-tutorial-data/world.qgs
&...

3.1.4. FILE_NAME

이 판매자 파라미터를 설정하면, 서버 응답을 지정한 파일명을 가진 첨부 파일로 클라이언트에 전송할 것입니다.

다음은 XML GetCapabilities 문서를 저장하는 URL 예시입니다:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetCapabilities
&FILE_NAME=wms_capabilities.xml
&...

참고

WFS3 (OGC 피처 API) 같은 REST 기반 서비스에는 사용할 수 없습니다.

3.1.5. 단축명

많은 요소들이 단축명(short name) 과 제목(title) 을 둘 다 가지고 있습니다. 단축명이란 기계 간 통신(machine-to-machine communication)에 쓰이는 텍스트 문자열을 말하고, 제목은 사람이 읽을 수 있는 문자열을 뜻합니다. 예를 들어 어떤 데이터셋이 “최고 기온(Maximum Atmospheric Temperature)” 같은 서술적인 제목을 가지고 있으면서도 데이터셋 요청 시에는 “ATMAX” 같은 단축명을 쓸 수도 있습니다. 사용자는 다음 요소에 대해 제목, 단축명, 요약을 설정할 수 있습니다:

  • 레이어: 레이어를 오른쪽 클릭하고 Properties… ► QGIS Server ► Description 메뉴 항목을 선택하십시오.

  • 그룹: 그룹을 오른쪽 클릭하고 Set Group WMS data 메뉴 항목을 선택하십시오.

  • 프로젝트: Project ► Properties… ► QGIS Server ► Service Capabilities 메뉴를 선택하십시오.

../../../_images/set_group_wms_data.png

그림 3.1 그룹 WMS 데이터 설정 대화창

즉 QGIS 서버와 대화형 작업을 할 때 이런 항목들을 식별하기 위해 단축명이 쓰일 수도 있습니다. 다음은 표준 LAYERS 파라미터를 사용해서 요청할 레이어를 지정하는 URL 예시입니다:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&LAYERS=shortname1,shortname2
&...