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|LatLngLiteralLocal de destino. Isso pode ser especificado como uma string a ser geocodificada, um LatLng ou um Place. Obrigatório. |
origin |
Tipo:
string|LatLng|Place|LatLngLiteralLocal de origem. Isso pode ser especificado como uma string a ser geocodificada, um LatLng ou um Place. Obrigatório. |
travelMode |
Tipo:
TravelModeTipo de rota solicitada. Obrigatório. |
avoidFerries optional |
Tipo:
boolean optionalSe true, instrui o serviço Directions a evitar balsas sempre que possível. Opcional. |
avoidHighways optional |
Tipo:
boolean optionalSe true, instrui o serviço Directions a evitar rodovias sempre que possível. Opcional. |
avoidTolls optional |
Tipo:
boolean optionalSe true, instrui o serviço Directions a evitar vias com pedágio sempre que possível. Opcional. |
drivingOptions optional |
Tipo:
DrivingOptions optionalConfiguraçõ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 optionalUm identificador do idioma em que os resultados devem ser retornados, quando possível. Consulte a lista de idiomas compatíveis. |
optimizeWaypoints optional |
Tipo:
boolean optionalSe 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 optionalIndica se trajetos alternativos devem ser fornecidos ou não. Opcional. |
region optional |
Tipo:
string optionalCó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 optionalConfiguraçõ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 optionalPadrã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> optionalMatriz 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 DirectionsWaypoints 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:
DirectionsRequestO DirectionsRequest que gerou esse resultado. |
routes |
Tipo:
Array<DirectionsRoute>Uma matriz de DirectionsRoutes, 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> optionalConté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> optionalUma matriz de DirectionsGeocodedWaypoints, 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:
DirectionsResultRetorna o conjunto de rotas atual do renderizador. |
getMap |
getMap()Parâmetros:nenhum
Valor de retorno:
MapRetorna o mapa em que o DirectionsResult é renderizado. |
getPanel |
getPanel()Parâmetros:nenhum
Valor de retorno:
HTMLElement|nullRetorna o painel <div> em que o DirectionsResult é renderizado. |
getRouteIndex |
getRouteIndex()Parâmetros:nenhum
Valor de retorno:
numberRetorna 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 optionalAs rotas a serem mostradas no mapa e/ou em um painel <div>, recuperadas como um objeto DirectionsResult de DirectionsService. |
draggable optional |
Tipo:
boolean optionalSe true, permite que o usuário arraste e modifique os caminhos das rotas renderizadas por este DirectionsRenderer. |
hideRouteList optional |
Tipo:
boolean optionalPadrão:
falseEssa 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 optionalO 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 optionalMapa no qual exibir as rotas. |
markerOptions optional |
Tipo:
MarkerOptions optionalOpções para os marcadores. Todos os marcadores renderizados pelo DirectionsRenderer vão usar essas opções. |
panel optional |
Tipo:
HTMLElement optionalO <div> em que as etapas do trajeto serão mostradas. |
polylineOptions optional |
Tipo:
PolylineOptions optionalOpções para as polilinhas. Todas as polilinhas renderizadas pelo DirectionsRenderer vão usar essas opções. |
preserveViewport optional |
Tipo:
boolean optionalPadrão:
falseSe 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 optionalO índice da rota no objeto DirectionsResult. O valor padrão é 0. |
suppressBicyclingLayer optional |
Tipo:
boolean optionalSuprime a renderização do BicyclingLayer quando rotas de bicicleta são solicitadas. |
suppressInfoWindows optional |
Tipo:
boolean optionalRemove a renderização da janela de informações. |
suppressMarkers optional |
Tipo:
boolean optionalRemove a renderização de marcadores. |
suppressPolylines optional |
Tipo:
boolean optionalRemove 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 optionalLocal do ponto de referência. Pode ser uma string de endereço, um LatLng ou um Place. Opcional. |
stopover optional |
Tipo:
boolean optionalPadrão:
trueSe 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 optionalSe 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 optionalO 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> optionalUma 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:
LatLngBoundsOs limites para este trajeto. |
copyrights |
Tipo:
stringO texto de direitos autorais a ser exibido para este trajeto. |
legs |
Tipo:
Array<DirectionsLeg>Uma matriz de DirectionsLegs, 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 LatLngs 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:
stringUma representação de polilinha codificada do trajeto em overview_path. Essa polilinha é um caminho aproximado (suavizado) da rota resultante. |
summary |
Tipo:
stringConté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 optionalA 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:
stringO 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:
LatLngO 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:
stringO 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:
LatLngO 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 DirectionsSteps, 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 optionalUm horário estimado de chegada para este trecho. Aplicável somente a solicitações de TRANSIT. |
departure_time optional |
Tipo:
Time optionalUm horário estimado de partida para este trecho. Aplicável somente a solicitações de TRANSIT. |
distance optional |
Tipo:
Distance optionalA distância total coberta por este trecho. Esta propriedade pode ser indefinida quando a distância não for conhecida. |
duration optional |
Tipo:
Duration optionalA duração total deste trecho. Essa propriedade pode ser undefined porque a duração pode ser desconhecida. |
duration_in_traffic optional |
Tipo:
Duration optionalA 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:
stringUma representação de polilinha codificada da etapa. Esse é um caminho aproximado (suavizado) da etapa. |
end_location |
Tipo:
LatLngO local final desta etapa. |
|
Tipo:
LatLngO local final desta etapa. |
instructions |
Tipo:
stringInstruções para esta etapa. |
|
Uma sequência de LatLngs que descrevem o curso dessa etapa. Esse é um caminho aproximado (suavizado) da etapa. |
maneuver |
Tipo:
stringConté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 LatLngs que descrevem o curso dessa etapa. Esse é um caminho aproximado (suavizado) da etapa. |
start_location |
Tipo:
LatLngO local inicial desta etapa. |
|
Tipo:
LatLngO local inicial desta etapa. |
travel_mode |
Tipo:
TravelModeO modo de viagem usado nesta etapa. |
distance optional |
Tipo:
Distance optionalA distância coberta por esta etapa. Essa propriedade pode ser undefined porque a distância pode ser desconhecida. |
duration optional |
Tipo:
Duration optionalO 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 optionalConté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> optionalSubetapas desta etapa. Especificado para trechos não relacionados a transporte público de trajetos de transporte público. |
transit optional |
Tipo:
TransitDetails optionalDetalhes 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 optionalDetalhes 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:
stringUma 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 optionalO LatLng da entidade descrita por este lugar. |
placeId optional |
Tipo:
string optionalO 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 optionalUma 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. |
|
Especifica uma solicitação de rotas para veículos de duas rodas. |
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:
DateO 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 optionalA 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 optionalO 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 optionalO 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> optionalUm 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 optionalUma 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. |
|
Especifica o veículo leve sobre trilhos como um meio de transporte preferido. |
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:
stringUm código de moeda ISO 4217 que indica a moeda em que a tarifa é expressa. |
text |
Tipo:
stringO valor da tarifa, expresso na currency fornecida, como uma string. |
value |
Tipo:
numberO 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:
TransitStopA parada de chegada desta etapa de trânsito. |
arrival_time |
Tipo:
TimeO horário de chegada desta etapa, especificado como um objeto Time. |
departure_stop |
Tipo:
TransitStopA parada de partida desta etapa de transporte público. |
departure_time |
Tipo:
TimeO horário de partida desta etapa, especificado como um objeto Time. |
headsign |
Tipo:
stringA direção de deslocamento nessa linha, conforme marcada no veículo ou no ponto de partida. |
headway |
Tipo:
numberO número esperado de segundos entre veículos equivalentes nesse ponto. |
line |
Tipo:
TransitLineDetalhes sobre a linha de transporte público usada nesta etapa. |
num_stops |
Tipo:
numberO número de paradas nesta etapa. Esse número inclui a parada de chegada, mas não a de partida. |
trip_short_name |
Tipo:
stringO 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:
LatLngO local dessa parada. |
name |
Tipo:
stringO 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:
stringA cor normalmente usada na sinalização dessa linha de transporte público, representada como uma string hexadecimal. |
icon |
Tipo:
stringO URL de um ícone associado a essa linha. |
name |
Tipo:
stringO nome completo dessa linha de transporte, por exemplo, "8 Avenue Local". |
short_name |
Tipo:
stringO nome abreviado dessa linha de transporte público, por exemplo, "E". |
text_color |
Tipo:
stringA cor do texto normalmente usada na sinalização dessa linha de transporte público, representada como uma string hexadecimal. |
url |
Tipo:
stringO URL da agência específico para essa linha de transporte público. |
vehicle |
Tipo:
TransitVehicleO 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:
stringO nome da empresa de transporte público. |
phone |
Tipo:
stringO número de telefone da empresa de transporte público. |
url |
Tipo:
stringO 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:
stringUm URL para um ícone que corresponde ao tipo de veículo usado nessa linha. |
local_icon |
Tipo:
stringUm URL para um ícone que corresponde ao tipo de veículo usado nessa região, em vez do ícone mais geral. |
name |
Tipo:
stringUm nome para esse tipo de TransitVehicle, por exemplo, "Trem" ou "Ônibus". |
type |
Tipo:
VehicleTypeO 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:
stringUma representação em string do valor da distância, usando a UnitSystem especificada na solicitação. |
value |
Tipo:
numberA 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:
stringUma string que representa o valor da duração. |
value |
Tipo:
numberA 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:
stringUma string que representa o valor do tempo. O tempo é exibido no fuso horário da parada do transporte público. |
time_zone |
Tipo:
stringO 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:
DateO 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