GPKG – 지오패키지 래스터

드라이버 단축 이름

GPKG

빌드 의존성

libsqlite3 (그리고 PNG, JPEG, WEBP 드라이버 가운데 하나 또는 전부)

이 드라이버는 OGC 지오패키지(GeoPackage) 포맷 표준 래스터 타일을 담고 있는 테이블의 완전한 읽기/생성/업데이트를 구현합니다. 지오패키지 표준은 SQLite 데이터베이스 파일을 일반 컨테이너로 사용하며, 다음을 정의하고 있습니다:

• 예상 메타데이터 테이블 (gpkg_contents, gpkg_spatial_ref_sys, gpkg_tile_matrix, gpkg_tile_matrix_set 등등)

• 타일 포맷 인코딩(기반 사양은 PNG와 JPEG, 확장 사양은 WebP) 및 타일 작업 규범

• 확장자 명명 및 규범

이 드라이버는 파일 시스템에서 SQLite 파일을 읽고 쓰기 때문에, 작업 파일에 읽기/쓰기 접근 권한을 가진 사용자가 이 드라이버를 실행해야만 합니다.

이 드라이버는 지오패키지 벡터도 처리할 수 있습니다. 지오패키지 벡터 문서도 읽어보십시오.

다양한 입력 데이터셋 유형을 지오패키지 래스터로 변환할 수 있습니다:

• 회색조 수준 단일 밴드

• RGB 또는 RGBA 색상표를 가진 단일 밴드

• 2밴드: 첫 번째 밴드는 회색조 수준, 두 번째 밴드는 알파 채널

• 3밴드: 적색(Red), 녹색(Green), 청색(Blue)

• 4밴드: 적색(Red), 녹색(Green), 청색(Blue), 알파(Alpha)

지오패키지 래스터는 바이트 데이터 유형만 지원합니다.

지오패키지 사양으로 표준화된 모든 래스터 확장자를 읽기 및 생성 지원합니다:

• gpkg_webp: WebP 타일을 저장하는 경우, GDAL이 libwebp를 대상으로 컴파일되었다고 가정

• gpkg_zoom_other: 연속하는 확대/축소 수준들의 해상도가 2배수로 변화하지 않는 경우

드라이버 케이퍼빌리티

CreateCopy() 지원

이 드라이버는 GDALDriver::CreateCopy() 작업을 지원합니다.

Create() 지원

이 드라이버는 GDALDriver::Create() 작업을 지원합니다.

지리참조 작업 지원

이 드라이버는 지리참조 작업을 지원합니다.

VirtualIO 지원

이 드라이버는 virtual I/O operations (/vsimem/, etc.) 를 지원합니다.

열기 옵션

이 드라이버는 기본적으로 지오패키지 데이터셋을 최대한 다양한 인코딩으로 타일을 저장할 수 있는 능력을 가진 4밴드(RGBA) 데이터셋으로 노출시킵니다. BAND_COUNT 열기 옵션으로 밴드 개수를 명확하게 지정할 수 있습니다.

이 드라이버는 gpkg_contents 테이블에 지정된 지리/투영 범위를 사용하는데, 해당 범위를 따르기 위해 필요하다면 잘라내기 작업을 수행할 것입니다. 하지만 이 정보는 선택적인 옵션으로, 이 옵션이 없을 경우 gpkg_tile_matrix_set 이 제공하는, 모든 확대/축소 수준의 범위를 커버하는 범위를 사용할 것입니다. 사용자가 최대 확대/축소 수준의 실제 타일 범위를 사용하려는 경우 USE_TILE_EXTENT=YES 열기 옵션을 지정하면 됩니다. 또는 사용자 지정 범위를 사용하려면 MINX/MINY/MAXX/MAXY 가운데 어떤 것이든 지정하면 됩니다.

다음 열기 옵션들을 사용할 수 있습니다:

• TABLE=table_name: 타일을 담고 있는 테이블의 이름입니다. (지오패키지 사양 용어로는 “타일 피라미드 사용자 데이터 테이블” 이라고 합니다.) 지오패키지 데이터셋이 테이블 하나만 담고 있는 경우, 이 옵션은 필요없습니다. 테이블이 하나 이상이라면 필수입니다.

