Classe DirectionsService
Classe
google.maps.DirectionsService
Um serviço para calcular rotas entre dois ou mais lugares.
Acesse chamando const {DirectionsService} = await google.maps.importLibrary("routes")
. Consulte Bibliotecas na API Maps JavaScript.
Construtor | |
---|---|
DirectionsService |
DirectionsService() Parâmetros: nenhum
Cria uma nova instância de um DirectionsService que envia consultas de rotas para servidores do Google. |
Métodos | |
---|---|
route |
route(request[, callback]) Parâmetros:
Valor de retorno:
Promise<DirectionsResult> Envia uma solicitação de pesquisa de rota. |
DirectionsRequest
Interface
google.maps.DirectionsRequest
Uma consulta de rota a ser enviada ao DirectionsService
.
Propriedades | |
---|---|
destination |
Tipo:
string|LatLng|Place|LatLngLiteral Local de destino. Isso pode ser especificado como uma string a ser geocodificada, LatLng ou Place . Obrigatório. |
origin |
Tipo:
string|LatLng|Place|LatLngLiteral Local de origem. Isso pode ser especificado como uma string a ser geocodificada, LatLng ou Place . Obrigatório. |
travelMode |
Tipo:
TravelMode Tipo de rota solicitada. Obrigatório. |
avoidFerries optional |
Tipo:
boolean optional Se true , instrui o serviço Directions a evitar balsas sempre que possível. Opcional. |
avoidHighways optional |
Tipo:
boolean optional Se true , instrui o serviço Directions a evitar rodovias sempre que possível. Opcional. |
avoidTolls optional |
Tipo:
boolean optional Se true , instrui o serviço Directions a evitar vias com pedágio sempre que possível. Opcional. |
drivingOptions optional |
Tipo:
DrivingOptions optional Configurações que se aplicam apenas a solicitações em que travelMode é DRIVING . Este objeto não terá efeito em outros meios de transporte. |
language optional |
Tipo:
string optional Um identificador de idioma para o idioma em que os resultados devem ser retornados, quando possível. Consulte a lista de idiomas compatíveis. |
optimizeWaypoints optional |
Tipo:
boolean optional Se for definido como true , o DirectionsService tentará reordenar os waypoints intermediários fornecidos para minimizar o custo geral do trajeto. Se os waypoints estiverem otimizados, inspecione DirectionsRoute.waypoint_order na resposta para determinar a nova ordem. |
provideRouteAlternatives optional |
Tipo:
boolean optional Indica se trajetos alternativos devem ser fornecidos ou não. Opcional. |
region optional |
Tipo:
string optional Código de região utilizado como polarização para solicitações de geocodificação. O código regional aceita um valor de dois caracteres ccTLD ("domínio de nível superior"). A maioria dos códigos ccTLD é idêntica aos códigos ISO 3166-1, com algumas exceções notáveis. Por exemplo, o ccTLD do Reino Unido é "uk" ( .co.uk ), enquanto o código ISO 3166-1 é "gb" (tecnicamente para a entidade "Reino Unido da Grã-Bretanha e Irlanda do Norte"). |
transitOptions optional |
Tipo:
TransitOptions optional Configurações aplicadas apenas a solicitações em que travelMode é TRANSPORTE. Este objeto não terá efeito em outros meios de transporte. |
unitSystem optional |
Tipo:
UnitSystem optional Padrão:é o sistema de medidas usado no país de origem.
Sistema de medidas escolhido para ser usado ao exibir a distância. |
waypoints optional |
Tipo:
Array<DirectionsWaypoint> optional Matriz de pontos de referência intermediários. As rotas são calculadas da origem ao destino com base em cada waypoint nesta matriz. Consulte o guia do desenvolvedor para obter o número máximo permitido de waypoints. Não são permitidos waypoints nas rotas de transporte público. Opcional. |
Constantes DirectionsStatus
Constantes
google.maps.DirectionsStatus
O status retornado pelo DirectionsService
na conclusão de uma chamada para route()
. Especifique-as por valor ou usando o nome da constante. Por exemplo, 'OK'
ou google.maps.DirectionsStatus.OK
.
Acesse chamando const {DirectionsStatus} = await google.maps.importLibrary("routes")
. Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
INVALID_REQUEST |
O DirectionsRequest informado é inválido. |
MAX_WAYPOINTS_EXCEEDED |
Muitos DirectionsWaypoint s foram fornecidos no DirectionsRequest . Consulte o guia do desenvolvedor para obter o número máximo permitido de waypoints. |
NOT_FOUND |
Não foi possível geocodificar a origem, o destino ou algum ponto de referência. |
OK |
A resposta contém um DirectionsResult válido. |
OVER_QUERY_LIMIT |
A página web ultrapassou o limite de solicitações em um período muito curto. |
REQUEST_DENIED |
A página web não tem permissão para usar o serviço de rotas. |
UNKNOWN_ERROR |
Não foi possível processar uma solicitação de rota devido a um erro no servidor. Se você tentar novamente, a solicitação poderá dar certo. |
ZERO_RESULTS |
Nenhum trajeto foi encontrado entre a origem e o destino. |
DirectionsResult
Interface
google.maps.DirectionsResult
A resposta das rotas recuperada do servidor de rotas. É possível renderizá-los usando um DirectionsRenderer
ou analisar e renderizar esse objeto por conta própria. Você precisa mostrar os avisos e direitos autorais conforme descrito nos Termos de Serviço da Plataforma Google Maps. Apesar de esse resultado ser do tipo "JSON", ele não é estritamente JSON, já que inclui objetos LatLng
indiretamente.
Propriedades | |
---|---|
request |
Tipo:
DirectionsRequest O DirectionsRequest que produziu esse resultado. |
routes |
Tipo:
Array<DirectionsRoute> Uma matriz de DirectionsRoute s, cada um contendo informações sobre os trechos e etapas dos quais é composto. Haverá apenas uma rota, a menos que o DirectionsRequest tenha sido criado com provideRouteAlternatives definido como true . |
available_travel_modes optional |
Tipo:
Array<TravelMode> optional Contém uma matriz de meios de transporte disponíveis. Este campo é retornado quando uma solicitação especifica um meio de transporte e não recebe resultados. A matriz contém os modos de transporte disponíveis nos países do determinado conjunto de pontos de referência. Este campo não será retornado se um ou mais waypoints forem "via waypoints". |
geocoded_waypoints optional |
Tipo:
Array<DirectionsGeocodedWaypoint> optional Uma matriz de DirectionsGeocodedWaypoint s, cada uma contendo informações sobre a geocodificação da origem, do destino e dos waypoints. |
Classe DirectionsRenderer
Classe
google.maps.DirectionsRenderer
Renderiza rotas extraídas do DirectionsService
.
Essa classe estende
MVCObject
.
Acesse chamando const {DirectionsRenderer} = await google.maps.importLibrary("routes")
. Consulte Bibliotecas na API Maps JavaScript.
Construtor | |
---|---|
DirectionsRenderer |
DirectionsRenderer([opts]) Parâmetros:
Cria o renderizador com as opções especificadas. As rotas podem ser renderizadas em um mapa (como sobreposições visuais) ou em adição a um painel <div> (como instruções textuais). |
Métodos | |
---|---|
getDirections |
getDirections() Parâmetros: nenhum
Valor de retorno:
DirectionsResult Retorna o conjunto de rotas atual do renderizador. |
getMap |
getMap() Parâmetros: nenhum
Valor de retorno:
Map Retorna o mapa em que o DirectionsResult é renderizado. |
getPanel |
getPanel() Parâmetros: nenhum
Valor de retorno:
HTMLElement|null Retorna o painel <div> em que o DirectionsResult é renderizado. |
getRouteIndex |
getRouteIndex() Parâmetros: nenhum
Valor de retorno:
number Retorna o índice de trajeto atual (baseado em zero) em uso por este objeto DirectionsRenderer . |
setDirections |
setDirections(directions) Parâmetros:
Valor de retorno: nenhum
Define o renderizador para usar o resultado do DirectionsService . A definição de um conjunto válido de rotas desse modo exibirá as rotas no mapa e painel designados do renderizador. |
setMap |
setMap(map) Parâmetros:
Valor de retorno: nenhum
Este método especifica o mapa no qual as rotas serão renderizadas. Transmita null para remover as rotas do mapa. |
setOptions |
setOptions(options) Parâmetros:
Valor de retorno: nenhum
Mude as configurações de opções deste DirectionsRenderer após a inicialização. |
setPanel |
setPanel(panel) Parâmetros:
Valor de retorno: nenhum
Esse método renderiza as rotas em um <div> . Transmita null para remover o conteúdo do painel. |
setRouteIndex |
setRouteIndex(routeIndex) Parâmetros:
Valor de retorno: nenhum
Define o índice (baseado em zero) do trajeto no objeto DirectionsResult a ser renderizado. Por padrão, o primeiro trajeto na matriz será renderizado. |
Herdado:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Eventos | |
---|---|
directions_changed |
function() Argumentos: nenhum
Este evento é disparado quando as rotas renderizadas são alteradas, seja quando um novo DirectionsResult é definido ou quando o usuário termina de arrastar uma alteração para o caminho de rotas. |
DirectionsRendererOptions
Interface
google.maps.DirectionsRendererOptions
Esse objeto define as propriedades que podem ser definidas em um objeto DirectionsRenderer
.
Propriedades | |
---|---|
directions optional |
Tipo:
DirectionsResult optional As rotas a serem mostradas no mapa e/ou em um painel <div> , recuperado como um objeto DirectionsResult do DirectionsService . |
draggable optional |
Tipo:
boolean optional Se for true , permite que o usuário arraste e modifique os caminhos dos trajetos renderizados por essa DirectionsRenderer . |
hideRouteList optional |
Tipo:
boolean optional Padrão:
false Essa propriedade indica se o renderizador deve fornecer uma lista selecionável de trajetos mostrados no painel de rotas. |
infoWindow optional |
Tipo:
InfoWindow optional O InfoWindow em que informações de texto são renderizadas quando um marcador é clicado. O conteúdo da janela de informações existente será substituído e sua posição movida. Se nenhuma janela de informações for especificada, o DirectionsRenderer criará e usará sua própria janela. Essa propriedade será ignorada se suppressInfoWindows for definido como true . |
map optional |
Tipo:
Map optional Mapa no qual exibir as rotas. |
markerOptions optional |
Tipo:
MarkerOptions optional Opções para os marcadores. Todos os marcadores renderizados pelo DirectionsRenderer vão usar essas opções. |
panel optional |
Tipo:
HTMLElement optional O <div> em que as etapas de rotas serão mostradas. |
polylineOptions optional |
Tipo:
PolylineOptions optional Opções para as polilinhas. Todas as polilinhas renderizadas pelo DirectionsRenderer usarão essas opções. |
preserveViewport optional |
Tipo:
boolean optional Padrão:
false Se essa opção for definida como true ou se o centro e o zoom do mapa nunca tiverem sido definidos, o mapa será centralizado e ampliado para a caixa delimitadora desse conjunto de rotas. |
routeIndex optional |
Tipo:
number optional O índice do trajeto no objeto DirectionsResult . O valor padrão é 0. |
suppressBicyclingLayer optional |
Tipo:
boolean optional Remove a renderização de BicyclingLayer quando rotas de bicicleta são solicitadas. |
suppressInfoWindows optional |
Tipo:
boolean optional Remove a renderização da janela de informações. |
suppressMarkers optional |
Tipo:
boolean optional Remove a renderização de marcadores. |
suppressPolylines optional |
Tipo:
boolean optional Remove a renderização de polilinhas. |
DirectionsWaypoint
Interface
google.maps.DirectionsWaypoint
Um DirectionsWaypoint
representa um local entre a origem e o destino pelo qual a viagem precisa ser direcionada.
Propriedades | |
---|---|
location optional |
Tipo:
string|LatLng|LatLngLiteral|Place optional Local do ponto de referência. Pode ser uma string de endereço, um LatLng ou um Place . Opcional. |
stopover optional |
Tipo:
boolean optional Padrão:
true Se for true , indica que este waypoint é uma parada entre a origem e o destino. Isso resulta na divisão do trajeto em dois trechos. Se false , indica que o trajeto deve ser tendencioso para passar por esse waypoint, mas não dividido em dois trechos. Isso é útil se você deseja criar um trajeto em resposta ao usuário arrastar waypoints em um mapa. |
Interface DirectionsGeocodedWaypoint (em inglês)
Interface
google.maps.DirectionsGeocodedWaypoint
Um único waypoint geocodificado.
Propriedades | |
---|---|
partial_match optional |
Tipo:
boolean optional Se o geocodificador não retornou uma correspondência exata para o waypoint original, embora possa corresponder parte do endereço solicitado. |
place_id optional |
Tipo:
string optional O ID de lugar associado ao waypoint. IDs de lugares identificam um local de modo exclusivo no banco de dados do Google Places e no Google Maps. Saiba mais sobre IDs de lugar no guia para desenvolvedores da API Places. |
types optional |
Tipo:
Array<string> optional Uma matriz de strings que denotam o tipo do elemento geocodificado retornado. Para obter uma lista das possíveis strings, consulte a seção Tipos de componentes de endereço do Guia do desenvolvedor. |
DirectionsRoute
Interface
google.maps.DirectionsRoute
Um único trajeto que contém um conjunto de trechos em um DirectionsResult
. Apesar de esse objeto ser do tipo "JSON", ele não é estritamente JSON, já que inclui objetos LatLng
direta e indiretamente.
Propriedades | |
---|---|
bounds |
Tipo:
LatLngBounds Os limites para este trajeto. |
copyrights |
Tipo:
string O texto de direitos autorais a ser exibido para este trajeto. |
legs |
Tipo:
Array<DirectionsLeg> Uma matriz de DirectionsLeg s, cada uma contendo informações sobre as etapas das quais é composta. Haverá um trecho para cada waypoint ou destino de parada especificado. Assim, um trajeto sem waypoints com parada contém um DirectionsLeg , e um trajeto com um waypoint com parada contém dois. |
overview_path |
Uma matriz de LatLng s que representam todo o percurso deste trajeto. O caminho é simplificado para se adequar a contextos onde é necessário um pequeno número de vértices (como os URLs da Google Static Maps API). |
overview_polyline |
Tipo:
string Uma representação de polilinha codificada do trajeto em Overview_path. Essa polilinha é um caminho aproximado (suavizado) da rota resultante. |
summary |
Tipo:
string Contém uma breve descrição textual para o trajeto, que serve para nomear e diferenciar o trajeto de trajetos alternativos. |
warnings |
Tipo:
Array<string> Avisos a serem exibidos quando estas rotas estiverem sendo mostradas. |
waypoint_order |
Tipo:
Array<number> Se optimizeWaypoints tiver sido definido como true , este campo conterá a nova ordem dos waypoints de entrada. Por exemplo, se a entrada for:Origem: Los Angeles Waypoints: Dallas, Bangor, Phoenix Destino: Nova York e a saída otimizada tiver sido ordenada da seguinte maneira: Origem: Los Angeles Waypoints: Phoenix, Dallas, Bangor Destination: New York , este campo será um Array contendo os valores [2, 0, 1]. A numeração dos pontos de referência é baseada em zero.Se algum waypoint de entrada tiver o stopover definido como false , este campo ficará vazio, porque a otimização de trajeto não está disponível para essas consultas. |
fare optional |
Tipo:
TransitFare optional A tarifa total para toda a viagem de transporte público. Aplicável apenas a solicitações de transporte público. |
DirectionsLeg
Interface
google.maps.DirectionsLeg
Um único trecho composto de um conjunto de etapas em um DirectionsResult
. Alguns campos no trecho podem não ser retornados para todas as solicitações. Apesar de esse resultado ser do tipo "JSON", ele não é estritamente JSON, já que inclui objetos LatLng
direta e indiretamente.
Propriedades | |
---|---|
end_address |
Tipo:
string O endereço do destino deste trecho. Este conteúdo deve ser lido no estado em que se encontra. Não analise programaticamente o endereço formatado. |
end_location |
Tipo:
LatLng O DirectionsService calcula rotas entre os locais usando a opção de transporte mais próxima (geralmente uma estrada) dos locais de início e término. end_location indica o destino geocodificado real, que pode ser diferente do end_location da última etapa se, por exemplo, a estrada não for próxima do destino deste trecho. |
start_address |
Tipo:
string O endereço da origem deste trecho. Este conteúdo deve ser lido no estado em que se encontra. Não analise programaticamente o endereço formatado. |
start_location |
Tipo:
LatLng O DirectionsService calcula rotas entre os locais usando a opção de transporte mais próxima (geralmente uma estrada) dos locais de início e término. start_location indica a origem geocodificada real, que pode ser diferente do start_location da primeira etapa se, por exemplo, a estrada não estiver próxima da origem deste trecho. |
steps |
Tipo:
Array<DirectionsStep> Uma matriz de DirectionsStep s, cada uma contendo informações sobre etapas individuais neste trecho. |
|
Tipo:
Array<?> Informações sobre velocidade do trânsito ao longo do trecho. |
via_waypoints |
Uma matriz de waypoints sem escalas ao longo deste trecho, especificados na solicitação original. Descontinuado em rotas alternativas. A 3.27 vai ser a última versão da API que vai adicionar mais Ao usar o Serviço de rotas para implementar rotas arrastáveis, é recomendável desativar o recurso de arrastar de trajetos alternativos. Somente o trajeto principal deve ser arrastável. Os usuários podem arrastar o trajeto principal até que ele corresponda a um trajeto alternativo. |
arrival_time optional |
Tipo:
Time optional Um horário previsto de chegada para este trecho. Aplicável somente para solicitações de TRANSPORTE. |
departure_time optional |
Tipo:
Time optional Um horário de partida estimado para este trecho. Aplicável somente para solicitações de TRANSPORTE. |
distance optional |
Tipo:
Distance optional A distância total coberta por este trecho. Esta propriedade pode ser indefinida quando a distância não for conhecida. |
duration optional |
Tipo:
Duration optional A duração total deste trecho. A propriedade talvez seja undefined porque a duração pode ser desconhecida. |
duration_in_traffic optional |
Tipo:
Duration optional A duração total deste trecho, considerando as condições de trânsito indicadas pela propriedade trafficModel . A propriedade talvez seja undefined porque a duração pode ser desconhecida. |
DirectionsStep
Interface
google.maps.DirectionsStep
Uma única DirectionsStep
em uma DirectionsResult
. Alguns campos podem ser undefined
. Apesar de esse objeto ser do tipo "JSON", ele não é estritamente JSON, porque inclui objetos LatLng
diretamente.
Propriedades | |
---|---|
encoded_lat_lngs |
Tipo:
string Uma representação de polilinha codificada da etapa. Esse é um caminho aproximado (suavizado) da etapa. |
end_location |
Tipo:
LatLng O local final desta etapa. |
|
Tipo:
LatLng O local final desta etapa. |
instructions |
Tipo:
string Instruções para esta etapa. |
|
Uma sequência de LatLng s que descrevem o curso desta etapa. Esse é um caminho aproximado (suavizado) da etapa. |
maneuver |
Tipo:
string Contém a ação a ser realizada na etapa atual ( turn-left , merge , straight etc.). Os valores estão sujeitos a alterações, e novos valores podem ser introduzidos sem aviso prévio. |
path |
Uma sequência de LatLng s que descrevem o curso desta etapa. Esse é um caminho aproximado (suavizado) da etapa. |
start_location |
Tipo:
LatLng O local inicial desta etapa. |
|
Tipo:
LatLng O local inicial desta etapa. |
travel_mode |
Tipo:
TravelMode O modo de viagem usado nesta etapa. |
distance optional |
Tipo:
Distance optional A distância coberta por esta etapa. Essa propriedade pode ser undefined porque a distância pode ser desconhecida. |
duration optional |
Tipo:
Duration optional O tempo normalmente necessário para a execução desta etapa, em segundos e no formato de texto. A propriedade talvez seja undefined porque a duração pode ser desconhecida. |
|
Tipo:
DirectionsPolyline optional Contém um objeto com uma única propriedade, "points", que contém uma representação da polilinha codificada da etapa. Essa polilinha é um caminho aproximado (suavizado) da etapa. |
steps optional |
Tipo:
Array<DirectionsStep> optional Subetapas desta etapa. Especificado para seções de trajetos de transporte público que não são de transporte público. |
transit optional |
Tipo:
TransitDetails optional Detalhes específicos do Google Transit sobre esta etapa Essa propriedade será indefinida, a menos que o meio de transporte desta etapa seja TRANSIT . |
transit_details optional |
Tipo:
TransitDetails optional Detalhes relacionados a esta etapa, se o meio de transporte for TRANSIT . |
Interface DirectionsPolyline
Interface
google.maps.DirectionsPolyline
Um objeto que contém uma propriedade points
para descrever a polilinha de um DirectionsStep
.
Propriedades | |
---|---|
points |
Tipo:
string Uma polilinha codificada. |
Place
Interface
google.maps.Place
Contém as informações necessárias para localizar, identificar ou descrever um lugar para uma DirectionsRequest
ou um DistanceMatrixRequest
. Nesse contexto, "lugar" significa uma empresa, um ponto de interesse ou uma localização geográfica. Para buscar informações sobre um local, consulte PlacesService
.
Propriedades | |
---|---|
location optional |
Tipo:
LatLng|LatLngLiteral optional O LatLng da entidade descrita por esse lugar. |
placeId optional |
Tipo:
string optional O ID de local do lugar (como uma empresa ou um ponto de interesse). O ID de local é um identificador exclusivo de um local no banco de dados do Google Maps. O placeId é a forma mais precisa de identificar um lugar. Se possível, especifique o placeId em vez de uma query . Um ID de local pode ser recuperado de qualquer solicitação para a API Places, como uma TextSearch. Os IDs de lugares também podem ser recuperados a partir de solicitações para a API Geocoding. Para mais informações, consulte a visão geral de IDs de lugar. |
query optional |
Tipo:
string optional Uma consulta de pesquisa que descreve o lugar (como uma empresa ou um ponto de interesse). Um exemplo de consulta é "Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW". Se possível, especifique o placeId em vez de uma query . A API não garante a precisão de resolver a string de consulta para um local. Se o placeId e o query forem fornecidos, ocorrerá um erro. |
Constantes TravelMode
Constantes
google.maps.TravelMode
Os meios de transporte válidos que podem ser especificados em um DirectionsRequest
, bem como os meios de transporte retornados em um DirectionsStep
. Especifique-as por valor ou usando o nome da constante. Por exemplo, 'BICYCLING'
ou google.maps.TravelMode.BICYCLING
.
Acesse chamando const {TravelMode} = await google.maps.importLibrary("routes")
. Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
BICYCLING |
Especifica uma solicitação de rotas de ciclismo. |
DRIVING |
Especifica uma solicitação de rotas de carro. |
TRANSIT |
Especifica uma solicitação de rotas de transporte público. |
WALKING |
Especifica uma solicitação de rotas a pé. |
DrivingOptions
Interface
google.maps.DrivingOptions
Configura o DirectionsRequest
quando o modo de viagem é definido como DRIVING
.
Propriedades | |
---|---|
departureTime |
Tipo:
Date O horário de partida desejado do trajeto, especificado como um objeto Date . O objeto Date mede o tempo em milissegundos desde 1o de janeiro de 1970. Precisa ser especificado para que um DrivingOptions seja válido. O horário de partida precisa ser definido como o horário atual ou no futuro. Seu valor não pode estar no passado. |
trafficModel optional |
Tipo:
TrafficModel optional A suposição preferencial a ser usada ao prever a duração no tráfego. O padrão é BEST_GUESS . |
Constantes TrafficModel
Constantes
google.maps.TrafficModel
As suposições a serem usadas ao prever a duração no tráfego. Especificado como parte de um DirectionsRequest
ou DistanceMatrixRequest
. Especifique-as por valor ou usando o nome da constante. Por exemplo, 'bestguess'
ou google.maps.TrafficModel.BEST_GUESS
.
Acesse chamando const {TrafficModel} = await google.maps.importLibrary("routes")
. Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
BEST_GUESS |
Use os dados históricos de trânsito para estimar melhor o tempo gasto no trânsito. |
OPTIMISTIC |
Use os dados históricos de trânsito para fazer uma estimativa otimista da duração no trânsito. |
PESSIMISTIC |
Use os dados históricos de trânsito para fazer uma estimativa pessimista da duração no trânsito. |
TransitOptions
Interface
google.maps.TransitOptions
O objeto TransitOptions a ser incluído em um DirectionsRequest
quando o meio de viagem estiver definido como trânsito.
Propriedades | |
---|---|
arrivalTime optional |
Tipo:
Date optional O horário de chegada desejado para o trajeto, especificado como um objeto Date. O objeto Date mede o tempo em milissegundos desde 1o de janeiro de 1970. Se o horário de chegada é especificado, o horário de partida é ignorado. |
departureTime optional |
Tipo:
Date optional O horário de partida desejado do trajeto, especificado como um objeto Date. O objeto Date mede o tempo em milissegundos desde 1o de janeiro de 1970. Se nenhum horário de partida nem de chegada for especificado, o horário será considerado "agora". |
modes optional |
Tipo:
Array<TransitMode> optional Um ou mais meios de transporte preferidos, como ônibus ou trem. Se nenhuma preferência for dada, a API retornará a melhor rota padrão. |
routingPreference optional |
Tipo:
TransitRoutePreference optional Uma preferência que pode induzir a escolha do trajeto de transporte público, como menos caminhada. Se nenhuma preferência for dada, a API retornará a melhor rota padrão. |
Constantes TransitMode
Constantes
google.maps.TransitMode
O meio de transporte público válido (por exemplo, ônibus), que pode ser especificado em um TransitOptions
. Especifique-as por valor ou usando o nome da constante. Por exemplo, 'BUS'
ou google.maps.TransitMode.BUS
.
Acesse chamando const {TransitMode} = await google.maps.importLibrary("routes")
. Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
BUS |
Especifica o ônibus como meio de transporte preferencial. |
RAIL |
Especifica o trem como um meio de transporte preferencial. |
SUBWAY |
Especifica "metrô" como um meio de transporte preferencial. |
TRAIN |
Especifica trem como modo de transporte público preferido. |
TRAM |
Especifica o bonde como meio de transporte preferencial. |
Constantes TransitRoutePreference.
Constantes
google.maps.TransitRoutePreference
O tipo de trajeto de transporte público válido que pode ser especificado em um TransitOptions
. Especifique-as por valor ou usando o nome da constante. Por exemplo, 'LESS_WALKING'
ou google.maps.TransitRoutePreference.LESS_WALKING
.
Acesse chamando const {TransitRoutePreference} = await google.maps.importLibrary("routes")
. Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
FEWER_TRANSFERS |
Especifica que o trajeto calculado deve dar preferência a um número limitado de baldeações. |
LESS_WALKING |
Especifica que o trajeto calculado deve dar preferência a uma quantidade limitada de caminhada. |
Interface TransitFare
Interface
google.maps.TransitFare
Uma tarifa de um DirectionsRoute
que consiste em valor e moeda.
Propriedades | |
---|---|
currency |
Tipo:
string Um código de moeda ISO 4217 que indica a moeda em que a tarifa é expressa. |
value |
Tipo:
number O valor numérico da tarifa, expresso no currency especificado. |
TransitDetails
Interface
google.maps.TransitDetails
Detalhes sobre partida, chegada e meio de transporte público usados nessa etapa.
Propriedades | |
---|---|
arrival_stop |
Tipo:
TransitStop A parada de chegada desta etapa de transporte público. |
arrival_time |
Tipo:
Time O horário de chegada desta etapa, especificado como um objeto Time. |
departure_stop |
Tipo:
TransitStop A parada de partida desta etapa de transporte público. |
departure_time |
Tipo:
Time O horário de partida desta etapa, especificado como um objeto Time. |
headsign |
Tipo:
string A direção de deslocamento nessa linha, conforme marcada no veículo ou no ponto de partida. |
headway |
Tipo:
number O número esperado de segundos entre veículos equivalentes nesta parada. |
line |
Tipo:
TransitLine Detalhes sobre a linha de transporte público usada nessa etapa. |
num_stops |
Tipo:
number O número de paradas desta etapa. Esse número inclui a parada de chegada, mas não a de partida. |
trip_short_name |
Tipo:
string o texto que aparece nos horários e placas de sinalização para identificar uma viagem de transporte público aos passageiros, por exemplo, para identificar os números dos trens. O texto identifica exclusivamente uma viagem em um dia de serviço. |
TransitStop.
Interface
google.maps.TransitStop
Detalhes sobre uma parada ou estação de transporte público
Propriedades | |
---|---|
location |
Tipo:
LatLng O local desta parada. |
name |
Tipo:
string O nome desta parada de transporte público. |
TransitLine.
Interface
google.maps.TransitLine
Informações sobre a linha de transporte público que opera esta etapa.
Propriedades | |
---|---|
agencies |
Tipo:
Array<TransitAgency> A empresa de transporte público que opera essa linha de transporte público. |
color |
Tipo:
string A cor normalmente usada na sinalização dessa linha de transporte público, representada como uma string hexadecimal. |
icon |
Tipo:
string O URL de um ícone associado a essa linha. |
name |
Tipo:
string O nome completo dessa linha de transporte público. Por exemplo, "8 Avenue Local". |
short_name |
Tipo:
string O nome curto da linha de transporte público. Por exemplo, "E". |
text_color |
Tipo:
string A cor do texto normalmente usada na sinalização dessa linha de transporte público, representada como uma string hexadecimal. |
url |
Tipo:
string O URL da agência que é específico para esta linha de transporte público. |
vehicle |
Tipo:
TransitVehicle O tipo de veículo usado, por exemplo, trem ou ônibus. |
Interface TransitAgency
Interface
google.maps.TransitAgency
Informações sobre uma empresa que opera uma linha de transporte público.
Propriedades | |
---|---|
name |
Tipo:
string O nome dessa empresa de transporte público. |
phone |
Tipo:
string Número de telefone da empresa de transporte público. |
url |
Tipo:
string O URL da empresa de transporte público. |
Interface TransitVehicle
Interface
google.maps.TransitVehicle
Informações sobre o veículo que opera em uma linha de transporte público.
Propriedades | |
---|---|
icon |
Tipo:
string Um URL para um ícone que corresponde ao tipo de veículo usado na linha. |
local_icon |
Tipo:
string Um URL para um ícone que corresponde ao tipo de veículo usado na região em vez do ícone mais geral. |
name |
Tipo:
string Um nome para este tipo de veículo de transporte público, por exemplo, "Trem" ou "Ônibus". |
type |
Tipo:
VehicleType O tipo de veículo usado, por exemplo, trem, ônibus ou balsa. |
Constantes de VehicleType
Constantes
google.maps.VehicleType
Valores possíveis para tipos de veículo.
Acesse chamando const {VehicleType} = await google.maps.importLibrary("routes")
. Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
BUS |
Ônibus |
CABLE_CAR |
Um veículo que opera por meio de um cabo, normalmente terrestre. Bondes aéreos podem ser do tipo GONDOLA_LIFT . |
COMMUTER_TRAIN |
Trem metropolitano. |
FERRY |
Balsa. |
FUNICULAR |
Um veículo puxado por cabo em declives acentuados. |
GONDOLA_LIFT |
Um bonde aéreo. |
HEAVY_RAIL |
Vagões pesados. |
HIGH_SPEED_TRAIN |
Trem de alta velocidade. |
INTERCITY_BUS |
Ônibus intermunicipal. |
METRO_RAIL |
Metrô de superfície. |
MONORAIL |
Monotrilho. |
OTHER |
Outros veículos |
RAIL |
Trem |
SHARE_TAXI |
Dividir um táxi é um tipo de transporte de ônibus que permite deixar e pegar passageiros em qualquer ponto do trajeto. Geralmente, táxis compartilhados usam micro-ônibus. |
SUBWAY |
Veículo leve subterrâneo. |
TRAM |
Veículo leve acima do chão. |
TROLLEYBUS |
Ônibus elétrico. |
Constantes UnitSystem
Constantes
google.maps.UnitSystem
Os sistemas de medidas válidos que podem ser especificados em um DirectionsRequest
.
Acesse chamando const {UnitSystem} = await google.maps.importLibrary("core")
. Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
IMPERIAL |
Especifica que as distâncias no DirectionsResult precisam ser expressas no sistema imperial. |
METRIC |
Especifica que as distâncias no DirectionsResult precisam ser expressas em unidades métricas. |
Distance
Interface
google.maps.Distance
Uma representação da distância como um valor numérico e uma string de exibição.
Propriedades | |
---|---|
text |
Tipo:
string Uma string que representa o valor da distância, usando o UnitSystem especificado na solicitação. |
value |
Tipo:
number A distância em metros. |
Duration
Interface
google.maps.Duration
Uma representação da duração como um valor numérico e uma string de exibição.
Propriedades | |
---|---|
text |
Tipo:
string Uma string que representa o valor da duração. |
value |
Tipo:
number A duração em segundos. |
Time
Interface
google.maps.Time
Uma representação do tempo como um objeto de data, uma string localizada e um fuso horário.
Propriedades | |
---|---|
text |
Tipo:
string Uma string que representa o valor do horário. O tempo é exibido no fuso horário da parada do transporte público. |
time_zone |
Tipo:
string O fuso horário da parada. O valor é o nome do fuso horário conforme definido no banco de dados de fusos horários da IANA, por exemplo, "America/New_York". |
value |
Tipo:
Date O horário dessa partida ou chegada, especificado como um objeto JavaScript Date. |
Constantes DirectionsTravelMode
Constantes
google.maps.DirectionsTravelMode
Constantes DirectionsUnitSystem
Constantes
google.maps.DirectionsUnitSystem