ST_AsGeoJSON
ST_AsGeoJSON retorna a representação GeoJSON de uma geometria ou geografia de entrada. Para mais informações sobre GeoJSON, consulte GeoJSON
Para geometrias 3DZ e 4D, a geometria de saída é uma projeção 3DZ da geometria 3DZ ou 4D de entrada. Ou seja, as coordenadas x
, y
, e z
estão presentes na saída. Para geometrias 3DM, a geometria de saída é uma projeção 2D da geometria 3DM de entrada. Ou seja, apenas as coordenadas x
e y
estão presentes na saída.
Para geografias de entrada, ST_AsGeoJSON retorna a representação GeoJSON de uma geografia de entrada. As coordenadas da geografia são exibidas usando a precisão especificada.
Sintaxe
ST_AsGeoJSON(geo)
ST_AsGeoJSON(geo, precision)
Argumentos
- geo
-
Um valor de tipo de dados
GEOMETRY
ouGEOGRAPHY
ou uma expressão que é avaliada como tipoGEOMETRY
ouGEOGRAPHY
. - precisão
-
Um valor de tipo de dados
INTEGER
. Para geometrias, as coordenadas geo são exibidas usando a precisão especificada de 1 a 20. Se precision não for especificado, o padrão será 15. Para geometrias, as coordenadas geo são exibidas usando a precisão especificada. Se precision não for especificado, o padrão será 15.
Tipo de retorno
VARCHAR
Será retornado null, se geo for nulo.
Nulo será retornado se precision for nulo.
Se o resultado for maior que VARCHAR
de 64 KB, um erro será retornado.
Exemplos
O seguinte SQL retorna a representação GeoJSON de uma linestring.
SELECT ST_AsGeoJSON(ST_GeomFromText('LINESTRING(3.141592653589793 -6.283185307179586,2.718281828459045 -1.414213562373095)'));
st_asgeojson
----------------------------------------------------------------------------------------------------------------
{"type":"LineString","coordinates":[[3.14159265358979,-6.28318530717959],[2.71828182845905,-1.41421356237309]]}
O seguinte SQL retorna a representação GeoJSON de uma linestring. As coordenadas das geometrias são exibidas com seis dígitos de precisão.
SELECT ST_AsGeoJSON(ST_GeomFromText('LINESTRING(3.141592653589793 -6.283185307179586,2.718281828459045 -1.414213562373095)'), 6);
st_asgeojson
-----------------------------------------------------------------------------
{"type":"LineString","coordinates":[[3.14159,-6.28319],[2.71828,-1.41421]]}
O SQL a seguir retorna a representação GeoJSON de uma geografia.
SELECT ST_AsGeoJSON(ST_GeogFromText('LINESTRING(110 40, 2 3, -10 80, -7 9)'));
st_asgeojson
----------------------------------------------------------------------
{"type":"LineString","coordinates":[[110,40],[2,3],[-10,80],[-7,9]]}