Distance Matrix (deprecated)

Clase DistanceMatrixService

google.maps.DistanceMatrixService clase
biblioteca "routes" 

const {DistanceMatrixService} = await google.maps.importLibrary("routes");
DistanceMatrixService
DistanceMatrixService()
Parámetros: Ninguno
Crea una nueva instancia de un DistanceMatrixService que envía consultas de matriz de distancia a los servidores de Google.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Parámetros:
Valor de retorno: Promise<DistanceMatrixResponse>
Emite una solicitud de matriz de distancia.

Interfaz DistanceMatrixRequest

Interfaz google.maps.DistanceMatrixRequest

Es una consulta de matriz de distancia que envía el DistanceMatrixService y 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, o bien objetos LatLng o Place, para los que se calcula la distancia y el tiempo. Obligatorio.
origins
Es un array que contiene cadenas de direcciones de origen, o bien objetos LatLng o Place, desde donde se calculan la distancia y el tiempo. Obligatorio.
travelMode
Es el tipo de enrutamiento solicitado. Obligatorio.
avoidFerries
opcional
Tipo: boolean optional
Si es true, indica al servicio de matriz de distancia que evite los ferris siempre que sea posible. Opcional.
avoidHighways
opcional
Tipo: boolean optional
Si es true, indica al servicio Matriz de distancia que evite las autopistas siempre que sea posible. Opcional.
avoidTolls
opcional
Tipo: boolean optional
Si es true, indica al servicio Matriz de distancia que evite las rutas con peaje siempre que sea posible. Opcional.
drivingOptions
opcional
Tipo: DrivingOptions optional
Son los parámetros de configuración que se aplican solo a las solicitudes en las que travelMode es DRIVING. Este objeto no tendrá ningún efecto en otros medios de transporte.
language
opcional
Tipo: string optional
Es un identificador del idioma en el que se deben devolver los resultados, cuando sea posible. Consulta la lista de idiomas compatibles.
region
opcional
Tipo: string optional
Es el 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 dos caracteres de ccTLD ("dominio de nivel superior"). 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
opcional
Tipo: TransitOptions optional
Es la 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
opcional
Tipo: UnitSystem optional
Es el sistema de unidades preferido que se usará para mostrar la distancia. Opcional; el valor predeterminado es métrico.

Interfaz DistanceMatrixResponse

Interfaz google.maps.DistanceMatrixResponse

Es 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>
Son las direcciones de destino con formato.
originAddresses
Tipo: Array<string>
Son las direcciones de origen con formato.
rows
Son las filas de la matriz, que corresponden a las direcciones de origen.

Interfaz DistanceMatrixResponseRow

Interfaz google.maps.DistanceMatrixResponseRow

Es 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
Son los elementos de la fila, que corresponden a las direcciones de destino.

Interfaz DistanceMatrixResponseElement

Interfaz google.maps.DistanceMatrixResponseElement

Es 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 para este par de origen y destino. Esta propiedad puede no definirse, ya que es posible que se desconozca la distancia.
duration
Tipo: Duration
Es la duración de este par de origen y destino. Esta propiedad puede no definirse, ya que es posible que se desconozca la duración.
duration_in_traffic
Tipo: Duration
Es la duración de este par de origen y destino, teniendo en cuenta las condiciones de tráfico que se indican en la propiedad trafficModel. Esta propiedad puede ser undefined, ya que es posible que se desconozca la duración. Solo está disponible para los clientes del plan Premium cuando se define drivingOptions al realizar la solicitud.
fare
Es la tarifa total de este par de origen y destino. Solo se aplica a las solicitudes de transporte público.
status
Es el estado de este par de origen y destino en particular.

Constantes de DistanceMatrixStatus

google.maps.DistanceMatrixStatus constantes biblioteca
"routes"

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

Estas constantes también se pueden usar como cadenas. En TypeScript, los literales de cadena se definen con el tipo DistanceMatrixStatusString.

const {DistanceMatrixStatus} = await google.maps.importLibrary("routes");
INVALID_REQUEST La solicitud enviada 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 correctamente si realizas un nuevo intento después de un tiempo.
REQUEST_DENIED El servicio rechazó el uso del servicio Matriz de Distancia en tu página web.
UNKNOWN_ERROR No se pudo procesar una solicitud de matriz de distancia debido a un error de servidor. La solicitud podría completarse si realizas un nuevo intento.

Constantes de DistanceMatrixElementStatus

google.maps.DistanceMatrixElementStatus constantes biblioteca
"routes"

Es el estado a nivel del elemento sobre un par de origen y destino específico que devuelve la DistanceMatrixService cuando se completa una solicitud de matriz de distancia. Estos valores se especifican como cadenas, por ejemplo, 'OK'.

Estas constantes también se pueden usar como cadenas. En TypeScript, los literales de cadena se definen con el tipo DistanceMatrixElementStatusString.

const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes");
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.