Como embutir uma calculadora de quilometragem em qualquer site
Uma única tag <script>, quatro variantes (completa, taxa, viagem única e frota) e três idiomas.
Por que um widget embutível
Nem todo time precisa de uma plataforma completa de despesas.[^irs-2025] Blogs de RH, sites de ERP, portais de motoristas e páginas de marketing frequentemente só querem oferecer ao visitante uma calculadora rápida de quilometragem. O widget do Quilometragem entrega isso em uma tag de script, sem dependências, sem bundlers e sem chave de API exigida do parceiro.
Como adicionar
Cole no HTML:
``` <script src="https://quilometragem.com/embed/calculator.js" defer></script> <div data-quilometragem-calculator data-locale="pt" data-country="br" data-variant="full"></div> ```
O script monta o widget em todos os elementos com o atributo `data-quilometragem-calculator` quando o DOM estiver pronto. Os atributos controlam idioma (`pt`, `es`, `en`), país padrão (`br`, `mx`, `co`, `us`, `uk`, `ca`) e variante.
As quatro variantes
- **full**: dois campos de endereço, seletor de país e taxa, botão calcular. Devolve distância e valor de reembolso. - **rate**: apenas a taxa oficial vigente, útil para sidebar de blog ou página de FAQ. - **trip**: estimador de viagem única — usuário insere distância, vê o valor em tempo real. - **fleet**: resumo mensal — multiplica veículos × km médio × taxa.
SPAs e mounts dinâmicos
Se seu site é uma SPA (Next.js, Nuxt, Astro com transições), use o helper exposto globalmente:
``` window.QuilometragemEmbed.mount(divElement); ```
A função aceita qualquer host criado dinamicamente. Útil dentro de routers que recriam o DOM em cada navegação.
oEmbed para Notion, Slack e Confluence
Para documentação interna, basta colar uma URL do Quilometragem em qualquer ferramenta compatível com oEmbed. Nosso endpoint `/oembed` devolve o iframe pronto. O widget herda automaticamente o idioma e o país detectado a partir da URL original.
E o backlink?
Cada variante renderiza um discreto "Powered by Quilometragem" com `utm_source=embed`, o que ajuda parceiros e nós ao mesmo tempo: você ganha uma calculadora robusta, nós ganhamos um link de retorno mensurável.