Categorias:

Funções geoespaciais, Funções de conversão

ST_GEOGRAPHYFROMWKB

Analisa uma entrada de WKB (binário bem-conhecido) ou EWKB (binário bem-conhecido estendido) e retorna um valor do tipo GEOGRAPHY.

Aliases:

ST_GEOGFROMWKB , ST_GEOGRAPHYFROMEWKB , ST_GEOGFROMEWKB

Consulte também:

TO_GEOGRAPHY

Sintaxe

ST_GEOGRAPHYFROMWKB( <varchar_or_binary_expression> [ , <allow_invalid> ] )

ST_GEOGFROMWKB( <varchar_or_binary_expression> [ , <allow_invalid> ] )

ST_GEOGRAPHYFROMEWKB( <varchar_or_binary_expression> [ , <allow_invalid> ] )

ST_GEOGFROMEWKB( <varchar_or_binary_expression> [ , <allow_invalid> ] )
Copy

Argumentos

Obrigatório:

varchar_or_binary_expression

O argumento deve ser uma cadeia de caracteres ou expressão binária em WKB ou EWKB que represente um objeto geoespacial válido.

Uma expressão de cadeia de caracteres deve estar em formato hexadecimal (sem um 0x na frente).

Opcional:

allow_invalid

Se TRUE, especifica que a função deve retornar um objeto GEOGRAPHY ou GEOMETRY, mesmo quando a forma de entrada for inválida e não puder ser reparada. Para obter mais detalhes, consulte Especificação de como as formas geoespaciais inválidas são tratadas.

Retornos

A função retorna um valor do tipo GEOGRAPHY.

Notas de uso

  • Emite um erro se a entrada não puder ser analisada como WKB ou EWKB.

  • Emite um erro se o formato de entrada for EWKB e o SRID não for 4326. Consulte a nota sobre como lidar com EWKT e EWKB.

Exemplos

O exemplo a seguir retorna o objeto GEOGRAPHY para um objeto geoespacial descrito no formato WKT:

-- Set the output format to WKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='WKT';
Copy
select ST_GEOGRAPHYFROMWKB('01010000006666666666965EC06666666666C64240');
+-------------------------------------------------------------------+
| ST_GEOGRAPHYFROMWKB('01010000006666666666965EC06666666666C64240') |
|-------------------------------------------------------------------|
| POINT(-122.35 37.55)                                              |
+-------------------------------------------------------------------+
Copy

O exemplo a seguir retorna o objeto GEOGRAPHY para um objeto geoespacial descrito no formato EWKT:

-- Set the output format to EWKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='EWKT';
Copy
select ST_GEOGRAPHYFROMEWKB('0101000020E61000006666666666965EC06666666666C64240');
+----------------------------------------------------------------------------+
| ST_GEOGRAPHYFROMEWKB('0101000020E61000006666666666965EC06666666666C64240') |
|----------------------------------------------------------------------------|
| SRID=4326;POINT(-122.35 37.55)                                             |
+----------------------------------------------------------------------------+
Copy
Linguagem: Português