Cette page a été traduite par l'API Cloud Translation.

Obtenir un itinéraire économe en carburant

Développeurs de l'Espace économique européen (EEE)

Par défaut, l'API Routes renvoie l'itinéraire par défaut, c'est-à-dire un itinéraire qui ne tient pas compte de l'efficacité énergétique ni de la consommation de carburant. Lorsque vous activez le routage respectueux de l'environnement, vous obtenez toujours l'itinéraire par défaut dans la réponse. De plus, vous obtenez un itinéraire écologique qui vous indique le trajet le plus économe en carburant ou en énergie en fonction du type de moteur de votre véhicule.

L'itinéraire écologique renvoyé par l'API Routes est optimisé pour réduire la consommation de carburant sur l'ensemble du trajet. L'API utilise le type de motorisation de votre véhicule ainsi que d'autres facteurs, comme le trafic et les conditions de circulation en temps réel, pour choisir l'itinéraire économe en carburant. Plus l'itinéraire est économe en énergie ou en carburant, plus la consommation d'énergie ou de carburant et les émissions de CO2 de votre voiture sont faibles.

Par exemple, l'avantage relatif en termes d'économie de carburant d'un véhicule diesel est généralement plus important sur l'autoroute. Les véhicules hybrides et électriques tendent à être progressivement plus économiques dans les environnements urbains avec des ralentissements ou sur des routes vallonnées, où ils peuvent largement utiliser le freinage régénératif et en bénéficier.

Vous pouvez également demander à l'API de renvoyer l'estimation de la consommation de carburant pour l'ensemble de l'itinéraire. Utilisez les estimations de consommation de carburant pour comparer différents itinéraires, et non comme des estimations explicites de la consommation de carburant pour votre véhicule exact.

Comment Google Maps estime la consommation de carburant

L'API Routes estime l'efficacité énergétique à l'aide des informations fournies par le National Renewable Energy Laboratory du département de l'Énergie des États-Unis et sur les données de l'Agence européenne pour l'environnement. Ce calcul tient compte de facteurs qui influent sur votre consommation de carburant et d'énergie ainsi que sur vos émissions de CO2, parmi lesquels :

la consommation moyenne de carburant ou d'énergie des véhicules de votre région ;
l'inclinaison des pentes sur votre trajet ;
les tendances de circulation en accordéon ;
le type de route (départementale ou autoroute, par exemple).

L'API Routes renvoie l'itinéraire le plus économe en carburant ou en énergie lorsque son heure d'arrivée est à peu près identique à celle de l'itinéraire par défaut. Si les économies de carburant ou d'énergie sont trop faibles ou que cela augmente considérablement le temps de trajet, l'API vous indique les économies de carburant ou d'énergie des différents itinéraires afin de vous aider à les comparer.

En savoir plus sur la technologie de calcul d'itinéraires économes en carburant (PDF)

Prérequis

Pour utiliser un itinéraire économe en carburant ou estimer la consommation de carburant :

Vous devez spécifier TRAFFIC_AWARE_OPTIMAL comme préférence de routage. Dans ce mode, le serveur effectue une recherche plus exhaustive du réseau routier pour trouver l'itinéraire optimal. Pour en savoir plus, consultez Configurer la qualité par rapport à la latence.
Vous devez définir travelMode sur DRIVE ou TWO_WHEELER. Les requêtes pour tout autre mode de transport renvoient une erreur. Le routage écologique pour TWO_WHEELER n'est disponible que dans certains pays.
Vous devez définir un emplacement pour le point de cheminement d'origine dans une région compatible. Sinon, l'API renvoie une erreur.
Pour TWO_WHEELER, vous devez définir un emplacement pour le point de cheminement d'origine dans une région acceptant les deux-roues. Sinon, l'API renvoie une erreur.
L'itinéraire ne peut pas contenir de point de cheminement intermédiaire.

Facturation

