Method: computeRoutes

Restituisce il percorso principale tra l'origine e la destinazione richieste per la modalità di viaggio richiesta.

Richiesta HTTP

POST https://mapstools.googleapis.com/v1alpha:computeRoutes

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode),
  "intermediateWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "routingPreference": enum (RoutingPreference),
  "locationBias": {
    object (LatLng)
  },
  "includePolyline": boolean,
  "computeAlternativeRoutes": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "departureTime": string,
  "arrivalTime": string
  // End of mutually exclusive fields.
}
Campi
origin

object (Waypoint)

Obbligatorio. Waypoint di origine.
destination

object (Waypoint)

Obbligatorio. Waypoint di destinazione.
travelMode

enum (RouteTravelMode)

Facoltativo. Specifica il mezzo di trasporto.
intermediateWaypoints[]

object (Waypoint)

Facoltativo. Fermate intermedie tra il luogo di partenza e la destinazione da attraversare in ordine. Sono supportate fino a 25 tappe intermedie.

Se specifichi più di 10 waypoint intermedi, i costi e la latenza saranno più elevati. I waypoint intermedi non sono supportati quando travelMode è TRANSIT.
routingPreference

enum (RoutingPreference)

Facoltativo. Determina il modo in cui i dati sul traffico vengono utilizzati per calcolare il percorso. ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL non è supportato quando travelMode è WALK o BICYCLE. Per TRANSIT, attiva i dati sul trasporto pubblico in tempo reale, come ritardi e cancellazioni.
locationBias

object (LatLng)

Facoltativo. Una località verso cui orientare i risultati di ricerca, ad esempio per eliminare l'ambiguità delle query di testo dei waypoint.
includePolyline

boolean

Facoltativo. Indica se includere la polilinea codificata nei percorsi di risposta. Il valore predefinito è false. Se impostato su true, viene restituito Route.encoded_polyline.
computeAlternativeRoutes

boolean

Facoltativo. Indica se calcolare percorsi alternativi oltre a quello consigliato. Il valore predefinito è false, nel qual caso viene restituito solo il percorso consigliato. Se impostato su true, vengono restituite tutte le route disponibili, anche se le alternative potrebbero non essere disponibili per ogni richiesta.
Specifica quando partire dall'origine o arrivare al waypoint finale. Se non specificato, il valore predefinito è l'ora corrente. Per TRANSIT, l'orario deve essere al massimo 7 giorni nel passato e al massimo 100 giorni nel futuro. Per altre modalità di viaggio, l'orario non deve essere nel passato e deve essere al massimo 365 giorni nel futuro. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
departureTime

string (Timestamp format)

Facoltativo. Indica che il percorso deve essere calcolato in base all'ora di partenza.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
arrivalTime

string (Timestamp format)

Facoltativo. Indica che il percorso deve essere calcolato in base all'ora di arrivo.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
Fine dei campi che si escludono a vicenda.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di ComputeRoutesResponse.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/maps-platform.mapstools