API elenco percorsi (elenca percorsi salvati)

Q: Qual è l'equivalente SOAP dell'API elenco percorsi?

Il nome del metodo SOAP è GetRouteList.

Q: Come mi autentico?

Per SOAP, invia il tuo TrackServiceKey in SessionIDHeader come SessionID. Login e Logout non sono richiesti quando si usa TrackServiceKey.

Usa l'API elenco percorsi di TrackRoad per recuperare percorsi precedentemente salvati usando filtri come intervallo di date, proprietario e nome del percorso. Per le integrazioni SOAP, il metodo equivalente è GetRouteList.

Elenca e filtra i percorsi precedentemente salvati per report, dashboard e ricerche nella cronologia dei percorsi.

Ti serve il contratto completo?

Swagger include modelli e campi degli endpoint per REST, mentre il WSDL espone il contratto SOAP per GetRouteList e i metodi correlati.

Visualizza Swagger UI Visualizza WSDL SOAP Panoramica riferimento API

Cosa fa l'API elenco percorsi#

L'API elenco percorsi restituisce un elenco dei percorsi salvati per il tuo account. Viene comunemente usata per viste cronologiche dei percorsi, dashboard e schermate di ricerca in cui gli utenti devono trovare percorsi generati in precedenza.

I filtri tipici includono intervallo di date di creazione, proprietario e nome del percorso. Questo aiuta a mantenere le ricerche dei percorsi veloci, mirate e più facili da gestire in flotte più grandi.

Se hai bisogno dei dettagli completi di un singolo percorso, incluse fermate, indicazioni e tempi, usa la API Route .

Endpoint e URL di base#

La documentazione seguente di Routes List si concentra sul modello di integrazione SOAP mostrato da GetRouteList. Segui la documentazione del tuo account e Swagger quando i dettagli specifici della distribuzione sono diversi.

SOAP

Elemento	Valore
Endpoint	https://trackservice.trackroad.com/TrackService.asmx
WSDL	https://trackservice.trackroad.com/TrackService.asmx?WSDL
Metodo	`GetRouteList`
SOAPAction	http://TrackService.TrackRoad.com/GetRouteList

Autenticazione#

Per SOAP, invia il tuo TrackServiceKey in SessionIDHeader come SessionID. Login e Logout non sono richiesti quando si usa TrackServiceKey.

Conserva le chiavi API lato server ed evita di esporre valori di autenticazione nel codice del browser o delle app mobili.

Schema della richiesta#

La richiesta descrive i filtri usati per trovare i percorsi salvati. In SOAP, questi valori vengono passati come parametri di GetRouteList.

Campi di filtro dell'elenco percorsi

Campo	Tipo	Obbligatorio	Descrizione
`FromDate`	string (date-time)	No	Filtra i percorsi creati o aggiornati a partire da questo timestamp in formato ISO 8601.
`ToDate`	string (date-time)	No	Filtra i percorsi creati o aggiornati fino a questo timestamp in formato ISO 8601.
`Owner`	string	No	Filtra per proprietario o nome utente, se supportato dalla configurazione del tuo account.
`RouteName`	string	No	Filtra per nome del percorso con corrispondenza esatta o parziale, a seconda dell'implementazione.

Se la tua implementazione espone filtri aggiuntivi come stato, paginazione o numero massimo di risultati, documenta anche questi campi qui.

Schema della risposta#

Una risposta riuscita restituisce un elenco di percorsi che corrispondono ai tuoi filtri insieme a eventuali informazioni di stato o errore restituite dal servizio.

Risultato Routes

Proprietà	Tipo	Descrizione
`Routes`	RouteSummary[]	Elenco dei record di riepilogo dei percorsi corrispondenti.
`Errors`	Error[]	Errori o avvisi facoltativi restituiti dal servizio.
`Status`	int (enum)	Codice di stato, comunemente 0=None, 1=Success, 2=Failed, 3=SuccessWithErrors.

Riepilogo percorso

Proprietà	Tipo	Descrizione
`RouteID`	string / int	Identificatore del percorso usato successivamente per recuperare i dettagli completi del percorso.
`RouteName`	string	Nome del percorso leggibile dall'utente.
`Distance`	double	Distanza totale del percorso.
`Time`	int	Tempo totale del percorso, di solito in secondi salvo configurazione diversa.
`Owner`	string	Identificatore del proprietario o del creatore, quando disponibile.
`DateCreated`	string (date-time)	Timestamp che indica quando il percorso è stato creato.

SOAP restituisce lo stesso concetto di elenco percorsi all'interno di una busta SOAP, con il risultato racchiuso negli elementi di risposta di GetRouteList.

Esempi#