• ZOOM_LEVEL=value: 0에서 gpkg_tile_matrix 테이블의 최대값 사이의 정수값입니다. 이 드라이버는 기본적으로 래스터 테이블에서 해당 확대/축소 수준의 타일을 최소한 1개는 찾도록 최대 확대/축소 수준을 선택할 것입니다.

• BAND_COUNT=1/2/3/4: 데이터셋을 연 다음 노출되는 밴드 개수입니다. 구현되어 있고 사용할 수 있는 경우 몇몇 변환 작업을 수행할 것이지만, BAND_COUNT 값과 타일의 밴드 개수에 따라 실패하는 경우도 생길 수 있습니다. 기본값은 (언제나 안전한 값인) 4입니다.

• MINX=value: 관심 영역의 최소 경도/편동(easting)입니다.

• MINY=value: 관심 영역의 최소 위도/편북(northing)입니다.

• MAXX=value: 관심 영역의 최대 경도/편동(easting)입니다.

• MAXY=value: 관심 영역의 최대 위도/편북(northing)입니다.

• USE_TILE_EXTENT=YES/NO: 전체 해상도 데이터셋의 확대/축소 수준의 실제 기존 타일들의 범위를 사용할지 여부를 선택합니다. 기본값은 NO입니다.

• TILE_FORMAT=PNG_JPEG/PNG/PNG8/JPEG/WEBP: 타일을 저장하기 위해 쓰이는 포맷입니다. 타일 포맷 단락을 참조하십시오. 업데이트 모드에서만 사용합니다. 기본값은 PNG_JPEG입니다.

• QUALITY=1-100: JPEG 및 WEBP 압축의 경우 품질을 설정합니다. 업데이트 모드에서만 사용합니다. 기본값은 75입니다.

• ZLEVEL=1-9: PNG 타일 용 DEFLATE 압축 수준을 설정합니다. 업데이트 모드에서만 사용합니다. 기본값은 6입니다.

• DITHER=YES/NO: (TILE_FORMAT=PNG8일 때) 플로이드-스타인버그 디더링(Floyd–Steinberg dithering)을 사용할지 여부를 선택합니다. 업데이트 모드에서만 사용합니다. 기본값은 NO입니다.

주의: 대부분의 GDAL 유틸리티에서는 일반적으로 오픈 옵션을 “-oo name=value” 문법 또는 GDALOpenEx() API 호출로 지정합니다.

생성 문제점

이 드라이버는 입력 데이터셋의 밴드 개수와 선택한 타일 포맷에 따라 타일 포맷을 호환시키기 위한 필수 변환 작업을 수행할 것입니다.

지오패키지 데이터셋에 타일 테이블 여러 개를 (GDAL 하위 데이터셋으로 간주해서) 추가하려면, 또는 기존 벡터 전용 지오패키지에 타일 테이블을 추가하려면, 일반 APPEND_SUBDATASET=YES 생성 옵션을 반드시 지정해야만 합니다.

포맷이 허용하는 대로, 완전히 투명한 타일은 데이터베이스에 작성되지 않을 것입니다.

이 드라이버는 Create() 및 IWriteBlock()을 구현하기 때문에, 래스터 블록을 임의 작성할 수 있습니다. 지오패키지를 gdalwarp 같은 유틸리티의 산출 데이터셋으로 직접 사용할 수 있다는 뜻입니다.

생성 작업 시, SetGeoTransform()으로 지리변형 행렬을 설정한 경우에만 래스터 블록을 작성할 수 있습니다. 픽셀 해상도, 데이터셋, 그리고 타일 크기를 바탕으로 전체 해상도 데이터셋의 확대/축소 수준을 결정하기 위해서는 실질적으로 지리변형 행렬이 필요합니다.

