RouteDirectionOptions Classe

Constructeur de RouteDirectionOptions.

Spécifie l’efficacité de la conversion de l’énergie chimique stockée dans le carburant en énergie cinétique lorsque le véhicule accélère (c’est-à-dire, KineticEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed_ est obtenu en convertissant le carburant consommé en énergie chimique à l’aide fuelEnergyDensityInMJoulesPerLiterde . Doit être associé à decelerationEfficiency. La plage de valeurs autorisées est comprise entre 0,0 et 1/decelerationEfficiency. Valeurs sensibles : pour le modèle de combustion : 0,33, pour le modèle électrique : 0,66

Contrôle l’optimalité, par rapport aux critères de planification donnés, des alternatives calculées par rapport à l’itinéraire de référence.

Date et heure d’arrivée au point de destination. Il doit être spécifié en tant que dateTime. Lorsqu’un décalage de fuseau horaire n’est pas spécifié, il est supposé être celui du point de destination. La valeur arriveAt doit être à l’avenir. Le paramètre arriveAt ne peut pas être utilisé conjointement avec departAt, minDeviationDistance ou minDeviationTime.

Spécifie la quantité d’énergie consommée pour le maintien en puissance des systèmes auxiliaires, en kilowatts (kW). Il peut être utilisé pour spécifier la consommation due à des appareils et des systèmes tels que les systèmes de climatisation, la radio, le chauffage, etc. Valeurs sensibles : 1.7

Spécifie la quantité de carburant consommée pour le maintien des systèmes auxiliaires du véhicule, en litres par heure. Il peut être utilisé pour spécifier la consommation due à des appareils et des systèmes tels que les systèmes de climatisation, la radio, le chauffage, etc. Valeurs sensibles : 0,2

Spécifie un élément que le calcul de la route doit essayer d’éviter lors de la détermination de l’itinéraire. Peut être spécifié plusieurs fois dans une seule requête. Dans les requêtes calculateReachableRange, la valeur alreadyUsedRoads ne doit pas être utilisée.

Récommandez les points de routage à l’aide d’un algorithme heuristique rapide pour réduire la longueur de l’itinéraire. Obtient de meilleurs résultats lorsqu’il est utilisé conjointement avec routeType le plus court. Notez que l’origine et la destination sont exclues des index de waypoint optimisés. Pour inclure l’origine et la destination dans la réponse, augmentez tous les index de 1 pour tenir compte de l’origine, puis ajoutez la destination comme index final. Les valeurs possibles sont true ou false. True calcule un meilleur ordre si possible, mais n’est pas autorisé à être utilisé conjointement avec la valeur maxAlternatives supérieure à 0 ou conjointement avec des points de waypoint en cercle. False utilise les emplacements dans l’ordre donné et n’est pas autorisé à être utilisé conjointement avec routeRepresentation none.

Spécifie le composant dépendant de la vitesse de consommation. Fourni sous la forme d’une liste non triée de paires vitesse/débit de consommation. La liste définit des points sur une courbe de consommation. Les taux de consommation pour les vitesses qui ne figurent pas dans la liste sont les suivants :

• par interpolation linéaire, si la vitesse donnée se situe entre deux vitesses dans la liste
• par extrapolation linéaire sinon, en supposant une constante (ΔConsumption/ΔSpeed) déterminée par les deux points les plus proches de la liste

Spécifie le composant dépendant de la vitesse de consommation. Fourni sous la forme d’une liste non triée de paires de débit de consommation de vitesse & délimitées par deux-points. La liste définit des points sur une courbe de consommation. Les taux de consommation pour les vitesses qui ne figurent pas dans la liste sont les suivants :

• par interpolation linéaire, si la vitesse donnée se situe entre deux vitesses dans la liste
• par extrapolation linéaire sinon, en supposant une constante (ΔConsumption/ΔSpeed) déterminée par les deux points les plus proches de la liste

Spécifie l’alimentation électrique actuelle en kilowattheures (kWh). Ce paramètre coexiste avec MaxChargeInKilowattHour le paramètre. La plage de valeurs autorisées est comprise entre 0,0 et MaxChargeInKilowattHour. Valeurs sensibles : 43

Spécifie l’approvisionnement actuel en carburant en litres. Valeurs sensibles : 55

Spécifie l’efficacité de la conversion de l’énergie cinétique en carburant économisé (non consommé) lorsque le véhicule ralentit (c’est-à-dire, ChemicalEnergySaved/KineticEnergyLost). ChemicalEnergySaved_ est obtenu en convertissant le carburant économisé (non consommé) en énergie à l’aide fuelEnergyDensityInMJoulesPerLiterde . Doit être associé à accelerationEfficiency. La plage de valeurs autorisées est comprise entre 0,0 et 1/accelerationEfficiency. Valeurs sensibles : pour le modèle de combustion : 0,83, pour le modèle électrique : 0,91

Date et heure de départ du point d’origine. Les heures de départ à l’exception de maintenant doivent être spécifiées en tant que dateTime. Lorsqu’un décalage de fuseau horaire n’est pas spécifié, il est supposé être celui du point d’origine. La valeur departAt doit être ultérieurement au format date-heure (1996-12-19T16:39:57-08:00).

Spécifie l’efficacité de la conversion de l’énergie potentielle en carburant économisé (non consommé) lorsque le véhicule perd de l’élévation (c’est-à-dire, ChemicalEnergySaved/PotentialEnergyLost). ChemicalEnergySaved_ est obtenu en convertissant le carburant économisé (non consommé) en énergie à l’aide fuelEnergyDensityInMJoulesPerLiterde . Doit être associé à uphillEfficiency. La plage de valeurs autorisées est comprise entre 0,0 et 1/uphillEfficiency. Valeurs sensibles : pour le modèle de combustion : 0,51, pour le modèle électrique : 0,73

Spécifie la quantité d’énergie chimique stockée dans un litre de carburant en mégajoules (MJ). Il est utilisé conjointement avec les paramètres pour les conversions entre l’énergie Efficiency économisée ou consommée et le carburant. Par exemple, la densité énergétique est de 34,2 MJ/l pour l’essence et de 35,8 MJ/l pour le diesel. Ce paramètre est obligatoire si un Efficiency paramètre est défini. Valeurs sensibles : 34.2

Degré de colline pour un itinéraire palpitant. Ce paramètre peut uniquement être utilisé conjointement avec routeType.Thrilling.

Si elles sont spécifiées, des instructions d’aide seront retournées. Notez que le paramètre instructionsType ne peut pas être utilisé conjointement avec routeRepresentation=none.

Indique si le véhicule est utilisé à des fins commerciales. Les véhicules commerciaux peuvent ne pas être autorisés à circuler sur certaines routes.

Le paramètre language détermine la langue des messages d’aide. Les noms appropriés (noms de rues, de places, etc.) sont retournés dans la langue spécifiée ou, si ce n’est pas disponible, ils sont retournés dans une langue disponible proche de celle-ci. Les valeurs autorisées sont (un sous-ensemble de) les balises de langue IETF. Les langues actuellement prises en charge sont répertoriées dans la section Langues prises en charge. Valeur par défaut : EnglishGreatBritain

Nombre d’itinéraires alternatifs souhaités à calculer. Valeur par défaut : 0, minimum : 0 et maximum : 5.

Spécifie la quantité maximale d’énergie électrique en kWh qui peut être stockée dans la batterie du véhicule. Ce paramètre coexiste avec currentChargeInkilowattHour le paramètre. La valeur minimale doit être supérieure ou égale à currentChargeInkilowattHour. Valeurs sensibles : 85

Toutes les autres routes retournées suivent l’itinéraire de référence (voir la section Requêtes POST) à partir du point d’origine de la demande calculateRoute pour au moins ce nombre de mètres. Ne peut être utilisé que lors de la reconstruction d’un itinéraire. Le paramètre minDeviationDistance ne peut pas être utilisé conjointement avec arriveAt.

Tous les itinéraires alternatifs retournés suivent l’itinéraire de référence (voir la section Requêtes POST) à partir du point d’origine de la demande calculateRoute pendant au moins ce nombre de secondes. Ne peut être utilisé que lors de la reconstruction d’un itinéraire. Le paramètre minDeviationTime ne peut pas être utilisé conjointement avec arriveAt. La valeur par défaut est 0. La définition de )minDeviationTime_ sur une valeur supérieure à zéro a les conséquences suivantes : le point d’origine de la requête calculateRoute doit se trouver sur (ou très près) de l’itinéraire de référence d’entrée. Si ce n’est pas le cas, une erreur est retournée. Toutefois, le point d’origine n’a pas besoin d’être au début de l’itinéraire de référence d’entrée (il peut être considéré comme la position actuelle du véhicule sur l’itinéraire de référence). L’itinéraire de référence, retourné en tant que premier itinéraire dans la réponse calculateRoute, démarre au point d’origine spécifié dans la requête calculateRoute. La partie initiale de l’itinéraire de référence d’entrée jusqu’à ce que le point d’origine soit exclu de la réponse. Les valeurs de minDeviationDistance et minDeviationTime déterminent la distance dans laquelle d’autres itinéraires seront garantis pour suivre l’itinéraire de référence à partir du point d’origine. L’itinéraire doit utiliser departAt. est VehicleHeading ignoré.

