Condividi tramite


Route - Post Route Directions

Usare per ottenere il percorso migliore tra un'origine e una destinazione per automobili, camion commerciali e percorsi a piedi.

L'API Route Directions è una richiesta HTTP POST che restituisce il percorso ideale tra un'origine e una destinazione per automobili (guida), camion commerciali e percorsi a piedi. Se specificato, la route passa attraverso una serie di punti di percorso. Un punto di navigazione è una posizione geografica definita da longitudine e latitudine utilizzata a scopo di navigazione. Il percorso considera fattori quali il traffico corrente e le velocità tipiche della strada nel giorno richiesto della settimana e dell'ora del giorno.

L'API restituisce la distanza, il tempo di viaggio stimato e una rappresentazione della geometria del percorso. Sono disponibili anche altre informazioni di routing, ad esempio un ordine di punto di spostamento ottimizzato o un turno per turno, a seconda dei parametri usati.

Le indicazioni stradali considerano leggi locali, dimensioni del veicolo, tipo di carico, velocità massima, ponte e altezza del tunnel per calcolare i percorsi specifici del camion ed evitare manovre complesse e strade difficili. Non tutti i camion possono percorrere le stesse rotte di altri veicoli a causa di determinate restrizioni in base al profilo del veicolo o al tipo di carico. Ad esempio, le autostrade spesso hanno limiti di velocità separati per i camion, alcune strade non consentono autocarri con materiali flammabili o pericolosi e possono esserci limitazioni di altezza e peso sui ponti.

Fino a 25 punti di marcia e 10 punti di via tra due punti di marcia è supportato per la guida e i percorsi a piedi. Ogni set di punti di percorso crea una gamba separata. I punti viaway definiscono il percorso e possono essere usati per la creazione di itinerari attraverso posizioni specifiche, ma non creano le gambe del percorso. Le route dei camion supportano fino a 150 punti di tragitto, ma non supportano viaWaypoint.

Per informazioni sulla disponibilità del routing in paesi/aree geografiche, vedere copertura di routing di Mappe di Azure.

POST https://atlas.microsoft.com/route/directions?api-version=2025-01-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
api-version
query True

string

Numero di versione dell'API mappe di Azure.

Intestazione della richiesta

Media Types: "application/geo+json"

Nome Necessario Tipo Descrizione
x-ms-client-id

string

Specifica quale account è destinato all'utilizzo in combinazione con il modello di sicurezza Microsoft Entra ID. Rappresenta un ID univoco per l'account mappe di Azure e può essere recuperato dall'API dell'account del piano di gestione di Mappe di Azure. To use Microsoft Entra ID security in Azure Maps see the following articles for guidance.

Accept-Language

string

Lingua in cui devono essere restituiti i risultati del routing.

Per altre informazioni, vedere supporto per la localizzazione in Mappe di Azure.

Corpo della richiesta

Media Types: "application/geo+json"

Nome Necessario Tipo Descrizione
features True

InputWaypointFeaturesItem[]

I percorsi di guida e a piedi sono definiti da un set di punti di marcia (fermate) e viaWaypoint (posizioni intermedie che il percorso deve attraversare). È possibile avere un massimo di 25 punti di direzione e un massimo di 10 punti di viaWay tra ogni set di punti di percorso. Il percorso del camion supporta fino a 150 punti di tragitto e viaWaypoint non è supportato.

Un itinerario deve avere almeno 2 punti di partenza e i punti di partenza e di arrivo del percorso non possono essere viaWaypoint.

Sia i percorsi waypoint che i percorsi viaWaypoint devono essere specificati come un oggetto funzione punto GeoJSON valido insieme a pointIndex che specifica l'ordine delle posizioni. For more information on the GeoJSON format, see RFC 7946.

type True

FeatureTypeEnum

Specifica il tipo di GeoJSON. L'unico tipo di oggetto supportato è FeatureCollection. For more information, see RFC 7946.

arriveAt

string (date-time)

Data e ora di arrivo nel punto di destinazione formattato come valore dateTime definito da RFC 3339, sezione 5.6. Quando non viene specificata una differenza di fuso orario, si presuppone l'ora UTC.

Il parametro arriveAt non può essere utilizzato insieme a departAt.

Esempio: "arriveAt": "2023-06-01T09:30:00.000-07:00"

avoid

AvoidEnum[]

Specifica le restrizioni che il calcolo della route deve rispettare quando si determina la route. Evitare supporta più valori in una richiesta ed è supportato solo per la guida e il camion travelMode.

Esempio: "avoid": ["limitedAccessHighways", "tollRoads"]

departAt

string (date-time)

Data e ora di partenza dal punto di origine formattato come valore dateTime definito da RFC 3339, sezione 5.6. Quando non viene specificata una differenza di fuso orario, si presuppone l'ora UTC.

Se il departAt non è impostato, il valore predefinito è l'ora corrente.

Example:

"departAt": "2023-06-01T09:30:00.000-07:00"

heading

integer (int64)

minimum: 0
maximum: 359

Direzione iniziale del veicolo in gradi a partire da nord reale e continua in senso orario. Nord è di 0 gradi, est è di 90 gradi, sud è di 180 gradi, ovest è di 270 gradi.

maxRouteCount

integer (int64)

minimum: 1
maximum: 6

Numero massimo di route da restituire. Disponibile per le modalità di guida e di viaggio del camion.

Default: "maxRouteCount":1

optimizeRoute

RouteDirectionOptimizeRouteEnum

Specifica il parametro da usare per ottimizzare la route. Se non definito, il valore predefinito è "fastestWithoutTraffic" che restituisce il percorso per ridurre al minimo il tempo di viaggio senza usare le informazioni sul traffico correnti.

Example: "optimizeRoute":"shortest"

optimizeWaypointOrder

boolean

Riordinare i punti di percorso usando un algoritmo euristico rapido per ridurre il costo di route specificato con il parametro Optimize. L'origine e la destinazione vengono escluse dal punto di partenza ottimizzato e la relativa posizione viene considerata fissa. I valori accettabili sono true o false.

routeOutputOptions

RouteOutputOptionEnum[]

Includere le informazioni di route desiderate dalla risposta. Per impostazione predefinita, l'itinerario è incluso nella risposta.

Supporta più valori come "routeOutputOptions": ["routePath", "itinerary"]

travelMode

TravelModeEnum

Modalità di viaggio per il percorso richiesto. Se non definito, il valore predefinito è "guida" che restituisce il percorso ottimizzato per le auto.

Note: per il trasporto di camionMode, il percorso del camion richiesto potrebbe non essere disponibile per l'intero percorso. Se il percorso del camion non è disponibile per una sezione specifica, l'elemento travelMode della risposta per tale sezione sarà "altro".

Example: "travelMode":"driving"

vehicleSpec

RouteDirectionVehicleSpec

Specifica gli attributi del veicolo, ad esempio dimensioni, peso, velocità massima, tipo di carico e così via solo per il percorso dei camion. Ciò consente di evitare spazi di ponte bassi, restrizioni stradali, turni di destra difficili per fornire il percorso ottimizzato dei camion in base alle specifiche del veicolo.

Note: supportato solo per truck travelMode

Risposte

Nome Tipo Descrizione
200 OK

RouteDirectionsResponse

OK

Media Types: "application/geo+json", "application/json"

Other Status Codes

MapsErrorResponse

Errore imprevisto.

Media Types: "application/geo+json", "application/json"

Intestazioni

x-ms-error-code: string

Sicurezza

AADToken

Questi sono i flussi di Microsoft Entra OAuth 2.0. Se abbinato a l'accesso in base al ruolo di Azure controllarlo, può essere usato per controllare l'accesso alle API REST di Mappe di Azure. I controlli di accesso in base al ruolo di Azure vengono usati per designare l'accesso a uno o più account di risorse di Mappe di Azure o a risorse secondarie. A qualsiasi utente, gruppo o entità servizio può essere concesso l'accesso tramite un ruolo predefinito o un ruolo personalizzato composto da una o più autorizzazioni per le API REST di Mappe di Azure.

