Obtenir un itinéraire économe en carburant

Par défaut, l'API Routes renvoie l'itinéraire par défaut, c'est-à-dire un itinéraire sans tenir compte de l'efficacité énergétique ni du carburant. Lorsque vous activez le routage écoresponsable, vous obtenez toujours la route par défaut dans la réponse. En outre, vous obtenez également un itinéraire économe en carburant ou en énergie selon le 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 de l'itinéraire. L'API utilise le type de moteur de votre véhicule ainsi que d'autres facteurs tels que 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 carburant ou en énergie, plus la consommation d'énergie et de carburant et les émissions de CO2 de votre voiture sont faibles.

Par exemple, l'avantage en termes de consommation de carburant d'un véhicule diesel est généralement plus élevé sur autoroute. Les véhicules hybrides et électriques ont tendance à être progressivement plus efficaces dans les environnements de conduite en ville "stop and go" et sur les pentes escarpé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'intégralité de l'itinéraire. Utilisez les estimations de consommation de carburant pour comparer différents itinéraires, et non pour obtenir des estimations explicites de consommation de carburant pour votre véhicule.

Comment Google Maps estime la consommation de carburant

L'API Routes estime les économies de carburant grâce aux insights du National Renewable Energy Laboratory du département de l'Énergie des États-Unis, ainsi qu'aux données de l'Agence européenne pour l'environnement. Ce calcul inclut des facteurs qui influent sur votre consommation de carburant et d'énergie, ainsi que sur vos émissions de CO2, par exemple:

  • 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 augmentent considérablement le temps de trajet, l'API affiche les économies de carburant ou d'énergie relatives entre les itinéraires pour vous aider à les comparer.

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

Prérequis

Pour utiliser les itinéraires économes 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 sur le réseau routier afin de trouver l'itinéraire optimal. Pour en savoir plus, consultez la section Configurer la qualité ou la latence.

  • Vous devez définir travelMode sur DRIVE. Les requêtes pour tout autre mode de transport renvoient une erreur.

  • Vous devez définir un emplacement pour le point de cheminement d'origine dans une région compatible. 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 les itinéraires économes en carburant et l'estimation de la consommation de carburant nécessitent que vous définissiez TRAFFIC_AWARE_OPTIMAL comme préférence d'itinéraire, les frais vous sont facturés en fonction du SKU: Routes Advanced.

En savoir plus sur la facturation pour l'API Routes

Demander un itinéraire économe en carburant

Pour envoyer une requête de 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 en utilisant les 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 spécifiant de renvoyer les propriétés de réponse associées à un itinéraire économe en carburant:

    • 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 un itinéraire personnalisé.

Exemple de demande écoresponsable

Le code suivant affiche une demande 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 à une route écoresponsable, 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 écoresponsable

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 la route 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 dans la requête sur true pour calculer les autres routes, la propriété du 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 circulation 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 étiquettes (DEFAULT_ROUTE et FUEL_EFFICIENT) :

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

Estimer la consommation de carburant de l'itinéraire

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

  • Définissez le champ du tableau extraComputations sur FUEL_CONSUMPTION pour activer le calcul de la consommation de carburant.

  • Spécifiez emissionType pour le véhicule en utilisant les 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 combustible en microlitres de combustible.

    Si emissionType est défini sur ELECTRIC, l'API convertit la consommation d'électricité en microlitres de combustible.

  • Définissez un masque de champ de réponse spécifiant 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 incluant é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 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 en permanence 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 économes en carburant:

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