RouteDirectionOptions Classe

Construtor de RouteDirectionOptions.

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 pela conversão de combustível consumido em energia química usando fuelEnergyDensityInMJoulesPerLiter. Deve ser emparelhado com decelerationEfficiency. O intervalo de valores permitidos é de 0,0 a 1/decelerationEfficiency. Valores sensatos: para o modelo de combustão: 0,33, para o modelo elétrico: 0,66

Controla a idealidade, em relação aos critérios de planejamento fornecidos, das alternativas calculadas em comparação com a rota de referência.

A data e a hora de chegada no ponto de destino. Ele deve ser especificado como dateTime. Quando um deslocamento de fuso horário não for especificado, ele será considerado o do ponto de destino. O valor arriveAt deve estar no futuro. O parâmetro arriveAt não pode ser usado em conjunto com departAt, minDeviationDistance ou minDeviationTime.

Especifica a quantidade de energia consumida para sustentar sistemas auxiliares, em quilowatts (kW). Ele pode ser usado para especificar o consumo devido a dispositivos e sistemas como sistemas AC, rádio, aquecimento etc. Valores sensatos: 1,7

Especifica a quantidade de combustível consumida para sustentar sistemas auxiliares do veículo, em litros por hora. Ele pode ser usado para especificar o consumo devido a dispositivos e sistemas como sistemas AC, rádio, aquecimento etc. Valores sensatos: 0,2

Especifica algo que o cálculo de rota deve tentar evitar ao determinar a rota. Pode ser especificado várias vezes em uma solicitação. Em solicitações calculateReachableRange, o valor alreadyUsedRoads não deve ser usado.

Ordene novamente os pontos de passagem de rota usando um algoritmo heurístico rápido para reduzir o comprimento da rota. Gera melhores resultados quando usado em conjunto com routeType mais curto. Observe que a origem e o destino são excluídos dos índices de ponto de passagem otimizados. Para incluir a origem e o destino na resposta, aumente todos os índices em 1 para considerar a origem e adicione o destino como o índice final. Os possíveis valores são true ou false. True calcula uma ordem melhor, se possível, mas não tem permissão para ser usado em conjunto com o valor maxAlternatives maior que 0 ou em conjunto com pontos de passagem de círculo. False usará os locais na ordem determinada e não poderá ser usado em conjunto com routeRepresentation none.

Especifica o componente dependente de velocidade do consumo. Fornecido como uma lista não ordenada de pares de velocidade/taxa de consumo. A lista define pontos em uma curva de consumo. As taxas de consumo para velocidades que não estão na lista são encontradas da seguinte maneira:

• por interpolação linear, se a velocidade fornecida estiver entre duas velocidades na lista
• por extrapolação linear caso contrário, supondo uma constante (ΔConsumption/ΔSpeed) determinada pelos dois pontos mais próximos na lista

Especifica o componente dependente de velocidade do consumo. Fornecida como uma lista não ordenada de pares de taxa de consumo de velocidade & delimitada por dois-pontos. A lista define pontos em uma curva de consumo. As taxas de consumo para velocidades que não estão na lista são encontradas da seguinte maneira:

• por interpolação linear, se a velocidade fornecida estiver entre duas velocidades na lista
• por extrapolação linear caso contrário, supondo uma constante (ΔConsumption/ΔSpeed) determinada pelos dois pontos mais próximos na lista

Especifica o fornecimento de energia elétrica atual em quilowatts-hora (kWh). Esse parâmetro coexiste com MaxChargeInKilowattHour o parâmetro . O intervalo de valores permitidos é de 0,0 a MaxChargeInKilowattHour. Valores sensatos: 43

Especifica o fornecimento atual de combustível em litros. Valores sensatos: 55

Especifica a eficiência da conversão de energia cinética em combustível salvo (não consumido) quando o veículo desacelera (ou seja, ChemicalEnergySaved/KineticEnergyLost). ChemicalEnergySaved_ é obtido convertendo combustível salvo (não consumido) em energia usando fuelEnergyDensityInMJoulesPerLiter. Deve 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 o modelo elétrico: 0,91

A data e a hora da partida do ponto de origem. Horários de partida separados de agora devem ser especificados como um dateTime. Quando um deslocamento de fuso horário não for especificado, ele será considerado o do ponto de origem. O valor departAt deve estar no futuro no formato de data e hora (1996-12-19T16:39:57-08:00).