To implement scenarios, we recommend viewing authentication concepts. In sintesi, questa definizione di sicurezza offre una soluzione per la modellazione di applicazioni tramite oggetti in grado di controllare l'accesso su API e ambiti specifici.

Note

  • This security definition requires the use of the x-ms-client-id header to indicate which Azure Maps resource the application is requesting access to. Questa operazione può essere acquisita dall'API di gestione di mappe .
  • Il Authorization URL è specifico dell'istanza del cloud pubblico di Azure. I cloud sovrani hanno URL di autorizzazione univoci e configurazioni microsoft Entra ID.
  • Il controllo degli accessi in base al ruolo di Azure viene configurato dal piano di gestione di Azure tramite il portale di Azure, PowerShell, l'interfaccia della riga di comando, gli SDK di Azure o le API REST.
  • L'utilizzo della Sdk Web di Mappe di Azure consente la configurazione basata sulla configurazione di un'applicazione per più casi d'uso.
  • Per altre informazioni su Microsoft Identity Platform, vedere panoramica di Microsoft Identity Platform.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

Si tratta di una chiave condivisa di cui viene effettuato il provisioning durante la creazione di un risorsa di Mappe di Azure tramite il piano di gestione di Azure tramite il portale di Azure, PowerShell, l'interfaccia della riga di comando, gli SDK di Azure o le API REST.

Con questa chiave, qualsiasi applicazione è autorizzata ad accedere a tutte le API REST. In altre parole, questi possono essere attualmente considerati chiavi master per l'account per cui vengono rilasciati.

Per le applicazioni esposte pubblicamente, è consigliabile usare l'accesso da server a server delle API REST di Mappe di Azure in cui questa chiave può essere archiviata in modo sicuro.

Tipo: apiKey
In: header

SAS Token

Si tratta di un token di firma di accesso condiviso creato dall'operazione List SAS nell'risorsa di Mappe di Azure tramite il piano di gestione di Azure tramite il portale di Azure, PowerShell, l'interfaccia della riga di comando, gli SDK di Azure o le API REST.

Con questo token, qualsiasi applicazione è autorizzata ad accedere ai controlli di accesso in base al ruolo di Azure e al controllo granulare per la scadenza, la frequenza e le aree d'uso per il token specifico. In altre parole, il token di firma di accesso condiviso può essere usato per consentire alle applicazioni di controllare l'accesso in modo più protetto rispetto alla chiave condivisa.

Per le applicazioni esposte pubblicamente, è consigliabile configurare un elenco specifico di origini consentite nella risorsa account mappa per limitare l'abuso di rendering e rinnovare regolarmente il token di firma di accesso condiviso.

Tipo: apiKey
In: header

Esempio

Successfully retrieve a route between an origin and a destination with additional parameters in the body

Esempio di richiesta

POST https://atlas.microsoft.com/route/directions?api-version=2025-01-01

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "coordinates": [
          -122.201399,
          47.608678
        ],
        "type": "Point"
      },
      "properties": {
        "pointIndex": 0,
        "pointType": "waypoint"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "coordinates": [
          -122.20687,
          47.612002
        ],
        "type": "Point"
      },
      "properties": {
        "pointIndex": 1,
        "pointType": "viaWaypoint"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "coordinates": [
          -122.201669,
          47.615076
        ],
        "type": "Point"
      },
      "properties": {
        "pointIndex": 2,
        "pointType": "waypoint"
      }
    }
  ],
  "optimizeRoute": "fastestWithTraffic",
  "routeOutputOptions": [
    "routePath"
  ],
  "maxRouteCount": 3,
  "travelMode": "driving"
}

