Name
ST_AsTWKB — 도형을 TWKB(Tiny Well-Known Binary)로 반환합니다.
Synopsis
bytea ST_AsTWKB(geometry geom, integer prec=0, integer prec_z=0, integer prec_m=0, boolean with_sizes=false, boolean with_boxes=false);
bytea ST_AsTWKB(geometry[] geom, bigint[] ids, integer prec=0, integer prec_z=0, integer prec_m=0, boolean with_sizes=false, boolean with_boxes=false);
설명
도형을 TWKB(Tiny Well-Known Binary) 형식으로 반환합니다. TWKB는 출력물의 용량을 최소화하는 데 집중한 압축 바이너리 형식 입니다.
소수점 이하 자릿수 파라미터가 출력물에 어느 정도의 정밀도를 저장할지 결정합니다. 기본적으로, 모든 값은 인코딩하기 전에 가장 가까운 단위로 반올림됩니다. 더 높은 정밀도를 복사하고 싶다면, 자릿수를 올리십시오. 예를 들어, 값이 1이라면 소수점 오른쪽의 첫 번째 숫자까지 보전될 것입니다.
크기 및 경계 상자 파라미터는 객체의 인코딩된 길이 및 경계에 대한 선택적인 정보를 출력물에 포함시킬지 말지를 결정합니다. 기본적으로는 포함되지 않습니다. 사용자의 클라이언트 소프트웨어가 필요로하지 않는다면 활성화시키지 마십시오. 디스크 공간을 소비할 뿐입니다(디스크 공간을 절약하는 것이 TWKB의 목적입니다).
이 함수의 배열 입력 형식은 도형 집합 및 유일 식별자를 식별자를 보전하는 TWKB 집합으로 변환하는 데 쓰입니다. 집합의 압축을 풀어 그 안에 있는 객체들에 대한 상세 정보에 접근하는 기능을 가진 클라이언트에 유용합니다. array_agg 함수를 이용해서 배열을 생성할 수 있습니다. 다른 파라미터들은 이 함수의 단순 형태의 경우와 동일하게 실행됩니다.
![[Note]](../images/note.png) | |
https://github.com/TWKB/Specification 에서 형식 사양서를 찾아볼 수 있으며, https://github.com/TWKB/twkb.js 에서 자바스크립트 클라이언트를 빌드하기 위한 코드를 찾을 수 있습니다. |
Enhanced: 2.4.0 memory and speed improvements.
2.2.0 버전부터 사용할 수 있습니다.
예시
SELECT ST_AsTWKB('LINESTRING(1 1,5 5)'::geometry);
st_astwkb
--------------------------------------------
\x02000202020808
식별자를 포함하는 종합 TWKB 객체를 생성하려면, 먼저 "array_agg()"를 통해 원하는 도형과 객체를 합친 다음 적절한 TWKB 함수를 호출하십시오.
SELECT ST_AsTWKB(array_agg(geom), array_agg(gid)) FROM mytable;
st_astwkb
--------------------------------------------
\x040402020400000202