Classe DirectionsService
Classe
google.maps.DirectionsService
Um serviço para calcular rotas entre dois ou mais lugares.
Acesse ligando para 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 os servidores do Google. |
Métodos | |
---|---|
route |
route(request[, callback]) Parâmetros:
Valor de retorno:
Promise<DirectionsResult> Envia uma solicitação de pesquisa de rota. |
Interface DirectionsRequest
Interface google.maps.DirectionsRequest
Uma consulta de rotas a ser enviada para DirectionsService
.
Propriedades | |
---|---|
destination |
Tipo:
string|LatLng|Place|LatLngLiteral Local de destino. Isso pode ser especificado como uma string a ser geocodificada, um LatLng ou um Place . Obrigatório. |
origin |
Tipo:
string|LatLng|Place|LatLngLiteral Local de origem. Isso pode ser especificado como uma string a ser geocodificada, um LatLng ou um 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 . Esse objeto não terá efeito para outros modos de viagem. |
language optional |
Tipo:
string optional Um identificador do idioma em que os resultados devem ser retornados, quando possível. Consulte a lista de idiomas compatíveis. |
optimizeWaypoints optional |
Tipo:
boolean optional Se definido como true , o DirectionsService tentará reordenar os pontos de parada intermediários fornecidos para minimizar o custo geral da rota. Se os waypoints forem 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 que se aplicam apenas a solicitações em que travelMode é TRANSIT. Esse objeto não terá efeito para outros modos de viagem. |
unitSystem optional |
Tipo:
UnitSystem optional Padrão:o sistema de unidades 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 usando cada ponto de parada nessa matriz. Consulte o guia do desenvolvedor para saber o número máximo de pontos de parada permitidos. Não são permitidos waypoints nas rotas de transporte público. Opcional. |
Constantes DirectionsStatus
Constantes de google.maps.DirectionsStatus
O status retornado pelo DirectionsService
na conclusão de uma chamada para route()
. Especifique-os por valor ou usando o nome da constante. Por exemplo, 'OK'
ou google.maps.DirectionsStatus.OK
.
Acesse ligando para const {DirectionsStatus} = await google.maps.importLibrary("routes")
.
Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
INVALID_REQUEST |
O DirectionsRequest fornecido é inválido. |
MAX_WAYPOINTS_EXCEEDED |
Muitos DirectionsWaypoint s foram fornecidos no DirectionsRequest . Consulte o guia do desenvolvedor para saber o número máximo de pontos de parada permitidos. |
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. |
Interface DirectionsResult
Interface google.maps.DirectionsResult
A resposta das rotas recuperada do servidor de rotas. É possível renderizar esses dados usando um DirectionsRenderer
ou analisar e renderizar o objeto por conta própria. É necessário mostrar os avisos e direitos autorais conforme indicado nos Termos de Serviço da Plataforma Google Maps. Embora esse resultado seja semelhante a JSON, ele não é estritamente JSON, já que inclui indiretamente objetos LatLng
.
Propriedades | |
---|---|
request |
Tipo:
DirectionsRequest O DirectionsRequest que gerou esse resultado. |
routes |
Tipo:
Array<DirectionsRoute> Uma matriz de DirectionsRoute s, cada uma contendo informações sobre os trechos e etapas de que é composta. Só haverá uma rota, a menos que a solicitação DirectionsRequest tenha sido feita com provideRouteAlternatives definido como true . |
available_travel_modes optional |
Tipo:
Array<TravelMode> optional Contém uma matriz de meios de transporte disponíveis. Esse 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. Esse campo não é 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 obtidas do DirectionsService
.
Essa classe estende
MVCObject
.
Acesse ligando para 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 também em 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 da rota atual (baseado em zero) em uso por este objeto DirectionsRenderer . |
setDirections |
setDirections(directions) Parâmetros:
Valor de retorno:nenhum
Defina 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 instruções em um <div> . Transmita null para remover o conteúdo do painel. |
setRouteIndex |
setRouteIndex(routeIndex) Parâmetros:
Valor de retorno:nenhum
Defina o índice (baseado em zero) da rota 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
Esse evento é disparado quando as rotas renderizadas mudam, seja quando um novo DirectionsResult é definido ou quando o usuário termina de arrastar uma mudança no caminho das rotas. |
Interface 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> , recuperadas como um objeto DirectionsResult de DirectionsService . |
draggable optional |
Tipo:
boolean optional Se true , permite que o usuário arraste e modifique os caminhos das rotas renderizadas por este DirectionsRenderer . |
hideRouteList optional |
Tipo:
boolean optional Padrão:
false Essa propriedade indica se o renderizador precisa fornecer uma lista de rotas selecionáveis pelo usuário mostrada no painel de rotas. |
infoWindow optional |
Tipo:
InfoWindow optional O InfoWindow em que as 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 vai criar e usar a 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 do trajeto serão mostradas. |
polylineOptions optional |
Tipo:
PolylineOptions optional Opções para as polilinhas. Todas as polilinhas renderizadas pelo DirectionsRenderer vão usar 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 de entrada será centralizado e terá zoom aplicado à caixa delimitadora desse conjunto de rotas. |
routeIndex optional |
Tipo:
number optional O índice da rota no objeto DirectionsResult . O valor padrão é 0. |
suppressBicyclingLayer optional |
Tipo:
boolean optional Suprime a renderização do 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. |
Interface DirectionsWaypoint
Interface google.maps.DirectionsWaypoint
Um DirectionsWaypoint
representa um local entre a origem e o destino pelo qual a viagem deve ser feita.
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 true , indica que este waypoint é uma parada entre a origem e o destino. Isso divide o trajeto em dois trechos. Se false , indica que o trajeto deve ser direcionado para passar por esse waypoint, mas não dividido em dois trechos. Isso é útil se você quiser criar um trajeto em resposta ao usuário arrastando pontos de referência em um mapa. |
Interface DirectionsGeocodedWaypoint
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 ponto de referência original, mas conseguiu corresponder parte do endereço solicitado. |
place_id optional |
Tipo:
string optional O ID do lugar associado ao ponto de referência. 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 uma lista de strings possíveis, consulte a seção Tipos de componentes de endereço do Guia do desenvolvedor. |
Interface DirectionsRoute
Interface google.maps.DirectionsRoute
Uma única rota que contém um conjunto de trechos em um DirectionsResult
. Embora esse objeto seja semelhante a 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 de que é composta. Haverá um trecho para cada ponto de parada ou destino especificado. Portanto, um trajeto sem waypoints de parada vai conter um DirectionsLeg , e um trajeto com um waypoint de parada vai conter dois. |
overview_path |
Uma matriz de LatLng s que representa todo o 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 do trajeto, adequada para nomear e diferenciar o trajeto de alternativas. |
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 , esse campo vai conter a permutação reordenada dos pontos de referência de entrada. Por exemplo, se a entrada for:Origem: Los Angeles Pontos de parada: Dallas, Bangor, Phoenix Destino: Nova York e a saída otimizada for ordenada da seguinte forma: Origem: Los Angeles Pontos de parada: Phoenix, Dallas, Bangor Destino: Nova York , esse campo será um Array que contém os valores [2, 0, 1]. A numeração dos pontos de referência é baseada em zero.Se algum dos pontos de referência de entrada tiver stopover definido como false , esse campo vai ficar vazio, já que a otimização de rotas não está disponível para essas consultas. |
fare optional |
Tipo:
TransitFare optional A tarifa total de toda a viagem de transporte público. Aplicável apenas a solicitações de transporte público. |
Interface DirectionsLeg
Interface google.maps.DirectionsLeg
Um único trecho que consiste em um conjunto de etapas em um DirectionsResult
. Alguns campos no trecho podem não ser retornados para todas as solicitações. Embora esse resultado seja semelhante a 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. O conteúdo precisa ser lido no estado em que se encontra. Não analise o endereço formatado de maneira programática. |
end_location |
Tipo:
LatLng O DirectionsService calcula rotas entre locais usando a opção de transporte mais próxima (geralmente uma estrada) do ponto inicial e final. end_location indica o destino geocodificado real, que pode ser diferente do end_location da última etapa se, por exemplo, a estrada não estiver perto do destino deste trecho. |
start_address |
Tipo:
string O endereço da origem deste trecho. O conteúdo precisa ser lido no estado em que se encontra. Não analise o endereço formatado de maneira programática. |
start_location |
Tipo:
LatLng O DirectionsService calcula rotas entre locais usando a opção de transporte mais próxima (geralmente uma estrada) do ponto inicial e final. start_location indica a origem geocodificada real, que pode ser diferente do start_location da primeira etapa se, por exemplo, a via não estiver perto da origem deste trecho. |
steps |
Tipo:
Array<DirectionsStep> Uma matriz de DirectionsStep s, cada uma contendo informações sobre as etapas individuais desse trecho. |
|
Tipo:
Array<?> Informações sobre a velocidade do trânsito ao longo do trecho. |
via_waypoints |
Uma matriz de pontos de parada sem escala ao longo desse trecho, que foram especificados na solicitação original. Descontinuado em trajetos alternativos. A versão 3.27 será a última da API que adiciona Ao usar o serviço Directions para implementar rotas arrastáveis, recomendamos 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 estimado de chegada para este trecho. Aplicável somente a solicitações de TRANSIT. |
departure_time optional |
Tipo:
Time optional Um horário estimado de partida para este trecho. Aplicável somente a solicitações de TRANSIT. |
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. Essa propriedade pode ser 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 . Essa propriedade pode ser undefined porque a duração pode ser desconhecida. |
Interface DirectionsStep
Interface google.maps.DirectionsStep
Um único DirectionsStep
em um DirectionsResult
. Alguns campos podem ser undefined
. Embora esse objeto seja semelhante a JSON, ele não é estritamente JSON, já que inclui diretamente objetos LatLng
.
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 dessa etapa. Esse é um caminho aproximado (suavizado) da etapa. |
maneuver |
Tipo:
string Contém a ação a ser realizada para a etapa atual ( turn-left , merge , straight etc.). Os valores estão sujeitos a mudanças, e novos valores podem ser adicionados sem aviso prévio. |
path |
Uma sequência de LatLng s que descrevem o curso dessa 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. Essa propriedade pode ser 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 de polilinha codificada da etapa. Essa polilinha é um caminho aproximado (suavizado) da etapa. |
steps optional |
Tipo:
Array<DirectionsStep> optional Subetapas desta etapa. Especificado para trechos não relacionados a transporte público de trajetos de transporte público. |
transit optional |
Tipo:
TransitDetails optional Detalhes específicos de trânsito sobre esta etapa. Essa propriedade será indefinida, a menos que o modo de viagem desta etapa seja TRANSIT . |
transit_details optional |
Tipo:
TransitDetails optional Detalhes relacionados a esta etapa se o modo de viagem 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. |
Interface Place
Interface google.maps.Place
Contém as informações necessárias para localizar, identificar ou descrever um lugar para um DirectionsRequest
ou DistanceMatrixRequest
. Nesse contexto, "lugar" significa uma empresa, um ponto de interesse ou uma localização geográfica. Para buscar informações sobre um lugar, consulte PlacesService
.
Propriedades | |
---|---|
location optional |
Tipo:
LatLng|LatLngLiteral optional O LatLng da entidade descrita por este lugar. |
placeId optional |
Tipo:
string optional O ID do lugar (como uma empresa ou um ponto de interesse). O ID do lugar é um identificador exclusivo de um lugar no banco de dados do Google Maps. O placeId é a maneira mais precisa de identificar um lugar. Se possível, especifique o placeId em vez de um query . Um ID de lugar pode ser recuperado de qualquer solicitação à API Places, como uma TextSearch. Os IDs de lugar também podem ser recuperados de solicitações à API Geocoding. Para mais informações, consulte a visão geral dos 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 um query . A API não garante a precisão da resolução da string de consulta para um lugar. Se placeId e query forem fornecidos, ocorrerá um erro. |
Constantes TravelMode
Constantes de 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-os por valor ou usando o nome da constante. Por exemplo, 'BICYCLING'
ou google.maps.TravelMode.BICYCLING
.
Acesse ligando para 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é. |
Interface 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 para a rota, especificado como um objeto Date . O objeto Date mede o tempo em milissegundos desde 1º de janeiro de 1970. É preciso especificar isso para que um DrivingOptions seja válido. O horário de partida precisa ser definido como o horário atual ou algum horário no futuro. Seu valor não pode estar no passado. |
trafficModel optional |
Tipo:
TrafficModel optional A proposição preferida a ser usada ao prever a duração no trânsito. O padrão é BEST_GUESS . |
Constantes TrafficModel
Constantes de google.maps.TrafficModel
As proposições a serem usadas ao prever a duração no trânsito. Especificado como parte de um DirectionsRequest
ou DistanceMatrixRequest
. Especifique-os por valor ou usando o nome da constante. Por exemplo, 'bestguess'
ou google.maps.TrafficModel.BEST_GUESS
.
Acesse ligando para const {TrafficModel} = await google.maps.importLibrary("routes")
.
Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
BEST_GUESS |
Use dados históricos de trânsito para estimar melhor o tempo gasto no trânsito. |
OPTIMISTIC |
Use dados históricos de tráfego para fazer uma estimativa otimista da duração no trânsito. |
PESSIMISTIC |
Use dados históricos de trânsito para fazer uma estimativa pessimista da duração no trânsito. |
Interface TransitOptions
Interface google.maps.TransitOptions
O objeto TransitOptions a ser incluído em um DirectionsRequest
quando o modo de viagem é definido como TRANSIT.
Propriedades | |
---|---|
arrivalTime optional |
Tipo:
Date optional O horário de chegada desejado para o trajeto, especificado como um objeto de data. O objeto Date mede o tempo em milissegundos desde 1º 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 para o trajeto, especificado como um objeto de data. O objeto Date mede o tempo em milissegundos desde 1º de janeiro de 1970. Se nem o horário de partida nem o de chegada forem especificados, 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 informada, a API vai retornar o melhor trajeto padrão. |
routingPreference optional |
Tipo:
TransitRoutePreference optional Uma preferência que pode influenciar a escolha da rota de transporte público, como menos caminhada. Se nenhuma preferência for informada, a API vai retornar o melhor trajeto padrão. |
Constantes TransitMode
Constantes de google.maps.TransitMode
O meio de transporte válido, por exemplo, ônibus, que pode ser especificado em um TransitOptions
. Especifique-os por valor ou usando o nome da constante. Por exemplo, 'BUS'
ou google.maps.TransitMode.BUS
.
Acesse ligando para const {TransitMode} = await google.maps.importLibrary("routes")
.
Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
BUS |
Especifica o ônibus como um meio de transporte preferencial. |
RAIL |
Especifica o transporte ferroviário como um meio de transporte preferido. |
SUBWAY |
Especifica o metrô como um meio de transporte preferencial. |
TRAIN |
Especifica o trem como meio de transporte preferido. |
TRAM |
Especifica o bonde como um meio de transporte preferido. |
Constantes TransitRoutePreference
Constantes de google.maps.TransitRoutePreference
O tipo de trajeto de transporte público válido que pode ser especificado em um TransitOptions
. Especifique-os por valor ou usando o nome da constante. Por exemplo, 'LESS_WALKING'
ou google.maps.TransitRoutePreference.LESS_WALKING
.
Acesse ligando para const {TransitRoutePreference} = await google.maps.importLibrary("routes")
.
Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
FEWER_TRANSFERS |
Especifica que o trajeto calculado deve preferir um número limitado de transferências. |
LESS_WALKING |
Especifica que o trajeto calculado deve preferir pouca 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. |
text |
Tipo:
string O valor da tarifa, expresso na currency fornecida, como uma string. |
value |
Tipo:
number O valor numérico da tarifa, expresso na currency especificada. |
Interface TransitDetails
Interface google.maps.TransitDetails
Detalhes sobre a partida, a chegada e o modo de transporte usado nesta etapa.
Propriedades | |
---|---|
arrival_stop |
Tipo:
TransitStop A parada de chegada desta etapa de trânsito. |
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 nesse ponto. |
line |
Tipo:
TransitLine Detalhes sobre a linha de transporte público usada nesta etapa. |
num_stops |
Tipo:
number O número de paradas nesta 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 nos quadros de avisos para identificar uma viagem de transporte público aos passageiros, por exemplo, para identificar os números dos trens em viagens de trem metropolitano. O texto identifica exclusivamente uma viagem em um dia de serviço. |
Interface TransitStop
Interface google.maps.TransitStop
Detalhes sobre uma parada ou estação de transporte público.
Propriedades | |
---|---|
location |
Tipo:
LatLng O local dessa parada. |
name |
Tipo:
string O nome desta parada de transporte público. |
Interface 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. |
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, por exemplo, "8 Avenue Local". |
short_name |
Tipo:
string O nome abreviado dessa 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 específico para essa 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 da empresa de transporte público. |
phone |
Tipo:
string O 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 nessa linha. |
local_icon |
Tipo:
string Um URL para um ícone que corresponde ao tipo de veículo usado nessa região, em vez do ícone mais geral. |
name |
Tipo:
string Um nome para esse tipo de TransitVehicle, por exemplo, "Trem" ou "Ônibus". |
type |
Tipo:
VehicleType O tipo de veículo usado, por exemplo, trem, ônibus ou balsa. |
Constantes VehicleType
Constantes de google.maps.VehicleType
Valores possíveis para tipos de veículos.
Acesse ligando para 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 |
Veículo leve sobre trilhos. |
MONORAIL |
Monotrilho. |
OTHER |
Outros veículos. |
RAIL |
Trem |
SHARE_TAXI |
Dividir um táxi é uma forma de ônibus, com a possibilidade de deixar e pegar passageiros em qualquer ponto do trajeto. Em geral, os 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 de google.maps.UnitSystem
Os sistemas de unidades válidos que podem ser especificados em um DirectionsRequest
.
Acesse ligando para const {UnitSystem} = await google.maps.importLibrary("core")
.
Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
IMPERIAL |
Especifica que as distâncias no DirectionsResult devem ser expressas em unidades imperiais. |
METRIC |
Especifica que as distâncias em DirectionsResult devem ser expressas em unidades métricas. |
Interface 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 representação em string do valor da distância, usando a UnitSystem especificada na solicitação. |
value |
Tipo:
number A distância em metros. |
Interface 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. |
Interface Tempo
Interface google.maps.Time
Uma representação de 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 tempo. O tempo é exibido no fuso horário da parada do transporte público. |
time_zone |
Tipo:
string O fuso horário em que a parada está localizada. 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 de partida ou chegada, especificado como um objeto de data JavaScript. |
Constantes DirectionsTravelMode
Constantes de google.maps.DirectionsTravelMode
Constantes DirectionsUnitSystem
Constantes de google.maps.DirectionsUnitSystem