Risposta di esempio

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.20147,
          47.60868
        ]
      },
      "properties": {
        "routePathPoint": {
          "legIndex": 0,
          "pointIndex": 0
        },
        "order": {
          "inputIndex": 0
        },
        "type": "Waypoint"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.2016,
          47.61508
        ]
      },
      "properties": {
        "routePathPoint": {
          "legIndex": 0,
          "pointIndex": 64
        },
        "order": {
          "inputIndex": 2
        },
        "type": "Waypoint"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "MultiLineString",
        "coordinates": [
          [
            [
              -122.20147,
              47.60868
            ],
            [
              -122.20148,
              47.60884
            ],
            [
              -122.20148,
              47.60906
            ],
            [
              -122.20148,
              47.60919
            ],
            [
              -122.20148,
              47.60953
            ],
            [
              -122.20148,
              47.60967
            ],
            [
              -122.20149,
              47.60997
            ],
            [
              -122.2015,
              47.61011
            ],
            [
              -122.2015,
              47.61019
            ],
            [
              -122.20192,
              47.61021
            ],
            [
              -122.20199,
              47.61021
            ],
            [
              -122.20252,
              47.61019
            ],
            [
              -122.20264,
              47.61018
            ],
            [
              -122.20271,
              47.61015
            ],
            [
              -122.20276,
              47.61015
            ],
            [
              -122.20281,
              47.61015
            ],
            [
              -122.20286,
              47.61015
            ],
            [
              -122.20329,
              47.61016
            ],
            [
              -122.20346,
              47.61016
            ],
            [
              -122.20414,
              47.61017
            ],
            [
              -122.20416,
              47.61057
            ],
            [
              -122.20418,
              47.61083
            ],
            [
              -122.20418,
              47.61092
            ],
            [
              -122.20419,
              47.61103
            ],
            [
              -122.20419,
              47.61121
            ],
            [
              -122.2042,
              47.61126
            ],
            [
              -122.20478,
              47.61127
            ],
            [
              -122.20555,
              47.61128
            ],
            [
              -122.20569,
              47.61128
            ],
            [
              -122.20596,
              47.61128
            ],
            [
              -122.20617,
              47.61127
            ],
            [
              -122.20624,
              47.61125
            ],
            [
              -122.2066,
              47.61126
            ],
            [
              -122.20669,
              47.61127
            ],
            [
              -122.20686,
              47.61129
            ],
            [
              -122.20687,
              47.61158
            ],
            [
              -122.20689,
              47.61187
            ],
            [
              -122.20691,
              47.61233
            ],
            [
              -122.20691,
              47.61247
            ],
            [
              -122.20694,
              47.61317
            ],
            [
              -122.20695,
              47.61342
            ],
            [
              -122.20696,
              47.61362
            ],
            [
              -122.20697,
              47.61384
            ],
            [
              -122.20683,
              47.61384
            ],
            [
              -122.20638,
              47.61384
            ],
            [
              -122.20612,
              47.61384
            ],
            [
              -122.20568,
              47.61383
            ],
            [
              -122.20559,
              47.6138
            ],
            [
              -122.20467,
              47.61379
            ],
            [
              -122.20443,
              47.61379
            ],
            [
              -122.20405,
              47.61379
            ],
            [
              -122.20325,
              47.6138
            ],
            [
              -122.203,
              47.6138
            ],
            [
              -122.20274,
              47.6138
            ],
            [
              -122.20241,
              47.61381
            ],
            [
              -122.20222,
              47.6138
            ],
            [
              -122.20202,
              47.6138
            ],
            [
              -122.20193,
              47.6138
            ],
            [
              -122.20181,
              47.61386
            ],
            [
              -122.20167,
              47.61386
            ],
            [
              -122.20155,
              47.61386
            ],
            [
              -122.20158,
              47.61464
            ],
            [
              -122.20159,
              47.61475
            ],
            [
              -122.2016,
              47.61503
            ],
            [
              -122.2016,
              47.61508
            ]
          ]
        ]
      },
      "properties": {
        "distanceInMeters": 1520,
        "durationInSeconds": 307,
        "departureAt": "2025-06-17T09:08:10+00:00",
        "arrivalAt": "2025-06-17T09:13:10+00:00",
        "durationTrafficInSeconds": 300,
        "trafficCongestion": "Medium",
        "type": "RoutePath",
        "legs": [
          {
            "distanceInMeters": 1520,
            "durationInSeconds": 307,
            "durationTrafficInSeconds": 300,
            "departureAt": "2025-06-17T09:08:10+00:00",
            "arrivalAt": "2025-06-17T09:13:10+00:00",
            "routePathRange": {
              "legIndex": 0,
              "range": [
                0,
                64
              ]
            }
          }
        ]
      },
      "bbox": [
        -122.20697,
        47.60868,
        -122.20147,
        47.61508
      ]
    }
  ],
  "alternativeRoutes": [
    {
      "type": "FeatureCollection",
      "features": [
        {
          "type": "Feature",
          "geometry": {
            "type": "Point",
            "coordinates": [
              -122.20147,
              47.60868
            ]
          },
          "properties": {
            "routePathPoint": {
              "legIndex": 0,
              "pointIndex": 0
            },
            "order": {
              "inputIndex": 0
            },
            "type": "Waypoint"
          }
        },
        {
          "type": "Feature",
          "geometry": {
            "type": "Point",
            "coordinates": [
              -122.2016,
              47.61508
            ]
          },
          "properties": {
            "routePathPoint": {
              "legIndex": 0,
              "pointIndex": 29
            },
            "order": {
              "inputIndex": 1
            },
            "type": "Waypoint"
          }
        },
        {
          "type": "Feature",
          "geometry": {
            "type": "MultiLineString",
            "coordinates": [
              [
                [
                  -122.20147,
                  47.60868
                ],
                [
                  -122.20148,
                  47.60884
                ],
                [
                  -122.20148,
                  47.60906
                ],
                [
                  -122.20148,
                  47.60919
                ],
                [
                  -122.20148,
                  47.60953
                ],
                [
                  -122.20148,
                  47.60967
                ],
                [
                  -122.20149,
                  47.60997
                ],
                [
                  -122.2015,
                  47.61011
                ],
                [
                  -122.2015,
                  47.61019
                ],
                [
                  -122.20151,
                  47.61072
                ],
                [
                  -122.20152,
                  47.61092
                ],
                [
                  -122.20152,
                  47.61097
                ],
                [
                  -122.20149,
                  47.611
                ],
                [
                  -122.20147,
                  47.61104
                ],
                [
                  -122.20145,
                  47.61117
                ],
                [
                  -122.20145,
                  47.61122
                ],
                [
                  -122.20145,
                  47.61126
                ],
                [
                  -122.20146,
                  47.61149
                ],
                [
                  -122.20147,
                  47.61166
                ],
                [
                  -122.20148,
                  47.61197
                ],
                [
                  -122.20148,
                  47.61203
                ],
                [
                  -122.2015,
                  47.61268
                ],
                [
                  -122.20151,
                  47.61289
                ],
                [
                  -122.20152,
                  47.61297
                ],
                [
                  -122.20153,
                  47.61338
                ],
                [
                  -122.20155,
                  47.61386
                ],
                [
                  -122.20158,
                  47.61464
                ],
                [
                  -122.20159,
                  47.61475
                ],
                [
                  -122.2016,
                  47.61503
                ],
                [
                  -122.2016,
                  47.61508
                ]
              ]
            ]
          },
          "properties": {
            "distanceInMeters": 713,
            "durationInSeconds": 92,
            "departureAt": "2025-06-17T09:08:10+00:00",
            "arrivalAt": "2025-06-17T09:09:40+00:00",
            "durationTrafficInSeconds": 90,
            "trafficCongestion": "Medium",
            "type": "RoutePath",
            "legs": [
              {
                "distanceInMeters": 713,
                "durationInSeconds": 92,
                "durationTrafficInSeconds": 90,
                "departureAt": "2025-06-17T09:08:10+00:00",
                "arrivalAt": "2025-06-17T09:09:40+00:00",
                "routePathRange": {
                  "legIndex": 0,
                  "range": [
                    0,
                    29
                  ]
                }
              }
            ]
          },
          "bbox": [
            -122.2016,
            47.60868,
            -122.20145,
            47.61508
          ]
        }
      ]
    }
  ]
}

Definizioni

Nome Descrizione
Address

Il distretto amministrativo e la regione del paese per i waypoint e i punti di manovra sul percorso.

AdminDistrict

Nome della suddivisione nel paese o nell'area geografica per un indirizzo. Questo elemento viene in genere considerato come suddivisione amministrativa del primo ordine, ma in alcuni casi contiene anche la seconda, terza o quarta suddivisione dell'ordine in un paese, una dipendenza o un'area geografica.

AdrTunnelRestrictionCodeEnum

Codice di restrizione del tunnel ADR. L'ADR è un accordo europeo relativo al trasporto internazionale di merci pericolose per strada. Il codice di restrizione del tunnel ADR viene utilizzato per determinare se un veicolo può attraversare un tunnel con restrizioni sul trasporto di merci pericolose.

AvoidEnum

Specifica le restrizioni che il calcolo della route deve rispettare quando si determina la route. Evitare supporta più valori in una richiesta ed è supportato solo per la guida e il camion travelMode.

Esempio: "avoid": ["limitedAccessHighways", "tollRoads"]

CountryRegion

Rappresenta un paese o un'area geografica contenente i dettagli correlati.

DirectionsRequest

Questo oggetto è il corpo della richiesta.

DrivingSideEnum

Indica la guida a sinistra o a destra al punto della manovra.

FeatureCollection

GeoJSON FeatureCollection oggetto che contiene un elenco di funzionalità. Per altre informazioni, vedere RFC 7946, sezione 3.3.

FeaturesItem

Oggetto funzionalità GeoJSON che contiene l'oggetto Geometry e proprietà aggiuntive della route.

FeaturesItemTypeEnum

Specifica il tipo di GeoJSON. L'unico tipo di oggetto supportato è Feature. For more information, see RFC 7946.

FeatureTypeEnum

Specifica il tipo di GeoJSON. L'unico tipo di oggetto supportato è FeatureCollection. For more information, see RFC 7946.

GeoJsonPoint

Tipo geometry GeoJSON Point valido. Please refer to RFC 7946 for details.

InputWaypointFeaturesItem

Specifica il punto di ingresso e viaWaypoint GeoJSON oggetto funzionalità e proprietà aggiuntive. For more information, see RFC 7946.

InputWaypointProperties

Specifica le proprietà di un punto di partenza che è una posizione o un punto specifico lungo un percorso o un viaggio che funge da riferimento o punto di arresto.

InputWaypointTypeEnum

Tipo di punto di tragitto sulla route. Può trattarsi di una fermata o di una posizione intermedia che il percorso deve attraversare.

Instruction

Descrizione di una manovra in un set di direzioni.

Leg

Informazioni su una sezione di una route tra due punti di direzione. Altre informazioni sui campi contenuti in una gamba di itinerario:

ManeuverPointProperties

Specifica le istruzioni di guida e le proprietà aggiuntive per ogni punto di manovra nel percorso Gamba.

ManeuverTypeEnum

Il tipo di manovra descritto in questa raccolta dettagliata. Il ManeuverType fornisce informazioni per una parte della manovra specificata dall'istruzione corrispondente. Ad esempio, il tipo di manovra di un'istruzione può specificare TurnLeftThenTurnRight, mentre gli elementi di dettaglio associati possono fornire specifiche sulle manovre TurnLeft e TurnRight

MapsErrorDetail

Dettagli dell'errore.

MapsErrorResponse

Risposta di errore comune per le API di Mappe di Azure per restituire i dettagli dell'errore per le operazioni non riuscite.

MapsInnerError

Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.

MultiLineStringGeometry

Specifica l'GeoJSON oggetto Geometry MultiLineString. For more information, see RFC 7946.

OptimizedWaypoint