기술/구현 메모: 데이터셋을 기본값이 아닌 관심 영역으로 여는 경우 (예를 들어 MINX,MINY,MAXX,MAXY 또는 USE_TILE_EXTENT 열기 옵션을 사용하는 경우) 또는 데이터셋을 사용자 지정(custom)이 아닌 타일 작업 스키마로 생성/열기하는 경우, GDAL 블록들이 단일 지오패키지 타일과 정확히 일치하지 않을 가능성이 있습니다. 이런 경우, 각 GDAL 블록이 지오패키지 타일 4개와 중첩할 것입니다. 읽어오는 경우에는 쉽게 처리할 수 있지만, 생성/업데이트하는 경우에는 이런 환경설정이 수많은 타일들을 압축 해제/재압축시켜야 하는 상황을 일으킬 수 있습니다. 이런 상황이 발생하면 손실 압축 방식(JPEG, WebP)을 사용하는 경우 불필요한 품질 저하가 일어날 수도 있습니다. 이렇게 되는 일을 피하기 위해, 이 드라이버는 주 지오패키지 테이블 외에 부분 지오패키지 타일들을 비손실 (그리고 비압축) 방식으로 저장하기 위한 임시 데이터베이스를 생성할 것입니다. 그리고 타일이 자신의 4분면 및 모든 밴드의 데이터를 받은 다음 (또는 데이터셋을 닫거나, 캐시에서 데이터셋을 FlushCache()로 확실하게 제거한 다음) 지오패키지 테이블에 이 비압축 타일들을 적절한 방식으로 압축해서 확실히 전송합니다. GDAL API/유틸리티 사용자에게 이 모든 과정을 공개합니다.

이 드라이버는 파일 생성 또는 수정 시 지오패키지 last_change 타임스탬프를 업데이트합니다. 재현성(reproducibility)을 위해 일관적인 바이너리 산출물이 필요한 경우, 전체 수준 환경설정 옵션 OGR_CURRENT_DATE 를 설정하면 타임스탬프를 특정값으로 설정하도록 강제할 수 있습니다. 이 옵션을 설정할 때 지오패키지 표준, 예를 들어 1.2버전 의 특정한 시간 서식 요구 사항을 만족시키도록 주의하십시오.

타일 포맷

타일 래스터

지오패키지는 타일을 서로 다른 포맷으로 저장할 수 있습니다. PNG 그리고/또는 JPEG을 기본 사양으로 사용하고, WebP를 확장 지오패키지 사양으로 사용합니다. 이런 타일 포맷 지원은 GDAL에서 기저 드라이버를 사용할 수 있는지에 따라 달라집니다. PNG와 JPEG의 경우 일반적으로 기저 드라이버를 사용할 수 있지만, WebP의 경우 GDAL이 선택적인 libwebp를 대상으로 컴파일되어야 하기 때문에 기저 드라이버를 반드시 사용할 수 있다고 장담할 수는 없습니다.

GDAL은 기본적으로 PNG와 JPEG을 혼합해서 사용할 것입니다. 입력 데이터셋이 완전히 불투명하지 않은 내용을 가진 알파 밴드를 가졌거나, 래스터의 우측 또는 하단 경계에서 래스터를 잘라냈거나, 데이터셋을 기본값이 아닌 관심 영역으로 또는 사용자 지정(custom)이 아닌 타일 작업 스키마로 열었기 때문에 완전히 불투명하지 않아진 타일을 저장하기 위해 PNG 파일을 사용할 것입니다. 그 반대로, 완전히 불투명한 타일은 JPEG으로 저장할 것입니다.

TILE_FORMAT 생성/열기 옵션을 PNG, JPEG 또는 WEBP 가운데 하나로 설정하면 유일한 타일 포맷 하나만 선택할 수도 있습니다. JPEG을 선택한 경우, 알파 채널을 저장하지 않을 것입니다. WebP를 선택한 경우, gpkg_webp 확장자를 등록할 것입니다. WebP의 손실 압축 방식을 사용합니다. WebP 타일에서 알파 채널을 지원하려면 최신 (0.1.4버전 이상의) libwebp을 사용해야만 한다는 사실을 기억하십시오.

256색까지 지원하는 색상표를 가진 8비트 PNG를 사용하려면 PNG8을 선택하면 됩니다. 생성 작업 시, 각 타일에 최적화된 색상표를 계산합니다. 플로이드-스타인버그 디더링 알고리즘을 사용하려면 DITHER 옵션을 YES로 설정하면 됩니다. 이 알고리즘은 더 나은 렌더링을 위해 양자화 오류를 이웃하는 픽셀로 분산시킵니다. (하지만 이미지 확대 시 시각적으로 바람직하지 않은 결과를 보게 될 수 있다는 사실을 기억하십시오.) 일반적으로, DITHER 옵션을 YES로 설정하면 더 비효율적으로 압축하게 될 것입니다. 이때 8비트 PNG 같은 포맷은 완전히 불투명한 타일에만 사용된다는 사실을 기억하십시오. (PNG8 포맷이 투명도를 가진 색상표를 지원할 수는 있지만) 현재 최적 색상표를 계산하기 위해 구현된 중앙값 절단(Median Cut) 알고리즘이 알파 채널을 지원하지 않기 때문입니다. 따라서 PNG8을 선택하는 경우, 완전히 불투명하지 않은 타일은 32비트 PNG로 저장될 것입니다.

