Trechos do capítulo "Mapas e dados geoespaciais"
alexandrecaramaschi.com/educacao/frontends-com-vibecoding

Três pedidos prontos para colar no agente. A página explica quando usar cada
degrau de mapa e o que a figura exige para não mentir; aqui está o material
bruto, para quem vai executar.

================================================================================

### O que faz: mede, em número, quanto o contexto oficial da biblioteca reduz a invenção do agente
### Onde entra: antes da primeira linha de código de mapa no projeto
### Cuidado: guarde o resultado sem contexto ANTES de carregar o contexto, senão não há comparação

# Este exercício pede terminal e um agente instalado.

# 1. Verifique se o projeto da biblioteca de mapa que você usa publica
#    contexto para agentes (servidor de contexto, pacote de instruções ou
#    documentação em formato legível por máquina). Anote o que encontrou
#    e a data da consulta.

# 2. SEM esse contexto carregado, peça ao agente:
"Monte um mapa com meus dados de expansão por país (arquivo paises.geojson
 com uma propriedade 'clientes' por país), lendo as peças do mapa de um
 arquivo único hospedado em armazenamento estático. Colora por taxa."

# 3. Guarde o resultado. Carregue o contexto oficial e repita o MESMO pedido.

# 4. Compare os dois códigos lado a lado e conte:
#    - quantos métodos citados não existem na versão instalada
#    - quantos nomes de formato ou de protocolo estão errados
#    - qual das duas versões roda sem ajuste

# Critério de aceite: você registra a diferença em número, não em impressão,
# e declara a versão da biblioteca em que a comparação foi feita.

================================================================================

### O que faz: pede um mapa vetorial sem chave de API e sem servidor de mapa, servido de armazenamento estático
### Onde entra: projeto que precisa de mapa próprio sem cobrança por carregamento
### Cuidado: o mapa não inicializa dentro de um contêiner de altura zero; garanta a altura antes

# Este exercício pede terminal, conta de armazenamento e código.

Quero um mapa vetorial do Brasil SEM nenhuma chave de API e SEM servidor de
mapa. Base: MapLibre com um arquivo único de peças de mapa hospedado em
armazenamento estático (R2, S3 ou equivalente).

Passo a passo que preciso que você me entregue:
1. O comando de linha de comando para extrair do conjunto do planeta um
   arquivo contendo APENAS o território brasileiro.
2. O comando para subir esse arquivo no meu armazenamento, com os cabeçalhos
   de cache e o suporte a entrega parcial de arquivo corretos.
3. O componente de tela que inicializa o mapa, registra o formato do arquivo
   como origem das peças e aplica um estilo mínimo legível.
4. Uma camada de área colorida por penetração por unidade federativa, lida de
   um arquivo local, colorida por TAXA e nunca por valor absoluto.

Critérios de aceite:
- Zero chamadas a qualquer serviço de mapa pago: comprove listando as
  requisições de rede e mostrando que só há acesso ao meu armazenamento.
- Nenhuma variável de ambiente com chave de mapa.
- O mapa não inicializa em contêiner de altura zero; garanta a altura antes.
- Se algum passo depender de um recurso que você não tem certeza que existe
  na versão instalada, diga isso em vez de inventar, e cite a versão que
  consultou com a data.

================================================================================

### O que faz: plota dois milhões de pontos com duas camadas alternáveis e mede o teto de desenho
### Onde entra: mapa de alto volume, quando a tela não consegue mais desenhar ponto a ponto
### Cuidado: rótulo de texto dentro da camada da placa de vídeo derruba justamente o desempenho que motivou a troca

# Este exercício pede terminal, código e medição no navegador.

"Plote 2 milhões de pontos de pedidos (latitude, longitude, valor) sobre um
 mapa de base, com duas camadas alternáveis: pontos individuais e densidade
 agregada em hexágonos. Depois explique, em prosa e sem jargão, por que este
 volume não cabe no desenho vetorial comum e o que muda quando ele passa para
 a placa de vídeo."

# Critério de aceite:
# - A rolagem e a aproximação seguem fluidas com os 2 milhões de pontos, e
#   você mediu isso em vez de descrever a sensação.
# - A camada agregada colore por contagem, com legenda e denominador escritos.
# - A explicação cita o motivo real do ganho, sem prometer efeito mágico onde
#   o gargalo é outro.
# - Você declara em que máquina a medição foi feita, com a data.