Oggetto punto di ottimizzazione.

Order

Sequenza per la visita dei waypoint.

PointGeometry

Punto di origine passato come oggetto Geometry valido GeoJSON da cui calcolare il poligono dell'intervallo. Please refer to RFC 7946 for details.

Note: l'API blocca il punto di origine richiesto alla rete stradale più vicina e lo userà per il calcolo dell'intervallo. Verrà restituito come punto center nella risposta.

RouteDirectionOptimizeRouteEnum

Specifica il parametro da usare per ottimizzare la route. Se non definito, il valore predefinito è "fastestWithoutTraffic" che restituisce il percorso per ridurre al minimo il tempo di viaggio senza usare le informazioni sul traffico correnti.

Example: "optimizeRoute":"shortest"

RouteDirectionsResponse

Questo oggetto viene restituito da una chiamata riuscita.

RouteDirectionVehicleSpec

Specifica gli attributi del veicolo, ad esempio dimensioni, peso, velocità massima, tipo di carico e così via solo per il percorso dei camion. Ciò consente di evitare spazi di ponte bassi, restrizioni stradali, turni di destra difficili per fornire il percorso ottimizzato dei camion in base alle specifiche del veicolo.

ISNote: supportato solo per truck travelMode.

RouteOutputOptionEnum

Includere le informazioni di route desiderate dalla risposta. Per impostazione predefinita, l'itinerario è incluso nella risposta.

Supporta più valori come "routeOutputOptions": ["routePath", "itinerary"]

RoutePathPoint

Fa riferimento all'indice di un punto all'interno di una gamba specifica di un percorso.

RoutePathProperties

Specifica le proprietà che descrivono il percorso della route nella risposta.

RoutePathRange

Fa riferimento all'intervallo coperto da una gamba specifica di un percorso o di un percorso.

RoutePathTravelModeEnum

Modalità di viaggio per il percorso della risposta.

SideOfStreetEnum

Il lato della strada in cui si trova la destinazione in base alla direzione di arrivo. Questo campo si applica solo all'ultimo punto di manovra.

Step

Una gamba del percorso contiene istruzioni turn-by-turn. Un passo si riferisce a una gamma di un percorso tra due punti di manovra consecutivi.

TrafficCongestionEnum

Livello di congestione del traffico lungo il percorso. Note: supportato solo per la guida di travelMode

TravelModeEnum

Modalità di viaggio per il percorso richiesto. Se non definito, il valore predefinito è "guida" che restituisce il percorso ottimizzato per le auto.

Note: per il trasporto di camionMode, il percorso del camion richiesto potrebbe non essere disponibile per l'intero percorso. Se il percorso del camion non è disponibile per una sezione specifica, l'elemento travelMode della risposta per tale sezione sarà "altro".

Example: "travelMode":"driving"

VehicleLoadTypeEnum

Tipi di carico che possono essere classificati come materiali pericolosi e limitati da alcune strade. I valori di vehicleLoadType disponibili sono classi Us Hazmat da 1 a 9, oltre a classificazioni generiche da usare in altri paesi. I valori che iniziano con USHazmat sono per l'instradamento degli Stati Uniti, mentre altrihazmat devono essere usati per tutti gli altri paesi. vehicleLoadType supporta più valori in una richiesta.

WaypointProperties

Specifica le proprietà di un punto di partenza che è una posizione o un punto specifico lungo un percorso o un viaggio che funge da riferimento o punto di arresto.

Address

Il distretto amministrativo e la regione del paese per i waypoint e i punti di manovra sul percorso.

Nome Tipo Descrizione
adminDistricts

AdminDistrict[]

Nome della suddivisione nel paese o nell'area geografica per un indirizzo. Questo elemento viene in genere considerato come suddivisione amministrativa del primo ordine, ma in alcuni casi contiene anche la seconda, terza o quarta suddivisione dell'ordine in un paese, una dipendenza o un'area geografica.

countryRegion

CountryRegion

Rappresenta un paese o un'area geografica contenente i dettagli correlati.

AdminDistrict

Nome della suddivisione nel paese o nell'area geografica per un indirizzo. Questo elemento viene in genere considerato come suddivisione amministrativa del primo ordine, ma in alcuni casi contiene anche la seconda, terza o quarta suddivisione dell'ordine in un paese, una dipendenza o un'area geografica.

Nome Tipo Descrizione
shortName

string

Il nome breve per il campo adminDistrict corrispondente, Per adminDistrict[0], potrebbe essere un nome breve di stato, ad esempio WA. Questa opzione è disponibile solo per Stati Uniti, Canada e Messico.

AdrTunnelRestrictionCodeEnum

Codice di restrizione del tunnel ADR. L'ADR è un accordo europeo relativo al trasporto internazionale di merci pericolose per strada. Il codice di restrizione del tunnel ADR viene utilizzato per determinare se un veicolo può attraversare un tunnel con restrizioni sul trasporto di merci pericolose.

Valore Descrizione
B

I veicoli con codice B sono limitati dalle strade con categorie di tunnel ADR B, C, D ed E.

C

I veicoli con codice C sono limitati dalle strade con categorie di tunnel ADR C, D ed E

D

I veicoli con codice D sono limitati dalle strade con categorie di tunnel ADR D ed E.

E

I veicoli con codice E sono limitati dalle strade con categoria tunnel ADR E.

AvoidEnum

Specifica le restrizioni che il calcolo della route deve rispettare quando si determina la route. Evitare supporta più valori in una richiesta ed è supportato solo per la guida e il camion travelMode.

Esempio: "avoid": ["limitedAccessHighways", "tollRoads"]

Valore Descrizione
limitedAccessHighways

Evita l'uso di autostrade ad accesso limitato nel percorso.

tollRoads

Evita l'uso di strade a pedaggio nel percorso.

ferries

Evita l'uso di traghetti nel percorso.

tunnels

Evita l'uso di tunnel nella route.

borderCrossings

Evita di attraversare i confini del paese nel percorso.

lowEmissionZones

Evita zone a basse emissioni nel percorso.

unpavedRoads

Evita strade non pavimentate nel percorso.

CountryRegion

Rappresenta un paese o un'area geografica contenente i dettagli correlati.

Nome Tipo Descrizione
ISO

string

ISO del paese/area geografica rappresenta un codice paese/area geografica ISO 3166-1 Alfa-2

name

string

nome del paese/area geografica

DirectionsRequest

Questo oggetto è il corpo della richiesta.

Nome Tipo Valore predefinito Descrizione
arriveAt

string (date-time)

Data e ora di arrivo nel punto di destinazione formattato come valore dateTime definito da RFC 3339, sezione 5.6. Quando non viene specificata una differenza di fuso orario, si presuppone l'ora UTC.

Il parametro arriveAt non può essere utilizzato insieme a departAt.

Esempio: "arriveAt": "2023-06-01T09:30:00.000-07:00"

avoid

AvoidEnum[]

Specifica le restrizioni che il calcolo della route deve rispettare quando si determina la route. Evitare supporta più valori in una richiesta ed è supportato solo per la guida e il camion travelMode.

Esempio: "avoid": ["limitedAccessHighways", "tollRoads"]

departAt

string (date-time)

Data e ora di partenza dal punto di origine formattato come valore dateTime definito da RFC 3339, sezione 5.6. Quando non viene specificata una differenza di fuso orario, si presuppone l'ora UTC.

Se il departAt non è impostato, il valore predefinito è l'ora corrente.

Example:

"departAt": "2023-06-01T09:30:00.000-07:00"

features

InputWaypointFeaturesItem[]

I percorsi di guida e a piedi sono definiti da un set di punti di marcia (fermate) e viaWaypoint (posizioni intermedie che il percorso deve attraversare). È possibile avere un massimo di 25 punti di direzione e un massimo di 10 punti di viaWay tra ogni set di punti di percorso. Il percorso del camion supporta fino a 150 punti di tragitto e viaWaypoint non è supportato.

