Package google.maps.roads.selection.v1

Índice

RoadsSelection

Definição de serviço da API Roads Selection.

BatchCreateSelectedRoutes

rpc BatchCreateSelectedRoutes(BatchCreateSelectedRoutesRequest) returns (BatchCreateSelectedRoutesResponse)

Cria várias SelectedRoutes e inicia uma programação para recuperar periodicamente informações de cache de cada uma das rotas.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform
CreateSelectedRoute

rpc CreateSelectedRoute(CreateSelectedRouteRequest) returns (SelectedRoute)

Cria um SelectedRoute e inicia uma programação para recuperar periodicamente informações de cache da rota.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform
DeleteSelectedRoute

rpc DeleteSelectedRoute(DeleteSelectedRouteRequest) returns (Empty)

Exclui o SelectedRoute especificado para o projeto especificado.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform
GetSelectedRoute

rpc GetSelectedRoute(GetSelectedRouteRequest) returns (SelectedRoute)

Recebe um SelectedRoute conforme especificado pelo nome.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform
ListSelectedRoutes

rpc ListSelectedRoutes(ListSelectedRoutesRequest) returns (ListSelectedRoutesResponse)

Lista todas as SelectedRoutes do projeto especificado com paginação.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

BatchCreateSelectedRoutesRequest

Solicitação para criar vários SelectedRoutes.

Campos
parent

string

Opcional. O recurso de projeto compartilhado por todas as rotas selecionadas. Formato: projects/{project}. Se este campo estiver definido, o campo "parent" nas mensagens "CreateSelectedRouteRequest" precisará estar vazio ou corresponder a este campo.

requests[]

CreateSelectedRouteRequest

Obrigatório. A mensagem de solicitação que especifica a rota selecionada a ser criada. É possível criar no máximo 1.000 rotas selecionadas em um lote.

BatchCreateSelectedRoutesResponse

Resposta da criação de várias SelectedRoutes.

Campos
selected_routes[]

SelectedRoute

SelectedRoutes criado.

CreateSelectedRouteRequest

Solicitação para criar um SelectedRoute.

Campos
parent

string

Obrigatório. O projeto em que o SelectedRoute será criado. Formato: projects/{project}

selected_route

SelectedRoute

Obrigatório. O SelectedRoute a ser criado.

selected_route_id

string

Opcional. O ID a ser usado para o SelectedRoute, que se tornará o componente final do nome do recurso do SelectedRoute.

Esse valor precisa ter de 4 a 63 caracteres, e os caracteres válidos são: "a-z", "A-Z", "0-9" ou "-". Se ele não for fornecido ou estiver vazio, um UUID será gerado após a criação do recurso.

DeleteSelectedRouteRequest

Solicitação para excluir um SelectedRoute.

Campos
name

string

Obrigatório. O nome do SelectedRoute a ser excluído. Formato: projects/{project}/selectedRoutes/{selected_route}

GetSelectedRouteRequest

Solicitação para receber um SelectedRoute.

Campos
name

string

Obrigatório. O nome do SelectedRoute a ser recuperado. Formato: projects/{project}/selectedRoutes/{selected_route}

ListSelectedRoutesRequest

Solicitação para listar SelectedRoutes.

Campos
parent

string

Obrigatório. O pai, que é o projeto de onde todos os SelectedRoutes serão consultados. Formato: projects/{project}/selectedRoutes

page_size

int32

Opcional. O número de resultados que devem ser retornados para uma determinada página. Se não for definido, o valor padrão será 100. Quando um valor de 0 é fornecido, ele é definido como o padrão. O valor máximo é 5.000. Qualquer valor acima disso será definido como 5.000.

page_token

string

Opcional. Um token de página recebido de uma chamada ListSelectedRoutes anterior.

ListSelectedRoutesResponse

Resposta que lista SelectedRoutes.

Campos
selected_routes[]

SelectedRoute

Uma página de SelectedRoutes armazenada no projeto especificado na solicitação.

next_page_token

string

Token que pode ser enviado como page_token para recuperar a próxima página. Se esse campo estiver vazio, não haverá páginas subsequentes.

SelectedRoute

Um SelectedRoute representa uma rota específica para a qual um cliente quer recuperar informações periodicamente (por exemplo, duração) para casos de uso contratados.

Campos
name

string

Identificador. Nome do recurso do SelectedRoute.

Formato: projects/{project}/selectedRoutes/{selected_route}

display_name

string

Opcional. Nome de exibição da rota. Esse é um campo opcional que pode ser usado pelo cliente. Ele não precisa ser único.

create_time

Timestamp

Apenas saída. A hora em que a rota selecionada foi criada.

state

State

Apenas saída. O estado da rota selecionada.

route_attributes

map<string, string>

Opcional. Os atributos personalizados da rota selecionada. Ao adicioná-los, é possível filtrar / agrupar as rotas ao recuperar informações históricas e em tempo real. Até 10 atributos são aceitos por rota. Cada chave e valor precisa ser uma string não vazia e pode ter até 100 caracteres. As chaves não podem começar com "goog".

Campo de união route_type. No momento, apenas DynamicRoute é aceito. route_type pode ser apenas de um dos tipos a seguir:
dynamic_route

DynamicRoute

O SelectedRoute é uma rota dinâmica.

validation_error

ValidationError

Apenas saída. O erro de validação para a rota selecionada quando o estado é STATE_INVALID.

DynamicRoute

Representa uma rota com waypoints (origem, destino e intermediários). A rota real passa por todos os pontos de parada, mas pode mudar de tempos em tempos devido às variações nas condições de trânsito.

Campos
origin

LatLng

Obrigatório. Local de origem do trajeto.

destination

LatLng

Obrigatório. Local de término do trajeto.

intermediates[]

LatLng

Opcional. Um conjunto de pontos de referência intermediários ao longo do trajeto (excluindo os pontos finais). Eles são sempre pontos de passagem. É possível usar até 25 waypoints intermediários. Adicionar esses dados corretamente pode reduzir a variação do trajeto real ao longo do tempo.

Estado

O estado da rota selecionada.

Enums
STATE_UNSPECIFIED O estado desta rota não está definido.
STATE_SCHEDULING A rota foi criada e está sendo programada.
STATE_RUNNING A rota foi criada e tem uma programação ativa.
STATE_DELETING A rota foi marcada para exclusão.
STATE_VALIDATING A rota está em processo de validação.
STATE_INVALID A rota é inválida com base em um dos critérios de validação.

ValidationError

O erro de validação da rota selecionada.

Enums
VALIDATION_ERROR_UNSPECIFIED O erro de validação desta rota não está definido.
VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION A rota está fora da jurisdição do projeto.
VALIDATION_ERROR_LOW_ROAD_USAGE A rota tem baixo uso da via (muito poucas pessoas passam por ela).