API Routes (Calcul d’itinéraires par lot)

Q: Comment m’authentifier sur Routes (REST et SOAP) ?

Les requêtes REST envoient TrackServiceKey dans l’en-tête X-API-Key. Les requêtes SOAP CalculateRoutes envoient TrackServiceKey dans SessionIDHeader en tant que SessionID.

Q: Quand faut-il utiliser Routes plutôt que Route ?

Utilisez Route lorsque vous devez calculer un seul itinéraire. Utilisez Routes lorsque vous souhaitez calculer plusieurs itinéraires dans une seule requête par lot.

Q: Quelles sont les erreurs les plus courantes de l’API Routes ?

Les erreurs courantes incluent un X-API-Key manquant ou invalide, des échecs d’authentification SOAP avec SessionIDHeader, des Locations manquantes, des coordonnées invalides et des valeurs enum non valides.

Utilisez Routes pour calculer plusieurs itinéraires dans une seule requête. REST renvoie du JSON, tandis que SOAP utilise CalculateRoutes pour les flux de calcul d’itinéraires par lot et les intégrations héritées.

Routes calcule plusieurs itinéraires en un seul appel, ce qui la rend utile pour la planification massive d’itinéraires, la comparaison d’itinéraires et les workflows de routage par lot.

Besoin du contrat API complet ?

Swagger couvre les modèles REST, tandis que le WSDL SOAP prend en charge les intégrations héritées TrackService.

Voir Swagger UI Voir le WSDL SOAP Vue d’ensemble de la référence API

Ce que fait Routes#

Routes calcule un ou plusieurs itinéraires dans une seule requête. Cela est utile lorsque vous avez besoin d’un calcul d’itinéraires par lot plutôt que d’envoyer de nombreux appels unitaires.

Chaque itinéraire utilise une liste ordonnée d’entrées Location et des RouteOptions facultatives. Vous pouvez également définir un objet global RoutesOptions qui applique des valeurs par défaut à l’ensemble de la requête.

Conseil : Si vous n’avez besoin que d’un seul itinéraire, utilisez l’ API Route . Si vous devez calculer plusieurs itinéraires à la fois, utilisez Routes.

Endpoints et URL de base#

REST (JSON)

Élément	Valeur
URL de base	https://trackservice.trackroad.com
Endpoint	`POST /rest/routes`
URL complète	https://trackservice.trackroad.com/rest/routes
Content-Type	`application/json`

SOAP (CalculateRoutes)

Élément	Valeur
URL SOAP	https://trackservice.trackroad.com/TrackService.asmx
WSDL	https://trackservice.trackroad.com/TrackService.asmx?WSDL
Méthode	`CalculateRoutes`
SOAPAction	http://TrackService.TrackRoad.com/CalculateRoutes
Content-Type	`text/xml; charset=utf-8`

SOAP et REST partagent les mêmes concepts de routage fondamentaux, comme RouteSpecification, RouteOptions et Location. La principale différence concerne le transport : JSON pour REST et enveloppe SOAP + SessionIDHeader pour SOAP.

Authentification (REST et SOAP)#

Authentification REST (X-API-Key)

Incluez votre TrackServiceKey dans l’en-tête X-API-Key pour chaque requête REST. Voir Authentification API .

Authentification SOAP (SessionIDHeader)

Les requêtes SOAP utilisent SessionIDHeader. Envoyez votre TrackServiceKey comme SessionID à chaque appel CalculateRoutes.

Recommandation : utilisez REST sauf si vous devez vous intégrer à un système d’entreprise existant ou uniquement SOAP.

Schéma de requête#

Le corps de la requête REST est un objet unique de type lot : RoutesSpecification, qui contient une liste d’éléments RouteSpecification. SOAP utilise la même structure logique dans l’opération CalculateRoutes.

Modèles partagés

Location, LatLong et Address sont partagés entre plusieurs endpoints. Voir API Dispatch (modèles partagés) .

RoutesSpecification (REST)

