共用方式為

to_geography 函数

适用于:检查标记为“是”的 Databricks SQL 检查标记为“是”是 Databricks Runtime 17.1 及更高版本

重要

此功能目前以公共预览版提供。

分析地理位置的输入说明并返回相应的 GEOGRAPHY 值。 返回 GEOGRAPHY 值的 SRID 值为 4326。

Syntax

to_geography ( geoRepExpr )

Arguments

  • geoRepExpr:一种 BINARYSTRING 表达式,表示 WKB、WKT 或 GeoJSON 中的地理信息。

退货

一个类型 GEOGRAPHY(ANY)值,对应于输入地理说明。

如果输入为 NULL.,则函数返回 NULL

错误条件

  • 如果 geoRepExpr 类型为类型 BINARY 且值为无效的 WKB,则函数将返回 WKB_PARSE_ERROR
  • 如果 geoRepExpr 类型为类型 STRING 且值无效的 WKT,则函数将返回 WKT_PARSE_ERROR
  • 如果 geoRepExpr 类型为, STRING 并且值无效 GeoJSON,则函数将返回 GEOJSON_PARSE_ERROR

例子

-- Input geography is in WKT format.
> SELECT st_asgeojson(to_geography('POINT Z (3 4 5)'));
  {"type":"Point","coordinates":[3,4,5]}

-- Input geography is in GeoJSON format.
> SELECT st_asewkt(to_geography('{"type":"Point","coordinates":[3,4,5]}'));
  SRID=4326;POINT Z (3 4 5)

-- Input geography is in WKB format.
> SELECT st_astext(to_geography(X'01b90b0000000000000000084000000000000010400000000000001440000000000000f0bf'))
  POINT ZM (3 4 5 -1)