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 du carburant ni de l'efficacité énergétique. Lorsque vous activez le routage écologique, vous obtenez toujours l'itinéraire par défaut dans la réponse. De plus, vous obtenez un itinéraire écologique 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 é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 moteur de votre véhicule, ainsi que d'autres facteurs tels que le trafic en temps réel et les conditions de circulation, pour choisir l'itinéraire écologique. 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 d'un véhicule 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 du trajet. 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'économie de carburant à l'aide d'informations issues du 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 la section Configurer la qualité par rapport à 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é Preview. Toutefois, comme le calcul de 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 calcul d'itinéraire, vous êtes facturé 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 é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 en tant que 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 écologique

Le code suivant montre une requête de trajet é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 écologique

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 le routage 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 dans la requête sur true 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 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 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 la consommation de carburant estimée pour l'ensemble du trajet, 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 emissionType est HYBRID, l'API convertit la consommation d'électricité et de carburant en microlitres de carburant.

    Si 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 la consommation de carburant estimée dans le cadre d'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 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 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)
  • 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)