Utilisé pour reconstruire un itinéraire et pour calculer zéro ou plusieurs itinéraires alternatifs à cet itinéraire de référence. La séquence de coordonnées fournie est utilisée comme entrée pour la reconstruction de l’itinéraire. Les itinéraires alternatifs sont calculés entre les points d’origine et de destination spécifiés dans les emplacements des paramètres de chemin d’accès de base. Si minDeviationDistance et minDeviationTime sont tous deux définis sur zéro, ces points d’origine et de destination sont censés se trouver au début (ou très proche) de la route de référence, respectivement. Les emplacements intermédiaires (waypoints) ne sont pas pris en charge lors de l’utilisation de supportsPoints. La définition d’au moins une des valeurs minDeviationDistance ou minDeviationTime sur une valeur supérieure à zéro a les conséquences suivantes :

• Le point d’origine de la requête calculateRoute doit se trouver sur (ou très près) de l’itinéraire de référence d’entrée. Si ce n’est pas le cas, une erreur est retournée. Toutefois, le point d’origine n’a pas besoin d’être au début de l’itinéraire de référence d’entrée (il peut être considéré comme la position actuelle du véhicule sur l’itinéraire de référence).
• L’itinéraire de référence, retourné en tant que premier itinéraire dans la réponse calculateRoute, démarre au point d’origine spécifié dans la requête calculateRoute. La partie initiale de l’itinéraire de référence d’entrée jusqu’à ce que le point d’origine soit exclu de la réponse.
• Les valeurs de minDeviationDistance et minDeviationTime déterminent dans quelle mesure d’autres itinéraires seront garantis pour suivre l’itinéraire de référence à partir du point d’origine.
• L’itinéraire doit utiliser departAt.
• La propriété vehicleHeading est ignorée.