Un itinerario deve avere almeno 2 punti di partenza e i punti di partenza e di arrivo del percorso non possono essere viaWaypoint.

Sia i percorsi waypoint che i percorsi viaWaypoint devono essere specificati come un oggetto funzione punto GeoJSON valido insieme a pointIndex che specifica l'ordine delle posizioni. For more information on the GeoJSON format, see RFC 7946.

heading

integer (int64)

minimum: 0
maximum: 359

Direzione iniziale del veicolo in gradi a partire da nord reale e continua in senso orario. Nord è di 0 gradi, est è di 90 gradi, sud è di 180 gradi, ovest è di 270 gradi.

maxRouteCount

integer (int64)

minimum: 1
maximum: 6

Numero massimo di route da restituire. Disponibile per le modalità di guida e di viaggio del camion.

Default: "maxRouteCount":1

optimizeRoute

RouteDirectionOptimizeRouteEnum

fastestWithoutTraffic

Specifica il parametro da usare per ottimizzare la route. Se non definito, il valore predefinito è "fastestWithoutTraffic" che restituisce il percorso per ridurre al minimo il tempo di viaggio senza usare le informazioni sul traffico correnti.

Example: "optimizeRoute":"shortest"

optimizeWaypointOrder

boolean

False

Riordinare i punti di percorso usando un algoritmo euristico rapido per ridurre il costo di route specificato con il parametro Optimize. L'origine e la destinazione vengono escluse dal punto di partenza ottimizzato e la relativa posizione viene considerata fissa. I valori accettabili sono true o false.

routeOutputOptions

RouteOutputOptionEnum[]

[ "itinerary" ]

Includere le informazioni di route desiderate dalla risposta. Per impostazione predefinita, l'itinerario è incluso nella risposta.

Supporta più valori come "routeOutputOptions": ["routePath", "itinerary"]

travelMode

TravelModeEnum

driving

Modalità di viaggio per il percorso richiesto. Se non definito, il valore predefinito è "guida" che restituisce il percorso ottimizzato per le auto.

Note: per il trasporto di camionMode, il percorso del camion richiesto potrebbe non essere disponibile per l'intero percorso. Se il percorso del camion non è disponibile per una sezione specifica, l'elemento travelMode della risposta per tale sezione sarà "altro".

Example: "travelMode":"driving"

type

FeatureTypeEnum

Specifica il tipo di GeoJSON. L'unico tipo di oggetto supportato è FeatureCollection. For more information, see RFC 7946.

vehicleSpec

RouteDirectionVehicleSpec

Specifica gli attributi del veicolo, ad esempio dimensioni, peso, velocità massima, tipo di carico e così via solo per il percorso dei camion. Ciò consente di evitare spazi di ponte bassi, restrizioni stradali, turni di destra difficili per fornire il percorso ottimizzato dei camion in base alle specifiche del veicolo.

Note: supportato solo per truck travelMode

DrivingSideEnum

Indica la guida a sinistra o a destra al punto della manovra.

Valore Descrizione
Left

Guida sul lato sinistro.

Right

Guida laterale destra.

FeatureCollection

GeoJSON FeatureCollection oggetto che contiene un elenco di funzionalità. Per altre informazioni, vedere RFC 7946, sezione 3.3.

Nome Tipo Descrizione
features

FeaturesItem[]

GeoJSON oggetto feature che contiene l'oggetto Geometry e le proprietà aggiuntive. Per altre informazioni, vedere RFC 7946, sezione 3.2.

type

FeatureTypeEnum

Specifica il tipo di GeoJSON. L'unico tipo di oggetto supportato è FeatureCollection. For more information, see RFC 7946.

FeaturesItem

Oggetto funzionalità GeoJSON che contiene l'oggetto Geometry e proprietà aggiuntive della route.

Nome Tipo Descrizione
bbox

number[] (double)

Area rettangolare sulla terra definita come oggetto rettangolo delimitatore. I lati dei rettangoli sono definiti dai valori di latitudine e longitudine. Per altre informazioni, vedere RFC 7946, sezione 5.

Esempio: "bbox": [-10.0, -10.0, 10.0, 10.0]

geometry RouteDirectionsGeometry:

Oggetto Geometry valido GeoJSON. For more information, see RFC 7946.

properties FeatureProperties:

Specifica le proprietà delle caratteristiche del percorso, ad esempio itinerario, gambe percorso e geometria, riepilogo dei viaggi.

type

FeaturesItemTypeEnum

Specifica il tipo di GeoJSON. L'unico tipo di oggetto supportato è Feature. For more information, see RFC 7946.

FeaturesItemTypeEnum

Specifica il tipo di GeoJSON. L'unico tipo di oggetto supportato è Feature. For more information, see RFC 7946.

Valore Descrizione
Feature

Specifica il tipo di oggetto Feature GeoJSON.

FeatureTypeEnum

Specifica il tipo di GeoJSON. L'unico tipo di oggetto supportato è FeatureCollection. For more information, see RFC 7946.

Valore Descrizione
FeatureCollection

Specifica il tipo di oggetto GeoJSONFeatureCollection.

GeoJsonPoint

Tipo geometry GeoJSON Point valido. Please refer to RFC 7946 for details.

Nome Tipo Descrizione
coordinates

number[] (double)

Un Position è una matrice di numeri con due o più elementi. The first two elements are longitude and latitude, precisely in that order. Altitude/Elevation is an optional third element. Please refer to RFC 7946 for details.

type string:

Point

Specifica il tipo di GeoJSON. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

InputWaypointFeaturesItem

Specifica il punto di ingresso e viaWaypoint GeoJSON oggetto funzionalità e proprietà aggiuntive. For more information, see RFC 7946.

Nome Tipo Descrizione
geometry GeoJsonPoint:

PointGeometry

Tipo geometry GeoJSON Point valido. Please refer to RFC 7946 for details.

properties

InputWaypointProperties

Specifica le proprietà di un punto di partenza che è una posizione o un punto specifico lungo un percorso o un viaggio che funge da riferimento o punto di arresto.

type

FeaturesItemTypeEnum

Specifica il tipo di GeoJSON. L'unico tipo di oggetto supportato è Feature. For more information, see RFC 7946.

InputWaypointProperties

Specifica le proprietà di un punto di partenza che è una posizione o un punto specifico lungo un percorso o un viaggio che funge da riferimento o punto di arresto.

Nome Tipo Valore predefinito Descrizione
pointIndex

integer (int64)

Identificare e ordinare la sequenza di punti di direzione nella route. Il valore predefinito è il index value di una matrice di funzionalità.

pointType

InputWaypointTypeEnum

waypoint

Tipo di punto di tragitto sulla route. Può trattarsi di una fermata o di una posizione intermedia che il percorso deve attraversare.

InputWaypointTypeEnum

Tipo di punto di tragitto sulla route. Può trattarsi di una fermata o di una posizione intermedia che il percorso deve attraversare.

Valore Descrizione
waypoint

Un punto di partenza è una posizione o un punto specifico lungo un percorso o un viaggio che funge da riferimento o punto di arresto.

viaWaypoint

Un viaWaypoint è un punto di percorso specifico che deve essere passato o visitato lungo un percorso o un viaggio.

Instruction

Descrizione di una manovra in un set di direzioni.

Nome Tipo Descrizione
drivingSide

DrivingSideEnum

Indica la guida a sinistra o a destra al punto della manovra.

formattedText

string

Descrizione del testo formattato dell'istruzione.

maneuverType

ManeuverTypeEnum

Il tipo di manovra descritto in questa raccolta dettagliata. Il ManeuverType fornisce informazioni per una parte della manovra specificata dall'istruzione corrispondente. Ad esempio, il tipo di manovra di un'istruzione può specificare TurnLeftThenTurnRight, mentre gli elementi di dettaglio associati possono fornire specifiche sulle manovre TurnLeft e TurnRight

