Package maps.fleetengine.delivery.v1

DeliveryRequestHeader

Opcional. O cabeçalho de solicitação padrão da API Delivery. Observação: se você definir esse campo, o campo de cabeçalho nas mensagens CreateTaskRequest precisará estar vazio ou corresponder a esse campo.

string

Obrigatório. O recurso pai compartilhado por todas as tarefas. Esse valor precisa estar no formato providers/{provider}. O provider precisa ser o ID do projeto do Google Cloud. Por exemplo, sample-cloud-project. O campo pai nas mensagens CreateTaskRequest precisa estar vazio ou corresponder a esse campo.

CreateTaskRequest

Obrigatório. A mensagem de solicitação que especifica os recursos a serem criados. Observação: é possível criar no máximo 500 tarefas em um lote.

Task

As tarefas criadas.

DeliveryRequestHeader

Opcional. O cabeçalho de solicitação padrão da API Delivery.

string

Obrigatório. Precisa estar no formato providers/{provider}. O provedor precisa ser o ID do projeto do Google Cloud. Por exemplo, sample-cloud-project.

string

Obrigatório. O ID do veículo de entrega precisa ser exclusivo e estar sujeito às seguintes restrições:

• Precisa ser uma string Unicode válida.
• Limitado a um tamanho máximo de 64 caracteres.
• Normalizado de acordo com o Formulário de normalização C do Unicode.
• Não pode conter os seguintes caracteres ASCII: "/", ':', '?', ',' ou '#'.

DeliveryVehicle

Obrigatório. A entidade DeliveryVehicle a ser criada. Ao criar um novo veículo de entrega, você pode definir os seguintes campos opcionais:

• tipo
• last_location
• Atributos

Observação: o campo name do DeliveryVehicle é ignorado. Todos os outros campos de DeliveryVehicle não precisam ser definidos. Caso contrário, um erro será retornado.

DeliveryRequestHeader

Opcional. O cabeçalho de solicitação padrão da API Delivery.

string

Obrigatório. Precisa estar no formato providers/{provider}. O provider precisa ser o ID do projeto do Google Cloud. Por exemplo, sample-cloud-project.

string

Obrigatório. O ID da tarefa precisa ser exclusivo, mas não pode ser um ID de rastreamento de frete. Para armazenar um ID de rastreamento de frete, use o campo tracking_id. Várias tarefas podem ter o mesmo tracking_id. Os IDs de tarefas estão sujeitos às seguintes restrições:

• Precisa ser uma string Unicode válida.
• Limitado a um comprimento máximo de 64 caracteres.
• Normalizado de acordo com o Formulário C de normalização Unicode.
• Não pode conter nenhum dos seguintes caracteres ASCII: '/', ':', '?', ',' ou '#'.

Task

Obrigatório. A entidade Task a ser criada. Ao criar uma tarefa, os seguintes campos são obrigatórios:

• type
• state (precisa ser definido como OPEN)
• tracking_id: não pode ser definido para tarefas UNAVAILABLE ou SCHEDULED_STOP, mas é obrigatório para todos os outros tipos de tarefa.
• planned_location (opcional para tarefas UNAVAILABLE)
• task_duration

Observação: o campo name da tarefa é ignorado. Todos os outros campos da tarefa não podem ser definidos. Caso contrário, um erro será retornado.

string

O código de idioma BCP-47, como "pt-BR" ou "en-US". Para mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Se nenhum for especificado, a resposta poderá ser em qualquer idioma, com preferência pelo inglês, se esse nome existir. Exemplo de valor do campo: en-US.

string

Obrigatório. Código regional CLDR da região de origem da solicitação. Exemplo de valor do campo: US.

string

Versão do SDK de chamada, se aplicável. O formato da versão é "major.minor.patch", por exemplo: 1.1.2.

string

Versão do sistema operacional em que o SDK de chamada está sendo executado. Exemplos de valor de campo: 4.4.1, 12.1.

string

Modelo do dispositivo em que o SDK de chamada está sendo executado. Exemplos de valor de campo: iPhone12,1, SM-G920F.

