Route Matrix

Clase RouteMatrix

Clase google.maps.routes.RouteMatrix

Es una matriz de rutas calculadas para un conjunto de pares de origen y destino por RouteMatrix.computeRouteMatrix.

Para acceder, llama al const {RouteMatrix} = await google.maps.importLibrary("routes").
Consulta Bibliotecas de la API de Maps JavaScript.

Métodos estáticos

computeRouteMatrix

computeRouteMatrix(request) Parámetros:  request:  ComputeRouteMatrixRequest Valor de retorno:  Promise<{matrix:RouteMatrix}> Toma una lista de orígenes y destinos, y devuelve una matriz que contiene información de la ruta para cada combinación de origen y destino. Nota: Este método requiere que especifiques una máscara de campo de respuesta en la solicitud configurando la propiedad ComputeRouteMatrixRequest.fields. El valor es una lista de rutas de acceso de campos. Por ejemplo: Máscara de campo de todos los campos disponibles: fields: ['*'] Máscara de campo de la duración y la distancia a nivel de la ruta: fields: ['durationMillis', 'distanceMeters'] No se recomienda usar la máscara de campo de respuesta comodín fields: ['*'] por los siguientes motivos: Seleccionar solo los campos que necesitas ayuda a nuestro servidor a ahorrar ciclos de procesamiento, lo que nos permite devolverte el resultado con una latencia más baja. Seleccionar solo los campos que necesitas en tu trabajo de producción garantiza un rendimiento de latencia estable. Es posible que agreguemos más campos de respuesta en el futuro, y esos campos nuevos podrían requerir tiempo de procesamiento adicional. Si seleccionas todos los campos, o si seleccionas todos los campos en el nivel superior, es posible que experimentes una degradación del rendimiento, ya que cualquier campo nuevo que agreguemos se incluirá automáticamente en la respuesta. Si seleccionas solo los campos que necesitas, se reducirá el tamaño de la respuesta y, por lo tanto, se cargará más rápido en la red.

Propiedades
rows	Tipo:  Array<RouteMatrixRow> Son las filas de la matriz. Cada fila corresponde a un origen y contiene un array de RouteMatrixItem, cada uno de los cuales representa una ruta a un destino.

Métodos
toJSON	toJSON() Parámetros: Ninguno Valor de retorno:  Object Se convierte en un objeto.

Clase RouteMatrixRow

Clase google.maps.routes.RouteMatrixRow

Corresponde a un origen que se pasa a RouteMatrix.computeRouteMatrix. Contiene una lista de RouteMatrixItem, en la que cada elemento representa una ruta a un destino.

Para acceder, llama al const {RouteMatrixRow} = await google.maps.importLibrary("routes").
Consulta Bibliotecas de la API de Maps JavaScript.

Propiedades
items	Tipo:  Array<RouteMatrixItem> La información de la ruta para cada destino.

Métodos
toJSON	toJSON() Parámetros: Ninguno Valor de retorno:  Object Se convierte en un objeto.

Clase RouteMatrixItem

Clase google.maps.routes.RouteMatrixItem

Contiene información de la ruta calculada para un par de origen y destino que se pasa a RouteMatrix.computeRouteMatrix.

Para acceder, llama al const {RouteMatrixItem} = await google.maps.importLibrary("routes").
Consulta Bibliotecas de la API de Maps JavaScript.

Propiedades
condition	Tipo:  RouteMatrixItemCondition optional Indica si se encontró la ruta o no.
distanceMeters	Tipo:  number optional Es la distancia de viaje de la ruta en metros.
durationMillis	Tipo:  number optional Es el tiempo necesario para recorrer la ruta, expresado en milisegundos. Si estableces ComputeRouteMatrixRequest.routingPreference en TRAFFIC_UNAWARE, este valor será el mismo que RouteMatrixItem.staticDurationMillis. Si configuras ComputeRouteMatrixRequest.routingPreference como TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL, este valor se calcula teniendo en cuenta las condiciones de tráfico. Nota: Si la duración supera los 2^53 milisegundos, este valor es Number.POSITIVE_INFINITY.
error	Tipo:  RouteMatrixItemError optional Es el error que se produjo durante el cálculo de la ruta.
fallbackInfo	Tipo:  FallbackInfo optional En algunos casos, cuando el servidor no puede calcular la ruta con las preferencias dadas para este par de origen y destino en particular, puede recurrir a un modo de cálculo diferente. Cuando se usa un resguardo, este campo contiene información detallada sobre la respuesta de resguardo. De lo contrario, este campo no se configura.
localizedValues	Tipo:  RouteMatrixItemLocalizedValues optional Son representaciones de texto de las propiedades de RouteMatrixItem.
staticDurationMillis	Tipo:  number optional Es la duración del viaje por la ruta sin tener en cuenta las condiciones de tráfico. Nota: Si la duración supera los 2^53 milisegundos, este valor es Number.POSITIVE_INFINITY.
travelAdvisory	Tipo:  RouteTravelAdvisory optional Información adicional sobre la ruta.

