Method: annotatePaths (Automotive)

Restituisce indietro i percorsi basati su segmenti di input con annotazioni per gli attributi dinamici lungo i percorsi.

Richiesta HTTP

POST https://routes.googleapis.com/annotations/v2:annotatePaths

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "paths": [
    {
      object (Path)
    }
  ],
  "annotationOptions": {
    object (AnnotationOptions)
  }
}
Campi
paths[]

object (Path)

Obbligatoria. Le route richieste da compilare con i dati degli attributi dinamici. Tutti i percorsi devono avere lo stesso segmento di partenza, ovvero quello su cui si trova attualmente il veicolo. Si presume che il veicolo si trovi all'inizio del primo segmento. Se i percorsi non iniziano dallo stesso tratto, verrà restituito un errore.
annotationOptions

object (AnnotationOptions)

Obbligatoria. Gli attributi dei dati dinamici richiesti da aggiungere nei percorsi di input. Se vuota, la richiesta non verrà annotata.

Corpo della risposta

L'elemento AnnotatePathsResponse contiene i percorsi di input con dati aggiuntivi aggiunti per tutte le annotazioni richieste.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "annotatedPaths": [
    {
      object (AnnotatedPath)
    }
  ]
}
Campi
annotatedPaths[]

object (AnnotatedPath)

Percorsi dell'input annotati con attributi richiesti.

Percorso

Un percorso in cui vengono richiesti attributi dinamici.

Un percorso deve avere segmenti collegati e percorribili. Si presume che i segmenti di un percorso seguano una via logica e, se non è possibile trovare una route nei segmenti di input, viene restituito un errore. Ad esempio, se i segmenti di un percorso non hanno endpoint di collegamento o se un percorso è vuoto, viene restituito un errore.

Attualmente un percorso è limitato a 15 km. Il percorso viene misurato dall'inizio del primo segmento, la posizione prevista del veicolo. Se un tratto di un percorso inizia a una distanza superiore a 15 km dall'inizio del primo tratto, verrà restituito un errore. È accettabile che l'ultimo tratto inizi prima dei 15 km e termini dopo i 15 km. Non verranno restituite risposte parziali.

Un percorso può contenere gli stessi segmenti di un altro percorso, ma le annotazioni dei segmenti possono contenere risposte diverse in base alle differenze in altre parti del percorso.

Rappresentazione JSON 
{
  "segments": [
    {
      object (Segment)
    }
  ]
}
Campi
segments[]

object (Segment)

Obbligatoria. Un elenco ordinato di segmenti che formano il percorso.

Segmento

Un segmento che appartiene a un percorso.

Rappresentazione JSON 
{
  "polyline": {
    object (Polyline)
  },

  // Union field id can be only one of the following:
  "placeId": string
  // End of list of possible types for union field id.
}
Campi
polyline

object (Polyline)

Obbligatoria. La polilinea del segmento, che può essere utilizzata per identificare il segmento se non è possibile trovare l'ID e anche per distinguere tra due segmenti se hanno lo stesso ID. La polilinea è codificata utilizzando il formato standard dell'algoritmo Polilinea codificato di Google Maps Platform.
Campo di unione id. Utilizzato per identificare questo segmento all'interno di uno spazio ID. Obbligatoria. id può essere solo uno dei seguenti:
placeId

string

L'ID luogo di questo tratto di strada. Utilizzato nelle API.

AnnotationOptions

Annotazioni richieste per i percorsi di input.

Rappresentazione JSON 
{
  "includeLevelOfService": boolean
}
Campi
includeLevelOfService

boolean

Campo facoltativo. Se impostato su true, i segmenti nella risposta verranno annotati con i valori di traffico previsti. "Livello di servizio" è un termine generalmente utilizzato per descrivere la categorizzazione del flusso di traffico, ma il livello di definizioni dei servizi in questa API appartiene solo a questa API.

AnnotatedPath

Una copia di un percorso di input restituito con gli attributi previsti.

Rappresentazione JSON 
{
  "annotatedSegments": [
    {
      object (AnnotatedSegment)
    }
  ]
}
Campi
annotatedSegments[]

object (AnnotatedSegment)

Un elenco ordinato di segmenti che formano il percorso principale, annotato con gli attributi richiesti.

AnnotatedSegment

Un segmento che crea un percorso annotato con attributi di dati dinamici.

Rappresentazione JSON 
{
  "segment": {
    object (Segment)
  },
  "segmentSpanAttributes": [
    {
      object (SegmentSpanAttribute)
    }
  ]
}
Campi
segment

object (Segment)

Dettagli del segmento utilizzati per distinguerlo dagli altri segmenti.
segmentSpanAttributes[]

object (SegmentSpanAttribute)

Attributi assegnati al segmento. Questi attributi possono variare in base al percorso in cui si trova un segmento. Un intervallo può coprire l'intero segmento. Le sezioni degli attributi saranno in ordine in avanti dalla posizione del veicolo alla fine del percorso.

SegmentSpanAttribute

Un SegmentSpanAttribute contiene le annotazioni restituite dall'API.

Rappresentazione JSON 
{
  "segmentSpan": {
    object (SegmentSpan)
  },
  "levelOfService": enum (LevelOfService)
}
Campi
segmentSpan

object (SegmentSpan)

Descrive in quali punti del segmento si applicano le annotazioni.
levelOfService

enum (LevelOfService)

Livello di traffico previsto per l'intervallo di un segmento, definito dalle velocità del traffico previste in questo tratto quando il veicolo arriva all'inizio del segmento.

SegmentSpan

Utilizzato per delimitare una sottosezione di un segmento. Se una sezione copre l'intero segmento, startMeters sarebbe 0 e endMeters sarebbe la lunghezza del segmento.

Rappresentazione JSON 
{
  "startMeters": integer,
  "endMeters": integer
}
Campi
startMeters

integer

Dove l'inizio dell'intervallo si trova dal punto iniziale della polilinea del segmento.
endMeters

integer

Dove la fine dell'intervallo si trova dal punto iniziale della polilinea del segmento.

LevelOfService

Valori previsti del bucket di traffico, da utilizzare per la funzionalità ADAS, che vengono mappati a livelli generali di traffico. I valori restituiti da questa API sono indipendenti e non devono essere utilizzati per corrispondere ad altre API.

Enum
LEVEL_OF_SERVICE_UNSPECIFIED Valore predefinito. Questo valore indica che non è disponibile alcun valore di traffico previsto.
LEVEL_OF_SERVICE_STOPPED Il traffico è stato interrotto.
LEVEL_OF_SERVICE_STOP_AND_GO Il traffico è fermo.
LEVEL_OF_SERVICE_SLOW È previsto un rallentamento, ma non sono previsti ingorghi.
LEVEL_OF_SERVICE_NORMAL Velocità normale, non è previsto alcun rallentamento.