Clase DirectionsService
Clase google.maps.DirectionsService
Un servicio para calcular direcciones entre dos o más lugares.
Para acceder, llama a const {DirectionsService} = await google.maps.importLibrary("routes")
. Consulta Bibliotecas de la API de Maps JavaScript.
Constructor | |
---|---|
DirectionsService |
DirectionsService() Parámetros: Ninguno
Crea una instancia nueva de un DirectionsService que envía consultas sobre cómo llegar a los servidores de Google. |
Métodos | |
---|---|
route |
route(request[, callback]) Parámetros:
Valor que se muestra:
Promise<DirectionsResult> Emite una solicitud de búsqueda de instrucciones sobre cómo llegar. |
DirectionsRequest.
Interfaz google.maps.DirectionsRequest
Una consulta de instrucciones sobre cómo llegar que se enviará a DirectionsService
.
Propiedades | |
---|---|
destination |
Tipo:
string|LatLng|Place|LatLngLiteral Es la ubicación del destino. Esto se puede especificar como una string para geocodificar, o como LatLng o Place . Obligatorio. |
origin |
Tipo:
string|LatLng|Place|LatLngLiteral Ubicación de origen. Esto se puede especificar como una string para geocodificar, o como LatLng o Place . Obligatorio. |
travelMode |
Tipo:
TravelMode Tipo de enrutamiento solicitado. Obligatorio. |
avoidFerries optional |
Tipo:
boolean optional Si el valor es true , le indica al servicio Directions que evite los ferris siempre que sea posible. Opcional. |
avoidHighways optional |
Tipo:
boolean optional Si el valor es true , le indica al servicio Directions que evite las autopistas siempre que sea posible. Opcional. |
avoidTolls optional |
Tipo:
boolean optional Si el valor es true , le indica al servicio Directions que evite las rutas con peaje siempre que sea posible. Opcional. |
drivingOptions optional |
Tipo:
DrivingOptions optional Configuración que se aplica solo a las solicitudes en las que travelMode es DRIVING . Este objeto no tendrá efecto en otros medios de transporte. |
language optional |
Tipo:
string optional Un identificador de idioma para el idioma en el que se deben mostrar los resultados, cuando sea posible. Consulta la lista de idiomas compatibles. |
optimizeWaypoints optional |
Tipo:
boolean optional Si la estableces como true , DirectionsService intentará volver a ordenar los puntos de referencia intermedios proporcionados para minimizar el costo general de la ruta. Si los puntos de referencia están optimizados, inspecciona DirectionsRoute.waypoint_order en la respuesta para determinar el nuevo orden. |
provideRouteAlternatives optional |
Tipo:
boolean optional Indica si se deben proporcionar o no rutas alternativas. Opcional. |
region optional |
Tipo:
string optional Es el código de región que se usa como restricción para las solicitudes de geocodificación. El código de región acepta un valor ccTLD ("dominio de nivel superior") de dos caracteres. La mayoría de los códigos ccTLD son idénticos a los códigos ISO 3166-1, con algunas excepciones notables. Por ejemplo, el ccTLD del Reino Unido es "uk" ( .co.uk ), mientras que su código ISO 3166-1 es "gb" (técnicamente para la entidad de "Reino Unido de Gran Bretaña e Irlanda del Norte"). |
transitOptions optional |
Tipo:
TransitOptions optional Configuración que se aplica solo a las solicitudes en las que travelMode es TRANSIT. Este objeto no tendrá efecto en otros medios de transporte. |
unitSystem optional |
Tipo:
UnitSystem optional Predeterminado: El sistema de unidades que se usa en el país de origen.
Sistema de unidades preferido para mostrar la distancia |
waypoints optional |
Tipo:
Array<DirectionsWaypoint> optional Array de puntos de referencia intermedios. Las indicaciones se calculan desde el origen hasta el destino por medio de cada punto de referencia de este array. Consulta la guía para desarrolladores a fin de conocer la cantidad máxima de puntos de referencia permitidos. No se admiten los puntos de referencia para las rutas en transporte público. Opcional. |
Constantes de DirectionsStatus
Constantes google.maps.DirectionsStatus
Es el estado que muestra DirectionsService
cuando se completa una llamada a route()
. Especifícalas por valor o mediante el nombre de la constante. Por ejemplo, 'OK'
o google.maps.DirectionsStatus.OK
.
Para acceder, llama a const {DirectionsStatus} = await google.maps.importLibrary("routes")
. Consulta Bibliotecas de la API de Maps JavaScript.
Constantes | |
---|---|
INVALID_REQUEST |
La DirectionsRequest proporcionada no es válida. |
MAX_WAYPOINTS_EXCEEDED |
Se proporcionaron demasiados elementos DirectionsWaypoint en DirectionsRequest . Consulta la guía para desarrolladores a fin de conocer la cantidad máxima de puntos de referencia permitidos. |
NOT_FOUND |
No se pudo geocodificar al menos uno de los puntos de referencia, de origen o de destino. |
OK |
La respuesta contiene un DirectionsResult válido. |
OVER_QUERY_LIMIT |
La página web excedió el límite de solicitudes en un período demasiado corto. |
REQUEST_DENIED |
La página web no puede utilizar el servicio Directions. |
UNKNOWN_ERROR |
No se pudo procesar una solicitud de instrucciones sobre cómo llegar debido a un error del servidor. La solicitud podría completarse si realizas un nuevo intento. |
ZERO_RESULTS |
No se encontró ninguna ruta entre el origen y el destino. |
DirectionsResult
Interfaz google.maps.DirectionsResult
Respuesta de instrucciones sobre cómo llegar recuperada del servidor de instrucciones sobre cómo llegar. Puedes renderizarlos con un DirectionsRenderer
, o bien analizar este objeto y renderizarlo tú mismo. Debes mostrar las advertencias y los derechos de autor como se indica en las Condiciones del Servicio de Google Maps Platform. Ten en cuenta que, aunque este resultado es "similar a JSON", no es estrictamente JSON, ya que incluye objetos LatLng
de forma indirecta.
Propiedades | |
---|---|
request |
Tipo:
DirectionsRequest El objeto DirectionsRequest que produjo este resultado. |
routes |
Tipo:
Array<DirectionsRoute> Un array de DirectionsRoute , cada uno de los cuales contiene información sobre los segmentos y los pasos de los que se compone. Solo habrá una ruta, a menos que se haya creado DirectionsRequest con provideRouteAlternatives configurado como true . |
available_travel_modes optional |
Tipo:
Array<TravelMode> optional Contiene una variedad de medios de transporte disponibles. Este campo se muestra cuando una solicitud especifica un medio de transporte y no obtiene resultados. La matriz contiene los modos de viaje disponibles en los países del conjunto específico de waypoints. Este campo no se muestra si uno o más de los puntos de referencia son "via puntos de referencia". |
geocoded_waypoints optional |
Tipo:
Array<DirectionsGeocodedWaypoint> optional Un array de DirectionsGeocodedWaypoint , cada uno de los cuales contiene información sobre la geocodificación del origen, el destino y los puntos de referencia. |
DirectionsRenderer.
Clase google.maps.DirectionsRenderer
Renderiza las instrucciones obtenidas de DirectionsService
.
Esta clase extiende MVCObject
.
Para acceder, llama a const {DirectionsRenderer} = await google.maps.importLibrary("routes")
. Consulta Bibliotecas de la API de Maps JavaScript.
Constructor | |
---|---|
DirectionsRenderer |
DirectionsRenderer([opts]) Parámetros:
Crea el renderizador con las opciones determinadas. Las instrucciones sobre cómo llegar se pueden renderizar en un mapa (como superposiciones visuales) o, de manera adicional, en un panel <div> (como instrucciones textuales). |
Métodos | |
---|---|
getDirections |
getDirections() Parámetros: Ninguno
Valor que se muestra:
DirectionsResult Muestra el conjunto actual de instrucciones sobre cómo llegar del renderizador. |
getMap |
getMap() Parámetros: Ninguno
Valor que se muestra:
Map Muestra el mapa en el que se renderiza DirectionsResult . |
getPanel |
getPanel() Parámetros: Ninguno
Valor que se muestra:
HTMLElement|null Muestra el panel <div> en el que se renderiza DirectionsResult . |
getRouteIndex |
getRouteIndex() Parámetros: Ninguno
Valor que se muestra:
number Muestra el índice de ruta actual (basado en cero) que usa este objeto DirectionsRenderer . |
setDirections |
setDirections(directions) Parámetros:
Valor que se muestra: ninguno
Configura el procesador para usar el resultado de DirectionsService . Si estableces un conjunto válido de instrucciones sobre cómo llegar de esta manera, se mostrarán en el mapa y el panel designados por el renderizador. |
setMap |
setMap(map) Parámetros:
Valor que se muestra: ninguno
Este método especifica el mapa en el que se mostrarán las instrucciones sobre cómo llegar. Pasa null para quitar las instrucciones sobre cómo llegar del mapa. |
setOptions |
setOptions(options) Parámetros:
Valor que se muestra: ninguno
Cambia la configuración de las opciones de este DirectionsRenderer después de la inicialización. |
setPanel |
setPanel(panel) Parámetros:
Valor que se muestra: ninguno
Este método renderiza las instrucciones sobre cómo llegar en un objeto <div> . Pasa null para quitar el contenido del panel. |
setRouteIndex |
setRouteIndex(routeIndex) Parámetros:
Valor que se muestra: ninguno
Configura el índice (basado en cero) de la ruta en el objeto DirectionsResult que deseas renderizar. De forma predeterminada, se renderizará la primera ruta del array. |
Heredado:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Events | |
---|---|
directions_changed |
function() Argumentos: Ninguno
Este evento se activa cuando cambian las instrucciones sobre cómo llegar renderizadas, ya sea cuando se establece un nuevo objeto DirectionsResult o cuando el usuario termina de arrastrar un cambio en la ruta de acceso de las instrucciones sobre cómo llegar. |
DirectionsRendererOptions.
Interfaz google.maps.DirectionsRendererOptions
Este objeto define las propiedades que se pueden configurar en un objeto DirectionsRenderer
.
Propiedades | |
---|---|
directions optional |
Tipo:
DirectionsResult optional Indica las instrucciones sobre cómo llegar que se mostrarán en el mapa o en un panel <div> , recuperadas como un objeto DirectionsResult de DirectionsService . |
draggable optional |
Tipo:
boolean optional Si es true , permite que el usuario arrastre y modifique las rutas de las rutas que renderiza este DirectionsRenderer . |
hideRouteList optional |
Tipo:
boolean optional Valor predeterminado:
false Esta propiedad indica si el renderizador debe proporcionar una lista de rutas que el usuario pueda seleccionar y que se muestran en el panel de instrucciones sobre cómo llegar. |
infoWindow optional |
Tipo:
InfoWindow optional El InfoWindow en el que se debe renderizar información de texto cuando se hace clic en un marcador. Se reemplazará el contenido existente de la ventana de información y se moverá su posición. Si no se especifica ninguna ventana de información, DirectionsRenderer creará y usará su propia ventana de información. Se ignorará esta propiedad si se configura suppressInfoWindows como true . |
map optional |
Tipo:
Map optional Mapa en el que se mostrarán las instrucciones sobre cómo llegar |
markerOptions optional |
Tipo:
MarkerOptions optional Opciones para los marcadores. Todos los marcadores renderizados por DirectionsRenderer usarán estas opciones. |
panel optional |
Tipo:
HTMLElement optional El <div> en el que se muestran los pasos de las instrucciones sobre cómo llegar. |
polylineOptions optional |
Tipo:
PolylineOptions optional Opciones para las polilíneas. Todas las polilíneas renderizadas por DirectionsRenderer usarán estas opciones. |
preserveViewport optional |
Tipo:
boolean optional Valor predeterminado:
false Si esta opción se establece en true o nunca se establecieron el centro y el zoom del mapa, el mapa de entrada se centrará y se ampliará en función del cuadro delimitador de este conjunto de instrucciones sobre cómo llegar. |
routeIndex optional |
Tipo:
number optional El índice de la ruta dentro del objeto DirectionsResult . El valor predeterminado es 0. |
suppressBicyclingLayer optional |
Tipo:
boolean optional Elimina la renderización de BicyclingLayer cuando se solicitan instrucciones sobre cómo llegar en bicicleta. |
suppressInfoWindows optional |
Tipo:
boolean optional Elimina la renderización de ventanas de información. |
suppressMarkers optional |
Tipo:
boolean optional Elimina la renderización de marcadores. |
suppressPolylines optional |
Tipo:
boolean optional Elimina la renderización de polilíneas. |
Interfaz de DirectionsWaypoint
Interfaz google.maps.DirectionsWaypoint
Un objeto DirectionsWaypoint
representa una ubicación entre el origen y el destino a través de los cuales se debe enrutar el viaje.
Propiedades | |
---|---|
location optional |
Tipo:
string|LatLng|LatLngLiteral|Place optional Ubicación del punto de referencia. Puede ser una string de dirección, un LatLng o una Place . Opcional. |
stopover optional |
Tipo:
boolean optional Valor predeterminado:
true Si es true , indica que este punto de referencia es una parada entre el origen y el destino. Esto tiene el efecto de dividir la ruta en dos tramos. Si es false , indica que se debe personalizar la ruta para pasar por este punto de referencia, pero no se debe dividir en dos segmentos. Esto resulta útil si deseas crear una ruta en respuesta a que el usuario arrastre los puntos de referencia en un mapa. |
Interfaz de DirectionsGeocodedWaypoint
Interfaz google.maps.DirectionsGeocodedWaypoint
Un único punto de referencia con geocodificación.
Propiedades | |
---|---|
partial_match optional |
Tipo:
boolean optional Indica si el geocodificador no devolvió una coincidencia exacta para el punto de referencia original, aunque sí pudo establecer una coincidencia parcial para la dirección solicitada. |
place_id optional |
Tipo:
string optional El ID de lugar asociado con el punto de referencia. Los IDs de lugar identifican de forma exclusiva un sitio en la base de datos de Google Places y en Google Maps. Obtén más información sobre los IDs de lugar en la guía para desarrolladores de la API de Places. |
types optional |
Tipo:
Array<string> optional Matriz de cadenas que denota el tipo del elemento geocodificado que se muestra. Para obtener una lista de cadenas posibles, consulta la sección Tipos de componentes de dirección de la Guía para desarrolladores. |
DirectionsRoute.
Interfaz google.maps.DirectionsRoute
Una sola ruta que contiene un conjunto de segmentos en un DirectionsResult
. Ten en cuenta que, aunque este objeto es “similar a JSON”, no es estrictamente JSON, ya que incluye objetos LatLng
de forma directa e indirecta.
Propiedades | |
---|---|
bounds |
Tipo:
LatLngBounds Los límites de esta ruta. |
copyrights |
Tipo:
string Texto de derechos de autor que se debe mostrar para esta ruta. |
legs |
Tipo:
Array<DirectionsLeg> Un array de DirectionsLeg , cada uno de los cuales contiene información sobre los pasos que lo componen. Habrá un segmento por cada punto de referencia o destino de parada especificados. Por lo tanto, una ruta sin puntos de referencia de parada contendrá un DirectionsLeg , y una ruta con un punto de referencia de parada contendrá dos. |
overview_path |
Un array de LatLng que representa el recorrido completo de esta ruta. La ruta se simplifica para que sea adecuada en contextos en los que se requiere una pequeña cantidad de vértices (como las URLs de Static Maps API). |
overview_polyline |
Tipo:
string Es una representación de polilínea codificada de la ruta en overview_path. Esta polilínea es una ruta aproximada (unificada) a partir de las indicaciones resultantes. |
summary |
Tipo:
string Contiene una descripción textual corta de la ruta, adecuada para indicar un nombre y diferenciarla de otras alternativas. |
warnings |
Tipo:
Array<string> Advertencias que se deben mostrar al mostrar estas instrucciones sobre cómo llegar |
waypoint_order |
Tipo:
Array<number> Si optimizeWaypoints se configuró como true , este campo contendrá la permutación reordenada de los puntos de referencia de entrada. Por ejemplo, si la entrada fue:Origen: Los Ángeles Puntos de referencia: Dallas, Bangor, Phoenix Destino: Nueva York y el resultado optimizado se ordenó de la siguiente manera: Origen: Los Ángeles Puntos de referencia: Phoenix, Dallas, Bangor Destino: Nueva York , este campo será un Array con los valores [2, 0, 1]. Ten en cuenta que la numeración de los puntos de referencia se basa en cero.Si alguno de los puntos de referencia de entrada tiene el valor stopover establecido en false , este campo estará vacío, ya que la optimización de rutas no está disponible para esas consultas. |
fare optional |
Tipo:
TransitFare optional Es la tarifa total del viaje en transporte público. Solo se aplica a las solicitudes de transporte público. |
DirectionsLeg
Interfaz google.maps.DirectionsLeg
Una sola etapa que consta de un conjunto de pasos en una DirectionsResult
. Es posible que algunos campos del segmento no se muestren para todas las solicitudes. Ten en cuenta que, aunque este resultado es "similar a JSON", no es estrictamente JSON, ya que incluye objetos LatLng
de manera directa e indirecta.
Propiedades | |
---|---|
end_address |
Tipo:
string Es la dirección del destino de este segmento. Este contenido debe leerse tal como está. No analices la dirección con formato de manera programática. |
end_location |
Tipo:
LatLng DirectionsService calcula las instrucciones sobre cómo llegar entre ubicaciones con la opción de transporte más cercana (por lo general, una ruta) en las ubicaciones de partida y de destino. end_location indica el destino geocodificado real, que puede diferir del valor end_location del último paso si, por ejemplo, la ruta no está cerca del destino de este segmento. |
start_address |
Tipo:
string Es la dirección donde se originó este segmento. Este contenido debe leerse tal como está. No analices la dirección con formato de manera programática. |
start_location |
Tipo:
LatLng DirectionsService calcula las instrucciones sobre cómo llegar entre ubicaciones con la opción de transporte más cercana (por lo general, una ruta) en las ubicaciones de partida y de destino. start_location indica el origen geocodificado real, que puede diferir del valor start_location del primer paso si, por ejemplo, la ruta no se encuentra cerca del origen de este segmento. |
steps |
Tipo:
Array<DirectionsStep> Un array de DirectionsStep , cada uno de los cuales contiene información sobre los pasos individuales de este segmento. |
|
Tipo:
Array<?> Información sobre la velocidad del tráfico en el tramo. |
via_waypoints |
Un array de puntos de referencia sin paradas a lo largo de este segmento, que se especificaron en la solicitud original. Obsoleto en rutas alternativas. La versión 3.27 será la última versión de la API que agrega Al usar el servicio de indicaciones para implementar indicaciones arrastrables, se recomienda inhabilitar el arrastre de rutas alternativas. Solo la ruta principal debe ser arrastrable. Los usuarios pueden arrastrar la ruta principal hasta que coincida con una alternativa. |
arrival_time optional |
Tipo:
Time optional Hora de llegada estimada para este segmento. Solo se aplica a las solicitudes de TRANSIT. |
departure_time optional |
Tipo:
Time optional Hora de salida estimada para este segmento. Solo se aplica a las solicitudes de TRANSIT. |
distance optional |
Tipo:
Distance optional La distancia total cubierta por este segmento. Esta propiedad puede no definirse, ya que se desconoce la distancia. |
duration optional |
Tipo:
Duration optional Es la duración total de este segmento. Esta propiedad puede ser undefined , ya que se desconoce la duración. |
duration_in_traffic optional |
Tipo:
Duration optional Es la duración total de este segmento, teniendo en cuenta las condiciones de tráfico indicadas por la propiedad trafficModel . Esta propiedad puede ser undefined , ya que se desconoce la duración. |
DirectionsStep.
Interfaz google.maps.DirectionsStep
Un solo DirectionsStep
en una DirectionsResult
. Algunos campos pueden ser undefined
. Ten en cuenta que, aunque este objeto es “similar a JSON”, no es estrictamente JSON, ya que incluye objetos LatLng
de forma directa.
Propiedades | |
---|---|
encoded_lat_lngs |
Tipo:
string Una representación de polilínea codificada del paso. Esta es una ruta aproximada (unificada) del paso. |
end_location |
Tipo:
LatLng Es la ubicación final de este paso. |
|
Tipo:
LatLng Es la ubicación final de este paso. |
instructions |
Tipo:
string Instrucciones para este paso. |
|
Una secuencia de LatLng que describen el curso de este paso. Esta es una ruta aproximada (unificada) del paso. |
maneuver |
Tipo:
string Contiene la acción que se debe realizar para el paso actual ( turn-left , merge , straight , etcétera). Los valores están sujetos a cambios, y es posible que se ingresen nuevos sin previo aviso. |
path |
Una secuencia de LatLng que describen el curso de este paso. Esta es una ruta aproximada (unificada) del paso. |
start_location |
Tipo:
LatLng Es la ubicación inicial de este paso. |
|
Tipo:
LatLng Es la ubicación inicial de este paso. |
travel_mode |
Tipo:
TravelMode Indica el medio de transporte que se usa en este paso. |
distance optional |
Tipo:
Distance optional La distancia cubierta en este paso. Es posible que esta propiedad tenga un valor de undefined , ya que se desconoce la distancia. |
duration optional |
Tipo:
Duration optional El tiempo típico que se requiere para realizar este paso en segundos y en formato de texto. Esta propiedad puede ser undefined , ya que se desconoce la duración. |
|
Tipo:
DirectionsPolyline optional Contiene un objeto con una sola propiedad, "points", que incluye una representación de la polilínea codificada del paso. Esta polilínea es una ruta aproximada (unificada) del paso. |
steps optional |
Tipo:
Array<DirectionsStep> optional Pasos secundarios de este paso. Se especifica para las secciones que no son de transporte público de las rutas de transporte público. |
transit optional |
Tipo:
TransitDetails optional Detalles específicos del transporte público sobre este paso. Esta propiedad no se definirá, a menos que el medio de transporte para este paso sea TRANSIT . |
transit_details optional |
Tipo:
TransitDetails optional Son los detalles de este paso si el medio de transporte es TRANSIT . |
DirectionsPolyline
Interfaz google.maps.DirectionsPolyline
Es un objeto que contiene una propiedad points
para describir la polilínea de una DirectionsStep
.
Propiedades | |
---|---|
points |
Tipo:
string |
Place
Interfaz google.maps.Place
Contiene información necesaria para ubicar, identificar o describir un lugar en DirectionsRequest
o DistanceMatrixRequest
. En este contexto, "lugar" hace referencia a una empresa, un lugar de interés o una ubicación geográfica. Para obtener información sobre un lugar, consulta PlacesService
.
Propiedades | |
---|---|
location optional |
Tipo:
LatLng|LatLngLiteral optional El LatLng de la entidad descrita por este lugar. |
placeId optional |
Tipo:
string optional Es el ID del lugar (como una empresa o un lugar de interés). El ID de lugar es un identificador único de un sitio en la base de datos de Google Maps. Ten en cuenta que placeId es la forma más precisa de identificar un lugar. Si es posible, debes especificar el placeId en lugar de un query . Un ID de lugar se puede recuperar de cualquier solicitud a la API de Places, como una TextSearch. Los IDs de lugar también se pueden recuperar a partir de solicitudes a la API de Geocoding. Para obtener más información, consulta la descripción general de los IDs de lugar. |
query optional |
Tipo:
string optional Una búsqueda que describe el lugar (como una empresa o un lugar de interés). Un ejemplo de consulta es “Quay, Upper Level, Overseas Pasa Terminal 5 Hickson Road, The Rocks NSW”. Si es posible, debes especificar el placeId en lugar de un query . La API no garantiza la precisión de resolver la cadena de consulta a un sitio. Si se proporcionan placeId y query , se produce un error. |
Constantes de TravelMode
Constantes google.maps.TravelMode
Los medios de transporte válidos que se pueden especificar en un DirectionsRequest
y los medios de transporte que se muestran en un DirectionsStep
Especifícalas por valor o mediante el nombre de la constante. Por ejemplo, 'BICYCLING'
o google.maps.TravelMode.BICYCLING
.
Para acceder, llama a const {TravelMode} = await google.maps.importLibrary("routes")
. Consulta Bibliotecas de la API de Maps JavaScript.
Constantes | |
---|---|
BICYCLING |
Especifica una solicitud de ruta en bicicleta. |
DRIVING |
Especifica una solicitud de ruta en auto. |
TRANSIT |
Especifica una solicitud de ruta en transporte público. |
WALKING |
Especifica una solicitud de instrucciones sobre cómo llegar a pie. |
DrivingOptions
Interfaz google.maps.DrivingOptions
Configura DirectionsRequest
cuando el medio de transporte se establece en DRIVING
.
Propiedades | |
---|---|
departureTime |
Tipo:
Date La hora de salida deseada para la ruta, especificada como un objeto Date . El objeto Date mide el tiempo en milisegundos desde el 1 de enero de 1970. Se debe especificar este valor para que un DrivingOptions sea válido. La hora de salida debe establecerse en la hora actual o en una hora futura determinada. No puede ser un horario pasado. |
trafficModel optional |
Tipo:
TrafficModel optional Es la suposición preferida para predecir la duración en el tráfico. El valor predeterminado es BEST_GUESS . |
Constantes de TrafficModel
Constantes google.maps.TrafficModel
Son las suposiciones que se usarán para predecir la duración en el tráfico. Se especifica como parte de un DirectionsRequest
o DistanceMatrixRequest
. Especifícalas por valor o mediante el nombre de la constante. Por ejemplo, 'bestguess'
o google.maps.TrafficModel.BEST_GUESS
.
Para acceder, llama a const {TrafficModel} = await google.maps.importLibrary("routes")
. Consulta Bibliotecas de la API de Maps JavaScript.
Constantes | |
---|---|
BEST_GUESS |
Usa los datos históricos de tráfico para calcular mejor el tiempo dedicado al tráfico. |
OPTIMISTIC |
Usa los datos históricos de tráfico para realizar una estimación optimista de la duración del tráfico. |
PESSIMISTIC |
Usa los datos históricos de tráfico para realizar una estimación pesimista de la duración en el tráfico. |
TransitOptions
Interfaz google.maps.TransitOptions
El objeto TransitOptions que se incluirá en una DirectionsRequest
cuando el medio de transporte se configure en TRANSIT.
Propiedades | |
---|---|
arrivalTime optional |
Tipo:
Date optional La hora de llegada deseada para la ruta, especificada como un objeto Date. El objeto Date mide el tiempo en milisegundos desde el 1 de enero de 1970. Si se especifica la hora de llegada, se ignora la hora de partida. |
departureTime optional |
Tipo:
Date optional La hora de salida deseada para la ruta, especificada como un objeto Date. El objeto Date mide el tiempo en milisegundos desde el 1 de enero de 1970. Si no se especifica la hora de salida ni la de llegada, se supone que la hora es “ahora”. |
modes optional |
Tipo:
Array<TransitMode> optional Uno o más medios de transporte público, como autobús o tren. Si no se otorga ninguna preferencia, la API muestra la mejor ruta predeterminada. |
routingPreference optional |
Tipo:
TransitRoutePreference optional Una preferencia que puede sesgar la elección de la ruta de transporte público, como menos caminata. Si no se otorga ninguna preferencia, la API muestra la mejor ruta predeterminada. |
Constantes de TransitMode
Constantes google.maps.TransitMode
El medio de transporte público válido, p.ej., autobús que se puede especificar en un TransitOptions
. Especifícalas por valor o mediante el nombre de la constante. Por ejemplo, 'BUS'
o google.maps.TransitMode.BUS
.
Para acceder, llama a const {TransitMode} = await google.maps.importLibrary("routes")
. Consulta Bibliotecas de la API de Maps JavaScript.
Constantes | |
---|---|
BUS |
Especifica el autobús como medio de transporte público preferido. |
RAIL |
Especifica el tren como medio de transporte público preferido. |
SUBWAY |
Especifica el metro como medio de transporte público preferido. |
TRAIN |
Especifica el tren como medio de transporte público preferido. |
TRAM |
Especifica el tranvía como medio de transporte público preferido. |
Constantes TransitRoutePreference
Constantes google.maps.TransitRoutePreference
El tipo de ruta de transporte público válido que se puede especificar en un TransitOptions
. Especifícalas por valor o mediante el nombre de la constante. Por ejemplo, 'LESS_WALKING'
o google.maps.TransitRoutePreference.LESS_WALKING
.
Para acceder, llama a const {TransitRoutePreference} = await google.maps.importLibrary("routes")
. Consulta Bibliotecas de la API de Maps JavaScript.
Constantes | |
---|---|
FEWER_TRANSFERS |
Especifica que, para la ruta calculada, debe priorizarse una cantidad limitada de transbordos. |
LESS_WALKING |
Especifica que, para la ruta calculada, debe priorizarse una distancia limitada de recorrido a pie. |
TransitFare
Interfaz google.maps.TransitFare
Es una tarifa de DirectionsRoute
compuesta por el valor y la moneda.
Propiedades | |
---|---|
currency |
Tipo:
string Un código de moneda ISO 4217 que indica la moneda en la que se expresa la tarifa. |
value |
Tipo:
number Es el valor numérico de la tarifa, expresado en el currency especificado. |
TransitDetails
Interfaz google.maps.TransitDetails
Detalles sobre la salida, la llegada y el medio de transporte utilizados en este paso.
Propiedades | |
---|---|
arrival_stop |
Tipo:
TransitStop Es la parada de llegada de este paso de transporte público. |
arrival_time |
Tipo:
Time La hora de llegada de este paso, especificada como un objeto Time. |
departure_stop |
Tipo:
TransitStop Es la parada de salida de este paso de transporte público. |
departure_time |
Tipo:
Time La hora de salida de este paso, especificada como un objeto Time. |
headsign |
Tipo:
string La dirección en la que se debe viajar en esta línea, como se marca en el vehículo o en la parada de salida |
headway |
Tipo:
number La cantidad de segundos previstos entre vehículos equivalentes en esta parada. |
line |
Tipo:
TransitLine Detalles sobre la línea de transporte público utilizada en este paso. |
num_stops |
Tipo:
number Es la cantidad de paradas en este paso. Incluye la parada de llegada, pero no la de salida. |
trip_short_name |
Tipo:
string Es el texto que aparece en los horarios y carteles para que los pasajeros identifiquen un viaje de transporte público; por ejemplo, para que identifiquen los números de tren en los viajes diarios. El texto identifica de forma exclusiva un viaje durante un día de servicio. |
TransitStop
Interfaz google.maps.TransitStop
Son detalles sobre una parada o estación de transporte público.
Propiedades | |
---|---|
location |
Tipo:
LatLng Es la ubicación de esta parada. |
name |
Tipo:
string Es el nombre de esta parada de transporte público. |
TransitLine
Interfaz google.maps.TransitLine
Incluye información sobre la línea de transporte público que realiza este paso.
Propiedades | |
---|---|
agencies |
Tipo:
Array<TransitAgency> Es la empresa de transporte público que opera esta línea de transporte público. |
color |
Tipo:
string Color que se suele usar en la señalización de esta línea de transporte público, representado con una cadena hexadecimal. |
icon |
Tipo:
string La URL de un ícono asociado con esta línea. |
name |
Tipo:
string El nombre completo de esta línea de transporte público, p.ej., "8 Avenue Local". |
short_name |
Tipo:
string El nombre corto de esta línea de transporte público, p.ej., "E". |
text_color |
Tipo:
string El color del texto que se suele usar en la señalización de esta línea de transporte público, representado como una cadena hexadecimal. |
url |
Tipo:
string La URL de la empresa que es específica de esta línea de transporte público. |
vehicle |
Tipo:
TransitVehicle Indica el tipo de vehículo que se usa, p.ej., tren o autobús. |
Interfaz de TransitAgency
Interfaz google.maps.TransitAgency
Incluye información sobre una empresa que opera una línea de transporte público.
Propiedades | |
---|---|
name |
Tipo:
string Es el nombre de la empresa de transporte público. |
phone |
Tipo:
string El número de teléfono de la empresa de transporte público |
url |
Tipo:
string URL de la empresa de transporte público. |
Interfaz de TransitVehicle
Interfaz google.maps.TransitVehicle
Incluye información sobre el vehículo que opera en una línea de transporte público.
Propiedades | |
---|---|
icon |
Tipo:
string Es una URL para un ícono que corresponde al tipo de vehículo que se usa en esta línea. |
local_icon |
Tipo:
string Es una URL para un ícono que corresponde al tipo de vehículo que se usa en esta región en lugar del ícono más general. |
name |
Tipo:
string Es un nombre para este tipo de TransitVehicle, p.ej., "Tren" o "Bus". |
type |
Tipo:
VehicleType Indica el tipo de vehículo que se usa, p.ej., tren, autobús o transbordador. |
Constantes de VehicleType
Constantes google.maps.VehicleType
Valores posibles para los tipos de vehículos
Para acceder, llama a const {VehicleType} = await google.maps.importLibrary("routes")
. Consulta Bibliotecas de la API de Maps JavaScript.
Constantes | |
---|---|
BUS |
Autobús |
CABLE_CAR |
Un vehículo que funciona con un cable y generalmente sobre el suelo; Los teleféricos pueden ser del tipo GONDOLA_LIFT . |
COMMUTER_TRAIN |
Ferrocarril suburbano |
FERRY |
Ferry |
FUNICULAR |
Un vehículo que sube por una pendiente pronunciada a través de un cable; |
GONDOLA_LIFT |
Un funicular aéreo |
HEAVY_RAIL |
Ferrocarril metropolitano |
HIGH_SPEED_TRAIN |
Tren de alta velocidad |
INTERCITY_BUS |
Autobús interurbano |
METRO_RAIL |
Tren ligero |
MONORAIL |
Monorriel |
OTHER |
Otros vehículos |
RAIL |
Ferrocarril |
SHARE_TAXI |
El transporte "share taxi" es una clase de transporte en autobús que puede dejar y recoger pasajeros en cualquier punto de su ruta. Generalmente, los taxis de uso compartido usan vehículos minibús. |
SUBWAY |
Tren ligero subterráneo |
TRAM |
Tren ligero sobre el suelo |
TROLLEYBUS |
Trolebús |
Constantes UnitSystem
Constantes google.maps.UnitSystem
Los sistemas de unidades válidos que se pueden especificar en un DirectionsRequest
.
Para acceder, llama a const {UnitSystem} = await google.maps.importLibrary("core")
. Consulta Bibliotecas de la API de Maps JavaScript.
Constantes | |
---|---|
IMPERIAL |
Especifica que las distancias en DirectionsResult se deben expresar en unidades imperiales. |
METRIC |
Especifica que las distancias en DirectionsResult se deben expresar en unidades métricas. |
Distance
Interfaz google.maps.Distance
Es una representación de la distancia como un valor numérico y una string de visualización.
Propiedades | |
---|---|
text |
Tipo:
string Una representación de string del valor de distancia, con el UnitSystem especificado en la solicitud. |
value |
Tipo:
number Es la distancia en metros. |
Duration.
Interfaz google.maps.Duration
Es una representación de la duración como un valor numérico y una string de visualización.
Propiedades | |
---|---|
text |
Tipo:
string Representación de cadena del valor de duración. |
value |
Tipo:
number Es la duración en segundos. |
Time
Interfaz google.maps.Time
Una representación de la hora como un objeto Date, una string localizada y una zona horaria.
Propiedades | |
---|---|
text |
Tipo:
string Es una cadena que representa el valor de la hora. La hora se muestra en la zona horaria de la parada de transporte. |
time_zone |
Tipo:
string La zona horaria en la que se encuentra esta parada. El valor es el nombre de la zona horaria tal como se define en la base de datos de zonas horarias de IANA, p.ej., “America/New_York”. |
value |
Tipo:
Date La hora de esta salida o llegada, especificada como un objeto JavaScript Date. |
Constantes DirectionsTravelMode
Constantes google.maps.DirectionsTravelMode
Constantes DirectionsUnitSystem
Constantes google.maps.DirectionsUnitSystem