타일 그리드화된 커버리지 데이터

GDAL 2.3버전부터, (부동소수점 데이터 유형으로 표현될 수 있도록 해주는 잠재적인 오프셋과 척도를 가진) PNG 부호 없는 16비트 타일, 또는 TIFF 32비트 부동소수점형 LZW 압축 타일을 이용해서 타일 그리드화 커버리지 데이터 를 저장할 수 있습니다.

GDAL Int16 또는 UInt16 데이터셋으로 변환 시, PNG 타일을 사용할 것입니다. GDAL Float32 데이터셋으로 변환 시, 명확하게 PNG를 지정하지 않는 한, 기본적으로 TIFF 타일을 사용할 것입니다. 명확하게 PNG를 지정한 경우, 각 타일에 대해 크기 조정 및 오프셋을 자동으로 계산할 것입니다.

Warning

처음으로 GDAL 2.2버전에 구현되었던 타일 그리드화 확장 은 공식적으로 도입된 것이 아니어서, 후에 OGC가 재작업했습니다. 이때 도입된 타일 그리드화 커버리지 데이터 에는 몇 가지 차이점이 있기 때문에, GDAL 2.2 데이터셋이 최종 확장 사양과 호환되지 않을 것입니다. GDAL 2.3버전에서 이런 GDAL 2.2 생성 파일을 열 수 있습니다.

타일 작업 스키마

기본적으로, 지오패키지로 변환 시 (PNG 같은 비손실 타일 포맷을 사용하는 경우) 입력 데이터를 픽셀 및 지리참조 두 수준에서 손실 없이 변환할 수 있는 사용자 지정 타일 작업 스키마를 생성하게 됩니다. 이 타일 작업 스키마는 gpkg_tile_matrix_set 에 있는 타일 원점(min_x, max_y)이 데이터셋의 좌상단 모서리와 정확히 일치하고, gpkg_tile_matrix 테이블의 계산된 최대 확대/축소 수준에서 선택된 해상도(pixel_x_size, pixel_y_size)가 래스터의 픽셀 너비 및 높이와 일치하도록 생성됩니다.

하지만 구현된 다른 기능과 작업 호환을 쉽게 하려면 그리고 지오패키지를 타일 서비스 소프트웨어와 함께 사용할 수 있도록 하려면, 지구 전체를 커버하는, 사전 정의된 다음과 같은 타일 작업 스키마를 사용할 수도 있습니다:

• GoogleMapsCompatible, WMTS 1.0 사양에서 설명하는 Annex E.4입니다. 이 타일 작업 스키마는 [-20037508.34,20037508.34] 사이에 있는 편동과 편북 단위의 범위를 가진 EPSG:3857 좌표계의 확대/축소 0수준에서 크기 256x256인 단일 타일로 이루어져 있습니다.

• InspireCRS84Quad, 인스파이어 뷰 서비스(Inspire View Services) 문서에서 설명하는 이 타일 작업 스키마는 [-180,180] 사이에 있는 경도와 [-90,90] 사이에 있는 위도 단위의 범위를 가진 EPSG:4326 좌표계의 확대/축소 0수준에서 크기 256x256인 타일 2개로 이루어져 있습니다.

• PseudoTMS_GlobalGeodetic, 이 타일 작업 스키마는 OSGeo TMS(Tile Map Service) 사양의 global-geodetic 프로파일을 기반으로 합니다. 이 스키마는 InspireCRS84Quad 타일 작업 스키마와 정확히 동일하게 정의됩니다. 하지만 TMS가 좌하단 모서리를 원점으로 사용하는 반면 지오패키지는 (WMTS 규범을 준수하도록) 좌상단 모서리를 타일 번호 원점으로 삼기 때문에 TMS와 완전한 작업 호환은 불가능하다는 사실을 기억하십시오.

