API Routes (Calcolo percorsi in batch)

Q: Come mi autentico su Routes (REST e SOAP)?

Le richieste REST inviano TrackServiceKey nell’header X-API-Key. Le richieste SOAP CalculateRoutes inviano TrackServiceKey nel SessionIDHeader come SessionID.

Q: Quando dovrei usare Routes invece di Route?

Usa Route quando devi calcolare un singolo percorso. Usa Routes quando vuoi calcolare più percorsi in una singola richiesta batch.

Q: Quali sono gli errori più comuni dell’API Routes?

Gli errori comuni includono un X-API-Key mancante o non valido, errori di autenticazione SOAP con SessionIDHeader, Locations mancanti, coordinate non valide e valori enum non validi.

Usa Routes per calcolare più percorsi in una singola richiesta. REST restituisce JSON, mentre SOAP usa CalculateRoutes per flussi di calcolo percorsi in batch e integrazioni legacy.

Routes calcola più percorsi in una sola chiamata, rendendola utile per la pianificazione massiva dei percorsi, il confronto dei percorsi e i flussi di lavoro di routing batch.

Hai bisogno del contratto API completo?

Swagger copre i modelli REST, mentre il WSDL SOAP supporta le integrazioni legacy TrackService.

Apri Swagger UI Apri SOAP WSDL Panoramica del riferimento API

Cosa fa Routes#

Routes calcola uno o più percorsi in una singola richiesta. Questo lo rende utile quando hai bisogno del calcolo percorsi in batch invece di inviare molte chiamate per un singolo percorso.

Ogni percorso usa un elenco ordinato di input Location e RouteOptions opzionali. Puoi anche definire un oggetto globale RoutesOptions che applica i valori predefiniti all’intera richiesta.

Suggerimento: Se ti serve un solo percorso, usa API Route . Se devi calcolare più percorsi contemporaneamente, usa Routes.

Endpoint e URL di base#

REST (JSON)

Elemento	Valore
URL di base	https://trackservice.trackroad.com
Endpoint	`POST /rest/routes`
URL completo	https://trackservice.trackroad.com/rest/routes
Content-Type	`application/json`

SOAP (CalculateRoutes)

Elemento	Valore
URL SOAP	https://trackservice.trackroad.com/TrackService.asmx
WSDL	https://trackservice.trackroad.com/TrackService.asmx?WSDL
Metodo	`CalculateRoutes`
SOAPAction	http://TrackService.TrackRoad.com/CalculateRoutes
Content-Type	`text/xml; charset=utf-8`

SOAP e REST condividono gli stessi concetti fondamentali di routing, come RouteSpecification, RouteOptions e Location. La differenza principale è il trasporto: JSON per REST e busta SOAP + SessionIDHeader per SOAP.

Autenticazione (REST e SOAP)#

Autenticazione REST (X-API-Key)

Includi il tuo TrackServiceKey nell’header X-API-Key per ogni richiesta REST. Vedi Autenticazione API .

Autenticazione SOAP (SessionIDHeader)

Le richieste SOAP usano SessionIDHeader. Invia il tuo TrackServiceKey come SessionID per ogni chiamata CalculateRoutes.

Consigliato: usa REST a meno che tu non debba integrare un sistema aziendale esistente solo SOAP o legacy.

Schema della richiesta#

Il body della richiesta REST è un singolo oggetto batch: RoutesSpecification, che contiene un elenco di elementi RouteSpecification. SOAP usa la stessa struttura logica all’interno dell’operazione CalculateRoutes.

Modelli condivisi

Location, LatLong e Address sono condivisi tra più endpoint. Vedi API Dispatch (modelli condivisi) .

RoutesSpecification (REST)

Proprietà	Tipo	Obbligatorio	Descrizione
`Specifications`	RouteSpecification[]	Sì*	Un elemento per ogni percorso che vuoi calcolare nella richiesta batch.
`RoutesOptions`	RouteOptions	No	Valori predefiniti globali applicati a ogni percorso, salvo override tramite RouteOptions per percorso.

RouteSpecification

Proprietà	Tipo	Obbligatorio	Descrizione
`Locations`	Location[]	Sì*	Fermate di questo percorso. L’ordine può essere ottimizzato in base alle RouteOptions.
`RouteOptions`	RouteOptions	No	Override per singolo percorso per motore di routing, unità, modalità di ottimizzazione, lingua/cultura e opzioni mappa.

RouteOptions (riepilogo)

I campi RouteOptions come RoutingService, DistanceUnit, RouteOptimize, Culture e le impostazioni relative alla mappa sono simili all’endpoint Route e possono essere applicati globalmente o per singolo percorso.

Schema della risposta#

Risposta REST (RoutesResult)

Proprietà	Tipo	Descrizione
`Results`	RouteResult[]	Un risultato per ogni RouteSpecification in input.
`Map`	string	Output mappa opzionale in base alle opzioni. Può essere vuoto.
`Errors`	Error[]	Avvisi ed errori opzionali restituiti dal servizio.
`Status`	int (enum)	0=None, 1=Success, 2=Failed, 3=SuccessWithErrors.

Risposta SOAP (CalculateRoutesResult)

SOAP incapsula la stessa struttura logica del risultato all’interno di CalculateRoutesResponse e CalculateRoutesResult.

Esempi#

Usa gli esempi qui sotto per capire come funziona TrackRoad Routes con REST JSON e SOAP CalculateRoutes. I blocchi di codice di esempio devono rimanere invariati tra le lingue.

REST request body (JSON)#

