Configurer des itinéraires écologiques

Par défaut, l'API Routes renvoie l'itinéraire par défaut, c'est-à-dire un itinéraire sans tenir compte de l'économie d'énergie ou de carburant. Lorsque vous activez le routage économe en carburant, la route par défaut s'affiche toujours dans la réponse. En outre, vous obtenez un itinéraire économe en carburant qui présente l'itinéraire le plus économe en énergie ou en carburant en fonction du type de moteur de votre véhicule.

L'itinéraire économe en carburant renvoyé par l'API Routes est optimisé pour la consommation de carburant sur l'intégralité de l'itinéraire. 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 l'état de la route, 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 du carburant diesel relatif en carburant est généralement le plus grand en voiture. Les véhicules hybrides et électriques tendent à être progressivement plus économiques dans les environnements urbains avec des ralentissements et sur des routes vallonnées, où ils peuvent largement utiliser les freins régénératifs.

Vous pouvez également demander à l'API de renvoyer la consommation de carburant estimée pour l'itinéraire entier. Les estimations de consommation de carburant vous permettent de comparer différents itinéraires, et non des estimations explicites d'utilisation de carburant pour votre véhicule exact.

Comment Google Maps estime la consommation de carburant

Pour estimer les économies de carburant, l'API Routes s'appuie sur les 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, 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 énergie ou en carburant 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 le temps de trajet augmente considérablement, l'API indique les économies de carburant ou d'énergie correspondantes entre les 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 sur le réseau routier afin de trouver l'itinéraire optimal. Pour en savoir plus, consultez la section Configurer la qualité et 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 version preview. Toutefois, comme l'itinéraire économe en carburant et l'estimation de la consommation de carburant nécessite de spécifier TRAFFIC_AWARE_OPTIMAL comme préférence de routage, les frais vous sont facturés en fonction du SKU: Routes Advanced.

En savoir plus sur la facturation de l'API Routes

Demander un itinéraire économe en carburant

Pour effectuer une requête de calcul d'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 l'affichage des propriétés de réponse associées à un itinéraire économe en carburant:

    • routes.routeLabels: Identifie chaque itinéraire en tant que 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 écoresponsable

Le code suivant montre 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 à un itinéraire écoresponsable, avec 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: 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 de routes de calcul ci-dessus génère une réponse JSON contenant deux routes : la route par défaut et la route économe en carburant. Dans la réponse:

  • Pour la route par défaut, la propriété de tableau routeLabels contient DEFAULT_ROUTE.

  • Pour la route écologique, la propriété de tableau routeLabels contient FUEL_EFFICIENT.

  • Si vous définissez computeAlternativeRoutes dans la requête sur true pour calculer d'autres itinéraires, 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 é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 votre itinéraire

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

  • 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.

    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 les propriétés de réponse associées à la consommation de carburant : routes.travelAdvisory.fuelConsumptionMicroliters.

L'exemple suivant demande une consommation de carburant estimée 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: 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 constamment d'améliorer la couverture internationale de nos services d'API. La liste suivante présente les dernières informations de 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)