Exportacao MDS para Cidades

Se voce concorre a permissoes municipais, mais cedo ou mais tarde um agente de conformidade vai pedir um feed de eventos de seguranca. O Levy Vision entrega uma exportacao em formato MDS que da exatamente isso — eventos de calcada, taxas de conformidade de capacete e contagens de violacao de estacionamento, escopadas por um poligono de jurisdicao e um intervalo de datas. Este artigo percorre como gerar uma e o que tem dentro.

Para quem isso e

• Operadores concorrendo a uma nova permissao municipal que precisam de um feed de amostra para a resposta da RFP
• Operadores com uma permissao ativa que inclui uma exigencia de relatorio de seguranca
• Agentes de conformidade municipal consumindo feeds Levy Fleets diretamente via API

Se voce nao se encaixa em nenhuma dessas condicoes, voce nao precisa deste recurso — pule para outros artigos nesta categoria.

O que e MDS

MDS (Mobility Data Specification) e o padrao aberto que a maioria das cidades dos EUA usa para consumir dados de operadores. Levy Fleets tem uma API completa MDS Provider para viagens e status; a exportacao de seguranca coberta aqui e um endpoint adicional que a complementa com eventos derivados de visao.

Cidades que assinaram o MDS incluem Chicago, San Francisco, Los Angeles, Austin, Atlanta, Seattle, Paris, Londres, Berlim e dezenas mais. Se sua cidade aceita feeds MDS, ela aceita este formato.

Gerando uma exportacao

1. Abra Dashboard > Safety > MDS export.
2. Defina o intervalo de datas. A maioria das cidades quer janelas mensais.
3. Escolha o poligono de jurisdicao:
   • Use saved polygon — escolha de poligonos que voce enviou anteriormente (limites da cidade, areas de servico personalizadas)
   • Draw on map — esboce o poligono a mao, util para relatorios pontuais
   • Paste GeoJSON — para cidades que enviam um poligono especifico na RFP
4. Escolha os tipos de evento a incluir. Padrao e todos (capacete, estacionamento, calcada).
5. Escolha o formato:
   • CSV — uma linha por evento, mais facil para humanos
   • MDS JSON — schema MDS estrito, o que cidades consomem programaticamente
6. Clique em Generate.

A exportacao e transmitida para um download. Para intervalos de datas grandes (mais de 30 dias em alto volume), a exportacao e enfileirada e voce recebera um email com o link de download quando estiver pronta.

O que esta na exportacao

Cada linha de evento inclui os campos que importam para conformidade, com PII do piloto removido.

Colunas comuns (todos os tipos de evento)

Extras de evento de capacete

• helmet_status — pass, fail, ambiguous, bypassed, inference_failed
• attempt_count — Quantas selfies o piloto tirou

Extras de evento de calcada

• enforcement_action — warn, speed_reduce, throttle_cut, none
• geofence_allowlist_hit — booleano, se este evento caiu dentro de um poligono de lista de permissao

Extras de evento de estacionamento

• parking_status — pass, fail, retake, appealed, approved_after_appeal, rejected_after_appeal
• upright, in_zone, blocking_sidewalk — o julgamento estruturado do classificador
• fee_applied_cents — o que o piloto foi cobrado

O que NAO esta na exportacao

• Identidade do piloto — nome, telefone, email nunca sao incluidos
• Selfies ou fotos de estacionamento — URLs de imagem sao removidas
• Detalhes de cartao ou pagamento — nunca incluidos
• Rotulos internos de subaccount — seus nomes internos permanecem internos

Se o contrato da cidade exige explicitamente PII (raro), contate o suporte para configurar uma exportacao personalizada com o acordo de processamento de dados apropriado.

Acesso direto a API para cidades

Algumas cidades querem puxar os dados programaticamente em vez de receber um relatorio manual mensal. O endpoint de exportacao esta disponivel em:

GET /api/dashboard/cv/exports/mds
  ?from=2026-04-01
  &to=2026-04-30
  &polygon_id=<uuid>
  &format=mds-json

A autenticacao e via token de API de longa duracao emitido para a conta da cidade. Contate o suporte para provisionar uma conta do lado da cidade com acesso somente leitura aos dados de seguranca das suas frotas. Tokens sao escopados por jurisdicao — uma cidade so pode puxar dados dentro do seu proprio poligono.

Relatorios mensais agregados

Algumas cidades querem totais, nao eventos linha por linha. A pagina de exportacao tambem oferece um modo Aggregated que retorna:

• Total de viagens na jurisdicao
• Taxa de conformidade de capacete (% de viagens com helmet_status=pass)
• Eventos de calcada por 100 viagens
• Taxa de violacao de estacionamento (% de viagens com parking_status=fail)
• Lista de hotspots — top 20 clusters lat/lng com contagens de eventos

Este e o formato que a maioria dos operadores envia para cidades mensalmente como um PDF de uma pagina ou email resumo. A pagina de exportacao tem um botao "Copy as Markdown" que da uma versao pronta para colar.

Dicas

• Salve seus poligonos comuns. A maioria dos operadores acaba com 2–4 jurisdicoes padrao; salvar evita redesenhar a cada vez.
• Rode um intervalo de datas menor primeiro. Se voce esta gerando para uma nova cidade, faca um teste de um dia primeiro para confirmar que o formato corresponde ao que eles querem.
• Compartilhe o schema previamente. Se a cidade nunca consumiu seu feed antes, envie este artigo e a referencia da API MDS Provider como parte da submissao da permissao. Reduz idas e vindas.

Perguntas comuns

Isso inclui eventos de antes de eu ativar o Levy Vision?

Nao. Eventos so existem a partir do momento que o Levy Vision e ativado para seu subaccount. Cidades entendem isso — a maioria pede os 30 ou 90 dias mais recentes.

Tem cobranca pela exportacao MDS?

Para a maioria dos planos, nao — esta incluso. Alguns planos de frota grande tem cobranca adicional para acesso direto a API por cidades (onde cidades puxam dados programaticamente em vez de receber exportacoes manuais).

E se minha cidade nao usa MDS?

A exportacao CSV e um arquivo de texto puro com os mesmos dados. Envie isso. Suportamos alguns formatos especificos de cidade (Atlanta usa um schema ligeiramente diferente, por exemplo); se sua cidade tem uma especificacao especifica, contate o suporte.