Digite para filtrar os verbetes do Glossário.

    Banco de dados · Vibe Coding: Do Zero ao MVP

    O que é WKB?

    O WKB codifica geometrias em bytes para transferi-las entre programas. O formato padrão preserva precisão numérica, mas exige enviar o SRID separadamente.

    Também chamado de: Well-Known Binary

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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:

    0101000000000000000000F03F000000000000F0BF

    O 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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano