Scegli un percorso ecosostenibile

Per impostazione predefinita, l'API Routes restituisce la route predefinita, ovvero una route senza tenere conto del carburante o dell'efficienza energetica. Quando attivi il routing ecosostenibile, ricevi comunque il percorso predefinito nella risposta. Inoltre, viene visualizzato anche 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 un consumo di carburante inferiore durante 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 energia del percorso, minori il consumo di carburante/energia e le emissioni di CO2 della tua 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 progressivamente maggiore efficienza nella guida a singhiozzo in città e in aree di guida collinare, in cui possono utilizzare ampiamente e trarre vantaggio dalla frenata 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 veicolo in questione.

In che modo Google Maps stima il risparmio di carburante

L'API Routes stima il consumo di carburante utilizzando le informazioni del National Renewable Energy Laboratory del Dipartimento dell'energia degli Stati Uniti e i 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 con il minor consumo di carburante o con il minor consumo energetico se l'ora di arrivo è all'incirca la stessa del percorso predefinito. Nei casi in cui il risparmio di carburante o energia sia troppo ridotto o in cui i tempi di guida aumentino in modo significativo, l'API mostra il risparmio relativo di carburante o energia tra i percorsi per aiutarti a confrontarli.

Scopri di più sulla tecnologia del percorso ecosostenibile (PDF).

Prerequisiti

Per utilizzare percorsi ecosostenibili 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 qualità e latenza.

  • Devi impostare travelMode su DRIVE. Le richieste relative a 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 un tappa intermedia.

Fatturazione

In genere, Google Maps Platform non addebita alcun costo per l'utilizzo della funzionalità Anteprima. Tuttavia, poiché per percorrere un percorso ecosostenibile e la stima del consumo di carburante è necessario specificare TRAFFIC_AWARE_OPTIMAL come preferenza di percorso, gli addebiti vengono effettuati in base a 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 o HYBRID. Il valore predefinito è GASOLINE.

  • Imposta requestedReferenceRoutes su FUEL_EFFICIENT.

  • Imposta una maschera per il campo della risposta che specifichi di restituire le proprietà di risposta associate a una route ecosostenibile:

    • routes.routeLabels: Identifica ogni route come DEFAULT_ROUTE, FUEL_EFFICIENT o DEFAULT_ROUTE_ALTERNATE.

    • routes.routeToken: Un token di route che puoi passare all'SDK di navigazione per recuperare una route personalizzata.

Esempio di richiesta ecosostenibile

Il codice seguente 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 contenente due route: quella predefinita e quella a basso consumo di carburante. Nella risposta:

  • Per la route predefinita, la proprietà array routeLabels contiene DEFAULT_ROUTE.

  • Per la route ecosostenibile, la proprietà array routeLabels contiene FUEL_EFFICIENT.

  • Se imposti computeAlternativeRoutes nella richiesta su true per calcolare le route alternative, la proprietà array routeLabels contiene DEFAULT_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 condizioni di guida attuali e di altri fattori, il percorso predefinito e il percorso ecosostenibile possono coincidere. 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 di carburante stimato per l'intero percorso, in microlitri. Per aggiungere alla risposta il consumo di carburante stimato per un percorso:

  • Imposta il campo array extraComputations su FUEL_CONSUMPTION per abilitare il calcolo dell'utilizzo del carburante.

  • Specifica emissionType per il veicolo utilizzando i valori definiti in VehicleEmissionType: DIESEL, GASOLINE, ELECTRIC o HYBRID. 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 per il campo della risposta che specifichi di restituire le proprietà di risposta associate all'utilizzo del carburante: routes.travelAdvisory.fuelConsumptionMicroliters.

L'esempio seguente richiede il consumo stimato di 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 di carburante stimato sia per il percorso predefinito sia 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 vengono mostrati 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)