- Solicitação HTTP
- Corpo da solicitação
- Corpo da resposta
- Caminho
- Segmento
- AnnotationOptions
- AnnotatedPath
- AnnotatedSegment (em inglês)
- SegmentSpanAttribute
- SegmentSpan
- LevelOfService
Retorna os caminhos com base em segmentos de entrada de volta com anotações para atributos dinâmicos ao longo dos caminhos.
Solicitação HTTP
POST https://routes.googleapis.com/annotations/v2:annotatePaths
O URL usa a sintaxe de transcodificação gRPC.
Corpo da solicitação
O corpo da solicitação contém dados com a seguinte estrutura:
Representação JSON |
---|
{ "paths": [ { object ( |
Campos | |
---|---|
paths[] |
Obrigatório. As rotas solicitadas a serem preenchidas com dados de atributo dinâmico. Todos os caminhos precisam ter o mesmo trecho de partida, sendo o trecho em que o veículo está no momento. O veículo está no início do primeiro trecho. Se os caminhos não começarem no mesmo segmento, será retornado um erro. |
annotationOptions |
Obrigatório. Os atributos de dados dinâmicos solicitados que precisam ser adicionados aos caminhos de entrada. Se estiver vazia, a solicitação não será anotada. |
Corpo da resposta
A annotatePathsResponse contém os caminhos de entrada com mais dados para todas as anotações solicitadas.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Representação JSON |
---|
{
"annotatedPaths": [
{
object ( |
Campos | |
---|---|
annotatedPaths[] |
Caminhos da entrada anotada com atributos solicitados. |
Caminho
Um caminho em que atributos dinâmicos estão sendo solicitados.
Um caminho precisa ter segmentos conectados e com acesso. Os segmentos de um caminho seguem um trajeto lógico e, se não for possível encontrar uma rota nos segmentos de entrada, será retornado um erro. Por exemplo, se os segmentos de um caminho não tiverem pontos de extremidade de conexão ou se o caminho estiver vazio, ocorrerá um erro.
No momento, o caminho está limitado a 15 km de extensão. O caminho é medido a partir do início do primeiro trecho, a localização do veículo presumida. Um erro será retornado se um trecho de um caminho começar a mais de 15 km do início do primeiro trecho. É aceitável que o último trecho comece antes de 15 km e termine após 15 km. Não será retornada nenhuma resposta parcial.
Um caminho pode conter os mesmos segmentos que outro caminho, mas é possível que as anotações de segmento contenham respostas diferentes, com base nas diferenças em outras partes do caminho.
Representação JSON |
---|
{
"segments": [
{
object ( |
Campos | |
---|---|
segments[] |
Obrigatório. Uma lista ordenada de segmentos que formam o caminho. |
Segmento
Um segmento que pertence a um caminho.
Representação JSON |
---|
{ "polyline": { object ( |
Campos | |
---|---|
polyline |
Obrigatório. A polilinha do segmento, que pode ser usada para identificar o segmento se o ID não puder ser encontrado e também para diferenciar entre dois segmentos se eles tiverem o mesmo ID. A polilinha é codificada usando o formato de algoritmo de polilinhas codificadas padrão da Plataforma Google Maps. |
Campo de união id . Usado para identificar este segmento dentro de um espaço de ID. Obrigatório. id pode ser apenas de um dos tipos a seguir: |
|
placeId |
O ID de lugar desse trecho de via. Usado em várias APIs. |
AnnotationOptions
Anotações solicitadas para os caminhos de entrada.
Representação JSON |
---|
{ "includeLevelOfService": boolean } |
Campos | |
---|---|
includeLevelOfService |
Opcional. Quando ela é definida como verdadeira, os segmentos da resposta são anotados com os valores de tráfego previstos. "Nível de serviço" é um termo geralmente usado para descrever a categorização do fluxo de tráfego, mas o nível das definições de serviço nesta API pertence somente a ela. |
AnnotatedPath
Uma cópia de um caminho de entrada retornado com atributos previstos.
Representação JSON |
---|
{
"annotatedSegments": [
{
object ( |
Campos | |
---|---|
annotatedSegments[] |
Uma lista ordenada de segmentos que formam o caminho principal, anotada com os atributos solicitados. |
AnnotatedSegment
Um segmento que cria um caminho, anotado com atributos de dados dinâmicos.
Representação JSON |
---|
{ "segment": { object ( |
Campos | |
---|---|
segment |
Detalhes usados para diferenciá-lo de outros segmentos. |
segmentSpanAttributes[] |
São os atributos atribuídos ao trecho. Esses atributos podem variar de acordo com o caminho em que o segmento está. Um período pode abranger todo o segmento. Os vãos dos atributos vão estar em ordem progressiva, do local do veículo até o fim do caminho. |
SegmentSpanAttribute
Um SegmentSpanAttribute contém as anotações retornadas da API.
Representação JSON |
---|
{ "segmentSpan": { object ( |
Campos | |
---|---|
segmentSpan |
Descreve onde as anotações se aplicam no segmento. |
levelOfService |
O nível de tráfego previsto para a extensão do trecho, definido pelas velocidades de trânsito esperadas nesse trecho quando o veículo chega no início dele. |
SegmentSpan
Usado para delimitar uma subseção de um trecho. Se um período cobrir todo o segmento, startMeters será 0 e endMeters será o comprimento do trecho.
Representação JSON |
---|
{ "startMeters": integer, "endMeters": integer } |
Campos | |
---|---|
startMeters |
Onde o início do período é a partir do ponto inicial da polilinha do segmento. |
endMeters |
O ponto final do período é a partir do ponto inicial da polilinha do segmento. |
LevelOfService
Valores previstos do bucket de tráfego, a serem usados para a funcionalidade do ADAS, que mapeiam os níveis gerais de tráfego. Os valores retornados por essa API são independentes e não devem corresponder a outras APIs.
Enums | |
---|---|
LEVEL_OF_SERVICE_UNSPECIFIED |
Valor padrão. Esse valor significa que não há valor de tráfego previsto disponível. |
LEVEL_OF_SERVICE_STOPPED |
O tráfego foi interrompido. |
LEVEL_OF_SERVICE_STOP_AND_GO |
O trânsito está indo embora. |
LEVEL_OF_SERVICE_SLOW |
Há previsão de lentidão, mas não há engarrafamentos. |
LEVEL_OF_SERVICE_NORMAL |
Velocidade normal, nenhuma lentidão prevista. |