# Maps

> Um mapa do Brasil com os seus pontos, em qualquer página, com uma linha de script.

Um mapa do Brasil (dados do OpenStreetMap) com os seus pontos marcados: lojas, pontos de retirada, escritórios. Usa uma [chave pública](https://apizen.com.br/docs/autenticacao.md) (`pk_maps_…`), que só funciona nos domínios cadastrados nela.

```html
<div id="map" style="height: 420px"></div>
<script src="https://maps.apizen.com.br/v1/maps.js"></script>
<script>
  Maps.create("#map", {
    key: "pk_maps_…",
    points: [
      {
        name: "Ponto MASP",
        lat: -23.5615,
        lon: -46.6559,
        address: "Av. Paulista, 1578 - Bela Vista",
        description: "Seg–Sex, 9h–18h",
        image: "https://exemplo.com.br/fotos/masp.jpg",
      },
      // …
    ],
  });
</script>
```

## Maps.create(alvo, opções)

Recebe um elemento ou um seletor e devolve `{ map, remove() }`.

| Opção | |
|---|---|
| `key` | a chave pública (`pk_maps_…`) |
| `points` | `[{ lat, lon, name?, address?, description?, image? }]`: marcadores com um balão (foto, nome, endereço, descrição); o mapa se ajusta a eles |
| `center` | `[lon, lat]` quando não há pontos (padrão: o Brasil inteiro) |
| `zoom` | o zoom do `center` ou de um ponto só (padrão 15) |
| `attribution` | texto antes do crédito do OpenStreetMap |
| `pulse` | marcadores pulsando (padrão: só com um ponto) |
| `reset` | `false` esconde o botão que volta à primeira visão |

A cota do Maps conta mapas carregados, não requisições de tiles. O crédito do OpenStreetMap aparece no mapa (licença ODbL).
