API Route (Rota única)

Utilize Route para gerar uma rota única com distância e tempo de viagem totais, passos detalhados do itinerário e pontos da rota. Para otimização multi-veículo, utilize Dispatch .

Exemplo de planeamento de rota única mostrando distância, ETA e geometria da rota devolvidos pela API Route.

Precisa do contrato completo?

O Swagger inclui o esquema completo, os modelos e os detalhes dos endpoints para Route e APIs relacionadas.

Ver Swagger UI Visão geral da referência da API

O que o Route faz#

O Route calcula uma rota única através de uma lista de localizações. Devolve a distância total e o tempo de viagem, troços da rota com instruções do itinerário, pontos da rota e saída de mapa opcional, dependendo das opções selecionadas.

LatLong é preferível. Se omitir coordenadas para uma localização, tem de fornecer um Endereço . Modelos partilhados como Location, LatLong e Address estão documentados na API Dispatch .

Endpoints e URL base (REST + SOAP)#

REST

Item	Valor
URL base	https://trackservice.trackroad.com
Endpoint	`POST /rest/Route`
URL completa	https://trackservice.trackroad.com/rest/Route
Content-Type	`application/json`
Autenticação	`X-API-Key: YOUR_TRACKSERVICEKEY`

SOAP

Item	Valor
WSDL	`https://trackservice.trackroad.com/TrackService.asmx?wsdl`
Endpoint SOAP	https://trackservice.trackroad.com/TrackService.asmx
Operação	`CalculateRoute`
SOAPAction	`http://TrackService.TrackRoad.com/CalculateRoute`
Namespace	`http://TrackService.TrackRoad.com/`
Content-Type	`text/xml; charset=utf-8`
Cabeçalho de autenticação	`SessionIDHeader com SessionID`

Autenticação#

Autenticação REST (X-API-Key)

Inclua a sua TrackServiceKey no cabeçalho X-API-Key em todos os pedidos REST. Gere-a em Autenticação da API .

Autenticação SOAP (SessionIDHeader)

As chamadas SOAP utilizam um SessionIDHeader. Fluxo típico:

Chame Login (SOAP) com o seu nome de utilizador e palavra-passe.
Leia o SessionIDHeader devolvido que contém o SessionID.
Envie esse SessionID no cabeçalho SOAP para pedidos CalculateRoute.

A autenticação REST e SOAP é separada. REST utiliza X-API-Key. SOAP utiliza SessionIDHeader.

Esquema do pedido#

O corpo do pedido REST é RouteSpecification. . O SOAP utiliza a mesma estrutura lógica em XML. Os modelos partilhados estão documentados em API Dispatch .

RouteSpecification

Propriedade	Tipo	Obrigatório	Descrição
`Locations`	Location[]	Sim*	Lista de paragens da rota. Forneça pelo menos 2 localizações.
`RouteOptions`	RouteOptions	Não	Motor de roteamento, unidades, preferência de rota e definições opcionais do mapa.

RouteOptions

Propriedade	Tipo	Obrigatório	Descrição
`RoutingService`	int (enum)	Não	0=NetRoad, 1=TrackRoad, 2=Bing.
`DistanceUnit`	int (enum)	Não	0=Mile, 1=Kilometer.
`RouteOptimize`	int (enum)	Não	0=MinimizeTime, 1=MinimizeDistance.
`Culture`	string	Não	Por exemplo, en-US.
`MapSize`	MapSize	Não	Tamanho de saída opcional com Width e Height.
`RouteColor`	RouteColor	Não	Cor opcional da rota no mapa.
`MapCenter`	LatLong	Não	Coordenadas opcionais do centro do mapa.
`HideStops`	bool	Não	Se true, os marcadores das paragens ficam ocultos na saída do mapa, quando disponível.
`ZoomLevel`	int	Não	0=auto; caso contrário, um nível de zoom fixo.

Tipos partilhados

Para evitar duplicação, modelos partilhados como Location, LatLong e Address são descritos em API Dispatch .

Esquema da resposta#

Uma resposta bem-sucedida devolve RouteResult com Route contendo distância, tempo de viagem, troços da rota, passos do itinerário, pontos da rota e saída de mapa opcional.

RouteResult

Propriedade	Tipo	Descrição
`Route`	Route	Saída da rota incluindo distância, tempo de viagem, troços, pontos e mapa opcional.
`Errors`	Error[]	Erros ou avisos opcionais.
`Status`	int (enum)	0=None, 1=Success, 2=Failed, 3=SuccessWithErrors.

Route

Propriedade	Tipo	Descrição
`Distance`	double	Distância total. A unidade depende de DistanceUnit.
`Time`	int	Tempo total de viagem em segundos.
`RouteLegs`	RouteLeg[]	Troços da rota contendo passos do itinerário.
`Points`	LatLong[]	Pontos da polilinha. Esta coleção pode ser grande.
`Map`	string	Carga útil do mapa opcional, dependendo do comportamento do servidor e das opções.

Exemplos#

Os exemplos de corpos de pedido, respostas de exemplo, cabeçalhos e amostras de código específicas por linguagem devem ser inseridos abaixo.

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
}

Erros comuns#

401 / Unauthorized (REST): X-API-Key em falta ou inválida.
Falha de autenticação SOAP: SessionIDHeader em falta ou inválido, ou um ID de sessão expirado.
Erros de validação: Uma localização pode não ter LatLong nem Address, as coordenadas podem ser inválidas ou podem ter sido fornecidas poucas localizações.
Localizações não roteáveis: Alguns pontos podem não ser roteáveis dependendo do fornecedor de roteamento ou da qualidade dos dados.

Boas práticas#

Prefira LatLong para todas as localizações para reduzir o custo de geocodificação e a ambiguidade.
Escolha cuidadosamente o modo de otimização: MinimizeTime para a rota mais rápida, MinimizeDistance para a rota mais curta.
Os pontos da polilinha podem ser muitos, por isso solicite-os e armazene-os apenas quando a geometria for necessária.
Utilize Dispatch para otimização de rotas com múltiplos veículos ou muitas paragens.

FAQ#

O que devolve a API Route?

O Route devolve a distância total e o tempo de viagem, troços da rota com passos do itinerário, pontos da rota e saída de mapa opcional, dependendo das suas opções.

Como faço a autenticação?

REST utiliza X-API-Key. SOAP utiliza SessionIDHeader com um SessionID obtido pela chamada SOAP Login.

Preciso de LatLong ou Address para as localizações?

LatLong é preferível. Se LatLong for omitido para uma localização, Address é obrigatório para que o serviço possa geocodificar a paragem.

Quando devo usar Route em vez de Dispatch?

Utilize Route quando precisar de uma rota única com direções e detalhes de viagem. Utilize Dispatch quando precisar de otimização de rotas com múltiplos veículos ou muitas paragens.

Crie rotas em minutos

Gere a sua chave de API para REST ou utilize o SOAP Login para obter um SessionID, e comece a calcular rotas com a TrackRoad.

Obter chave de API Ver Swagger UI