Casos de uso: integração Google Planilhas e APIs Cobli
Três análises práticas construídas a partir da listagem de dispositivos da API da Cobli no Google Planilhas.
A lista de endpoints disponíveis para integração é extensa, e com os mesmos dados é possível resolver casos de uso bem diferentes do dia a dia da gestão de frotas. Aqui estão três exemplos construídos a partir de uma única requisição.
Pré-requisitos
- O API Connector instalado e configurado: veja Como integrar o Google Planilhas com as APIs da Cobli.
- Uma chave de API.
Adicionar a planilha de dados
Os exemplos usam a listagem de dispositivos. No API Connector, informe:
| Campo | O que informar |
|---|---|
| Method | GET |
| API URL path | O endpoint de listagem de dispositivos (confira a versão atual em docs.cobli.co) |
| Headers | Key cobli-api-key, Value com a sua chave de API |
| Destination Sheet | A página da planilha que vai receber os dados |
| Name | Um nome para a requisição |
Clique em Save para guardar a requisição ou em Run para executá-la: os dados dos dispositivos são preenchidos na planilha escolhida.
Caso 1: quais dispositivos estão conectados agora
Crie uma aba de análise
Crie uma nova aba na planilha para não mexer nos dados de origem. Uma aba fica com a resposta da API (Listagem de Dispositivos) e a outra com a análise (Análise de Dispositivos Conectados).
Referencie apenas as colunas que interessam
Na primeira célula de cada coluna da nova aba, referencie a coluna correspondente da aba de origem — por exemplo, a placa do veículo, o nome do motorista associado, o estado de conectado ou desconectado e a latitude e a longitude da última posição. Repita para qualquer outra coluna que queira acompanhar.
Depois copie as células e arraste para baixo até a última linha do relatório de origem.
Atualize quando precisar
Clique em Run novamente no API Connector: os dados são atualizados na aba de origem e a análise acompanha.
Para ver os números agregados, crie uma tabela dinâmica sobre a aba de origem com:
- Linhas: em branco.
- Colunas: o campo de conexão do dispositivo (
last_location.is_plugged). - Valores: a placa do veículo (
vehicle.license_plate), com agregação COUNTA.
Os estados de conexão podem ser:
| Valor | Significado |
|---|---|
TRUE | Dispositivo conectado |
FALSE | Dispositivo desconectado |
| Vazio | A Cobli não pôde afirmar o estado no último momento — por falta de sinal ou GPS impreciso |
Caso 2: quem está dirigindo cada veículo
O processo é o mesmo do Caso 1, analisando a coluna de motorista associado em vez da de conexão do dispositivo.
Caso 3: quando e onde foi a última posição de um dispositivo
Traga os dados dos dispositivos
Faça a requisição da listagem de dispositivos com o API Connector, como acima.
Crie uma tabela dinâmica
Selecione todos os dados da planilha e vá em Dados > Tabela Dinâmica. Escolha Nova página e clique em Criar.
Escolha os campos
No Editor da Tabela Dinâmica, em Linhas, adicione devices.esn, devices.last_location.latitude, devices.last_location.longitude e devices.last_location.time.
Filtre os dispositivos ativos
Em Filtros, adicione devices.last_location.time e escolha a condição A célula não está vazia. Os dispositivos sem última localização deixam de aparecer.
Veja também
- Como integrar o Google Planilhas com as APIs da Cobli
- Cobli: relatórios no Google Sheets
- Consultar dispositivos: a mesma informação direto no painel.