Route - Get Route Range

ResponseFormat

Formato pretendido da resposta. O valor pode ser json ou xml.

string

Número da versão da API do Azure Maps.

number[]

A Coordenada a partir da qual o cálculo do intervalo deve ser iniciado.

number

Especifica a eficiência da conversão de energia química armazenada em combustível em energia cinética quando o veículo acelera (ou seja, KineticEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed é obtido através da conversão de combustível consumido em energia química utilizando fuelEnergyDensityInMJoulesPerLiter.

Tem de ser emparelhado com a desaceleraçãoEficiência.

O intervalo de valores permitidos é de 0,0 a 1/deceleraçãoEficiência.

Valores Sensatos: para o Modelo de Combustão : 0,33, para Modelo Elétrico : 0,66

number

Especifica a quantidade de energia consumida para sustentar sistemas auxiliares, em kilowatts (kW).

Pode ser utilizado para especificar o consumo devido a dispositivos e sistemas como sistemas CA, rádio, aquecimento, etc.

Valores Sensatos: 1,7

number

Especifica a quantidade de combustível consumido para sustentar sistemas auxiliares do veículo, em litros por hora.

Pode ser utilizado para especificar o consumo devido a dispositivos e sistemas como sistemas CA, rádio, aquecimento, etc.

Valores Sensatos: 0,2

RouteAvoidType[]

Especifica algo que o cálculo da rota deve tentar evitar ao determinar a rota. Pode ser especificado várias vezes num pedido, por exemplo, "&avoid=motorways&avoid=tollRoads&avoid=ferries". Nos pedidos do Intervalo de Rotas, o valor jáUsedRoads não pode ser utilizado.

string

Especifica o componente dependente da velocidade do consumo.

Fornecido como uma lista não ordenada de pares de velocidade/taxa de consumo. A lista define pontos numa curva de consumo. As taxas de consumo para velocidades que não se encontram na lista são encontradas da seguinte forma:

• por interpolação linear, se a velocidade especificada se situar entre duas velocidades na lista

• por extrapolação linear, caso contrário, assumindo uma constante (ΔConsumption/ΔSpeed) determinada pelos dois pontos mais próximos na lista

A lista tem de conter entre 1 e 25 pontos (inclusive) e não pode conter pontos duplicados para a mesma velocidade. Se apenas contiver um único ponto, a taxa de consumo desse ponto é utilizada sem processamento adicional.

O consumo especificado para a maior velocidade tem de ser maior ou igual ao da penúltima maior velocidade. Isto garante que a extrapolação não conduz a taxas de consumo negativas.

Da mesma forma, os valores de consumo especificados para as duas velocidades mais pequenas na lista não podem levar a uma taxa de consumo negativa para qualquer velocidade mais pequena.

O intervalo válido para os valores de consumo (expresso em kWh/100km) está entre 0,01 e 100000,0.

Valores Sensatos: 50,8.2:130,21.3

Este parâmetro é necessário para o modelo de consumo Elétrico.

string

Especifica o componente dependente da velocidade do consumo.

Fornecido como uma lista não ordenada de velocidade delimitada por dois pontos & pares de taxa de consumo. A lista define pontos numa curva de consumo. As taxas de consumo para velocidades que não se encontram na lista são encontradas da seguinte forma:

• por interpolação linear, se a velocidade especificada se situar entre duas velocidades na lista

• por extrapolação linear, caso contrário, assumindo uma constante (ΔConsumption/ΔSpeed) determinada pelos dois pontos mais próximos na lista

A lista tem de conter entre 1 e 25 pontos (inclusive) e não pode conter pontos duplicados para a mesma velocidade. Se apenas contiver um único ponto, a taxa de consumo desse ponto é utilizada sem processamento adicional.

O consumo especificado para a maior velocidade tem de ser maior ou igual ao da penúltima maior velocidade. Isto garante que a extrapolação não conduz a taxas de consumo negativas.

Da mesma forma, os valores de consumo especificados para as duas velocidades mais pequenas na lista não podem levar a uma taxa de consumo negativa para qualquer velocidade mais pequena.

O intervalo válido para os valores de consumo (expresso em l/100km) está entre 0,01 e 100000,0.

Valores Sensatos: 50,6.3:130,11.5

Nota : este parâmetro é necessário para o Modelo de Consumo de Combustão.

number

Especifica o fornecimento de energia elétrica atual em kilowatt hours (kWh).

Este parâmetro coexiste com o parâmetro maxChargeInkWh .

O intervalo de valores permitidos é de 0,0 a maxChargeInkWh.

Valores Sensatos: 43

number

Especifica o fornecimento atual de combustível em litros.

Valores Sensatos: 55

number

Especifica a eficiência da conversão de energia cinética em combustível guardado (não consumido) quando o veículo decelera (ou seja, ChemicalEnergySaved/KineticEnergyLost). ChemicalEnergySaved é obtido através da conversão de combustível guardado (não consumido) em energia utilizando fuelEnergyDensityInMJoulesPerLiter.

Tem de ser emparelhado com accelerationEfficiency.

O intervalo de valores permitidos é de 0,0 a 1/accelerationEfficiency.

Valores Sensatos: para o Modelo de Combustão : 0,83, para Modelo Elétrico : 0.91

string

A data e hora de partida do ponto de origem formatada como um dateTime valor conforme definido em RFC 3339, secção 5.6, com um desvio opcional do fuso horário. Quando um desvio de fuso horário não é especificado, assume-se que é o do ponto de origem.

• Valor predefinido: agora
• Outro valor: dateTime

Exemplos:

• 2023-12-19T16:39:57
• 2023-12-20T00:39:57+00:00

O departAt parâmetro não pode ser utilizado em conjunto com arriveAt.

number

Orçamento de distância em medidores que determina o intervalo máximo que pode ser percorrido com a distância de condução. O Modelo de Consumo só afetará o intervalo quando routeType for eco.
Tem de ser utilizado exatamente um orçamento (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec ou distanceBudgetInMeters).

number

Especifica a eficiência da conversão de energia potencial em combustível guardado (não consumido) quando o veículo perde elevação (ou seja, ChemicalEnergySaved/PotentialEnergyLost). ChemicalEnergySaved é obtido através da conversão de combustível guardado (não consumido) em energia utilizando fuelEnergyDensityInMJoulesPerLiter.

Tem de ser emparelhado com uphillEfficiency.

O intervalo de valores permitidos é de 0,0 a 1/uphillEfficiency.

Valores Sensatos: para o Modelo de Combustão : 0,51, para Modelo Elétrico : 0,73

number

Orçamento de energia elétrica em kilowatt horas (kWh) que determina o intervalo máximo que pode ser percorrido com o Modelo de Consumo Elétrico especificado.
Quando o energyBudgetInkWh é utilizado, é obrigatório especificar um Modelo de Consumo Elétrico detalhado.
Tem de ser utilizado exatamente um orçamento (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec ou distanceBudgetInMeters).

number

Orçamento do combustível em litros que determina o intervalo máximo que pode ser percorrido com o Modelo de Consumo de Combustão especificado.
Quando fuelBudgetInLiters é utilizado, é obrigatório especificar um Modelo de Consumo de Combustão detalhado.
Tem de ser utilizado exatamente um orçamento (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec ou distanceBudgetInMeters).

number

Especifica a quantidade de energia química armazenada num litro de combustível em megajoules (MJ). É utilizado em conjunto com os *Parâmetros de eficiência para conversões entre energia e combustível guardados ou consumidos. Por exemplo, a densidade energética é de 34,2 MJ/l para gasolina e 35,8 MJ/l para combustível diesel.

Este parâmetro é necessário se algum *Parâmetro de eficiência estiver definido.

Valores Sensatos: 34.2

InclineLevel

Grau de colina para uma rota emocionante. Este parâmetro só pode ser utilizado em conjunto com routeType=emocionante.

number

Especifica o fornecimento máximo de energia elétrica em kilowatt horas (kWh) que pode ser armazenado na bateria do veículo.

Este parâmetro coexiste com o parâmetro currentChargeInkWh .

O valor mínimo tem de ser maior ou igual a currentChargeInkWh.

Valores Sensatos: 85

RouteType

O tipo de rota pedida.

number

Orçamento de tempo em segundos que determina o intervalo máximo que pode ser percorrido com o tempo de condução. O Modelo de Consumo só afetará o intervalo quando routeType for eco.
Tem de ser utilizado exatamente um orçamento (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec ou distanceBudgetInMeters).

boolean

Valores possíveis:

• true - Considere todas as informações de tráfego disponíveis durante o encaminhamento
• false - Ignore os dados de tráfego atuais durante o encaminhamento. Tenha em atenção que, embora os dados de tráfego atuais sejam ignorados durante o encaminhamento, o efeito do tráfego histórico em velocidades de estrada eficazes continua a ser incorporado.

TravelMode

O modo de viagem para a rota pedida. Se não estiver definido, a predefinição é "carro". Tenha em atenção que o travelMode pedido pode não estar disponível para toda a rota. Quando o travelMode pedido não estiver disponível para uma secção específica, o elemento travelMode da resposta para essa secção será "outro". Tenha em atenção que os modos de viagem de ônibus, motociclo, táxi e van são funcionalidades BETA. Os dados de restrição total não estão disponíveis em todas as áreas.

number

Especifica a eficiência da conversão de energia química armazenada em combustível em energia potencial quando o veículo ganha elevação (ou seja, PotentialEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed é obtido através da conversão de combustível consumido em energia química utilizando fuelEnergyDensityInMJoulesPerLiter.

Tem de ser emparelhado com a descidaEficiência.

O intervalo de valores permitidos é de 0,0 a 1/descidaEficiência.

Valores Sensatos: para o Modelo de Combustão : 0.27, para Modelo Elétrico : 0,74

integer

Peso por eixo do veículo em kg. Um valor de 0 significa que as restrições de peso por eixo não são consideradas.

boolean

Se o veículo é utilizado para fins comerciais. Os veículos comerciais podem não ser autorizados a conduzir em algumas estradas.

VehicleEngineType

Tipo de motor do veículo. Quando um Modelo de Consumo detalhado é especificado, tem de ser consistente com o valor de vehicleEngineType.

number

Altura do veículo em metros. Um valor de 0 significa que as restrições de altura não são consideradas.

number

Comprimento do veículo em metros. Um valor de 0 significa que as restrições de comprimento não são consideradas.

VehicleLoadType

Tipos de carga que podem ser classificados como materiais perigosos e restringidos a algumas estradas. Os valores de vehicleLoadType disponíveis são classes Hazmat dos EUA de 1 a 9, além de classificações genéricas para utilização noutros países/regiões. Os valores que começam com USHazmat destinam-se ao encaminhamento dos EUA, enquanto outrosHazmat devem ser utilizados para todos os outros países/regiões. vehicleLoadType pode ser especificado várias vezes. Este parâmetro é atualmente considerado apenas para travelMode=truck.

integer

Velocidade máxima do veículo em km/hora. A velocidade máxima no perfil do veículo é utilizada para verificar se um veículo é permitido nas auto-estradas.

• Um valor de 0 significa que um valor adequado para o veículo será determinado e aplicado durante o planeamento da rota.

• Um valor não zero pode ser substituído durante o planeamento de rotas. Por exemplo, o fluxo de tráfego atual é de 60 km/hora. Se a velocidade máxima do veículo estiver definida como 50 km/hora, o motor de encaminhamento considerará 60 km/hora, uma vez que esta é a situação atual. Se a velocidade máxima do veículo for fornecida como 80 km/hora, mas o fluxo de tráfego atual for de 60 km/hora, o motor de encaminhamento voltará a utilizar 60 km/hora.

integer

Peso do veículo em quilogramas.

• É obrigatório se algum dos parâmetros *Eficiência estiver definido.

• Tem de ser estritamente positivo quando utilizado no contexto do Modelo de Consumo. As restrições de peso são consideradas.

• Se não for especificado nenhum Modelo de Consumo detalhado e o valor de vehicleWeight não for zero, as restrições de peso serão consideradas.

• Em todos os outros casos, este parâmetro é ignorado.

Valores Sensatos: para o Modelo de Combustão : 1600, para Modelo Elétrico : 1900

number

Largura do veículo em metros. Um valor de 0 significa que as restrições de largura não são consideradas.

WindingnessLevel

Nível de voltas para uma rota emocionante. Este parâmetro só pode ser utilizado em conjunto com routeType=emocionante.