text

string

Descrizione di testo normale dell'istruzione.

Leg

Informazioni su una sezione di una route tra due punti di direzione. Altre informazioni sui campi contenuti in una gamba di itinerario:

Nome Tipo Descrizione
arrivalAt

string (date-time)

L'ora di arrivo stimata per la gamba, che tiene conto delle condizioni del traffico, viene formattata come valore dateTime definito da RFC 3339, sezione 5.6. Farà riferimento all'offset del fuso orario departAt o arrivalAt. In caso contrario, verrà usata l'ora UTC.

departureAt

string (date-time)

L'ora di partenza stimata per la gamba, che tiene conto delle condizioni del traffico, viene formattata come valore dateTime definito da RFC 3339, sezione 5.6. Farà riferimento all'offset del fuso orario departAt o arrivalAt. In caso contrario, verrà usata l'ora UTC.

distanceInMeters

number

La distanza fisica in metri coperti da una gamba di percorso.

durationInSeconds

integer (int64)

Tempo di viaggio stimato in secondi che non include ritardi sul percorso a causa di condizioni del traffico.

durationTrafficInSeconds

integer (int64)

Tempo necessario, in secondi, per spostarsi in un TravelDistance corrispondente con condizioni di traffico correnti. Questo valore viene fornito se optimizeRoute include considerazioni sul traffico.

routePathRange

RoutePathRange

Fa riferimento all'intervallo coperto da una gamba specifica di un percorso o di un percorso.

ManeuverPointProperties

Specifica le istruzioni di guida e le proprietà aggiuntive per ogni punto di manovra nel percorso Gamba.

Nome Tipo Valore predefinito Descrizione
address

Address

Il distretto amministrativo e la regione del paese per i waypoint e i punti di manovra sul percorso.

distanceInMeters

number

Distanza fisica in metri coperti da questo passaggio del percorso.

durationInSeconds

integer (int64)

Tempo necessario, in secondi, per spostarsi in un TravelDistancecorrispondente.

exitIdentifier

string

Nome o numero dell'uscita associata a questo passaggio di route.

instruction

Instruction

Descrizione di una manovra in un set di direzioni.

order

Order

Sequenza per la visita dei waypoint.

routePathPoint

RoutePathPoint

Fa riferimento all'indice di un punto all'interno di una gamba specifica di un percorso.

sideOfStreet

SideOfStreetEnum

Il lato della strada in cui si trova la destinazione in base alla direzione di arrivo. Questo campo si applica solo all'ultimo punto di manovra.

signs

string[]

Testo della segnaletica per il percorso. Potrebbero essere presenti più di un valore di segno.

steps

Step[]

Passi tra due punti di manovra consecutivi.

towardsRoadName

string

Nome della strada che il percorso va verso nel primo ManeuverPoint.

travelMode

RoutePathTravelModeEnum

driving

Modalità di viaggio per il percorso della risposta.

type string:

ManeuverPoint

Output type.

ManeuverTypeEnum

Il tipo di manovra descritto in questa raccolta dettagliata. Il ManeuverType fornisce informazioni per una parte della manovra specificata dall'istruzione corrispondente. Ad esempio, il tipo di manovra di un'istruzione può specificare TurnLeftThenTurnRight, mentre gli elementi di dettaglio associati possono fornire specifiche sulle manovre TurnLeft e TurnRight

Valore Descrizione
ArriveFinish

Arrivare alla destinazione finale.

ArriveIntermediate

Arrivare a un punto di via intermedio.

BearLeft

Bear left.

BearLeftThenBearLeft

Bear left and then bear left and then bear left again.

BearLeftThenBearRight

Tenete la sinistra e poi la destra.

BearLeftThenTurnLeft

Orso a sinistra e poi girare a sinistra.

BearLeftThenTurnRight

Orso a sinistra e poi girare a destra.

BearRight

Bear right.

BearRightThenBearLeft

Tenete la destra e poi la sinistra.

BearRightThenBearRight

Tenete la destra e poi di nuovo la destra.

BearRightThenTurnLeft

Porta a destra e poi gira a sinistra.

BearRightThenTurnRight

Porta a destra e poi gira a destra.

BearThenKeep

Eseguire l'istruzione e quindi un'istruzione keep

BearThenMerge

Eseguire l'istruzione bear e quindi un'istruzione di merge.

Continue

Continua sulla strada corrente.

DepartIntermediateStop

Lasciare un punto di marcia intermedio in una direzione e una strada diversa da quella in cui sei arrivato.

DepartIntermediateStopReturning

Lasciare un punto intermedio nella stessa direzione e sulla stessa strada su cui sei arrivato.

DepartStart

Lasciare il punto di partenza.

EnterRoundabout

Entrare in una rotatoria.

ExitRoundabout

Uscire da una rotatoria.

EnterThenExitRoundabout

Entrare e uscire da una rotatoria.

ExitRoundaboutRight

Alla rotatoria prendere l'uscita a destra.

ExitRoundaboutLeft

Alla rotatoria prendere l'uscita a sinistra.

Follow

Follow.

GoAroundRoundabout

Andate in giro per la rotatoria.

KeepLeft

Continuate a sinistra su una strada diversa.

KeepOnRampLeft

Continuate a sinistra e continuate sulla rampa.

KeepOnRampRight

Continuate a destra e continuate sulla rampa.

KeepOnRampStraight

Continuate dritto e continuate su rampa.

KeepRight

Continuate a destra su una strada diversa.

KeepStraight

Continuate dritto su una strada diversa.

KeepToStayLeft

Continuate a sinistra per rimanere sulla stessa strada.

KeepToStayRight

Mantieni giusto per rimanere sulla stessa strada.

KeepToStayStraight

Continuate dritto per rimanere sulla stessa strada.

MergeFreeway

Unisci su una strada libera.

MergeHighway

Unisci su un'autostrada.

MergeMotorway

Unisci su un'autostrada.

MotorwayExitLeft

Prendi l'uscita sinistra.

MotorwayExitRight

Esci a destra.

None

No instruction.

RampThenHighwayLeft

Prendi la rampa sinistra sull'autostrada. Questa è parte di un'istruzione combinata.

RampThenHighwayRight

Prendi la rampa destra sull'autostrada. Questa è parte di un'istruzione combinata.

RampThenHighwayStraight

Resta dritto per prendere la rampa sull'autostrada. Questa è parte di un'istruzione combinata.

RoadNameChange

Modifiche al nome della strada.

SwitchToParallelRoad

Passare alla strada parallela.

SwitchToMainRoad

Passare alla strada principale.

Take

Prendi la strada. Questa istruzione viene utilizzata quando si entra o si esce da un traghetto.

TakeFerry

Prendi il traghetto.

TakeExit

Prendi l'uscita.

TakeRamp

Take ramp.

TakeRampLeft

Prendi la rampa a sinistra.

TakeRampRight

Prendi la rampa a destra.

TakeRampStraight

Resta dritto per prendere rampa.

TurnBack

Torna indietro bruscamente.

TurnLeft

Turn left.

TurnLeftSharp

Prendi un turno sinistro tagliente.

TurnLeftThenBearLeft

Gira a sinistra e poi porta a sinistra.

TurnLeftThenBearRight

Gira a sinistra e poi porta a destra.

TurnLeftThenTurnLeft

Girare a sinistra e quindi girare di nuovo a sinistra.

TurnLeftThenTurnRight

Girare a sinistra e quindi girare a destra.

TurnRight

Turn right.

TurnRightSharp

Prendi una curva destra nitida.

TurnRightThenBearLeft

Girare a destra e poi sopportare a sinistra.

TurnRightThenBearRight

Gira a destra e poi porta a destra.

TurnRightThenTurnLeft

Girare a destra e quindi girare a sinistra.

TurnRightThenTurnRight

Girare a destra e quindi girare di nuovo a destra

TurnThenMerge