SdkType

O tipo de SDK que envia a solicitação.

string

Versão do MapSDK da qual o SDK de chamada depende, se aplicável. O formato da versão é "major.minor.patch", por exemplo: 5.2.1.

string

Versão do NavSDK da qual o SDK de chamada depende, se aplicável. O formato da versão é "major.minor.patch", exemplo: 2.1.0.

Platform

Plataforma do SDK que faz a chamada.

string

Fabricante do dispositivo Android do SDK de chamada, aplicável apenas para SDKs do Android. Exemplo de valor do campo: Samsung.

int32

Nível da API do Android do SDK de chamada, aplicável apenas a SDKs do Android. Exemplo de valor do campo: 23.

string

ID opcional que pode ser fornecido para fins de registro, a fim de identificar a solicitação.

string

O nome exclusivo desse veículo de entrega. O formato é providers/{provider}/deliveryVehicles/{vehicle}.

DeliveryVehicleLocation

O último local relatado do veículo de entrega.

DeliveryVehicleNavigationStatus

O status de navegação do veículo de entrega.

bytes

A poligonal codificada que especifica a rota que a navegação recomenda para o próximo ponto de passagem. O app do motorista atualiza essa informação quando uma parada é alcançada ou ultrapassada e quando a navegação é redirecionada. Esses LatLngs são retornados em Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) ou Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) para todas as tarefas ativas atribuídas ao veículo.

Há alguns casos em que esse campo pode não ser usado para preencher Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) ou Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST):

• O endpoint do current_route_segment não corresponde a DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) ou DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST).

• O app do motorista não atualizou a localização recentemente. Por isso, o valor da última atualização desse campo pode estar desatualizado.

• O app do motorista atualizou o local recentemente, mas o current_route_segment está desatualizado e aponta para uma parada anterior do veículo.

Nesses casos, o Fleet Engine preenche esse campo com um trajeto desde o VehicleStop enviado mais recentemente até o próximo VehicleStop para garantir que o consumidor desse campo tenha as melhores informações disponíveis sobre o caminho atual do veículo de entrega.

LatLng

O local em que o current_route_segment termina. No momento, esse campo não é preenchido pelo app do motorista, mas você pode fornecê-lo em chamadas UpdateDeliveryVehicle. É a LatLng da próxima parada do veículo ou a última LatLng do current_route_segment. O Fleet Engine vai fazer o possível para interpolar para um VehicleStop real.

Esse campo é ignorado em chamadas UpdateDeliveryVehicle se o campo current_route_segment estiver vazio.

Int32Value

A distância de carro restante do percurso current_route_segment. O app Driver geralmente fornece esse campo, mas há algumas circunstâncias em que o Fleet Engine substitui o valor enviado pelo app. Para mais informações, consulte DeliveryVehicle.current_route_segment. Esse campo é retornado em Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) ou Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) para todos os Tasks ativos atribuídos ao veículo de entrega.

O Fleet Engine vai ignorar esse campo em UpdateDeliveryVehicleRequest se o campo current_route_segment estiver vazio.

Duration

O tempo restante de viagem para o current_route_segment. O app Driver geralmente fornece esse campo, mas há algumas circunstâncias em que o Fleet Engine substitui o valor enviado pelo app. Para mais informações, consulte DeliveryVehicle.current_route_segment. Esse campo é retornado em Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) ou Task.remainingVehicleJourneySegments[0].drivingDuration (REST) para todas as tarefas ativas atribuídas ao veículo de entrega.

O Fleet Engine vai ignorar esse campo em UpdateDeliveryVehicleRequest se o campo current_route_segment estiver vazio.

VehicleJourneySegment

Os segmentos de viagem atribuídos a esse veículo de entrega, começando pelo local mais recente informado. Esse campo não será preenchido na resposta de ListDeliveryVehicles.

DeliveryVehicleAttribute

Uma lista de atributos personalizados do veículo de entrega. Um veículo de entrega pode ter no máximo 100 atributos, e cada atributo precisa ter uma chave exclusiva.

DeliveryVehicleType

