Indice dei Metodi:   Position Services   –   Geofencing   –   EventsServices

Position Services

Position Services

Servizio mediante il quale è possibile accedere a determinate informazioni riguardanti i target associati all'utente, nello specifico relative al collocamento dei dispositivi in una posizione in un determinato momento.
NB: i dati sulle distanze sono espressi in km e le date sono in formato UTC.


Esempio di chiamata in C# di una funzione del Position Services (nell'esempio PositionServices è il nome del namespace):

   using (PositionServices.PositionsServiceSoapClient client = new PositionServices.PositionsServiceSoapClient()){
      PositionServices.MembershipSoapHeader header = new PositionServices.MembershipSoapHeader();
      header.Username = @"99999\johndoe"; //99999 = codice cliente, johndoe = username
      header.Password = "12345"; //12345 = password
      client.Open();
      double mileage = client.GetMileage(header, "JOHNDOE001", null); //JOHNDOE001 = codice target
      client.Close();
   }

Indice

---------------------------------------------------------------------------------------

GetCANData

Descrizione: Metodo per ottenere dalla box i dati del CAN, come ad esempio distanza percorsa, temperatura del motore, rpm, livello e consumo del carburante; i dati si riferiscono a un intervallo temporale compreso tra due date da indicare.


Dettaglio funzione: public TargetCANDataDTO[] GetCANData(string target, string tag, DateTime fromUtc, DateTime toUtc)
      target: oggetto da tracciare;
      tag: tag dell'oggetto;
      fromUtc: data di partenza per l'intervallo di interesse (formato UTC);
      toUtc: data conclusiva per l'intervallo di interesse (formato UTC).

GetDatedMileage

Descrizione: Metodo per ottenere la distanza percorsa in km e la data a cui si riferisce l'informazione; i km percorsi sono sia quelli registrati dalla box sia quelli che eventualmente erano presenti prima dell'installazione (dato richiesto all'utente in un primo momento).


Dettaglio funzione: public MileageDTO GetDatedMileage(string target, string tag)
      target: oggetto da tracciare;
      tag: tag dell'oggetto.

GetDatedPartialMileage

Descrizione: Metodo per ottenere la distanza percorsa in km in un intervallo temporale specificato e la data a cui si riferisce l'informazione.


Dettaglio funzione: public MileageDTO GetDatedPartialMileage(string target, string tag, DateTime fromUtc, DateTime toUtc)
      target: oggetto da tracciare;
      tag: tag dell'oggetto;
      fromUtc: data di partenza per l'intervallo di interesse (formato UTC);
      toUtc: data conclusiva per l'intervallo di interesse (formato UTC).

GetHistory

Descrizione: Metodo per sapere, in un intervallo temporale indicato tra due date, dove e quando è stato localizzato il target richiesto; le informazioni sulla posizione sono indicate in latitudine e longitudine.


Dettaglio funzione: public TargetGeocodedPositionDTO[] GetHistory(string target, string tag, DateTime fromUtc, DateTime toUtc)
      target: oggetto da tracciare;
      tag: tag dell'oggetto;
      fromUtc: data di partenza per l'intervallo di interesse (formato UTC);
      toUtc: data conclusiva per l'intervallo di interesse (formato UTC).

GetHistoryWithGeocoding

Descrizione: Metodo per sapere, in un intervallo temporale indicato tra due date, dove e quando è stato localizzato il target richiesto; oltre alle coordinate geografiche è presente il servizio di geocodifica della posizione nel quale una posizione indicata in latitudine e longitudine viene tradotta in un indirizzo stradale.


Dettaglio funzione: public TargetGeocodedPositionDTO[] GetHistoryWithGeocoding(string target, string tag, DateTime fromUtc, DateTime toUtc)
      target: oggetto da tracciare;
      tag: tag dell'oggetto;
      fromUtc: data di partenza per l'intervallo di interesse (formato UTC);
      toUtc: data conclusiva per l'intervallo di interesse (formato UTC).

GetLastPosition

Descrizione: Metodo per sapere dove e quando è stato localizzato il target richiesto l'ultima volta che l'apparato ha inviato una posizione; le informazioni sulla posizione sono indicate in latitudine e longitudine.


Dettaglio funzione: public TargetGeocodedPositionDTO GetLastPosition(string target, string tag)
      target: oggetto da tracciare;
      tag: tag dell'oggetto.

GetLastPositionWithGeocoding

Descrizione: Metodo per sapere dove e quando è stato localizzato il target richiesto l'ultima volta che l'apparato ha inviato una posizione; oltre alle coordinate geografiche è presente il servizio di geocodifica della posizione nel quale una posizione indicata in latitudine e longitudine viene tradotta in un indirizzo stradale.


Dettaglio funzione: public TargetGeocodedPositionDTO GetLastPositionWithGeocoding(string target, string tag)
      target: oggetto da tracciare;
      tag: tag dell'oggetto.

GetLastPositions

Descrizione: Metodo per sapere dove e quando sono stati localizzati tutti i target dell'utente l'ultima volta che gli apparati hanno inviato una posizione; le informazioni sulla posizione sono indicate in latitudine e longitudine.


Dettaglio funzione: public TargetGeocodedPositionDTO[] GetLastPositions()

GetLastPositionsWithGeocoding

Descrizione: Metodo per sapere dove e quando sono stati localizzati tutti i target dell'utente l'ultima volta che gli apparati hanno inviato una posizione; oltre alle coordinate geografiche è presente il servizio di geocodifica della posizione nel quale una posizione indicata in latitudine e longitudine viene tradotta in un indirizzo stradale.


Dettaglio funzione: public TargetGeocodedPositionDTO[] GetLastPositionsWithGeocoding()

GetMileage

Descrizione: Metodo che restituisce la distanza percorsa in km dal target; include anche un eventuale chilometraggio precedente all'installazione della box (dato già inserito dall'utente).