{
  "Locations": [
    { "Name": "Start", "LatLong": { "Latitude": 37.7946, "Longitude": -122.3950 }, "LocationType": 1 },
    { "Name": "Stop A", "LatLong": { "Latitude": 37.7897, "Longitude": -122.4011 }, "LocationType": 0 },
    { "Name": "Finish", "LatLong": { "Latitude": 37.7810, "Longitude": -122.4110 }, "LocationType": 2 }
  ],
  "RouteOptions": {
    "RoutingService": 2,
    "DistanceUnit": 0,
    "RouteOptimize": 0,
    "Culture": "en-US",
    "ZoomLevel": 0
  }
}

REST call examples#

curl -X POST "https://trackservice.trackroad.com/rest/Route" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_TRACKSERVICEKEY" \
  -d @route-request.json

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

var url = "https://trackservice.trackroad.com/rest/Route";
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("X-API-Key", "YOUR_TRACKSERVICEKEY");

var json = @"{
  ""Locations"": [
    { ""Name"": ""Start"", ""LatLong"": { ""Latitude"": 37.7946, ""Longitude"": -122.3950 }, ""LocationType"": 1 },
    { ""Name"": ""Stop A"", ""LatLong"": { ""Latitude"": 37.7897, ""Longitude"": -122.4011 }, ""LocationType"": 0 },
    { ""Name"": ""Finish"", ""LatLong"": { ""Latitude"": 37.7810, ""Longitude"": -122.4110 }, ""LocationType"": 2 }
  ],
  ""RouteOptions"": { ""RoutingService"": 2, ""DistanceUnit"": 0, ""RouteOptimize"": 0, ""Culture"": ""en-US"", ""ZoomLevel"": 0 }
}";
using var content = new StringContent(json, Encoding.UTF8, "application/json");

var resp = await http.PostAsync(url, content);
Console.WriteLine(await resp.Content.ReadAsStringAsync());

const url = "https://trackservice.trackroad.com/rest/Route";

const payload = {
  Locations: [
    { Name: "Start", LatLong: { Latitude: 37.7946, Longitude: -122.3950 }, LocationType: 1 },
    { Name: "Stop A", LatLong: { Latitude: 37.7897, Longitude: -122.4011 }, LocationType: 0 },
    { Name: "Finish", LatLong: { Latitude: 37.7810, Longitude: -122.4110 }, LocationType: 2 }
  ],
  RouteOptions: { RoutingService: 2, DistanceUnit: 0, RouteOptimize: 0, Culture: "en-US", ZoomLevel: 0 }
};

const res = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_TRACKSERVICEKEY"
  },
  body: JSON.stringify(payload)
});

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

import okhttp3.*;

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

    String json = "{"
      + "\"Locations\":["
      + "{\"Name\":\"Start\",\"LatLong\":{\"Latitude\":37.7946,\"Longitude\":-122.3950},\"LocationType\":1},"
      + "{\"Name\":\"Stop A\",\"LatLong\":{\"Latitude\":37.7897,\"Longitude\":-122.4011},\"LocationType\":0},"
      + "{\"Name\":\"Finish\",\"LatLong\":{\"Latitude\":37.7810,\"Longitude\":-122.4110},\"LocationType\":2}"
      + "],"
      + "\"RouteOptions\":{\"RoutingService\":2,\"DistanceUnit\":0,\"RouteOptimize\":0,\"Culture\":\"en-US\",\"ZoomLevel\":0}"
      + "}";

    RequestBody body = RequestBody.create(json, MediaType.parse("application/json"));
    Request request = new Request.Builder()
      .url("https://trackservice.trackroad.com/rest/Route")
      .post(body)
      .addHeader("Content-Type", "application/json")
      .addHeader("X-API-Key", "YOUR_TRACKSERVICEKEY")
      .build();

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

import requests

url = "https://trackservice.trackroad.com/rest/Route"
headers = {
  "Content-Type": "application/json",
  "X-API-Key": "YOUR_TRACKSERVICEKEY"
}

payload = {
  "Locations": [
    { "Name": "Start", "LatLong": { "Latitude": 37.7946, "Longitude": -122.3950 }, "LocationType": 1 },
    { "Name": "Stop A", "LatLong": { "Latitude": 37.7897, "Longitude": -122.4011 }, "LocationType": 0 },
    { "Name": "Finish", "LatLong": { "Latitude": 37.7810, "Longitude": -122.4110 }, "LocationType": 2 }
  ],
  "RouteOptions": { "RoutingService": 2, "DistanceUnit": 0, "RouteOptimize": 0, "Culture": "en-US", "ZoomLevel": 0 }
}

r = requests.post(url, headers=headers, json=payload)
print(r.text)

<?php
$url = "https://trackservice.trackroad.com/rest/Route";

$payload = json_encode([
  "Locations" => [
    [ "Name" => "Start", "LatLong" => [ "Latitude" => 37.7946, "Longitude" => -122.3950 ], "LocationType" => 1 ],
    [ "Name" => "Stop A", "LatLong" => [ "Latitude" => 37.7897, "Longitude" => -122.4011 ], "LocationType" => 0 ],
    [ "Name" => "Finish", "LatLong" => [ "Latitude" => 37.7810, "Longitude" => -122.4110 ], "LocationType" => 2 ]
  ],
  "RouteOptions" => [ "RoutingService" => 2, "DistanceUnit" => 0, "RouteOptimize" => 0, "Culture" => "en-US", "ZoomLevel" => 0 ]
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: YOUR_TRACKSERVICEKEY"
  ],
  CURLOPT_POSTFIELDS => $payload
]);

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

require "net/http"
require "json"
require "uri"

uri = URI("https://trackservice.trackroad.com/rest/Route")

