Classe DirectionsService
google.maps.DirectionsService
classe
biblioteca "routes"
const {DirectionsService} = await google.maps.importLibrary("routes");
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 o 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
opcional |
Tipo:
boolean optionalSe true, instrui o serviço Directions a evitar balsas sempre que possível. Opcional. |
avoidHighways
opcional |
Tipo:
boolean optionalSe true, instrui o serviço Directions a evitar rodovias sempre que possível. Opcional. |
avoidTolls
opcional |
Tipo:
boolean optionalSe for true, instrui o serviço Directions a evitar vias com pedágio sempre que possível. Opcional. |
drivingOptions
opcional |
Tipo:
DrivingOptions optionalConfigurações que se aplicam apenas a solicitações em que travelMode é DRIVING. Esse objeto não terá efeito para outros meios de transporte. |
language
opcional |
Tipo:
string optionalUm identificador do idioma em que os resultados precisam ser retornados, quando possível. Consulte a lista de idiomas compatíveis. |
optimizeWaypoints
opcional |
Tipo:
boolean optionalSe definido como true, o DirectionsService vai tentar reordenar os waypoints intermediários fornecidos para minimizar o custo geral do trajeto. Se os waypoints forem otimizados, inspecione DirectionsRoute.waypoint_order na resposta para determinar a nova ordem. |
provideRouteAlternatives
opcional |
Tipo:
boolean optionalIndica se trajetos alternativos devem ser fornecidos ou não. Opcional. |
region
opcional |
Tipo:
string optionalCódigo de região utilizado como polarização para solicitações de geocodificação. O código de região aceita um valor de dois caracteres de 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
opcional |
Tipo:
TransitOptions optionalConfigurações que se aplicam apenas a solicitações em que travelMode é TRANSIT. Esse objeto não terá efeito para outros meios de transporte. |
unitSystem
opcional |
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
opcional |
Tipo:
Array<DirectionsWaypoint> optionalMatriz de pontos de referência intermediários. As rotas são calculadas da origem ao destino, passando por cada ponto de referência nessa matriz. Consulte o guia para desenvolvedores para saber o número máximo de waypoints permitidos. Não são permitidos waypoints nas rotas de transporte público. Opcional. |
Constantes DirectionsStatus
google.maps.DirectionsStatus
biblioteca de constantes
"routes"
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.
Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo DirectionsStatusString.
const {DirectionsStatus} = await google.maps.importLibrary("routes");
Constantes | |
|---|---|
INVALID_REQUEST |
O DirectionsRequest fornecido era inválido. |
MAX_WAYPOINTS_EXCEEDED |
Muitos DirectionsWaypoints foram fornecidos no DirectionsRequest. Consulte o guia para desenvolvedores para saber 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. É possível renderizar esses resultados usando um DirectionsRenderer ou analisar esse objeto e renderizá-lo por conta própria. Você precisa exibir os avisos e direitos autorais conforme indicado nos Termos de Serviço da Plataforma Google Maps. Embora esse resultado seja "semelhante ao JSON", ele não é estritamente JSON, porque inclui indiretamente objetos LatLng.
Propriedades | |
|---|---|
request |
Tipo:
DirectionsRequestO DirectionsRequest que gerou esse resultado. |
routes |
Tipo:
Array<DirectionsRoute>Uma matriz de DirectionsRoutes, cada uma com informações sobre os trechos e as etapas que a compõem. Só haverá uma rota, a menos que DirectionsRequest tenha sido feito com provideRouteAlternatives definido como true. |
available_travel_modes
opcional |
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 será retornado se um ou mais waypoints forem "via waypoints". |
geocoded_waypoints
opcional |
Tipo:
Array<DirectionsGeocodedWaypoint> optionalUma matriz de DirectionsGeocodedWaypoints, cada uma com informações sobre a geocodificação da origem, do destino e dos waypoints. |
Classe DirectionsRenderer
google.maps.DirectionsRenderer
classe
estende MVCObject
biblioteca "routes"
const {DirectionsRenderer} = await google.maps.importLibrary("routes");
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 <div> (como instruções textuais). |
Métodos | |
|---|---|
getDirections |
getDirections()Parâmetros: nenhum
Valor de retorno:
DirectionsResult|nullRetorna o conjunto de rotas atual do renderizador. |
getMap |
getMap()Parâmetros: nenhum
Valor de retorno:
Map|nullRetorna 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 de trajeto atual (com base em zero) em uso por esse 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 (com base em zero) do trajeto no objeto DirectionsResult a ser renderizado. Por padrão, o primeiro trajeto na matriz será renderizado. |
Herdado:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll
| |
Eventos | |
|---|---|
directions_changed |
function()Argumentos: nenhum
Esse evento é acionado quando as rotas renderizadas mudam, seja quando um novo DirectionsResult é definido ou quando o usuário termina de arrastar uma mudança no trajeto. |
Interface DirectionsRendererOptions
Interface
google.maps.DirectionsRendererOptions
Esse objeto define as propriedades que podem ser definidas em um objeto DirectionsRenderer.
Propriedades | |
|---|---|
directions
opcional |
Tipo:
DirectionsResult optionalAs rotas a serem exibidas no mapa e/ou em um painel <div>, recuperadas como um objeto DirectionsResult de DirectionsService. |
draggable
opcional |
Tipo:
boolean optionalSe for true, permite que o usuário arraste e modifique os caminhos dos trajetos renderizados por esse DirectionsRenderer. |
hideRouteList
opcional |
Tipo:
boolean optionalPadrão:
falseEssa propriedade indica se o renderizador precisa fornecer uma lista de rotas selecionáveis pelo usuário no painel de rotas. |
infoWindow
opcional |
Tipo:
InfoWindow optionalO InfoWindow em que as informações de texto serão renderizadas quando um marcador for 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
opcional |
Tipo:
Map optionalMapa no qual exibir as rotas. |
markerOptions
opcional |
Tipo:
MarkerOptions optionalOpções para os marcadores. Todos os marcadores renderizados pelo DirectionsRenderer vão usar essas opções. |
panel
opcional |
Tipo:
HTMLElement optionalO <div> em que as etapas de trajeto serão mostradas. |
polylineOptions
opcional |
Tipo:
PolylineOptions optionalOpções para as polilinhas. Todas as polilinhas renderizadas pelo DirectionsRenderer vão usar essas opções. |
preserveViewport
opcional |
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 ampliado para a caixa delimitadora desse conjunto de rotas. |
routeIndex
opcional |
Tipo:
number optionalO índice da rota no objeto DirectionsResult. O valor padrão é 0. |
suppressBicyclingLayer
opcional |
Tipo:
boolean optionalSuprime a renderização do BicyclingLayer quando rotas de bicicleta são solicitadas. |
suppressInfoWindows
opcional |
Tipo:
boolean optionalRemove a renderização da janela de informações. |
suppressMarkers
opcional |
Tipo:
boolean optionalRemove a renderização de marcadores. |
suppressPolylines
opcional |
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 roteirizada.
Propriedades | |
|---|---|
location
opcional |
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
opcional |
Tipo:
boolean optionalPadrão:
trueSe for true, indica que esse waypoint é uma parada entre a origem e o destino. Isso resulta na divisão do trajeto em dois trechos. Se for 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 waypoints em um mapa. |
Interface DirectionsGeocodedWaypoint
Interface
google.maps.DirectionsGeocodedWaypoint
Um único waypoint geocodificado.
Propriedades | |
|---|---|
partial_match
opcional |
Tipo:
boolean optionalSe o geocodificador não retornou uma correspondência exata para o waypoint original, mas conseguiu corresponder parte do endereço solicitado. |
place_id
opcional |
Tipo:
string optionalO ID de 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 os IDs de lugar no guia para desenvolvedores da API Places. |
types
opcional |
Tipo:
Array<string> optionalUma matriz de strings que denotam o tipo do elemento geocodificado retornado. Para ver uma lista de strings possíveis, consulte a seção Tipos de componentes de endereço do Guia para desenvolvedores. |
Interface DirectionsRoute
Interface
google.maps.DirectionsRoute
Um único trajeto que contém um conjunto de trechos em um DirectionsResult. Embora esse objeto seja "semelhante ao JSON", ele não é estritamente JSON, porque inclui objetos LatLng de forma direta e indireta.
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 com informações sobre as etapas que a compõem. Haverá um trecho para cada waypoint 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 eliminar ambiguidades em relação a alternativas. |
warnings |
Tipo:
Array<string>Avisos a serem exibidos quando estas rotas estiverem sendo mostradas. |
waypoint_order |
Tipo:
Array<number>Se optimizeWaypoints foi definido como true, esse campo vai conter a permutação reordenada dos waypoints de entrada. Por exemplo, se a entrada for:Origem: Los Angeles Pontos de referência: Dallas, Bangor, Phoenix Destino: Nova York e a saída otimizada for ordenada da seguinte maneira: Origem: Los Angeles Pontos de referência: Phoenix, Dallas, Bangor Destino: Nova York , esse campo será um Array contendo os valores [2, 0, 1]. A numeração dos pontos de referência é baseada em zero.Se algum dos pontos de passagem de entrada tiver stopover definido como false, esse campo vai ficar vazio, já que a otimização de rota não está disponível para essas consultas. |
fare
opcional |
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 ao JSON", ele não é estritamente JSON, porque 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 desse 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 estrada não estiver perto da origem desse trecho. |
steps |
Tipo:
Array<DirectionsStep>Uma matriz de DirectionsSteps, cada uma com 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 waypoints sem parada 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
opcional |
Tipo:
Time optionalUm horário estimado de chegada para esse trecho. Aplicável apenas a solicitações de transporte público. |
departure_time
opcional |
Tipo:
Time optionalUm horário estimado de partida para este trecho. Aplicável apenas a solicitações de transporte público. |
distance
opcional |
Tipo:
Distance optionalA distância total coberta por este trecho. Esta propriedade pode ser indefinida quando a distância não for conhecida. |
duration
opcional |
Tipo:
Duration optionalA duração total deste trecho. Essa propriedade pode ser undefined, já que a duração pode ser desconhecida. |
duration_in_traffic
opcional |
Tipo:
Duration optionalA duração total desse trecho, considerando as condições de trânsito indicadas pela propriedade trafficModel. Essa propriedade pode ser undefined, já que 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 ao JSON", ele não é estritamente JSON, porque inclui diretamente objetos LatLng.
Propriedades | |
|---|---|
encoded_lat_lngs |
Tipo:
stringUma representação de polilinha codificada da etapa. É 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 descreve o curso dessa etapa. É um caminho aproximado (suavizado) da etapa. |
maneuver |
Tipo:
stringContém a ação a ser realizada na 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 descreve o curso dessa etapa. É 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
opcional |
Tipo:
Distance optionalA distância coberta por esta etapa. Essa propriedade pode ser undefined, já que a distância pode ser desconhecida. |
duration
opcional |
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, já que a duração pode ser desconhecida. |
opcional |
Tipo:
DirectionsPolyline optionalContém um objeto com uma única propriedade, "points", que contém uma representação da polilinha codificada da etapa. Essa polilinha é um caminho aproximado (suavizado) da etapa. |
steps
opcional |
Tipo:
Array<DirectionsStep> optionalSubetapas desta etapa. Especificado para seções de rotas de transporte público que não são de transporte público. |
transit
opcional |
Tipo:
TransitDetails optionalDetalhes específicos do transporte público sobre essa etapa. Essa propriedade será indefinida, a menos que o meio de transporte dessa etapa seja TRANSIT. |
transit_details
opcional |
Tipo:
TransitDetails optionalDetalhes referentes a esta etapa se o meio de transporte for TRANSIT. |
Interface DirectionsPolyline
Interface
google.maps.DirectionsPolyline
Um objeto que contém uma propriedade points para descrever a polilinha de um DirectionsStep.
Propriedades | |
|---|---|
points |
Tipo:
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
opcional |
Tipo:
LatLng|LatLngLiteral optionalO LatLng da entidade descrita por este lugar. |
placeId
opcional |
Tipo:
string optionalO ID de lugar do lugar (como uma empresa ou um ponto de interesse). O ID de 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 para a API Geocoding. Para mais informações, consulte a visão geral dos IDs de lugar. |
query
opcional |
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, vai ocorrer um erro. |
Constantes TravelMode
google.maps.TravelMode
biblioteca de constantes
"routes"
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.
Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo TravelModeString.
const {TravelMode} = await google.maps.importLibrary("routes");
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 motocicletas. |
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 o trajeto, especificado como um objeto Date. O objeto Date mede o tempo em milissegundos desde 1º de janeiro de 1970. Isso precisa ser especificado 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
opcional |
Tipo:
TrafficModel optionalA suposição preferencial a ser usada ao prever a duração no trânsito. O padrão é BEST_GUESS. |
Constantes de TrafficModel
google.maps.TrafficModel
biblioteca de constantes
"routes"
As suposiçõ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.
Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo TrafficModelString.
const {TrafficModel} = await google.maps.importLibrary("routes");
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ânsito 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
opcional |
Tipo:
Date optionalO horário de chegada desejado para o trajeto, especificado como um objeto Date. 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
opcional |
Tipo:
Date optionalO horário de partida desejado para o trajeto, especificado como um objeto Date. O objeto Date mede o tempo em milissegundos desde 1º de janeiro de 1970. Se nenhum horário de partida ou de chegada for especificado, o horário será considerado como "agora". |
modes
opcional |
Tipo:
Array<TransitMode> optionalUm ou mais meios de transporte preferenciais, como ônibus ou trem. Se nenhuma preferência for informada, a API vai retornar o melhor trajeto padrão. |
routingPreference
opcional |
Tipo:
TransitRoutePreference optionalUma preferência que pode influenciar a escolha da rota de transporte público, como menos caminhadas. Se nenhuma preferência for informada, a API vai retornar o melhor trajeto padrão. |
Constantes TransitMode
google.maps.TransitMode
biblioteca de constantes
"routes"
O meio de transporte público 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.
Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo TransitModeString.
const {TransitMode} = await google.maps.importLibrary("routes");
Constantes | |
|---|---|
BUS |
Especifica o ônibus como meio de transporte preferencial. |
|
Especifica o veículo leve sobre trilhos (VLT) como meio de transporte preferencial. |
RAIL |
Especifica o transporte ferroviário como o meio de transporte preferencial. |
SUBWAY |
Especifica o metrô como meio de transporte preferencial. |
TRAIN |
Especifica o trem como meio de transporte preferencial. |
TRAM |
Especifica o bonde como meio de transporte preferencial. |
Constantes TransitRoutePreference
google.maps.TransitRoutePreference
biblioteca de constantes
"routes"
O tipo de trajeto de roteamento transitivo 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.
Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo TransitRoutePreferenceString.
const {TransitRoutePreference} = await google.maps.importLibrary("routes");
Constantes | |
|---|---|
FEWER_TRANSFERS |
Especifica que o trajeto calculado deve priorizar um número limitado de baldeações. |
LESS_WALKING |
Especifica que o trajeto calculado deve priorizar 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 fornecida. |
Interface TransitDetails
Interface
google.maps.TransitDetails
Detalhes sobre a partida, a chegada e o modo de transporte público usado nesta etapa.
Propriedades | |
|---|---|
arrival_stop |
Tipo:
TransitStopA parada de chegada desta etapa de transporte público. |
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 nessa parada. |
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:
stringTexto que aparece em horários e placas para identificar uma viagem de transporte público aos passageiros, por exemplo, para identificar números de trens em viagens de trem urbano. 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 da parada. |
name |
Tipo:
stringO nome da parada de transporte público. |
Interface TransitLine
Interface
google.maps.TransitLine
Informações sobre a linha de transporte público que opera essa etapa.
Propriedades | |
|---|---|
agencies |
Tipo:
Array<TransitAgency>A empresa de transporte público que opera essa linha. |
color |
Tipo:
stringA cor usada com frequência 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 da linha de transporte público, por exemplo, "8 Avenue Local". |
short_name |
Tipo:
stringO nome curto da linha de transporte público, por exemplo, "E". |
text_color |
Tipo:
stringA cor do texto usados com frequência na sinalização dessa linha de transporte público, representada como uma string hexadecimal. |
url |
Tipo:
stringO URL da empresa de transporte público específico para essa linha. |
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
google.maps.VehicleType
biblioteca de constantes
"routes"
Valores possíveis para tipos de veículo.
Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo VehicleTypeString.
const {VehicleType} = await google.maps.importLibrary("routes");
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 |
Dividir um táxi é uma forma de transporte de ônibus, com a possibilidade de deixar e pegar passageiros em qualquer ponto do trajeto. Geralmente, 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
google.maps.UnitSystem
biblioteca de constantes
"core"
Os sistemas de medidas válidos que podem ser especificados em um DirectionsRequest.
const {UnitSystem} = await google.maps.importLibrary("core");
Constantes | |
|---|---|
IMPERIAL |
Especifica que as distâncias no DirectionsResult precisam ser expressas em unidades imperiais. |
METRIC |
Especifica que as distâncias no DirectionsResult precisam 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 o UnitSystem especificado 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 Time
Interface
google.maps.Time
Uma representação de tempo como um objeto Date, uma string localizada e um fuso horário.
Propriedades | |
|---|---|
text |
Tipo:
stringUma string que representa o valor do horário. O tempo é exibido no fuso horário da parada do transporte público. |
time_zone |
Tipo:
stringO fuso horário em que essa parada está. 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 Date do JavaScript. |