Navixy Web Service

Endpoint SOAP para solicitar dados de rastreamento para um período especificado

Categoria do Protocolo: Protocolo de consolidação de dados

Índice

O que é o Navixy Web Service?

Navixy Web Service o protocolo de reencaminhamento de dados transmite dados da frota do sistema Navixy para qualquer sistema de terceiros. O protocolo é flexível, permitindo que terceiros armazenem dados da frota em seus bancos de dados para usar para quaisquer finalidades ou para exibir dados em recursos web.

Como este protocolo de reencaminhamento de dados é independente de plataforma, seria a opção ideal para qualquer parceiro que trabalhe com arquivos XML.

Informações técnicas gerais do Navixy Web Service

O protocolo Navixy Web Service utiliza SOAP para permitir a extração de dados em XML de dispositivos de rastreamento como parte da camada de aplicação do modelo OSI. Os dados são extraídos sob demanda.

Campos de dados que são enviados:

dateGPS: Data e hora em UTC
ignition: Status booleano da ignição
latitude
longitude
speedGPS: km/h
unitPlate: Placa
altitude: Metros
course: Direção do veículo, por exemplo: N,S,E,O,NO,NE,SO,SE
deviceId: IMEI
numSat: Número de satélites GNSS que o dispositivo está utilizando
odometer: Distância percorrida em km
eventId: o código de evento de acordo com o ID de evento do Navixy Generic Protocol

Configuração do Navixy Web Service

Configuração

Para configurar o reencaminhamento de dados no protocolo Navixy Web Service:

Vá para Dispositivos e configurações na barra lateral esquerda.
Selecione o dispositivo necessário da Objetos lista.
Encontre o Reencaminhamento de dados portlet, expanda-o e clique .
Na janela aberta, clique em "+" para adicionar uma nova retransmissão.
No Novo protocolo de retransmissão diálogo, insira as informações exigidas. Para o protocolo Navixy Web Service, preencha os campos a seguir:

Parâmetro

Explicação

Nome

Um rótulo descritivo para identificar esta configuração de retransmissão de dados. Insira um nome para tornar este retransmissor facilmente identificável.

Protocolo e Login

O protocolo de comunicação usado para retransmissão. Selecione Navixy Web Service no menu suspenso.

Endereço

A URL ou endereço IP do servidor de destino. Observação: Não é utilizado pelo Navixy Web Service, insira qualquer formato de endereço válido.

Porta

A porta de rede para conexão ao servidor de destino. Observação: Não é utilizada pelo Navixy Web Service, insira qualquer número de porta.

Um identificador único para esta conexão do retransmissor. Insira qualquer login que ainda não esteja sendo usado por outro retransmissor em seu sistema.

Senha

Código de autenticação para esta conexão do retransmissor. Insira uma senha exclusiva para proteger esta configuração de retransmissão.

Ative o Habilitado interruptor para ativar a retransmissão de dados. O retransmissor não transmitirá nenhum dado enquanto estiver desativado.
A tela de gerenciamento de retransmissão deverá ser semelhante à seguinte, com o login e a senha do Navixy Web Service. Certifique-se de que o status esteja Ativo se desejar que este retransmissor envie dados.
Em seguida, o retransmissor precisará ser vinculado ao dispositivo. Para isso, habilite o interruptor com o nome do retransmissor necessário no Reencaminhamento de dados portlet. O ID Externo não é necessário para o protocolo Navixy Web Service.

Você criou e habilitou com sucesso um novo protocolo de retransmissão para este dispositivo. Agora o retransmissor está disponível para todos os dispositivos na conta; você pode habilitá-lo alternando o interruptor nas configurações de outros dispositivos.

Acesso externo:

Parâmetros requeridos:

Login e senha: Estes devem corresponder às credenciais que você definiu na configuração do retransmissor
deviceIDs: Máx. de 100
startDate e endDate: Por exemplo, 9 de setembro de 2022 00:00 UTC até 11:59:59
- UTC: 2022-09-01T00:00:00Z até 2022-09-01T11:59:59Z

A descrição do protocolo em WSDL pode ser encontrada abaixo, referente à localização do servidor:

UE https://soap.navixy.com/LocationDataService?wsdl

EUA https://soap.us.navixy.com/LocationDataService?wsdl

Uma requisição SOAP deve ser feita utilizando uma das páginas WSDL acima. A própria requisição XML é a seguinte, substituindo-se com as informações associadas:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org">

   <soapenv:Header>
   <tem:authentication>
     <login>username</login>
     <password>password</password>
   </tem:authentication>
   </soapenv:Header>
   <soapenv:Body>
   <tem:dataRequest>
      <!--1 to 100 repetitions:-->
      <deviceIds>IMEI of device</deviceIds>
      <startDate>2022-08-30T00:00:00Z</startDate>
      <endDate>2022-08-31T00:00:00Z</endDate>
   </tem:dataRequest>
   </soapenv:Body>
</soapenv:Envelope>

Uma resposta de exemplo pode ser como esta:

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
    <S:Body>
        <ns:getLocationDataResponse xmlns:ns="http://tempuri.org">
            <result>
                <dateGps>2019-10-15T08:48:50.000Z</dateGps>
                <ignition>false</ignition>
                <latitude>75.9270866</latitude>
                <longitude>-85.5207616</longitude>
                <speedGps>0.0</speedGps>
                <unitPlate>JRT1550</unitPlate>
                <altitude>284.0</altitude>
                <course>N</course>
                <deviceId>866258048802349</deviceId>
                <numSat>15</numSat>
                <odometer>59845</odometer>
                <eventId>401</eventId>
            </result>
        </ns:getLocationDataResponse>
    </S:Body>
</S:Envelope>

Gerenciamento

Para editar ou interromper o reencaminhamento de dados, siga estes passos:

Em qualquer Reencaminhamento de dados portlet, clique para abrir a lista de protocolos disponíveis.
Clique para alterar as configurações do retransmissor, como nome, informações de login ou status habilitado.
Clique e confirme para excluir um retransmissor

Todas as alterações são salvas automaticamente.

Para habilitar/desabilitar um retransmissor para um determinado dispositivo, alterne o interruptor com o nome do retransmissor necessário no Reencaminhamento de dados portlet.

Solução de problemas

Para verificar e testar sua requisição SOAP para a plataforma, é sugerido usar o SoapUI que pode ser encontrado aqui: https://www.soapui.org/downloads/soapui/

Instale o Soap UI
No menu Arquivo, selecione “New SOAP Project”
Cole o caminho correto no campo WSDL de acordo com o servidor e selecione Create sample requests for all operations?
EUA: https://soap.us.navixy.com/LocationDataService?wsdl
UE: https://soap.navixy.com/LocationDataService?wsdl

AnteriorILSP PróximoRecurso Confiável

Atualizado há 1 mês

Isto foi útil?