O tipo do veículo de entrega. Se não for definido, o padrão será AUTO.

string

A chave do atributo.

string

O valor do atributo.

string

Valor de atributo digitado em string.

Observação: esse campo é idêntico ao value, que será descontinuado. Para métodos de criação ou atualização, qualquer campo pode ser usado, mas é altamente recomendável usar string_value. Se string_value e value forem definidos, eles precisarão ser idênticos ou um erro será gerado. Ambos os campos são preenchidos nas respostas.

bool

Valor de atributo do tipo booleano.

double

Valor de atributo com dois tipos.

LatLng

O local do veículo. Quando enviado ao Fleet Engine, o local do veículo é um local de GPS. Quando você receber a resposta, o local do veículo poderá ser um local do GPS, um local complementar ou algum outro local aproximado. A fonte é especificada em location_sensor.

DoubleValue

Descontinuado: use latlng_accuracy.

DoubleValue

Precisão de location em metros como raio.

Int32Value

Direção em que o veículo está se movendo em graus. 0 representa o norte. O intervalo válido é [0, 360].

DoubleValue

Descontinuado: use heading_accuracy.

DoubleValue

Precisão de heading em graus.

DoubleValue

Altitude em metros acima do WGS84.

DoubleValue

Descontinuado: use altitude_accuracy.

DoubleValue

Precisão de altitude em metros.

Int32Value

Velocidade do veículo em quilômetros por hora. Descontinuado: use speed.

DoubleValue

Velocidade do veículo em metros por segundo

DoubleValue

Precisão de speed em metros/segundo.

Timestamp

O horário em que o location foi informado pelo sensor de acordo com o relógio do sensor.

Timestamp

Apenas saída. A hora em que o servidor recebeu as informações de local.

DeliveryVehicleLocationSensor

Provedor de dados de local (por exemplo, GPS).

BoolValue

Indica se location está fixado a uma via.

BoolValue

Somente entrada. Indica se o sensor de GPS está ativado no dispositivo móvel.

Int32Value

Somente entrada. Tempo (em segundos) desde que esse local foi enviado pela primeira vez ao servidor. Esse valor será zero para a primeira atualização. Se o horário for desconhecido (por exemplo, quando o app for reiniciado), esse valor será redefinido para zero.

Int32Value

Somente entrada. Obsoleto: outros indicadores agora são usados para determinar se um local está desatualizado.

LatLng

Local do veículo bruto (não processado pelo road-snapper).

Timestamp

Carimbo de data/hora associado ao local bruto.

DeliveryVehicleLocationSensor

Origem do local bruto. O valor padrão é GPS.

DoubleValue

Precisão de raw_location como um raio, em metros.

LatLng

Localização complementar fornecida pelo app de integração.

Timestamp

Carimbo de data/hora associado ao local complementar.

DeliveryVehicleLocationSensor

Origem do local complementar. O valor padrão é CUSTOMER_SUPPLIED_LOCATION.

DoubleValue

Precisão de supplemental_location como um raio, em metros.

bool

Descontinuado: use is_road_snapped.

DeliveryRequestHeader

Opcional. O cabeçalho de solicitação padrão da API Delivery.

string

Obrigatório. Precisa estar no formato providers/{provider}/deliveryVehicles/{delivery_vehicle}. O provider precisa ser o ID do projeto do Google Cloud. Por exemplo, sample-cloud-project.

DeliveryRequestHeader

Opcional. O cabeçalho de solicitação padrão da API Delivery.

string

Obrigatório. Precisa estar no formato providers/{provider}/tasks/{task}. O provider precisa ser o ID do projeto do Google Cloud. Por exemplo, sample-cloud-project.

DeliveryRequestHeader

Opcional. O cabeçalho de solicitação padrão da API Delivery.

string

Obrigatório. Precisa estar no formato providers/{provider}/taskTrackingInfo/{tracking_id}. O provider precisa ser o ID do projeto do Google Cloud, e o tracking_id precisa ser o ID de rastreamento associado à tarefa. Um exemplo de nome pode ser providers/sample-cloud-project/taskTrackingInfo/sample-tracking-id.