Inserisci in questa sezione la richiesta SOAP di esempio, la risposta di esempio e gli esempi di codice multilingua. Il codice di esempio in sé non deve essere localizzato.

SOAP: request examples (multiple languages)#

SOAP requires SessionIDHeader (SessionID = TrackServiceKey) and the SOAPAction header http://TrackService.TrackRoad.com/GetRouteList.

<!-- POST https://trackservice.trackroad.com/TrackService.asmx -->
<!-- Content-Type: text/xml; charset=utf-8 -->
<!-- SOAPAction: "http://TrackService.TrackRoad.com/GetRouteList" -->

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

  <soap:Header>
    <SessionIDHeader xmlns="http://TrackService.TrackRoad.com/">
      <SessionID>YOUR_TRACKSERVICEKEY</SessionID>
    </SessionIDHeader>
  </soap:Header>

  <soap:Body>
    <GetRouteList xmlns="http://TrackService.TrackRoad.com/">
      <FromDate>2026-01-01T00:00:00Z</FromDate>
      <ToDate>2026-01-31T23:59:59Z</ToDate>
      <Owner>dispatcher@company.com</Owner>
      <RouteName>January</RouteName>
    </GetRouteList>
  </soap:Body>
</soap:Envelope>

curl -X POST "https://trackservice.trackroad.com/TrackService.asmx" \
  -H "Content-Type: text/xml; charset=utf-8" \
  -H "SOAPAction: \"http://TrackService.TrackRoad.com/GetRouteList\"" \
  --data-binary @getroutelist.soap.xml

using System.Net.Http;
using System.Text;

var url = "https://trackservice.trackroad.com/TrackService.asmx";

var soap = @"

  
    
      YOUR_TRACKSERVICEKEY
    
  
  
    
      2026-01-01T00:00:00Z
      2026-01-31T23:59:59Z
      dispatcher@company.com
      January
    
  
";

using var http = new HttpClient();
using var content = new StringContent(soap, Encoding.UTF8, "text/xml");

content.Headers.Clear();
content.Headers.TryAddWithoutValidation("Content-Type", "text/xml; charset=utf-8");

var req = new HttpRequestMessage(HttpMethod.Post, url);
req.Headers.TryAddWithoutValidation("SOAPAction", "\"http://TrackService.TrackRoad.com/GetRouteList\"");
req.Content = content;

var resp = await http.SendAsync(req);
Console.WriteLine(await resp.Content.ReadAsStringAsync());

const url = "https://trackservice.trackroad.com/TrackService.asmx";

const soap = `

  
    
      YOUR_TRACKSERVICEKEY
    
  
  
    
      2026-01-01T00:00:00Z
      2026-01-31T23:59:59Z
      dispatcher@company.com
      January
    
  
`;

const res = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "text/xml; charset=utf-8",
    "SOAPAction": "\"http://TrackService.TrackRoad.com/GetRouteList\""
  },
  body: soap
});

console.log(await res.text());

import okhttp3.*;

public class Main {
  public static void main(String[] args) throws Exception {
    OkHttpClient client = new OkHttpClient();

    String soap = ""
      + ""
      + ""
      + ""
      + "YOUR_TRACKSERVICEKEY"
      + ""
      + ""
      + ""
      + ""
      + "2026-01-01T00:00:00Z"
      + "2026-01-31T23:59:59Z"
      + "dispatcher@company.com"
      + "January"
      + ""
      + ""
      + "";

    RequestBody body = RequestBody.create(soap, MediaType.parse("text/xml; charset=utf-8"));
    Request request = new Request.Builder()
      .url("https://trackservice.trackroad.com/TrackService.asmx")
      .post(body)
      .addHeader("SOAPAction", "\"http://TrackService.TrackRoad.com/GetRouteList\"")
      .build();

    try (Response response = client.newCall(request).execute()) {
      System.out.println(response.body().string());
    }
  }
}

import requests

url = "https://trackservice.trackroad.com/TrackService.asmx"
soap = """

  
    
      YOUR_TRACKSERVICEKEY
    
  
  
    
      2026-01-01T00:00:00Z
      2026-01-31T23:59:59Z
      dispatcher@company.com
      January
    
  
"""

headers = {
  "Content-Type": "text/xml; charset=utf-8",
  "SOAPAction": "\"http://TrackService.TrackRoad.com/GetRouteList\""
}

r = requests.post(url, data=soap.encode("utf-8"), headers=headers)
print(r.text)

<?php
$url = "https://trackservice.trackroad.com/TrackService.asmx";

