to_geography Función

Se aplica a: Databricks SQL Databricks Runtime 17.1 y versiones posteriores

Important

Esta característica está en versión preliminar pública.

Nota:

Esta característica no está disponible en almacenes clásicos de Databricks SQL. Para más información sobre los almacenes de SQL de Databricks, consulte Tipos de almacenamiento de SQL.

Analiza la descripción de entrada de una geografía y devuelve el valor correspondiente GEOGRAPHY . El valor SRID del valor devuelto GEOGRAPHY es 4326.

Syntax

to_geography ( geoRepExpr )

Arguments

• geoRepExpr: expresión BINARY o STRING que representa una geografía en WKB, WKT o GeoJSON.

Returns

Valor de tipo GEOGRAPHY(ANY), que corresponde a la descripción de geografía de entrada.

La función devuelve NULL si la entrada es NULL.

Condiciones de error

• Si geoRepExpr es de tipo BINARY y el valor es un WKB no válido, la función devuelve WKB_PARSE_ERROR.
• Si geoRepExpr es de tipo STRING y el valor es un WKT no válido, la función devuelve WKT_PARSE_ERROR.
• Si geoRepExpr es de tipo STRING y el valor es un GeoJSON no válido, la función devuelve GEOJSON_PARSE_ERROR.

Examples

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

Funciones relacionadas

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