payload = {
  Locations: [
    { Name: "Start", LatLong: { Latitude: 37.7946, Longitude: -122.3950 }, LocationType: 1 },
    { Name: "Stop A", LatLong: { Latitude: 37.7897, Longitude: -122.4011 }, LocationType: 0 },
    { Name: "Finish", LatLong: { Latitude: 37.7810, Longitude: -122.4110 }, LocationType: 2 }
  ],
  RouteOptions: { RoutingService: 2, DistanceUnit: 0, RouteOptimize: 0, Culture: "en-US", ZoomLevel: 0 }
}

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Post.new(uri.request_uri)
req["Content-Type"] = "application/json"
req["X-API-Key"] = "YOUR_TRACKSERVICEKEY"
req.body = JSON.generate(payload)

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

package main

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

func main() {
  url := "https://trackservice.trackroad.com/rest/Route"

  body := []byte(`{
    "Locations": [
      { "Name": "Start", "LatLong": { "Latitude": 37.7946, "Longitude": -122.3950 }, "LocationType": 1 },
      { "Name": "Stop A", "LatLong": { "Latitude": 37.7897, "Longitude": -122.4011 }, "LocationType": 0 },
      { "Name": "Finish", "LatLong": { "Latitude": 37.7810, "Longitude": -122.4110 }, "LocationType": 2 }
    ],
    "RouteOptions": { "RoutingService": 2, "DistanceUnit": 0, "RouteOptimize": 0, "Culture": "en-US", "ZoomLevel": 0 }
  }`)

  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(body))
  req.Header.Set("Content-Type", "application/json")
  req.Header.Set("X-API-Key", "YOUR_TRACKSERVICEKEY")

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

  var buf bytes.Buffer
  buf.ReadFrom(resp.Body)
  fmt.Println(buf.String())
}

import okhttp3.MediaType.Companion.toMediaType
import okhttp3.OkHttpClient
import okhttp3.Request
import okhttp3.RequestBody.Companion.toRequestBody

fun main() {
  val client = OkHttpClient()
  val url = "https://trackservice.trackroad.com/rest/Route"

  val json = """
  {
    "Locations": [
      { "Name": "Start", "LatLong": { "Latitude": 37.7946, "Longitude": -122.3950 }, "LocationType": 1 },
      { "Name": "Stop A", "LatLong": { "Latitude": 37.7897, "Longitude": -122.4011 }, "LocationType": 0 },
      { "Name": "Finish", "LatLong": { "Latitude": 37.7810, "Longitude": -122.4110 }, "LocationType": 2 }
    ],
    "RouteOptions": { "RoutingService": 2, "DistanceUnit": 0, "RouteOptimize": 0, "Culture": "en-US", "ZoomLevel": 0 }
  }
  """.trimIndent()

  val body = json.toRequestBody("application/json".toMediaType())
  val request = Request.Builder()
    .url(url)
    .post(body)
    .addHeader("Content-Type", "application/json")
    .addHeader("X-API-Key", "YOUR_TRACKSERVICEKEY")
    .build()

  client.newCall(request).execute().use { resp ->
    println(resp.body?.string())
  }
}

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

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

  const char *url = "https://trackservice.trackroad.com/rest/Route";
  const char *json =
    "{"
    "\"Locations\":["
      "{\"Name\":\"Start\",\"LatLong\":{\"Latitude\":37.7946,\"Longitude\":-122.3950},\"LocationType\":1},"
      "{\"Name\":\"Stop A\",\"LatLong\":{\"Latitude\":37.7897,\"Longitude\":-122.4011},\"LocationType\":0},"
      "{\"Name\":\"Finish\",\"LatLong\":{\"Latitude\":37.7810,\"Longitude\":-122.4110},\"LocationType\":2}"
    "],"
    "\"RouteOptions\":{\"RoutingService\":2,\"DistanceUnit\":0,\"RouteOptimize\":0,\"Culture\":\"en-US\",\"ZoomLevel\":0}"
    "}";

  struct curl_slist *headers = NULL;
  headers = curl_slist_append(headers, "Content-Type: application/json");
  headers = curl_slist_append(headers, "X-API-Key: YOUR_TRACKSERVICEKEY");

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

  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>

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

  const char* url = "https://trackservice.trackroad.com/rest/Route";
  const char* json =
    "{"
    "\"Locations\":["
      "{\"Name\":\"Start\",\"LatLong\":{\"Latitude\":37.7946,\"Longitude\":-122.3950},\"LocationType\":1},"
      "{\"Name\":\"Stop A\",\"LatLong\":{\"Latitude\":37.7897,\"Longitude\":-122.4011},\"LocationType\":0},"
      "{\"Name\":\"Finish\",\"LatLong\":{\"Latitude\":37.7810,\"Longitude\":-122.4110},\"LocationType\":2}"
    "],"
    "\"RouteOptions\":{\"RoutingService\":2,\"DistanceUnit\":0,\"RouteOptimize\":0,\"Culture\":\"en-US\",\"ZoomLevel\":0}"
    "}";

  struct curl_slist* headers = nullptr;
  headers = curl_slist_append(headers, "Content-Type: application/json");
  headers = curl_slist_append(headers, "X-API-Key: YOUR_TRACKSERVICEKEY");

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

  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(int argc, const char * argv[]) {
  @autoreleasepool {
    NSURL *url = [NSURL URLWithString:@"https://trackservice.trackroad.com/rest/Route"];

    NSDictionary *payload = @{
      @"Locations": @[
        @{@"Name":@"Start", @"LatLong":@{@"Latitude":@37.7946, @"Longitude":@-122.3950}, @"LocationType":@1},
        @{@"Name":@"Stop A", @"LatLong":@{@"Latitude":@37.7897, @"Longitude":@-122.4011}, @"LocationType":@0},
        @{@"Name":@"Finish", @"LatLong":@{@"Latitude":@37.7810, @"Longitude":@-122.4110}, @"LocationType":@2}
      ],
      @"RouteOptions": @{@"RoutingService":@2, @"DistanceUnit":@0, @"RouteOptimize":@0, @"Culture":@"en-US", @"ZoomLevel":@0}
    };

    NSData *body = [NSJSONSerialization dataWithJSONObject:payload options:0 error:nil];

    NSMutableURLRequest *req = [NSMutableURLRequest requestWithURL:url];
    req.HTTPMethod = @"POST";
    [req setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
    [req setValue:@"YOUR_TRACKSERVICEKEY" forHTTPHeaderField:@"X-API-Key"];
    req.HTTPBody = body;

    dispatch_semaphore_t sema = dispatch_semaphore_create(0);

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

    [task resume];
    dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);
  }
  return 0;
}