Métodos
toJSON	toJSON() Parámetros: Ninguno Valor de retorno:  Object Se convierte en un objeto.

Interfaz ComputeRouteMatrixRequest

Interfaz google.maps.routes.ComputeRouteMatrixRequest

Es una solicitud de una matriz de rutas.

Propiedades
destinations	Tipo:  Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint> Es un array de destinos que determina las columnas de la matriz de respuesta. Un valor que se pasa como una cadena puede ser una dirección, un Plus Code o un nombre de recurso de Place. No se tienen en cuenta los valores de altitud.
fields	Tipo:  Iterable<string> Es la colección de campos que se recuperarán. Especifica ["*"] para todos los campos.
origins	Tipo:  Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|RouteMatrixOrigin|Waypoint> Es un array de orígenes que determina las filas de la matriz de respuesta. Un valor que se pasa como una cadena puede ser una dirección, un Plus Code o un nombre de recurso de Place. No se tienen en cuenta los valores de altitud. Se aplican varias restricciones de tamaño a la cardinalidad de los orígenes y destinos: La cantidad total de orígenes y destinos especificados como string o Place no debe ser superior a 50. El producto de la cantidad de orígenes y la cantidad de destinos no debe ser superior a 625. El producto de la cantidad de orígenes y destinos no debe ser superior a 100 si ComputeRouteMatrixRequest.routingPreference se establece en TRAFFIC_AWARE_OPTIMAL. El producto de la cantidad de orígenes y destinos no debe ser superior a 100 si ComputeRouteMatrixRequest.travelMode se establece en TRANSIT.
arrivalTime optional	Tipo:  Date optional La hora de llegada. Nota: Solo se puede configurar cuando ComputeRouteMatrixRequest.travelMode se establece en TRANSIT. Puedes especificar ComputeRouteMatrixRequest.departureTime o ComputeRouteMatrixRequest.arrivalTime, pero no ambos. Los viajes en transporte público están disponibles hasta 7 días en el pasado o 100 días en el futuro.
departureTime optional	Tipo:  Date optional La hora de salida. Si no estableces este valor, se establecerá de forma predeterminada en la hora en que realizaste la solicitud. Nota: Solo puedes especificar una hora en el pasado cuando ComputeRouteMatrixRequest.travelMode se establece en TRANSIT. Los viajes en transporte público están disponibles hasta 7 días en el pasado o 100 días en el futuro.
extraComputations optional	Tipo:  Iterable<ComputeRouteMatrixExtraComputation> optional Es una lista de cálculos adicionales que se pueden usar para completar la solicitud. Nota: Estos cálculos adicionales pueden devolver campos adicionales en la respuesta. Estos campos adicionales también se deben especificar en ComputeRouteMatrixRequest.fields para que se devuelvan en la respuesta.
language optional	Tipo:  string optional El código de idioma BCP-47, como "en-US" o "sr-Latn". Para obtener más información, consulta Identificador de configuración regional de Unicode. Consulta Idiomas admitidos para obtener la lista de idiomas compatibles. Si no proporcionas este valor, el idioma se infiere de la configuración de localización de la API de Maps JavaScript de Google Maps. De lo contrario, el idioma se infiere de la ubicación del primer origen.
region optional	Tipo:  string optional Es el código de región, especificado como un valor ccTLD ("dominio de nivel superior") de dos caracteres. Para obtener más información, consulta Dominios de nivel superior con código de país. Si no proporcionas este valor, la región se infiere de la configuración de localización de la API de Google Maps JavaScript. De lo contrario, la región se infiere de la ubicación del primer origen.
routingPreference optional	Tipo:  RoutingPreference optional Especifica cómo calcular la matriz de rutas. El servidor intenta usar la preferencia de ruta seleccionada para calcular la matriz de rutas. Si la preferencia de enrutamiento genera un error o una latencia muy larga, se devuelve un error. Puedes especificar esta opción solo cuando ComputeRouteMatrixRequest.travelMode es DRIVING o TWO_WHEELER; de lo contrario, la solicitud falla.
trafficModel optional	Tipo:  TrafficModel optional Especifica las suposiciones que se usarán para calcular el tiempo en el tráfico. Este parámetro de configuración afecta el valor que se muestra en RouteMatrixItem.durationMillis, que contiene el tiempo previsto en el tráfico según los promedios históricos. ComputeRouteMatrixRequest.trafficModel solo está disponible para las solicitudes que establecieron ComputeRouteMatrixRequest.routingPreference en TRAFFIC_AWARE_OPTIMAL y ComputeRouteMatrixRequest.travelMode en DRIVING. La configuración predeterminada es BEST_GUESS.
transitPreference optional	Tipo:  TransitPreference optional Especifica las preferencias que influyen en la ruta que se devuelve para las rutas TRANSIT. Nota: Solo se puede especificar cuando ComputeRouteMatrixRequest.travelMode se establece en TRANSIT.
travelMode optional	Tipo:  TravelMode optional Especifica el medio de transporte.
units optional	Tipo:  UnitSystem optional Especifica las unidades de medida de los campos de visualización. Si no proporcionas este valor, las unidades de visualización se infieren de la ubicación del primer origen.