Istruzione turn seguita da un'istruzione di merge.

TurnToStayLeft

Gira a sinistra per rimanere sulla stessa strada.

TurnToStayRight

Gira a destra per rimanere sulla stessa strada.

Unknown

L'istruzione è sconosciuta.

UTurn

Fare un u-turn per andare nella direzione opposta.

Wait

Wait

Walk

Walk

MapsErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
code

string

Uno di un set definito dal server di codici di errore.

details

MapsErrorDetail[]

Matrice di dettagli sugli errori specifici che hanno causato l'errore segnalato.

innererror

MapsInnerError

Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.

message

string

Rappresentazione leggibile dell'errore.

target

string

Destinazione dell'errore.

MapsErrorResponse

Risposta di errore comune per le API di Mappe di Azure per restituire i dettagli dell'errore per le operazioni non riuscite.

Nome Tipo Descrizione
error

MapsErrorDetail

Dettagli dell'errore.

MapsInnerError

Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.

Nome Tipo Descrizione
code

string

Codice di errore.

innererror

MapsInnerError

Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.

MultiLineStringGeometry

Specifica l'GeoJSON oggetto Geometry MultiLineString. For more information, see RFC 7946.

Nome Tipo Descrizione
coordinates

number[] (double)

Coordinate per la geometria GeoJson MultiLineString.

type string:

MultiLineString

Specifica il tipo di geometria per l'oggetto Geometry GeoJSON. For more information, see RFC 7946.

OptimizedWaypoint

Oggetto punto di ottimizzazione.

Nome Tipo Descrizione
inputIndex

integer (int64)

Indice del punto di modo fornito dall'utente.

optimizedIndex

integer (int64)

Indice del punto di modo ottimizzato dal sistema.

Order

Sequenza per la visita dei waypoint.

Nome Tipo Descrizione
inputIndex

integer (int64)

Indice fornito dall'utente per il waypoint

optimizedIndex

integer (int64)

System-optimized waypoint

PointGeometry

Punto di origine passato come oggetto Geometry valido GeoJSON da cui calcolare il poligono dell'intervallo. Please refer to RFC 7946 for details.

Note: l'API blocca il punto di origine richiesto alla rete stradale più vicina e lo userà per il calcolo dell'intervallo. Verrà restituito come punto center nella risposta.

Nome Tipo Descrizione
coordinates

number[] (double)

Un Position è una matrice di numeri con due o più elementi. The first two elements are longitude and latitude, precisely in that order. Altitude/Elevation is an optional third element. Please refer to RFC 7946 for details.

type string:

Point

Specifica il tipo di geometria per l'oggetto Geometry GeoJSON. For more information, see RFC 7946.

RouteDirectionOptimizeRouteEnum

Specifica il parametro da usare per ottimizzare la route. Se non definito, il valore predefinito è "fastestWithoutTraffic" che restituisce il percorso per ridurre al minimo il tempo di viaggio senza usare le informazioni sul traffico correnti.

Example: "optimizeRoute":"shortest"

Valore Descrizione
shortest

Il percorso viene calcolato per ridurre al minimo la distanza. Le informazioni sul traffico non vengono usate.

fastestWithoutTraffic

Trova la route più veloce, senza considerare le informazioni sul traffico.

fastestAvoidClosureWithoutTraffic
fastestWithTraffic

La route viene calcolata per ridurre al minimo il tempo usando le informazioni sul traffico correnti. Note: supportato solo per la guida e il trasporto di camionMode.

RouteDirectionsResponse

Questo oggetto viene restituito da una chiamata riuscita.

Nome Tipo Descrizione
alternativeRoutes

FeatureCollection[]

Alternative route.

features

FeaturesItem[]

GeoJSON oggetto feature che contiene l'oggetto Geometry e le proprietà aggiuntive. Per altre informazioni, vedere RFC 7946, sezione 3.2.

type

FeatureTypeEnum

Specifica il tipo di GeoJSON. L'unico tipo di oggetto supportato è FeatureCollection. For more information, see RFC 7946.

RouteDirectionVehicleSpec

Specifica gli attributi del veicolo, ad esempio dimensioni, peso, velocità massima, tipo di carico e così via solo per il percorso dei camion. Ciò consente di evitare spazi di ponte bassi, restrizioni stradali, turni di destra difficili per fornire il percorso ottimizzato dei camion in base alle specifiche del veicolo.

ISNote: supportato solo per truck travelMode.

Nome Tipo Valore predefinito Descrizione
adrTunnelRestrictionCode

AdrTunnelRestrictionCodeEnum

Codice di restrizione del tunnel ADR. L'ADR è un accordo europeo relativo al trasporto internazionale di merci pericolose per strada. Il codice di restrizione del tunnel ADR viene utilizzato per determinare se un veicolo può attraversare un tunnel con restrizioni sul trasporto di merci pericolose.

axleCount

integer (int64)

Numero di assi sul veicolo.

axleWeight

integer (int64)

minimum: 0
maximum: 1000000
0

Peso per asse del veicolo in kg. Il valore 0 indica che le restrizioni di peso per asse non vengono considerate.

height

number (double)

minimum: 0
maximum: 1000000
0

Altezza del veicolo in metri. Il valore 0 indica che le restrizioni di altezza non vengono considerate.

isVehicleCommercial

boolean

False

Indica se il veicolo viene utilizzato per scopi commerciali. I veicoli commerciali potrebbero non essere autorizzati a guidare su alcune strade.

length

number (double)

minimum: 0
maximum: 1000000
0

Lunghezza del veicolo in metri. Il valore 0 indica che le restrizioni di lunghezza non vengono considerate.

loadType

VehicleLoadTypeEnum[]

Tipi di carico che possono essere classificati come materiali pericolosi e limitati da alcune strade. I valori di vehicleLoadType disponibili sono classi Us Hazmat da 1 a 9, oltre a classificazioni generiche da usare in altri paesi. I valori che iniziano con USHazmat sono per l'instradamento degli Stati Uniti, mentre altrihazmat devono essere usati per tutti gli altri paesi. vehicleLoadType supporta più valori in una richiesta.

maxSpeed

integer (int64)

minimum: 0
maximum: 250
0

Velocità massima del veicolo in km/ora. La velocità massima nel profilo del veicolo viene utilizzata per verificare se un veicolo è consentito sulle autostrade.

Il valore 0 indica che un valore appropriato per il veicolo verrà determinato e applicato durante la pianificazione del percorso.

È possibile eseguire l'override di un valore diverso da zero durante la pianificazione della route. Ad esempio, il flusso di traffico corrente è di 60 km/ora. Se la velocità massima del veicolo è impostata su 50 km/ora, il motore di instradamento considererà 60 km/ora in quanto si tratta della situazione attuale. Se la velocità massima del veicolo viene fornita come 80 km/ora, ma il flusso di traffico corrente è di 60 km/ora, il motore di instradamento utilizzerà di nuovo 60 km/ora.

weight

integer (int64)

minimum: 0
maximum: 1000000
0

Peso del veicolo in kg. Il valore 0 indica che le restrizioni di peso non vengono considerate.

width

number (double)

minimum: 0
maximum: 1000000
0

Larghezza del veicolo in metri. Il valore 0 indica che le restrizioni di larghezza non vengono considerate.

RouteOutputOptionEnum

Includere le informazioni di route desiderate dalla risposta. Per impostazione predefinita, l'itinerario è incluso nella risposta.

Supporta più valori come "routeOutputOptions": ["routePath", "itinerary"]

Valore Descrizione
routeSummary

Includere solo il tempo di viaggio e la distanza per il percorso e non fornire altre informazioni.

routePath

Includere un GeoJSON MultiLineString RFC 7946, sezione 3.1.5 che descrivono il percorso della route nella risposta.

itinerary

Includere indicazioni dettagliate nella risposta. Le indicazioni dettagliate sono fornite come "ManeuverPoints" e contengono dettagli come le istruzioni turn-by-turn.