Especifica a eficiência da conversão de energia potencial para combustível salvo (não consumido) quando o veículo perde elevação (ou seja, ChemicalEnergySaved/PotentialEnergyLost). ChemicalEnergySaved_ é obtido convertendo combustível salvo (não consumido) em energia usando fuelEnergyDensityInMJoulesPerLiter. Deve 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 o modelo elétrico: 0,73

Especifica a quantidade de energia química armazenada em um litro de combustível em megajoules (MJ). Ele é usado em conjunto com os Efficiency parâmetros para conversões entre energia e combustível salvos ou consumidos. Por exemplo, a densidade de energia é de 34,2 MJ/l para gasolina e 35,8 MJ/l para diesel. Esse parâmetro será necessário se qualquer Efficiency parâmetro for definido. Valores sensatos: 34.2

Grau de colina para rota emocionante. Esse parâmetro só pode ser usado em conjunto com routeType.Thrilling.

Se especificado, as instruções de diretriz serão retornadas. Observe que o parâmetro instructionsType não pode ser usado em conjunto com routeRepresentation=none.

Se o veículo é usado para fins comerciais. Veículos comerciais podem não ter permissão para dirigir em algumas estradas.

O parâmetro de idioma determina o idioma das mensagens de orientação. Substantivos adequados (os nomes de ruas, praças etc.) são retornados no idioma especificado ou, se isso não estiver disponível, eles serão retornados em um idioma disponível próximo a ele. Os valores permitidos são (um subconjunto de) as marcas de idioma IETF. Os idiomas com suporte no momento estão listados na seção Idiomas com suporte. Valor padrão: EnglishGreatBritain

Número de rotas alternativas desejadas a serem calculadas. Padrão: 0, mínimo: 0 e máximo: 5.

Especifica o fornecimento máximo de energia elétrica em kWh (quilowatts-hora) que podem ser armazenados na bateria do veículo. Esse parâmetro coexiste com currentChargeInkilowattHour o parâmetro . O valor mínimo deve ser maior ou igual a currentChargeInkilowattHour. Valores sensatos: 85

Todas as rotas alternativas retornadas seguirão a rota de referência (consulte a seção Solicitações POST) do ponto de origem da solicitação calculateRoute para pelo menos esse número de medidores. Só pode ser usado ao reconstruir uma rota. O parâmetro minDeviationDistance não pode ser usado em conjunto com arriveAt.

Todas as rotas alternativas retornadas seguirão a rota de referência (consulte a seção Solicitações POST) do ponto de origem da solicitação calculateRoute para pelo menos esse número de segundos. Só pode ser usado ao reconstruir uma rota. O parâmetro minDeviationTime não pode ser usado em conjunto com arriveAt. O valor padrão é 0. A configuração de )minDeviationTime_ para um valor maior que zero tem as seguintes consequências: o ponto de origem da solicitação calculateRoute deve estar na (ou muito próxima) da rota de referência de entrada. Se esse não for o caso, um erro será retornado. No entanto, o ponto de origem não precisa estar no início da rota de referência de entrada (ele pode ser considerado como a posição atual do veículo na rota de referência). A rota de referência, retornada como a primeira rota na resposta calculateRoute, começará no ponto de origem especificado na Solicitação calculateRoute. A parte inicial da rota de referência de entrada até que o ponto de origem seja excluído da Resposta. Os valores de minDeviationDistance e minDeviationTime determinam até que ponto as rotas alternativas serão garantidas para seguir a rota de referência do ponto de origem em diante. A rota deve usar departAt. O VehicleHeading é ignorado.

Usado para reconstruir uma rota e para calcular zero ou mais rotas alternativas para essa rota de referência. A sequência fornecida de coordenadas é usada como entrada para reconstrução de rota. As rotas alternativas são calculadas entre os pontos de origem e de destino especificados nos locais de parâmetro do caminho base. Se minDeviationDistance e minDeviationTime estiverem definidos como zero, esses pontos de origem e destino deverão estar em (ou muito próximos) no início e no final da rota de referência, respectivamente. Não há suporte para locais intermediários (pontos de passagem) ao usar supportingPoints. Definir pelo menos um de minDeviationDistance ou minDeviationTime como um valor maior que zero tem as seguintes consequências:

