Route Matrix (beta)

Classe RouteMatrix

Classe google.maps.routes.RouteMatrix

Uma matriz de rotas calculadas para um conjunto de pares de origem/destino por RouteMatrix.computeRouteMatrix.

Acesse ligando para const {RouteMatrix} = await google.maps.importLibrary("routes").
Consulte Bibliotecas na API Maps JavaScript.
computeRouteMatrix
computeRouteMatrix(request)
Parâmetros:
Valor de retorno:Promise<{matrix:RouteMatrix}>
Recebe uma lista de origens e destinos e retorna uma matriz com informações de trajeto para cada combinação de origem e destino.

Observação: esse método exige que você especifique uma máscara de campo de resposta na solicitação definindo a propriedade ComputeRouteMatrixRequest.fields. O valor é uma lista de caminhos de campo.

Por exemplo:
  • Máscara de campo de todos os campos disponíveis: fields: ['*']
  • Máscara de campo da duração e distância no nível da rota: fields: ['durationMillis', 'distanceMeters']

O uso da máscara de campo de resposta curinga fields: ['*'] não é recomendado porque:
  • Selecionar apenas os campos necessários ajuda nosso servidor a economizar ciclos de computação, permitindo que retornemos o resultado com uma latência menor.
  • Selecionar apenas os campos necessários no seu trabalho de produção garante uma performance de latência estável. Podemos adicionar mais campos de resposta no futuro, e esses novos campos podem exigir mais tempo de computação. Se você selecionar todos os campos ou todos os campos no nível superior, poderá ocorrer uma degradação da performance, porque qualquer novo campo adicionado será incluído automaticamente na resposta.
  • Selecionar apenas os campos necessários resulta em um tamanho de resposta menor e, portanto, um carregamento mais rápido na rede.
rows
As linhas da matriz. Cada linha corresponde a uma origem e contém uma matriz de RouteMatrixItems, cada um representando um trajeto até um destino.
toJSON
toJSON()
Parâmetros:nenhum
Valor de retorno:Object
Converte em um objeto.

Classe RouteMatrixRow

Classe google.maps.routes.RouteMatrixRow

Corresponde a uma origem transmitida para RouteMatrix.computeRouteMatrix. Contém uma lista de RouteMatrixItems, em que cada item representa um trajeto até um destino.

Acesse ligando para const {RouteMatrixRow} = await google.maps.importLibrary("routes").
Consulte Bibliotecas na API Maps JavaScript.
items
As informações de trajeto para cada destino.
toJSON
toJSON()
Parâmetros:nenhum
Valor de retorno:Object
Converte em um objeto.

Classe RouteMatrixItem

Classe google.maps.routes.RouteMatrixItem

Contém informações de trajeto calculadas para um par origem/destino transmitido para RouteMatrix.computeRouteMatrix.

Acesse ligando para const {RouteMatrixItem} = await google.maps.importLibrary("routes").
Consulte Bibliotecas na API Maps JavaScript.
condition
Indica se o trajeto foi encontrado ou não.
distanceMeters
Tipo:number optional
A distância percorrida do trajeto em metros.
durationMillis
Tipo:number optional
O tempo necessário para navegar pela rota em milissegundos. Se você definir ComputeRouteMatrixRequest.routingPreference como TRAFFIC_UNAWARE, esse valor será o mesmo que RouteMatrixItem.staticDurationMillis. Se você definir ComputeRouteMatrixRequest.routingPreference como TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL, esse valor será calculado considerando as condições de trânsito.

Observação: se a duração exceder 2^53 milissegundos, o valor será Number.POSITIVE_INFINITY.
error
Tipo:RouteMatrixItemError optional
Erro que ocorreu durante o cálculo da rota.
fallbackInfo
Tipo:FallbackInfo optional
Em alguns casos, quando o servidor não consegue calcular o trajeto com as preferências especificadas para um determinado par origem/destino, ele pode usar outro modo de cálculo. Quando um substituto é usado, esse campo contém informações detalhadas sobre a resposta substituta. Caso contrário, esse campo não será definido.
localizedValues
Representações de texto das propriedades do RouteMatrixItem.
staticDurationMillis
Tipo:number optional
A duração da viagem pelo trajeto sem considerar as condições de trânsito.