import Foundation

let url = URL(string: "https://trackservice.trackroad.com/rest/Route")!

let payload: [String: Any] = [
  "Locations": [
    ["Name": "Start", "LatLong": ["Latitude": 37.7946, "Longitude": -122.3950], "LocationType": 1],
    ["Name": "Stop A", "LatLong": ["Latitude": 37.7897, "Longitude": -122.4011], "LocationType": 0],
    ["Name": "Finish", "LatLong": ["Latitude": 37.7810, "Longitude": -122.4110], "LocationType": 2]
  ],
  "RouteOptions": ["RoutingService": 2, "DistanceUnit": 0, "RouteOptimize": 0, "Culture": "en-US", "ZoomLevel": 0]
]

let body = try JSONSerialization.data(withJSONObject: payload, options: [])

var req = URLRequest(url: url)
req.httpMethod = "POST"
req.setValue("application/json", forHTTPHeaderField: "Content-Type")
req.setValue("YOUR_TRACKSERVICEKEY", forHTTPHeaderField: "X-API-Key")
req.httpBody = body

let sema = DispatchSemaphore(value: 0)

URLSession.shared.dataTask(with: req) { data, response, error in
  if let error = error { print(error) }
  else if let data = data { print(String(data: data, encoding: .utf8) ?? "") }
  sema.signal()
}.resume()

sema.wait()

SOAP request (CalculateRoute)#

SOAP requires SessionIDHeader. Replace YOUR_SESSION_ID with the session id returned from SOAP Login.

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <SessionIDHeader xmlns="http://TrackService.TrackRoad.com/">
      <SessionID>YOUR_SESSION_ID</SessionID>
    </SessionIDHeader>
  </soap:Header>

  <soap:Body>
    <CalculateRoute xmlns="http://TrackService.TrackRoad.com/">
      <specification>
        <Locations>
          <Location>
            <Name>Start</Name>
            <LatLong><Latitude>37.7946</Latitude><Longitude>-122.3950</Longitude></LatLong>
            <LocationType>Start</LocationType>
          </Location>

          <Location>
            <Name>Stop A</Name>
            <LatLong><Latitude>37.7897</Latitude><Longitude>-122.4011</Longitude></LatLong>
            <LocationType>Midway</LocationType>
          </Location>

          <Location>
            <Name>Finish</Name>
            <LatLong><Latitude>37.7810</Latitude><Longitude>-122.4110</Longitude></LatLong>
            <LocationType>Finish</LocationType>
          </Location>
        </Locations>

        <RouteOptions>
          <RoutingService>Bing</RoutingService>
          <DistanceUnit>Mile</DistanceUnit>
          <RouteOptimize>MinimizeTime</RouteOptimize>
          <Culture>en-US</Culture>
          <ZoomLevel>0</ZoomLevel>
        </RouteOptions>
      </specification>
    </CalculateRoute>
  </soap:Body>
</soap:Envelope>

SOAP call examples#

curl -X POST "https://trackservice.trackroad.com/TrackService.asmx" \
  -H "Content-Type: text/xml; charset=utf-8" \
  -H "SOAPAction: http://TrackService.TrackRoad.com/CalculateRoute" \
  -d @calculate-route.xml

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

var url = "https://trackservice.trackroad.com/TrackService.asmx";
var soapAction = "http://TrackService.TrackRoad.com/CalculateRoute";

var xml = @"<?xml version=""1.0"" encoding=""utf-8""?>
<soap:Envelope xmlns:soap=""http://schemas.xmlsoap.org/soap/envelope/"">
  <soap:Header>
    <SessionIDHeader xmlns=""http://TrackService.TrackRoad.com/"">
      <SessionID>YOUR_SESSION_ID</SessionID>
    </SessionIDHeader>
  </soap:Header>
  <soap:Body>
    <CalculateRoute xmlns=""http://TrackService.TrackRoad.com/"">
      <specification>
        <Locations>
          <Location>
            <Name>Start</Name>
            <LatLong><Latitude>37.7946</Latitude><Longitude>-122.3950</Longitude></LatLong>
            <LocationType>Start</LocationType>
          </Location>
          <Location>
            <Name>Stop A</Name>
            <LatLong><Latitude>37.7897</Latitude><Longitude>-122.4011</Longitude></LatLong>
            <LocationType>Midway</LocationType>
          </Location>
          <Location>
            <Name>Finish</Name>
            <LatLong><Latitude>37.7810</Latitude><Longitude>-122.4110</Longitude></LatLong>
            <LocationType>Finish</LocationType>
          </Location>
        </Locations>
        <RouteOptions>
          <RoutingService>Bing</RoutingService>
          <DistanceUnit>Mile</DistanceUnit>
          <RouteOptimize>MinimizeTime</RouteOptimize>
          <Culture>en-US</Culture>
          <ZoomLevel>0</ZoomLevel>
        </RouteOptions>
      </specification>
    </CalculateRoute>
  </soap:Body>
