Pular para o conteúdo
Octo × Mapas web Pedir um diagnóstico

Octo para OpenLayers, Leaflet, MapLibre, PMTiles e Martin

Um arquivo, um bucket, um mapa. O que vai junto no tile é decisão sua.

Com tippecanoe, PMTiles e MapLibre GL JS, um mapa web inteiro cabe num arquivo lido por pedaços (HTTP Range) direto de uma hospedagem estática; quando o dado muda o dia todo, o Martin serve o PostGIS ao vivo. O Octo gera os tiles só com as colunas aprovadas, mede o peso por zoom, confere a hospedagem pelo conteúdo e monta a página com a atribuição visível. O que vai a público e o crédito de cada fonte ficam com o responsável pelo dado e o administrador.

À esquerda, um terminal roda tippecanoe e pmtiles verify; no centro, um arquivo PMTiles com cabeçalho, diretório e blocos de tiles, de onde saem três pedidos de intervalo de bytes; à direita, a tela de um mapa vetorial com quadras, ruas, um rio, pontos de ocorrência e a atribuição visível no canto $ tippecanoe -o base.mbtiles -Z10 -z16 -y inscricao … $ pmtiles convert … base.pmtiles $ pmtiles verify base.pmtiles z16 maior tile 412 KB OK cpf removido do tile ✓ base-2026-10-31.pmtiles cabeçalho 127 B · v3 diretório raiz tiles z10–z16 · somente leitura Range: bytes=0-126 → 206 Range: bytes=127-16510 → 206 Range: bytes=8812044-… → 206 DADOS FICTÍCIOS buraco · aberta aberta em 30/10 © colaboradores do OpenStreetMap
Ilustração: do dado ao arquivo PMTiles e à tela do mapa, com atribuição visível; dados fictícios.
MapLibre GL JS6.16lançado em 25/10/2026, licença BSD
OpenLayers10.11lançado em 04/10/2026, BSD-2-Clause
Especificação PMTilesv3lida por HTTP Range, sem servidor de mapas
Fontes11listadas no fim da página
01

O que o Octo faz com mapas web e tiles.

Seis entregas possíveis, tiradas do levantamento. Todas começam lendo o que existe sem mexer em nada, e todas passam pelo responsável antes de ir a público.

Tiles vetoriais com tippecanoe

Exporta só as colunas aprovadas com ogr2ogr, gera os tiles por camada e zoom e mede o peso de cada zoom no MBTiles intermediário.

Entrega: tiles + tabela de peso por zoom

PMTiles em hospedagem estática

Converte, verifica e publica com nome versionado; confere 206, assinatura, versão 3 e CORS pelo conteúdo da resposta.

Entrega: arquivo conferido + relatório da hospedagem

Martin sobre o PostGIS

Publica só a view aprovada, com usuário de leitura e descoberta automática desligada, e mede tiles de amostra por zoom.

Entrega: configuração + amostra medida

A página do mapa

MapLibre, OpenLayers ou Leaflet, conforme projeção, fonte e equipe; estilo JSON, clique com as colunas públicas e controle de atribuição visível.

Entrega: página + estilo versionados

Mapa-base próprio

Mede o uso do tile.openstreetmap.org contra a política da OSMF e propõe um recorte em PMTiles com atribuição ODbL.

Entrega: recorte + nota de licença para a equipe

O que vai dentro do tile

Lê os atributos de cada camada nos tiles já publicados e aponta dado pessoal que foi junto sem aparecer no estilo.

Entrega: lista para o encarregado de dados decidir
02

Oito braços, um mapa conferido antes de ir a público.

O mesmo ciclo do Octo, aplicado ao mapa web. Cada braço tem um papel estreito; quem decide o que sai, como o crédito aparece e quando publicar são pessoas.

  1. Descoberta

    Levanta o que já existe

    Bibliotecas e versões no código, fontes de tiles, uso do tile.openstreetmap.org, atribuições presentes ou ausentes.

  2. Dados

    Separa estável de vivo

    Que camada muda todo dia, que coluna é necessária no mapa, até que zoom o dado se sustenta.

  3. Segurança

    Olha o que vai no tile

    Atributos pessoais, tabelas visíveis ao usuário do Martin, CORS aberto demais, URL de bucket exposta.

  4. Arquitetura

    Escolhe o caminho

    PMTiles estático, Martin ao vivo ou servidor OGC; MapLibre, OpenLayers ou Leaflet; zoom máximo e cache.

  5. Desenvolvimento

    Escreve script e página

    Exportação, geração de tiles, configuração do Martin e a página do mapa, com modo de ensaio e fonte de cada opção anotada.

  6. Revisão

    Confere pelo conteúdo

    Resposta 206, assinatura do arquivo, peso por zoom, colunas no tile, atribuição visível. Status 200 não é conferência.

  7. Publicação

    Só com o seu ok

    Upload com nome novo e troca de referência no estilo na janela combinada, com aprovação do administrador.

  8. Documentação

    Registra o que foi publicado

    Versão de cada arquivo, colunas que saíram, fontes e atribuições, e quem aprovou.

