Route - Post Route Matrix

Referencia

Service:: Maps

API Version:: 1.0

Use para obtener una matriz de rutas que muestre el tiempo de viaje y la distancia de todos los pares posibles en una lista de orígenes y destinos, mediante una solicitud asincrónica.

La Post Route Matrix API es una solicitud HTTP POST que permite calcular una matriz de resúmenes de ruta para un conjunto de rutas definidas por ubicaciones de origen y destino mediante una solicitud asincrónica (asincrónica). Para realizar una solicitud sincrónica (sincrónica), consulte Post Route Matrix Sync. Para cada origen determinado, el servicio calcula el costo del enrutamiento desde ese origen a cada destino determinado. El conjunto de orígenes y el conjunto de destinos se pueden considerar como los encabezados de columna y fila de una tabla y cada celda de la tabla contiene los costos de enrutamiento desde el origen hasta el destino de esa celda. Por ejemplo, supongamos que una empresa de entrega de alimentos tiene 20 conductores y necesitan encontrar el conductor más cercano para recoger la entrega del restaurante. Para resolver este caso de uso, pueden llamar a Matrix Route API.

Para cada ruta, se devuelven los tiempos de viaje y las distancias. Puede usar los costos calculados para determinar qué rutas detalladas se van a calcular mediante Route Directions API.

El tamaño máximo de una matriz para la solicitud asincrónica es 700 y para la solicitud de sincronización es 100 (el número de orígenes multiplicado por el número de destinos).

Enviar solicitud de matriz de ruta sincrónica

Si el escenario requiere solicitudes sincrónicas y el tamaño máximo de la matriz es menor o igual que 100, es posible que desee realizar una solicitud sincrónica. El tamaño máximo de una matriz para esta API es 100 (el número de orígenes multiplicado por el número de destinos). Teniendo en cuenta esa restricción, algunos ejemplos de posibles dimensiones de matriz son: 10x10, 6x8, 9x8 (no es necesario que sea cuadrado).

POST https://atlas.microsoft.com/route/matrix/sync/json?api-version=1.0&subscription-key={subscription-key}

Enviar solicitud de matriz de ruta asincrónica

La API asincrónica es adecuada para procesar grandes volúmenes de solicitudes de enrutamiento relativamente complejas. Cuando realiza una solicitud mediante una solicitud asincrónica, el servicio devuelve de forma predeterminada un código de respuesta 202 a lo largo de una dirección URL de redireccionamiento en el campo Ubicación del encabezado de respuesta. Esta dirección URL debe comprobarse periódicamente hasta que los datos de respuesta o la información de error estén disponibles. Si waitForResults el parámetro de la solicitud se establece en true, el usuario obtendrá una respuesta 200 si la solicitud ha finalizado en menos de 120 segundos.

El tamaño máximo de una matriz para esta API es 700 (el número de orígenes multiplicado por el número de destinos). Teniendo en cuenta esa restricción, algunos ejemplos de posibles dimensiones de matriz son: 50x10, 10x10, 28x25. 10x70 (no es necesario que sea cuadrado).

Las respuestas asincrónicas se almacenan durante 14 días. La dirección URL de redireccionamiento devuelve una respuesta 404 si se usa después del período de expiración.

POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0&subscription-key={subscription-key}

Esta es una secuencia típica de operaciones asincrónicas:

El cliente envía una solicitud POST de matriz de rutas para Azure Maps
El servidor responderá con uno de los siguientes elementos:

HTTP 202 Accepted : se ha aceptado la solicitud route matrix.

HTTP Error : se produjo un error al procesar la solicitud de Route Matrix. Puede ser una solicitud 400 incorrecta o cualquier otro código de estado de error.
Si la solicitud de ruta de matriz se aceptó correctamente, el encabezado Location de la respuesta contiene la dirección URL para descargar los resultados de la solicitud. Este URI de estado es similar al siguiente:

  GET https://atlas.microsoft.com/route/matrix/{matrixId}?api-version=1.0?subscription-key={subscription-key}

El cliente emite una solicitud GET en la dirección URL de descarga obtenida en el paso 3 para descargar los resultados

Descargar resultados de sincronización

