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 ou de la consommation de carburant. Lorsque vous activez les itinéraires économes en carburant, vous obtenez toujours l'itinéraire par défaut dans la réponse. De plus, vous obtenez un itinéraire éco-responsable qui indique l'itinéraire le plus économe en carburant ou en énergie en fonction du type de moteur de votre véhicule.

L'itinéraire économe en carburant 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'économie en carburant relative des véhicules diesel est généralement plus importante 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 la consommation de carburant estimée 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 de votre véhicule.

Comment Google Maps estime la consommation de carburant

L'API Routes estime la consommation de carburant à l'aide des informations fournies par le National Renewable Energy Laboratory du département de l'Énergie des États-Unis et des 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. Les itinéraires économes en carburant pour les TWO_WHEELER ne sont disponibles que dans quelques pays.

  • Vous devez définir un emplacement pour le point de repère 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 repère d'origine dans une région où les deux-roues sont pris en charge. 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é en preview. Toutefois, comme l'itinéraire économe en carburant et l'estimation de la consommation de carburant nécessitent de spécifier 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 écoresponsable

Pour demander le calcul d'un itinéraire économe en carburant, 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 économe en carburant :

    • routes.routeLabels: : identifie chaque route comme DEFAULT_ROUTE, FUEL_EFFICIENT ou DEFAULT_ROUTE_ALTERNATE.

    • routes.routeToken: Jeton d'itinéraire que vous pouvez transmettre au SDK Navigation pour récupérer un itinéraire personnalisé.

Exemple de requête écoresponsable

Le code suivant montre une requête d'itinéraire économe en carburant. 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 économe en carburant, 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 éco-responsable

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 économe en carburant. Dans la réponse :

  • Pour l'itinéraire par défaut, la propriété de tableau routeLabels contient DEFAULT_ROUTE.

  • Pour l'itinéraire économe en carburant, 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 bis, 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"
            ]
        }
    ]
}

Selon les conditions de conduite en cours 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 étiquettes : 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 la consommation de carburant estimée pour l'ensemble de l'itinéraire, en microlitres. Pour ajouter la consommation de carburant estimée 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 la valeur de emissionType est HYBRID, l'API convertit la consommation d'électricité et de carburant en microlitres de carburant.

    Si la valeur de emissionType est 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 le cadre d'une requête qui inclut également l'itinéraire économe en carburant :

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 la consommation de carburant estimée 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, pays par pays, pour les itinéraires écoresponsables :

  • 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 prises en charge pour les deux-roues

La liste suivante présente les dernières informations sur la couverture, pays par pays, pour les itinéraires écoresponsables pour les deux-roues :

  • Inde (IN)
  • Indonésie (ID)