</soap:Envelope>";

using var http = new HttpClient();
using var content = new StringContent(xml, 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.Content = content;
req.Headers.TryAddWithoutValidation("SOAPAction", soapAction);

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

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

const xml = `<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <SessionIDHeader xmlns="http://TrackService.TrackRoad.com/">
      <SessionID>YOUR_SESSION_ID</SessionID>
    </SessionIDHeader>
  </soap:Header>
  <soap:Body>
    <CalculateRoute xmlns="http://TrackService.TrackRoad.com/">
      <specification>
        <Locations>
          <Location>
            <Name>Start</Name>
            <LatLong><Latitude>37.7946</Latitude><Longitude>-122.3950</Longitude></LatLong>
            <LocationType>Start</LocationType>
          </Location>
          <Location>
            <Name>Stop A</Name>
            <LatLong><Latitude>37.7897</Latitude><Longitude>-122.4011</Longitude></LatLong>
            <LocationType>Midway</LocationType>
          </Location>
          <Location>
            <Name>Finish</Name>
            <LatLong><Latitude>37.7810</Latitude><Longitude>-122.4110</Longitude></LatLong>
            <LocationType>Finish</LocationType>
          </Location>
        </Locations>
        <RouteOptions>
          <RoutingService>Bing</RoutingService>
          <DistanceUnit>Mile</DistanceUnit>
          <RouteOptimize>MinimizeTime</RouteOptimize>
          <Culture>en-US</Culture>
          <ZoomLevel>0</ZoomLevel>
        </RouteOptions>
      </specification>
    </CalculateRoute>
  </soap:Body>
</soap:Envelope>`;

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

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

import okhttp3.*;

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

    String xml = "<?xml version=\"1.0\" encoding=\"utf-8\"?>"
      + "<soap:Envelope xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\">"
      + "  <soap:Header>"
      + "    <SessionIDHeader xmlns=\"http://TrackService.TrackRoad.com/\">"
      + "      <SessionID>YOUR_SESSION_ID</SessionID>"
      + "    </SessionIDHeader>"
      + "  </soap:Header>"
      + "  <soap:Body>"
      + "    <CalculateRoute xmlns=\"http://TrackService.TrackRoad.com/\">"
      + "      <specification>"
      + "        <Locations>"
      + "          <Location><Name>Start</Name><LatLong><Latitude>37.7946</Latitude><Longitude>-122.3950</Longitude></LatLong><LocationType>Start</LocationType></Location>"
      + "          <Location><Name>Stop A</Name><LatLong><Latitude>37.7897</Latitude><Longitude>-122.4011</Longitude></LatLong><LocationType>Midway</LocationType></Location>"
      + "          <Location><Name>Finish</Name><LatLong><Latitude>37.7810</Latitude><Longitude>-122.4110</Longitude></LatLong><LocationType>Finish</LocationType></Location>"
      + "        </Locations>"
      + "        <RouteOptions><RoutingService>Bing</RoutingService><DistanceUnit>Mile</DistanceUnit><RouteOptimize>MinimizeTime</RouteOptimize><Culture>en-US</Culture><ZoomLevel>0</ZoomLevel></RouteOptions>"
      + "      </specification>"
      + "    </CalculateRoute>"
      + "  </soap:Body>"
      + "</soap:Envelope>";

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

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

import requests

url = "https://trackservice.trackroad.com/TrackService.asmx"
headers = {
  "Content-Type": "text/xml; charset=utf-8",
  "SOAPAction": "http://TrackService.TrackRoad.com/CalculateRoute"
}

xml = """<?xml version="1.0" encoding="utf-8"?<
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"<
  <soap:Header<
    <SessionIDHeader xmlns="http://TrackService.TrackRoad.com/"<
      <SessionID<YOUR_SESSION_ID</SessionID<
    </SessionIDHeader<
  </soap:Header<
  <soap:Body<
    <CalculateRoute xmlns="http://TrackService.TrackRoad.com/"<
      <specification<
        <Locations<
          <Location<
            <Name<Start</Name<
            <LatLong<<Latitude<37.7946</Latitude<<Longitude<-122.3950</Longitude<</LatLong<
            <LocationType<Start</LocationType<
          </Location<
          <Location<
            <Name<Stop A</Name<
            <LatLong<<Latitude<37.7897</Latitude<<Longitude<-122.4011</Longitude<</LatLong<
            <LocationType<Midway</LocationType<
          </Location<
          <Location<
            <Name<Finish</Name<
            <LatLong<<Latitude<37.7810</Latitude<<Longitude<-122.4110</Longitude<</LatLong<
            <LocationType<Finish</LocationType<
          </Location<
        </Locations<
        <RouteOptions<
          <RoutingService<Bing</RoutingService<
          <DistanceUnit<Mile</DistanceUnit<
          <RouteOptimize<MinimizeTime</RouteOptimize<
          <Culture<en-US</Culture<
          <ZoomLevel<0</ZoomLevel<
        </RouteOptions<
      </specification<
    </CalculateRoute<
  </soap:Body<
</soap:Envelope<"""

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

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

$xml = '<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <SessionIDHeader xmlns="http://TrackService.TrackRoad.com/">
      <SessionID>YOUR_SESSION_ID</SessionID>
    </SessionIDHeader>
  </soap:Header>
  <soap:Body>
    <CalculateRoute xmlns="http://TrackService.TrackRoad.com/">
      <specification>
        <Locations>
          <Location><Name>Start</Name><LatLong><Latitude>37.7946</Latitude><Longitude>-122.3950</Longitude></LatLong><LocationType>Start</LocationType></Location>
          <Location><Name>Stop A</Name><LatLong><Latitude>37.7897</Latitude><Longitude>-122.4011</Longitude></LatLong><LocationType>Midway</LocationType></Location>
          <Location><Name>Finish</Name><LatLong><Latitude>37.7810</Latitude><Longitude>-122.4110</Longitude></LatLong><LocationType>Finish</LocationType></Location>
        </Locations>
        <RouteOptions>
          <RoutingService>Bing</RoutingService>
          <DistanceUnit>Mile</DistanceUnit>
          <RouteOptimize>MinimizeTime</RouteOptimize>
          <Culture>en-US</Culture>
          <ZoomLevel>0</ZoomLevel>
        </RouteOptions>
      </specification>
    </CalculateRoute>
  </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/CalculateRoute"
  ],
  CURLOPT_POSTFIELDS => $xml
]);

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