Al realizar una solicitud POST para Route Matrix Sync API, el servicio devuelve el código de respuesta 200 para una solicitud correcta y una matriz de respuesta. El cuerpo de la respuesta contendrá los datos y no habrá posibilidad de recuperar los resultados más adelante.

Descargar resultados asincrónicos

Cuando una solicitud emite una 202 Accepted respuesta, la solicitud se procesa mediante nuestra canalización asincrónica. Se le proporcionará una dirección URL para comprobar el progreso de la solicitud asincrónica en el encabezado de ubicación de la respuesta. Este URI de estado es similar al siguiente:

  GET https://atlas.microsoft.com/route/matrix/{matrixId}?api-version=1.0?subscription-key={subscription-key}

La dirección URL proporcionada por el encabezado de ubicación devolverá las siguientes respuestas cuando se emita una GET solicitud.

HTTP 202 Accepted : se aceptó la solicitud de matriz, pero todavía se está procesando. Inténtelo de nuevo en algún momento.

HTTP 200 OK : solicitud de matriz procesada correctamente. El cuerpo de la respuesta contiene todos los resultados.

POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0

With optional parameters:

POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0&waitForResults={waitForResults}&computeTravelTimeFor={computeTravelTimeFor}&sectionType={sectionType}&arriveAt={arriveAt}&departAt={departAt}&vehicleAxleWeight={vehicleAxleWeight}&vehicleLength={vehicleLength}&vehicleHeight={vehicleHeight}&vehicleWidth={vehicleWidth}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&windingness={windingness}&hilliness={hilliness}&travelMode={travelMode}&avoid={avoid}&traffic={traffic}&routeType={routeType}&vehicleLoadType={vehicleLoadType}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
format	path	True	JsonFormat	Formato deseado de la respuesta. Solo se admite el formato `json`.
api-version	query	True	string	Número de versión de la API de Azure Maps.
arriveAt	query		string date-time	Fecha y hora de llegada al punto de destino con formato de valor definido en RFC 3339, sección 5.6, con un `dateTime` desplazamiento de zona horaria opcional. Cuando no se especifica un desplazamiento de zona horaria, se supone que es el del punto de destino. Ejemplos: 2023-12-19T16:39:57 2023-12-20T00:39:57+00:00 El `arriveAt` parámetro no se puede usar junto con `departAt`, `minDeviationDistance` o `minDeviationTime`.
avoid	query		RouteAvoidType[]	Especifica algo que el cálculo de ruta debe intentar evitar al determinar la ruta. Se puede especificar varias veces en una solicitud, por ejemplo, "&avoid=autopistas&avoid=tollRoads&avoid=ferries". En las solicitudes de intervalo de rutas, no se debe usar el valor alreadyUsedRoads.
computeTravelTimeFor	query		ComputeTravelTime	Especifica si se devuelven tiempos de viaje adicionales mediante diferentes tipos de información de tráfico (ninguno, histórico, activo), así como el tiempo de viaje predeterminado de mejor estimación.
departAt	query		string date-time	Fecha y hora de salida del punto de origen con formato de valor definido en RFC 3339, sección 5.6, con un `dateTime` desplazamiento de zona horaria opcional. Cuando no se especifica un desplazamiento de zona horaria, se supone que es el del punto de origen. Valor predeterminado: ahora Otro valor: `dateTime` Ejemplos: 2023-12-19T16:39:57 2023-12-20T00:39:57+00:00 El `departAt` parámetro no se puede usar junto con `arriveAt`.
hilliness	query		InclineLevel	Grado de colina para la emocionante ruta. Este parámetro solo se puede usar junto con `routeType`=thrilling.
routeType	query		RouteType	Tipo de ruta solicitada.
sectionType	query		SectionType	Especifica cuáles de los tipos de sección se notifican en la respuesta de ruta. Por ejemplo, si sectionType = peatonal las secciones que son adecuadas para los peatones solo se devuelven. Se pueden usar varios tipos. El valor predeterminado sectionType hace referencia a la entrada travelMode. De forma predeterminada, travelMode está establecido en coche.
traffic	query		boolean	Valores posibles: true: considere toda la información de tráfico disponible durante el enrutamiento. false: omita los datos de tráfico actuales durante el enrutamiento. Tenga en cuenta que, aunque los datos de tráfico actuales se omiten durante el enrutamiento, el efecto del tráfico histórico en velocidades de carretera efectivas sigue incorporando.
travelMode	query		TravelMode	Modo de viaje para la ruta solicitada. Si no se define, el valor predeterminado es "car". Tenga en cuenta que es posible que el travelMode solicitado no esté disponible para toda la ruta. Cuando el travelMode solicitado no está disponible para una sección determinada, el elemento travelMode de la respuesta de esa sección será "otro". Tenga en cuenta que los modos de viaje bus, motocicleta, taxi y camioneta son funcionalidad BETA. Los datos de restricción completa no están disponibles en todas las áreas.
vehicleAxleWeight	query		integer	Peso por eje del vehículo en kg. Un valor de 0 significa que no se tienen en cuenta las restricciones de peso por eje.
vehicleHeight	query		number double	Altura del vehículo en metros. Un valor de 0 significa que no se tienen en cuenta las restricciones de altura.
vehicleLength	query		number double	Longitud del vehículo en metros. Un valor de 0 significa que no se tienen en cuenta las restricciones de longitud.
vehicleLoadType	query		VehicleLoadType	Tipos de carga que se pueden clasificar como materiales peligrosos y restringidos de algunas carreteras. Los valores de vehicleLoadType disponibles son clases hazmat de EE. UU. de 1 a 9, además de clasificaciones genéricas para su uso en otros países o regiones. Los valores que comienzan con USHazmat son para el enrutamiento de EE. UU., mientras que otroshazmat deben usarse para todos los demás países o regiones. vehicleLoadType se puede especificar varias veces. Este parámetro solo se considera actualmente para travelMode=truck.
vehicleMaxSpeed	query		integer	Velocidad máxima del vehículo en km/hora. La velocidad máxima en el perfil del vehículo se utiliza para comprobar si se permite un vehículo en las autopistas. Un valor de 0 significa que se determinará y aplicará un valor adecuado para el vehículo durante la planificación de rutas. Un valor distinto de cero se puede invalidar durante el planeamiento de rutas. Por ejemplo, el flujo de tráfico actual es de 60 km/hora. Si la velocidad máxima del vehículo se establece en 50 km/hora, el motor de enrutamiento tendrá en cuenta 60 km/hora, ya que esta es la situación actual. Si la velocidad máxima del vehículo se proporciona como 80 km/hora, pero el flujo de tráfico actual es de 60 km/hora, el motor de enrutamiento volverá a usar 60 km/hora.
vehicleWeight	query		integer	Peso del vehículo en kilogramos.
vehicleWidth	query		number double	Ancho del vehículo en metros. Un valor de 0 significa que no se tienen en cuenta las restricciones de ancho.
waitForResults	query		boolean	Boolean para indicar si se va a ejecutar la solicitud de forma sincrónica. Si se establece en true, el usuario obtendrá una respuesta 200 si la solicitud ha finalizado en 120 segundos. De lo contrario, el usuario obtendrá una respuesta 202 inmediatamente. Consulte la descripción de la API para obtener más información sobre la respuesta 202. Solo se admite para la solicitud asincrónica.
windingness	query		WindingnessLevel	Nivel de turnos para una ruta emocionante. Este parámetro solo se puede usar junto con `routeType`=thrilling.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
x-ms-client-id		string	Especifica qué cuenta está pensada para su uso junto con el modelo de seguridad de Microsoft Entra ID. Representa un identificador único para la cuenta de Azure Maps y se puede recuperar de la API de cuenta del plano de administración de Azure Maps. Para usar Microsoft Entra ID seguridad en Azure Maps consulte los siguientes artículos para obtener instrucciones.

Cuerpo de la solicitud

Nombre	Tipo	Description
destinations	GeoJsonMultiPoint	Un tipo de geometría válido `GeoJSON MultiPoint` . Consulte RFC 7946 para obtener más información.
origins	GeoJsonMultiPoint	Un tipo de geometría válido `GeoJSON MultiPoint` . Consulte RFC 7946 para obtener más información.

Respuestas

Nombre	Tipo	Description
200 OK	RouteMatrixResult	Solicitud de matriz procesada correctamente. El cuerpo de la respuesta contiene todos los resultados.
202 Accepted		Solo se admite para la solicitud asincrónica. Solicitud aceptada: la solicitud se ha aceptado para su procesamiento. Use la dirección URL en el encabezado de ubicación para reintentar o acceder a los resultados. Headers Location: string
Other Status Codes	ErrorResponse	Se ha producido un error inesperado.

Nombre

Tipo

Description

200 OK

RouteMatrixResult

Solicitud de matriz procesada correctamente. El cuerpo de la respuesta contiene todos los resultados.

202 Accepted

Solo se admite para la solicitud asincrónica. Solicitud aceptada: la solicitud se ha aceptado para su procesamiento. Use la dirección URL en el encabezado de ubicación para reintentar o acceder a los resultados.

Headers

Location: string

Other Status Codes

ErrorResponse

Se ha producido un error inesperado.

Seguridad

AADToken

Estos son los Microsoft Entra flujos de OAuth 2.0. Cuando se empareja con el control de acceso basado en rol de Azure, se puede usar para controlar el acceso a Azure Maps API REST. Los controles de acceso basados en roles de Azure se usan para designar el acceso a una o varias Azure Maps cuenta de recursos o subrecursos. Se puede conceder acceso a cualquier usuario, grupo o entidad de servicio a través de un rol integrado o un rol personalizado compuesto por uno o varios permisos para Azure Maps API REST.

Para implementar escenarios, se recomienda ver los conceptos de autenticación. En resumen, esta definición de seguridad proporciona una solución para modelar aplicaciones a través de objetos capaces de controlar el acceso en determinadas API y ámbitos.

Notas

Esta definición de seguridad requiere el uso del x-ms-client-id encabezado para indicar a qué recurso Azure Maps la aplicación solicita acceso. Esto se puede adquirir desde la API de administración de Maps.

Authorization URL es específico de la instancia de nube pública de Azure. Las nubes soberanas tienen direcciones URL de autorización únicas y configuraciones de Microsoft Entra ID. * El control de acceso basado en rol de Azure se configura desde el plano de administración de Azure a través de Azure Portal, PowerShell, CLI, SDK de Azure o API REST. * El uso del SDK web de Azure Maps permite la configuración basada en la configuración de una aplicación para varios casos de uso.

Para obtener más información sobre Plataforma de identidad de Microsoft, consulte introducción a Plataforma de identidad de Microsoft.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nombre	Description
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Se trata de una clave compartida que se aprovisiona al Create una cuenta de Azure Maps en el Azure Portal o mediante PowerShell, la CLI, los SDK de Azure o la API REST.

Con esta clave, cualquier aplicación puede acceder a todas las API REST. En otras palabras, esta clave se puede usar como clave maestra en la cuenta en la que se emiten.

En el caso de las aplicaciones expuestas públicamente, nuestra recomendación es usar el enfoque de aplicaciones cliente confidenciales para acceder a Azure Maps API REST para que la clave se pueda almacenar de forma segura.

Type: apiKey
In: query

SAS Token

Se crea un token de firma de acceso compartido a partir de la operación List SAS en el recurso de Azure Maps a través del plano de administración de Azure a través de Azure Portal, PowerShell, CLI, SDK de Azure o API REST.

Con este token, cualquier aplicación está autorizada para acceder a los controles de acceso basado en rol de Azure y el control específico a la expiración, la tasa y las regiones de uso para el token determinado. En otras palabras, el token de SAS se puede usar para permitir que las aplicaciones controlen el acceso de forma más segura que la clave compartida.

En el caso de las aplicaciones expuestas públicamente, nuestra recomendación es configurar una lista específica de orígenes permitidos en el recurso de la cuenta de asignación para limitar la representación del abuso y renovar periódicamente el token de SAS.

Type: apiKey
In: header

Ejemplos

Successfully submit a route matrix request

Sample Request

HTTP

POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0&routeType=shortest

{
  "origins": {
    "type": "MultiPoint",
    "coordinates": [
      [
        4.85106,
        52.36006
      ],
      [
        4.85056,
        52.36187
      ]
    ]
  },
  "destinations": {
    "type": "MultiPoint",
    "coordinates": [
      [
        4.85003,
        52.36241
      ],
      [
        13.42937,
        52.50931
      ]
    ]
  }
}

Sample Response

Status code:: 200