Spécifie la représentation de l’ensemble d’itinéraires fourni en tant que réponse. Cette valeur de paramètre ne peut être utilisée qu’avec computeBestOrder=true.

Type d’itinéraire demandé.

Spécifie les types de section signalés dans la réponse d’itinéraire. <br><br>Par exemple, si sectionType = piéton, les sections qui conviennent uniquement aux piétons sont retournées. Plusieurs types peuvent être utilisés. Le sectionType par défaut fait référence à l’entrée travelMode. Par défaut, travelMode est défini sur car.

Spécifie les données à signaler à des fins de diagnostic. Si la valeur est true, elle signale les paramètres effectifs ou les données utilisées lors de l’appel de l’API. Dans le cas des paramètres par défaut, la valeur par défaut est reflétée lorsque le paramètre n’a pas été spécifié par l’appelant.

Mode de déplacement pour l’itinéraire demandé. Si elle n’est pas définie, la valeur par défaut est car. Notez que le travelMode demandé peut ne pas être disponible pour l’ensemble de l’itinéraire. Si le travelMode demandé n’est pas disponible pour une section particulière, l’élément travelMode de la réponse pour cette section sera « other ». Notez que les modes de voyage bus, moto, taxi et fourgonnette sont des fonctionnalités BÊTA. Les données de restriction complètes ne sont pas disponibles dans toutes les zones. Dans calculateReachableRange les requêtes, les valeurs vélo et piéton ne doivent pas être utilisées.

