Cette page a été traduite par l'API Cloud Translation.

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.

L'itinéraire écologique renvoyé par l'API Routes est optimisé pour réduire la consommation de carburant sur l'ensemble de la route. L'API utilise le type de moteur de votre véhicule ainsi que d'autres facteurs, tels que l'état du trafic et les conditions de circulation en temps réel, pour choisir l'itinéraire écologique. 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.

Vous pouvez également demander à l'API de renvoyer la consommation de carburant estimée pour l'intégralité de la route. Utilisez les estimations de consommation de carburant pour comparer différents itinéraires, et non comme des estimations explicites de consommation 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)

Prérequis

Pour utiliser des 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 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 portant sur un 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.

Facturation

En règle générale, Google Maps Platform ne facture pas l'utilisation de la fonctionnalité Preview. Toutefois, étant donné que le routage écologique et l'estimation de la consommation de carburant nécessite que vous spécifiiez TRAFFIC_AWARE_OPTIMAL comme préférence de routage, le service vous sera facturé en fonction du code SKU: Routes Advanced.

En savoir plus sur la facturation de l'API Routes

Demander un itinéraire écoresponsable

Pour demander le calcul d'une route é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 à une route écoresponsable:
- 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 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.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 conduite actuelles et d'autres facteurs, l'itinéraire par défaut et l'itinéraire écologique 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 de carburant estimée pour l'intégralité de la route, en microlitres. Pour ajouter à la réponse la consommation de carburant estimée 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 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.
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 la route écoresponsable:

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 une estimation de la consommation de carburant de l'itinéraire par défaut et de l'itinéraire écologique:

{
    "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 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)