• PseudoTMS_GlobalMercator, 이 타일 작업 스키마는 OSGeo TMS(Tile Map Service) 사양의 global-mercator 프로파일을 기반으로 합니다. 이 타일 작업 스키마는 [-20037508.34,20037508.34] 사이에 있는 편동과 편북 단위의 범위를 가진 EPSG:3857 좌표계의 확대/축소 0수준에서 크기 256x256인 타일 4개로 이루어져 있습니다. TMS와의 작업 호환성에 대해서는 PseudoTMS_GlobalGeodetic과 동일합니다.

• GoogleCRS84Quad, OGC 07-057r7 WMTS 1.0 사양에서 설명하는 Annex E.3입니다. 이 타일 작업 스키마는 [-180,180] 사이에 있는 경도와 위도 단위의 범위를 가진 EPSG:4326 좌표계의 확대/축소 0수준에서 크기 256x256인 단일 타일로 이루어져 있습니다. 그 결과 확대/축소 0수준에서 해당 타일의 최상단 및 최하단에 있는 라인 64개를 사용하지 않습니다. 이로 인해 몇몇 사양 구현에 문제가 생길 수도 있고, 이 타일 작업 스키마의 정확한 정의가 약간 모호해지기도 합니다. 따라서 이 스키마 대신 InspireCRS84Quad 또는 PseudoTMS_GlobalGeodetic 스키마를 사용하도록 권장합니다.

  주의: OGC WMTS 단순 프로파일 13-082r2 부터 GoogleCRS84Quad 정의를 변경했습니다. (즉 드라이버에 구현되지 않았습니다.) 이 새로운 정의는 원점이 (-180,90)이고 최하단 라인 128개가 비어 있는 단일 타일을 가진 -1수준을 포함합니다. (지오패키지의 zoom_level은 0부터 시작하는 양의 값이기 때문에, 지오패키지에서 이 정의를 모델링할 수 없습니다.) 0수준부터는 InspireCRS84Quad 타일 작업 스키마와 동일합니다. 따라서 실용적인 목적을 위해, 지오패키지의 InspireCRS84Quad는 새로운 GoogleCRS84Quad 정의를 준수합니다.

이 모든 사전 정의 타일 작업 스키마에서, 연속되는 확대/축소 수준은 2배수의 해상도만큼씩 달라집니다.

GDAL 3.2버전부터, `OGC 2차원 타일 행렬 집합 표준`_ 에 따라 JSON 파일로 인코딩된 타일 행렬 집합 정의도 사용할 수 있습니다. http://schemas.opengis.net/tms/1.0/json/examples/ 에서 이런 파일의 예시를 찾아볼 수 있습니다. GDAL data 디렉터리도 tms_ 접두어와 .json 확장자를 가진 파일들을 담고 있습니다. tms_FOO.json 파일이 존재한다면, FOO 를 TILING_SCHEME 생성 옵션의 값으로 사용할 수 있습니다. 지원하는 타일 행렬 집합의 유형에 대한 제약 조건이 존재합니다:

• 모든 확대/축소 수준이 동일한 원점이어야만 합니다.

• 연속되는 확대/축소 수준은 2배수의 해상도만큼씩 달라집니다.

• 모든 확대/축소 수준이 동일한 타일 크기여야만 합니다.

• 변동(variable) 행렬 너비 타일 집합은 지원하지 않습니다.

NODATA 값

타일 그리드화 표고 데이터셋만 NODATA 값이라는 개념을 지원합니다. 정규 타일 래스터의 경우, NODATA 대신 알파 밴드를 사용해야만 합니다.

TIFF 타일을 가진 Float32 데이터셋이라면, GDAL에서의 NODATA 개념과 지오패키지 내부의 null_value가 정확하게 일치합니다.

PNG 타일을 가진 Int16, UInt16 또는 Float32 데이터셋의 경우, GDAL은 보통 입력 NODATA 값을 또다른 값으로 다시 매핑할 것입니다.

PNG 타일의 경우, 작성 시 습성이 다음과 같습니다:

PNG 타일 작성 습성

GDAL 데이터 유형	입력 GDAL NODATA 값	GPKG gpkg_2d_gridded_coverage_ancillary의 null_value
Int16	모든 값	65535
UInt16	X (커버리지 오프셋이 0이고 커버리지 척도가 1인 경우)	X
Float32	모든 값	65535

PNG 타일의 경우, 읽기 시 습성이 다음과 같습니다:

PNG 타일 읽기 습성