• O ponto de origem da solicitação calculateRoute deve estar na (ou muito próxima) da rota de referência de entrada. Se esse não for o caso, um erro será retornado. No entanto, o ponto de origem não precisa estar no início da rota de referência de entrada (ele pode ser considerado como a posição atual do veículo na rota de referência).
• A rota de referência, retornada como a primeira rota na resposta calculateRoute, começará no ponto de origem especificado na solicitação calculateRoute. A parte inicial da rota de referência de entrada até que o ponto de origem seja excluído da resposta.
• Os valores de minDeviationDistance e minDeviationTime determinam até que ponto as rotas alternativas serão garantidas para seguir a rota de referência do ponto de origem em diante.
• A rota deve usar departAt.
• O vehicleHeading é ignorado.

Especifica a representação do conjunto de rotas fornecido como resposta. Esse valor de parâmetro só pode ser usado em conjunto com computeBestOrder=true.

O tipo de rota solicitada.

Especifica qual dos tipos de seção é relatado na resposta da rota. <br><br>Por exemplo, se sectionType = pedestre, as seções que são adequadas apenas para pedestres são retornadas. Vários tipos podem ser usados. O sectionType padrão refere-se à entrada travelMode. Por padrão, travelMode é definido como carro.

Especifica quais dados devem ser relatados para fins de diagnóstico. Se for true, ele relatará os parâmetros efetivos ou os dados usados ao chamar a API. No caso de parâmetros padrão, o padrão será refletido em que o parâmetro não foi especificado pelo chamador.

O modo de viagem para a rota solicitada. Se não estiver definido, o padrão será car. Observe que o travelMode solicitado pode não estar disponível para toda a rota. Quando o travelMode solicitado não estiver disponível para uma seção específica, o elemento travelMode da resposta para essa seção será "outro". Observe que os modos de viagem de ônibus, motocicleta, táxi e van são funcionalidade BETA. Os dados de restrição completa não estão disponíveis em todas as áreas. Nas calculateReachableRange solicitações, os valores bicicleta e pedestre não devem ser usados.

Especifica se é necessário retornar tempos de viagem adicionais usando diferentes tipos de informações de tráfego (nenhum, histórico, ao vivo), bem como o tempo de viagem de melhor estimativa padrão.

Especifica a eficiência da conversão de energia química armazenada em combustível para energia potencial quando o veículo ganha elevação (ou seja, PotentialEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed_ é obtido pela conversão de combustível consumido em energia química usando fuelEnergyDensityInMJoulesPerLiter. Deve ser emparelhado com downhillEfficiency. O intervalo de valores permitidos é de 0,0 a 1/downhillEfficiency. Valores sensatos: para o modelo de combustão: 0,27, para o modelo elétrico: 0,74

Valores possíveis:

• true – Considere todas as informações de tráfego disponíveis durante o roteamento
• false – Ignorar dados de tráfego atuais durante o roteamento. Observe que, embora os dados de tráfego atuais sejam ignorados

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

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

O título direcional do veículo em graus começando no verdadeiro Norte e continuando na direção no sentido horário. Norte é 0 graus, leste é 90 graus, sul é 180 graus, oeste é 270 graus. Valores possíveis de 0 a 359.

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

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

Tipos de carga que podem ser classificados como materiais perigosos e restritos de algumas estradas. Os valores de vehicleLoadType disponíveis são as classes Hazmat dos EUA de 1 a 9, além de classificações genéricas para uso em outros países. Os valores que começam com USHazmat são para roteamento dos EUA, enquanto otherHazmat deve ser usado para todos os outros países. vehicleLoadType pode ser especificado várias vezes. Atualmente, esse parâmetro só é considerado para travelMode=truck.

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

• Um valor 0 significa que um valor apropriado para o veículo será determinado e aplicado durante o planejamento da rota.
• Um valor diferente de zero pode ser substituído durante o planejamento de rota. Por exemplo, o fluxo de tráfego atual é de 60 km/hora. Se a velocidade máxima do veículo for definida como 50 km/hora, o motor de roteamento considerará 60 km/hora, pois essa é 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 roteamento usará novamente 60 km/hora.

Peso do veículo em quilogramas.

• É obrigatório se qualquer um dos parâmetros *Efficiency estiver definido.
• Ele deve ser estritamente positivo quando usado no contexto do Modelo de Consumo. Restrições de peso são consideradas.
• Se nenhum detalhado Consumption Model for especificado e o valor de for diferente de vehicleWeight zero, as restrições de peso serão consideradas.
• Em todos os outros casos, esse parâmetro é ignorado.

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

Nível de voltas para uma rota emocionante. Esse parâmetro só pode ser usado em conjunto com routeType.Thrilling.