Observação: se a duração exceder 2^53 milissegundos, o valor será Number.POSITIVE_INFINITY.
travelAdvisory
Tipo:RouteTravelAdvisory optional
Informações adicionais sobre o trajeto.

Interface ComputeRouteMatrixRequest

Interface google.maps.routes.ComputeRouteMatrixRequest

Solicitação de uma matriz de rotas.
destinations
Matriz de destinos, que determina as colunas da matriz de resposta. Um valor transmitido como uma string pode ser um endereço, um código plus ou um nome de recurso de lugar. Os valores de altitude não são considerados.
fields
Tipo:Iterable<string>
Coleção de campos a serem buscados. Especifique ["*"] para todos os campos.
origins
Matriz de origens que determina as linhas da matriz de resposta. Um valor transmitido como uma string pode ser um endereço, um código plus ou um nome de recurso de lugar. Os valores de altitude não são considerados.

Várias restrições de tamanho se aplicam à cardinalidade de origens e destinos:
  • O número total de origens e destinos especificados como strings ou Places não pode ser maior que 50.
  • O produto do número de origens e destinos não pode ser maior que 625.
  • O produto do número de origens e destinos não pode ser maior que 100 se ComputeRouteMatrixRequest.routingPreference estiver definido como TRAFFIC_AWARE_OPTIMAL.
  • O produto do número de origens e destinos não pode ser maior que 100 se ComputeRouteMatrixRequest.travelMode estiver definido como TRANSIT.
arrivalTime optional
Tipo:Date optional
O horário de chegada.

Observação: só pode ser definido quando ComputeRouteMatrixRequest.travelMode estiver definido como TRANSIT. É possível especificar ComputeRouteMatrixRequest.departureTime ou ComputeRouteMatrixRequest.arrivalTime, mas não ambos. As viagens de transporte público estão disponíveis por até 7 dias no passado ou 100 dias no futuro.
departureTime optional
Tipo:Date optional
O horário de partida. Se você não definir esse valor, ele será definido como o horário em que você fez a solicitação.

Observação: só é possível especificar um horário no passado quando ComputeRouteMatrixRequest.travelMode está definido como TRANSIT. As viagens de transporte público estão disponíveis por até 7 dias no passado ou 100 dias no futuro.
extraComputations optional
Uma lista de cálculos extras que podem ser usados para concluir a solicitação.

Observação: esses cálculos extras podem retornar campos extras na resposta. Esses campos extras também precisam ser especificados em ComputeRouteMatrixRequest.fields para serem retornados na resposta.
language optional
Tipo:string optional
O código de idioma BCP-47, como "pt-BR" ou "en-US". Para saber mais, consulte Identificador de localidade Unicode. Consulte Suporte de idioma para conferir a lista de idiomas disponíveis. Quando você não fornece esse valor, o idioma é inferido das configurações de localização da API Google Maps JavaScript. Caso contrário, o idioma será inferido da localização da primeira origem.
region optional
Tipo:string optional
O código da região, especificado como um valor ccTLD ("domínio de nível superior") de dois caracteres. Para mais informações, consulte Domínios de nível superior de código de país. Quando você não fornece esse valor, a região é inferida das configurações de localização da API Google Maps JavaScript. Caso contrário, a região será inferida da localização da primeira origem.
routingPreference optional
Tipo:RoutingPreference optional
Especifica como calcular a matriz de rotas. O servidor tenta usar a preferência de roteamento selecionada para calcular a matriz de rotas. Se a preferência de roteamento resultar em um erro ou uma latência muito longa, um erro será retornado. Você só pode especificar essa opção quando ComputeRouteMatrixRequest.travelMode é DRIVING ou TWO_WHEELER. Caso contrário, a solicitação falha.
trafficModel optional
Tipo:TrafficModel optional
Especifica as proposições a serem usadas ao calcular o tempo no trânsito. Essa configuração afeta o valor retornado em RouteMatrixItem.durationMillis, que contém o tempo previsto no trânsito com base nas médias históricas. ComputeRouteMatrixRequest.trafficModel só está disponível para solicitações que definiram ComputeRouteMatrixRequest.routingPreference como TRAFFIC_AWARE_OPTIMAL e ComputeRouteMatrixRequest.travelMode como DRIVING. O padrão é BEST_GUESS.
transitPreference optional
Tipo:TransitPreference optional
Especifica preferências que influenciam a rota retornada para rotas TRANSIT.

