DirectionsService
Classe
google.maps.DirectionsService
Um serviço para calcular rotas entre dois ou mais lugares.
Construtor | |
---|---|
DirectionsService |
DirectionsService() Parâmetros:nenhum
Cria uma nova instância de um DirectionsService que envia consultas de rotas aos 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. Ela pode ser especificada como uma string a ser geocodificada, um LatLng ou um Place . Obrigatório. |
origin |
Tipo:
string|LatLng|Place|LatLngLiteral Local de origem. Ela pode ser especificada 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 de rotas a evitar balsas sempre que possível. Opcional. |
avoidHighways optional |
Tipo:
boolean optional Se true , instrui o serviço de rotas a evitar rodovias sempre que possível. Opcional. |
avoidTolls optional |
Tipo:
boolean optional Se true , instrui o serviço de rotas a evitar vias com pedágio sempre que possível. Opcional. |
drivingOptions optional |
Tipo:
DrivingOptions optional Configurações válidas apenas para solicitações em que travelMode é DRIVING . Esse objeto não terá efeito para outros meios de transporte. |
|
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 definido como true , o DirectionsService tentará reordenar os waypoints intermediários fornecidos para minimizar o custo geral do trajeto. Se os waypoints estão 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 de região aceita um valor de ccTLD ("domínio de nível superior") de dois caracteres. 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 somente a solicitações em que travelMode é TRANSPORTE. Esse objeto não terá efeito para outros meios de transporte. |
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 referência nesta matriz. Consulte o guia do desenvolvedor para ver o número máximo de waypoints permitidos. Não são permitidos waypoints nas rotas de transporte público. Opcional. |
DirectionsStatus
google.maps.DirectionsStatus
constantes
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
.
Constantes | |
---|---|
INVALID_REQUEST |
O DirectionsRequest fornecido é inválido. |
MAX_WAYPOINTS_EXCEEDED |
Foram fornecidos muitos DirectionsWaypoint s no DirectionsRequest . Consulte o guia do desenvolvedor para ver o número máximo de waypoints 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. Você pode renderizá-la usando um DirectionsRenderer
ou pode analisar e renderizar esse objeto por conta própria. Exiba 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 objetos LatLng
indiretamente.
Propriedades | |
---|---|
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 feito com o 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 é retornado se um ou mais pontos de referência forem "via pontos de referência". |
geocoded_waypoints optional |
Tipo:
Array<DirectionsGeocodedWaypoint> optional Uma matriz de DirectionsGeocodedWaypoint s, cada um contendo informações sobre a geocodificação da origem, do destino e dos waypoints. |
DirectionsRenderer
Classe
google.maps.DirectionsRenderer
Renderiza rotas fornecidas pelo DirectionsService
.
Essa classe estende
MVCObject
.
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 um painel de <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 a DirectionsResult é renderizada. |
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
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 rotas 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. |
Herdadas:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Eventos | |
---|---|
directions_changed |
function() Argumentos: nenhum
Este evento é acionado quando as rotas renderizadas são alteradas, seja quando um novo DirectionsResult é definido ou quando o usuário termina de arrastar uma mudança 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 exibidas no mapa e/ou em um painel <div> , recuperado como um objeto DirectionsResult do DirectionsService . |
draggable optional |
Tipo:
boolean optional Se true , permite que o usuário arraste e modifique os caminhos dos trajetos renderizados 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 InfoWindow para renderizar informações de texto quando um marcador é clicado. O conteúdo da janela de informações existente será substituído e sua posição movida. Se nenhuma janela for especificada, o DirectionsRenderer vai criar e usar uma janela própria. 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 usarão essas opções. |
panel optional |
Tipo:
HTMLElement optional O <div> em que as etapas de rotas são exibidas. |
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 de entrada será centralizado e terá o 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 da BicyclingLayer quando as 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 roteada.
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 , esse ponto de referência é uma parada entre a origem e o destino. Isso resulta na divisão do trajeto em dois trechos. Se false , indica que a rota precisa ter um viés para passar por esse waypoint, mas não é dividida em dois trechos. Isso é útil se você quer criar um trajeto em resposta ao usuário arrastar pontos de referência em um mapa. |
Interface DirectionsGeoencodedWaypoint.
Interface google.maps.DirectionsGeocodedWaypoint
Um único ponto de referência geocodificado.
Propriedades | |
---|---|
partial_match optional |
Tipo:
boolean optional Se o geocodificador não retornou uma correspondência exata para o waypoint original, embora seja possível corresponder parte do endereço solicitado. |
place_id optional |
Tipo:
string optional 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 do desenvolvedor da API Places. |
types optional |
Tipo:
Array<string> optional Uma matriz de strings que denotam o tipo do elemento geocodificado retornado. Para ver uma lista de possíveis strings, consulte a seção Tipos de componentes de endereço do Guia do desenvolvedor. |
DirectionsRoute.
Interface google.maps.DirectionsRoute
Um trajeto 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 um contendo informações sobre as etapas das quais são compostas. Haverá um trecho para cada ponto de referência ou destino especificado. Assim, um trajeto sem waypoints com parada terá um DirectionsLeg e um trajeto com um waypoint com uma parada conterá dois. |
overview_path |
Uma matriz de LatLng s que representam todo o percurso desta rota. 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 for definido como true , esse campo conterá a permutação reordenada 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 foi ordenada da seguinte maneira: Origem: Los Angeles Waypoints: Phoenix, Dallas, Bangor Destino: Nova York , esse campo vai ser um Array contendo os valores [2, 0, 1]. A numeração dos pontos de referência é baseada em zero.Se algum dos waypoints de entrada tiver o stopover definido como false , esse 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 de toda a viagem de transporte público. Aplicável somente a solicitações de transporte público. |
Interface 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. 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. Este conteúdo deve ser lido no estado em que se encontra. Não analisa 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 via) nos 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 analisa 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 via) nos locais de início e término. start_location indica a origem geocodificada real, que pode ser diferente de start_location da primeira etapa se, por exemplo, a estrada não for próxima da origem deste trecho. |
steps |
Tipo:
Array<DirectionsStep> Uma matriz de DirectionsStep s, cada um contendo informações sobre etapas individuais neste trecho. |
|
Tipo:
Array<?> Informações sobre a velocidade do trânsito ao longo do trecho. |
via_waypoints |
Uma matriz de waypoints sem paradas ao longo deste trecho, que foram especificados na solicitação original. Descontinuado em rotas alternativas. A versão 3.27 será a última versão da API que adiciona 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 a rota principal até que ela corresponda a uma rota alternativa. |
arrival_time optional |
Tipo:
Time optional O horário estimado de chegada para este trecho. Aplicável somente para solicitações de TRANSPORTE PÚBLICO. |
departure_time optional |
Tipo:
Time optional O horário estimado de partida para este trecho. Aplicável somente para solicitações de TRANSPORTE PÚBLICO. |
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. Esta 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 . Esta propriedade pode ser undefined porque a duração pode ser desconhecida. |
DirectionsStep
Interface google.maps.DirectionsStep
Um único DirectionsStep
em um DirectionsResult
. Alguns campos podem ser undefined
. Embora esse objeto seja do tipo JSON, ele não é estritamente JSON, já que 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 descreve o percurso desta etapa. Esse é um caminho aproximado (suavizado) da etapa. |
maneuver |
Tipo:
string Contém a ação a ser tomada 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 descreve o percurso 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 é desconhecida. |
duration optional |
Tipo:
Duration optional O tempo normalmente necessário para a execução desta etapa, em segundos e no formato de texto. Esta 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 seções de não transporte público de trajetos de transporte público. |
transit optional |
Tipo:
TransitDetails optional Detalhes específicos do transporte público 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 DirectionsGeocoding
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 informações necessárias para localizar, identificar ou descrever um lugar para um DirectionsRequest
ou DistanceMatrixRequest
. Nesse contexto, "lugar" significa uma empresa, ponto de interesse ou 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 placeId em vez de query . Um ID de lugar pode ser recuperado de qualquer solicitação para a API Places, como uma TextSearch. Os IDs de lugar também podem ser recuperados em solicitações para a 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 ponto de interesse). Um exemplo de consulta é "Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW". Se possível, especifique placeId em vez de query . A API não garante a precisão da resolução da string de consulta em um local. Se placeId e query forem fornecidos, ocorrerá um erro. |
TravelMode
google.maps.TravelMode
constantes
Os meios de transporte válidos que podem ser especificados em uma 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
.
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 DriverOptions
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 o 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 a hora atual ou algum horário no futuro. Seu valor não pode estar no passado. |
trafficModel optional |
Tipo:
TrafficModel optional A melhor opção para prever a duração do tráfego. O padrão é BEST_GUESS . |
TrafficModel
google.maps.TrafficModel
constantes
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
.
Constantes | |
---|---|
BEST_GUESS |
Use dados de tráfego históricos 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 do tráfego. |
PESSIMISTIC |
Use dados históricos de tráfego para fazer uma estimativa pessimista da duração do tráfego. |
TransitOptions
Interface google.maps.TransitOptions
O objeto TransitOptions a ser incluído em uma DirectionsRequest
quando o modo de viagem estiver definido como TRANSPORTE.
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 para o trajeto, especificado como um objeto Date. O objeto "Date" mede o tempo em milissegundos desde 1o de janeiro de 1970. Se nem o horário de partida ou de chegada for especificado, o horário será considerado "agora". |
modes optional |
Tipo:
Array<TransitMode> optional Um ou mais meios de transporte público preferidos, como ônibus ou trem. Se nenhuma preferência for definida, a API retornará a melhor rota padrão. |
routingPreference optional |
Tipo:
TransitRoutePreference optional Uma preferência que pode influenciar a escolha do trajeto de transporte público, como menos caminhada. Se nenhuma preferência for definida, a API retornará a melhor rota padrão. |
TransitMode
google.maps.TransitMode
constantes
O meio de transporte público válido, por exemplo, um ônibus que pode ser especificado em uma TransitOptions
. Especifique-as por valor ou usando o nome da constante. Por exemplo, 'BUS'
ou google.maps.TransitMode.BUS
.
Constantes | |
---|---|
BUS |
Especifica o ônibus como meio de transporte público de sua preferência. |
RAIL |
Especifica o tipo de transporte ferroviário como forma de transporte público preferencial. |
SUBWAY |
Especifica o metrô como o meio de transporte público de sua preferência. |
TRAIN |
Especifica o trem como o modo de transporte público preferido. |
TRAM |
Especifica o bonde como meio de transporte preferido. |
TransitRoutePreference.
google.maps.TransitRoutePreference
constantes
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
.
Constantes | |
---|---|
FEWER_TRANSFERS |
Especifica que a rota calculada 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. |
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. |
Interface TransitDetails
Interface google.maps.TransitDetails
Detalhes sobre a partida, chegada e modo de transporte público usados nesta etapa.
Propriedades | |
---|---|
arrival_stop |
Tipo:
TransitStop O ponto 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 O ponto 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 em que você percorre essa linha, conforme indicado no veículo ou na parada 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 nesta 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 mostradores para identificar uma viagem de transporte público aos passageiros, por exemplo, identifica os números dos trens. O texto identifica apenas uma viagem no dia do serviço. |
Interface TransitStop
Interface google.maps.TransitStop
Detalhes sobre uma estação ou um ponto 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 a etapa de transporte público.
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 esta linha. |
name |
Tipo:
string O nome completo dessa linha de transporte público, por exemplo, "8 Avenida Paulista". |
short_name |
Tipo:
string O nome curto 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 empresa 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 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 É o URL de um ícone correspondente ao tipo de veículo usado na região em vez do ícone mais geral. |
name |
Tipo:
string Um nome para esse tipo de transporte público, por exemplo, "Trem" ou "Ônibus". |
type |
Tipo:
VehicleType O tipo de veículo usado, por exemplo, trem, ônibus ou balsa. |
VehicleType.
google.maps.VehicleType
constantes
Valores possíveis para tipos de veículo.
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 (VLT). |
MONORAIL |
Monotrilho. |
OTHER |
Outros veículos. |
RAIL |
Trem. |
SHARE_TAXI |
O táxi compartilhado é um tipo de ônibus, com a opção de desembarcar e pegar os passageiros no trajeto. Geralmente, o táxi compartilha veículos de micro-ônibus. |
SUBWAY |
Veículo leve subterrâneo. |
TRAM |
Veículo leve acima do chão. |
TROLLEYBUS |
Ônibus elétrico. |
UnitSystem (link em inglês)
google.maps.UnitSystem
constantes
Os sistemas de unidades válidos que podem ser especificados em um DirectionsRequest
.
Constantes | |
---|---|
IMPERIAL |
Especifica que as distâncias em DirectionsResult precisam ser expressas em unidades imperiais. |
METRIC |
Especifica que as distâncias em DirectionsResult precisam ser expressas em unidades métricas. |
Interface de distância
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 o UnitSystem especificado na solicitação. |
value |
Tipo:
number A distância em metros. |
Interface de duração
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 Time
Interface google.maps.Time
Uma representação de hora 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 fuso horário IANA, por exemplo, "América/Nova_York". |
value |
Tipo:
Date O horário de partida ou chegada, especificado como um objeto JavaScript Date. |
DirectionsTravelMode
google.maps.DirectionsTravelMode
constantes
DirectionsUnitSystem
google.maps.DirectionsUnitSystem
constantes