O WKB (Well-Known Binary) é um formato binário que codifica o tipo de uma geometria e suas coordenadas para transferi-la entre programas. A sequência também informa a ordem dos bytes, necessária para interpretar os números corretamente.
O que os bytes de um ponto descrevem
O manual do MySQL apresenta o ponto POINT(1 -1) como uma sequência de 21 bytes. Na exibição hexadecimal, cada byte ocupa dois caracteres:
0101000000000000000000F03F000000000000F0BFO byte inicial 01 indica a ordem little-endian, que coloca primeiro o byte menos significativo de cada número. Os quatro bytes seguintes identificam o tipo ponto. Os dezesseis restantes representam as coordenadas X igual a 1 e Y igual a -1, com oito bytes para cada valor. Um programa que decodifica esse WKB recupera o ponto, embora a sequência exibida não contenha a palavra POINT.
O hexadecimal é uma maneira de mostrar os bytes. Ao receber uma exportação, você precisa conferir se a integração fornece o conteúdo binário ou sua codificação hexadecimal, pois o programa destinatário precisa interpretar a representação recebida.
Exportação e informações que acompanham a geometria
No PostGIS, a função ST_AsBinary produz WKB e preserva a precisão numérica das coordenadas. O WKB padrão não inclui o SRID, identificador do sistema de referência espacial. Essa informação precisa acompanhar a transferência separadamente ou por uma extensão aceita pelos dois programas, como o EWKB do PostGIS.
O formato interno de um banco também exige atenção. O MySQL armazena quatro bytes com o SRID antes do WKB. Por isso, copiar diretamente a representação interna e entregá-la a um decodificador de WKB pode levar à leitura incorreta do início da sequência.
Dúvidas frequentes
Perguntas frequentes sobre WKB
- Por que o WKB pode aparecer como uma sequência de letras e números?
- Uma ferramenta pode exibir cada byte como dois caracteres hexadecimais. Essa exibição representa o conteúdo binário do WKB, enquanto o WKT escreve o tipo da geometria e suas coordenadas em outra sintaxe.
- O WKB padrão inclui a referência espacial?
- O WKB padrão não inclui o SRID, identificador do sistema de referência espacial. No PostGIS, a extensão EWKB permite incluí-lo, desde que o programa destinatário aceite esse formato.
- Uma coluna espacial do MySQL armazena somente WKB?
- O formato interno do MySQL acrescenta quatro bytes com o SRID antes da representação WKB. Para exportar uma geometria, use a função de conversão correspondente ao formato aceito pelo destinatário.
Para continuar
Recursos relacionados
Documentação
PostGIS: representação binária de geometrias
Documenta a exportação em WKB, a ordem dos bytes e a preservação da precisão numérica no PostGIS.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Orientação ao vivo para você revisar a exportação de geometrias e a leitura do conteúdo recebido pela aplicação.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Na integração de uma aplicação com um banco espacial, você precisa distinguir os bytes da geometria da forma usada para transmiti-los.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.