require "net/http"
require "uri"

uri = URI("https://trackservice.trackroad.com/TrackService.asmx")

xml = <<~XML
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <SessionIDHeader xmlns="http://TrackService.TrackRoad.com/">
      <SessionID>YOUR_SESSION_ID</SessionID>
    </SessionIDHeader>
  </soap:Header>
  <soap:Body>
    <CalculateRoute xmlns="http://TrackService.TrackRoad.com/">
      <specification>
        <Locations>
          <Location><Name>Start</Name><LatLong><Latitude>37.7946</Latitude><Longitude>-122.3950</Longitude></LatLong><LocationType>Start</LocationType></Location>
          <Location><Name>Stop A</Name><LatLong><Latitude>37.7897</Latitude><Longitude>-122.4011</Longitude></LatLong><LocationType>Midway</LocationType></Location>
          <Location><Name>Finish</Name><LatLong><Latitude>37.7810</Latitude><Longitude>-122.4110</Longitude></LatLong><LocationType>Finish</LocationType></Location>
        </Locations>
        <RouteOptions><RoutingService>Bing</RoutingService><DistanceUnit>Mile</DistanceUnit><RouteOptimize>MinimizeTime</RouteOptimize><Culture>en-US</Culture><ZoomLevel>0</ZoomLevel></RouteOptions>
      </specification>
    </CalculateRoute>
  </soap:Body>
</soap:Envelope>
XML

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

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

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

package main

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

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

  xml := []byte(`<?xml version="1.0" encoding="utf-8"?<
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"<
  <soap:Header<
    <SessionIDHeader xmlns="http://TrackService.TrackRoad.com/"<
      <SessionID<YOUR_SESSION_ID</SessionID<
    </SessionIDHeader<
  </soap:Header<
  <soap:Body<
    <CalculateRoute xmlns="http://TrackService.TrackRoad.com/"<
      <specification<
        <Locations<
          <Location<<Name<Start</Name<<LatLong<<Latitude<37.7946</Latitude<<Longitude<-122.3950</Longitude<</LatLong<<LocationType<Start</LocationType<</Location<
          <Location<<Name<Stop A</Name<<LatLong<<Latitude<37.7897</Latitude<<Longitude<-122.4011</Longitude<</LatLong<<LocationType<Midway</LocationType<</Location<
          <Location<<Name<Finish</Name<<LatLong<<Latitude<37.7810</Latitude<<Longitude<-122.4110</Longitude<</LatLong<<LocationType<Finish</LocationType<</Location<
        </Locations<
        <RouteOptions<<RoutingService<Bing</RoutingService<<DistanceUnit<Mile</DistanceUnit<<RouteOptimize<MinimizeTime</RouteOptimize<<Culture<en-US</Culture<<ZoomLevel<0</ZoomLevel<</RouteOptions<
      </specification<
    </CalculateRoute<
  </soap:Body<
</soap:Envelope<`)

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

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

  var buf bytes.Buffer
  buf.ReadFrom(resp.Body)
  fmt.Println(buf.String())
}

import okhttp3.MediaType.Companion.toMediaType
import okhttp3.OkHttpClient
import okhttp3.Request
import okhttp3.RequestBody.Companion.toRequestBody

fun main() {
  val client = OkHttpClient()
  val url = "https://trackservice.trackroad.com/TrackService.asmx"

  val xml = """
  <?xml version="1.0" encoding="utf-8"?>
  <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Header>
      <SessionIDHeader xmlns="http://TrackService.TrackRoad.com/">
        <SessionID>YOUR_SESSION_ID</SessionID>
      </SessionIDHeader>
    </soap:Header>
    <soap:Body>
      <CalculateRoute xmlns="http://TrackService.TrackRoad.com/">
        <specification>
          <Locations>
            <Location><Name>Start</Name><LatLong><Latitude>37.7946</Latitude><Longitude>-122.3950</Longitude></LatLong><LocationType>Start</LocationType></Location>
            <Location><Name>Stop A</Name><LatLong><Latitude>37.7897</Latitude><Longitude>-122.4011</Longitude></LatLong><LocationType>Midway</LocationType></Location>
            <Location><Name>Finish</Name><LatLong><Latitude>37.7810</Latitude><Longitude>-122.4110</Longitude></LatLong><LocationType>Finish</LocationType></Location>
          </Locations>
          <RouteOptions><RoutingService>Bing</RoutingService><DistanceUnit>Mile</DistanceUnit><RouteOptimize>MinimizeTime</RouteOptimize><Culture>en-US</Culture><ZoomLevel>0</ZoomLevel></RouteOptions>
        </specification>
      </CalculateRoute>
    </soap:Body>
  </soap:Envelope>
  """.trimIndent()

  val body = xml.toRequestBody("text/xml; charset=utf-8".toMediaType())
  val request = Request.Builder()
    .url(url)
    .post(body)
    .addHeader("Content-Type", "text/xml; charset=utf-8")
    .addHeader("SOAPAction", "http://TrackService.TrackRoad.com/CalculateRoute")
    .build()

  client.newCall(request).execute().use { resp ->
    println(resp.body?.string())
  }
}

