ST_AsKML
Prev  7.9.3. Other Formats  Next

Name

ST_AsKML — Retorna a geometria como uma versão GML com 2 ou 3 elementos.

Synopsis

text ST_AsKML(geometry geom, integer maxdecimaldigits=15, text nprefix=NULL);

text ST_AsKML(geography geog, integer maxdecimaldigits=15, text nprefix=NULL);

Descrição

Retorna a geometria como um elemento Keyhole Markup Language (KML). Existem muitas variantes desta função. Número máximo de casas decimais usado na saída (padrão 15), versão para 2 e o namespace não tem prefixo.

[Warning]

Using the maxdecimaldigits parameter can cause output geometry to become invalid. To avoid this use ST_ReducePrecision with a suitable gridsize first.

[Note]

Requer que PostGIS seja compilado com o suporte Porj. Use PostGIS_Full_Version para confirmar que você o suporte proj compilado.

[Note]

Disponibilidade: 1.2.2 - variantes futuras que incluem parâmetro versão que veio em 1.3.2
[Note]

Melhorias: 2.0.0 - Adiciona namespace prefixo. O padrão é não ter nenhum prefixo

[Note]

Changed: 3.0.0 - Removed the "versioned" variant signature
[Note]

A saída AsKML não funcionará com geometrias que não possuem um SRID

This function supports 3d and will not drop the z-index.

Exemplos

SELECT ST_AsKML(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));

    st_askml
    --------
    <Polygon
><outerBoundaryIs
><LinearRing
><coordinates
>0,0 0,1 1,1 1,0 0,0</coordinates
></LinearRing
></outerBoundaryIs
></Polygon>

    --3d linestring
    SELECT ST_AsKML('SRID=4326;LINESTRING(1 2 3, 4 5 6)');
    <LineString
><coordinates
>1,2,3 4,5,6</coordinates
></LineString>

Veja também

ST_AsSVG, ST_AsGML