# Collection Source: https://docs.mobway.cloud/api-reference/collection Para facilitar a integração e os testes com a API, disponibilizamos uma coleção que contém todas as rotas e configurações necessárias. Siga os passos abaixo para começar a utilizá-la. ### 1. Baixar a Coleção Você pode baixar o arquivo da coleção diretamente daqui: [Baixar Coleção Postman](https://mobway.sharepoint.com/:u:/s/mobway/IQAPFhonNaDrTpQV8cNQWTlPAUIRbmPtCPtPO3f5yTWK0sg?e=l7NyaX) Salve o arquivo `mobway.postman_collection.json` em seu computador. ### 2. Importar a Coleção 1. Abra o aplicativo Postman. 2. Clique no botão "Import" no canto superior esquerdo. 3. Na janela que se abrir, você pode arrastar e soltar o arquivo `mobway.postman_collection.json` ou clicar em "Upload Files" para selecioná-lo. 4. Após o upload, a coleção "mobway" aparecerá na sua lista de coleções. 5. Leia a "Overview" da coleção no Postman. # POST vehicle-command Source: https://docs.mobway.cloud/api-reference/endpoint/command POST https://api.mobway.cloud/vehicle-command Envia um comando remoto para um veículo conectados à empresa Esta rota inicia a execução de um comando remoto para um único veículo específico. A execução do comando ocorre em segundo plano. Use a rota GET `/vehicle-command/{command_id}` para verificar o status do comando. Os comandos de ignição `enable_ignition` e `disable_ignition` exigem **confirmação em duas etapas**. Na primeira chamada (sem o campo `code`), o comando **não é executado**: a resposta retorna `status: "Confirmation"` com um `code` de 6 dígitos e uma `message` para exibir ao usuário. Para executar, reenvie a mesma requisição incluindo o `code` recebido. Os demais comandos executam em chamada única. ## Request ##### **Header** É o token ao portador utilizado para autenticar a empresa. Assinatura HMAC SHA256 do corpo da requisição, usando o **sign-secret** da aplicação como chave. O corpo deve ser serializado em JSON sem espaços extras e com chaves ordenadas alfabeticamente antes de gerar a assinatura. Veja o exemplo a seguir: ```python theme={null} data = {"vin": vin, "command": command} body = json.dumps(data, separators=(",", ":"), sort_keys=True) signature = hmac.new("SUA_SIGN_SECRET_FORNECIDA_PELA_MOBWAY", body.encode(), hashlib.sha256).hexdigest() ``` O campo `code` (quando enviado na segunda etapa dos comandos de ignição) **não** faz parte da assinatura, apenas `vin` e `command` são assinados. ##### **Body** Indica o Vehicle Identification Number (VIN) do veículo para o qual o comando será enviado. Indica o [comando remoto](https://docs.mobway.cloud/command/general) que se deseja executar no veículo. Indica o código de confirmação de 6 dígitos retornado na primeira etapa dos comandos de ignição (`enable_ignition` e `disable_ignition`). Informe-o para executar o comando na segunda chamada. Não se aplica aos demais comandos. ## Response Indica o identificador único (UUID) do comando registrado no sistema da mobway. Use este ID para verificar o status do comando posteriormente em GET `/vehicle-command/{command_id}`. Indica o número de identificação único do veículo. Indica o comando que foi solicitado. Indica o status inicial do comando. Pode ser "Confirmation", quando um comando de ignição aguarda a segunda etapa de confirmação (reenvio com o `code`), "Pending", em que o comando ainda não foi processado, ou "Error", quando o comando não foi executado corretamente. Indica a data e hora em que o comando foi registrado no sistema da mobway \[YYYY-MM-DD HH:MM:SS] (UTC-3). Indica o código de confirmação de 6 dígitos. Presente apenas na resposta de confirmação (`status: "Confirmation"`) dos comandos de ignição. Reenvie a requisição com este valor no campo `code` para executar o comando. Indica a mensagem de alerta, em português, a ser exibida ao usuário antes de confirmar a ação. Presente apenas na resposta de confirmação. Indica a cause do erro na requisição. Esse campo só estará presente em caso de falha na requisição. * "Invalid VIN. VIN must be a string. At least one VIN is required.": A requisição está mal formada pela falta do parâmetro obrigatório `vin`. * "Invalid command. Command must be a string. At least one command is required.": A requisição está mal formada pela falta do parâmetro obrigatório `command`. * "VIN not found or unauthorized access.": O VIN solicitado é inválido, não está associado à sua empresa, ou o tipo de propriedade do veículo não permite essa ação. * "Command not found or unauthorized access.": O comando solicitado não está disponível para este veículo, seja por restrições do OEM ou por não estar incluído no seu plano de pacotes. * "Sign-secret not found.": A assinatura HMAC fornecida no header X-Signature não corresponde a nenhum aplicação relacionada a empresa. * "X-Signature invalid.": A assinatura HMAC fornecida no header `X-Signature` não corresponde à assinatura calculada com base no corpo da requisição. * "Failed to send command to the OEM.": Ocorreu um erro ao tentar enviar o comando para o sistema da OEM. * "Failed to initiate command with the OEM or retrieve status URL.": Ocorreu um erro ao iniciar o comando com o OEM ou ao obter a URL necessária para verificar o status posteriormente. * "Confirmation invalid": O código de confirmação informado é inválido. Reinicie o fluxo enviando a requisição sem o campo `code` para obter um novo código. * "Confirmation already used": O código de confirmação já foi utilizado. Cada código é de uso único. Reinicie o fluxo enviando a requisição sem o campo `code` para obter um novo. ```bash Requisição theme={null} curl --request POST \ --url https://api.mobway.cloud/vehicle-command \ --header 'Authorization: Bearer ' \ --header 'X-Signature: ' \ --header 'Content-Type: application/json' \ --data '{ "vin": "{vin}", "command": "{command}" }' ``` ```bash Requisição Confirmação (2ª etapa dos comandos de ignição) theme={null} curl --request POST \ --url https://api.mobway.cloud/vehicle-command \ --header 'Authorization: Bearer ' \ --header 'X-Signature: ' \ --header 'Content-Type: application/json' \ --data '{ "vin": "{vin}", "command": "{command}", "code": "{code}" }' ``` ```json Resposta Pendente theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "diagnostics", "status": "Pending", "created": "2023-02-14 09:51:48" } ``` ```json Resposta Confirmação theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "disable_ignition", "status": "Confirmation", "code": "559289", "message": "" } ``` ```json Resposta Erro theme={null} { "detail": "X-Signature invalid." } ``` # POST vehicle-data Source: https://docs.mobway.cloud/api-reference/endpoint/data POST https://api.mobway.cloud/vehicle-data Retorna os dados dos veículos conectados à empresa Apesar de ser uma requisição POST, está rota não se destina a criar um recurso na API. Foi desenvolvida desta forma pela comodidade de customizar o payload a ser enviado no corpo da requisição. ## Request ##### **Header** É o token ao portador utilizado para autenticar a empresa. ##### **Body** Indica a lista de Vehicle Identification Number (VIN) dos veículos os quais se deseja recuperar os dados. * A quantidade de VINs deve ser no máximo 20 Indica a lista de [pontos de dados](/data/general) que se deseja recuperar dos veículos. É um parâmetro opcional e pode ser usado para filtrar a data de início dos dados. Deve ser enviado nos seguintes formatos: * YYYY-MM-DD Para os propósitos do filtro, será considerado o seguinte horário: YYYY-MM-DDT00:00:00-03:00 (UTC-3) * YYYY-MM-DDTHH:MM:SS Para os propósitos do filtro, será considerado o seguinte horário: YYYY-MM-DDTHH:MM:SS-03:00 (UTC-3) * YYYY-MM-DDTHH:MM:SS-ZZ:00 Para os propósitos do filtro, será considerado exatamente o horário informado: YYYY-MM-DDTHH:MM:SS-ZZ:00 (UTC-Z) Também é um parâmetro opcional e pode ser usado para filtrar a data de fim dos dados. Deve ser enviado nos seguintes formatos: * YYYY-MM-DD Para os propósitos do filtro, será considerado o seguinte horário: YYYY-MM-DDT00:00:00-03:00 (UTC-3) * YYYY-MM-DDTHH:MM:SS Para os propósitos do filtro, será considerado o seguinte horário: YYYY-MM-DDTHH:MM:SS-03:00 (UTC-3) * YYYY-MM-DDTHH:MM:SS-ZZ:00 Para os propósitos do filtro, será considerado exatamente o horário informado: YYYY-MM-DDTHH:MM:SS-ZZ:00 (UTC-Z) * Quando forem utilizados start\_date e end\_date, o date\_time estará entre estas duas datas, da seguinte forma: end\_data >= datetime >= start\_date * Quando não forem utilizados o start\_date e o end\_date, será requisitado, por padrão, as últimas 24 horas a partir do momento da atual * Quando for utilizado apenas o start\_date, o end\_date será considerado, por padrão, como start\_date mais 24 horas * Quando for utilizado apenas o end\_date, o start\_date será considerado, por padrão, como end\_date menos 24 horas * O valor mínimo para o start\_date é do momento atual menos sete dias * O valor máximo para o end\_date é o momento atual * A diferença entre o start\_date e end\_date deve ser de no máximo 24 horas ## Response Para informações mais detalhadas sobre a resposta, consultar em [Pontos de Dados](https://docs.mobway.cloud/data/general) Indica o número de identificação único do veículo. Indica a data e hora do registro do conjunto de dados \[YYYY-MM-DD HH:MM:SS]. Indica separademente cada [pontos de dados](https://docs.mobway.cloud/data/general). Indica quando um dado foi considerado como errôneo e foi corrigido, contendo o dado do qual se trata, o valor original e o tipo do erro. * "VIN not found or unauthorized access.": O VIN solicitada é inválido ou não está associada à sua empresa. Verifique o VIN ou suas permissões. * "Unsupported datapoint for this vehicle.": O ponto de dado solicitado não está disponível para este veículo devido a restrições de compatibilidade com o OEM. * "Datapoint not included in your package plan.": O ponto de dado solicitado não está disponível no seu plano atual. Entre em contato com o suporte da mobway para mais assistência. * "No data for the given date range: start\_date to end\_date.": Nenhum dado foi encontrado para o intervalo de datas informado (start\_date a end\_date). Verifique se as datas estão corretas, confira o fuso horário ou tente selecionar um período diferente. * "start\_date is greater than end\_date.": A data inicial (start\_date) é posterior a data final (end\_date) informada. * "start\_date or end\_date are out of the range of 7 days.": As datas inicial ou final (start\_date ou end\_date) informadas são anteriores ao período máximo de 7 dias de disponibilidade. * "start\_date or end\_date are in the future.": As datas inicial ou final (start\_date ou end\_date) informadas são posteriores ao momento atual. * "Difference between start\_date and end\_date cannot exceed 24 hours.": A diferença entre o start\_date e end\_date é maior que 24 horas * "Too many VINs provided. Maximum allowed is 20.": A quantidade de VINs é maior que 20 ```bash Requisição theme={null} curl --request POST \ --url https://api.mobway.cloud/vehicle-data \ --header 'Authorization: Bearer ' \ --data '{ "vins": [ {vins} ], "datapoints": [ "vin", "date_time", "speed", "latitude", "longitude", "heading", "rpm", "odometer", "fuel_level", "range", "left_front_tire_pressure", "right_front_tire_pressure", "left_rear_tire_pressure", "right_rear_tire_pressure", "oil_level", "engine_cooling_temperature", "lv_battery_voltage", "hv_battery_voltage", "hv_battery_soc", "hv_battery_charging_status", "seat_belt_status", "event", "flag" ], "start_date": {start_date}, "end_date": {end_date} }' ``` ```json Resposta theme={null} { "6AHFT68CKAF501652": [ { "vin": "6AHFT68CKAF501652", "date_time": "2023-02-14 09:51:48", "speed": 109.78, "latitude": 56.073055, "longitude": -177.689265, "heading": 357.92, "rpm": 3737.16, "odometer": 806942.06, "fuel_level": 79.79, "range": -75.68, "left_front_tire_pressure": 31.66, "right_front_tire_pressure": 31.95, "left_rear_tire_pressure": 31.17, "right_rear_tire_pressure": 31.88, "oil_level": 15.28, "engine_cooling_temperature": 11.4, "lv_battery_voltage": 12.41, "hv_battery_voltage": 596.41, "hv_battery_soc": 38.48, "hv_battery_charging_status": "other", "seat_belt_status": "not buckled", "event": "charging plug status change", "flag": {} }, { "vin": "6AHFT68CKAF501652", "date_time": "2023-02-14 09:51:51", "speed": 265.23, "latitude": 56.089004, "longitude": -177.71086, "heading": 357.92, "rpm": 5591.89, "odometer": 806942.21, "fuel_level": 21.35, "range": -76.13, "left_front_tire_pressure": 31.66, "right_front_tire_pressure": 31.95, "left_rear_tire_pressure": 31.17, "right_rear_tire_pressure": 31.88, "oil_level": 95.38, "engine_cooling_temperature": 129.52, "lv_battery_voltage": None, "hv_battery_voltage": None, "hv_battery_soc": 17.87, "hv_battery_charging_status": "charging", "seat_belt_status": "not buckled", "event": "charging plug status change", "flag": { "lv_battery_voltage": { "value": 35.44, "flag": "out of range" }, "hv_battery_voltage": { "value": 1200.54, "flag": "out of range" } } } ] } ``` # GET vehicle-command/{command_id} Source: https://docs.mobway.cloud/api-reference/endpoint/status GET https://api.mobway.cloud/vehicle-command/{command_id} Verifica o status de um comando remoto enviado anteriormente. Use esta rota para verificar o status de um comando que foi iniciado através da rota POST `/vehicle-command`. ## Request ##### **Header** É o token ao portador utilizado para autenticar a empresa. ##### **Path Parameters** O identificador único (UUID) do comando, retornado na resposta da requisição POST `/vehicle-command`. ## Response Indica o identificador único (UUID) do comando registrado no sistema da mobway. Indica o número de identificação único do veículo. Indica o comando que foi solicitado. Indica o status atual do comando. Pode ser "Pending", em que o comando ainda não foi processado, "Success", quando o comando foi executado corretamente, ou "Error", quando o comando não foi executado corretamente. Indica detalhes adicionais sobre o resultado do comando. Em caso de sucesso, pode conter um objeto com informações retornadas pelo veículo. Em caso de erro, geralmente contém um texto com a descrição do erro, conforme a descrição abaixo. Será um objeto vazio enquanto o comando ainda estiver "Pending" ou quando o comando não retornar nenhuma informação adicional. * Erros na Requisição. Ocorrem quando há um problema entre o cliente o servidor da mobway, por exemplo uma requisição mal formada ou com acesso negado. * "Invalid command ID. Command ID must be a string. At least one command ID is required.": A requisição está mal formada pela falta do parâmetro obrigatório `command_id`. * "Command not found.": O `command_id` fornecido não corresponde a nenhum comando registrado. * "Access denied.": O comando solicitado pertence a uma aplicação diferente daquela associada ao token de autenticação utilizado. * Erros no Comando. Ocorrem quando há um problema entre o servidor da mobway e da montadora ou entre a montadora e o veículo, por exemplo quando o comando não consegue ser executado por estar fora da área de cobertura do sinal. * "Command timeout.": A requisição não conseguiu ser executada no tempo pré-determinado ou não obteve a resposta esperada do veículo. * "Commands blocked.": Comando recusado porque o veículo está em estado incompatível (ex: em movimento) ou não possui capacidade para processá-lo. * "Commands restrictions.": Comando não conseguiu ser executado completamente (ex: geolocalização do veículo está oculta por privacidade). * "Communication failures.": Conexão interrompida ou instável entre a rede e o veículo, impedindo troca de dados (ex: sinal fraco, falha de protocolo). * "Data retrieval failures.": Dados recebidos estão parcialmente disponíveis ou não foram coletados devido a erros de transmissão. * "Internal system failures.": Serviço fora do ar temporariamente ou erro crítico em processos internos. * "Invalid input.": Comando enviado inclui informações inválidas, incompletas ou opções não reconhecidas. * "Unauthorized access.": Sessão expirada ou tentativa de acesso a recursos restritos sem privilégios adequados. * "Unsupported commands.": Funcionalidade indisponível para o modelo ou falta de autorização para ação. Indica a data e hora da última atualização do status do comando no sistema da mobway \[YYYY-MM-DD HH:MM:SS] (UTC-3). Se o valor for igual ao `created` em POST `/vehicle-command`, quer dizer que o comando ainda não teve nenhuma atualização no sistema da mobway. Os três valores de data e hora por comando são: * created: quando o comando foi registrado no sistema da mobway (POST `/vehicle-command`) * date\_time: quando o comando foi executado pelo veículo * updated: quando a mobway recebeu a resposta do comando ```bash Requisição theme={null} curl --request GET \ --url https://api.mobway.cloud/vehicle-command/{command_id} \ --header 'Authorization: Bearer ' ``` ```json Resposta Sucesso theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "diagnostics", "status": "Success", "detail": { "fuel_amount": 43.47, "fuel_capacity": 44.0, "fuel_level": 98.8, "fuel_range": 542.37, "ideal_front_tire_pressure": 34.81, "ideal_rear_tire_pressure": 34.81, "left_front_tire_pressure": 33.07, "left_front_tire_pressure_status": "nominal", "left_rear_tire_pressure": 31.91, "left_rear_tire_pressure_status": "nominal", "odometer": 76140.81, "oil_remaining_life": 53.3, "oil_remaining_life_status": "normal", "right_front_tire_pressure": 31.91, "right_front_tire_pressure_status": "nominal", "right_rear_tire_pressure": 31.33, "right_rear_tire_pressure_status": "nominal", "seat_belt_status": "not buckled", "system_power_mode": "off", "total_fuel_economy": 12.32, "total_fuel_used": 6766.5, "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` ```json Resposta Erro theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "diagnostics", "status": "Error", "detail": "Command timeout.", "updated": "2023-02-14 09:53:48" } ``` ```json Resposta Pendente theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "diagnostics", "status": "Pending", "detail": {}, "updated": "2023-02-14 09:51:48" } ``` # POST token Source: https://docs.mobway.cloud/api-reference/endpoint/token POST https://api.mobway.cloud/token Retorna um token JWT com 1 hora (3600 segundos) de expiração, utilizando autenticação baseada no padrão OAuth2 com client_id e client_secret. ## Request ##### **Header** Define o formato esperado para a resposta. Deve ser definido como `application/json`. ##### **Body** O corpo da requisição deve incluir as credenciais de autenticação do cliente, conforme o padrão OAuth2: O client ID fornecido pela mobway para o seu aplicativo. O client secret fornecido pela mobway para o seu aplicativo. Deve ser mantido em sigilo. O client\_id e o client\_secret são únicos por empresa/aplicação e não devem ser compartilhados! ## Response Indica o token a ser usado nas outras rotas como header Authentication. Indica o tempo de expiração do token em segundos. Está definido, por padrão, para expirar em 1 hora (3600 segundos). ```bash Requisição theme={null} curl --request POST \ --url https://api.mobway.cloud/token \ --header 'accept: application/json' \ --data-urlencode 'client_id=' \ --data-urlencode 'client_secret=' ``` ```json Resposta theme={null} { "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjb21wYW55IjoibW9id2F5IiwiZXhwaXJhdGlvbiI6IjIwMjMtMTAtMTdUMTg6Mzc6MTkuNzkwMDMyIn0.lqqJBTvzoO1JhK0z8KBH_lw1eZA65DnIvu4VaaVv7yI", "expiration": 3600 } ``` # GET vehicle Source: https://docs.mobway.cloud/api-reference/endpoint/vehicle GET https://api.mobway.cloud/vehicle Retorna as informações dos veículos conectados à empresa. ## Request ##### **Header** É o token ao portador utilizado para autenticar a empresa. ## Response Indica a empresa à qual o veículo está conectado. Indica o Vehicle Identification Number (VIN). Indica placa do veículo. Indica a montadora (OEM) do veículo. Indica o modelo do veículo. Indica o ano do veículo. Indica o status de conexão do veículo com a mobway. * Caso "active", o veículo está conectado e enviando dados. Indica quando a conexão do veículo com a mobway foi criada. ```bash Requisição theme={null} curl --request GET \ --url https://api.mobway.cloud/vehicle \ --header 'Authorization: Bearer ' ``` ```json Resposta theme={null} [ { "company": "mobway", "vin": "8DMBK45KGIC435803", "plate": "TBUJ740", "oem": "OEM 1", "model": "Modelo 1", "year": 2021, "status": "active", "created": "2021-04-20T12:42:44", }, { "company": "mobway", "vin": "8DMBK45KGIC435804", "plate": "TBUJ741", "oem": "OEM 2", "model": "Modelo 2", "year": 2021, "status": "active", "created": "2021-04-20T12:42:44", } ] ``` # GET vehicle/{vin} Source: https://docs.mobway.cloud/api-reference/endpoint/vin GET https://api.mobway.cloud/vehicle/{vin} Retorna as informações do veículo conectado a empresa. ## Request ##### **Header** É o token ao portador utilizado para autenticar a empresa. ##### **Path** Indica o Vehicle Identification Number (VIN) do veículo ao qual se deseja recuperar as informações. ## Response Indica a empresa à qual o veículo está conectado. Indica o Vehicle Identification Number (VIN). Indica placa do veículo. Indica a montadora (OEM) do veículo. Indica o modelo do veículo. Indica o ano do veículo. Indica o status de conexão do veículo com a mobway. * Caso "active", o veículo está conectado e enviando dados. Indica quando a conexão do veículo com a mobway foi criada. ```bash Requisição theme={null} curl --request GET \ --url https://api.mobway.cloud/vehicle/{vin} \ --header 'Authorization: Bearer ' ``` ```json Resposta theme={null} { "company": "mobway", "vin": "8DMBK45KGIC435803", "plate": "TBUJ740", "oem": "OEM 1", "model": "Modelo 1", "year": 2021, "status": "active", "created": "2021-04-20T12:42:44", } ``` # Autenticação via OAuth2 Source: https://docs.mobway.cloud/api-reference/key A mobway utiliza o padrão OAuth2 para autenticação, garantindo maior segurança e conformidade com os padrões modernos de autenticação. Cada empresa possui credenciais únicas compostas por um **client\_id** e um **client\_secret**, que devem ser utilizados para gerar o token de acesso na rota [/token](https://docs.mobway.cloud/api-reference/endpoint/token). ## Como obter as credenciais de acesso Para obter seu **client\_id** e **client\_secret**, entre em contato com a mobway através do e-mail: [info@mobway.cloud](mailto:info@mobway.cloud). ## Como utilizar as credenciais de acesso Na rota [/token](https://docs.mobway.cloud/api-reference/endpoint/token), envie as credenciais no corpo da requisição como um formulário utilizando os seguintes campos: ```bash theme={null} POST /token HTTP/1.1 Content-Type: application/x-www-form-urlencoded username=&password= ``` ### Exemplo de Requisição ```bash theme={null} curl -X POST https://api.mobway.cloud/token \ -H "accept: application/json" \ -d "username=&password=" ``` A resposta será um token JWT com informações sobre a empresa e o tempo de expiração do token. Esse token deve ser utilizado nas demais requisições para autenticação. As credenciais (client\_id e client\_secret) são únicas por empresa e não devem ser compartilhadas! ## O que fazer se tiver um problema com as credenciais Caso tenha algum problema com suas credenciais, entre em contato com a mobway através do e-mail: [support@mobway.cloud](mailto:support@mobway.cloud). É importante que o **client\_id** e o **client\_secret** sejam mantidos em local seguro e não sejam compartilhados com terceiros. Não armazene essas credenciais em repositórios públicos ou diretamente no código-fonte. No caso de qualquer suspeita de que suas credenciais foram comprometidas, entre em contato com a mobway para que as credenciais sejam desabilitadas e recriadas. # Token Source: https://docs.mobway.cloud/api-reference/token É um token ao portador (Bearer) gerado através da rota [/token](https://docs.mobway.cloud/api-reference/endpoint/token) utilizando o [Client ID e Client Secret](https://docs.mobway.cloud/api-reference/key). O token é utilizado para autenticar as requisições feitas para as rotas da API (exceto para [/token](https://docs.mobway.cloud/api-reference/endpoint/token), na qual o token é gerado). ## Como obter o token É preciso fazer um requisição na rota [/token](https://docs.mobway.cloud/api-reference/endpoint/token) utilizando o [Client ID e Client Secret](https://docs.mobway.cloud/api-reference/key). ## Como utilizar o token Nas rotas da API (exceto [/token](https://docs.mobway.cloud/api-reference/endpoint/token)), é necessário enviar o token no header da requisição (Authorization), da seguinte forma: ```bash theme={null} "Authorization": "Bearer " ``` ## Tempo de expiração O token está definido, por padrão, para expirar em 1 hora (3600 segundos) # Webhook Source: https://docs.mobway.cloud/api-reference/webhook Para garantir a autenticidade de um webhook, é utilizada uma assinatura digital gerada a partir do payload da mensagem e uma chave secreta (**sign-secret**). A **sign-secret** é criada pela mobway no momento da configuração do webhook e deve ser mantida em sigilo. ## Como a assinatura é gerada A assinatura do webhook é gerada utilizando o método HMAC (Hash-based Message Authentication Code) com o algoritmo SHA-256. Esse método combina a **sign-secret** com os dados enviados (payload) para criar uma assinatura única. Qualquer modificação no conteúdo ou no cabeçalho do webhook alterará a assinatura, tornando evidente qualquer tentativa de adulteração. ## Exemplo de código (Python) para consumir o Webhook O exemplo a seguir demonstra como criar uma interface para receber dados de veículos em tempo real via Webhook usando Python e a biblioteca Flask. Este aplicativo precisa ser hospedado online em uma URL que possa ser acessada pela mobway para o envio das informações. ```python theme={null} import hmac import json import logging import asyncio import hashlib import threading from flask import Flask, request, jsonify, abort app = Flask(__name__) # chave secreta fornecida pela mobway SIGN_SECRET = 'SUA_SIGN_SECRET_FORNECIDA_PELA_MOBWAY' logging.basicConfig(level=logging.INFO) def verify_signature(payload, signature): """ Verifica a autenticidade da assinatura do webhook. Args: payload (str): O conteúdo do webhook recebido. signature (str): A assinatura HMAC recebida no cabeçalho do webhook. Returns: bool: True se a assinatura for válida, False caso contrário. """ logging.info("Verificando assinatura...") computed_signature = hmac.new(SIGN_SECRET.encode(), payload.encode(), hashlib.sha256).hexdigest() is_valid = hmac.compare_digest(computed_signature, signature) logging.info(f"Assinatura válida: {is_valid}") return is_valid def process_data(data): """ Processa os dados recebidos do webhook. Args: data (dict): Dados do payload em formato JSON. """ logging.info(f"Processando dados: {data}") # Aqui você pode adicionar a lógica para tratar os dados recebidos async def handle_request(payload, signature): """ Lida com a requisição do webhook, verificando a assinatura e processando o payload. Args: payload (str): O conteúdo do webhook recebido. signature (str): A assinatura HMAC recebida no cabeçalho do webhook. """ if not verify_signature(payload, signature): logging.warning("Assinatura inválida, abortando...") abort(403) logging.info("Assinatura verificada com sucesso, processando requisição...") data = json.loads(payload) thread = threading.Thread(target=process_data, args=(data,)) thread.start() thread.join() @app.route('/', methods=['GET']) def home(): """ Rota básica para verificação de status do servidor. Returns: Response: Retorna uma mensagem de sucesso. """ return jsonify({"status": "success"}), 200 @app.route('/webhook', methods=['POST']) async def webhook(): """ Rota para receber os dados do webhook. Returns: Response: Retorna uma mensagem de sucesso após o processamento do webhook. """ logging.info("Webhook recebido...") payload = request.get_data(as_text=True) signature = request.headers.get('X-Signature') await handle_request(payload, signature) logging.info("Webhook processado com sucesso!") return jsonify({"status": "success"}), 200 if __name__ == '__main__': logging.info("Iniciando aplicativo Flask...") app.run(host='0.0.0.0', port=5000, debug=True) ``` A rota `/webhook`, é onde o servidor espera receber os webhooks enviados pela mobway. Essa rota é configurada para aceitar apenas requisições HTTP do tipo `POST`. A função `webhook` associada a essa rota é assíncrona, o que permite ao servidor lidar com múltiplas requisições simultaneamente de maneira eficiente, sem bloquear a execução enquanto processa as requisições anteriores. Dentro da função `webhook`, o payload (os dados do webhook) e a assinatura digital são extraídos da requisição. A assinatura é enviada no cabeçalho da requisição sob o nome `X-Signature`. A função então delega a verificação da assinatura e o processamento dos dados para a função `handle_request`. O servidor da mobway que envia os dados via webhook espera um código de resposta HTTP 200, indicando que os dados foram recebidos com sucesso. Caso qualquer outro código de erro seja retornado, o servidor tentará reenviar os dados sucessivamente até atingir um limite pré-definido. Para garantir que nenhum dado seja perdido, as informações são armazenadas, permitindo que sejam consultadas por outros meios, se necessário. Se o problema no recebimento dos dados persistir, o envio via webhook será interrompido, e a mobway entrará em contato para verificar e resolver a situação. A função `handle_request` é responsável por validar a autenticidade da assinatura e processar os dados recebidos. Ela recebe o payload e a assinatura como parâmetros. Primeiramente, ela chama a função `verify_signature` para comparar a assinatura recebida com a assinatura esperada. A validação é feita utilizando HMAC com o algoritmo SHA-256, combinando o payload com a **sign-secret** armazenada no servidor. Se a assinatura não for válida, a função aborta a operação, retornando um código de status HTTP 403, indicando que a requisição foi rejeitada por falta de autenticidade. Caso a assinatura seja válida, os dados são convertidos de uma string JSON para um dicionário e processados em uma thread separada. A função `verify_signature` desempenha um papel crucial na segurança do webhook. Ela gera a assinatura localmente utilizando HMAC com SHA-256 e a **sign-secret**, e em seguida, compara essa assinatura com a assinatura recebida na requisição. ## Exemplo de payload O payload abaixo é enviado ao cliente assim que os dados do veículo são recebidos e processados pela mobway. A estrutura inclui todos os dados disponíveis que o cliente tem permissão para acessar, organizados por VIN: ```json Resposta theme={null} { "6AHFT68CKAF501652": [ { "vin": "6AHFT68CKAF501652", "date_time": "2023-02-14 09:51:48", "speed": 109.78, "latitude": 56.073055, "longitude": -177.689265, "heading": 357.92, "rpm": 3737.16, "odometer": 806942.06, "fuel_level": 79.79, "range": -75.68, "left_front_tire_pressure": 31.66, "right_front_tire_pressure": 31.95, "left_rear_tire_pressure": 31.17, "right_rear_tire_pressure": 31.88, "oil_level": 15.28, "engine_cooling_temperature": 11.4, "lv_battery_voltage": 12.41, "hv_battery_voltage": 596.41, "hv_battery_soc": 38.48, "hv_battery_charging_status": "other", "seat_belt_status": "not buckled", "event": "charging plug status change", "flag": {} }, { "vin": "6AHFT68CKAF501652", "date_time": "2023-02-14 09:51:51", "speed": 265.23, "latitude": 56.089004, "longitude": -177.71086, "heading": 357.92, "rpm": 5591.89, "odometer": 806942.21, "fuel_level": 21.35, "range": -76.13, "left_front_tire_pressure": 31.66, "right_front_tire_pressure": 31.95, "left_rear_tire_pressure": 31.17, "right_rear_tire_pressure": 31.88, "oil_level": 95.38, "engine_cooling_temperature": 129.52, "lv_battery_voltage": None, "hv_battery_voltage": None, "hv_battery_soc": 17.87, "hv_battery_charging_status": "charging", "seat_belt_status": "not buckled", "event": "charging plug status change", "flag": { "lv_battery_voltage": { "value": 35.44, "flag": "out of range" }, "hv_battery_voltage": { "value": 1200.54, "flag": "out of range" } } } ] } ``` Este payload é enviado em tempo real sempre que novos dados são recebidos pela mobway, garantindo que o cliente tenha acesso imediato às informações mais atualizadas dos veículos monitorados. # Alertas Source: https://docs.mobway.cloud/command/alerts Comandos relacionados a alerta do veículo. ### alert Aciona alerta * Descrição: aciona o sistema de alerta do veículo com ativação da buzina e luzes. Serve, por exemplo, para situações de difícil localização do veículo. O alerta cessa após 30 segundos. É possível enviar outros alertas em sequência. * Exemplo: ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "alert", "status": "Success", "detail": { "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` ### cancel\_alert Cancela alerta * Descrição: cancela o comando de alerta enviado previamente. * Pré-condições: * O alerta precisa ter sido acionado previamente por comando remoto. * Exemplo: ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "cancel_alert", "status": "Success", "detail": { "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` # Portas Source: https://docs.mobway.cloud/command/doors Comandos relacionados as portas do veículo. ### lock\_door Trancar portas * Descrição: tranca as portas quando as pré-condições de segurança estabelecidas pelo veículo são cumpridas (verificar abaixo). * Pré-condições: * O veículo não pode estar em movimento. * Exemplo: ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "lock_door", "status": "Success", "detail": { "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` ### unlock\_door Destrancar portas * Descrição: destranca as portas quando as pré-condições de segurança estabelecidas pelo veículo são cumpridas (verificar abaixo). * Pré-condições: * O veículo não pode estar em movimento. * Exemplo: ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "unlock_door", "status": "Success", "detail": { "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` # Geral Source: https://docs.mobway.cloud/command/general Esta página apresenta um overview de todos os comandos disponibilizados pelo veículo. Para mais detalhes a respeito de um comando, você pode consultar a página da categoria correspondente ## [Informações](https://docs.mobway.cloud/command/informations) Esta categoria apresenta os comandos relacionados as informações do veículo. ### [location](https://docs.mobway.cloud/command/informations#location) Requisita a localização atual do veículo ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "diagnostics", "status": "Success", "detail": { "latitude": 34.0567236, "longitude": -118.2451370, "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` ### [diagnostics](https://docs.mobway.cloud/command/informations#diagnostics) Requisita dados de diagnóstico do veículo ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "diagnostics", "status": "Success", "detail": { "fuel_amount": 43.47, "fuel_capacity": 44.0, "fuel_level": 98.8, "fuel_range": 542.37, "ideal_front_tire_pressure": 34.81, "ideal_rear_tire_pressure": 34.81, "left_front_tire_pressure": 33.07, "left_front_tire_pressure_status": "nominal", "left_rear_tire_pressure": 31.91, "left_rear_tire_pressure_status": "nominal", "odometer": 76140.81, "oil_remaining_life": 53.3, "oil_remaining_life_status": "normal", "right_front_tire_pressure": 31.91, "right_front_tire_pressure_status": "nominal", "right_rear_tire_pressure": 31.33, "right_rear_tire_pressure_status": "nominal", "seat_belt_status": "not buckled", "system_power_mode": "off", "total_fuel_economy": 12.32, "total_fuel_used": 6766.5, "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` ## [Portas](https://docs.mobway.cloud/command/doors) Esta categoria apresenta os comandos relacionados as portas do veículo. ### [lock\_door](https://docs.mobway.cloud/command/doors#lock-door) Trava as portas do veículo ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "lock_door", "status": "Success", "detail": { "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` ### [unlock\_door](https://docs.mobway.cloud/command/doors#unlock-door) Destrava as portas do veículo ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "unlock_door", "status": "Success", "detail": { "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` ## [Alerta](https://docs.mobway.cloud/command/alerts) Esta categoria apresenta os comandos relacionados a alerta do veículo. ### [alert](https://docs.mobway.cloud/command/alerts#alert) Aciona o alerta do veículo (buzinas e luzes) ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "alert", "status": "Success", "detail": { "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` ### [cancel\_alert](https://docs.mobway.cloud/command/alerts#cancel-alert) Cancela o alerta do veículo (buzinas e luzes) ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "cancel_alert", "status": "Success", "detail": { "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` ## [Ignição](https://docs.mobway.cloud/command/ignitions) Esta categoria apresenta os comandos relacionados a ignição do veículo. ### [enable\_ignition](https://docs.mobway.cloud/command/ignitions#enable-ignition) Ativa a ignição do veículo ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "enable_ignition", "status": "Success", "detail": { "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` ### [disable\_ignition](https://docs.mobway.cloud/command/ignitions#disable-ignition) Desativa a ignição do veículo ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "disable_ignition", "status": "Success", "detail": { "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` ### [start](https://docs.mobway.cloud/command/ignitions#start) Aciona remotamente o veículo ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "start", "status": "Success", "detail": { "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` ### [cancel\_start](https://docs.mobway.cloud/command/ignitions#cancel-start) Cancela o acionamento remoto do veículo ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "cancel_start", "status": "Success", "detail": { "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` # Ignição Source: https://docs.mobway.cloud/command/ignitions Comandos relacionados a ignição do veículo. Os comandos `enable_ignition` e `disable_ignition` dependem da área de cobertura do sinal de telefonia para comunicação com o veículo. É fundamental assegurar que o veículo esteja acessível e conectado antes de enviar qualquer um desses comandos. Caso um deles seja executado e o veículo fique fora da área de cobertura, poderá ser necessária uma intervenção física. Por segurança, `enable_ignition` e `disable_ignition` exigem **confirmação em duas etapas**. Na primeira chamada (sem o campo `code`), o comando **não é executado**: a resposta retorna `status: "Confirmation"`, um `code` de 6 dígitos e uma `message` para exibir ao usuário. Para executar, reenvie a mesma requisição incluindo o `code` recebido. Detalhes em [POST vehicle-command](/api-reference/endpoint/command). Exemplo da resposta da primeira etapa (confirmação): ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "disable_ignition", "status": "Confirmation", "code": "559289", "message": "" } ``` **Requisitos e responsabilidades de uso (desativação de ignição)** A desativação remota da ignição é uma funcionalidade sensível. Ao utilizá-la, a sua empresa é responsável por garantir que: * O acesso aos comandos de ignição seja restrito a usuários autorizados, não liberado a todos os usuários. * O comando seja iniciado apenas pela sua empresa, e não por terceiros. * O veículo seja de propriedade da sua empresa, alugado, ou esteja legalmente sob a sua frota. * Haja consentimento do usuário final do veículo. * O uso se restrinja a situações em que o veículo esteja desaparecido, com suspeita razoável de furto ou roubo, ou em uso não autorizado. * Seus procedimentos internos tenham sido concluídos antes do envio, incluindo, quando aplicável, a tentativa de localizar o veículo pelas APIs disponíveis, conforme a legislação aplicável. * Tenha havido uma tentativa de notificar o usuário final antes do envio. * Tenham sido feitos esforços razoáveis para confirmar que a desativação pode ser concluída com segurança. Após desativar, reative a ignição (`enable_ignition`) assim que não for mais seguro ou necessário manter o veículo desativado. ## enable\_ignition Ativa ignição * Descrição: habilita a ignição quando as pré-condições de segurança estabelecidas pelo veículo são cumpridas (verificar abaixo). * Pré-condições: * O veículo precisa estar desligado. * A ignição do veículo precisa ter sido desabilitada previamente por comando remoto. * Exemplo: ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "enable_ignition", "status": "Success", "detail": { "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` ## disable\_ignition Desativa ignição * Descrição: desabilita a ignição quando as pré-condições de segurança estabelecidas pelo veículo são cumpridas (verificar abaixo). Um aviso será mostrado no painel do veículo. * Pré-condições: * O veículo precisa estar desligado. * Exemplo: ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "disable_ignition", "status": "Success", "detail": { "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` ## start Aciona remotamente * Descrição: aciona remotamente quando as pré-condições de segurança estabelecidas pelo veículo são cumpridas (verificar abaixo). * Pré-condições: * O capô do motor deve estar fechado. * O tanque de combustível não deve estar na reserva. * A tensão da bateria deve estar em níveis adequados. * O pisca-alerta não deve estar ligado. * A transmissão deve estar na posição de “Park” (P). * Não deve haver luzes de anomalia no painel do veículo. O veículo não deve ter realizado mais de duas partidas remotas consecutivas com sucesso. Para que a próxima partida remota seja bem-sucedida, o cliente deve ligar o carro fisicamente antes de tentar novamente. * Exemplo: ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "start", "status": "Success", "detail": { "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` ## cancel\_start Cancela acionamento remoto * Descrição: cancela o acionamento remoto do veículo enviando anteriormente ou desliga o veículo caso ele tenha sido ligado via comando remoto e não tenha ligado a ignição manualmente. * Pré-condições: * O veículo precisa ter sido acionado remotamente previamente por comando remoto. * Exemplo: ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "cancel_start", "status": "Success", "detail": { "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` # Informações Source: https://docs.mobway.cloud/command/informations Comandos relacionados as informações de localização e diagnóstico do veículo. ## location Localização * Descrição: latitude, longitude, date e hora de quando o comando foi executado no veículo. * Latitude e Longitude: * Formato: numérico * Unidade: ° * Casas decimais: 7 * O dado tratado pela mobway sempre terá no máximo 7 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 7 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Date e Hora: * Formato: yyyy-mm-dd hh:mm:ss * Fuso horário: UTC -3 (Horário de Brasília) * É a data e hora que o comando foi executado no veículo. Não é a data e hora em que o comando chegou no banco de dados da montadora. Quando o horário fornecido pelo veículo estiver em outro fuso horário, ele será convertido para UTC -3 * Exemplo: ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "diagnostics", "status": "Success", "detail": { "latitude": 34.0567236, "longitude": -118.2451370, "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` ## diagnostics Diagnóstico * Descrição: estado atual do veículo, com alguns pontos de dados disponíveis e a data e hora de quando o comando foi executado no veículo. * Pontos de Dados: * Formato: dicionário (chave e valor) * A definição para cada ponto de dados segue o que está [aqui](https://docs.mobway.cloud/data/general). A disponibilidade de cada um deles depende do modelo e do ano do veículo. * Date e Hora: * Formato: yyyy-mm-dd hh:mm:ss * Fuso horário: UTC -3 (Horário de Brasília) * Não é a data e hora em que o comando chegou no banco de dados da montadora. Quando o horário fornecido pelo veículo estiver em outro fuso horário, ele será convertido para UTC -3 * Exemplo: ```json theme={null} { "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5", "vin": "6AHFT68CKAF501652", "command": "diagnostics", "status": "Success", "detail": { "fuel_amount": 43.47, "fuel_capacity": 44.0, "fuel_level": 98.8, "fuel_range": 542.37, "ideal_front_tire_pressure": 34.81, "ideal_rear_tire_pressure": 34.81, "left_front_tire_pressure": 33.07, "left_front_tire_pressure_status": "nominal", "left_rear_tire_pressure": 31.91, "left_rear_tire_pressure_status": "nominal", "odometer": 76140.81, "oil_remaining_life": 53.3, "oil_remaining_life_status": "normal", "right_front_tire_pressure": 31.91, "right_front_tire_pressure_status": "nominal", "right_rear_tire_pressure": 31.33, "right_rear_tire_pressure_status": "nominal", "seat_belt_status": "not buckled", "system_power_mode": "off", "total_fuel_economy": 12.32, "total_fuel_used": 6766.5, "date_time": "2023-02-14 09:52:48" }, "updated": "2023-02-14 09:53:48" } ``` # Modelos conectados no Brasil Source: https://docs.mobway.cloud/compatible A lista a seguir não implica integração direta com a plataforma mobway, mas indica que esses modelos oferecem serviços de conectividade de dados em nuvem com o fabricante, o que abre oportunidades para futuras integrações com a mobway ## Chevrolet | Modelo | Modelo Fipe | Ano Modelo | | - | - | :-: | | CRUZE SEDAN | CRUZE LT 1.4 16V TURBO FLEX 4P AUT. | 21 | | CRUZE SEDAN | CRUZE LTZ 1.4 16V TURBO FLEX 4P AUT. | 21 | | CRUZE SEDAN | CRUZE Premier 1.4 16V TB Flex Aut. | 21 | | CRUZE SPORT | CRUZE Sport LT 1.4 16V TB Flex 5p Aut. | 21 | | CRUZE SPORT | CRUZE Sport LTZ 1.4 16V TB Flex 5p Aut. | 21 | | CRUZE SPORT | CRUZE Sport Premier 1.4 16V TB Flex Aut. | 21 | | CRUZE SEDAN | CRUZE LT 1.4 16V TURBO FLEX 4P AUT. | 20 | | CRUZE SPORT | CRUZE Sport LT 1.4 16V TB Flex 5p Aut. | 20 | | CRUZE SEDAN | CRUZE Premier 1.4 16V TB Flex Aut. | 20 | | CRUZE SPORT | CRUZE Sport Premier 1.4 16V TB Flex Aut. | 20 | | ONIX | ONIX HATCH LT 1.0 12V TB FLEX 5P MEC. | 20 | | ONIX | ONIX HATCH LT 1.0 12V TB FLEX 5P AUT. | 20 | | ONIX | ONIX LTZ AT TURBO 116cv | 20 | | ONIX | ONIX LTZ MT TURBO 116cv | 20 | | ONIX PLUS | ONIX PLUS LT 4 PORTAS - MOTOR 1.0L | 20 | | ONIX PLUS | ONIX PLUS SEDAN LT 1.0 12V TB FLEX AUT. | 20 | | ONIX PLUS | ONIX SEDAN Plus LTZ 1.0 12V TB Flex Aut. | 20 | | ONIX PLUS | Onix Sedan Plus LTZ 1.0 12V TB Flex Mec. | 20 | | TRACKER | TRACKER 1.0 TURBO 12V FLEX MEC. | 21 | | TRACKER | TRACKER LTZ 4 PORTAS - MOTOR 1.2 TURBO | 21 | | TRACKER | TRACKER 1.2 TURBO 12V FLEX AUT. | 21 | | TRACKER | TRACKER 1.0 TURBO 12V FLEX AUT. (PCD) | 21 | | TRACKER | TRACKER LTZ 1.0 TURBO 12V FLEX AUT. | 21 | | TRACKER | TRACKER LT 1.0 Turbo 12V Flex Aut. | 21 | | S10 | S10 LTZ CABINE DUPLA 4X4 - MOTOR 2.5L ECOTEC | 22 | | CRUZE SPORT | CRUZE LT 1.4 16V TURBO FLEX 4P AUT. | 22 | | CRUZE SPORT | CRUZE LTZ 1.4 16V TURBO FLEX 4P AUT. | 22 | | CRUZE SPORT | CRUZE Premier 1.4 16V TB Flex Aut. | 22 | | CRUZE SPORT | CRUZE Sport LT 1.4 16V TB Flex 5p Aut. | 22 | | CRUZE SPORT | CRUZE Sport LTZ 1.4 16V TB Flex 5p Aut. | 22 | | CRUZE SPORT | CRUZE Sport Premier 1.4 16V TB Flex Aut. | 22 | | ONIX | ONIX HATCH PREM. 1.0 12V TB Flex 5p Aut. | 22 | | ONIX | ONIX HATCH RS 1.0 TB 12V Flex 5p Aut. | 22 | | ONIX | ONIX HATCH LTZ 1.0 12V TB Flex 5p Aut. | 22 | | ONIX | ONIX HATCH LTZ 1.0 12V TB Flex 5p Mec. | 22 | | ONIX PLUS | ONIX SED. Plus PREM. 1.0 12V TB Flex Aut | 22 | | ONIX PLUS | ONIX SD. P. PR. MIDNIGHT 1.0 TB Flex Aut | 22 | | ONIX PLUS | ONIX SEDAN Plus LTZ 1.0 12V TB Flex Aut. | 22 | | ONIX PLUS | Onix Sedan Plus LTZ 1.0 12V TB Flex Mec. | 22 | | TRACKER | TRACKER Premier 1.2 Turbo 12V Flex Aut. | 22 | | TRACKER | TRACKER Premier 1.0 Turbo 12V Flex Aut. | 22 | | TRACKER | TRACKER LTZ 1.0 TURBO 12V FLEX AUT. | 22 | | TRACKER | TRACKER LT 1.0 Turbo 12V Flex Aut. | 22 | | TRAILBLAZER | TRAILBLAZER PREMIER 2.8 TB Diesel Aut. | 22 | | S10 | S10 Pick-Up Advantage 2.5 Flex 4x2 CD | 22 | | S10 | S10 Pick-Up LTZ 2.8 TDI 4x4 CD Flex.Aut | 22 | | S10 | S10 Pick-Up LTZ 2.8 TDI 4x4 CD Dies.Aut | 22 | | S10 | S10 P-Up H.Country 2.8 4x4 CD Dies.Aut. | 22 | | CAMARO | Camaro SS 6.2 V8 16V | 22 | | CAMARO | Camaro SS Conversível 6.2 V8 16V | 22 | | EQUINOX | EQUINOX Premier 1.5 Turbo 172cv Aut. | 22 | | CRUZE SEDAN | CRUZE Midnight 1.4 16V TB Flex Aut. | 22 | | CRUZE SPORT | CRUZE Sport LT 1.4 16V TB Flex 5p Aut. | 22 | | CRUZE SPORT | CRUZE Sport LTZ 1.4 16V TB Flex 5p Aut. | 22 | | CRUZE SPORT | CRUZE Sport Premier 1.4 16V TB Flex Aut. | 22 | | CRUZE SPORT | CRUZE Sport RS 1.4 16V TB Flex 5p Aut. | 22 | | ONIX | ONIX HATCH PREM. 1.0 12V TB Flex 5p Aut. | 21 | | ONIX PLUS | ONIX SED. Plus PREM. 1.0 12V TB Flex Aut | 21 | | TRACKER | TRACKER Premier 1.2 Turbo 12V Flex Aut. | 21 | | TRACKER | TRACKER Premier 1.0 Turbo 12V Flex Aut. | 21 | | TRACKER | TRACKER LTZ 1.0 Turbo 12V Flex Aut. | 21 | | TRAILBLAZER | TRAILBLAZER PREMIER 2.8 TB Diesel Aut. | 21 | | S10 | S10 Pick-Up Advantage 2.5 Flex 4x2 CD | 21 | | S10 | S10 Pick-Up LTZ 2.8 TDI 4x2 CD Flex.Aut | 21 | | S10 | S10 Pick-Up LTZ 2.8 TDI 4x4 CD Flex.Aut | 21 | | S10 | S10 Pick-Up LTZ 2.8 TDI 4x4 CD Dies.Aut | 21 | | S10 | S10 P-Up H.Country 2.8 4x4 CD Dies.Aut. | 21 | | ONIX | ONIX HATCH LT 1.0 12V Flex 5p Mec. | 23 | | ONIX | ONIX HATCH LT 1.0 12V TB Flex 5p Mec. | 23 | ## Ford | Modelo | Ano | Código Fipe | | - | :-: | :-: | | Bronco Sport Wildtrak 2.0 Tb 16V AWD Aut | 2022 | 003481-9 | | Maverick Lariat FX4 2.0 EcoBoost Aut. | 2022 | 003485-1 | | Mustang MACH 1 5.0 V8 | 2022 | 003480-0 | | TERRITORY Titanium 1.5 GTDi EcoBo. Aut. | 2022 | 003478-9 | | Ranger Black 2.2 4x2 CD Diesel Aut. | 2022 | 003479-7 | | Ranger FX4 3.2 20V 4x4 CD Diesel Aut. | 2022 | 003486-0 | | Ranger Limited 3.2 4x4 CD Diesel Aut. | 2022 | 003364-2 | | Ranger Storm 3.2 20V 4x4 CD Diesel Aut. | 2022 | 003476-2 | | Ranger XL 2.2 4x4 CD Diesel Mec. | 2022 | 003426-6 | | Ranger XL 2.2 4x4 CS Diesel Mec. | 2022 | 003433-9 | | Ranger XLS 2.2 4x2 CD Diesel Aut. | 2022 | 003454-1 | | Ranger XLS 2.2 4x4 CD Diesel Aut. | 2022 | 003421-5 | | Ranger XLT 3.2 20V 4x4 CD Diesel Aut. | 2022 | 003363-4 | | TRANSIT Furgão 2.0 Longo Turbo Diesel | 2022 | 003488-6 | | TRANSIT Minibus 15 Lug. 2.0 16V Diesel | 2022 | 003483-5 | | TRANSIT Minibus 18 Lug. 2.0 16V Diesel | 2022 | 003484-3 | | TRANSIT Minibus Vidrada 2.0 16V Diesel | 2022 | 003482-7 | | Bronco Sport Wildtrak 2.0 Tb 16V AWD Aut | 2023 | 003481-9 | | F-150 Lariat 4x4 5.0 V8 | 2023 | 003489-4 | | F-150 Platinum 4x4 5.0 V8 | 2023 | 003490-8 | | Maverick Lariat FX4 2.0 EcoBoost Aut. | 2023 | 003485-1 | | Maverick Lariat Hybrid 2.5 Aut. | 2023 | 003495-9 | | Mustang MACH 1 5.0 V8 | 2023 | 003480-0 | | Ranger Black 2.2 4x2 CD Diesel Aut. | 2023 | 003479-7 | | Ranger FX4 3.2 20V 4x4 CD Diesel Aut. | 2023 | 003486-0 | | Ranger Limited 3.2 4x4 CD Diesel Aut. | 2023 | 003364-2 | | Ranger Storm 3.2 20V 4x4 CD Diesel Aut. | 2023 | 003476-2 | | Ranger XL 2.2 4x4 CD Diesel Mec. | 2023 | 003426-6 | | Ranger XL 2.2 4x4 CS Diesel Mec. | 2023 | 003433-9 | | Ranger XLS 2.2 4x2 CD Diesel Aut. | 2023 | 003454-1 | | Ranger XLS 2.2 4x4 CD Diesel Aut. | 2023 | 003421-5 | | Ranger XLT 3.2 20V 4x4 CD Diesel Aut. | 2023 | 003363-4 | | TRANSIT Furgão 2.0 Curto Turbo Diesel | 2023 | 003487-8 | | TRANSIT Furgão 2.0 Longo Turbo Die Aut. | 2023 | 003494-0 | | TRANSIT Furgão 2.0 Longo Turbo Diesel | 2023 | 003488-6 | | TRANSIT Minibus 15 Lug. 2.0 16V Die Aut. | 2023 | 003491-6 | | TRANSIT Minibus 15 Lug. 2.0 16V Diesel | 2023 | 003483-5 | | TRANSIT Minibus 18 Lug. 2.0 16V Die Aut. | 2023 | 003492-4 | | TRANSIT Minibus 18 Lug. 2.0 16V Diesel | 2023 | 003484-3 | | TRANSIT Minibus Vidrada 2.0 16V Die Aut. | 2023 | 003493-2 | | TRANSIT Minibus Vidrada 2.0 16V Diesel | 2023 | 003482-7 | | Ranger Limited 3.0 V6 4x4 CD TB Die. Aut | 2024 | 003497-5 | | Ranger Limited+ 3.0 V6 4x4 CD TB Die Aut | 2024 | 003498-3 | | Ranger XLT 3.0 V6 4x4 CD TB Die. Aut. | 2024 | 003496-7 | | Ranger Limited 3.0 V6 4x4 CD TB Die. Aut | - | 003497-5 | | Ranger Limited+ 3.0 V6 4x4 CD TB Die Aut | - | 003498-3 | | Ranger XLT 3.0 V6 4x4 CD TB Die. Aut. | - | 003496-7 | ## Hyundai | Modelo | | - | | Creta Action 1.6 AT | | Creta Comfort TGDI 1.0 AT | | Creta Limited TGDI 1.0 AT | | Creta Platinum TGDI 1.0 AT | | Creta Ultimate 2.0 SmartStream AT | | HB20 Sense TGDI 1.0 AT | | HB20 Vision TGDI 1.0 AT | | HB20 Evolution 1.0 MT | | HB20 Platinum TGDI 1.0 AT | | HB20 Platinum Plus TGDI 1.0 AT | | HB20S Vision 1.0 MT | | HB20S Evolution 1.0 MT | | HB20S Platinum TGDI 1.0 MT | | HB20S Platinum Plus TGDI 1.0 AT | | HB20 Sport Nova Geração TGDI 1.0 AT | ## Fiat
Modelo Ano
DUCATO CARGO 24+
DUCATO MAXICARGO 24+
DUCATO MAXICARGO HEAVY 24+
DUCATO MINIBUS CONFORT 24+
DUCATO MINIBUS LUXO 24+
FASTBACK ABARTH 25+
FASTBACK AUDACE HIBRIDO 25+
FASTBACK IMPETUS HIBRIDO 25+
FASTBACK LIMITED EDITION 25+
PULSE ABARTH 25+
PULSE IMPETUS HIBRIDO 25+
SCUDO CARGO 25+
SCUDO MULTI 25+
STRADA RANCH 26+
STRADA ULTRA 26+
TORO FREEDOM 25+
TORO RANCH 25+
TORO ULTRA 25+
TORO VOLCANO 25+
## Jeep
Modelo Ano
COMMANDER LIMITED 25+
COMMANDER OVERLAND 25+
COMPASS BLACKHAWK HURRICANE 25+
COMPASS LONGITUDE 25+
COMPASS SERIE S 25+
RENEGADE ALTITUDE 25+
RENEGADE LONGITUDE 25+
RENEGADE SAHARA 25+
RENEGADE WILLYS 25+
## RAM
Modelo Ano
RAM 1500 LARAMIE 25+
RAM 1500 LARAMIE NIGHT EDITION 25+
RAM 2500 LARAMIE 25+
RAM 3500 LARAMIE NIGHT EDITION 25+
RAM 3500 LIMITED LONGHORN 25+
RAMPAGE BIG HORN 25+
RAMPAGE LARAMIE 25+
RAMPAGE R/T 25+
RAMPAGE REBEL 25+
# Processo de Consentimento Source: https://docs.mobway.cloud/compliance Nossa estrutura de consentimento foi criada para garantir a conformidade com a Lei Geral de Proteção de Dados (LGPD) e seguir as práticas recomendadas de transparência e privacidade desde a concepção. Confira [aqui](https://www.mobway.cloud/privacy-first) tudo sobre como funciona a transparência na mobway ### Consentimento do proprietário Antes de acessar os dados de qualquer veículo, garantimos que temos o consentimento explícito do proprietário do veículo. Utilizando informações como o [VIN](https://docs.mobway.cloud/vin), esse consentimento é obtido por meio de um processo claro e direto em que o proprietário é informado sobre: * Quais dados serão coletados: Fornecemos uma lista detalhada dos dados do veículo que pretendemos coletar. * Porque precisamos desses dados: Explicamos como esses dados serão usados e por que são necessários para a prestação de nossos serviços. * Quem terá acesso a esses dados: Informamos quais são os terceiros com os quais esses dados possam ser compartilhados. * O proprietário do veículo tem o direito de retirar seu consentimento a qualquer momento. ### Transparência Acreditamos na transparência total sobre a coleta e uso dos dados. [Aqui](https://www.mobway.cloud/privacy-first) temos uma maneira visual e clara sobre nossos termos de uso, fornecendo informações detalhadas sobre os dados que coletamos, como os usamos, como os protegemos e os direitos do proprietário. ### Privacy by design Privacy by design é um princípio fundamental em nosso processo de desenvolvimento de produtos. Isso significa que consideramos as implicações de privacidade em todas as etapas do desenvolvimento do produto e implementamos as frameworks adequados para proteger os dados do proprietário. ### Conformidade com a LGPD Estamos em conformidade com todas as disposições da LGPD. Isso inclui obter o consentimento explícito antes de coletar dados pessoais, fornecer informações claras sobre nossas práticas de dados, garantir a segurança dos dados que coletamos e respeitar os direitos dos titulares dos dados. Lembre-se de que sua confiança é importante para nós. Se tiver alguma dúvida ou preocupação sobre nossa estrutura de consentimento ou práticas de privacidade, entre em contato conosco pelo e-mail [support@mobway.cloud](mailto:support@mobway.cloud). # Consumo de dados Source: https://docs.mobway.cloud/consuming A mobway oferece duas maneiras principais de acessar os dados dos veículos conectados: em tempo real, através de streaming via webhook, e de forma sob demanda, utilizando nossa API para acessar dados históricos. Cada uma dessas abordagens é projetada para atender diferentes necessidades e casos de uso. Para aplicações que necessitam de dados em tempo real, a mobway oferece um mecanismo de streaming através de webhooks. Com essa abordagem, assim que novos dados do veículo são recebidos e processados pela mobway, eles são imediatamente enviados para o endpoint configurado pelo cliente. Isso garante que você tenha acesso instantâneo a informações críticas, como eventos do veículo ou atualizações de telemetria, permitindo uma reação rápida e precisa. #### Vantagens do Streaming via Webhook: * **Imediatez**: Receba dados assim que eles forem gerados, sem a necessidade de consultas periódicas. * **Eficiência**: Reduza a carga na sua infraestrutura, recebendo apenas os dados novos sem precisar consultar constantemente a API. * **Escalabilidade**: Adequado para cenários onde grandes volumes de dados são gerados e precisam ser processados em tempo real. Além do streaming em tempo real, você também pode acessar dados históricos dos veículos conectados utilizando nossa API. Essa abordagem é ideal para quando você precisa analisar períodos específicos de tempo, realizar auditorias, ou gerar relatórios baseados em dados passados. Basta fornecer um intervalo de datas utilizando os parâmetros 'start\_date' e 'end\_date' para obter os dados necessários. #### Vantagens do Consumo via API: * **Flexibilidade**: Consulte dados de acordo com a necessidade da sua aplicação, com a possibilidade de especificar intervalos de tempo precisos. * **Temporalidade**: Explore o histórico completo dos veículos conectados, ideal para análises retroativas ou geração de relatórios. * **Controle**: Defina exatamente quais dados deseja acessar, filtrando por períodos relevantes para sua aplicação. ## Escolhendo o Modo Adequado A escolha entre streaming em tempo real e consumo sob demanda via API depende do caso de uso específico da sua aplicação. Para situações onde a velocidade e a resposta imediata são essenciais, o streaming via webhook é a melhor opção. Já para análises detalhadas e acesso a dados passados, a API com consultas por intervalo de datas oferece a flexibilidade e o controle necessários. # Bateria Source: https://docs.mobway.cloud/data/battery Dados relacionados à bateria de baixa tensão ## lv\_battery\_voltage Tensão da Bateria LV * Descrição: tensão da bateria de baixa tensão (LV) * Formato: numérico * Unidade: V * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 16 V * A faixa de tensão da bateria LV foi definida com base nos valores limite atingidos por uma bateria de 12 V, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "lv_battery_voltage": { "value": 35.44, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "lv_battery_voltage": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "lv_battery_voltage": 12.45 } ``` ## lv\_battery\_soc Estado de Carga da Bateria LV * Descrição: estado de carga da bateria de baixa tensão (LV) * Formato: numérico * Unidade: % * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 100% * A faixa do estado de carga bateria LV foi definida com base nos valores limite por definição * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "lv_battery_soc": { "value": -5.24, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "lv_battery_soc": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "lv_battery_soc": 43.57 } ``` ## lv\_battery\_current Corrente da Bateria LV * Descrição: estado de carga da bateria de baixa tensão (LV) * Formato: numérico * Unidade: % * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 10 A * A faixa da corrente da bateria LV foi definida com base nos valores limite atingidos por uma bateria de 12 V, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "lv_battery_current": { "value": 15.47, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "lv_battery_current": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "lv_battery_current": 1.02 } ``` # Freio Source: https://docs.mobway.cloud/data/brake Dados relacionados ao freio ## front\_brake\_pad\_remaining\_life Vida Restante dos Discos de Freio Dianteiro * Descrição: estimativa do quão gastos os discos de freio dianteiro estão * Formato: numérico * Unidade: % * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 100 % * A faixa da vida restante do disco de freio dianteiro foi definida com base nos valores limite por definição * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "front_brake_pad_remaining_life": { "value": 155.15, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "front_brake_pad_remaining_life": { "flag": "missing data" } } ``` * Formato de dados incorreto * É gerada uma flag indicando que o dado recebido estava no formato incorreto, neste caso uma valor textual ao invés de um valor numérico, e uma descrição para o significado deste dado, no seguinte formato: ```json theme={null} { "front_brake_pad_remaining_life": { "value": "Invalid", "meaning": "the data is unreliable", "flag": "incorrect data format" } } ``` * Exemplo: ```json theme={null} { "front_brake_pad_remaining_life": 49.45 } ``` ## rear\_brake\_pad\_remaining\_life Vida Restante dos Discos de Freio Traseiro * Descrição: estimativa do quão gastos os discos de freio traseiro estão * Formato: numérico * Unidade: % * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 100 % * A faixa da vida restante do disco de freio dianteiro foi definida com base nos valores limite por definição * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "rear_brake_pad_remaining_life": { "value": 251.11, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "rear_brake_pad_remaining_life": { "flag": "missing data" } } ``` * Formato de dados incorreto * É gerada uma flag indicando que o dado recebido estava no formato incorreto, neste caso uma valor textual ao invés de um valor numérico, e uma descrição para o significado deste dado, no seguinte formato: ```json theme={null} { "rear_brake_pad_remaining_life": { "value": "Invalid", "meaning": "the data is unreliable", "flag": "incorrect data format" } } ``` * Exemplo: ```json theme={null} { "rear_brake_pad_remaining_life": 19.68 } ``` ## invalid\_front\_brake\_pad Identificação de Disco de Freio Dianteiro Inválido * Descrição: identifica que os discos de freio dianteiro precisam ser trocados * Formato: categórico * Valores: * invalid front\_brake\_pad\_remaining\_life (front\_brake\_pad\_remaining\_life inválido) * Descrição: indica que o dado front\_brake\_pad\_remaining\_life é inválido * other (outro) * Descrição: indica que o veículo enviou um sinal de uma categoria não mapeada pela mobway ```json theme={null} { "invalid_front_brake_pad": "invalid front_brake_pad_remaining_life" } ``` ## invalid\_rear\_brake\_pad Identificação de Disco de Freio Traseiro Inválido * Descrição: identifica que os discos de freio traseiro precisam ser trocados * Formato: categórico * Valores: * invalid rear\_brake\_pad\_remaining\_life (rear\_brake\_pad\_remaining\_life inválido) * Descrição: indica que o dado rear\_brake\_pad\_remaining\_life é inválido * other (outro) * Descrição: indica que o veículo enviou um sinal de uma categoria não mapeada pela mobway ```json theme={null} { "invalid_rear_brake_pad": "invalid rear_brake_pad_remaining_life" } ``` ## brake\_pad\_life\_status Estado dos Discos de Freio * Descrição: identifica o estado dos discos de freio * Formato: categórico * Valores: * change now (troque agora) * Descrição: indica que os discos de freio precisam ser trocados * change soon (troque em breve) * Descrição: indica que os discos de freio em breve precisarão ser trocados * disabled feature (funcionalidade desabilitada) * Descrição: indica que o recebimento deste dado está desabilitado * invalid feature (funcionalidade inválida) * Descrição: indica que os dados relacionados aos discos de freio são inválidos * no action required (sem ação necessária) * Descrição: indica que não é preciso tomar nenhuma ação * not available feature (funcionalidade indisponível) * Descrição: indica que o recebimento deste dado é indisponível neste veículo * ok (ok) * Descrição: indica que os discos de freio estão ok * maintenance required (manutenção necessária) * Descrição: indica que os discos de freio precisam de manutenção * other (outro) * Descrição: indica que o veículo enviou um sinal de uma categoria não mapeada pela mobway ```json theme={null} { "brake_pad_life_status": "change now" } ``` # Rede de Celular Source: https://docs.mobway.cloud/data/cellular Dados relacionados à rede de celular do veículo ## cellular\_signal\_strength Intensidade do Sinal de Celular * Descrição: intensidade do sinal de celular do veículo * Formato: categórico * Valores: * max * Descrição: indica que a intensidade do sinal de celular é máxima * 4 * Descrição: indica que a intensidade do sinal de celular é alta * 3 * Descrição: indica que a intensidade do sinal de celular é média * 2 * Descrição: indica que a intensidade do sinal de celular é baixa * 1 * Descrição: indica que a intensidade do sinal de celular é muito baixa * 0 * Descrição: indica a ausência de sinal de celular * other (outro) * Descrição: indica que o veículo enviou um sinal de uma categoria não mapeada pela mobway ```json theme={null} { "cellular_signal_strength": "4" } ``` ## cellular\_service Serviço de Celular * Descrição: tipo de serviço da rede de celular utilizado pelo veículo * Formato: categórico * Valores: * 4G LTE * Descrição: indica que o veículo utiliza a rede de celular 4G LTE * 3G * Descrição: indica que o veículo utiliza a rede de celular 3G * 2G * Descrição: indica que o veículo utiliza a rede de celular 2G * no service (sem serviço) * Descrição: indica que o veículo não está conectado a uma rede de celular * other (outro) * Descrição: indica que o veículo enviou um sinal de uma categoria não mapeada pela mobway ```json theme={null} { "cellular_service": "4G LTE" } ``` # Detalhes Source: https://docs.mobway.cloud/data/details Dados relacionados a identificação da data e hora e pela indicação de dados errôneos ## date\_time Data e Hora * Descrição: data e hora em que os dados foram gerados pelo veículo * Não é a data e hora em que os dados chegaram ao banco de dados da montadora. * Formato: yyyy-mm-dd hh:mm:ss * Fuso horário: UTC -3 (Horário de Brasília) * Quando o horário fornecido pelo veículo estiver em outro fuso horário, ele será convertido para UTC -3 * Exemplo: ```json theme={null} { "date_time": "2023-08-09 20:02:45" } ``` ## flag Flag * Descrição: indicação que um dado foi considerado como errôneo, contendo o dado do qual se trata, o valor original e o tipo do erro * Formato: lista de dicionários * Exemplo: ```json theme={null} { "hv_battery_soc": { "value": 153.14, "flag": "out of range" }, "range": { "flag": "missing data" }, "odometer": { "value": 43345.71, "flag": "variation out of limit" }, "front_brake_pad_remaining_life": { "value": "Invalid", "meaning": "the data is unreliable", "flag": "incorrect data format" }, "speed": { "value": 10E-30, "flag": "unable to process" } } ``` # Condução Source: https://docs.mobway.cloud/data/driving Dados relacionados à condução do veículo ## accelerator\_pedal\_position Posição do Pedal do Acelerador * Descrição: posição do pedal do acelerador * Formato: numérico * Unidade: % * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 100% * A faixa da posição do pedal do acelerador foi definida com base nos valores limite por definição * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "accelerator_pedal_position": { "value": 120.50, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "accelerator_pedal_position": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "accelerator_pedal_position": 23.50 } ``` ## longitudinal\_acceleration Aceleração Longitudinal * Descrição: aceleração longitudinal do veículo, com sinal (positivo ou negativo) conforme enviado pela montadora * Formato: numérico * Unidade: m/s² * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: -100 a 100 m/s² * A faixa da aceleração longitudinal foi definida com base no valor máximo que os veículos conectados à mobway podem atingir, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "longitudinal_acceleration": { "value": 150.00, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "longitudinal_acceleration": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "longitudinal_acceleration": 1.25 } ``` ## lateral\_acceleration Aceleração Lateral * Descrição: aceleração lateral do veículo, com sinal (positivo ou negativo) conforme enviado pela montadora * Formato: numérico * Unidade: m/s² * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: -100 a 100 m/s² * A faixa da aceleração lateral foi definida com base no valor máximo que os veículos conectados à mobway podem atingir, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "lateral_acceleration": { "value": 150.00, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "lateral_acceleration": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "lateral_acceleration": -0.85 } ``` # Motor Source: https://docs.mobway.cloud/data/engine Dados relacionados ao funcionamento e estado do motor ## rpm Rotações por Minuto * Descrição: rotações por minuto do motor * Formato: numérico * Unidade: rpm * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 10000 rpm * A faixa de rpm foi definida com base no valor máximo que os veículos conectados à mobway podem atingir, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "rpm": { "value": -1014.38, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "rpm": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "rpm": 3567.89 } ``` ## oil\_level Nível de Óleo * Descrição: quantidade de óleo de lubrificação do motor * Formato: numérico * Unidade: % * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 100% * A faixa do nível de óleo foi definida com base nos valores limite por definição * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "oil_level": { "value": 125.60, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "oil_level": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "oil_level": 82.37 } ``` ## oil\_remaining\_life Vida Útil do Óleo * Descrição: percentual de vida útil restante do óleo do motor * Formato: numérico * Unidade: % * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 100% * A faixa da vida útil do óleo foi definida com base nos valores limite por definição * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "oil_remaining_life": { "value": 107.12, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "oil_remaining_life": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "oil_remaining_life": 37.92 } ``` ## oil\_remaining\_life\_status Status da Vida Útil do Óleo * Descrição: status da vida útil restante do óleo do motor * Formato: categórico * Valores: * extremely low (extremamente baixa) * Descrição: indica que o status da vida útil restante do óleo do motor é extremamente baixa * low (baixa) * Descrição: indica que o status da vida útil restante do óleo do motor do pneu é baixa * normal (normal) * Descrição: indica que o status da vida útil restante do óleo do motor é normal * unknown (desconhecido) * Descrição: indica que o status da vida útil restante do óleo do motor é desconhecido * Exemplo: ```json theme={null} { "oil_remaining_life_status": "normal" } ``` ## engine\_coolant\_temperature Temperatura do Líquido de Arrefecimento do Motor * Descrição: temperatura do líquido de arrefecimento do motor * Formato: numérico * Unidade: °C * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: -15°C a 150°C * O valor mínimo da temperatura do líquido de arrefecimento do motor foi definida com base na temperatura do ambiente mínima atingida no Brasil, considerando uma margem de segurança. O valor máximo da temperatura do líquido de arrefecimento do motor foi definida com base nos valores máximos comumente atingidos, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "engine_coolant_temperature": { "value": -25.34, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "engine_coolant_temperature": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "engine_coolant_temperature": 98.75 } ``` ## total\_engine\_idle\_time Tempo Total com Motor Ocioso * Descrição: tempo total em que o motor está ligado, porém o veículo está parado * Formato: numérico * Unidade: s * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 100000000 s * O valor limite do tempo total com motor ocioso foi definido com base no tempo equivalente a 8h diárias ao longo de 10 anos * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "total_engine_idle_time": { "value": -1023.12, "flag": "out of range" } } ``` * Variação mínima e máxima: 0 e (1.1x + 2)s por segundo * As variações mínima e máxima do tempo total com motor ocioso foram definidas para desconsiderar pequenas imprecisões * Dados com variação fora do limite permitido em relação ao dado anterior são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "total_engine_idle_time": { "value": 43368.81, "flag": "variation out of limit" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "total_engine_idle_time": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "total_engine_idle_time": 9728308.75 } ``` ## total\_engine\_run\_time Tempo Total com Motor em Utilização * Descrição: tempo total em que o motor está ligado com o veículo andando * Formato: numérico * Unidade: s * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 300000000 s * O valor limite do tempo total com motor em utilização foi definido com base no tempo equivalente a 24h diárias ao longo de 10 anos * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "total_engine_run_time": { "value": -1352.86, "flag": "out of range" } } ``` * Variação mínima e máxima: 0 e (1.1x + 2)s por segundo * As variações mínima e máxima do tempo total com motor em utilização foram definidas para desconsiderar pequenas imprecisões * Dados com variação fora do limite permitido em relação ao dado anterior são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "total_engine_run_time": { "value": 37268.11, "flag": "variation out of limit" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "total_engine_run_time": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "total_engine_run_time": 73920308.35 } ``` ## engine\_air\_filter\_diagnostic Diagnóstico do Filtro de Ar do Motor * Descrição: indica a falha que esta atingindo o filtro de ar do motor * Formato: categórico * Valores: * blocked (bloqueado) * Descrição: indica que o filtro de ar do motor está bloqueado * inactive (inativo) * Descrição: indica que o filtro de ar do motor está inativo. Todos os dados relacionados ao filtro de ar do motor devem ser ignorados * indeterminate issue (falha indeterminada) * Descrição: indica que uma falha indeterminada foi encontrada no filtro de ar do motor * missing (ausente) * Descrição: indica que o filtro de ar do motor não foi detectado * ok (ok) * Descrição: indica que o filtro de ar do motor está ok * other (outro) * Descrição: indica que o veículo enviou um sinal de uma categoria não mapeada pela mobway ```json theme={null} { "engine_air_filter_diagnostic": "blocked" } ``` ## engine\_air\_filter\_status Estado do Filtro de Ar do Motor * Descrição: indica o estado do filtro de ar do motor * Formato: categórico * Valores: * disabled feature (funcionalidade desabilitada) * Descrição: indica que os dados ralacionados ao filtro de ar do motor estão desabilitados * invalid feature (funcionalidade inválida) * Descrição: indica que os dados ralacionados ao filtro de ar do motor são inválidos * ok (ok) * Descrição: indica que o filtro de ar do motor está ok * change now (troque agora) * Descrição: indica que o filtro de ar do motor deve ser trocado agora * change soon (troque em breve) * Descrição: indica que o filtro de ar do motor deve ser trocado em breve * other (outro) * Descrição: indica que o veículo enviou um sinal de uma categoria não mapeada pela mobway ```json theme={null} { "engine_air_filter_status": "change now" } ``` ## engine\_air\_filter\_remaining\_life Vida Restante do Filtro de Ar do Motor * Descrição: estimativa do quão gasto o filtro de ar do motor está * Formato: numérico * Unidade: % * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 100 % * A faixa da vida restante do filtro de ar do motor foi definida com base nos valores limite por definição * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "engine_air_filter_remaining_life": { "value": 132.12, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "engine_air_filter_remaining_life": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "engine_air_filter_remaining_life": 91.98 } ``` ## engine\_oil\_temperature Temperatura do Óleo do Motor * Descrição: temperatura do óleo lubrificante do motor * Formato: numérico * Unidade: °C * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: -15°C a 180°C * O valor mínimo da temperatura do óleo do motor foi definida com base na temperatura do ambiente mínima atingida no Brasil, considerando uma margem de segurança. O valor máximo da temperatura do óleo do motor foi definida com base nos valores máximos comumente atingidos, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "engine_oil_temperature": { "value": 255.00, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "engine_oil_temperature": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "engine_oil_temperature": 92.50 } ``` # EV Source: https://docs.mobway.cloud/data/ev Dados relacionados ao funcionamento e recarga de um veículo elétrico ## hv\_battery\_voltage Tensão da Bateria de alta tensão (HV) * Descrição: tensão da bateria de alta tensão * Formato: numérico * Unidade: V * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Disponibilidade: Este dado esta disponível apenas em veículos elétricos ou híbridos * Faixa: 0 a 1000 V * A faixa de tensão da bateria HV foi definida com base no valor máximo que os veículos conectados à mobway podem atingir, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "hv_battery_voltage": { "value": 1005.89, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "hv_battery_voltage": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "hv_battery_voltage": 625.89 } ``` ## hv\_battery\_soc Estado de Carga da Bateria HV * Descrição: estado de carga da bateria de alta tensão * Formato: numérico * Unidade: % * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Disponibilidade: Este dado esta disponível apenas em veículos elétricos ou híbridos * Faixa: 0 a 100% * A faixa do estado de carga da bateria hv foi definida com base nos valores limite por definição * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "hv_battery_soc": { "value": 153.14, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "hv_battery_soc": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "hv_battery_soc": 73.42 } ``` ## hv\_battery\_charging\_status Estado de Carregamento da Bateria HV * Descrição: estado de carregamento da bateria de alta tensão * Formato: categórico * Valores: * charging (carregando) * Descrição: indica que a bateria hv está carregando * not charging (não carregando) * Descrição: indica que a bateria hv não está carregando * charged (carregado) * Descrição: indica que o carregamento da bateria hv terminou * charging error (erro de carregamento) * Descrição: indica que ocorreu um erro no carregamento da bateria hv * other (outro) * Descrição: indica que este estado de carregamento da bateria hv não foi mapeado pela mobway * Disponibilidade: Este dado esta disponível apenas em veículos elétricos ou híbridos * Exemplo: ```json theme={null} { "hv_battery_charging_status": "charging" } ``` # Eventos Source: https://docs.mobway.cloud/data/event Dados relacionados ao evento que atuou como gatilho para o envio dos dados ## event Evento * Descrição: evento que atuou como gatilho para o envio dos dados * Formato: categórico * Valores: * periodic data (dados periódicos) * Descrição: indica que o veículo enviou um sinal periódico. O período pode variar de acordo com o modelo do veículo, geralmente estando na casa de alguns segundos ou minutos * periodic geolocation (geolocalização periódica) * Descrição: indica que o veículo enviou um sinal periódico com sua posição geográfica. O intervalo pode variar conforme o modelo, geralmente de alguns segundos ou minutos * periodic data key off mode (dados periódicos com ignição desligada) * Descrição: indica que o veículo enviou um sinal periódico com a ignição desligada * ignition on (ignição ligada) * Descrição: indica que o veículo enviou um sinal quando foi ligado * ignition off (ignição desligada) * Descrição: indica que o veículo enviou um sinal quando foi desligado * motive mode begin (modo de tração iniciado) * Descrição: indica que o veículo enviou um sinal quando o modo de propulsão foi iniciado, ou seja, quando o motor começou a entregar torque para as rodas * motive mode end (modo de tração encerrado) * Descrição: indica que o veículo enviou um sinal quando o modo de propulsão foi encerrado, ou seja, quando o motor deixou de entregar torque para as rodas * powertrain active (sistema de tração ativado) * Descrição: indica que o veículo enviou um sinal quando o sistema de tração foi ativado * powertrain inactive (sistema de tração inativado) * Descrição: indica que o veículo enviou um sinal quando o sistema de tração foi inativado * hard braking (freada brusca) * Descrição: indica que o veículo enviou um sinal quando freiou bruscamento, ou seja, teve uma diminuição de velocidade acima do comum * excessive rpm (rotação do motor excessiva) * Descrição: indica que o veículo enviou um sinal quando o motor operou com rotação acima do limite considerado normal * door opened while driving (porta aberta com o veículo em movimento) * Descrição: indica que o veículo enviou um sinal quando uma porta estava aberta enquanto o veículo estava em movimento * driver seat belt unbuckled while moving (motorista desafivelou o cinto em movimento) * Descrição: indica que o veículo enviou um sinal quando o motorista retirou o cinto de segurança enquanto o veículo estava em movimento * driver seat belt buckled while moving (motorista afivelou o cinto em movimento) * Descrição: indica que o veículo enviou um sinal quando o motorista colocou o cinto de segurança enquanto o veículo estava em movimento * front passenger seat belt unbuckled while moving (passageiro desafivelou o cinto em movimento) * Descrição: indica que o veículo enviou um sinal quando o passageiro dianteiro retirou o cinto de segurança com o veículo em movimento * front passenger seat belt buckled while moving (passageiro afivelou o cinto em movimento) * Descrição: indica que o veículo enviou um sinal quando o passageiro dianteiro colocou o cinto enquanto o veículo estava em movimento * reverse gear activated (marcha ré engatada) * Descrição: indica que o veículo enviou um sinal quando a marcha ré foi engatada * reverse gear inactivated (marcha ré desengatada) * Descrição: indica que o veículo enviou um sinal quando a marcha ré foi desengatada * moving after stopped (veículo começou a se move após parar) * Descrição: indica que o veículo enviou um sinal quando iniciou movimento após estar parado * stopped after moving (veículo parou após se mover) * Descrição: indica que o veículo enviou um sinal quando parou após estar em movimento * excessive engine idle time (tempo excessivo em marcha lenta) * Descrição: indica que o veículo enviou um sinal quando permaneceu em marcha lenta por um tempo acima do limite estabelicido * lv battery low voltage (baixa tensão da bateria LV) * Descrição: indica que o veículo enviou um sinal quando sua bateria de baixa tensão estava com uma tensão baixa, ou seja, próxima ao seu limite mínimo recomendado para uso. O valor da tensão considerada baixa pode variar de acordo com o modelo do veículo, mas geralmente será em torno de 12V * clear lv battery low voltage (recuperação do estado de baixa tensão da bateria LV) * Descrição: indica que o veículo enviou um sinal quando sua bateria de baixa tensão saiu do estado de tensão baixa, ou seja, próxima ao seu limite mínimo recomendado para uso. O valor da tensão considerada baixa pode variar de acordo com o modelo do veículo, mas geralmente será em torno de 12V * alarm triggered (alarme disparado) * Descrição: indica que o veículo enviou um sinal quando o alarme foi disparado * panic alarm on (alarme de pânico ativado) * Descrição: indica que o veículo enviou um sinal quando o alarme de pânico foi acionado * panic alarm off (alarme de pânico desativado) * Descrição: indica que o veículo enviou um sinal quando o alarme de pânico foi desligado * sleep state change (mudança de estado no modo de suspensão) * Descrição: indica que o veículo enviou um sinal quando teve uma mudança no estado no modo de suspensão. Exemplos são quando o veículo entra ou sai do estado de suspensão * error signal (sinal de falha) * Descrição: indica que o veículo enviou um sinal indicando que uma falha aconteceu e a identificando * authorization status change (mudança de estado da autenticação) * Descrição: indica que o veículo enviou um sinal quando teve uma mudança no estado de autenticação * vehicle configuration change (mudança de configuração do veículo) * Descrição: indica que o veículo enviou um sinal quando houve uma alteração em alguma configuração do sistema * vehicle configuration change response (resposta à mudança de configuração do veículo) * Descrição: indica que o veículo enviou um sinal em resposta a uma alteração de configuração previamente solicitada * vehicle diagnostic data request (solicitação de dados de diagnóstico do veículo) * Descrição: indica que foi solicitado ao veículo o envio de dados de diagnóstico * vehicle diagnostic data response (resposta de dados de diagnóstico do veículo) * Descrição: indica que o veículo enviou um sinal contendo informações de diagnóstico em resposta a uma solicitação anterior * vehicle status update (atualização de status do veículo) * Descrição: indica que o veículo enviou um sinal quando houve uma atualização de status * clear user settings (limpeza da configurações de usuário) * Descrição: indica que o veículo enviou um sinal quando as configurações de usuário foram limpas * connecting to cellular service (conectando ao serviço celular) * Descrição: indica que o veículo enviou um sinal durante o processo de conexão à rede celular * firmware upgrade trigger (início de atualização de firmware) * Descrição: indica que o veículo enviou um sinal indicando o início do processo de atualização de firmware * master reset (reinicialização total) * Descrição: indica que o veículo enviou um sinal quando foi executada uma reinicialização total de suas configurações de fábrica * other (outro) * Descrição: indica que o veículo enviou um sinal em um evento não mapeado pela mobway * Exemplo: ```json theme={null} { "event": "ignition on" } ``` ## sleep\_status Estado de Suspensão * Descrição: estado de suspensão para economia de bateria * Formato: categórico * Valores: * awake (acordado) * Descrição: indica que o veículo não está em estado de suspensão * entering on deep sleep (entrando em suspensão) * Descrição: indica que o veículo está entrando em estdo de suspensão * other (outro) * Descrição: indica que o veículo enviou um sinal de uma categoria não mapeada pela mobway ```json theme={null} { "sleep_status": "awake" } ``` ## authentication\_status Estado de Autenticação * Descrição: estado de autenticação * Formato: categórico * Valores: * authorized (autorizado) * Descrição: indica que a autenticação foi autorizada * waiting for authentication (esperando por autenticação) * Descrição: indica que o veículo está esperando que a autenticação seja autorizada * waiting for home url (esperando por provisionamento) * Descrição: indica que o veículo está esperando o provisionamento * unprovisioned (desprovisionado) * Descrição: indica que o veículo foi desprovisionado * other (outro) * Descrição: indica que o veículo enviou um sinal de uma categoria não mapeada pela mobway ```json theme={null} { "authentication_status": "authorized" } ``` # Combustível Source: https://docs.mobway.cloud/data/fuel Dados relacionados ao consumo e quantidade de combustível ## fuel\_level Nível de Combustível * Descrição: nível do combustível no tanque * Formato: numérico * Unidade: % * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 100% * A faixa do nível de combustível foi definida com base nos valores limite por definição * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "fuel_level": { "value": 120.33, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "fuel_level": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "fuel_level": 58.23 } ``` ## fuel\_amount Quantidade de Combustível * Descrição: quantidade de combustível no tanque * Formato: numérico * Unidade: L * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 150 L * A faixa da quantidade de combustível foi definida com base no valor máximo que os veículos conectados à mobway podem, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "fuel_amount": { "value": 170.54, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "fuel_amount": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "fuel_amount": 43.63 } ``` ## fuel\_range Autonomia do Combustível * Descrição: distância estimada a ser percorrida com a quantidade atual de combustível * Formato: numérico * Unidade: km * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 1500 km * A faixa de autonomia do combustível foi definida com base no valor máximo que os veículos conectados à mobway podem possuir, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "fuel_range": { "value": 2118.73, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "fuel_range": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "fuel_range": 789.56 } ``` ## total\_range Autonomia Total * Descrição: distância estimada a ser percorrida com a quantidade atual de combustível e bateria * Formato: numérico * Unidade: km * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 1500 km * A faixa de autonomia total foi definida com base no valor máximo que os veículos conectados à mobway podem possuir, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "total_range": { "value": 1728.39, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "total_range": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "total_range": 58.48 } ``` ## average\_fuel\_economy Economia Média de Combustível * Descrição: economia média de combustível do veículo * Formato: numérico * Unidade: km/l * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 30 km * A faixa de economia média de combustível foi definida com base no valor máximo que os veículos conectados à mobway podem possuir, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "average_fuel_economy": { "value": 48.73, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "average_fuel_economy": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "average_fuel_economy": 3.12 } ``` ## total\_fuel\_economy Economia Total de Combustível * Descrição: economia total de combustível do veículo * Formato: numérico * Unidade: km/l * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 30 km * A faixa de economia total de combustível foi definida com base no valor máximo que os veículos conectados à mobway podem possuir, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "total_fuel_economy": { "value": -1.30, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "total_fuel_economy": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "total_fuel_economy": 23.12 } ``` ## total\_fuel\_used Combustível Total Utilizado * Descrição: quantidade total de combustível utilizada pelo veículo * Formato: numérico * Unidade: L * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 200000 L * A faixa do combustível total utilizado foi definida com base no valor gasto para percorrer 1 milhão de quilômetros com um consumo médio de 5 km/l * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "total_fuel_used": { "value": -8.34, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "total_fuel_used": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "total_fuel_used": 4246.57 } ``` ## diesel\_exhaust\_fluid\_level Nível do Fluido de Escape Diesel * Descrição: nível de fluido de escape para veículos movidos a diesel (Arla 32) * Formato: numérico * Unidade: % * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 100% * A faixa do nível de fluido de escape diesel foi definida com base nos valores limite por definição * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "diesel_exhaust_fluid_level": { "value": 101.98, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "diesel_exhaust_fluid_level": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "diesel_exhaust_fluid_level": 32.91 } ``` ## diesel\_exhaust\_fluid\_range Distância até o Tanque Vazio do Fluido de Escape Diesel * Descrição: distância até o tanque vazio do fluido de escape de veículos movidos a diesel (Arla 32) * Formato: numérico * Unidade: km * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 20000 km * A faixa da distância até o tanque vazio do fluido de escape diesel foi definida com base no valor máximo que os veículos conectados à mobway podem possuir, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "diesel_exhaust_fluid_range": { "value": 23810.81, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "diesel_exhaust_fluid_range": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "diesel_exhaust_fluid_range": 482.38 } ``` ## diesel\_particulate\_filter\_soot\_load Carga de Fuligem no Filtro de Partículas Diesel * Descrição: carga de fuligem no filtro de partículas de veículos movido a diesel * Formato: numérico * Unidade: % * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 100 % * A faixa da carga de fuligem no filtro de partículas diesel foi definida com base no valor máximo que os veículos conectados à mobway podem possuir, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "diesel_particulate_filter_soot_load": { "value": -8.39, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "diesel_particulate_filter_soot_load": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "diesel_particulate_filter_soot_load": 78.63 } ``` ## diesel\_particulate\_filter\_regeneration\_status Status de Regeneração do Filtro de Partículas Diesel * Descrição: status de regeneração do filtro de partículas de veículos movido a diesel * Formato: categórico * Valores: * normal operation (operação normal) * Descrição: indica que a regeneração do filtro de partículas para veículos movidos a diesel esta funcionando normalmente * other (outro) * Descrição: indica que o veículo enviou um sinal de uma categoria não mapeada pela mobway * Exemplo: ```json theme={null} { "diesel_particulate_filter_regeneration_status": "normal operation" } ``` ## diesel\_particulate\_filter\_warning\_1 Aviso do Filtro de Partículas Diesel 1 * Descrição: indica se o aviso do filtro de partículas diesel está acionado * Formato: categórico * Valores: * warning 1 on (aviso 1 acionado) * Descrição: indica que o aviso do filtro de partículas diesel está acionado * warning 1 off (aviso 1 desligado) * Descrição: indica que o aviso do filtro de partículas diesel está desligado * other (outro) * Descrição: indica que o veículo enviou um sinal de uma categoria não mapeada pela mobway * Exemplo: ```json theme={null} { "diesel_particulate_filter_warning_1": "warning 1 on" } ``` ## diesel\_particulate\_filter\_warning\_2 Aviso do Filtro de Partículas Diesel 2 * Descrição: indica se o aviso do filtro de partículas diesel está acionado * Formato: categórico * Valores: * warning 2 on (aviso 2 acionado) * Descrição: indica que o aviso do filtro de partículas diesel está acionado * warning 2 off (aviso 2 desligado) * Descrição: indica que o aviso do filtro de partículas diesel está desligado * other (outro) * Descrição: indica que o veículo enviou um sinal de uma categoria não mapeada pela mobway * Exemplo: ```json theme={null} { "diesel_particulate_filter_warning_2": "warning 2 on" } ``` # Geral Source: https://docs.mobway.cloud/data/general Esta página apresenta um overview de todos os dados disponibilizados pelo próprio veículo. Para mais detalhes a respeito de um dado, você pode consultar a página da categoria correspondente Com exceção dos dados enriquecidos pela mobway, todos os outros dados são disponibilizados de forma homologada pela montadora diretamente do próprio veículo. ## [VIN](https://docs.mobway.cloud/data/vin) Esta categoria apresenta apenas um dado, responsável pela identificação do veículo. ### [vin](https://docs.mobway.cloud/data/vin#vin) Número de Identificação do Veículo ```json theme={null} { "vin": "9BM384073WB000000" } ``` ## [Detalhes](https://docs.mobway.cloud/data/details) Esta categoria apresenta dados responsáveis pela identificação da data e hora e pela indicação de dados errôneos. ### [date\_time](https://docs.mobway.cloud/data/details#date-time) Data e Hora ```json theme={null} { "date_time": "2023-08-09 20:02:45" } ``` ### [flag](https://docs.mobway.cloud/data/details#flag) Flag ```json theme={null} [ { "datapoint": "hv_battery_soc", "value": 153.14, "flag": "out of range" }, { "datapoint": "range", "value": NaN, "flag": "missing data" }, { "datapoint": "odometer", "value": 43345.71, "flag": "variation out of limit" } ] ``` ## [Velocidade](https://docs.mobway.cloud/data/speed) Esta categoria apresenta dados, gerados pelo próprio veículo, relacionados à sua velocidade. ### [speed](https://docs.mobway.cloud/data/speed#speed) Velocidade ```json theme={null} { "speed": 78.45 } ``` ### [vehicle\_move\_status](https://docs.mobway.cloud/data/speed#vehicle-move-status) Estado de Movimento do Veículo ```json theme={null} { "vehicle_move_status": "moving" } ``` ## [Condução](https://docs.mobway.cloud/data/driving) Esta categoria apresenta dados, gerados pelo próprio veículo, relacionados à sua condução. ### [accelerator\_pedal\_position](https://docs.mobway.cloud/data/driving#accelerator-pedal-position) Posição do Pedal do Acelerador ```json theme={null} { "accelerator_pedal_position": 23.50 } ``` ### [longitudinal\_acceleration](https://docs.mobway.cloud/data/driving#longitudinal-acceleration) Aceleração Longitudinal ```json theme={null} { "longitudinal_acceleration": 1.25 } ``` ### [lateral\_acceleration](https://docs.mobway.cloud/data/driving#lateral-acceleration) Aceleração Lateral ```json theme={null} { "lateral_acceleration": -0.85 } ``` ## [Odômetro](https://docs.mobway.cloud/data/odometer) Esta categoria apresenta dados, gerados pelo próprio veículo, relacionados ao odômetro. ### [odometer](https://docs.mobway.cloud/data/odometer#odometer) Odômetro ```json theme={null} { "odometer": 25678.00 } ``` ### [trip\_odometer](https://docs.mobway.cloud/data/odometer#trip-odometer) Distância Percorrida na Viagem ```json theme={null} { "trip_odometer": 578.93 } ``` ## [Localização](https://docs.mobway.cloud/data/location) Esta categoria apresenta dados, gerados pelo próprio veículo, relacionados à geolocalização e orientação. ### [latitude](https://docs.mobway.cloud/data/location#latitude) Latitude ```json theme={null} { "latitude": 34.0567236 } ``` ### [longitude](https://docs.mobway.cloud/data/location#longitude) Longitude ```json theme={null} { "longitude": -118.2451370 } ``` ### [heading](https://docs.mobway.cloud/data/location#heading) Orientação ```json theme={null} { "heading": 357.92 } ``` ### [altitude](https://docs.mobway.cloud/data/location#altitude) Altitude ```json theme={null} { "altitude": 586.10 } ``` ### [geolocation\_horizontal\_error](https://docs.mobway.cloud/data/location#geolocation-horizontal-error) Erro Horizontal da Geolocalização ```json theme={null} { "geolocation_horizontal_error": 3 } ``` ### [geolocation\_anonymization](https://docs.mobway.cloud/data/location#geolocation-anonymization) Anonimização da Geolocalização ```json theme={null} { "geolocation_anonymization": "anonymized" } ``` ## [Motor](https://docs.mobway.cloud/data/engine) Esta categoria apresenta dados, gerados pelo próprio veículo, relacionados ao funcionamento e estado do motor. ### [rpm](https://docs.mobway.cloud/data/engine#rpm) Rotações por Minuto ```json theme={null} { "rpm": 3567.89 } ``` ### [oil\_level](https://docs.mobway.cloud/data/engine#oil-level) Nível de Óleo ```json theme={null} { "oil_level": 82.37 } ``` ### [oil\_remaining\_life](https://docs.mobway.cloud/data/engine#oil-remaining-life) Vida Útil do Óleo ```json theme={null} { "oil_remaining_life": 37.92 } ``` ### [engine\_coolant\_temperature](https://docs.mobway.cloud/data/engine#engine-coolant-temperature) Temperatura do Líquido de Arrefecimento do Motor ```json theme={null} { "engine_coolant_temperature": 98.75 } ``` ### [total\_engine\_idle\_time](https://docs.mobway.cloud/data/engine#total-engine-idle-time) Tempo Total com Motor em Marcha Lenta ```json theme={null} { "total_engine_idle_time": 9728308.75 } ``` ### [total\_engine\_run\_time](https://docs.mobway.cloud/data/engine#total-engine-run-time) Tempo Total com Motor em Utilização ```json theme={null} { "total_engine_run_time": 73920308.35 } ``` ### [engine\_air\_filter\_diagnostic](https://docs.mobway.cloud/data/engine#engine-air-filter-diagnostic) Diagnóstico do Filtro de Ar do Motor ```json theme={null} { "engine_air_filter_diagnostic": "blocked" } ``` ### [engine\_air\_filter\_status](https://docs.mobway.cloud/data/engine#engine-air-filter-status) Estado do Filtro de Ar do Motor ```json theme={null} { "engine_air_filter_status": "change now" } ``` ### [engine\_air\_filter\_remaining\_life](https://docs.mobway.cloud/data/engine#engine-air-filter-remaining-life) Vida Restante do Filtro de Ar do Motor ```json theme={null} { "engine_air_filter_remaining_life": 91.98 } ``` ### [engine\_oil\_temperature](https://docs.mobway.cloud/data/engine#engine-oil-temperature) Temperatura do Óleo do Motor ```json theme={null} { "engine_oil_temperature": 92.50 } ``` ## [Transmissão](https://docs.mobway.cloud/data/transmission) Esta categoria apresenta dados, gerados pelo próprio veículo, relacionados à sua transmissão. ### [transmission\_fluid\_temperature](https://docs.mobway.cloud/data/transmission#transmission-fluid-temperature) Temperatura do Fluido da Transmissão ```json theme={null} { "transmission_fluid_temperature": 78.25 } ``` ## [Freio](https://docs.mobway.cloud/data/brake) Esta categoria apresenta dados, gerados pelo próprio veículo, relacionados ao estado do freio. ### [front\_brake\_pad\_remaining\_life](https://docs.mobway.cloud/data/brake#front-brake-pad-remaining-life) Vida Restante dos Discos de Freio Dianteiro ```json theme={null} { "front_brake_pad_remaining_life": 49.45 } ``` ### [rear\_brake\_pad\_remaining\_life](https://docs.mobway.cloud/data/brake#rear-brake-pad-remaining-life) Vida Restante dos Discos de Freio Traseiro ```json theme={null} { "rear_brake_pad_remaining_life": 19.68 } ``` ### [invalid\_front\_brake\_pad](https://docs.mobway.cloud/data/brake#invalid-front-brake-pad) Identificação de Disco de Freio Dianteiro Inválido ```json theme={null} { "invalid_rear_brake_pad": "invalid rear_brake_pad_remaining_life" } ``` ### [invalid\_rear\_brake\_pad](https://docs.mobway.cloud/data/brake#invalid-rear-brake-pad) Identificação de Disco de Freio Traseiro Inválido ```json theme={null} { "invalid_rear_brake_pad": "invalid rear_brake_pad_remaining_life" } ``` ### [brake\_pad\_life\_status](https://docs.mobway.cloud/data/brake#brake-pad-life-status) Estado dos Discos de Freio ```json theme={null} { "brake_pad_life_status": "change now" } ``` ## [Temperatura](https://docs.mobway.cloud/data/temperature) Esta categoria apresenta dados, gerados pelo próprio veículo, relacionados a temperatura. ### [external\_ambient\_temperature](https://docs.mobway.cloud/data/temperature#external-ambient-temperature) Temperatura Ambiente Externa ```json theme={null} { "external_ambient_temperature": 23.40 } ``` ## [Combustível](https://docs.mobway.cloud/data/fuel) Esta categoria apresenta dados, gerados pelo próprio veículo, relacionados ao consumo e quantidade de combustível. ### [fuel\_level](https://docs.mobway.cloud/data/fuel#fuel-level) Nível de Combustível ```json theme={null} { "fuel_level": 58.23 } ``` ### [fuel\_amount](https://docs.mobway.cloud/data/fuel#fuel-amount) Quantidade de Combustível ```json theme={null} { "fuel_amount": 43.63 } ``` ### [fuel\_range](https://docs.mobway.cloud/data/fuel#fuel-range) Autonomia do Combustível ```json theme={null} { "fuel_range": 789.56 } ``` ### [total\_range](https://docs.mobway.cloud/data/fuel#total-range) Autonomia Total ```json theme={null} { "total_range": 58.48 } ``` ### [average\_fuel\_economy](https://docs.mobway.cloud/data/fuel#average-fuel-economy) Economia Média de Combustível ```json theme={null} { "average_fuel_economy": 3.12 } ``` ### [total\_fuel\_economy](https://docs.mobway.cloud/data/fuel#total-fuel-economy) Economia Total de Combustível ```json theme={null} { "total_fuel_economy": 23.12 } ``` ### [total\_fuel\_used](https://docs.mobway.cloud/data/fuel#total-fuel-used) Combustível Total Utilizado ```json theme={null} { "total_fuel_used": 4246.57 } ``` ### [diesel\_exhaust\_fluid\_level](https://docs.mobway.cloud/data/fuel#diesel-exhaust-fluid-level) Nível do Fluido de Escape Diesel ```json theme={null} { "diesel_exhaust_fluid_level": 32.91 } ``` ### [diesel\_exhaust\_fluid\_range](https://docs.mobway.cloud/data/fuel#diesel-exhaust-fluid-range) Distância até o Tanque Vazio do Fluido de Escape Diesel ```json theme={null} { "diesel_exhaust_fluid_range": 482.38 } ``` ### [diesel\_particulate\_filter\_soot\_load](https://docs.mobway.cloud/data/fuel#diesel-particulate-filter-soot-load) Carga de Fuligem no Filtro de Partículas Diesel ```json theme={null} { "diesel_particulate_filter_soot_load": 78.63 } ``` ### [diesel\_particulate\_filter\_regeneration\_status](https://docs.mobway.cloud/data/fuel#diesel-particulate-filter-regeneration-status) Status de Regeneração do Filtro de Partículas Diesel ```json theme={null} { "diesel_particulate_filter_regeneration_status": "normal operation" } ``` ### [diesel\_particulate\_filter\_warning\_1](https://docs.mobway.cloud/data/fuel#diesel-particulate-filter-warning-1) Aviso do Filtro de Partículas Diesel 1 ```json theme={null} { "diesel_particulate_filter_warning_1": "warning 1 on" } ``` ### [diesel\_particulate\_filter\_warning\_2](https://docs.mobway.cloud/data/fuel#diesel-particulate-filter-warning-2) Aviso do Filtro de Partículas Diesel 2 ```json theme={null} { "diesel_particulate_filter_warning_2": "warning 2 on" } ``` ## [Pneu](https://docs.mobway.cloud/data/tire) Esta categoria apresenta dados, gerados pelo próprio veículo, relacionados à pressão dos pneus. ### [tire\_pressure](https://docs.mobway.cloud/data/tire#tire-pressure) Pressão do Pneu ```json theme={null} { "right_front_tire_pressure": 32.45, "left_front_tire_pressure": 32.67, "right_rear_tire_pressure": 33.23, "left_rear_tire_pressure": 33.35 } ``` ### [ideal\_front\_tire\_pressure](https://docs.mobway.cloud/data/tire#ideal-front-tire-pressure) Pressão Ideal dos Pneus Dianteiros ```json theme={null} { "ideal_front_tire_pressure": 32.50 } ``` ### [ideal\_rear\_tire\_pressure](https://docs.mobway.cloud/data/tire#ideal-rear-tire-pressure) Pressão Ideal dos Pneus Traseiros ```json theme={null} { "ideal_rear_tire_pressure": 30.00 } ``` ## [Bateria](https://docs.mobway.cloud/data/battery) Esta categoria apresenta dados, gerados pelo próprio veículo, relacionados à bateria de baixa tensão do veículo. ### [lv\_battery\_voltage](https://docs.mobway.cloud/data/battery#lv-battery-voltage) Tensão da Bateria LV ```json theme={null} { "lv_battery_voltage": 12.45 } ``` ### [lv\_battery\_soc](https://docs.mobway.cloud/data/battery#lv-battery-soc) Estado de Carga da Bateria LV ```json theme={null} { "lv_battery_soc": 43.57 } ``` ### [lv\_battery\_current](https://docs.mobway.cloud/data/battery#lv-battery-current) Corrente da Bateria LV ```json theme={null} { "lv_battery_current": 1.02 } ``` ## [EV](https://docs.mobway.cloud/data/ev) Esta categoria apresenta dados, gerados pelo próprio veículo, relacionados à bateria de um veículo elétrico e seu processo de recarga. ### [hv\_battery\_voltage](https://docs.mobway.cloud/data/ev#hv-battery-voltage) Tensão da Bateria HV ```json theme={null} { "hv_battery_voltage": 625.89 } ``` ### [hv\_battery\_soc](https://docs.mobway.cloud/data/ev#hv-battery-soc) Estado de Carga da Bateria HV ```json theme={null} { "hv_battery_soc": 73.42 } ``` ### [hv\_battery\_charging\_status](https://docs.mobway.cloud/data/ev#hv-battery-charging-status) Estado de Carregamento da Bateria HV ```json theme={null} { "hv_battery_charging_status": "charging" } ``` ## [Segurança](https://docs.mobway.cloud/data/safety) Esta categoria apresenta dados, gerados pelo próprio veículo, relacionados à segurança. ### [seat\_belt\_status](https://docs.mobway.cloud/data/safety#seat-belt-status) Estado do Cinto de Segurança ```json theme={null} { "seat_belt_status": "buckled" } ``` ### [warning\_signal](https://docs.mobway.cloud/data/safety#warning-signal) Código de Falha de Diagnóstico (DTC) ```json theme={null} { "warning_signal": "{\"Code\": \"300D22\", \"Description\": \"Tanque de combustível quase vazio.\", \"Action\": \"Reabasteça assim que possível.\"}" } ``` ### [warning\_indicator](https://docs.mobway.cloud/data/safety#warning-indicator) Alerta do Veículo ```json theme={null} { "warning_indicator": "{\"Code\": \"\", \"Description\": \"Falha no sistema de freios ABS.\", \"Action\": \"Procure uma oficina autorizada.\"}" } ``` ### [warning\_severity\_level](https://docs.mobway.cloud/data/safety#warning-severity-level) Nível de Severidade do Sinal de Aviso ```json theme={null} { "warning_severity_level": "high severity" } ``` ### [low\_level\_washer\_fluid](https://docs.mobway.cloud/data/safety#low-level-washer-fluid) Aviso de Baixo Nível do Líquido de Limpeza ```json theme={null} { "low_level_washer_fluid": "normal level washer fluid" } ``` ### [abs\_event\_duration](https://docs.mobway.cloud/data/safety#abs-event-duration) Duração do Evento de Acionamento do ABS ```json theme={null} { "abs_event_duration": 2.00 } ``` ### [traction\_control\_event\_duration](https://docs.mobway.cloud/data/safety#traction-control-event-duration) Duração do Evento de Controle de Tração ```json theme={null} { "traction_control_event_duration": 3.00 } ``` ### [electronic\_stability\_control\_event\_duration](https://docs.mobway.cloud/data/safety#electronic-stability-control-event-duration) Duração do Evento de Controle Eletrônico de Estabilidade ```json theme={null} { "electronic_stability_control_event_duration": 1.00 } ``` ## [Ignição](https://docs.mobway.cloud/data/ignition) Esta categoria apresenta dados, gerados pelo próprio veículo, relacionados ao modo do sistema de tração. ### [ignition\_status](https://docs.mobway.cloud/data/ignition#ignition-status) Estado da Ignição ```json theme={null} { "ignition_status": "ignition on" } ``` ### [ignition\_status\_change](https://docs.mobway.cloud/data/ignition#ignition-status-change) Troca do Estado da Ignição ```json theme={null} { "ignition_status_change": "changed" } ``` ### [system\_power\_mode](https://docs.mobway.cloud/data/ignition#system-power-mode) Modo do Sistema de Tração ```json theme={null} { "system_power_mode": "ignition on" } ``` ## [Rede de Celular](https://docs.mobway.cloud/data/fuel) Esta categoria apresenta dados, gerados pelo próprio veículo, relacionados à rede de celular. ### [cellular\_signal\_strength](https://docs.mobway.cloud/data/cellular#cellular-signal-strength) Intensidade do Sinal de Celular ```json theme={null} { "cellular_signal_strength": "4" } ``` ### [cellular\_service](https://docs.mobway.cloud/data/cellular#cellular-service) Serviço de Celular ```json theme={null} { "cellular_service": "4G LTE" } ``` ## [Eventos](https://docs.mobway.cloud/data/event) Esta categoria apresenta dados, gerados pelo próprio veículo, responsáveis por indicar o evento que atuou como gatilho para o envio dos dados. ### [event](https://docs.mobway.cloud/data/event#event) Evento ```json theme={null} { "event": "ignition on" } ``` ### [sleep\_status](https://docs.mobway.cloud/data/event#sleep-status) Estado de Suspensão ```json theme={null} { "sleep_status": "awake" } ``` ### [authentication\_status](https://docs.mobway.cloud/data/event#authentication-status) Estado de Autenticação ```json theme={null} { "authentication_status": "authorized" } ``` ## [Especificações do Veículo](https://docs.mobway.cloud/data/specifications) Esta categoria apresenta dados, gerados pelo próprio veículo, relacionados às especificações técnicas. ### [vehicle\_age](https://docs.mobway.cloud/data/specifications#vehicle-age) Idade do Veículo ```json theme={null} { "vehicle_age": 2.00 } ``` ### [fuel\_capacity](https://docs.mobway.cloud/data/specifications#fuel-capacity) Capacidade do Tanque de Combustível ```json theme={null} { "vehicle_age": 52.00 } ``` # Ignição Source: https://docs.mobway.cloud/data/ignition Dados relacionados a ignição ## ignition\_status Estado da Ignição * Descrição: indica o modo do sistema de tração, após alterar de estado * Formato: categórico * Valores: * ignition on (ligado) * Descrição: indica que a ignição acabou de ser ligada, ou seja, o veículo já deu partida e está ligado no momento * ignition off (desligado) * Descrição: indica que a ignição acabou de ser desligada, ou seja, o veículo está desligado no momento * crank (partida) * Descrição: indica que o veículo está dando partida, ou seja, o veículo está sendo ligado * accessory (acessórios) * Descrição: indica que o veículo acabou de entrar em um estado em que apenas os acessórios estão ligados, como o rádio e os interruptores das janelas * other (outro) * Descrição: indica que o veículo enviou um sinal de uma categoria não mapeada pela mobway * Exemplo: ```json theme={null} { "ignition_status": "ignition on" } ``` ## ignition\_status\_change Troca do Estado da Ignição * Descrição: indica se o modo do sistema de tração foi alterado * Formato: categórico * Valores: * changed (alterado) * Descrição: indica que o modo do sistema de tração foi alterado * not changed (não alterado) * Descrição: indica que o modo do sistema de tração não foi alterado * other (outro) * Descrição: indica que o veículo enviou um sinal de uma categoria não mapeada pela mobway * Exemplo: ```json theme={null} { "ignition_status_change": "changed" } ``` ## system\_power\_mode Modo do Sistema de Tração * Descrição: indica o modo do sistema de tração * Formato: categórico * Valores: * ignition on (ligado) * Descrição: indica que a ignição está ligada, ou seja, o veículo já deu partida e está ligado no momento * ignition off (desligado) * Descrição: indica que a ignição está desligada, ou seja, o veículo está desligado no momento * crank (partida) * Descrição: indica que o veículo está dando partida, ou seja, o veículo está sendo ligado * accessory (acessórios) * Descrição: indica que o veículo está em um estado em que apenas os acessórios estão ligados, como o rádio e os interruptores das janelas * other (outro) * Descrição: indica que o veículo enviou um sinal de uma categoria não mapeada pela mobway * Exemplo: ```json theme={null} { "system_power_mode": "on" } ``` # Localização Source: https://docs.mobway.cloud/data/location Dados relacionados à geolocalização e orientação ## latitude Latitude * Descrição: coordenada geográfica que indica a posição no sentido norte-sul da terra * Formato: numérico * Unidade: ° * Casas decimais: 7 * O dado tratado pela mobway sempre terá no máximo 7 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 7 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: -90° a 90° * A faixa de latitude foi definida com base nos valores limite por definição * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "latitude": { "value": 93.7435821, "flag": "out of range" } } ``` * Variação mínima e máxima: - 0.001° e 0.001° por segundo * As variações mínima e máxima de latitude foram definidas com base na distância percorrida por um veículo a 400 km/h, considerando uma trajetória no sentido norte-sul da terra, considerando uma margem de segurança * Dados com variação fora do limite permitido em relação ao dado anterior são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "latitude": { "value": 14.3181722, "flag": "variation out of limit" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "latitude": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "latitude": 34.0567236 } ``` ## longitude Longitude * Descrição: coordenada geográfica que indica a posição no sentido leste-oeste da terra * Formato: numérico * Unidade: ° * Casas decimais: 7 * O dado tratado pela mobway sempre terá no máximo 7 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 7 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: -180° a 180° * A faixa de longitude foi definida com base nos valores limite por definição * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "longitude": { "value": -191.3564382, "flag": "out of range" } } ``` * Variação mínima e máxima: - 0.001° e 0.001° por segundo * As variações mínima e máxima de longitude foram definidas com base na distância percorrida por um veículo a 400 km/h, considerando uma trajetória no sentido leste-oeste da terra, considerando uma margem de segurança * Dados com variação fora do limite permitido em relação ao dado anterior são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "longitude": { "value": 43.8127712, "flag": "variation out of limit" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "longitude": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "longitude": -118.2451370 } ``` ## altitude Altitude * Descrição: elevação do veículo em relação ao mar * Formato: numérico * Unidade: m * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: -500 a 9000 m * A faixa de altitude foi definida com base nos valores limite encontrados na terra * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "altitude": { "value": 11191.32, "flag": "out of range" } } ``` * Variação mínima e máxima: - 30 m e 30 m por segundo * As variações mínima e máxima de altitude foram definidas com base na distância percorrida por um veículo a 400 km/h, considerando uma inclinação de 15°, considerando uma margem de segurança * Dados com variação fora do limite permitido em relação ao dado anterior são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "altitude": { "value": 2343.87, "flag": "variation out of limit" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "altitude": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "altitude": 586.10 } ``` ## heading Orientação * Descrição: orientação do veículo em relação aos pontos cardeais * 0º: Norte * 90º: Leste * 180º: Sul * 270º: Oeste * Formato: numérico * Unidade: ° * Casas decimais: 2 * O dado tratado sempre terá 2 casas decimais, porém a precisão do dado original depende da montadora * Faixa: 0º a 360º * A faixa do sentido de orientação foi definida com base nos valores limite por definição * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "heading": { "value": 367.89, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "heading": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "heading": 357.92 } ``` ## geolocation\_horizontal\_error Erro Horizontal da Geolocalização * Descrição: valor do erro das medidas de latitude e longitude * Formato: numérico * Unidade: m * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 100 m * A faixa do erro horizontal da geolocalização foi definida com base nos valores geralmente encontrados em GPS, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "geolocation_horizontal_error": { "value": 132.00, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "geolocation_horizontal_error": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "geolocation_horizontal_error": 3.00 } ``` ## geolocation\_anonymization Anonimização da Geolocalização * Descrição: indica se os dados de geolocalização estão anonimizados * Formato: categórico * Valores: * anonymized (anonimizado) * Descrição: indica que os dados de geolocalização estão anonimizados * not anonymized (não anonimizado) * Descrição: indica que os dados de geolocalização não estão anonimizados * Exemplo: ```json theme={null} { "geolocation_anonymization": "anonymized" } ``` # Odômetro Source: https://docs.mobway.cloud/data/odometer Dados relacionados ao odômetro ## odometer Odômetro * Descrição: quilometragem total percorrida * Formato: numérico * Unidade: km * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 1000000 km * A faixa do odômetro foi definida com base no valor atingido por veículos durante seu ciclo de vida, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "odometer": { "value": 9118257.33, "flag": "out of range" } } ``` * Variação mínima e máxima: 0 km e 0.111 km por segundo * A variação mínima do odômetro foi definida pelo fato do mesmo nunca diminuir de valor. A variação máxima do odômetro foi definida com base na distância percorrida por um veículo a 400 km/h, considerando uma margem de segurança * Dados com variação fora do limite permitido em relação ao dado anterior são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "odometer": { "value": 43345.71, "flag": "variation out of limit" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "odometer": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "odometer": 25678.00 } ``` ## trip\_odometer Distância Percorrida na Viagem * Descrição: quilometragem total percorrida durante a viagem * Formato: numérico * Unidade: km * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 1500 km * A faixa da distância percorrida na viagem foi definida com base no valor atingido por veículos durante seu ciclo de vida, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "trip_odometer": { "value": 8257.43, "flag": "out of range" } } ``` * Variação máxima: 0.111 km por segundo * A variação máxima da distância percorrida na viagem foi definida com base na distância percorrida por um veículo a 400 km/h, considerando uma margem de segurança * Dados com variação fora do limite permitido em relação ao dado anterior são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "trip_odometer": { "value": 35.16, "flag": "variation out of limit" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "trip_odometer": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "trip_odometer": 578.93 } ``` # Segurança Source: https://docs.mobway.cloud/data/safety Dados relacionados a segurança ## seat\_belt\_status Estado do Cinto de Segurança * Descrição: estado do cinto de segurança do condutor * Formato: categórico * Valores: * buckled (afivelado) * Descrição: indica que o motorista está utilizando o cinto de segurança * not buckled (não afivelado) * Descrição: indica que o motorista não está utilizando o cinto de segurança * Exemplo: ```json theme={null} { "seat_belt_status": "buckled" } ``` ## warning\_signal Código de Falha de Diagnóstico (DTC) * Descrição: código de diagnóstico reportado pelo veículo para identificar uma falha detectada por seus sistemas. Inclui o código da falha e, quando disponibilizados pela fonte, sua descrição e uma ação recomendada * Formato: texto, contendo um objeto JSON por DTC. Com mais de um, os objetos são separados por vírgula * Valores: variam de acordo com a montadora e modelo do veículo * Code: código de diagnóstico (DTC) * Description: descrição da falha * Action: ação recomendada * Exemplo: ```json theme={null} { "warning_signal": "{\"Code\": \"300D22\", \"Description\": \"Tanque de combustível quase vazio.\", \"Action\": \"Reabasteça assim que possível.\"}" } ``` ## warning\_indicator Alerta do Veículo * Descrição: aviso reportado pela montadora sobre uma condição, anomalia ou estado do veículo que não é fornecido como um código de falha de diagnóstico (DTC). Pode representar avisos como baixo nível de fluidos, baixa pressão dos pneus, temperatura elevada ou falha em um sistema * Formato: texto, contendo um objeto JSON por aviso ativo. Com mais de um, os objetos são separados por vírgula. Sem nenhum aviso ativo, o dado é nulo * Valores: variam de acordo com a montadora e modelo do veículo * Code: código do aviso, quando a montadora o fornece, ou vazio caso contrário * Description: descrição do aviso * Action: ação recomendada * Exemplo: ```json theme={null} { "warning_indicator": "{\"Code\": \"\", \"Description\": \"Falha no sistema de freios ABS.\", \"Action\": \"Procure uma oficina autorizada.\"}" } ``` Importante: um Alerta do Veículo pode estar relacionado a uma falha que também gere um DTC internamente, mas vehicle\_warning representa apenas o aviso disponibilizado pela fonte e não deve ser interpretado como um código de diagnóstico. ## warning\_severity\_level Nível de Severidade do Sinal de Aviso * Descrição: indica a severidade do sinal de aviso * Formato: categórico * Valores: * no severity (sem severidade) * Descrição: indica que o problema indicado pelo sinal de aviso não tem severidade * low severity (severidade baixa) * Descrição: indica que o problema indicado pelo sinal de aviso tem severidade baixa * medium severity (severidade média) * Descrição: indica que o problema indicado pelo sinal de aviso tem severidade média * high severity (severidade alta) * Descrição: indica que o problema indicado pelo sinal de aviso tem severidade alta * Exemplo: ```json theme={null} { "warning_severity_level": "high severity" } ``` ## low\_level\_washer\_fluid Aviso de Baixo Nível do Líquido de Limpeza * Descrição: indica se o nível do líquido de limpeza do parabrisa está baixo * Formato: categórico * Valores: * normal level washer fluid (nível normal) * Descrição: indica que a quantidade de líquido de limpeza está normal * low level washer fluid (nível baixo) * Descrição: indica que a quantidade de líquido de limpeza está baixa * Exemplo: ```json theme={null} { "low_level_washer_fluid": "normal level washer fluid" } ``` ## abs\_event\_duration Duração do Evento de Acionamento do ABS * Descrição: duração do evento de acionamento do ABS * Formato: numérico * Unidade: s * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 3600 s * A faixa da duração do evento foi definida com base na duração máxima esperada de um evento, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "abs_event_duration": { "value": 4000.00, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "abs_event_duration": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "abs_event_duration": 2.00 } ``` ## traction\_control\_event\_duration Duração do Evento de Controle de Tração * Descrição: duração do evento de controle de tração * Formato: numérico * Unidade: s * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 3600 s * A faixa da duração do evento foi definida com base na duração máxima esperada de um evento, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "traction_control_event_duration": { "value": 4000.00, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "traction_control_event_duration": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "traction_control_event_duration": 3.00 } ``` ## electronic\_stability\_control\_event\_duration Duração do Evento de Controle Eletrônico de Estabilidade * Descrição: duração do evento de controle eletrônico de estabilidade * Formato: numérico * Unidade: s * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 3600 s * A faixa da duração do evento foi definida com base na duração máxima esperada de um evento, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "electronic_stability_control_event_duration": { "value": 4000.00, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "electronic_stability_control_event_duration": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "electronic_stability_control_event_duration": 1.00 } ``` # Especificações do Veículo Source: https://docs.mobway.cloud/data/specifications Especificações técnicas do modelo do veículo ## vehicle\_age Idade do Veículo * Descrição: idade do veículo * Formato: numérico * Unidade: anos * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 20 anos * A faixa da idade do veículo foi definida com base no valor máximo que os veículos conectados à mobway podem possuir, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "vehicle_age": { "value": 23.00, "flag": "out of range" } } ``` * Variação mínima: 0 anos por segundo * A variação mínima foi definida como 0 pois o valor não deve diminuir * Dados com variação fora do limite permitido em relação ao dado anterior são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "vehicle_age": { "value": 5.00, "flag": "variation out of limit" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "vehicle_age": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "vehicle_age": 2.00 } ``` ## fuel\_capacity Capacidade do Tanque de Combustível * Descrição: tamanho do tanque de combustível * Formato: numérico * Unidade: L * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 150 L * A faixa da capacidade do tanque de combustível foi definida com base no valor máximo que os veículos conectados à mobway podem possuir, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "fuel_capacity": { "value": -4.00, "flag": "out of range" } } ``` * Variação mínima e máxima: 0 km por segundo * A variação mínima e máxima foram definidas como 0 pois o valor deve ser fixo * Dados com variação fora do limite permitido em relação ao dado anterior são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "fuel_capacity": { "value": 35.16, "flag": "variation out of limit" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "fuel_capacity": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "vehicle_age": 52.00 } ``` # Velocidade Source: https://docs.mobway.cloud/data/speed Dados relacionados a velocidade ## speed Velocidade * Descrição: velocidade instantânea * Formato: numérico * Unidade: km/h * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 0 a 400 km/h * A faixa de velocidade foi definida com base no valor máximo que os veículos conectados à mobway podem atingir, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "speed": { "value": 512.54, "flag": "out of range" } } ``` * Variação máxima: 50 km/h por segundo * A variação máxima de velocidade foi definida com base na acerelação máxima que os veículos conectados à mobway podem atingir, considerando uma margem de segurança * Dados com variação acima do limite em relação ao dado anterior são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "speed": { "value": 104.17, "flag": "variation out of limit" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "speed": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "speed": 78.45 } ``` ## vehicle\_move\_status Estado de Movimento do Veículo * Descrição: indica se o veículo está se movendo * Formato: categórico * Valores: * forward (movendo para frente) * Descrição: indica que o veículo está se movendo para frente * neutral (neutro) * Descrição: indica que o veículo está com a transmissão no neutro * reverse (marcha ré) * Descrição: indica que o veículo está com a transmissão na marcha ré * park (estacionando) * Descrição: indica que o veículo está estacionando * parked (estacionado) * Descrição: indica que o veículo está estacionado * invalid (inválido) * Descrição: indica que o dado é inválido * Exemplo: ```json theme={null} { "vehicle_move_status": "moving" } ``` # Temperatura Source: https://docs.mobway.cloud/data/temperature Dados relacionados a temperatura ## external\_ambient\_temperature Temperatura Ambiente Externa * Descrição: temperatura ambiente externa ao veículo * Formato: numérico * Unidade: °C * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: -15°C a 60°C * O valor mínimo da temperatura ambiente externa ao veículo foi definida com base na temperatura do ambiente mínima atingida no Brasil, considerando uma margem de segurança. O valor máximo temperatura ambiente externa ao veículo foi definida com base na temperatura do ambiente máxima atingida no Brasil, considerando uma margem de segurança. * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "external_ambient_temperature": { "value": -25.34, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "external_ambient_temperature": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "external_ambient_temperature": 23.40 } ``` # Pneu Source: https://docs.mobway.cloud/data/tire Dados relacionados à pressão dos pneus ## tire\_pressure Pressão do Pneu * Existem 4 dados de mesmo formato, um para cada pneu do veículo, com os seguintes nomes: * right\_front\_tire\_pressure (pressão do pneu dianteiro direito) * left\_front\_tire\_pressure (pressão do pneu dianteiro esquerdo) * right\_rear\_tire\_pressure (pressão do pneu traseiro direito) * left\_rear\_tire\_pressure (pressão do pneu traseiro esquerdo) A requisição é feita individualmente, assim como os demais dados, a união foi feita apenas para evitar repetição na documentação * Descrição: pressão do pneu * Formato: numérico * Unidade: psi * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 14 a 150 psi * O valor mínimo da pressão de pneu foi definida com base na pressão atmosférica, considerando uma margem de erro. O valor máximo da pressão de pneu foi definida com base no valor máximo que os veículos conectados à mobway podem atingir, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "right_front_tire_pressure": { "value": 255.00, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "right_front_tire_pressure": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "right_front_tire_pressure": 32.45, "left_front_tire_pressure": 32.67, "right_rear_tire_pressure": 33.23, "left_rear_tire_pressure": 33.35 } ``` ## tire\_pressure\_status Status da Pressão do Pneu * Existem 4 dados de mesmo formato, um para cada pneu do veículo, com os seguintes nomes: * right\_front\_tire\_pressure\_status (status da pressão do pneu dianteiro direito) * left\_front\_tire\_pressure\_status (status da pressão do pneu dianteiro esquerdo) * right\_rear\_tire\_pressure\_status (status da pressão do pneu traseiro direito) * left\_rear\_tire\_pressure\_status (status da pressão do pneu traseiro esquerdo) A requisição é feita individualmente, assim como os demais dados, a união foi feita apenas para evitar repetição na documentação * Descrição: status da pressão do pneu * Formato: categórico * Valores: * extremely low (extremamente baixa) * Descrição: indica que o status da pressão do pneu é extremamente baixa * very low (muito baixa) * Descrição: indica que o status da pressão do pneu é muito baixa * low (baixa) * Descrição: indica que o status da pressão do pneu é baixa * nominal (nominal) * Descrição: indica que o status da pressão do pneu é nominal * high (alta) * Descrição: indica que o status da pressão do pneu é alta * unknown (desconhecido) * Descrição: indica que o status da pressão do pneu é desconhecido * Exemplo: ```json theme={null} { "right_front_tire_pressure_status": "extremely low", "left_front_tire_pressure_status": "very low", "right_rear_tire_pressure_status": "low", "left_rear_tire_pressure_status": "nominal" } ``` ## ideal\_front\_tire\_pressure Pressão Ideal dos Pneus Dianteiros * Descrição: pressão sugerida pela montadora para os pneus da frente * Formato: numérico * Unidade: psi * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 14 a 150 psi * O valor mínimo da pressão ideal dos pneus dianteiros foi definida com base na pressão atmosférica, considerando uma margem de erro. O valor máximo da pressão de pneu foi definida com base no valor máximo que os veículos conectados à mobway podem atingir, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "ideal_front_tire_pressure": { "value": 2.54, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "ideal_front_tire_pressure": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "ideal_front_tire_pressure": 32.50 } ``` ## ideal\_rear\_tire\_pressure Pressão Ideal dos Pneus Traseiros * Descrição: pressão sugerida pela montadora para os pneus de trás * Formato: numérico * Unidade: psi * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: 14 a 150 psi * O valor mínimo da pressão ideal dos pneus traseiros foi definida com base na pressão atmosférica, considerando uma margem de erro. O valor máximo da pressão de pneu foi definida com base no valor máximo que os veículos conectados à mobway podem atingir, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "ideal_rear_tire_pressure": { "value": 7.09, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "ideal_rear_tire_pressure": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "ideal_rear_tire_pressure": 30.00 } ``` # Transmissão Source: https://docs.mobway.cloud/data/transmission Dados relacionados à transmissão do veículo ## transmission\_fluid\_temperature Temperatura do Fluido da Transmissão * Descrição: temperatura do fluido da transmissão do veículo * Formato: numérico * Unidade: °C * Casas decimais: 2 * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float * Faixa: -15°C a 180°C * O valor mínimo da temperatura do fluido da transmissão foi definida com base na temperatura do ambiente mínima atingida no Brasil, considerando uma margem de segurança. O valor máximo da temperatura do fluido da transmissão foi definida com base nos valores máximos comumente atingidos, considerando uma margem de segurança * Dados fora desta faixa são considerados como errôneos * O valor é substituído por um valor nulo * É gerada uma flag indicando o erro e o valor original, no seguinte formato: ```json theme={null} { "transmission_fluid_temperature": { "value": 255.00, "flag": "out of range" } } ``` * Dados faltantes * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato: ```json theme={null} { "transmission_fluid_temperature": { "flag": "missing data" } } ``` * Exemplo: ```json theme={null} { "transmission_fluid_temperature": 78.25 } ``` # VIN Source: https://docs.mobway.cloud/data/vin O VIN é o número de identificação único do veículo, o qual será utilizado também como identificador na plataforma mobway para cadastrar e consultar o veículo ## vin Número de Identificação do Veículo * Descrição: VIN é o número de identificação do seu veículo, também conhecido como número do chassi. Ele pode ser encontrado no CRLV (Certificado de Registro e Licenciamento do Veículo) ou em seu veículo, variando a localização específica dependendo do modelo. Os locais mais comuns são: * No motor, próximo ao cabeçote * Na carroceria, do lado do passageiro, dentro de uma tampinha na parte metálica * Na coluna da porta dianteira lateral direita * No compartimento do motor * Em um dos pára-brisas e em um dos vidros traseiros * Em pelo menos dois vidros de cada lado do veículo * Exemplo: ```json theme={null} { "vin": "9BM384073WB000000" } ``` Informações detalhadas sobre o VIN, podem ser encontradas [aqui](https://docs.mobway.cloud/vin). # Introdução Source: https://docs.mobway.cloud/introduction Este local serve como o hub central para acessar informações relacionadas ao produto mobway. Hero Light Hero Dark ## Bem-vindo(a) ao guia completo mobway Somos o motor de inteligência veicular em seu serviço. Através de uma conexão direta e homologada com as montadoras, permitimos que você obtenha, em tempo real, dados e inteligência dos seus veículos conectados, utilizando uma plataforma 'privacy-by-design' que garante compliance e transparência. ### Primeiros Passos Através da integração homologada com montadoras, nós coletamos, padronizamos e limpamos os dados gerados por veículos conectados. Assim você obtém todas as informações do veículo em tempo real, sem hardware, pronto para conectar frotas inteiras em minutos. Para a utilização da nossa API, é um pré-requisito que o veículo seja conectado, saiba mais [aqui](https://docs.mobway.cloud/vehicle) sobre o que é um veículo conectado e descubra se você já possui um modelo na sua frota. Privacidade e transparência na mobway são algo sério! O proprietário pode conceder ou remover acesso aos dados do veículo a qualquer momento. Você pode encontrar mais detalhes [aqui](https://docs.mobway.cloud/compliance). Para utilizar a API, você precisará possuir um cadastro vinculado a sua empresa, siga este passo a passo para conseguir seu primeiro acesso e gerar seu [Client ID e Client Secret](https://docs.mobway.cloud/api-reference/key). Após o registro da sua empresa e com as credenciais em mãos, você pode começar a fazer solicitações autenticadas para a API da mobway. Isso envolve incluir as credenciais do seu aplicativo em cada solicitação de API. Com o Client ID e Client Secret gerados e com um token de autenticação, siga este guia de [uso da API](https://docs.mobway.cloud/api-reference/token) para saber mais. ### FAQ A mobway é uma plataforma de hub de dados de veículos que permite que você se conecte a veículos conectados, sem a instalação de hardwares externos. Atualmente os dados possíveis de serem extraídos através da mobway estão descritos em [dados](https://docs.mobway.cloud/data/data) e [viagens](https://docs.mobway.cloud/data/trip). Atualmente, não oferecemos SDKs ou bibliotecas. No entanto, nossa API foi projetada para ser fácil de usar por qualquer cliente. A frequência das atualizações de dados depende de vários fatores, incluindo o tipo de dado e o fabricante e modelo do veículo. Entre em contato conosco pelo e-mai para informações mais detalhadas [info@mobway.cloud](mailto:info@mobway.cloud). Confira [aqui](https://doc.clickup.com/3066448/p/h/2xjjg-4953/da821ee01eae9f9) a lista atual de carros conectados no Brasil. # O carro conectado Source: https://docs.mobway.cloud/vehicle Em essência, um veículo conectado é equipado com uma variedade de sensores e dispositivos que permitem a comunicação contínua entre o carro e a montadora. Essa conexão constante permite que o veículo transmita, receba e compartilhe informações em tempo real. Car Light Car Dark Dessa forma, é possível coletar dados sobre o próprio veículo, como o estado do motor, a pressão dos pneus, eficiência do combustível, geolocalização, leitura do odômetro e etc. A lista pode ser encontrada em [dados](https://docs.mobway.cloud/data/data) e [viagens](https://docs.mobway.cloud/data/trip). Essas informações são enviadas para uma central da montadora, onde podem ser acessadas pelos proprietários ou fabricantes para monitorar o desempenho do veículo, agendar manutenção preventiva, melhorar a segurança ou serem disponibilizadas para acesso em algum serviço de acordo com o consentimento do proprietário através de uma plataforma como a mobway. A lista pode ser encontrada [aqui](/compatible-vehicles). Como o mercado de veículos conectados está em franca expansão, esta lista é frequentemente atualizada! Para mais detalhes sobre o consetimento dos dados de um veículo conectado, acesse [aqui](/compliance). # VIN Source: https://docs.mobway.cloud/vin ## O que é VIN? VIN é o número de identificação do seu veículo, também conhecido como **número do chassi**. Ele possui 17 caracteres que podem ser letras ou números, que são dispostos da seguinte forma: Os 3 primeiros dígitos são chamados de World Manufacturer Identifier (WMI), e indicam a divisão específica do fabricante do veículo * 1º caractere: Indica o continente onde o veículo foi construído * A - C: África * J - R: Ásia * S - Z: Europa * 1 - 5: América do Norte * 6 - 7: Oceania * 8 - 9: América do Sul * 1º e 2º caracteres: Indicam em conjunto o país onde o veículo foi construído * 93 - 99, 9A - 9E: Brasil * 1º ao 3º caracteres: Indicam em conjunto a divisão específica do fabricante do veículo * Brasil: * 9BD: Fiat * 9BF: Ford * 9BG: Chevrolet * 9BW: Volkswagen * 9BH: Hyundai Motor * 935: Citroën * 936: Peugeot A [lista completa](https://docs.mobway.cloud/vin#lista-completa-de-montadoras-do-brasil) das montadoras do Brasil pode ser encontrada no final desta página. * 4º caractere: Indica características específicas do modelo e características de segurança * 5º caractere: Indica a série do modelo específico do veículo * 6º e 7º caracteres: Indicam o tipo de carroceria do veículo * 8º caractere: Indica o tamanho do motor É o código de segurança, utilizado para identificar a autenticidade do VIN Indica o ano de fabricação do veículo. A regra diz que deve ser representado por letras de A (1980) a Y (2000) e pelos números de 1 (2001) a 9 (2009). Quando as possibilidades se esgotam, voltam as letras e números do começo. As letras I, O, Q, U e Z não são utilizadas. * P: 2023 * N: 2022 * M: 2021 * L: 2020 * K: 2019 * J: 2018 * H: 2017 * G: 2016 * F: 2015 Indica em qual planta do fabricante o veículo foi feito É o número de série do veículo ## Como descobrir o VIN do meu veículo? Ele pode ser encontrado no CRLV (Certificado de Registro e Licenciamento do Veículo) ou em seu veículo, variando a localização específica dependendo do modelo. Os locais mais comuns são: * No motor, próximo ao cabeçote * Na carroceria, do lado do passageiro, dentro de uma tampinha na parte metálica * Na coluna da porta dianteira lateral direita * No compartimento do motor * Em um dos pára-brisas e em um dos vidros traseiros * Em pelo menos dois vidros de cada lado do veículo ## Lista completa de montadoras do Brasil A seguir está a lista de montadoras do Brasil, com seus respectivos códigos WMI: | WMI | Montadoras de Automóveis | | - | - | | 9BW | Volkswagen | | 9BG | Chevrolet/GM | | 9BF | Ford | | 9BD | Fiat | | 9BR | Toyota | | 93H | Honda Automóveis | | 93U | Audi | | 93X | Mitsubishi | | 93Y | Renault | | 94D | Nissan | | 935 | Citroën | | 936 | Peugeot | | 937 | Dodge | | 9BH | Hyundai Motor | | 9BU | Gurgel | | 9EA | JPX | | 94T | Troller | | 95P | CAOA Hyundai & CAOA Chery | | 988 | Jeep | | 98M | BWM | | 98R | Chery | | 99J | Jaguar Land Rover | | 99L | BYD |