$soap = '<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <SessionIDHeader xmlns="http://TrackService.TrackRoad.com/">
      <SessionID>YOUR_TRACKSERVICEKEY</SessionID>
    </SessionIDHeader>
  </soap:Header>
  <soap:Body>
    <GetRouteList xmlns="http://TrackService.TrackRoad.com/">
      <FromDate>2026-01-01T00:00:00Z</FromDate>
      <ToDate>2026-01-31T23:59:59Z</ToDate>
      <Owner>dispatcher@company.com</Owner>
      <RouteName>January</RouteName>
    </GetRouteList>
  </soap:Body>
</soap:Envelope>';

$ch = curl_init($url);
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Content-Type: text/xml; charset=utf-8",
    "SOAPAction: \"http://TrackService.TrackRoad.com/GetRouteList\""
  ],
  CURLOPT_POSTFIELDS => $soap
]);

echo curl_exec($ch);
curl_close($ch);

require "net/http"

uri = URI("https://trackservice.trackroad.com/TrackService.asmx")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

soap = <<~XML


  
    
      YOUR_TRACKSERVICEKEY
    
  
  
    
      2026-01-01T00:00:00Z
      2026-01-31T23:59:59Z
      dispatcher@company.com
      January
    
  

XML

req = Net::HTTP::Post.new(uri)
req["Content-Type"] = "text/xml; charset=utf-8"
req["SOAPAction"] = "\"http://TrackService.TrackRoad.com/GetRouteList\""
req.body = soap

res = http.request(req)
puts res.body

package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
)

func main() {
  url := "https://trackservice.trackroad.com/TrackService.asmx"

  soap := []byte(`

  
    
      YOUR_TRACKSERVICEKEY
    
  
  
    
      2026-01-01T00:00:00Z
      2026-01-31T23:59:59Z
      dispatcher@company.com
      January
    
  
`)

  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(soap))
  req.Header.Set("Content-Type", "text/xml; charset=utf-8")
  req.Header.Set("SOAPAction", "\"http://TrackService.TrackRoad.com/GetRouteList\"")

  resp, err := http.DefaultClient.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()

  b, _ := io.ReadAll(resp.Body)
  fmt.Println(string(b))
}

import java.net.URI
import java.net.http.HttpClient
import java.net.http.HttpRequest
import java.net.http.HttpResponse

fun main() {
  val url = "https://trackservice.trackroad.com/TrackService.asmx"
  val soap = """
    
    
      
        
          YOUR_TRACKSERVICEKEY
        
      
      
        
          2026-01-01T00:00:00Z
          2026-01-31T23:59:59Z
          dispatcher@company.com
          January
        
      
    
  """.trimIndent()

  val client = HttpClient.newHttpClient()
  val req = HttpRequest.newBuilder()
    .uri(URI.create(url))
    .header("Content-Type", "text/xml; charset=utf-8")
    .header("SOAPAction", "\"http://TrackService.TrackRoad.com/GetRouteList\"")
    .POST(HttpRequest.BodyPublishers.ofString(soap))
    .build()

  val resp = client.send(req, HttpResponse.BodyHandlers.ofString())
  println(resp.body())
}

#include <stdio.h>
#include <curl/curl.h>

int main(void) {
  CURL *curl = curl_easy_init();
  if(!curl) return 1;

  const char *url = "https://trackservice.trackroad.com/TrackService.asmx";
  const char *soap =
    ""
    ""
    ""
    ""
    "YOUR_TRACKSERVICEKEY"
    ""
    ""
    ""
    ""
    "2026-01-01T00:00:00Z"
    "2026-01-31T23:59:59Z"
    "dispatcher@company.com"
    "January"
    ""
    ""
    "";

  struct curl_slist *headers = NULL;
  headers = curl_slist_append(headers, "Content-Type: text/xml; charset=utf-8");
  headers = curl_slist_append(headers, "SOAPAction: \"http://TrackService.TrackRoad.com/GetRouteList\"");

  curl_easy_setopt(curl, CURLOPT_URL, url);
  curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
  curl_easy_setopt(curl, CURLOPT_POSTFIELDS, soap);

  CURLcode res = curl_easy_perform(curl);

  curl_slist_free_all(headers);
  curl_easy_cleanup(curl);

  return (res == CURLE_OK) ? 0 : 1;
}

#include <curl/curl.h>
#include <string>

int main() {
  CURL* curl = curl_easy_init();
  if(!curl) return 1;

  std::string url = "https://trackservice.trackroad.com/TrackService.asmx";
  std::string soap =
    ""
    ""
    ""
    ""
    "YOUR_TRACKSERVICEKEY"
    ""
    ""
    ""
    ""
    "2026-01-01T00:00:00Z"
    "2026-01-31T23:59:59Z"
    "dispatcher@company.com"
    "January"
    ""
    ""
    "";

  struct curl_slist* headers = NULL;
  headers = curl_slist_append(headers, "Content-Type: text/xml; charset=utf-8");
  headers = curl_slist_append(headers, "SOAPAction: \"http://TrackService.TrackRoad.com/GetRouteList\"");

  curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
  curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
  curl_easy_setopt(curl, CURLOPT_POSTFIELDS, soap.c_str());

  CURLcode res = curl_easy_perform(curl);

  curl_slist_free_all(headers);
  curl_easy_cleanup(curl);

  return (res == CURLE_OK) ? 0 : 1;
}

