Distance Matrix

Clase DistanceMatrixService

Clase google.maps.DistanceMatrixService

Es un servicio para calcular las distancias entre varios orígenes y destinos.

Para acceder, llama a const {DistanceMatrixService} = await google.maps.importLibrary("routes"). Consulta Bibliotecas de la API de Maps JavaScript.
DistanceMatrixService
DistanceMatrixService()
Parámetros:  Ninguno
Crea una instancia nueva de un DistanceMatrixService que envía consultas de matriz de distancias a los servidores de Google.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Parámetros: 
Valor que se muestra:  Promise<DistanceMatrixResponse>
Emite una solicitud de matriz de distancias.

Interfaz DistanceMatrixRequest

Interfaz de google.maps.DistanceMatrixRequest

Una consulta de matriz de distancias que envía DistanceMatrixService que contiene arrays de ubicaciones de origen y destino, y varias opciones para calcular métricas.
destinations
Es un array que contiene cadenas de direcciones de destino, objetos LatLng o Place para calcular la distancia y el tiempo. Obligatorio.
origins
Es un array que contiene cadenas de direcciones de origen, objetos LatLng o Place desde los que se calculan la distancia y el tiempo. Obligatorio.
travelMode
Tipo:  TravelMode
Es el tipo de enrutamiento solicitado. Obligatorio.
avoidFerries optional
Tipo:  boolean optional
Si es true, le indica al servicio Distance Matrix que evite los transbordadores siempre que sea posible. Opcional.
avoidHighways optional
Tipo:  boolean optional
Si es true, le indica al servicio Distance Matrix que evite las autopistas siempre que sea posible. Opcional.
avoidTolls optional
Tipo:  boolean optional
Si es true, le indica al servicio Distance Matrix que evite las rutas con peaje siempre que sea posible. Opcional.
drivingOptions optional
Tipo:  DrivingOptions optional
Es la configuración que se aplica solo a las solicitudes en las que travelMode es DRIVING. Este objeto no tendrá efecto en otros modos de viaje.
language optional
Tipo:  string optional
Un identificador de idioma para el idioma en el que se deben mostrar los resultados, siempre que sea posible. Consulta la lista de idiomas compatibles.
region optional
Tipo:  string optional
Código de región que se usa como sesgo 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 "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 modos de viaje.
unitSystem optional
Tipo:  UnitSystem optional
Es el sistema de unidades preferido que se usará para mostrar la distancia. Opcional; el valor predeterminado es métrica.

Interfaz DistanceMatrixResponse

Interfaz de google.maps.DistanceMatrixResponse

La respuesta a una solicitud DistanceMatrixService, que consta de las direcciones de origen y destino con formato, y una secuencia de DistanceMatrixResponseRow, una para cada dirección de origen correspondiente.
destinationAddresses
Tipo:  Array<string>
Las direcciones de destino con formato
originAddresses
Tipo:  Array<string>
Las direcciones de origen con formato
rows
Las filas de la matriz, que corresponden a las direcciones de origen.

Interfaz DistanceMatrixResponseRow

Interfaz de google.maps.DistanceMatrixResponseRow

Es una fila de la respuesta a una solicitud DistanceMatrixService, que consta de una secuencia de DistanceMatrixResponseElement, una para cada dirección de destino correspondiente.
elements
Los elementos de la fila, que corresponden a las direcciones de destino

Interfaz DistanceMatrixResponseElement

Interfaz de google.maps.DistanceMatrixResponseElement

Un solo elemento de una respuesta a una solicitud DistanceMatrixService, que contiene la duración y la distancia de un origen a un destino.
distance
Tipo:  Distance
Es la distancia de este par origen-destino. Es posible que esta propiedad no esté definida, ya que la distancia puede ser desconocida.
duration
Tipo:  Duration
Es la duración de esta vinculación de origen y destino. Es posible que esta propiedad no esté definida, ya que la duración puede ser desconocida.
duration_in_traffic
Tipo:  Duration
Es la duración de esta vinculación de origen y destino, teniendo en cuenta las condiciones de tráfico que indica la propiedad trafficModel. Esta propiedad puede ser undefined, ya que la duración puede ser desconocida. Solo está disponible para los clientes del plan Premium cuando se define drivingOptions cuando se realiza la solicitud.
fare
Tipo:  TransitFare
Es la tarifa total de esta vinculación de origen y destino. Solo se aplica a las solicitudes de transporte público.
status
Es el estado de esta vinculación de origen y destino en particular.

Constantes de DistanceMatrixStatus

Constantes de google.maps.DistanceMatrixStatus

Es el estado de nivel superior sobre la solicitud en general que muestra DistanceMatrixService cuando se completa una solicitud de matriz de distancias. Especifica estos valores por valor o con el nombre de la constante. Por ejemplo, 'OK' o google.maps.DistanceMatrixStatus.OK.

Para acceder, llama a const {DistanceMatrixStatus} = await google.maps.importLibrary("routes"). Consulta Bibliotecas de la API de Maps JavaScript.
INVALID_REQUEST La solicitud proporcionada no es válida.
MAX_DIMENSIONS_EXCEEDED La solicitud contiene más de 25 orígenes o más de 25 destinos.
MAX_ELEMENTS_EXCEEDED El producto de los orígenes y destinos supera el límite por consulta.
OK la respuesta contiene un resultado válido.
OVER_QUERY_LIMIT Se solicitaron demasiados elementos durante el período permitido. La solicitud debería completarse con éxito si realizas un nuevo intento después de un tiempo razonable.
REQUEST_DENIED El servicio rechazó el uso del servicio Distance Matrix en tu página web.
UNKNOWN_ERROR No se pudo procesar una solicitud de Distance Matrix debido a un error del servidor. La solicitud podría completarse si realizas un nuevo intento.

Constantes de DistanceMatrixElementStatus

Constantes de google.maps.DistanceMatrixElementStatus

Es el estado a nivel del elemento sobre una vinculación de origen-destino en particular que muestra DistanceMatrixService cuando se completa una solicitud de matriz de distancias. Estos valores se especifican como cadenas, por ejemplo, 'OK'.

Para acceder, llama a const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes"). Consulta Bibliotecas de la API de Maps JavaScript.
NOT_FOUND No se pudo geocodificar el origen o el destino de este par.
OK la respuesta contiene un resultado válido.
ZERO_RESULTS No se encontró ninguna ruta entre el origen y el destino.