#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 *xml =
    "<?xml version=\"1.0\" encoding=\"utf-8\"?>"
    "<soap:Envelope xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\">"
    "<soap:Header>"
      "<SessionIDHeader xmlns=\"http://TrackService.TrackRoad.com/\">"
        "<SessionID>YOUR_SESSION_ID</SessionID>"
      "</SessionIDHeader>"
    "</soap:Header>"
    "<soap:Body>"
      "<CalculateRoute xmlns=\"http://TrackService.TrackRoad.com/\">"
        "<specification>"
          "<Locations>"
            "<Location><Name>Start</Name><LatLong><Latitude>37.7946</Latitude><Longitude>-122.3950</Longitude></LatLong><LocationType>Start</LocationType></Location>"
            "<Location><Name>Stop A</Name><LatLong><Latitude>37.7897</Latitude><Longitude>-122.4011</Longitude></LatLong><LocationType>Midway</LocationType></Location>"
            "<Location><Name>Finish</Name><LatLong><Latitude>37.7810</Latitude><Longitude>-122.4110</Longitude></LatLong><LocationType>Finish</LocationType></Location>"
          "</Locations>"
          "<RouteOptions><RoutingService>Bing</RoutingService><DistanceUnit>Mile</DistanceUnit><RouteOptimize>MinimizeTime</RouteOptimize><Culture>en-US</Culture><ZoomLevel>0</ZoomLevel></RouteOptions>"
        "</specification>"
      "</CalculateRoute>"
    "</soap:Body>"
    "</soap:Envelope>";

  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/CalculateRoute");

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

  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>

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

  const char* url = "https://trackservice.trackroad.com/TrackService.asmx";
  const char* xml =
    "<?xml version=\"1.0\" encoding=\"utf-8\"?>"
    "<soap:Envelope xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\">"
    "<soap:Header>"
      "<SessionIDHeader xmlns=\"http://TrackService.TrackRoad.com/\">"
        "<SessionID>YOUR_SESSION_ID</SessionID>"
      "</SessionIDHeader>"
    "</soap:Header>"
    "<soap:Body>"
      "<CalculateRoute xmlns=\"http://TrackService.TrackRoad.com/\">"
        "<specification>"
          "<Locations>"
            "<Location><Name>Start</Name><LatLong><Latitude>37.7946</Latitude><Longitude>-122.3950</Longitude></LatLong><LocationType>Start</LocationType></Location>"
            "<Location><Name>Stop A</Name><LatLong><Latitude>37.7897</Latitude><Longitude>-122.4011</Longitude></LatLong><LocationType>Midway</LocationType></Location>"
            "<Location><Name>Finish</Name><LatLong><Latitude>37.7810</Latitude><Longitude>-122.4110</Longitude></LatLong><LocationType>Finish</LocationType></Location>"
          "</Locations>"
          "<RouteOptions><RoutingService>Bing</RoutingService><DistanceUnit>Mile</DistanceUnit><RouteOptimize>MinimizeTime</RouteOptimize><Culture>en-US</Culture><ZoomLevel>0</ZoomLevel></RouteOptions>"
        "</specification>"
      "</CalculateRoute>"
    "</soap:Body>"
    "</soap:Envelope>";

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

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

  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(int argc, const char * argv[]) {
  @autoreleasepool {
    NSURL *url = [NSURL URLWithString:@"https://trackservice.trackroad.com/TrackService.asmx"];

    NSString *xml =
    @"<?xml version=\"1.0\" encoding=\"utf-8\"?>"
    @"<soap:Envelope xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\">"
    @"  <soap:Header>"
    @"    <SessionIDHeader xmlns=\"http://TrackService.TrackRoad.com/\">"
    @"      <SessionID>YOUR_SESSION_ID</SessionID>"
    @"    </SessionIDHeader>"
    @"  </soap:Header>"
    @"  <soap:Body>"
    @"    <CalculateRoute xmlns=\"http://TrackService.TrackRoad.com/\">"
    @"      <specification>"
    @"        <Locations>"
    @"          <Location><Name>Start</Name><LatLong><Latitude>37.7946</Latitude><Longitude>-122.3950</Longitude></LatLong><LocationType>Start</LocationType></Location>"
    @"          <Location><Name>Stop A</Name><LatLong><Latitude>37.7897</Latitude><Longitude>-122.4011</Longitude></LatLong><LocationType>Midway</LocationType></Location>"
    @"          <Location><Name>Finish</Name><LatLong><Latitude>37.7810</Latitude><Longitude>-122.4110</Longitude></LatLong><LocationType>Finish</LocationType></Location>"
    @"        </Locations>"
    @"        <RouteOptions><RoutingService>Bing</RoutingService><DistanceUnit>Mile</DistanceUnit><RouteOptimize>MinimizeTime</RouteOptimize><Culture>en-US</Culture><ZoomLevel>0</ZoomLevel></RouteOptions>"
    @"      </specification>"
    @"    </CalculateRoute>"
    @"  </soap:Body>"
    @"</soap:Envelope>";

    NSMutableURLRequest *req = [NSMutableURLRequest requestWithURL:url];
    req.HTTPMethod = @"POST";
    [req setValue:@"text/xml; charset=utf-8" forHTTPHeaderField:@"Content-Type"];
    [req setValue:@"http://TrackService.TrackRoad.com/CalculateRoute" forHTTPHeaderField:@"SOAPAction"];
    req.HTTPBody = [xml dataUsingEncoding:NSUTF8StringEncoding];

    dispatch_semaphore_t sema = dispatch_semaphore_create(0);

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

    [task resume];
    dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);
  }
  return 0;
}

