Name
ST_AsBinary — 返回不带SRID元数据的几何图形/地理图形的OGC/ISO知名二进制(WKB)表示形式。
Synopsis
bytea ST_AsBinary(geometry g1);
bytea ST_AsBinary(geometry g1, text NDR_or_XDR);
bytea ST_AsBinary(geography g1);
bytea ST_AsBinary(geography g1, text NDR_or_XDR);
描述
返回OGC/ISO 知名的二进制 (WKB)几何图形的表示形式。第一个函数变量默认为使用服务器端进行编码。第二个函数变量接受一个文本参数，指定字节顺序编码，可以是小端(‘ndr’)或大端(‘xdr’)。
WKB格式对于从数据库中读取几何图形数据并保持完全的数值精度非常有用。这避免了使用文本格式(如WKT)时可能发生的精确舍入。
要执行从WKB到PostGIS几何的逆转换，请使用 ST_GeomFromWKB 。
![[Note]](images/note.png) | |
OGC/ISO WKB格式不包括SRID。要获得包含SRID的EWKB格式，请使用 ST_AsEWKB |
| |
PostgreSQL 9.0中的默认行为已更改为十六进制编码的OUTPUT BYTE。如果您的图形用户界面工具需要旧的行为，那么在您的数据库中设置TEA_OUTPUT=‘ESCRAPE’。 |
增强：2.0.0引入了对多面体曲面、三角形和三角网的支持。
增强：2.0.0引入了对更高坐标维度的支持。
增强：2.0.0引入了对使用地理位置指定字节顺序的支持。
可用性：引入了1.5.0地理支持。
已更改：2.0.0此函数的输入不能是未知的--必须是几何图形。构造，如 ST_AsBinary('POINT(1 2)') 不再有效，并且您将获得 n st_asbinary(unknown) is not unique error 。这样的代码需要更改为 ST_AsBinary('POINT(1 2)'::geometry); 。如果这是不可能的，则安装 legacy.sql 。
This method implements the OGC Simple Features
Implementation Specification for SQL 1.1. s2.1.1.1
This method implements the SQL/MM specification. SQL-MM 3：5.1.37
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
This function supports 3d and will not drop the z-index.
示例
SELECT ST_AsBinary(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));
st_asbinary
--------------------------------
\x01030000000100000005000000000000000000000000000000000000000000000000000000000000
000000f03f000000000000f03f000000000000f03f000000000000f03f0000000000000000000000
00000000000000000000000000
SELECT ST_AsBinary(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326), 'XDR');
st_asbinary
--------------------------------
\x000000000300000001000000050000000000000000000000000000000000000000000000003ff000
00000000003ff00000000000003ff00000000000003ff00000000000000000000000000000000000
00000000000000000000000000