DeliveryRequestHeader

Opcional. O cabeçalho de solicitação padrão da API Delivery.

string

Obrigatório. Precisa estar no formato providers/{provider}. O provider precisa ser o ID do projeto do Google Cloud. Por exemplo, sample-cloud-project.

int32

Opcional. O número máximo de veículos a serem retornados. O serviço pode retornar menos que esse valor. Se você não especificar esse número, o servidor vai determinar o número de resultados a serem retornados.

string

Opcional. Um token de página recebido de uma chamada ListDeliveryVehicles anterior. Você precisa fornecer isso para recuperar a página seguinte.

Ao paginar, todos os outros parâmetros fornecidos para ListDeliveryVehicles precisam corresponder à chamada que forneceu o token da página.

string

Opcional. Uma consulta de filtro a ser aplicada ao listar veículos de entrega. Consulte http://aip.dev/160 para conferir exemplos da sintaxe de filtro. Se você não especificar um valor ou uma string vazia para o filtro, todos os veículos de entrega serão retornados.

As únicas consultas compatíveis com ListDeliveryVehicles são em atributos de veículo (por exemplo, attributes.<key> = <value> ou attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Além disso, todos os atributos são armazenados como strings. Portanto, as únicas comparações compatíveis com atributos são comparações de string. Para comparar com valores numéricos ou booleanos, os valores precisam ser citados explicitamente para serem tratados como strings (por exemplo, attributes.<key> = "10" ou attributes.<key> = "true").

O número máximo de restrições permitido em uma consulta de filtro é 50. Uma restrição faz parte da consulta do formulário attribute.<KEY> <COMPARATOR> <VALUE>. Por exemplo, attributes.foo = bar é uma restrição.

Viewport

Opcional. Um filtro que limita os veículos retornados àqueles cujo último local conhecido estava na área retangular definida pelo viewport.

DeliveryVehicle

O conjunto de veículos de entrega que atende aos critérios de filtragem solicitados. Quando nenhum filtro é especificado, a solicitação retorna todos os veículos de entrega. Uma resposta bem-sucedida também pode estar vazia. Uma resposta vazia indica que nenhum veículo de entrega foi encontrado que atenda aos critérios de filtro solicitados.

string

É possível transmitir esse token no ListDeliveryVehiclesRequest para continuar a listar os resultados. Quando todos os resultados forem retornados, esse campo não vai estar na resposta ou será uma string vazia.

int64

O número total de veículos de entrega que correspondem aos critérios de solicitação em todas as páginas.

DeliveryRequestHeader

Opcional. O cabeçalho de solicitação padrão da API Delivery.

string

Obrigatório. Precisa estar no formato providers/{provider}. O provider precisa ser o ID do projeto do Google Cloud. Por exemplo, sample-cloud-project.

int32

Opcional. O número máximo de tarefas a serem retornadas. O serviço pode retornar menos que esse valor. Se você não especificar esse valor, o servidor vai determinar o número de resultados a serem retornados.

string

Opcional. Um token de página recebido de uma chamada ListTasks anterior. Você pode fornecer isso para recuperar a página seguinte.

Ao paginar, todos os outros parâmetros fornecidos para ListTasks precisam corresponder à chamada que forneceu o token da página.

string

Opcional. Uma consulta de filtro para aplicar ao listar tarefas. Consulte http://aip.dev/160 para conferir exemplos de sintaxe de filtro. Se você não especificar um valor ou filtrar uma string vazia, todas as tarefas serão retornadas. Para saber mais sobre as propriedades de tarefas que podem ser filtradas, consulte Listar tarefas.

Task

Conjunto de tarefas que atendem aos critérios de filtragem solicitados. Quando nenhum filtro é especificado, a solicitação retorna todas as tarefas. Uma resposta bem-sucedida também pode estar vazia. Uma resposta vazia indica que nenhuma tarefa foi encontrada que atenda aos critérios de filtro solicitados.

string

Transmita esse token no ListTasksRequest para continuar listando os resultados. Se todos os resultados tiverem sido retornados, esse campo será uma string vazia ou não aparecerá na resposta.

int64

O número total de tarefas que correspondem aos critérios de solicitação em todas as páginas.

LatLng

As coordenadas do local.

string

Precisa estar no formato providers/{provider}/tasks/{task}.

Type

Obrigatório. Imutável. Define o tipo da tarefa. Por exemplo, uma pausa ou um envio.

State

Obrigatório. O estado de execução atual da tarefa.

TaskOutcome

O resultado da Tarefa.

Timestamp

O carimbo de data/hora que indica quando o resultado do Task foi definido pelo provedor.

LocationInfo

O local em que o resultado do Task foi definido. Esse valor é atualizado como parte do UpdateTask. Se esse valor não for atualizado explicitamente pelo provedor, o Fleet Engine vai preenchê-lo por padrão com o último local conhecido do veículo (o local bruto).

TaskOutcomeLocationSource

Indica a origem do valor de task_outcome_location.

string

Imutável. Esse campo facilita o armazenamento de um ID para que você evite usar um mapeamento complicado. Não é possível definir tracking_id para Tarefas do tipo UNAVAILABLE e SCHEDULED_STOP. Esses IDs estão sujeitos às seguintes restrições:

• Precisa ser uma string Unicode válida.
• Limitado a um comprimento máximo de 64 caracteres.
• Normalizado de acordo com o Formulário de normalização C do Unicode.
• Não pode conter nenhum dos seguintes caracteres ASCII: '/', ':', '?', ',' ou '#'.

string

Apenas saída. O ID do veículo que está executando essa tarefa. Os IDs dos veículos de entrega estão sujeitos às seguintes restrições:

• Precisa ser uma string Unicode válida.
• Limitado a um comprimento máximo de 64 caracteres.
• Normalizado de acordo com o Formulário de normalização C do Unicode.
• Não pode conter os seguintes caracteres ASCII: "/", ':', '?', ',' ou '#'.

LocationInfo

Imutável. O local em que a tarefa será concluída. Opcional para tarefas UNAVAILABLE, mas obrigatório para todas as outras tarefas.

Duration

Obrigatório. Imutável. O tempo necessário para executar uma tarefa nesse local.

TimeWindow

Janela de tempo em que a tarefa precisa ser concluída.

JourneySharingInfo

Apenas saída. Campos específicos para compartilhamento de jornadas. Não é preenchido quando o estado é CLOSED.

TaskTrackingViewConfig

A configuração para o acompanhamento de tarefas que especifica quais elementos de dados são visíveis para os usuários finais e em quais circunstâncias.

TaskAttribute

Uma lista de atributos de tarefas personalizados. Cada atributo precisa ter uma chave exclusiva.

VehicleJourneySegment

Informações de rastreamento das paradas que o veículo atribuído fará antes de concluir esta Tarefa. Essa lista pode conter paradas de outras tarefas.

O primeiro segmento, Task.journey_sharing_info.remaining_vehicle_journey_segments[0] (gRPC) ou Task.journeySharingInfo.remainingVehicleJourneySegments[0] (REST), contém informações de trajeto do último local conhecido do motorista até o próximo VehicleStop. As informações da rota atual geralmente vêm do app do motorista, exceto em alguns casos indicados na documentação de DeliveryVehicle.current_route_segment. Os outros segmentos em Task.journey_sharing_info.remaining_vehicle_journey_segments (gRPC) ou Task.journeySharingInfo.remainingVehicleJourneySegments (REST) são preenchidos pelo Fleet Engine. Eles fornecem informações de rota entre os VehicleStops restantes.

DeliveryVehicleLocation

Indica o último local informado do veículo atribuído.

bool

Indica se o lastLocation do veículo pode ser vinculado ao current_route_segment. Esse valor é falso se last_location ou current_route_segment não existirem. Esse valor é calculado pelo Fleet Engine. As atualizações dos clientes são ignoradas.

string

A chave do atributo. As chaves não podem conter dois-pontos (:).

string

Valor de atributo digitado em string.

bool

Valor de atributo do tipo booleano.

double

Valor do atributo com digitação dupla.

string

Precisa estar no formato providers/{provider}/taskTrackingInfo/{tracking}, em que tracking representa o ID de acompanhamento.

string

Imutável. O ID de acompanhamento de uma tarefa. * Precisa ser uma string Unicode válida. * Limitado a um comprimento máximo de 64 caracteres. * Normalizado de acordo com o Formulário de normalização C do Unicode. * Não pode conter nenhum dos seguintes caracteres ASCII: '/', ':', '?', ',' ou '#'.

DeliveryVehicleLocation

O último local do veículo.

LatLng

Uma lista de pontos que, quando conectados, formam uma polilinha do trajeto esperado do veículo até o local da tarefa.

Int32Value

Indica o número de paradas que o veículo resta até a parada da tarefa ser alcançada, incluindo a parada da tarefa. Por exemplo, se a próxima parada do veículo for a parada da tarefa, o valor será 1.

Int32Value

A distância total restante em metros até o VehicleStop de interesse.

Timestamp

O carimbo de data/hora que indica o horário estimado de chegada até o local da parada.

Timestamp

O carimbo de data/hora que indica o tempo de conclusão estimado de uma tarefa.

State

O estado de execução atual da tarefa.

TaskOutcome

O resultado da tentativa de executar uma tarefa.

Timestamp

O carimbo de data/hora que indica quando o resultado da tarefa foi definido pelo provedor.

LocationInfo

Imutável. O local em que a tarefa será concluída.

TimeWindow

A janela de tempo em que a tarefa deve ser concluída.

TaskAttribute

Os atributos personalizados definidos na tarefa.

VisibilityOption

O campo que especifica quando os pontos da polilinha do trajeto podem ficar visíveis. Se esse campo não for especificado, a configuração de visibilidade padrão no nível do projeto para esses dados será usada.

VisibilityOption

Campo que especifica quando o horário de chegada estimado pode ser mostrado. Se esse campo não for especificado, a configuração de visibilidade padrão no nível do projeto para esses dados será usada.

VisibilityOption

Campo que especifica quando o tempo estimado para a conclusão da tarefa pode ficar visível. Se esse campo não for especificado, a configuração de visibilidade padrão no nível do projeto para esses dados será usada.

VisibilityOption

Campo que especifica quando a distância restante da viagem pode ser mostrada. Se este campo não for especificado, será usada a configuração de visibilidade padrão para esses dados no nível do projeto.

VisibilityOption

Campo que especifica quando a contagem de paradas restantes pode ser visível. Se esse campo não for especificado, a configuração de visibilidade padrão no nível do projeto para esses dados será usada.

VisibilityOption

Campo que especifica quando a localização do veículo pode ficar visível. Se esse campo não for especificado, a configuração de visibilidade padrão no nível do projeto para esses dados será usada.

int32

Esse elemento de dados fica visível para os usuários finais se a contagem de paradas restante for <= remaining_stop_count_threshold.

Duration

Esse elemento de dados fica visível para os usuários finais se o ETA até a parada for <= duration_until_estimated_arrival_time_threshold.

int32

Esse elemento de dados vai ficar visível para os usuários finais se a distância de carro restante em metros <= legacy_driving_distance_meters_threshold.

bool

Se definido como "true", esse elemento de dados fica sempre visível para os usuários finais sem limites. Este campo não pode ser definido como falso.

bool

Se definido como "true", esse elemento de dados fica sempre oculto dos usuários finais sem limites. Este campo não pode ser definido como falso.

Timestamp

Obrigatório. Horário de início do período.

Timestamp

Obrigatório. O horário de término da janela (inclusive).

DeliveryRequestHeader

Opcional. O cabeçalho de solicitação padrão da API Delivery.

DeliveryVehicle

Obrigatório. A atualização da entidade DeliveryVehicle a ser aplicada. Observação: não é possível atualizar o nome de DeliveryVehicle.

FieldMask

Obrigatório. Uma máscara de campo que indica quais campos DeliveryVehicle serão atualizados. A máscara de atualização precisa conter pelo menos um campo.

É uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "remaining_vehicle_journey_segments".

DeliveryRequestHeader

Opcional. O cabeçalho de solicitação padrão da API Delivery.

Task

Obrigatório. A tarefa associada à atualização. Os campos a seguir são mantidos pelo Fleet Engine. Não atualize usando Task.update.

• last_location.
• last_location_snappable.
• name.
• remaining_vehicle_journey_segments.
• task_outcome_location_source.

Observação: não é possível mudar o valor de task_outcome depois de definir.

Se a tarefa foi atribuída a um veículo de entrega, não defina o estado dela como "CONCLUÍDA" usando Task.update. Em vez disso, remova o VehicleStop que contém a tarefa do veículo de entrega, o que define automaticamente o estado da tarefa como "CONCLUÍDA".

FieldMask

Obrigatório. A máscara de campo que indica quais campos da tarefa serão atualizados. Observação: o update_mask precisa conter pelo menos um campo.

É uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "task_outcome,task_outcome_time,task_outcome_location".

VehicleStop

Especifica o local da parada e as Tasks associadas a ela. Alguns campos da VehicleStop podem não estar presentes se esse segmento de viagem fizer parte de JourneySharingInfo.

Int32Value

Apenas saída. A distância percorrida da parada anterior até essa parada. Se a parada atual for a primeira da lista de segmentos da viagem, o ponto de partida será o local do veículo registrado no momento em que essa parada foi adicionada à lista. Este campo pode não estar presente se o segmento da jornada fizer parte de JourneySharingInfo.

Duration

Apenas saída. O tempo de viagem da parada anterior até essa parada. Se a parada atual for a primeira na lista de segmentos da viagem, o ponto de partida será a localização do veículo registrada no momento em que essa parada foi adicionada à lista.

Se esse campo for definido no caminho Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) ou Task.remainingVehicleJourneySegments[0].drivingDuration (REST), ele poderá ser preenchido com o valor de DeliveryVehicle.remaining_duration (gRPC) ou DeliveryVehicle.remainingDuration (REST). Isso mostra a duração restante da viagem a partir do local conhecido mais recente do app do motorista, em vez do tempo de viagem da parada anterior.