GDAL 데이터 유형	GPKG gpkg_2d_gridded_coverage_ancillary의 null_value	노출된 GDAL NODATA 값
Int16	32768 이상	-32768
Int16	X (32767 이하)	X
UInt16	X	X
Float32	X	X

따라서, 다음과 같은 경우 완벽한 (데이터를 내보냈다가 손실 없이 무결하게 다시 가져오는) 라운드트립을 할 수 있습니다:

PNG 타일 라운드트립 달성 조건

GDAL 데이터 유형	입력 GDAL NODATA 값	GPKG gpkg_2d_gridded_coverage_ancillary의 null_value
Int16	-32768	65535
UInt16	X (커버리지 오프셋이 0이고 커버리지 척도가 1인 경우)	X
Float32	65535	65535

생성 옵션

다음과 같은 생성 옵션들을 사용할 수 있습니다:

• RASTER_TABLE=string. 사용자 테이블의 이름입니다. 기본적으로 소스 파일명을 기반으로 합니다. (예를 들어 파일명이 foo.gpkg라면, 테이블 이름은 “foo”가 될 것입니다.)

• APPEND_SUBDATASET=YES/NO: YES로 설정하면 기존 테이블에 새 내용을 추가할 수 있도록, 사전에 기존 지오패키지 테이블을 삭제하지 않을 것입니다. 기본값은 NO입니다.

• RASTER_IDENTIFIER=string. 사람이 읽을 수 있는 (예: 단축명) 식별자로, gpkg_contents 테이블의 identifier 열에 삽입됩니다.

• RASTER_DESCRIPTION=string. 사람이 읽을 수 있는 설명으로, gpkg_contents 테이블의 description 열에 삽입됩니다.

• BLOCKSIZE=integer. 블록 크기를 픽셀 단위 너비와 높이로 설정합니다. 기본값은 256입니다. 최대 4096까지 지원합니다. 사용자 지정(custom)이 아닌 TILING_SCHEME을 사용하는 경우 설정해서는 안 됩니다.

• BLOCKXSIZE=integer. 블록 너비를 픽셀 단위로 설정합니다. 기본값은 256입니다. 최대 4096까지 지원합니다.

• BLOCKYSIZE=integer. 블록 높이를 픽셀 단위로 설정합니다. 기본값은 256입니다. 최대 4096까지 지원합니다.

• TILE_FORMAT=PNG_JPEG/PNG/PNG8/JPEG/WEBP/TIFF/AUTO: 타일을 저장하기 위해 쓰이는 포맷입니다. 타일 포맷 단락을 참조하십시오. 기본값은 AUTO입니다.

• QUALITY=1-100: JPEG 및 WEBP 압축의 품질을 설정합니다. 기본값은 75입니다.

• ZLEVEL=1-9: PNG 타일 용 DEFLATE 압축 수준을 설정합니다. 기본값은 6입니다.

• DITHER=YES/NO: (TILE_FORMAT=PNG8일 때) 플로이드-스타인버그 디더링(Floyd–Steinberg dithering)을 사용할지 여부를 선택합니다. 기본값은 NO입니다.

• TILING_SCHEME=CUSTOM/GoogleCRS84Quad/GoogleMapsCompatible/InspireCRS84Quad/PseudoTMS_GlobalGeodetic/PseudoTMS_GlobalMercator/other. 타일 작업 스키마 단락을 참조하십시오. 기본값은 CUSTOM입니다.

  GDAL 3.2버전부터, `OGC 2차원 타일 행렬 집합 표준`_ 을 따르는 JSON 파일의 파일명, 해당 파일을 가리키는 URL, GDAL data 디렉터리에 있는 정의 파일의 어근(예를 들면 파일명이 tms_FOO.json 인 경우 FOO), 또는 그때 그때 즉시 처리하는(inline) JSON 정의를 TILING_SCHEME의 값으로 사용할 수 있습니다.

  주의: 사용자 지정(custom)이 아닌 TILING_SCHEME 옵션은 gdal_translate 유틸리티 또는 CreateCopy() API 작업에 최적화되어 있습니다. gdalwarp 유틸리티에 사용하는 경우, 타일 작업 스키마의 어떤 확대/축소 수준이 기대하는 값을 뽑아내기 위한 -tr 스위치를 반드시 설정해야 합니다.