{
  "formatVersion": "0.0.1",
  "matrix": [
    [
      {
        "statusCode": 200,
        "response": {
          "routeSummary": {
            "lengthInMeters": 495,
            "travelTimeInSeconds": 134,
            "trafficDelayInSeconds": 0,
            "departureTime": "2018-07-27T22:55:29+00:00",
            "arrivalTime": "2018-07-27T22:57:43+00:00"
          }
        }
      },
      {
        "statusCode": 200,
        "response": {
          "routeSummary": {
            "lengthInMeters": 647651,
            "travelTimeInSeconds": 26835,
            "trafficDelayInSeconds": 489,
            "departureTime": "2018-07-27T22:55:29+00:00",
            "arrivalTime": "2018-07-28T06:22:44+00:00"
          }
        }
      }
    ],
    [
      {
        "statusCode": 200,
        "response": {
          "routeSummary": {
            "lengthInMeters": 338,
            "travelTimeInSeconds": 104,
            "trafficDelayInSeconds": 0,
            "departureTime": "2018-07-27T22:55:29+00:00",
            "arrivalTime": "2018-07-27T22:57:13+00:00"
          }
        }
      },
      {
        "statusCode": 200,
        "response": {
          "routeSummary": {
            "lengthInMeters": 647494,
            "travelTimeInSeconds": 26763,
            "trafficDelayInSeconds": 469,
            "departureTime": "2018-07-27T22:55:29+00:00",
            "arrivalTime": "2018-07-28T06:21:32+00:00"
          }
        }
      }
    ]
  ],
  "summary": {
    "successfulRoutes": 4,
    "totalRoutes": 4
  }
}

Status code:: 202

operation-Location: New URL to check the status of the long-running operation.

Definiciones

Nombre	Description
ComputeTravelTime	Especifica si se devuelven tiempos de viaje adicionales mediante diferentes tipos de información de tráfico (ninguno, histórico, activo), así como el tiempo de viaje predeterminado de mejor estimación.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
GeoJsonMultiPoint	Un tipo de geometría válido `GeoJSON MultiPoint` . Consulte RFC 7946 para obtener más información.
InclineLevel	Grado de colina para la emocionante ruta. Este parámetro solo se puede usar junto con `routeType`=thrilling.
JsonFormat	Formato deseado de la respuesta. Solo se admite el formato `json`.
RouteAvoidType	Especifica algo que el cálculo de ruta debe intentar evitar al determinar la ruta. Se puede especificar varias veces en una solicitud, por ejemplo, "&avoid=autopistas&avoid=tollRoads&avoid=ferries". En las solicitudes de intervalo de rutas, no se debe usar el valor alreadyUsedRoads.
RouteLegSummary	Objeto de resumen para la sección de ruta.
RouteMatrix	Objeto de resultado de matriz
RouteMatrixQuery	Objeto con una matriz de coordenadas.
RouteMatrixResult	Este objeto se devuelve desde una llamada a Route Matrix correcta. Por ejemplo, si se proporcionan 2 orígenes y 3 destinos, habrá 2 matrices con 3 elementos en cada uno. El contenido de cada elemento depende de las opciones proporcionadas en la consulta.
RouteMatrixResultResponse	Objeto response de la celda actual de la matriz de entrada.
RouteMatrixSummary	Summary (objeto)
RouteType	Tipo de ruta solicitada.
SectionType	Especifica cuáles de los tipos de sección se notifican en la respuesta de ruta. Por ejemplo, si sectionType = peatonal las secciones que son adecuadas para los peatones solo se devuelven. Se pueden usar varios tipos. El valor predeterminado sectionType hace referencia a la entrada travelMode. De forma predeterminada, travelMode está establecido en coche.
TravelMode	Modo de viaje para la ruta solicitada. Si no se define, el valor predeterminado es "car". Tenga en cuenta que es posible que el travelMode solicitado no esté disponible para toda la ruta. Cuando el travelMode solicitado no está disponible para una sección determinada, el elemento travelMode de la respuesta de esa sección será "otro". Tenga en cuenta que los modos de viaje bus, motocicleta, taxi y camioneta son funcionalidad BETA. Los datos de restricción completa no están disponibles en todas las áreas.
VehicleLoadType	Tipos de carga que se pueden clasificar como materiales peligrosos y restringidos de algunas carreteras. Los valores de vehicleLoadType disponibles son clases hazmat de EE. UU. de 1 a 9, además de clasificaciones genéricas para su uso en otros países o regiones. Los valores que comienzan con USHazmat son para el enrutamiento de EE. UU., mientras que otroshazmat deben usarse para todos los demás países o regiones. vehicleLoadType se puede especificar varias veces. Este parámetro solo se considera actualmente para travelMode=truck.
WindingnessLevel	Nivel de turnos para una ruta emocionante. Este parámetro solo se puede usar junto con `routeType`=thrilling.

ComputeTravelTime

Especifica si se devuelven tiempos de viaje adicionales mediante diferentes tipos de información de tráfico (ninguno, histórico, activo), así como el tiempo de viaje predeterminado de mejor estimación.

Nombre	Tipo	Description
all	string	Calcula los tiempos de desplazamiento de todos los tipos de información de tráfico y especifica todos los resultados en los campos noTraffic TravelTimeInSeconds, historicTraffic TravelTimeInSeconds y liveTrafficIncidents TravelTimeInSeconds que se incluyen en los resúmenes de la respuesta de ruta.
none	string	No calcula tiempos de desplazamiento adicionales.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Los detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

GeoJsonMultiPoint

Un tipo de geometría válido GeoJSON MultiPoint . Consulte RFC 7946 para obtener más información.

Nombre	Tipo	Description
coordinates	number[]	Coordenadas de la `GeoJson MultiPoint` geometría.
type	string: MultiPoint	Especifica el tipo `GeoJSON`. Debe ser uno de los nueve tipos de objeto GeoJSON válidos: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature y FeatureCollection.

InclineLevel

Grado de colina para la emocionante ruta. Este parámetro solo se puede usar junto con routeType=thrilling.

Nombre	Tipo	Description
high	string	high
low	string	low
normal	string	normal

JsonFormat

Formato deseado de la respuesta. Solo se admite el formato json.

Nombre	Tipo	Description
json	string	Formato de intercambio de datos de notación de objetos JavaScript

RouteAvoidType

Especifica algo que el cálculo de ruta debe intentar evitar al determinar la ruta. Se puede especificar varias veces en una solicitud, por ejemplo, "&avoid=autopistas&avoid=tollRoads&avoid=ferries". En las solicitudes de intervalo de rutas, no se debe usar el valor alreadyUsedRoads.

Nombre	Tipo	Description
alreadyUsedRoads	string	Evita el uso de la misma carretera varias veces. Lo más útil junto con `routeType`=emocionante.
borderCrossings	string	Evita los cruces de bordes en el cálculo de rutas.
carpools	string	Evita las rutas que requieren el uso de carriles de carpool (vehículo de alta ocupación/ HOV).
ferries	string	Evita los ferries
motorways	string	Evita autopistas
tollRoads	string	Evita carreteras de peaje.
unpavedRoads	string	Evita carreteras no transitadas

RouteLegSummary

Objeto de resumen para la sección de ruta.