Dettaglio funzione: public double GetMileage(string target, string tag)
      target: oggetto da tracciare;
      tag: tag dell'oggetto.

GetPartialMileage

Descrizione: Metodo che restituisce la distanza percorsa in km dal target in un intervallo temporale compreso tra due date.


Dettaglio funzione: public double GetPartialMileage(string target, string tag, DateTime fromUtc, DateTime toUtc)
      target: oggetto da tracciare;
      tag: tag dell'oggetto.
      fromUtc: data di partenza per l'intervallo di interesse (formato UTC);
      toUtc: data conclusiva per l'intervallo di interesse (formato UTC).

SetMileage

Descrizione: Metodo che consente di impostare il chilometraggio della box a un valore desiderato.


Dettaglio funzione: public void SetMileage(string target, string tag, double mileage)
      target: oggetto da tracciare;
      tag: tag dell'oggetto;
      mileage: numero di km da impostare.

TestConnection

Descrizione: Metodo che invia un messaggio di test alla box che risponderà con il messaggio stesso preceduto da "Received ".


Dettaglio funzione: public string TestConnection(string testMessage)
      testMessage: messaggio di test da inviare.

Indice dei Metodi:   Position Services   –   Geofencing   –   EventsServices

Geofencing

Geofencing

Servizio per le attività nelle zone
NB: i dati sulle distanze sono espressi in km e le date sono in formato UTC.


Esempio di chiamata in C# di una funzione del Geofencing (nell'esempio Geofencing è il nome del namespace):

   using (Geofencing.GeofencingSoapClient client = new Geofencing.GeofencingSoapClient()){
      DateTime fromUTC = DateTime.Today.Date.ToUniversalTime();
      DateTime toUTC = DateTime.UtcNow;
      Geofencing.MembershipSoapHeader header = new Geofencing.MembershipSoapHeader();
      header.Username = @"99999\johndoe"; //99999 = codice cliente, johndoe = username
      header.Password = "12345"; //12345 = password
      client.Open();
      Geofencing.ZoneActivityRecord[] zoneActivityRecords = client.GetZoneActivities(header, fromUTC, toUTC);
      client.Close();
   }

Indice


---------------------------------------------------------------------------------------

GetZoneActivity

Descrizione: Metodo che, quando un target effettua un segmento di ingresso-uscita da una zona, ne riporta gli elementi salienti quali tempo di permanenza nella zona e km percorsi.


Dettaglio funzione: public ZoneActivityRecord[] GetZoneActivities(DateTime fromUtc, DateTime toUtc)
      fromUtc: data di partenza per l'intervallo di interesse (formato UTC);
      toUtc: data conclusiva per l'intervallo di interesse (formato UTC).

Indice dei Metodi:   Position Services   –   Geofencing   –   EventsServices

Events Service

Events Service

Servizio per l'accesso ad eventi dei target, in particolare relativi a segmenti di accensione e prese di forza.
NB: i dati sulle distanze sono espressi in km e le date sono in formato UTC.


Esempio di chiamata in C# di una funzione del Event Services (nell'esempio EventServices è il nome del namespace):

   using (EventsServices.EventsServiceSoapClient client = new EventsServices.EventsServiceSoapClient()){
      DateTime fromUTC = DateTime.Today.Date.ToUniversalTime();
      DateTime toUTC = DateTime.UtcNow;
      EventsServices.MembershipSoapHeader header = new EventsServices.MembershipSoapHeader();
      header.Username = @"99999\johndoe"; //99999 = codice cliente, johndoe = username
      header.Password = "12345"; //12345 = password
      client.Open();
      EventSegmentDTO[] ret = client.GetAccSegments(header, "DOTMOBI073", fromUTC, toUTC);
      client.Close();
   }

Indice


---------------------------------------------------------------------------------------

GetAccSegments

Descrizione: Metodo per ottenere, in uno specificato periodo, i segmenti di accensione-spegnimento del mezzo, calcolando per ciascuno la distanza percorsa e identificandone tutti i punti di tracking, per i quali ne viene verificata l'appartenenza ad una o più zone.


Dettaglio funzione: public EventSegmentDTO[] GetAccSegments(string targetCode, DateTime fromUtc, DateTime toUtc)
      targetCode: oggetto da tracciare;
      fromUtc: data di partenza per l'intervallo di interesse (formato UTC);
      toUtc: data conclusiva per l'intervallo di interesse (formato UTC).

GetForceSegments

Descrizione: Metodo per ottenere, in uno specificato periodo, i segmenti di accensione-spegnimento delle prese di forza mezzo, calcolando per ciascuno la distanza percorsa e identificandone tutti i punti di tracking, per i quali ne viene verificata l'appartenenza ad una o più zone.


Dettaglio funzione: public EventSegmentDTO[] GetForceSegments(string targetCode, DateTime fromUtc, DateTime toUtc)
      targetCode: oggetto da tracciare;
      fromUtc: data di partenza per l'intervallo di interesse (formato UTC);
      toUtc: data conclusiva per l'intervallo di interesse (formato UTC).

Indice dei Metodi:   Position Services   –   Geofencing   –   EventsServices