Route - Get Route Range

Referencia

Servicio:: Maps

Versión de la API:: 1.0

Use para crear un mapa que muestre el área accesible desde un punto determinado dentro de un umbral determinado en función del tiempo, la distancia o la capacidad de combustible.

La Get Route Range API (Isochrone) es una solicitud HTTP GET que calculará un conjunto de ubicaciones a las que se puede acceder desde el punto de origen en función del presupuesto de combustible, energía, tiempo o distancia especificado. Se devuelve un límite de polígono (o Isochrone) en una orientación en sentido contrario a las agujas del reloj, así como el centro de polígono preciso que era el resultado del punto de origen.

El polígono devuelto se puede usar para su posterior procesamiento, como Search Inside Geometry , para buscar pois en el isócrono proporcionado.

GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}

Con parámetros opcionales:

GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}&fuelBudgetInLiters={fuelBudgetInLiters}&energyBudgetInkWh={energyBudgetInkWh}&timeBudgetInSec={timeBudgetInSec}&distanceBudgetInMeters={distanceBudgetInMeters}&departAt={departAt}&routeType={routeType}&traffic={traffic}&avoid={avoid}&travelMode={travelMode}&hilliness={hilliness}&windingness={windingness}&vehicleAxleWeight={vehicleAxleWeight}&vehicleWidth={vehicleWidth}&vehicleHeight={vehicleHeight}&vehicleLength={vehicleLength}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&vehicleCommercial={vehicleCommercial}&vehicleLoadType={vehicleLoadType}&vehicleEngineType={vehicleEngineType}&constantSpeedConsumptionInLitersPerHundredkm={constantSpeedConsumptionInLitersPerHundredkm}&currentFuelInLiters={currentFuelInLiters}&auxiliaryPowerInLitersPerHour={auxiliaryPowerInLitersPerHour}&fuelEnergyDensityInMJoulesPerLiter={fuelEnergyDensityInMJoulesPerLiter}&accelerationEfficiency={accelerationEfficiency}&decelerationEfficiency={decelerationEfficiency}&uphillEfficiency={uphillEfficiency}&downhillEfficiency={downhillEfficiency}&constantSpeedConsumptionInkWhPerHundredkm={constantSpeedConsumptionInkWhPerHundredkm}&currentChargeInkWh={currentChargeInkWh}&maxChargeInkWh={maxChargeInkWh}&auxiliaryPowerInkW={auxiliaryPowerInkW}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
format	path	True	ResponseFormat	Formato deseado de la respuesta. El valor puede ser json o xml.
api-version	query	True	string	Número de versión de la API de Azure Maps.
query	query	True	number[]	Coordenada desde la que se debe iniciar el cálculo del intervalo.
accelerationEfficiency	query		number double	Especifica la eficiencia de convertir la energía química almacenada en combustible a energía cinética cuando el vehículo se acelera (es decir, CinéticaEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed se obtiene convirtiendo el combustible consumido en energía química utilizando fuelEnergyDensityInMJoulesPerLiter. Debe emparejarse con deceleraciónEfficiency. El intervalo de valores permitidos es de 0,0 a 1/deceleraciónEfficiency. Valores razonables : para el modelo de combustión : 0,33, para el modelo eléctrico : 0,66
auxiliaryPowerInkW	query		number double	Especifica la cantidad de energía consumida para mantener sistemas auxiliares, en kilowatts (kW). Se puede utilizar para especificar el consumo debido a dispositivos y sistemas como sistemas de CA, radio, calefacción, etc. Valores razonables: 1,7
auxiliaryPowerInLitersPerHour	query		number double	Especifica la cantidad de combustible consumido para mantener sistemas auxiliares del vehículo, en litros por hora. Se puede utilizar para especificar el consumo debido a dispositivos y sistemas como sistemas de CA, radio, calefacción, etc. Valores razonables: 0,2
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 ruta, no se debe usar el valor alreadyUsedRoads.
constantSpeedConsumptionInkWhPerHundredkm	query		string	Especifica el componente dependiente de la velocidad del consumo. Se proporciona como una lista desordenada de pares de velocidad/tasa de consumo. La lista define puntos en una curva de consumo. Las tasas de consumo de velocidades que no están en la lista se encuentran de la siguiente manera: por interpolación lineal, si la velocidad dada se encuentra entre dos velocidades de la lista por extrapolación lineal; de lo contrario, suponiendo una constante (ΔConsumption/ΔSpeed) determinada por los dos puntos más cercanos de la lista La lista debe contener entre 1 y 25 puntos (inclusive) y no puede contener puntos duplicados para la misma velocidad. Si solo contiene un único punto, la tasa de consumo de ese punto se usa sin procesamiento adicional. El consumo especificado para la mayor velocidad debe ser mayor o igual que el de la penúltima velocidad más grande. Esto garantiza que la extrapolación no conduce a tasas de consumo negativas. De forma similar, los valores de consumo especificados para las dos velocidades más pequeñas de la lista no pueden dar lugar a una tasa de consumo negativa para cualquier velocidad más pequeña. El intervalo válido para los valores de consumo (expresados en kWh/100km) está comprendido entre 0,01 y 100000,0. Valores razonables: 50,8.2:130,21.3 Este parámetro es necesario para el modelo de consumo eléctrico.
constantSpeedConsumptionInLitersPerHundredkm	query		string	Especifica el componente dependiente de la velocidad del consumo. Se proporciona como una lista desordenada de velocidad delimitada por dos puntos & pares de tasa de consumo. La lista define puntos en una curva de consumo. Las tasas de consumo de velocidades que no están en la lista se encuentran de la siguiente manera: por interpolación lineal, si la velocidad dada se encuentra entre dos velocidades de la lista por extrapolación lineal; de lo contrario, suponiendo una constante (ΔConsumption/ΔSpeed) determinada por los dos puntos más cercanos de la lista La lista debe contener entre 1 y 25 puntos (inclusive) y no puede contener puntos duplicados para la misma velocidad. Si solo contiene un único punto, la tasa de consumo de ese punto se usa sin procesamiento adicional. El consumo especificado para la mayor velocidad debe ser mayor o igual que el de la penúltima velocidad más grande. Esto garantiza que la extrapolación no conduce a tasas de consumo negativas. De forma similar, los valores de consumo especificados para las dos velocidades más pequeñas de la lista no pueden dar lugar a una tasa de consumo negativa para cualquier velocidad más pequeña. El intervalo válido para los valores de consumo (expresados en l/100km) está comprendido entre 0,01 y 100000,0. Valores razonables: 50,6,3:130,11,5 Nota : Este parámetro es necesario para el modelo de consumo de combustión.
currentChargeInkWh	query		number double	Especifica el suministro de energía eléctrica actual en kilowatt horas (kWh). Este parámetro existe conjuntamente con el parámetro maxChargeInkWh . El intervalo de valores permitidos es de 0,0 a maxChargeInkWh. Valores razonables: 43
currentFuelInLiters	query		number double	Especifica el suministro actual de combustible en litros. Valores razonables: 55
decelerationEfficiency	query		number double	Especifica la eficiencia de convertir la energía cinética en combustible ahorrado (no consumido) cuando el vehículo se decelera (es decir, ChemicalEnergySaved/CinéticaEnergyLost). ChemicalEnergySaved se obtiene convirtiendo el combustible guardado (no consumido) en energía utilizando fuelEnergyDensityInMJoulesPerLiter. Debe emparejarse con accelerationEfficiency. El intervalo de valores permitidos es de 0,0 a 1/accelerationEfficiency. Valores razonables : para el modelo de combustión : 0,83, para el modelo eléctrico : 0,91
departAt	query		string date-time	Fecha y hora de salida del punto de origen con formato de `dateTime` valor definido en RFC 3339, sección 5.6, con un 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`.
distanceBudgetInMeters	query		number double	Presupuesto de distancia en metros que determina el rango máximo que se puede recorrer utilizando la distancia de conducción. El modelo de consumo solo afectará al intervalo cuando routeType sea eco. Se debe usar exactamente un presupuesto (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec o distanceBudgetInMeters).
downhillEfficiency	query		number double	Especifica la eficiencia de convertir energía potencial en combustible ahorrado (no consumido) cuando el vehículo pierde la elevación (es decir, ChemicalEnergySaved/PotentialEnergyLost). ChemicalEnergySaved se obtiene convirtiendo el combustible guardado (no consumido) en energía utilizando fuelEnergyDensityInMJoulesPerLiter. Debe emparejarse con uphillEfficiency. El intervalo de valores permitidos es de 0,0 a 1/uphillEfficiency. Valores razonables : para el modelo de combustión : 0,51, para el modelo eléctrico : 0,73
energyBudgetInkWh	query		number double	Presupuesto de energía eléctrica en kilowatt horas (kWh) que determina el rango máximo que se puede recorrer utilizando el modelo de consumo eléctrico especificado. Cuando se usa energyBudgetInkWh, es obligatorio especificar un modelo de consumo eléctrico detallado. Se debe usar exactamente un presupuesto (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec o distanceBudgetInMeters).
fuelBudgetInLiters	query		number double	Presupuesto de combustible en litros que determina el rango máximo que se puede viajar utilizando el modelo de consumo de combustión especificado. Cuando se utiliza fuelBudgetInLiters, es obligatorio especificar un modelo de consumo de combustión detallado. Se debe usar exactamente un presupuesto (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec o distanceBudgetInMeters).
fuelEnergyDensityInMJoulesPerLiter	query		number double	Especifica la cantidad de energía química almacenada en un litro de combustible en megajoules (MJ). Se utiliza junto con los parámetros *Efficiency para conversiones entre energía guardada o consumida y combustible. Por ejemplo, la densidad energética es de 34,2 MJ/l para gasolina y 35,8 MJ/l para combustible diesel. Este parámetro es necesario si se establece cualquier parámetro *Efficiency . Valores razonables: 34.2
hilliness	query		InclineLevel	Grado de colina para la emocionante ruta. Este parámetro solo se puede usar junto con `routeType`=thrilling.
maxChargeInkWh	query		number double	Especifica el suministro máximo de energía eléctrica en kilowatt horas (kWh) que se pueden almacenar en la batería del vehículo. Este parámetro coexiste con el parámetro currentChargeInkWh . El valor mínimo debe ser mayor o igual que currentChargeInkWh. Valores razonables: 85
routeType	query		RouteType	Tipo de ruta solicitada.
timeBudgetInSec	query		number double	Presupuesto de tiempo en segundos que determina el intervalo máximo que se puede recorrer utilizando el tiempo de conducción. El modelo de consumo solo afectará al intervalo cuando routeType sea eco. Se debe usar exactamente un presupuesto (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec o distanceBudgetInMeters).
traffic	query		boolean	Valores posibles: true: considere toda la información de tráfico disponible durante el enrutamiento. false: omite 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 todavía se incorpora.
travelMode	query		TravelMode	Modo de desplazamiento para la ruta solicitada. Si no se define, el valor predeterminado es "car". Tenga en cuenta que el travelMode solicitado puede no estar disponible para toda la ruta. Si el objeto travelMode solicitado no está disponible para una sección determinada, el elemento travelMode de la respuesta de esa sección será "otro". Ten en cuenta que los modos de viaje bus, motocicleta, taxi y camioneta son la funcionalidad BETA. Los datos de restricción completa no están disponibles en todas las áreas.
uphillEfficiency	query		number double	Especifica la eficiencia de convertir la energía química almacenada en combustible a energía potencial cuando el vehículo obtiene elevación (es decir, PotentialEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed se obtiene convirtiendo el combustible consumido en energía química utilizando fuelEnergyDensityInMJoulesPerLiter. Debe emparejarse con downhillEfficiency. El intervalo de valores permitidos es de 0,0 a 1/downhillEfficiency. Valores razonables : para el modelo de combustión : 0,27, para el modelo eléctrico : 0,74
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.
vehicleCommercial	query		boolean	Si el vehículo se utiliza con fines comerciales. Es posible que los vehículos comerciales no puedan conducir en algunas carreteras.
vehicleEngineType	query		VehicleEngineType	Tipo de motor del vehículo. Cuando se especifica un modelo de consumo detallado, debe ser coherente con el valor de vehicleEngineType.
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 pueden clasificarse 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 usará de nuevo 60 km/hora.
vehicleWeight	query		integer	Peso del vehículo en kilogramos. Es obligatorio si se establece cualquiera de los parámetros Efficiency. Debe ser estrictamente positivo cuando se usa en el contexto del modelo de consumo. Se tienen en cuenta las restricciones de peso. Si no se especifica ningún modelo de consumo* detallado y el valor de vehicleWeight es distinto de cero, se tienen en cuenta las restricciones de peso. En todos los demás casos, este parámetro se omite. Valores razonables : para el modelo de combustión : 1600, para el modelo eléctrico : 1900
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.
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 Id. de Entra de Microsoft. 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 la seguridad de id. de Entra de Microsoft en Azure Maps, consulte los siguientes artículos para obtener instrucciones.

Respuestas

Nombre	Tipo	Description
200 OK	RouteRangeResult	Aceptar
Other Status Codes	ErrorResponse	Se ha producido un error inesperado.

Seguridad

AADToken

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

Para implementar escenarios, se recomienda ver los conceptos de autenticación. En resumen, esta definición de seguridad proporciona una solución para el modelado de 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 de Azure Maps solicita acceso la aplicación. 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 id. de Microsoft Entra. * El control de acceso basado en rol de Azure se configura desde el plano de administración de Azure mediante Azure Portal, PowerShell, la CLI, los SDK de Azure o las 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 la plataforma de identidad de Microsoft, consulte Introducción a la plataforma de identidad de Microsoft.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

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

subscription-key

Se trata de una clave compartida que se aprovisiona al crear una cuenta de Azure Maps en 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 las API REST de Azure Maps para que la clave se pueda almacenar de forma segura.

Tipo: apiKey
En: query

SAS Token

Se trata de un token de firma de acceso compartido que se crea 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, la CLI, los SDK de Azure o las API REST.

Con este token, cualquier aplicación está autorizada para acceder a los controles de acceso basado en roles de Azure y al control específico de la expiración, la tasa y las regiones de uso para el token determinado. Es decir, 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 mapa para limitar la representación de abusos y renovar periódicamente el token de SAS.

Tipo: apiKey
En: header

Ejemplos

Successfully retrieve a set of locations that can be reached from the origin point based on various conditions

Solicitud de ejemplo

HTTP

GET https://atlas.microsoft.com/route/range/json?api-version=1.0&query=50.97452,5.86605&timeBudgetInSec=6000

Respuesta de muestra

status code:: 200

{
  "formatVersion": "0.0.1",
  "reachableRange": {
    "center": {
      "latitude": 50.9745,
      "longitude": 5.86605
    },
    "boundary": [
      {
        "latitude": 52.03704,
        "longitude": 5.73602
      },
      {
        "latitude": 52.09456,
        "longitude": 5.59435
      },
      {
        "latitude": 52.16815,
        "longitude": 5.42279
      },
      {
        "latitude": 52.25047,
        "longitude": 5.21276
      },
      {
        "latitude": 52.21374,
        "longitude": 5.15355
      },
      {
        "latitude": 52.25674,
        "longitude": 4.96687
      },
      {
        "latitude": 52.07834,
        "longitude": 4.739
      },
      {
        "latitude": 52.05647,
        "longitude": 4.72513
      },
      {
        "latitude": 51.94553,
        "longitude": 4.53237
      },
      {
        "latitude": 51.70119,
        "longitude": 4.31165
      },
      {
        "latitude": 51.5837,
        "longitude": 4.28917
      },
      {
        "latitude": 51.48463,
        "longitude": 3.82685
      },
      {
        "latitude": 51.21096,
        "longitude": 3.62838
      },
      {
        "latitude": 50.6814,
        "longitude": 3.89244
      },
      {
        "latitude": 50.66791,
        "longitude": 3.93493
      },
      {
        "latitude": 50.49042,
        "longitude": 3.98156
      },
      {
        "latitude": 50.30944,
        "longitude": 4.47995
      },
      {
        "latitude": 50.24448,
        "longitude": 4.60502
      },
      {
        "latitude": 50.24467,
        "longitude": 4.89999
      },
      {
        "latitude": 50.08735,
        "longitude": 5.04206
      },
      {
        "latitude": 49.99214,
        "longitude": 5.23042
      },
      {
        "latitude": 49.88478,
        "longitude": 5.40994
      },
      {
        "latitude": 49.85797,
        "longitude": 5.46178
      },
      {
        "latitude": 49.86279,
        "longitude": 5.7196
      },
      {
        "latitude": 49.83259,
        "longitude": 5.74151
      },
      {
        "latitude": 50.22239,
        "longitude": 5.9387
      },
      {
        "latitude": 50.0011,
        "longitude": 6.08535
      },
      {
        "latitude": 50.04616,
        "longitude": 6.12089
      },
      {
        "latitude": 50.09472,
        "longitude": 6.28373
      },
      {
        "latitude": 49.95863,
        "longitude": 6.51654
      },
      {
        "latitude": 50.00485,
        "longitude": 6.61034
      },
      {
        "latitude": 50.00587,
        "longitude": 6.70295
      },
      {
        "latitude": 50.2947,
        "longitude": 6.65865
      },
      {
        "latitude": 50.36903,
        "longitude": 6.79276
      },
      {
        "latitude": 50.31614,
        "longitude": 7.32163
      },
      {
        "latitude": 50.36737,
        "longitude": 7.58782
      },
      {
        "latitude": 50.46919,
        "longitude": 7.7626
      },
      {
        "latitude": 50.96246,
        "longitude": 7.9826
      },
      {
        "latitude": 51.07086,
        "longitude": 7.55924
      },
      {
        "latitude": 51.36614,
        "longitude": 7.58138
      },
      {
        "latitude": 51.52015,
        "longitude": 7.67861
      },
      {
        "latitude": 51.65781,
        "longitude": 7.35175
      },
      {
        "latitude": 51.81916,
        "longitude": 7.21664
      },
      {
        "latitude": 51.9587,
        "longitude": 7.0467
      },
      {
        "latitude": 51.82713,
        "longitude": 6.67267
      },
      {
        "latitude": 51.81133,
        "longitude": 6.48424
      },
      {
        "latitude": 51.9368,
        "longitude": 6.27316
      },
      {
        "latitude": 52.01701,
        "longitude": 6.14452
      },
      {
        "latitude": 52.20847,
        "longitude": 6.09312
      },
      {
        "latitude": 52.23705,
        "longitude": 6.01297
      }
    ]
  }
}

Definiciones

Nombre	Description
EffectiveSetting	Parámetro o datos efectivos que se usan al llamar a esta API de ruta.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
InclineLevel	Grado de colina para la emocionante ruta. Este parámetro solo se puede usar junto con `routeType`=thrilling.
LatLongPair	Una ubicación representada como latitud y longitud.
ResponseFormat	Formato deseado de la respuesta. El valor puede ser json o xml.
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.
RouteRange	Intervalo accesible
RouteRangeResult	Este objeto se devuelve a partir de una llamada de intervalo accesible de ruta correcta.
RouteReport	Informa de la configuración efectiva usada en la llamada actual.
RouteType	Tipo de ruta solicitada.
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.
VehicleEngineType	Tipo de motor del vehículo. Cuando se especifica un modelo de consumo detallado, debe ser coherente con el valor de vehicleEngineType.
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.

EffectiveSetting

Parámetro o datos efectivos que se usan al llamar a esta API de ruta.

Nombre	Tipo	Description
key	string	Nombre del parámetro usado.
value	string	Valor del parámetro usado.

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.

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

LatLongPair

Una ubicación representada como latitud y longitud.

Nombre	Tipo	Description
latitude	number	Latitude (propiedad)
longitude	number	Longitud (propiedad)

ResponseFormat

Formato deseado de la respuesta. El valor puede ser json o xml.

Nombre	Tipo	Description
json	string	Formato de intercambio de datos de notación de objetos JavaScript
xml	string	Lenguaje de marcado extensible

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

RouteRange

Intervalo accesible

Nombre	Tipo	Description
boundary	LatLongPair[]	Límite de polígono del intervalo accesible representado como una lista de puntos.
center	LatLongPair	Punto central del intervalo accesible

RouteRangeResult

Este objeto se devuelve a partir de una llamada de intervalo accesible de ruta correcta.

Nombre	Tipo	Description
formatVersion	string	Format Version (propiedad)
reachableRange	RouteRange	Intervalo accesible
report	RouteReport	Informa de la configuración efectiva usada en la llamada actual.

RouteReport

Informa de la configuración efectiva usada en la llamada actual.

Nombre	Tipo	Description
effectiveSettings	EffectiveSetting[]	Parámetros o datos efectivos que se usan al llamar a esta ROUTE API.

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

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
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.
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.

VehicleEngineType

Tipo de motor del vehículo. Cuando se especifica un modelo de consumo detallado, debe ser coherente con el valor de vehicleEngineType.

Nombre	Tipo	Description
combustion	string	Motor de combustión interna.
electric	string	Motor eléctrico.

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

Compartir a través de