• ZOOM_LEVEL_STRATEGY=AUTO/LOWER/UPPER. 확대/축소 수준을 결정할 전략을 선택합니다. TILING_SCHEME이 CUSTOM이 아닌 경우에만 CreateCopy()가 사용합니다. LOWER는 내장되지 않은, 이론적으로 계산된 내장되지 않은 확대/축소 수준 바로 아래의 확대/축소 수준을 선택하고 서브샘플링 작업을 수행할 것입니다. UPPER는 그 반대로 바로 위의 확대/축소 수준을 선택하고 오버샘플링 작업을 수행할 것입니다. 기본값은 가장 가까운 확대/축소 수준을 선택하는 AUTO입니다.

• RESAMPLING=NEAREST/BILINEAR/CUBIC/CUBICSPLINE/LANCZOS/MODE/AVERAGE. 리샘플링 알고리즘을 선택합니다. TILING_SCHEME이 CUSTOM이 아닌 경우에만 CreateCopy()가 사용합니다. 기본값은 BILINEAR입니다.

• PRECISION=floating_point_value_in_vertical_units: 최소 중요값(significant value)입니다. 타일 그리드화 커버리지 데이터셋에만 사용합니다. 기본값은 1입니다.

• UOM=string: (GDAL 2.3버전 이상) 측정 단위입니다. 타일 그리드화 커버리지 데이터셋에만 사용합니다. SetUnitType()을 통해서도 설정할 수 있습니다.

• FIELD_NAME=string: (GDAL 2.3버전 이상) 필드 이름입니다. 타일 그리드화 커버리지 데이터셋에만 사용합니다. 기본값은 Height입니다.

• QUANTITY_DEFINITION=string: (GDAL 2.3버전 이상) 필드의 설명입니다. 타일 그리드화 커버리지 데이터셋에만 사용합니다. 기본값은 Height입니다.

• GRID_CELL_ENCODING=grid-value-is-center/grid-value-is-area/grid-value-is-corner: (GDAL 2.3버전 이상) 그리드 셀 인코딩입니다. 타일 그리드화 커버리지 데이터셋에만 사용합니다. 기본값은 grid-value-is-center로, 이때 AREA_OR_POINT 메타데이터 항목은 설정되지 않습니다.

• VERSION=AUTO/1.0/1.1/1.2/1.3: (GDAL 2.2버전 이상) (application_id 및 user_version 필드를 위한) 지오패키지 버전을 설정합니다. AUTO 모드에서는, GDAL 2.3버전부터 기본값이 1.2입니다. GDAL 3.3버전부터는 1.3을 사용할 수 있습니다.

• ADD_GPKG_OGR_CONTENTS=YES/NO: (GDAL 2.2버전 이상) 벡터 레이어의 객체 개수와 관련 트리거를 보전하기 위한 gpkg_ogr_contents 테이블을 추가할지 여부를 선택합니다. 기본값은 YES입니다.

오버뷰

gdaladdo 또는 BuildOverviews()를 사용해서 오버뷰를 계산할 수 있습니다. 기본 지오패키지 사양을 준수하려면 2의 거듭제곱 오버뷰 인자(2, 4, 8, 16, …)를 사용해야 합니다. 다른 오버뷰 인자를 사용하면, GDAL 드라이버에서 작동도 하고 gpkg_zoom_other 확장 사양을 등록도 할 것이지만, 해당 확장 사양을 지원하지 않는 다른 구현 기능들과 작업 호환이 안 되는 문제를 발생시킬 수도 있습니다.

gdaladdo의 -clean 옵션으로 (또는 BuildOverviews()의 nOverviews=0 파라미터로) 오버뷰를 제거할 수도 있습니다.

메타데이터

GDAL은 표준화된 `gpkg_metadata <http://www.geopackage.org/spec/#_metadata_table>`_ 및 `gpkg_metadata_reference <http://www.geopackage.org/spec/#_metadata_reference_table>`_ 테이블을 사용해서 메타데이터를 읽고 씁니다.

기본 메타데이터 도메인과 아마도 다른 메타데이터 도메인에서 나온 GDAL 메타데이터는 GDAL PAM(Persistent Auxiliary Metadata) .aux.xml 파일에서 쓰이는 서식을 준수하는 단일 XML 문서 안에 나열되고, gpkg_metadata에 md_scope=dataset 및 md_standard_uri=http://gdal.org 로 등록됩니다. gpkg_metadata_reference에서는 이 항목을 reference_scope=table 및 table_name={래스터 테이블의 이름}으로 참조합니다.