import Foundation

let url = URL(string: "https://trackservice.trackroad.com/TrackService.asmx")!

let xml = """
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <SessionIDHeader xmlns="http://TrackService.TrackRoad.com/">
      <SessionID>YOUR_SESSION_ID</SessionID>
    </SessionIDHeader>
  </soap:Header>
  <soap:Body>
    <CalculateRoute xmlns="http://TrackService.TrackRoad.com/">
      <specification>
        <Locations>
          <Location><Name>Start</Name><LatLong><Latitude>37.7946</Latitude><Longitude>-122.3950</Longitude></LatLong><LocationType>Start</LocationType></Location>
          <Location><Name>Stop A</Name><LatLong><Latitude>37.7897</Latitude><Longitude>-122.4011</Longitude></LatLong><LocationType>Midway</LocationType></Location>
          <Location><Name>Finish</Name><LatLong><Latitude>37.7810</Latitude><Longitude>-122.4110</Longitude></LatLong><LocationType>Finish</LocationType></Location>
        </Locations>
        <RouteOptions><RoutingService>Bing</RoutingService><DistanceUnit>Mile</DistanceUnit><RouteOptimize>MinimizeTime</RouteOptimize><Culture>en-US</Culture><ZoomLevel>0</ZoomLevel></RouteOptions>
      </specification>
    </CalculateRoute>
  </soap:Body>
</soap:Envelope>
"""

var req = URLRequest(url: url)
req.httpMethod = "POST"
req.setValue("text/xml; charset=utf-8", forHTTPHeaderField: "Content-Type")
req.setValue("http://TrackService.TrackRoad.com/CalculateRoute", forHTTPHeaderField: "SOAPAction")
req.httpBody = xml.data(using: .utf8)

let sema = DispatchSemaphore(value: 0)
URLSession.shared.dataTask(with: req) { data, response, error in
  if let error = error { print(error) }
  else if let data = data { print(String(data: data, encoding: .utf8) ?? "") }
  sema.signal()
}.resume()
sema.wait()

Response example (REST JSON)#

{
  "Route": {
    "Distance": 5.42,
    "Time": 1180,
    "RouteLegs": [
      {
        "Distance": 2.10,
        "Time": 480,
        "Itinerary": {
          "Items": [
            {
              "Distance": 0.2,
              "Time": 40,
              "Text": "Head north on ...",
              "LatLong": { "Latitude": 37.79, "Longitude": -122.39 }
            }
          ]
        }
      }
    ],
    "Points": [
      { "Latitude": 37.7946, "Longitude": -122.3950 },
      { "Latitude": 37.7897, "Longitude": -122.4011 }
    ],
    "Map": null
  },
  "Errors": [],
  "Status": 1
}

Errori comuni#

REST 401 / Unauthorized: X-API-Key mancante o non valido.
REST 403 / Forbidden: la chiave è valida ma bloccata, scaduta o senza credito disponibile.
Errore di autenticazione SOAP: SessionIDHeader mancante o non valido. SessionID deve essere il tuo TrackServiceKey.
Errori di validazione: Locations mancanti, coordinate non valide o valori enum non validi.

Best practice#

Raggruppa in modo intelligente: inserisci più calcoli di percorso in una sola chiamata Routes per ridurre l’overhead delle richieste.
Preferisci LatLong: fornisci coordinate quando possibile per ridurre l’ambiguità del geocoding e migliorare le prestazioni.
Usa RoutesOptions globali: imposta una sola volta i valori condivisi e fai override solo quando necessario per il singolo percorso.
Mantieni opzioni coerenti: mescolare motori di routing, unità o modalità di ottimizzazione tra percorsi può rendere più difficile il confronto.

FAQ#

Cosa fa l’API Routes?

L’API Routes calcola uno o più percorsi in una singola richiesta. Ogni risultato può includere località ordinate, distanza, tempo e un output mappa opzionale in base alle opzioni.

Come mi autentico su Routes (REST e SOAP)?

Le richieste REST inviano il TrackServiceKey nell’header X-API-Key. Le richieste SOAP CalculateRoutes inviano il TrackServiceKey nel SessionIDHeader come SessionID.

Quando dovrei usare Routes invece di Route?

Usa Route quando devi calcolare un singolo percorso. Usa Routes quando vuoi calcolare più percorsi in una singola richiesta batch.

Quali sono gli errori più comuni dell’API Routes?

Gli errori comuni includono un X-API-Key mancante o non valido, errori di autenticazione SOAP con SessionIDHeader, Locations mancanti, coordinate non valide e valori enum non validi.

Passaggio successivo: ottimizzare tra più veicoli

Se devi assegnare fermate a più veicoli e ottimizzare l’ordine delle fermate per veicolo, continua con l’API Dispatch.

Vai a Dispatch Swagger UI