Route Matrix (beta)

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.

Llama al const {RouteMatrix} = await google.maps.importLibrary("routes") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
computeRouteMatrix
computeRouteMatrix(request)
Parámetros: 
Valor de devolución:  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 a 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 con 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.
  • Si seleccionas solo los campos que necesitas en tu trabajo de producción, se 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 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, el tamaño de la respuesta será menor y, por lo tanto, la carga en la red será más rápida.
rows
Son las filas de la matriz. Cada fila corresponde a un origen y contiene un array de RouteMatrixItems, cada uno de los cuales representa una ruta a un destino.
toJSON
toJSON()
Parámetros: Ninguno
Valor de devolución:  Object
Se convierte en un objeto.

Clase RouteMatrixRow

Clase google.maps.routes.RouteMatrixRow

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

Llama al const {RouteMatrixRow} = await google.maps.importLibrary("routes") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
items
Es la información de la ruta para cada destino.
toJSON
toJSON()
Parámetros: Ninguno
Valor de devolución:  Object
Se convierte en un objeto.

Clase RouteMatrixItem

Clase google.maps.routes.RouteMatrixItem

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

Llama al const {RouteMatrixItem} = await google.maps.importLibrary("routes") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
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 navegar por 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 del tráfico.

Nota: Si la duración supera los 2^53 milisegundos, este valor es Number.POSITIVE_INFINITY.
error
Tipo:  RouteMatrixItemError optional
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 proporcionadas para este par de origen y destino en particular, es posible que vuelva a usar otro modo de cálculo. Cuando se usa una respuesta alternativa, este campo contiene información detallada sobre la respuesta alternativa. De lo contrario, este campo no se establece.
localizedValues
Son representaciones de texto de las propiedades de RouteMatrixItem.
staticDurationMillis
Tipo:  number optional
Es la duración del viaje a través de 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
Es información adicional sobre la ruta.

Interfaz de ComputeRouteMatrixRequest

Interfaz de google.maps.routes.ComputeRouteMatrixRequest

Es una solicitud de una matriz de rutas.
destinations
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 código plus 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
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 código plus 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 los destinos:
  • La cantidad total de orígenes y destinos especificados como strings o Places no debe ser superior a 50.
  • El producto de la cantidad de orígenes y la cantidad de destinos no debe ser mayor que 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
Es la hora de llegada.

Nota: Solo se puede configurar cuando ComputeRouteMatrixRequest.travelMode se establece como 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
Hora de salida Si no estableces este valor, se usará de forma predeterminada la hora en la que realizaste la solicitud.

Nota: Solo puedes especificar una fecha y 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
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 Unicode Locale Identifier. Consulta Idiomas admitidos para obtener la lista de idiomas admitidos. Si no proporcionas este valor, el idioma se infiere a partir de la configuración de localización de la API de Google Maps JavaScript. 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 de dos caracteres del ccTLD ("dominio de nivel superior"). 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 inferirá a partir 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 se debe calcular la matriz de rutas. El servidor intenta usar la preferencia de enrutamiento seleccionada para calcular la matriz de rutas. Si la preferencia de enrutamiento genera un error o una latencia demasiado larga, se muestra un error. Solo puedes especificar esta opción cuando ComputeRouteMatrixRequest.travelMode es DRIVING o TWO_WHEELER. De lo contrario, la solicitud fallará.
trafficModel optional
Tipo:  TrafficModel optional
Especifica las suposiciones que se usarán cuando se calcule 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 muestra para las rutas de 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 para los campos de visualización. Si no proporcionas este valor, las unidades de visualización se inferirán a partir 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.

Llama al const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
TOLLS Es la información de peaje para los elementos de la matriz.

Constantes de RouteMatrixItemCondition

Constantes de google.maps.routes.RouteMatrixItemCondition

Es la condición de una ruta para un par de origen y destino determinado.

Llama al const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
ROUTE_EXISTS Se encontró una ruta.
ROUTE_NOT_FOUND No se pudo encontrar 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.

Llama al const {RouteMatrixItemError} = await google.maps.importLibrary("routes") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
toJSON
toJSON()
Parámetros: Ninguno
Valor de devolución:  Object
Se convierte en un objeto.

Clase RouteMatrixItemLocalizedValues

Clase google.maps.routes.RouteMatrixItemLocalizedValues

Son representaciones de texto del RouteMatrixItem.

Llama al const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
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 BCP-47 del texto de 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
Duración, representada en formato de texto y localizada para la región de la búsqueda. Tiene 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 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
Duración sin tener en cuenta las condiciones del tráfico, representada en formato de texto.
staticDurationLanguage
Tipo:  string optional
Es el código de idioma BCP-47 del texto de duración estático, como "en-US" o "sr-Latn".
transitFare
Tipo:  string optional
Tarifa de transporte público, representada en formato de texto.
transitFareLanguage
Tipo:  string optional
Es el código de idioma 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.
toJSON
toJSON()
Parámetros: Ninguno
Valor de devolución:  Object
Se convierte en un objeto.

Interfaz de RouteMatrixOrigin

Interfaz de google.maps.routes.RouteMatrixOrigin

Es un solo origen para un objeto ComputeRouteMatrixRequest.
waypoint
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
Son los modificadores de cada ruta que toma este lugar como origen.