En règle générale, Google Maps Platform ne facture pas l'utilisation d'une fonctionnalité Preview. Toutefois, comme le routage économe en carburant et l'estimation de la consommation de carburant nécessitent que vous spécifiiez TRAFFIC_AWARE_OPTIMAL comme préférence de routage, vous êtes facturé en fonction du SKU : Compute Routes Pro.

En savoir plus sur la facturation de l'API Routes

Demander un itinéraire économe en carburant

Pour demander le calcul d'un itinéraire écologique, définissez les propriétés suivantes dans la requête :

Spécifiez emissionType pour le véhicule à l'aide des valeurs définies dans VehicleEmissionType : DIESEL, GASOLINE, ELECTRIC ou HYBRID. La valeur par défaut est GASOLINE.
Définissez requestedReferenceRoutes sur FUEL_EFFICIENT.
Définissez un masque de champ de réponse qui spécifie de renvoyer les propriétés de réponse associées à un itinéraire écologique :
- routes.routeLabels: : identifie chaque itinéraire comme DEFAULT_ROUTE, FUEL_EFFICIENT ou DEFAULT_ROUTE_ALTERNATE.
- routes.routeToken: : jeton de route que vous pouvez transmettre au SDK Navigation pour récupérer une route personnalisée.

Exemple de demande respectueuse de l'environnement

Le code suivant montre une demande d'itinéraire écologique. Dans cet exemple, vous utilisez le masque de champ de réponse pour renvoyer les propriétés de réponse associées à un itinéraire écologique, ainsi que les propriétés routes.distanceMeters et routes.duration :

curl -X POST -H 'content-type: application/json' -d '{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 41.76904801292959,
        "longitude": -72.67374935684933
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 41.823042361105024,
        "longitude": -71.40933143059424
      }
    }
  },
  "routeModifiers": {
    "vehicleInfo": {
      "emissionType": "GASOLINE"
    }
  },
  "travelMode":"DRIVE",
  "routingPreference": "TRAFFIC_AWARE_OPTIMAL",
  "requestedReferenceRoutes": ["FUEL_EFFICIENT"]
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Exemple de réponse respectueuse de l'environnement

L'appel computeRoutes ci-dessus génère une réponse JSON contenant deux itinéraires : l'itinéraire par défaut et l'itinéraire écoénergétique. Dans la réponse :

Pour l'itinéraire par défaut, la propriété de tableau routeLabels contient DEFAULT_ROUTE.
Pour l'itinéraire écologique, la propriété de tableau routeLabels contient FUEL_EFFICIENT.
Si vous définissez computeAlternativeRoutes sur true dans la requête pour calculer des itinéraires alternatifs, la propriété de tableau routeLabels contient DEFAULT_ROUTE_ALTERNATE.

{
    "routes": [
        {
            "distanceMeters": 138939,
            "duration": "5412s",
            "routeToken": "CoYJCpoIC…0n9S1cu",
            "routeLabels": [
                "DEFAULT_ROUTE"
            ]
        },
        {
            "distanceMeters": 116887,
            "duration": "5631s",
            "routeToken": "CuEHCu0G…xqm",
            "routeLabels": [
                "FUEL_EFFICIENT"
            ]
        }
    ]
}

En raison des conditions de conduite actuelles et d'autres facteurs, l'itinéraire par défaut et l'itinéraire économe en carburant peuvent être identiques. Dans ce cas, routeLabels contient les deux libellés : DEFAULT_ROUTE et FUEL_EFFICIENT :

{
  "routes": [
    {
      "distanceMeters": 45875,
      "duration": "2655s",
      "routeToken": "CvcDCos…6I40",
      "routeLabels": [
        "DEFAULT_ROUTE",
        "FUEL_EFFICIENT"
      ]
    }
  ]
}

Estimer la consommation de carburant pour l'itinéraire

Vous pouvez demander à la méthode de renvoyer l'estimation de la consommation de carburant pour l'ensemble de l'itinéraire, en microlitres. Pour ajouter l'estimation de la consommation de carburant d'un itinéraire à la réponse :