Constantes de ComputeRouteMatrixExtraComputation

Constantes de google.maps.routes.ComputeRouteMatrixExtraComputation

Son los cálculos adicionales que se deben realizar para una solicitud de RouteMatrix.computeRouteMatrix.

Para acceder, llama al const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes").
Consulta Bibliotecas de la API de Maps JavaScript.

Constantes
TOLLS	Es la información de peaje de los elementos de la matriz.

Constantes de RouteMatrixItemCondition

Constantes de google.maps.routes.RouteMatrixItemCondition

Es el estado de una ruta para un par de origen y destino determinado.

Para acceder, llama al const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes").
Consulta Bibliotecas de la API de Maps JavaScript.

Constantes
ROUTE_EXISTS	Se encontró una ruta.
ROUTE_NOT_FOUND	No se encontró ninguna ruta.

Clase RouteMatrixItemError

Clase google.maps.routes.RouteMatrixItemError

Es un error que se produjo durante RouteMatrix.computeRouteMatrix para un par de origen y destino específico.

Esta clase extiende Error.

Para acceder, llama al const {RouteMatrixItemError} = await google.maps.importLibrary("routes").
Consulta Bibliotecas de la API de Maps JavaScript.

Métodos
toJSON	toJSON() Parámetros: Ninguno Valor de retorno:  Object Se convierte en un objeto.

Clase RouteMatrixItemLocalizedValues

Clase google.maps.routes.RouteMatrixItemLocalizedValues

Son representaciones de texto de la RouteMatrixItem.

Para acceder, llama al const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes").
Consulta Bibliotecas de la API de Maps JavaScript.

Propiedades
distance	Tipo:  string optional Es la distancia de viaje del elemento de la matriz de rutas en formato de texto.
distanceLanguage	Tipo:  string optional Es el código de idioma según la norma BCP-47 del texto de la distancia, como "en-US" o "sr-Latn". Para obtener más información, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
duration	Tipo:  string optional Es la duración, representada en formato de texto y localizada según la región de la consulta. Toma en cuenta las condiciones de tráfico. Nota: Si no solicitaste información sobre el tráfico, este valor es el mismo que RouteMatrixItemLocalizedValues.staticDuration.
durationLanguage	Tipo:  string optional Es el código de idioma según la norma BCP-47 del texto de duración, como "en-US" o "sr-Latn". Para obtener más información, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
staticDuration	Tipo:  string optional Es la duración sin tener en cuenta las condiciones de tráfico, representada en formato de texto.
staticDurationLanguage	Tipo:  string optional Es el código de idioma según la norma BCP-47 del texto de duración estática, como "en-US" o "sr-Latn".
transitFare	Tipo:  string optional Es la tarifa de transporte público, representada en formato de texto.
transitFareLanguage	Tipo:  string optional Es el código de idioma según la norma BCP-47 del texto de la tarifa de transporte público, como "en-US" o "sr-Latn". Para obtener más información, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

Métodos
toJSON	toJSON() Parámetros: Ninguno Valor de retorno:  Object Se convierte en un objeto.

Interfaz RouteMatrixOrigin

Interfaz google.maps.routes.RouteMatrixOrigin

Un solo origen para un ComputeRouteMatrixRequest.

Propiedades
waypoint	Tipo:  string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint La ubicación del origen. Un valor que se pasa como una cadena puede ser una dirección o un código plus. No se tienen en cuenta los valores de altitud.
routeModifiers optional	Tipo:  RouteModifiers optional Modificadores para cada ruta que toma este elemento como origen.