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.
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
GetDatedMileage
GetDatedPartialMileage
GetHistory
GetHistoryWithGeocoding
GetLastPosition
GetLastPositionWithGeocoding
GetLastPositions
GetLastPositionsWithGeocoding
GetMileage
GetPartialMileage
SetMileage
TestConnection
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:
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).
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:
target: oggetto da tracciare;
tag: tag dell'oggetto.
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:
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).
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:
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).
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:
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).
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:
target: oggetto da tracciare;
tag: tag dell'oggetto.
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:
target: oggetto da tracciare;
tag: tag dell'oggetto.
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:
target: oggetto da tracciare;
tag: tag dell'oggetto.
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:
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).
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:
target: oggetto da tracciare;
tag: tag dell'oggetto;
mileage: numero di km da impostare.
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:
testMessage: messaggio di test da inviare.
public string TestConnection(string testMessage)
testMessage: messaggio di test da inviare.
Indice dei Metodi: Position Services – Geofencing – EventsServices
Geofencing
Servizio per le attività nelle zone
NB: i dati sulle distanze sono espressi in km e le date sono in formato UTC.
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:
fromUtc: data di partenza per l'intervallo di interesse (formato UTC);
toUtc: data conclusiva per l'intervallo di interesse (formato UTC).
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
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.
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:
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).
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:
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).
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).