Observação: só pode ser especificado quando ComputeRouteMatrixRequest.travelMode estiver definido como TRANSIT.
travelMode optional
Tipo:TravelMode optional
Especifica o meio de transporte.
units optional
Tipo:UnitSystem optional
Especifica as unidades de medida dos campos de exibição. Se você não fornecer esse valor, as unidades de exibição serão inferidas da localização da primeira origem.

Constantes ComputeRouteMatrixExtraComputation

Constantes de google.maps.routes.ComputeRouteMatrixExtraComputation

Computações extras a serem realizadas para uma solicitação de RouteMatrix.computeRouteMatrix.

Acesse ligando para const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes").
Consulte Bibliotecas na API Maps JavaScript.
TOLLS Informações sobre pedágios para os itens da matriz.

Constantes RouteMatrixItemCondition

Constantes de google.maps.routes.RouteMatrixItemCondition

A condição de um trajeto para um determinado par origem/destino.

Acesse ligando para const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes").
Consulte Bibliotecas na API Maps JavaScript.
ROUTE_EXISTS Um trajeto foi encontrado.
ROUTE_NOT_FOUND Nenhum trajeto foi encontrado.

Classe RouteMatrixItemError

Classe google.maps.routes.RouteMatrixItemError

Um erro que ocorreu durante RouteMatrix.computeRouteMatrix para um par origem/destino específico.

Essa classe estende Error.

Acesse ligando para const {RouteMatrixItemError} = await google.maps.importLibrary("routes").
Consulte Bibliotecas na API Maps JavaScript.
toJSON
toJSON()
Parâmetros:nenhum
Valor de retorno:Object
Converte em um objeto.

Classe RouteMatrixItemLocalizedValues

Classe google.maps.routes.RouteMatrixItemLocalizedValues

Representações de texto do RouteMatrixItem.

Acesse ligando para const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes").
Consulte Bibliotecas na API Maps JavaScript.
distance
Tipo:string optional
Distância percorrida do item da matriz de rotas em formato de texto.
distanceLanguage
Tipo:string optional
O código de idioma BCP-47 do texto de distância, como "en-US" ou "sr-Latn".

Para mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
duration
Tipo:string optional
Duração, representada em formato de texto e localizada na região da consulta. Considera as condições de trânsito.

Observação: se você não solicitou informações de trânsito, esse valor é o mesmo que RouteMatrixItemLocalizedValues.staticDuration.
durationLanguage
Tipo:string optional
O código de idioma BCP-47 do texto de duração, como "en-US" ou "sr-Latn".

Para mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
staticDuration
Tipo:string optional
Duração sem considerar as condições de trânsito, representada em formato de texto.
staticDurationLanguage
Tipo:string optional
O código de idioma BCP-47 do texto de duração estática, como "en-US" ou "sr-Latn".
transitFare
Tipo:string optional
Tarifa de transporte público, representada em formato de texto.
transitFareLanguage
Tipo:string optional
O código de idioma BCP-47 do texto da tarifa de transporte público, como "en-US" ou "sr-Latn".

Para mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
toJSON
toJSON()
Parâmetros:nenhum
Valor de retorno:Object
Converte em um objeto.

Interface RouteMatrixOrigin

Interface google.maps.routes.RouteMatrixOrigin

Uma única origem para um ComputeRouteMatrixRequest.
waypoint
O local da origem. Um valor transmitido como uma string pode ser um endereço ou um código plus. Os valores de altitude não são considerados.
routeModifiers optional
Tipo:RouteModifiers optional
Modificadores para cada trajeto que usa esse local como origem.