LatLng

Apenas saída. O caminho da parada anterior até essa parada. Se a parada atual for a primeira na lista de segmentos da jornada, esse será o caminho do local atual do veículo até essa parada no momento em que ela foi adicionada à lista. Este campo pode não estar presente se o segmento da jornada fizer parte de JourneySharingInfo.

Se esse campo for definido no caminho Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) ou Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST), ele poderá ser preenchido com os LatLngs decodificados de DeliveryVehicle.current_route_segment (gRPC) ou DeliveryVehicle.currentRouteSegment (REST). Ele fornece o caminho usando o local conhecido mais recente do app do motorista em vez do caminho da parada anterior.

LocationInfo

Obrigatório. O local da parada. Os locais nos Tasks podem não corresponder exatamente a esse local, mas estarão a uma curta distância dele. Esse campo não será preenchido na resposta de uma chamada de GetTask.

TaskInfo

Lista de Tasks a serem executados nessa parada. Esse campo não será preenchido na resposta de uma chamada GetTask.

State

O estado da VehicleStop. Esse campo não será preenchido na resposta de uma chamada GetTask.

string

O ID da tarefa. Esse campo não será preenchido na resposta de uma chamada GetTask. Os IDs de tarefas estão sujeitos às seguintes restrições:

• Precisa ser uma string Unicode válida.
• Limitado a um comprimento máximo de 64 caracteres.
• Normalizado de acordo com o Formulário de normalização C do Unicode.
• Não pode conter nenhum dos seguintes caracteres ASCII: '/', ':', '?', ',' ou '#'.

Duration

Apenas saída. O tempo necessário para realizar a tarefa.

TimeWindow

Apenas saída. A janela de tempo em que a tarefa deve ser concluída. Isso é definido apenas na resposta a GetDeliveryVehicle.