Clase DirectionsService
Clase google.maps.DirectionsService
Es un servicio para calcular direcciones entre dos o más lugares.
Para acceder, llama a const {DirectionsService} = await google.maps.importLibrary("routes")
. Consulta el artículo 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 las instrucciones sobre cómo llegar a los servidores de Google. |
Métodos | |
---|---|
route |
route(request[, callback]) Parámetros:
Valor que se devuelve:
Promise<DirectionsResult> Emite una solicitud de búsqueda de instrucciones sobre cómo llegar. |
Interfaz de DirectionsRequest
Interfaz de google.maps.DirectionsRequest
Una consulta de instrucciones sobre cómo llegar que se enviará a DirectionsService
Propiedades | |
---|---|
destination |
Tipo:
string|LatLng|Place|LatLngLiteral Ubicación del destino. Esto se puede especificar como una cadena que se geocodificará, o bien como LatLng o Place . Obligatorio. |
origin |
Tipo:
string|LatLng|Place|LatLngLiteral Ubicación de origen. Esto se puede especificar como una cadena que se geocodificará, o bien como LatLng o Place . Obligatorio. |
travelMode |
Tipo:
TravelMode Tipo de enrutamiento solicitado. Obligatorio. |
avoidFerries optional |
Tipo:
boolean optional Si es true , le indica al servicio Directions que evite los transbordadores siempre que sea posible. Opcional. |
avoidHighways optional |
Tipo:
boolean optional Si es true , le indica al servicio Directions que evite las autopistas siempre que sea posible. Opcional. |
avoidTolls optional |
Tipo:
boolean optional Si 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 se establece en 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 rutas alternativas o no. Opcional. |
region optional |
Tipo:
string optional Es el código de región que se usa como personalización para las solicitudes de geocodificación. El código de región acepta un valor de 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 del "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: Es el sistema de unidades que se usa en el país de origen.
Sistema de unidades preferido que se debe usar para mostrar la distancia. |
waypoints optional |
Tipo:
Array<DirectionsWaypoint> optional Array de puntos de referencia intermedios. Las instrucciones sobre cómo llegar se calculan desde el origen hasta el destino a través de cada punto de referencia en 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 finaliza una llamada a route()
. Especifícalas por valor o con 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 el artículo Bibliotecas de la API de Maps JavaScript.
Constantes | |
---|---|
INVALID_REQUEST |
La DirectionsRequest proporcionada no es válida. |
MAX_WAYPOINTS_EXCEEDED |
Se proporcionaron demasiados 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 usar el servicio de instrucciones sobre cómo llegar. |
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 de google.maps.DirectionsResult
Respuesta recuperada del servidor de indicaciones. Puedes renderizarlos con un DirectionsRenderer
o analizar este objeto y renderizarlo por tu cuenta. 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 manera indirecta.
Propiedades | |
---|---|
request |
Tipo:
DirectionsRequest Es el objeto DirectionsRequest que produjo este resultado. |
routes |
Tipo:
Array<DirectionsRoute> Un array de DirectionsRoute , cada uno de los cuales contiene información sobre las etapas y los pasos de los que está compuesta. Solo habrá una ruta, a menos que el DirectionsRequest se haya creado con provideRouteAlternatives configurado como true . |
available_travel_modes optional |
Tipo:
Array<TravelMode> optional Contiene un array 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 devuelve 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. |
Clase DirectionsRenderer
Clase google.maps.DirectionsRenderer
Renderiza las instrucciones sobre cómo llegar obtenidas de DirectionsService
.
Esta clase extiende MVCObject
.
Para acceder, llama a const {DirectionsRenderer} = await google.maps.importLibrary("routes")
. Consulta el artículo Bibliotecas de la API de Maps JavaScript.
Constructor | |
---|---|
DirectionsRenderer |
DirectionsRenderer([opts]) Parámetros:
Crea el procesador con las opciones determinadas. Las instrucciones sobre cómo llegar se pueden renderizar en un mapa (como superposiciones visuales) o, además, en un panel <div> (como instrucciones textuales). |
Métodos | |
---|---|
getDirections |
getDirections() Parámetros: Ninguno
Valor que se devuelve:
DirectionsResult Muestra el conjunto actual de instrucciones sobre cómo llegar del procesador. |
getMap |
getMap() Parámetros: Ninguno
Valor que se devuelve:
Map Muestra el mapa en el que se renderiza DirectionsResult . |
getPanel |
getPanel() Parámetros: Ninguno
Valor que se devuelve:
HTMLElement|null Muestra el panel <div> en el que se renderiza DirectionsResult . |
getRouteIndex |
getRouteIndex() Parámetros: Ninguno
Valor que se devuelve:
number Muestra el índice de ruta actual (basado en cero) que usa este objeto DirectionsRenderer . |
setDirections |
setDirections(directions) Parámetros:
Valor que se devuelve: 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 procesador. |
setMap |
setMap(map) Parámetros:
Valor que se devuelve: Ninguno
Este método especifica el mapa en el que se renderizará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 devuelve: 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 devuelve: Ninguno
Este método renderiza las instrucciones sobre cómo llegar en un <div> . Pasa null para quitar el contenido del panel. |
setRouteIndex |
setRouteIndex(routeIndex) Parámetros:
Valor que se devuelve: Ninguno
Configura el índice (basado en cero) de la ruta en el objeto DirectionsResult que se renderizará. De forma predeterminada, se renderizará la primera ruta del array. |
Heredado:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Eventos | |
---|---|
directions_changed |
function() Argumentos: Ninguno
Este evento se activa cuando las instrucciones renderizadas cambian, ya sea cuando se establece un nuevo DirectionsResult o cuando el usuario termina de arrastrar un cambio en la ruta de las instrucciones sobre cómo llegar. |
DirectionsRendererOptions
Interfaz de google.maps.DirectionsRendererOptions
Este objeto define las propiedades que se pueden configurar en un objeto DirectionsRenderer
.
Propiedades | |
---|---|
directions optional |
Tipo:
DirectionsResult optional 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 acceso de las rutas renderizadas por DirectionsRenderer . |
hideRouteList optional |
Tipo:
boolean optional Valor predeterminado:
false Esta propiedad indica si el procesador debe proporcionar una lista de rutas que el usuario seleccione en el panel de instrucciones sobre cómo llegar. |
infoWindow optional |
Tipo:
InfoWindow optional El InfoWindow en el que se renderiza 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 utilizará 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 muestran las instrucciones sobre cómo llegar |
markerOptions optional |
Tipo:
MarkerOptions optional Opciones para los marcadores. Todos los marcadores que renderiza DirectionsRenderer usarán estas opciones. |
panel optional |
Tipo:
HTMLElement optional El objeto <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 si nunca se establecen el centro ni el zoom del mapa, el mapa de entrada se centra y aplica zoom al cuadro delimitador de este conjunto de instrucciones. |
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 las 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 de google.maps.DirectionsWaypoint
Un DirectionsWaypoint
representa una ubicación entre el origen y el destino a través de la cual 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 segmentos. Si es false , indica que la ruta debe pasar por este punto de referencia, pero que 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 de google.maps.DirectionsGeocodedWaypoint
Un solo 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í encontró 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 Array de cadenas que denota el tipo del elemento geocodificado que se muestra. Para obtener una lista de las cadenas posibles, consulta la sección Tipos de componentes de dirección de la guía para desarrolladores. |
DirectionsRoute
Interfaz de 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 de forma directa e indirecta objetos LatLng
.
Propiedades | |
---|---|
bounds |
Tipo:
LatLngBounds Son los límites de esta ruta. |
copyrights |
Tipo:
string Texto de derechos de autor que se 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á una etapa para cada punto de referencia o destino de parada especificado. Por lo tanto, una ruta sin puntos de referencia de parada contendrá un DirectionsLeg y una ruta con un punto de referencia de una 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 breve de la ruta, adecuada para indicar el nombre de la ruta y diferenciarla de otras alternativas. |
warnings |
Tipo:
Array<string> Advertencias que se mostrarán cuando se muestren 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 era: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 Tarifa total para todo el viaje en transporte público Solo se aplica a las solicitudes de transporte público. |
DirectionsLeg
Interfaz de google.maps.DirectionsLeg
Un solo segmento que consta de un conjunto de pasos en un DirectionsResult
. Es posible que algunos campos de la etapa no se devuelvan para todas las solicitudes. Ten en cuenta que, aunque este resultado es "similar a JSON", no es estrictamente JSON, ya que incluye de forma directa e indirecta objetos LatLng
.
Propiedades | |
---|---|
end_address |
Tipo:
string Es la dirección del destino de este tramo. Este contenido debe leerse tal como está. No analices la dirección con formato de forma 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 ser diferente del valor end_location del último paso si, por ejemplo, la ruta no está cerca del destino de este tramo. |
start_address |
Tipo:
string Es la dirección del origen de este segmento. Este contenido debe leerse tal como está. No analices la dirección con formato de forma 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 está 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 en este segmento. |
|
Tipo:
Array<?> Información sobre la velocidad del tráfico a lo largo del tramo. |
via_waypoints |
Una matriz de puntos de referencia sin paradas a lo largo de este segmento, que se especificaron en la solicitud original. Obsoleto en las 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 estimada de llegada para este segmento. Solo se aplica a las solicitudes de TRANSIT. |
departure_time optional |
Tipo:
Time optional Hora de salida estimada para este tramo. Solo se aplica a las solicitudes de TRANSIT. |
distance optional |
Tipo:
Distance optional La distancia total que cubre este tramo. Es posible que esta propiedad no esté definida porque se desconoce la distancia. |
duration optional |
Tipo:
Duration optional 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 que indica la propiedad trafficModel . Esta propiedad puede ser undefined , ya que se desconoce la duración. |
DirectionsStep
Interfaz de 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 directamente objetos LatLng
.
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 La ubicación final de este paso. |
|
Tipo:
LatLng La ubicación final de este paso. |
instructions |
Tipo:
string Instrucciones para este paso. |
|
Es una secuencia de LatLng que describe 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 valores sin previo aviso. |
path |
Es una secuencia de LatLng que describe el curso de este paso. Esta es una ruta aproximada (unificada) del paso. |
start_location |
Tipo:
LatLng La ubicación inicial de este paso. |
|
Tipo:
LatLng La ubicación inicial de este paso. |
travel_mode |
Tipo:
TravelMode El medio de transporte utilizado en este paso. |
distance optional |
Tipo:
Distance optional La distancia que cubre este paso. Es posible que esta propiedad sea undefined , ya que se desconoce la distancia. |
duration optional |
Tipo:
Duration optional El tiempo habitual en segundos para realizar este paso 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 contiene una representación de una polilínea codificada del paso. Esta polilínea es una ruta aproximada (unificada) del paso. |
steps optional |
Tipo:
Array<DirectionsStep> optional Subpasos de este paso. Se especifica para secciones de transporte público que no son 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 relacionados con este paso si el medio de transporte es TRANSIT . |
DirectionsPolyline
Interfaz de google.maps.DirectionsPolyline
Es un objeto que contiene una propiedad points
para describir la polilínea de un objeto DirectionsStep
.
Propiedades | |
---|---|
points |
Tipo:
string Una polilínea codificada. |
Interfaz de Place
Interfaz de google.maps.Place
Contiene la información necesaria para ubicar, identificar o describir un lugar para 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 Es el LatLng de la entidad descrita por este lugar. |
placeId optional |
Tipo:
string optional Es el ID de lugar del lugar (como una empresa o un lugar de interés). El ID de lugar es un identificador único de un lugar 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 placeId en lugar de query . Un ID de lugar se puede recuperar a partir 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) Una consulta de ejemplo es “Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW”. Si es posible, debes especificar placeId en lugar de query . La API no garantiza la precisión de resolver la cadena de consulta para 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 con 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 el artículo 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 de 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 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 usar cuando se predice la duración en el tráfico. El valor predeterminado es BEST_GUESS . |
Constantes TrafficModel
Constantes google.maps.TrafficModel
Son las suposiciones que se deben utilizar para predecir la duración en el tráfico. Se especifica como parte de un DirectionsRequest
o DistanceMatrixRequest
. Especifícalas por valor o con 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 el artículo Bibliotecas de la API de Maps JavaScript.
Constantes | |
---|---|
BEST_GUESS |
Utiliza los datos históricos de tráfico para calcular mejor el tiempo que pasas en el tráfico. |
OPTIMISTIC |
Utiliza los datos históricos de tráfico para realizar una estimación optimista de la duración del tráfico. |
PESSIMISTIC |
Utiliza datos históricos de tráfico para hacer una estimación pesimista de la duración del tráfico. |
TransitOptions
Interfaz de google.maps.TransitOptions
Es 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 Fecha 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 Fecha mide el tiempo en milisegundos desde el 1 de enero de 1970. Si no se especifica una hora de salida ni de llegada, se supone que la hora es "ahora". |
modes optional |
Tipo:
Array<TransitMode> optional Uno o más medios de transporte público preferidos, 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 personalizar la elección de una 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 con 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 el artículo 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. |
Constantes de 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 con 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 el artículo 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. |
Interfaz de TransitFare
Interfaz de google.maps.TransitFare
Es una tarifa de un DirectionsRoute
que consta de valor y moneda.
Propiedades | |
---|---|
currency |
Tipo:
string Es 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 valor currency especificado. |
TransitDetails
Interfaz de google.maps.TransitDetails
Detalles sobre la salida, la llegada y el medio de transporte utilizado en este paso.
Propiedades | |
---|---|
arrival_stop |
Tipo:
TransitStop 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 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 esperados 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 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 identificar 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 de google.maps.TransitStop
Son los 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 Indica el nombre de esta parada de transporte público. |
TransitLine
Interfaz de google.maps.TransitLine
Información sobre la línea de transporte público que utiliza este paso.
Propiedades | |
---|---|
agencies |
Tipo:
Array<TransitAgency> La empresa de transporte público que opera esta línea de transporte público. |
color |
Tipo:
string Es el color que se usa comúnmente en la señalización de esta línea de transporte público, representado como una cadena hexadecimal. |
icon |
Tipo:
string La URL para un ícono asociado con esta línea. |
name |
Tipo:
string El nombre completo de la 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 Es el color de texto de uso general en la señalización para 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 utilizado, p.ej., tren o autobús. |
Interfaz de TransitAgency
Interfaz de 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 de google.maps.TransitVehicle
Incluye información sobre el vehículo que opera en una línea de transporte público.
Propiedades | |
---|---|
icon |
Tipo:
string 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 Indica un nombre para este tipo de TransitVehicle, p.ej., "Tren" o "Bus". |
type |
Tipo:
VehicleType Indica el tipo de vehículo utilizado, p.ej., tren, autobús o transbordador. |
Constantes 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 el artículo 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 forma de transporte en autobús que permite dejar y recoger pasajeros en cualquier punto de su recorrido. Generalmente, los taxis compartidos usan minibús. |
SUBWAY |
Tren ligero subterráneo |
TRAM |
Tren ligero sobre el suelo |
TROLLEYBUS |
Trolebús |
Constantes UnitSystem
Constantes google.maps.UnitSystem
Son 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 el artículo 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 del sistema métrico. |
Interfaz de Distance
Interfaz de google.maps.Distance
Es una representación de la distancia como un valor numérico y una cadena de visualización.
Propiedades | |
---|---|
text |
Tipo:
string Una representación de cadena del valor de distancia, con el UnitSystem especificado en la solicitud. |
value |
Tipo:
number Es la distancia en metros. |
Interfaz de Duration
Interfaz de google.maps.Duration
Es una representación de la duración como un valor numérico y una cadena 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 de google.maps.Time
Una representación de la hora como un objeto de fecha, una cadena 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 de fecha de JavaScript. |
Constantes de DirectionsTravelMode
Constantes google.maps.DirectionsTravelMode
Constantes DirectionsUnitSystem
Constantes google.maps.DirectionsUnitSystem