Nombre	Tipo	Description
arrivalTime	string	Hora estimada de llegada para la ruta o pierna. La hora es UTC.
batteryConsumptionInkWh	number	Consumo estimado de energía eléctrica en horas de kilowatt (kWh) mediante el modelo de consumo eléctrico. Incluido si vehicleEngineType se establece en electric y constantSpeedConsumptionInkWhPerHundredkm se especifica. El valor de batteryConsumptionInkWh incluye la energía eléctrica recuperada y, por tanto, puede ser negativo (lo que indica la ganancia de energía). Si se especifican maxChargeInkWh y currentChargeInkWh, la recuperación se limitará para garantizar que el nivel de carga de la batería nunca supere maxChargeInkWh. Si no se especifican maxChargeInkWh ni currentChargeInkWh, se asume la recuperación sin restricciones en el cálculo de consumo.
departureTime	string	Hora estimada de salida para la ruta o la pierna. La hora es UTC.
fuelConsumptionInLiters	number	Consumo estimado de combustible en litros con el modelo de consumo de combustión. Incluido si vehicleEngineType se establece en combustión y se especifica constantSpeedConsumptionInLitersPerHundredkm. El valor no será negativo.
historicTrafficTravelTimeInSeconds	integer	Tiempo estimado de viaje calculado mediante datos de tráfico histórico dependientes del tiempo. Solo se incluye si compute TravelTimeFor = todo se usa en la consulta.
lengthInMeters	integer	Length In Meters (propiedad)
liveTrafficIncidentsTravelTimeInSeconds	integer	Tiempo de viaje estimado calculado mediante datos de velocidad en tiempo real. Solo se incluye si compute TravelTimeFor = todo se usa en la consulta.
noTrafficTravelTimeInSeconds	integer	Tiempo estimado de viaje calculado como si no haya retrasos en la ruta debido a condiciones de tráfico (por ejemplo, congestión). Solo se incluye si compute TravelTimeFor = todo se usa en la consulta.
trafficDelayInSeconds	integer	Retraso estimado en segundos causado por los incidentes en tiempo real según la información de tráfico. En el caso de las rutas planeadas con la hora de salida en el futuro, los retrasos siempre son 0. Para devolver tiempos de desplazamiento adicionales con diferentes tipos de información de tráfico, es necesario agregar el parámetro compute TravelTimeFor=all.
travelTimeInSeconds	integer	Tiempo de viaje estimado en segundos propiedad que incluye el retraso debido al tráfico en tiempo real. Tenga en cuenta que incluso cuando traffic=false travelTimeInSeconds todavía incluye el retraso debido al tráfico. Si DepartAt está en el futuro, el tiempo de viaje se calcula mediante datos de tráfico histórico dependientes del tiempo.

RouteMatrix

Objeto de resultado de matriz

Nombre	Tipo	Description
response	RouteMatrixResultResponse	Objeto response de la celda actual de la matriz de entrada.
statusCode	integer	Propiedad StatusCode de la celda actual de la matriz de entrada.

RouteMatrixQuery

Objeto con una matriz de coordenadas.

Nombre	Tipo	Description
destinations	GeoJsonMultiPoint	Un tipo de geometría válido `GeoJSON MultiPoint` . Consulte RFC 7946 para obtener más información.
origins	GeoJsonMultiPoint	Un tipo de geometría válido `GeoJSON MultiPoint` . Consulte RFC 7946 para obtener más información.

RouteMatrixResult

Este objeto se devuelve desde una llamada a Route Matrix correcta. Por ejemplo, si se proporcionan 2 orígenes y 3 destinos, habrá 2 matrices con 3 elementos en cada uno. El contenido de cada elemento depende de las opciones proporcionadas en la consulta.

Nombre	Tipo	Description
formatVersion	string	Format Version (propiedad)
matrix	RouteMatrix[]	Resultados como una matriz dimensional 2 de resúmenes de ruta.
summary	RouteMatrixSummary	Summary (objeto)

RouteMatrixResultResponse

Objeto response de la celda actual de la matriz de entrada.

Nombre	Tipo	Description
routeSummary	RouteLegSummary	Objeto de resumen para la sección de ruta.

RouteMatrixSummary

Summary (objeto)

Nombre	Tipo	Description
successfulRoutes	integer	Número de rutas correctas en la respuesta.
totalRoutes	integer	Número total de rutas solicitadas. Número de celdas de la matriz de entrada.

RouteType

Tipo de ruta solicitada.

Nombre	Tipo	Description
eco	string	Una ruta equilibrada por economía y velocidad.
fastest	string	La ruta más rápida.
shortest	string	La ruta más corta por distancia.
thrilling	string	Incluye carreteras interesantes o desafiantes y utiliza tan pocas autopistas como sea posible. Puede elegir el nivel de giro incluido y también el grado de colina. Consulte los parámetros de pendiente y de pararización para saber cómo establecer esto. Hay un límite de 900 km en rutas planeadas con `routeType`=emocionante

SectionType

Especifica cuáles de los tipos de sección se notifican en la respuesta de ruta.

Por ejemplo, si sectionType = peatonal las secciones que son adecuadas para los peatones solo se devuelven. Se pueden usar varios tipos. El valor predeterminado sectionType hace referencia a la entrada travelMode. De forma predeterminada, travelMode está establecido en coche.

