Per impostazione predefinita, l'API Routes restituisce la route default, ovvero una route che non tiene conto del consumo di carburante o dell'efficienza energetica. Quando attivi il routing ecosostenibile, ricevi comunque la route predefinita nella risposta. Inoltre, viene visualizzato un percorso ecosostenibile che mostra il percorso a più basso consumo di carburante o energia in base al tipo di motore del veicolo.
Il percorso ecosostenibile restituito dall'API Routes è ottimizzato per ridurre il consumo di carburante lungo l'intero percorso. L'API utilizza il tipo di motore del veicolo insieme ad altri fattori, come il traffico in tempo reale e le condizioni stradali, per scegliere il percorso ecosostenibile. Maggiore è il consumo di carburante o dell'efficienza energetica del percorso, minori saranno il consumo di carburante/energia e le emissioni di CO2 dell'auto.
Ad esempio, il vantaggio relativo al risparmio di carburante di un veicolo diesel è generalmente maggiore nella guida in autostrada. I veicoli ibridi ed elettrici tendono a fornire un'efficienza progressivamente maggiore nella guida in città e in pendenza, dove possono utilizzare ampiamente e trarre vantaggio dalla frenatura rigenerativa.
Puoi anche richiedere che l'API restituisca il consumo stimato di carburante per l'intero percorso. Utilizza le stime del consumo di carburante per confrontare percorsi diversi, non come stime esplicite del consumo di carburante per il tuo veicolo esatto.
In che modo Google Maps stima il consumo di carburante
L'API Routes stima il consumo di carburante utilizzando approfondimenti del National Renewable Energy Laboratory del Dipartimento dell'energia degli Stati Uniti e dati dell'Agenzia europea dell'ambiente. Questo calcolo include fattori che influiscono sul consumo di carburante ed energia e sulle emissioni di CO2, ad esempio:
- Consumo medio di carburante o di energia dei veicoli nella tua regione
- Ripidità del percorso
- Pattern del traffico a singhiozzo
- Tipi di strade (strade locali o autostrade)
L'API Routes restituisce il percorso a più basso consumo di carburante o energia quando ha all'incirca la stessa ora di arrivo del percorso predefinito. Nei casi in cui il risparmio di carburante o di energia sia troppo ridotto o aumenti in modo significativo il tempo di guida, l'API mostra il risparmio di carburante o energia relativo tra i percorsi per aiutarti a effettuare un confronto.
Scopri di più sulla tecnologia del percorso ecosostenibile (PDF).
Prerequisiti
Per utilizzare il percorso ecosostenibile o stimare il consumo di carburante:
Devi specificare
TRAFFIC_AWARE_OPTIMAL
come preferenza di routing. In questa modalità, il server esegue una ricerca più completa della rete stradale per trovare il percorso ottimale. Per ulteriori informazioni, consulta Configurare la qualità e la latenza.Devi impostare
travelMode
suDRIVE
. Le richieste per qualsiasi altra modalità di viaggio restituiscono un errore.Devi impostare una località per il waypoint di origine in una regione supportata. In caso contrario, l'API restituisce un errore.
Il percorso non può contenere una tappa intermedia.
Fatturazione
In genere, Google Maps Platform non addebita alcun costo per l'utilizzo di una funzionalità
in anteprima. Tuttavia, poiché il percorso ecosostenibile e la stima del consumo di carburante
richiede di specificare TRAFFIC_AWARE_OPTIMAL
come preferenza di routing, l'addebito avviene in base allo SKU: Routes Advanced.
Scopri di più sulla fatturazione per l'API Routes.
Richiedi un percorso ecosostenibile
Per effettuare una richiesta per calcolare una route ecosostenibile, imposta le seguenti proprietà nella richiesta:
Specifica
emissionType
per il veicolo utilizzando i valori definiti in VehicleEmissionType:DIESEL
,GASOLINE
,ELECTRIC
oHYBRID
. Il valore predefinito èGASOLINE
.Imposta
requestedReferenceRoutes
suFUEL_EFFICIENT
.Imposta una maschera del campo di risposta che specifichi di restituire le proprietà di risposta associate a una route ecosostenibile:
routes.routeLabels:
Identifica ogni percorso comeDEFAULT_ROUTE
,FUEL_EFFICIENT
oDEFAULT_ROUTE_ALTERNATE
.routes.routeToken:
Un token di route che puoi passare all'SDK di navigazione per recuperare una route personalizzata.
Esempio di richiesta rispettoso dell'ambiente
Il seguente codice mostra una richiesta di un percorso ecosostenibile. In questo esempio,
utilizzi la maschera del campo di risposta per restituire le proprietà di risposta associate a una
route ecosostenibile insieme alle proprietà routes.distanceMeters
e
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'
Esempio di risposta ecosostenibile
La chiamata computeRoutes
riportata sopra genera una risposta JSON che contiene due route: quella predefinita e quella a basso consumo di carburante. Nella risposta:
Per la route predefinita, la proprietà array
routeLabels
contieneDEFAULT_ROUTE
.Per il percorso ecosostenibile, la proprietà array
routeLabels
contieneFUEL_EFFICIENT
.Se imposti
computeAlternativeRoutes
nella richiesta sutrue
per calcolare percorsi alternativi, la proprietà dell'arrayrouteLabels
contieneDEFAULT_ROUTE_ALTERNATE
.
{ "routes": [ { "distanceMeters": 138939, "duration": "5412s", "routeToken": "CoYJCpoIC…0n9S1cu", "routeLabels": [ "DEFAULT_ROUTE" ] }, { "distanceMeters": 116887, "duration": "5631s", "routeToken": "CuEHCu0G…xqm", "routeLabels": [ "FUEL_EFFICIENT" ] } ] }
A causa delle attuali condizioni di guida e di altri fattori, il percorso predefinito e quello ecosostenibile possono essere uguali. In questo caso, routeLabels
contiene entrambe le etichette: DEFAULT_ROUTE
e FUEL_EFFICIENT
:
{ "routes": [ { "distanceMeters": 45875, "duration": "2655s", "routeToken": "CvcDCos…6I40", "routeLabels": [ "DEFAULT_ROUTE", "FUEL_EFFICIENT" ] } ] }
Stima il consumo di carburante per il percorso
Puoi richiedere il metodo per restituire il consumo stimato del carburante per l'intero percorso, in microlitri. Per aggiungere il consumo stimato del carburante per un percorso alla risposta:
Imposta il campo array
extraComputations
suFUEL_CONSUMPTION
per abilitare il calcolo dell'utilizzo del carburante.Specifica
emissionType
per il veicolo utilizzando i valori definiti in VehicleEmissionType:DIESEL
,GASOLINE
,ELECTRIC
oHYBRID
. Il valore predefinito èGASOLINE
.Se
emissionType
èHYBRID
, l'API converte il consumo di elettricità e carburante in microlitri di carburante.Se
emissionType
èELECTRIC
, l'API converte il consumo di elettricità in microlitri di carburante.Imposta una maschera del campo di risposta che specifichi di restituire le proprietà di risposta associate all'utilizzo del carburante:
routes.travelAdvisory.fuelConsumptionMicroliters
.
L'esempio seguente richiede l'utilizzo stimato del carburante nell'ambito di una richiesta che include anche il percorso ecosostenibile:
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 risposta contiene il consumo stimato di carburante sia per il percorso predefinito che per il percorso ecosostenibile:
{ "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" ] } ] }
Aree geografiche supportate
Il team di Google Maps Platform lavora costantemente per migliorare la copertura internazionale dei nostri servizi API. Nell'elenco che segue sono riportati i dettagli più recenti sulla copertura, paese per paese, per i percorsi ecosostenibili:
- Albania (AL)
- Austria (AT)
- Belgio (BE)
- Bosnia ed Erzegovina (BA)
- Bulgaria (BG)
- Canada (CA)
- Croazia (HR)
- Cipro (CY)
- Cechia (CZ)
- Danimarca (DK)
- Estonia (EE)
- Finlandia (FI)
- Francia (FR)
- Germania (DE)
- Grecia (GR)
- Ungheria (HU)
- Islanda (IS)
- Irlanda (IE)
- Italia (IT)
- Kosovo (XK)
- Lettonia (LV)
- Liechtenstein (LI)
- Lituania (LT)
- Lussemburgo (LU)
- Malta (MT)
- Montenegro (ME)
- Paesi Bassi (NL)
- Macedonia del Nord (MK)
- Norvegia (NO)
- Polonia (PL)
- Portogallo (PT)
- Romania (RO)
- Serbia (RS)
- Slovacchia (SK)
- Slovenia (SI)
- Spagna (ES)
- Svezia (SE)
- Svizzera (CH)
- Turchia (TR)
- Regno Unito (GB) (solo canali a pagamento)
- Stati Uniti (US)