#import <Foundation/Foundation.h>

int main() {
  @autoreleasepool {
    NSURL *url = [NSURL URLWithString:@"https://trackservice.trackroad.com/TrackService.asmx"];
    NSMutableURLRequest *req = [NSMutableURLRequest requestWithURL:url];
    [req setHTTPMethod:@"POST"];
    [req setValue:@"text/xml; charset=utf-8" forHTTPHeaderField:@"Content-Type"];
    [req setValue:@"\"http://TrackService.TrackRoad.com/GetRouteList\"" forHTTPHeaderField:@"SOAPAction"];

    NSString *soap = @""
      ""
      ""
      ""
      "YOUR_TRACKSERVICEKEY"
      ""
      ""
      ""
      ""
      "2026-01-01T00:00:00Z"
      "2026-01-31T23:59:59Z"
      "dispatcher@company.com"
      "January"
      ""
      ""
      "";

    [req setHTTPBody:[soap dataUsingEncoding:NSUTF8StringEncoding]];

    NSURLSessionDataTask *task =
      [[NSURLSession sharedSession] dataTaskWithRequest:req
      completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
        if (error) { NSLog(@"%@", error); return; }
        NSString *text = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"%@", text);
      }];

    [task resume];
    [[NSRunLoop currentRunLoop] run];
  }
  return 0;
}

import Foundation

let url = URL(string: "https://trackservice.trackroad.com/TrackService.asmx")!
var req = URLRequest(url: url)
req.httpMethod = "POST"
req.setValue("text/xml; charset=utf-8", forHTTPHeaderField: "Content-Type")
req.setValue("\"http://TrackService.TrackRoad.com/GetRouteList\"", forHTTPHeaderField: "SOAPAction")

let soap = """


  
    
      YOUR_TRACKSERVICEKEY
    
  
  
    
      2026-01-01T00:00:00Z
      2026-01-31T23:59:59Z
      dispatcher@company.com
      January
    
  

"""

req.httpBody = soap.data(using: .utf8)

let task = URLSession.shared.dataTask(with: req) { data, _, error in
  if let error = error { print(error); return }
  print(String(data: data ?? Data(), encoding: .utf8) ?? "")
}
task.resume()
RunLoop.main.run()

SOAP: response example (shape)#

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Body>
    <GetRouteListResponse xmlns="http://TrackService.TrackRoad.com/">
      <GetRouteListResult>
        <Routes>
          <RouteSummary>
            <RouteID>12345</RouteID>
            <RouteName>January - North Zone</RouteName>
            <Distance>82.4</Distance>
            <Time>14250</Time>
            <Owner>dispatcher@company.com</Owner>
            <DateCreated>2026-01-12T16:21:00Z</DateCreated>
          </RouteSummary>
        </Routes>
        <Status>1</Status>
        <Errors />
      </GetRouteListResult>
    </GetRouteListResponse>
  </soap:Body>
</soap:Envelope>

Errori comuni#

Errore di autenticazione: SessionIDHeader mancante o non valido. Il valore di SessionID deve essere il tuo TrackServiceKey.
Formato data non valido: fornisci le date in formato ISO 8601, ad esempio 2026-01-31T23:59:59Z.
Nessun percorso corrispondente: l'intervallo di filtri, il proprietario o il nome del percorso potrebbero essere troppo restrittivi.
Problema di servizio o autorizzazione: la chiave può essere valida ma bloccata, scaduta o limitata per l'ambito account richiesto.

Best practice#

Usa filtri di data per mantenere risposte veloci e prevedibili, soprattutto nelle viste della cronologia dei percorsi.
Memorizza nella cache gli elenchi percorsi per dashboard caricate frequentemente e aggiornali su richiesta quando gli utenti cercano di nuovo.
Carica i dettagli del percorso solo quando necessario invece di recuperare i dati completi per ogni riga di risultato.
Documenta i campi specifici dell'account quando la tua distribuzione supporta filtri aggiuntivi o proprietà di risposta personalizzate.

FAQ#

Cosa fa l'API elenco percorsi?

L'API elenco percorsi restituisce un elenco di percorsi precedentemente salvati, solitamente filtrati per intervallo di date, proprietario o nome del percorso.

Qual è l'equivalente SOAP dell'API elenco percorsi?

Il nome del metodo SOAP è GetRouteList.

Come mi autentico?