Nombre	Tipo	Description
carTrain	string	Secciones de la ruta que son coches o trenes.
carpool	string	Secciones de la ruta que requieren el uso de carpool (vehículo de alta ocupación) carriles.
country	string	Secciones que indican en qué países o regiones se encuentra la ruta.
ferry	string	Secciones de la ruta que son ferries.
motorway	string	Secciones de la ruta que son autopistas.
pedestrian	string	Secciones de la ruta que solo son adecuadas para los peatones.
tollRoad	string	Secciones de la ruta que requieren que se pague un peaje.
tollVignette	string	Secciones de la ruta que requieren que haya una viñeta de peaje.
traffic	string	Secciones de la ruta que contienen información de tráfico.
travelMode	string	Secciones en relación con el parámetro `travelMode`request .
tunnel	string	Secciones de la ruta que son túneles.
urban	string	Secciones de la ruta que se encuentran dentro de las zonas urbanas.

TravelMode

Modo de viaje para la ruta solicitada. Si no se define, el valor predeterminado es "car". Tenga en cuenta que es posible que el travelMode solicitado no esté disponible para toda la ruta. Cuando el travelMode solicitado no está disponible para una sección determinada, el elemento travelMode de la respuesta de esa sección será "otro". Tenga en cuenta que los modos de viaje bus, motocicleta, taxi y camioneta son funcionalidad BETA. Los datos de restricción completa no están disponibles en todas las áreas.

Nombre	Tipo	Description
bicycle	string	Las rutas devueltas están optimizadas para bicicletas, incluido el uso de carriles de bicicletas.
bus	string	Las rutas devueltas están optimizadas para los autobuses, incluido el uso de solo carriles de autobús. Funcionalidad BETA.
car	string	Las rutas devueltas están optimizadas para automóviles.
motorcycle	string	Las rutas devueltas están optimizadas para motocicletas. Funcionalidad BETA.
pedestrian	string	Las rutas devueltas están optimizadas para los peatones, incluido el uso de aceras.
taxi	string	Las rutas devueltas están optimizadas para taxis. Funcionalidad BETA.
truck	string	Las rutas devueltas están optimizadas para vehículos comerciales, como para camiones.
van	string	Las rutas devueltas están optimizadas para las camionetas. Funcionalidad BETA.

VehicleLoadType

Tipos de carga que se pueden clasificar como materiales peligrosos y restringidos de algunas carreteras. Los valores de vehicleLoadType disponibles son clases hazmat de EE. UU. de 1 a 9, además de clasificaciones genéricas para su uso en otros países o regiones. Los valores que comienzan con USHazmat son para el enrutamiento de EE. UU., mientras que otroshazmat deben usarse para todos los demás países o regiones. vehicleLoadType se puede especificar varias veces. Este parámetro solo se considera actualmente para travelMode=truck.

Nombre	Tipo	Description
USHazmatClass1	string	Explosivos
USHazmatClass2	string	Gas comprimido
USHazmatClass3	string	Líquidos inflamables
USHazmatClass4	string	Sólidos inflamables
USHazmatClass5	string	Oxidantes
USHazmatClass6	string	Venenos
USHazmatClass7	string	Material radiactivo
USHazmatClass8	string	Corrosivos
USHazmatClass9	string	Disposiciones adicionales
otherHazmatExplosive	string	Explosivos
otherHazmatGeneral	string	Disposiciones adicionales
otherHazmatHarmfulToWater	string	Perjudicial para el agua

WindingnessLevel

Nivel de turnos para una ruta emocionante. Este parámetro solo se puede usar junto con routeType=thrilling.

Nombre	Tipo	Description
high	string	high
low	string	low
normal	string	normal

Route - Post Route Matrix

Enviar solicitud de matriz de ruta sincrónica

Enviar solicitud de matriz de ruta asincrónica

Descargar resultados de sincronización

Descargar resultados asincrónicos

Parámetros de identificador URI

Encabezado de la solicitud

Cuerpo de la solicitud

Respuestas

Seguridad

AADToken

Notas

Scopes

subscription-key

SAS Token

Ejemplos

Successfully submit a route matrix request

Sample Request

Sample Response

Definiciones

ComputeTravelTime

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GeoJsonMultiPoint

InclineLevel

JsonFormat

RouteAvoidType

RouteLegSummary

RouteMatrix

RouteMatrixQuery

RouteMatrixResult

RouteMatrixResultResponse

RouteMatrixSummary

RouteType

SectionType

TravelMode

VehicleLoadType

WindingnessLevel

Recursos adicionales