to_geography function

Applies to: Databricks SQL Databricks Runtime 17.1 and above

Preview

This feature is in Public Preview.

nota

This feature is not available on Databricks SQL Classic warehouses. To learn more about Databricks SQL warehouses, see SQL warehouse types

Parses the input description of a geography and returns the corresponding GEOGRAPHY value. The SRID value of the returned GEOGRAPHY value is 4326.

Syntax

to_geography ( geoRepExpr )

Arguments

• geoRepExpr: A BINARY or STRING expression representing a geography in WKB, WKT, or GeoJSON.

Returns

A value of type GEOGRAPHY(ANY), corresponding to the input geography description.

The function returns NULL if the input is NULL.

Error conditions

• If geoRepExpr is of type BINARY and the value is an invalid WKB, the function returns WKB_PARSE_ERROR.
• If geoRepExpr is of type STRING and the value is an invalid WKT, the function returns WKT_PARSE_ERROR.
• If geoRepExpr is of type STRING and the value is an invalid GeoJSON, the function returns GEOJSON_PARSE_ERROR.

Examples

SQL

-- 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)

Related functions

• st_asbinary function
• st_asewkb function
• st_asewkt function
• st_asgeojson function
• st_astext function
• st_aswkb function
• st_aswkt function
• st_geogfromgeojson function
• st_geogfromtext function
• st_geogfromwkb function
• st_geogfromwkt function
• st_geomfromewkb function
• st_geomfromgeojson function
• st_geomfromtext function
• st_geomfromwkb function
• st_geomfromwkt function
• to_geometry function
• try_to_geography function
• try_to_geometry function