RoutePathPoint

Fa riferimento all'indice di un punto all'interno di una gamba specifica di un percorso.

Nome Tipo Descrizione
legIndex

integer (int64)

L'indice leg del percorso è un numero sequenziale assegnato a ogni gamba del percorso per identificare e distinguere tra segmenti diversi del percorso.

pointIndex

integer (int64)

Indice di un punto all'interno di una gamba specifica.

RoutePathProperties

Specifica le proprietà che descrivono il percorso della route nella risposta.

Nome Tipo Descrizione
arrivalAt

string (date-time)

L'ora di arrivo stimata per la gamba, che tiene conto delle condizioni del traffico, viene formattata come valore dateTime definito da RFC 3339, sezione 5,6. Farà riferimento all'offset del fuso orario departAt o arrivalAt. In caso contrario, verrà usata l'ora UTC.

departureAt

string (date-time)

L'ora di partenza stimata per la gamba, che tiene conto delle condizioni del traffico, viene formattata come valore dateTime definito da RFC 3339, sezione 5.6. Farà riferimento all'offset del fuso orario departAt o arrivalAt. In caso contrario, verrà usata l'ora UTC.

distanceInMeters

number

Distanza fisica in metri coperti dall'intero percorso.

durationInSeconds

integer (int64)

Tempo di viaggio stimato in secondi che non include ritardi sul percorso a causa di condizioni del traffico.

durationTrafficInSeconds

integer (int64)

Tempo necessario, in secondi, per spostarsi in un TravelDistance corrispondente con condizioni di traffico correnti. Questo valore viene fornito se optimizeRoute include considerazioni sul traffico.

legs

Leg[]

Matrice di gambe di percorso. Per altre informazioni, vedere la descrizione dell'oggetto Leg di route.

optimizedWaypoints

OptimizedWaypoint[]

Sequenza ottimizzata di punti di direzione. Mostra l'indice della sequenza di punti di percorso fornita dall'utente per gli elenchi originali e ottimizzati.

trafficCongestion

TrafficCongestionEnum

Livello di congestione del traffico lungo il percorso. Note: supportato solo per la guida di travelMode

type string:

RoutePath

Output type.

RoutePathRange

Fa riferimento all'intervallo coperto da una gamba specifica di un percorso o di un percorso.

Nome Tipo Descrizione
legIndex

integer (int64)

L'indice leg del percorso è un numero sequenziale assegnato a ogni gamba del percorso per identificare e distinguere tra segmenti diversi del percorso.

range

integer[] (int64)

Fa riferimento all'intervallo coperto da una gamba specifica di un percorso o di un percorso.

RoutePathTravelModeEnum

Modalità di viaggio per il percorso della risposta.

Valore Descrizione
driving

Itinerari ottimizzati per le auto.

truck

Itinerari ottimizzati per autocarri di grandi dimensioni in base alla specifica del veicolo.

walking

Itinerari ottimizzati per i pedoni.

other

Route TagsMode viene restituito come "altro" per il camion travelMode quando il percorso del camion non è disponibile per una sezione specifica di un itinerario.

SideOfStreetEnum

Il lato della strada in cui si trova la destinazione in base alla direzione di arrivo. Questo campo si applica solo all'ultimo punto di manovra.

Valore Descrizione
Left

Left.

Right

Right.

Unknown

Unknown.

Step

Una gamba del percorso contiene istruzioni turn-by-turn. Un passo si riferisce a una gamma di un percorso tra due punti di manovra consecutivi.

Nome Tipo Descrizione
maneuverType

ManeuverTypeEnum

Il tipo di manovra descritto in questa raccolta dettagliata. Il ManeuverType fornisce informazioni per una parte della manovra specificata dall'istruzione corrispondente. Ad esempio, il tipo di manovra di un'istruzione può specificare TurnLeftThenTurnRight, mentre gli elementi di dettaglio associati possono fornire specifiche sulle manovre TurnLeft e TurnRight

names

string[]

Strada, autostrada o intersezione in cui si verifica la manovra. Se la manovra è complessa, nella raccolta dei dettagli potrebbero essere presenti più campi nome. Il campo nome potrebbe anche non avere alcun valore. Ciò può verificarsi se il nome non è noto o se una strada, un'autostrada o un'intersezione non ha un nome.

routePathRange

RoutePathRange

Fa riferimento all'intervallo coperto da una gamba specifica di un percorso o di un percorso.

TrafficCongestionEnum

Livello di congestione del traffico lungo il percorso. Note: supportato solo per la guida di travelMode

Valore Descrizione
Unknown

Unknown.

None

None.

Mild

Mild.

Medium

Medium.

Heavy

Heavy.

TravelModeEnum

Modalità di viaggio per il percorso richiesto. Se non definito, il valore predefinito è "guida" che restituisce il percorso ottimizzato per le auto.

Note: per il trasporto di camionMode, il percorso del camion richiesto potrebbe non essere disponibile per l'intero percorso. Se il percorso del camion non è disponibile per una sezione specifica, l'elemento travelMode della risposta per tale sezione sarà "altro".

Example: "travelMode":"driving"

Valore Descrizione
driving

I percorsi restituiti sono ottimizzati per le auto.

truck

I percorsi restituiti sono ottimizzati per autocarri di grandi dimensioni in base alla specifica del veicolo.

walking

I percorsi restituiti sono ottimizzati per i pedoni, incluso l'uso di marciapiedi.

VehicleLoadTypeEnum

Tipi di carico che possono essere classificati come materiali pericolosi e limitati da alcune strade. I valori di vehicleLoadType disponibili sono classi Us Hazmat da 1 a 9, oltre a classificazioni generiche da usare in altri paesi. I valori che iniziano con USHazmat sono per l'instradamento degli Stati Uniti, mentre altrihazmat devono essere usati per tutti gli altri paesi. vehicleLoadType supporta più valori in una richiesta.

Valore Descrizione
USHazmatClass1

Explosives

USHazmatClass2

Compressed gas

USHazmatClass3

Flammable liquids

USHazmatClass4

Flammable solids

USHazmatClass5

Oxidizers

USHazmatClass6

Poisons

USHazmatClass7

Radioactive

USHazmatClass8

Corrosives

USHazmatClass9

Miscellaneous

otherHazmatExplosive

Explosives

otherHazmatGeneral

Miscellaneous

otherHazmatHarmfulToWater

Dannoso per l'acqua

WaypointProperties

Specifica le proprietà di un punto di partenza che è una posizione o un punto specifico lungo un percorso o un viaggio che funge da riferimento o punto di arresto.

Nome Tipo Valore predefinito Descrizione
address

Address

Il distretto amministrativo e la regione del paese per i waypoint e i punti di manovra sul percorso.

distanceInMeters

number

Distanza fisica in metri coperti da questo passaggio del percorso.

durationInSeconds

integer (int64)

Tempo necessario, in secondi, per spostarsi in un TravelDistancecorrispondente.

exitIdentifier

string

Nome o numero dell'uscita associata a questo passaggio di route.

instruction

Instruction

Descrizione di una manovra in un set di direzioni.

order

Order

Sequenza per la visita dei waypoint.

routePathPoint

RoutePathPoint

Fa riferimento all'indice di un punto all'interno di una gamba specifica di un percorso.

sideOfStreet

SideOfStreetEnum

Il lato della strada in cui si trova la destinazione in base alla direzione di arrivo. Questo campo si applica solo all'ultimo punto di manovra.

signs

string[]

Testo della segnaletica per il percorso. Potrebbero essere presenti più di un valore di segno.

steps

Step[]

Passi tra due punti di manovra consecutivi.

towardsRoadName

string

Nome della strada che il percorso va verso nel primo ManeuverPoint.

travelMode

RoutePathTravelModeEnum

driving

Modalità di viaggio per il percorso della risposta.

type string:

Waypoint

Output type.