Distance Matrix

DistanceMatrixService

Clase google.maps.DistanceMatrixService

Un servicio para calcular distancias entre varios orígenes y destinos.

DistanceMatrixService
DistanceMatrixService()
Parámetros: ninguno
Crea una instancia nueva de un DistanceMatrixService que envía consultas de matriz de distancia a los servidores de Google.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Parámetros:
Valor que se muestra: Promise<DistanceMatrixResponse>
Emite una solicitud de matriz de distancia.

Interfaz DistanceMatrixRequest

Interfaz google.maps.DistanceMatrixRequest

Una consulta de matriz de distancia que envía DistanceMatrixService y que contiene arreglos de ubicaciones de origen y destino, y varias opciones para calcular métricas.

destinations
Es un arreglo que contiene strings de direcciones de destino, o bien objetos LatLng o Place, a los que se va a calcular la distancia y el tiempo. Obligatorio.
origins
Es un arreglo que contiene strings de direcciones de origen, o bien objetos LatLng u Place, a partir de los cuales se calcularán la distancia y el tiempo. Obligatorio.
travelMode
Tipo de enrutamiento solicitado. Obligatorio.
avoidFerries optional
Tipo: boolean optional
Si es true, indica al servicio de matriz de distancia que evite los ferris siempre que sea posible. Opcional.
avoidHighways optional
Tipo: boolean optional
Si es true, indica al servicio de matriz de distancia que evite las autopistas siempre que sea posible. Opcional.
avoidTolls optional
Tipo: boolean optional
Si el valor es true, indica al servicio de matriz de distancia que evite las rutas con peaje cuando 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á ningún efecto en otros medios de transporte.
Betalanguage 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.
region optional
Tipo: string optional
Código de región utilizado como sesgo para solicitudes de geocodificación. El código de región acepta un valor de dos caracteres ccTLD ("top-level domain"). 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 (.co.uk) mientras que el código ISO 3166-1 es &gt (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á ningún efecto en otros medios de transporte.
unitSystem optional
Tipo: UnitSystem optional
Sistema de unidades preferido para usar cuando se muestra la distancia. Opcional; la configuración predeterminada es la métrica.

DistanceMatrixResponse.

Interfaz google.maps.DistanceMatrixResponse

Es la respuesta a una solicitud DistanceMatrixService, que consiste en el origen y las direcciones de 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

DistanceMatrixResponseRow

Interfaz google.maps.DistanceMatrixResponseRow

Una fila de la respuesta a una solicitud DistanceMatrixService, que consiste en 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.

DistanceMatrixResponseElement

Interfaz google.maps.DistanceMatrixResponseElement

Un solo elemento de una respuesta a una solicitud DistanceMatrixService, que contiene la duración y la distancia desde un origen hasta un destino.

distance
Tipo: Distance
La distancia para esta sincronización de origen y destino. Es posible que esta propiedad no esté definida, ya que se desconoce la distancia.
duration
Tipo: Duration
Es la duración de esta sincronización de origen y destino. Es posible que esta propiedad no esté definida, ya que se desconoce la duración.
duration_in_traffic
Tipo: Duration
Es la duración de esta sincronizació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 se desconoce la duración. Solo está disponible para los clientes del plan Premium cuando se define drivingOptions cuando se realiza la solicitud.
fare
Es la tarifa total de esta sincronización de origen y destino. Solo se aplica a solicitudes de transporte público.
status
Es el estado de esta sincronización de origen y destino en particular.

Constantes DistanceMatrixStatus

google.maps.DistanceMatrixStatus constantes

El estado de nivel superior sobre la solicitud en general que muestra el DistanceMatrixService cuando se completa una solicitud de matriz de distancia. Especifícalos por valor o usa el nombre de la constante. Por ejemplo, 'OK' o google.maps.DistanceMatrixStatus.OK.

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 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 en el período de tiempo permitido. La solicitud debería completarse correctamente si vuelves a intentarlo más tarde.
REQUEST_DENIED El servicio no permitió que tu página web usara el servicio de matriz de distancia.
UNKNOWN_ERROR No se pudo procesar una solicitud a la matriz de distancia debido a un error del servidor. La solicitud puede tener éxito si realizas un nuevo intento.

Constantes DistanceMatrixElementStatus

google.maps.DistanceMatrixElementStatus constantes

El estado a nivel de elemento sobre una sincronización de origen y destino en particular que muestra DistanceMatrixService cuando se completa una solicitud de matriz de distancia. Estos valores se especifican como strings, por ejemplo, 'OK'.

NOT_FOUND No se pudo geocodificar el origen o el destino de esta sincronización.
OK la respuesta contiene un resultado válido.
ZERO_RESULTS No se encontró ninguna ruta entre el origen y el destino.