Method: annotatePaths (Automotive)

Muestra las rutas de acceso basadas en segmentos de entrada con anotaciones para los atributos dinámicos a lo largo de las rutas de acceso.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON
{
  "paths": [
    {
      object (Path)
    }
  ],
  "annotationOptions": {
    object (AnnotationOptions)
  }
}
Campos
paths[]

object (Path)

Obligatorio. Las rutas solicitadas que se deben completar con datos de atributos dinámicos. Todas las rutas deben tener el mismo tramo inicial, que debe ser el tramo en el que se encuentra el vehículo actualmente. Se supone que el vehículo está al comienzo del primer tramo. Si las rutas de acceso no comienzan en el mismo tramo, se mostrará un error.

annotationOptions

object (AnnotationOptions)

Obligatorio. Los atributos de datos dinámicos solicitados que se deben agregar en las rutas de acceso de entrada. Si está vacía, no se anotará la solicitud.

Cuerpo de la respuesta

AnnotatePathsResponse contiene las rutas de acceso de entrada con datos adicionales agregados para todas las anotaciones solicitadas.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "annotatedPaths": [
    {
      object (AnnotatedPath)
    }
  ]
}
Campos
annotatedPaths[]

object (AnnotatedPath)

Rutas de acceso de la entrada anotadas con atributos solicitados.

Ruta de acceso

Una ruta de acceso en la que se solicitan atributos dinámicos.

Una ruta debe tener tramos que estén conectados y que sean transitables. Se supone que los segmentos de una ruta siguen una ruta lógica y, si no se puede encontrar una ruta en los segmentos de entrada, se mostrará un error. Por ejemplo, si los segmentos de una ruta de acceso no tienen extremos que se conecten o una ruta está vacía, se producirá un error.

Actualmente, hay un límite de 15 km de largo. La ruta se mide desde el principio del primer tramo, la ubicación supuesta del vehículo. Se mostrará un error si un tramo de la ruta comienza a más de 15 km desde el principio del primer tramo. Está permitido que el último tramo comience antes de los 15 km y finalice después de los 15 km. No se mostrarán respuestas parciales.

Una ruta de acceso puede contener los mismos segmentos que otra, pero es posible que las anotaciones de segmentos contengan respuestas diferentes según las diferencias en otras partes de la ruta.

Representación JSON
{
  "segments": [
    {
      object (Segment)
    }
  ]
}
Campos
segments[]

object (Segment)

Obligatorio. Una lista ordenada de segmentos que forman la ruta de acceso.

Segmento

Un segmento que pertenece a una ruta.

Representación 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.
}
Campos
polyline

object (Polyline)

Obligatorio. La polilínea del segmento, que se puede usar para identificar el segmento si no se puede encontrar el ID y también para diferenciar entre dos segmentos si tienen el mismo ID La polilínea se codifica con el formato estándar del algoritmo de polilínea codificada de Google Maps Platform.

Campo de unión id. Se usa para identificar este segmento dentro de un espacio de ID. Obligatorio. Las direcciones (id) solo pueden ser una de las siguientes opciones:
placeId

string

El ID de lugar de este tramo de ruta. Se usa en todas las APIs.

AnnotationOptions

Anotaciones solicitadas para las rutas de acceso de entrada

Representación JSON
{
  "includeLevelOfService": boolean
}
Campos
includeLevelOfService

boolean

Opcional. Cuando se configura como verdadero, los segmentos en la respuesta se anotarán con valores de tráfico previstos. “Nivel de servicio” es un término de uso general para describir la categorización del flujo de tráfico, pero el nivel de definiciones de servicio en esta API pertenece solo a esta API.

AnnotatedPath

Una copia de la ruta de acceso de entrada que se muestra con los atributos predichos.

Representación JSON
{
  "annotatedSegments": [
    {
      object (AnnotatedSegment)
    }
  ]
}
Campos
annotatedSegments[]

object (AnnotatedSegment)

Una lista ordenada de segmentos que forman la ruta principal, anotados con atributos solicitados.

AnnotatedSegment

Es un segmento que crea una ruta, anotada con atributos de datos dinámicos.

Representación JSON
{
  "segment": {
    object (Segment)
  },
  "segmentSpanAttributes": [
    {
      object (SegmentSpanAttribute)
    }
  ]
}
Campos
segment

object (Segment)

Son los detalles del segmento que se utilizan para distinguirlo de otros segmentos.

segmentSpanAttributes[]

object (SegmentSpanAttribute)

Son los atributos asignados al segmento. Estos atributos pueden diferir según la ruta en la que se encuentre un segmento. Un intervalo puede abarcar todo el segmento. Los intervalos de los atributos estarán en orden desde la ubicación del vehículo hasta el final de la ruta.

SegmentSpanAttribute

Un SegmentSpanAttribute contiene las anotaciones que muestra la API.

Representación JSON
{
  "segmentSpan": {
    object (SegmentSpan)
  },
  "levelOfService": enum (LevelOfService)
}
Campos
segmentSpan

object (SegmentSpan)

Describe en qué parte del segmento se aplican las anotaciones.

levelOfService

enum (LevelOfService)

Es el nivel de tráfico previsto para el intervalo del tramo, definido según las velocidades de tráfico esperadas en este tramo cuando el vehículo llega al comienzo del tramo.

SegmentSpan

Se usa para delimitar la subsección de un segmento. Si un intervalo abarca todo el segmento, startMeters sería 0 y endMeters sería la longitud del segmento.

Representación JSON
{
  "startMeters": integer,
  "endMeters": integer
}
Campos
startMeters

integer

El comienzo del tramo es desde el punto de partida de la polilínea del tramo.

endMeters

integer

Cuando el final del tramo es desde el punto de partida de la polilínea del tramo.

LevelOfService

Valores del intervalo de tráfico previstos, que se usarán para la funcionalidad del ADAS, que se asignen a los niveles generales de tráfico Los valores que muestra esta API son independientes y no se debe confiar en que corresponden a otras APIs.

Enumeradores
LEVEL_OF_SERVICE_UNSPECIFIED Valor predeterminado Este valor significa que no hay disponible un valor previsto de tráfico.
LEVEL_OF_SERVICE_STOPPED El tráfico se detuvo.
LEVEL_OF_SERVICE_STOP_AND_GO El tráfico está detenido.
LEVEL_OF_SERVICE_SLOW Se predice una demora, pero no se predicen embotellamientos.
LEVEL_OF_SERVICE_NORMAL Velocidad normal, no se predice ninguna demora.