Spécifie s’il faut retourner des temps de trajet supplémentaires à l’aide de différents types d’informations sur la circulation (aucun, historique, temps réel) ainsi que de la meilleure estimation par défaut du temps de trajet.

Spécifie l’efficacité de la conversion de l’énergie chimique stockée dans le carburant en énergie potentielle lorsque le véhicule gagne en altitude (c.-à-d. PotentialEnergy Gagné/ChemicalEnergyConsumed). ChemicalEnergyConsumed_ est obtenu en convertissant le carburant consommé en énergie chimique à l’aide fuelEnergyDensityInMJoulesPerLiterde . Doit être associé à downhillEfficiency. La plage de valeurs autorisées est comprise entre 0,0 et 1/downhillEfficiency. Valeurs sensibles : pour le modèle de combustion : 0,27, pour le modèle électrique : 0,74

Valeurs possibles :

• true - Prendre en compte toutes les informations de trafic disponibles pendant le routage
• false - Ignorer les données de trafic actuelles pendant le routage. Notez que bien que les données de trafic actuelles soient ignorées

Poids par essieu du véhicule en kilogramme. La valeur 0 signifie que les restrictions de poids par axe ne sont pas prises en compte.

Type de moteur du véhicule. Lorsqu’un modèle de consommation détaillé est spécifié, il doit être cohérent avec la valeur de vehicleEngineType.

Direction du véhicule en degrés commençant au vrai nord et continuant dans le sens des aiguilles d’une montre. Le nord est de 0 degré, l’est à 90 degrés, le sud à 180 degrés, l’ouest à 270 degrés. Valeurs possibles 0-359.

Hauteur du véhicule en mètres. La valeur 0 signifie que les restrictions de hauteur ne sont pas prises en compte.

Longueur du véhicule en mètres. La valeur 0 signifie que les restrictions de longueur ne sont pas prises en compte.

Types de cargaisons qui peuvent être classées comme des matières dangereuses et interdites à partir de certaines routes. Les valeurs vehicleLoadType disponibles sont les classes US Hazmat 1 à 9, ainsi que les classifications génériques à utiliser dans d’autres pays. Les valeurs commençant par USHazmat sont destinées au routage des États-Unis, tandis que otherHazmat doit être utilisé pour tous les autres pays. vehicleLoadType peut être spécifié plusieurs fois. Ce paramètre est actuellement pris en compte uniquement pour travelMode=truck.

Vitesse maximale du véhicule en km/heure. La vitesse maximale dans le profil du véhicule est utilisée pour case activée si un véhicule est autorisé sur les autoroutes.

• La valeur 0 signifie qu’une valeur appropriée pour le véhicule sera déterminée et appliquée lors de la planification de l’itinéraire.
• Une valeur autre que zéro peut être remplacée pendant la planification de l’itinéraire. Par exemple, le trafic actuel est de 60 km/heure. Si la vitesse maximale du véhicule est définie sur 50 km/heure, le moteur de routage prend en compte 60 km/heure, car c’est la situation actuelle. Si la vitesse maximale du véhicule est de 80 km/heure, mais que le trafic actuel est de 60 km/heure, le moteur de routage utilisera à nouveau 60 km/heure.

Poids du véhicule en kilogrammes.

• Il est obligatoire si l’un des paramètres *Efficacité est défini.
• Il doit être strictement positif lorsqu’il est utilisé dans le contexte du modèle de consommation. Les restrictions de poids sont prises en compte.
• Si aucun détail Consumption Model n’est spécifié et que la valeur de est différente de vehicleWeight zéro, les restrictions de poids sont prises en compte.
• Dans tous les autres cas, ce paramètre est ignoré.

Largeur du véhicule en mètres. La valeur 0 signifie que les restrictions de largeur ne sont pas prises en compte.

Niveau de virages pour un itinéraire palpitant. Ce paramètre ne peut être utilisé qu’avec routeType.Thrilling.