GEOPACKAGE 메타데이터 도메인을 사용하면 래스터 테이블뿐만 아니라 전체 수준 지오패키지에 적용되는 메타데이터를 읽고 쓸 수 있습니다.

GDAL에서 나오지 않은 메타데이터의 경우, 이 드라이버는 이를 읽어와서 GPKG_METADATA_ITEM_XXX 형태의 키와 gpkg_metadata 테이블의 metadata 열에 있는 값을 사용해서 메타데이터 항목으로 노출시킬 것입니다. 이런 메타데이터를 GDAL 인터페이스를 통해 업데이트하는 기능은 아직 지원하지 않습니다. (하지만 직접 SQL 명령어(Direct SQL Command)를 통해서는 업데이트할 수 있습니다.)

읽기/쓰기에 기본 메타데이터 도메인의 특정 DESCRIPTION 및 IDENTIFIER 메타데이터 항목을 사용하면 gpkg_contents 테이블의 대응하는 각 열을 읽기/업데이트할 수 있습니다.

메타데이터 테이블을 생성하고 값을 채워넣는 일을 피하려면 CREATE_METADATA_TABLES 환경설정 옵션을 NO로 설정하면 됩니다.

지오패키지 확장 지원 수준

(래스터 스코프(scope)를 가지고 있는 지오패키지에 한합니다.)

GeoPackage Extensions

확장 이름	OGC 도입 확장인가?	GDAL이 지원하는가?
다른 간격의 확대/축소	Ｏ	Ｏ
WebP 타일 인코딩	Ｏ	Ｏ
메타데이터	Ｏ	Ｏ
좌표계 용 WKT (WKT v2)	Ｏ	GDAL 2.2버전 부터 부분 지원. GDAL이 이 확장 사양으로 데이터베이스를 읽어올 수 있습니다. GDAL 3.0버전부터 WKT v2 항목을 지원합니다.
타일 그리드화 커버리지 데이터	Ｏ	Ｏ, GDAL 2.3버전부터 (GDAL 2.2는 이 확장 사양의 초기 버전을 지원합니다.)

예시

• GeoTIFF를 지오패키지로 단순 변환(translation)합니다. 타일과 함께 ‘byte’ 테이블이 생성될 것입니다.

  gdal_translate -of GPKG byte.tif byte.gpkg
  

• GeoTIFF를 WebP 타일을 사용하는 지오패키지로 변환합니다.

  gdal_translate -of GPKG byte.tif byte.gpkg -co TILE_FORMAT=WEBP
  

• GeoTIFF를 (필요한 경우 재투영 및 리샘플링을 거친) GoogleMapsCompatible 타일 작업 스키마를 사용하는 지오패키지로 변환합니다.

  gdal_translate -of GPKG byte.tif byte.gpkg -co TILING_SCHEME=GoogleMapsCompatible
  

• 기존 지오패키지의 오버뷰를 작성하고, JPEG 타일을 강제로 생성합니다.

  gdaladdo -r cubic -oo TILE_FORMAT=JPEG my.gpkg 2 4 8 16 32 64
  

• 기존 지오패키지에 새 하위 데이터셋을 추가하고, 래스터 테이블에 기본값이 아닌 이름을 명명합니다.

  gdal_translate -of GPKG new.tif existing.gpkg -co APPEND_SUBDATASET=YES -co RASTER_TABLE=new_table
  

• 입력 데이터셋을 지오패키지로 재투영합니다.

  gdalwarp -of GPKG in.tif out.gpkg -t_srs EPSG:3857
  

• 지오패키지에 있는 특정 래스터 테이블을 엽니다.

  gdalinfo my.gpkg -oo TABLE=a_table
  

참고

• 지오패키지 벡터 문서 페이지

• 지오패키지 알아보기

• OGC 지오패키지 포맷 표준 사양, HTML 포맷 (표준의 현재/개발 버전)

• OGC 지오패키지 인코딩 표준 페이지

• SQLite

• PNG 드라이버 문서 페이지

• JPEG 드라이버 문서 페이지

• WEBP 드라이버 문서 페이지

• OGC 07-057r7 WMTS 1.0 사양

• OSGeo TMS(Tile Map Service) 사양

기타

GeoPackage 드라이버의 래스터 지원은 세이프 소프트웨어 의 재정 지원으로 개발되었습니다.