Définissez le champ de tableau extraComputations sur FUEL_CONSUMPTION pour activer le calcul de la consommation de carburant.
Spécifiez emissionType pour le véhicule à l'aide des valeurs définies dans VehicleEmissionType : DIESEL, GASOLINE, ELECTRIC ou HYBRID. La valeur par défaut est GASOLINE.

Si emissionType est défini sur HYBRID, l'API convertit la consommation d'électricité et de carburant en microlitres de carburant.

Si emissionType est défini sur ELECTRIC, l'API convertit la consommation d'électricité en microlitres de carburant.
Définissez un masque de champ de réponse qui spécifie de renvoyer les propriétés de réponse associées à la consommation de carburant : routes.travelAdvisory.fuelConsumptionMicroliters.

L'exemple suivant demande une estimation de la consommation de carburant dans une requête qui inclut également l'itinéraire écologique :

curl -X POST -H 'content-type: application/json' -d '{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 41.76904801292959,
        "longitude": -72.67374935684933
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 41.823042361105024,
        "longitude": -71.40933143059424
      }
    }
  },
  "routeModifiers": {
    "vehicleInfo": {
      "emissionType": "GASOLINE"
    }
  },
  "travelMode":"DRIVE",
  "routingPreference": "TRAFFIC_AWARE_OPTIMAL",
  "extraComputations": ["FUEL_CONSUMPTION"],
  "requestedReferenceRoutes": ["FUEL_EFFICIENT"]
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken,routes.travelAdvisory.fuelConsumptionMicroliters' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

La réponse contient une estimation de la consommation de carburant pour l'itinéraire par défaut et pour l'itinéraire économe en carburant :

{
    "routes": [
        {
            "distanceMeters": 138939,
            "duration": "5412s",
            "travelAdvisory": {
                "fuelConsumptionMicroliters": "11019554"
            },
            "routeToken": "CoYJCpoIC…0n9S1cu",
            "routeLabels": [
                "DEFAULT_ROUTE"
            ]
        },
        {
            "distanceMeters": 116887,
            "duration": "5631s",
            "travelAdvisory": {
                "fuelConsumptionMicroliters": "9572436"
            },
            "routeToken": "CuEHCu0G…xqm",
            "routeLabels": [
                "FUEL_EFFICIENT"
            ]
        }
    ]
}

Régions où le service est disponible

L'équipe Google Maps Platform s'efforce sans cesse d'améliorer la couverture internationale de nos services d'API. La liste suivante présente les dernières informations sur la couverture du calcul d'itinéraire écologique, pays par pays :

Albanie (AL)
Australie (AU)
Autriche (AT)
Belgique (BE)
Bosnie-Herzégovine (BA)
Bulgarie (BG)
Canada (CA)
Croatie (HR)
Chypre (CY)
Tchéquie (CZ)
Danemark (DK)
Égypte (EG)
Estonie (EE)
Finlande (FI)
France (FR)
Allemagne (DE)
Grèce (GR)
Hongrie (HU)
Islande (IS)
Inde (IN)
Indonésie (ID)
Irlande (IE)
Italie (IT)
Kosovo (XK)
Lettonie (LV)
Liechtenstein (LI)
Lituanie (LT)
Luxembourg (LU)
Malte (MT)
Mexique (MX)
Monténégro (ME)
Pays-Bas (NL)
Macédoine du Nord (MK)
Norvège (NO)
Pologne (PL)
Portugal (PT)
Roumanie (RO)
Arabie saoudite (SA)
Serbie (RS)
Slovaquie (SK)
Slovénie (SI)
Espagne (ES)
Suède (SE)
Suisse (CH)
Turquie (TR)
Émirats arabes unis (AE)
Royaume-Uni (GB)
États-Unis (US)

Régions où les deux-roues sont acceptés

La liste suivante présente les dernières informations sur la couverture, pays par pays, pour le routage écologique des deux-roues :

Inde (IN)
Indonésie (ID)