Propriété	Type	Obligatoire	Description
`Specifications`	RouteSpecification[]	Oui*	Un élément par itinéraire que vous souhaitez calculer dans la requête par lot.
`RoutesOptions`	RouteOptions	Non	Valeurs par défaut globales appliquées à chaque itinéraire, sauf remplacement par des RouteOptions propres à l’itinéraire.

RouteSpecification

Propriété	Type	Obligatoire	Description
`Locations`	Location[]	Oui*	Arrêts de cet itinéraire. L’ordre peut être optimisé selon les RouteOptions.
`RouteOptions`	RouteOptions	Non	Surcharges par itinéraire pour le moteur de routage, les unités, le mode d’optimisation, la culture et les options cartographiques.

RouteOptions (résumé)

Les champs RouteOptions tels que RoutingService, DistanceUnit, RouteOptimize, Culture et les paramètres liés à la carte sont similaires à ceux du endpoint Route et peuvent être appliqués globalement ou par itinéraire.

Schéma de réponse#

Réponse REST (RoutesResult)

Propriété	Type	Description
`Results`	RouteResult[]	Un résultat par RouteSpecification fournie en entrée.
`Map`	string	Sortie cartographique facultative selon les options. Peut être vide.
`Errors`	Error[]	Avertissements et erreurs facultatifs renvoyés par le service.
`Status`	int (enum)	0=None, 1=Success, 2=Failed, 3=SuccessWithErrors.

Réponse SOAP (CalculateRoutesResult)

SOAP encapsule la même structure logique de résultat dans CalculateRoutesResponse et CalculateRoutesResult.

Exemples#

Utilisez les exemples ci-dessous pour comprendre comment fonctionne TrackRoad Routes avec REST JSON et SOAP CalculateRoutes. Les blocs de code d’exemple doivent rester inchangés d’une langue à l’autre.

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
}

Erreurs courantes#

REST 401 / Unauthorized : X-API-Key manquant ou invalide.
REST 403 / Forbidden : la clé est valide mais bloquée, expirée ou sans crédit disponible.
Échec d’authentification SOAP : SessionIDHeader manquant ou invalide. SessionID doit être votre TrackServiceKey.
Erreurs de validation : Locations manquantes, coordonnées invalides ou valeurs enum non valides.

Bonnes pratiques#

Groupez intelligemment : placez plusieurs calculs d’itinéraires dans un seul appel Routes pour réduire la surcharge des requêtes.
Privilégiez LatLong : fournissez des coordonnées lorsque c’est possible pour réduire l’ambiguïté du géocodage et améliorer les performances.
Utilisez des RoutesOptions globales : définissez les valeurs partagées une seule fois et ne les remplacez que lorsque nécessaire pour chaque itinéraire.
Gardez des options cohérentes : mélanger moteurs de routage, unités ou modes d’optimisation entre plusieurs itinéraires peut compliquer les comparaisons.

FAQ#

Que fait l’API Routes ?

L’API Routes calcule un ou plusieurs itinéraires dans une seule requête. Chaque résultat peut inclure des emplacements ordonnés, une distance, un temps et une sortie cartographique facultative selon les options.

Comment m’authentifier sur Routes (REST et SOAP) ?

Les requêtes REST envoient le TrackServiceKey dans l’en-tête X-API-Key. Les requêtes SOAP CalculateRoutes envoient le TrackServiceKey dans SessionIDHeader en tant que SessionID.

Quand faut-il utiliser Routes plutôt que Route ?

Utilisez Route lorsque vous devez calculer un seul itinéraire. Utilisez Routes lorsque vous souhaitez calculer plusieurs itinéraires dans une seule requête par lot.

Quelles sont les erreurs les plus courantes de l’API Routes ?

Les erreurs courantes incluent un X-API-Key manquant ou invalide, des échecs d’authentification SOAP avec SessionIDHeader, des Locations manquantes, des coordonnées invalides et des valeurs enum non valides.

Étape suivante : optimiser entre plusieurs véhicules

Si vous devez attribuer des arrêts à plusieurs véhicules et optimiser l’ordre des arrêts par véhicule, poursuivez avec l’API Dispatch.

Aller à Dispatch Swagger UI