O Octo trabalha com acesso de leitura e como apoio. Não publica, não troca a versão em produção e não escolhe atributo que vai a público sem aprovação.

03

Cada tarefa, o seu caminho.

O critério que o Octo usa para escolher, com a documentação da versão instalada.

TarefaCaminhoObservação
Base estável na webtippecanoe + PMTiles em hospedagem estáticaArquivo somente leitura; nova versão, novo nome
Dado que muda o dia todoMartin sobre view do PostGISUsuário de leitura; descoberta automática desligada
Projeção local, WMS e WFSOpenLayersproj4 para SIRGAS 2000 / UTM
Mapa simples com marcadoresLeaflet 1.92.0 ainda em pré-lançamento
Fundo vetorial com estilo próprioMapLibre GL JSProtocolo pmtiles://
Fundo para uso intenso ou offlineRecorte próprio com pmtiles extractNão semear o tile.openstreetmap.org
Conferir a hospedagemcurl -r 0-126 + OPTIONSExigir 206 e CORS com Range
Limitar o peso do tile--drop-densest-as-needed, -yMedir no MBTiles antes de converter
Servir por padrão OGCOGC API – Tiles ou WMTS (área servidores-ogc)Quando o cliente exige padrão
04

Do mapa avulso ao mapa que se atualiza.

Três degraus. Cada um só faz sentido depois que o anterior mostrou resultado na sua equipe.

Proposta, não promessa

1 Hoje

Inventário do que está no ar

O Octo lista bibliotecas, fontes de tiles, atributos nos tiles e atribuições, sem mexer em nada.

  • Fontes de tiles e uso do OSM
  • Colunas que estão indo ao navegador
  • Perguntas para o responsável
Ganho: saber o que está exposto antes de mudar
2 Próximo

Base em PMTiles

Camadas estáveis em arquivo único, medido por zoom e conferido na hospedagem.

  • Peso por zoom com veredito
  • Hospedagem conferida
  • Página com atribuição visível
Ganho: menos servidor para manter
3 Depois

Rotina de atualização

Quando o dado muda, um novo arquivo é gerado, conferido e trocado com registro; o que é vivo vai pelo Martin.

  • Regeração agendada e conferida
  • Martin para o que muda o dia todo
  • Histórico de versões e aprovações
Ganho: mapa atualizado e publicação sob controle
05

Confirmado em fonte.

Cada ponto abaixo tem fonte publicada pelo projeto ou pela organização responsável pelo padrão. As fontes estão na seção seguinte.

5

pontos com fonte publicada, cada um com a referência indicada ao lado.

ConfirmadoVersões atuais
OpenLayers v10.11.0 (04/10/2026), MapLibre GL JS v6.16.0 (25/10/2026), Martin v1.16.1 (09/09/2026), go-pmtiles v1.31.2 (22/07/2026), tippecanoe 2.79.0 (24/07/2025).Fonte: releases dos repositórios no GitHub, 31/10/2026
ConfirmadoLeaflet 2.0 ainda não é estável
A última estável é a v1.9.4 (18/05/2023); a v2.0.0-alpha.1 (16/08/2025) está marcada como pré-lançamento.Fonte: releases do Leaflet
ConfirmadoPMTiles v3 por HTTP Range
O leitor busca só o tile ou o metadado relevante por requisição de intervalo; o arquivo é somente leitura.Fonte: documentação da Protomaps
ConfirmadoPolítica de tiles do OSM
Atribuição visível, User-Agent próprio, sem pré-carga nem uso offline no tile.openstreetmap.org; bloqueio sem aviso.Fonte: OSMF, política de uso de tiles
ConfirmadoOpções de linha de comando
O pmtiles extract recorta por --bbox ou --region e zoom, de origem clustered; no Martin, auto_publish: false desliga a descoberta e o martin cp grava só MBTiles; o tippecanoe limita o tile a 500K comprimido e 200.000 feições.Fonte: documentação do CLI pmtiles, do Martin e repositório do tippecanoe
06

O que o Octo faz e o que fica com vocês.

O Octo prepara tudo, mas não assina. O documento que vale continua com quem responde por ele.

O Octo prepara

Levanta, calcula, organiza e gera os documentos: planilhas, relatórios, mapas e minutas.

Entrega: material pronto para conferir

A sua equipe confere

O profissional habilitado confere o que o Octo entregou antes de assinar. Se algo não fecha, volta para o Octo com a correção.

Etapa: conferência por quem assina

Quem assina

O Octo não assina. Projeto, laudo, ART/RRT, prestação de contas e qualquer documento oficial continuam assinados pelo profissional habilitado da empresa ou do órgão: aqui, o responsável técnico pelo mapa ou pelo levantamento.

Assinatura: responsável técnico pelo mapa ou levantamento
07

Fontes.

Repositórios, documentação dos projetos e política da OSMF, consultados em 31/10/2026.

Seu mapa na web, conferido pelo que entrega.

O diagnóstico começa por um inventário do que o seu mapa web carrega: fontes de tiles, atributos que chegam ao navegador e atribuições. Você recebe a lista do que está exposto e das decisões que só a sua equipe toma, e decide com ela na mão.