L'API Routes est actuellement en version bêta (avant la mise à disposition générale). Il est possible que les produits et fonctionnalités pré-DG présentent une compatibilité limitée, et que les modifications apportées aux produits et fonctionnalités pré-DG ne soient pas compatibles avec d'autres versions pré-DG. Les Offres de pré-DG sont couvertes par les Conditions spécifiques au service Google Maps Platform. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Configurer des itinéraires écologiques

Par défaut, l'API Routes affiche l'itinéraire par défaut, c'est-à-dire un itinéraire qui ne tient pas 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 un itinéraire économe en carburant qui présente l'itinéraire le plus économe en énergie ou en carburant selon le type de moteur de votre véhicule.

Pour choisir l'itinéraire écologique, l'API Routes utilise le type de moteur de votre véhicule ainsi que d'autres facteurs, tels que l'état du trafic en temps réel et les conditions de circulation. Plus l'itinéraire est économe en énergie ou en carburant, plus la consommation de carburant/d'énergie de votre voiture et les émissions de CO2 sont faibles.

Par exemple, l'avantage énergétique relatif d'un véhicule diesel est généralement plus important lorsque vous conduisez. Les véhicules hybrides et électriques tendent à fournir progressivement une plus grande efficacité dans les environnements de conduite en ville en montée et en conduite vallonnée, où ils peuvent largement utiliser les freins régénératifs et en tirer profit.

L'itinéraire écologique renvoyé par l'API est optimisé pour réduire la consommation de carburant sur l'ensemble de la route. Utilisez les estimations de consommation de carburant de l'itinéraire pour comparer différents itinéraires, et non comme des estimations explicites de consommation de carburant pour votre véhicule.

Comment Google Maps estime votre consommation de carburant

Pour estimer la consommation 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 inclut des facteurs qui influent sur votre consommation de carburant et d'énergie ainsi que 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 conduite, 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)

Conditions préalables

Pour utiliser un routage économe en énergie, envoyez une requête de calcul d'itinéraire:

  • 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 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 d'itinéraires écoresponsables pour tout autre mode de transport renvoient une erreur.

  • Vous devez définir un emplacement pour le point de cheminement de départ dans une région compatible. Sinon, l'API renvoie une erreur.

  • L'itinéraire ne peut pas contenir de point de cheminement intermédiaire.

Demander un itinéraire écoresponsable

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

  • Définissez requestedReferenceRoutes sur FUEL_EFFICIENT.

  • 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 également un masque de champ de réponse qui spécifie de renvoyer les propriétés de réponse associées à une route écoresponsable:

  • routes.routeLabels: identifie chaque itinéraire:

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

    • Pour toutes les autres routes, la propriété de tableau routeLabels contient DEFAULT_ROUTE_ALTERNATE.

  • routes.travelAdvisory.fuelConsumptionMicroliters : consommation de carburant estimée pour l'intégralité de la route, en microlitres.

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

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

  • routes.routeToken: Jeton de routage que vous pouvez transmettre au SDK de navigation pour récupérer une route personnalisée.

Exemple de demande écoresponsable

Le code suivant montre une requête d'itinéraire écoresponsable. 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 é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: API_KEY' 
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.travelAdvisory.fuelConsumptionMicroliters,routes.routeToken' 
'https://routes.googleapis.com/directions/v2:computeRoutes'

Exemple de réponse écologique

L'appel de route de calcul ci-dessus génère une réponse JSON contenant deux routes:

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

Dans le cas où la route par défaut et la route écologique sont les mêmes, la propriété routeLabels contient à la fois DEFAULT_ROUTE et FUEL_EFFICIENT:.

{
  "routes": [
    {
      "distanceMeters": 45875,
      "duration": "2655s",
      "travelAdvisory": {
        "fuelConsumptionMicroliters": "1926791"
      },
      "routeToken": "CvcDCos…6I40",
      "routeLabels": [
        "DEFAULT_ROUTE",
        "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 détails de couverture les plus récents, pays par pays, pour un routage écologique:

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