ST_AsBinary 方法

geometry-expression.ST_AsBinary([ format])

名称	类型	说明
format	VARCHAR(128)	定义将 geometry-expression 转换为二进制表示时使用的输出二进制格式的字符串。如果未指定，则使用 st_geometry_asbinary_format 选项值选择二进制表示。请参见st_geometry_asbinary_format 选项。

LONG BINARY 返回 geometry-expression 的 WKB 表示。

ST_AsBinary 方法返回表示几何的二进制字符串。支持许多不同的二进制格式（及其关联选项），使用可选 format 参数选择所需格式。如果未指定 format 参数，则使用 st_geometry_asbinary_format 选项选择要使用的输出格式。请参见st_geometry_asbinary_format 选项。

格式字符串定义输出格式和格式参数。格式字符串具有以下格式之一：

format-name

format-name(parameter1=value1;parameter2=value2;...)

parameter1=value1;parameter2=value2;...

第一种格式指定格式名称，但不指定格式参数。所有格式参数均使用缺省值。第二种格式指定格式名称以及指定参数值列表。未提供参数值的参数使用缺省值。最后一种格式仅指定参数值，格式名称缺省为 'WKB'。

可能使用以下格式名称：

WKB 由 SQL/MM 和 OGC 定义的标准二进制格式。
EWKB 由 PostGIS 定义的扩展标准二进制格式。此格式包括几何的 SRID，与 WKB 格式的不同之处在于表示 Z 和 M 值的方式。

可以指定以下格式参数：

格式名称	参数名称	缺省值	允许值	说明
WKB	Version	1.2	1.1 由 OGC SFS 1.1 定义的 WKB。此格式不包含 Z 和 M 值。如果几何包含 Z 或 M 值，在输出中将移除这些值。 1.2 由 OGC SFS 1.2 定义的 WKB。应用于 2D 数据时此格式与版本 1.1 格式匹配，并扩展版本 1.1 格式以支持 Z 和 M 值。	Version 参数控制所使用的 WKB 规范的版本。

注释

将几何值转换为 BINARY 时，服务器使用 ST_AsBinary 方法。使用 st_geometry_asbinary_format 选项定义转换时使用的格式。请参见st_geometry_asbinary_format 选项。

注意

缺省情况下，如果几何的原始格式可用，ST_AsBinary 将使用该格式。否则使用内部格式。有关内部和原始格式的详细信息，请参见STORAGE FORMAT 子句，CREATE SPATIAL REFERENCE SYSTEM 语句。

SQL/MM (ISO/IEC 13249-3: 2006) 5.1.37

如果 st_geometry_asbinary_format 选项具有缺省值 'WKB'，则以下示例返回结果 [0x01b90b0000000000000000f03f000000000000004000000000000008400000000000001040]。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsBinary()

如果 st_geometry_asbinary_format 选项具有缺省值 'WKB'，则以下示例返回结果 [0x01b90b0000000000000000f03f000000000000004000000000000008400000000000001040]。将几何转换为 BINARY 时，服务器隐式调用 ST_AsBinary 方法。

SELECT CAST( NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ) AS LONG BINARY)

以下示例返回结果 0x0101000000000000000000f03f0000000000000040。因为 WKB 的 OGC 规范的 1.1 版本不支持 Z 和 M 值，所以它们会被忽略。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsBinary('WKB(Version=1.1;endian=little)')

以下示例返回结果 [0x01010000e0e6100000000000000000f03f000000000000004000000000000008400000000000001040]。扩展 WKB 包含 SRID。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsBinary('EWKB(endian=little)')

ST_AsBinary 方法

语法

参数

返回值

注释

注释

注意

标准和兼容性

示例