Scegli un percorso ecosostenibile

Sviluppatori dello Spazio economico europeo (SEE)

Per impostazione predefinita, l'API Routes restituisce il percorso predefinito, ovvero un percorso senza tenere conto del consumo di carburante o di energia. Quando attivi l'itinerario ecologico, nella risposta viene comunque visualizzato l'itinerario predefinito. Inoltre, riceverai anche un percorso ecosostenibile che mostra il percorso più efficiente dal punto di vista del consumo di carburante o del risparmio energetico in base al tipo di motore del veicolo.

Il percorso ecologico restituito dall'API Routes è ottimizzato per un consumo di carburante inferiore sull'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 ecologico. Maggiore è l'efficienza energetica o a livello di carburante del percorso, minori saranno il consumo di carburante o energia e le emissioni di CO2 della tua auto.

Ad esempio, il vantaggio relativo al risparmio di carburante di un veicolo diesel è solitamente maggiore in autostrada. I veicoli ibridi ed elettrici tendono a fornire un'efficienza progressivamente maggiore nella guida in città e in ambienti collinari, dove possono utilizzare e sfruttare ampiamente la frenata rigenerativa.

Puoi anche richiedere che l'API restituisca il consumo di carburante stimato per l'intero percorso. Utilizza le stime del consumo di carburante come modo per confrontare diversi percorsi, 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 i dati del National Renewable Energy Laboratory del Dipartimento dell'energia degli Stati Uniti e quelli 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 se l'ora di arrivo è all'incirca la stessa del percorso predefinito. Nei casi in cui il risparmio di carburante o energia sia minimo o la differenza del tempo di guida notevolmente maggiore, l'API mostra il risparmio di carburante o energia relativo ai percorsi per aiutarti a confrontarli.

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ù esaustiva della rete stradale per trovare il percorso ottimale. Per saperne di più, consulta Configurare la qualità rispetto alla latenza.

  • Devi impostare travelMode su DRIVE o TWO_WHEELER. Le richieste per qualsiasi altra modalità di viaggio restituiscono un errore. Il percorso ecologico per TWO_WHEELER è supportato solo in alcuni paesi.

  • Devi impostare una posizione per il waypoint di origine in una regione supportata. In caso contrario, l'API restituisce un errore.

  • Per TWO_WHEELER, devi impostare una posizione per il waypoint di partenza in una regione supportata per i veicoli a due ruote. In caso contrario, l'API restituisce un errore.

  • La rotta non può contenere un waypoint intermedio.

Fatturazione

In genere, Google Maps Platform non addebita costi per l'utilizzo di una funzionalità di anteprima. Tuttavia, poiché il percorso ecosostenibile e la stima del consumo di carburante richiedono di specificare TRAFFIC_AWARE_OPTIMAL come preferenza di routing, ti vengono addebitati costi in base allo SKU: Compute Routes Pro.

Scopri di più sulla fatturazione per l'API Routes.

Richiedere un percorso ecosostenibile

Per inviare una richiesta per calcolare un percorso ecologico, 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 del campo di risposta che specifichi di restituire le proprietà di risposta associate a un percorso ecologico:

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

    • routes.routeToken: Un token di percorso che puoi passare all'SDK Navigation per recuperare un percorso personalizzato.

Esempio di richiesta ecologica

Il seguente codice mostra una richiesta di un percorso ecologico. In questo esempio, utilizzi la maschera del campo di risposta per restituire le proprietà di risposta associate a un percorso ecologico 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 ecologica

La chiamata computeRoutes riportata sopra genera una risposta JSON contenente due percorsi: il percorso predefinito e il percorso a minor consumo di carburante. Nella risposta:

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

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

  • Se imposti computeAlternativeRoutes nella richiesta su true per calcolare percorsi alternativi, la proprietà dell'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 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 del consumo di carburante per l'itinerario

Puoi richiedere il metodo per restituire l'utilizzo stimato di carburante per l'intero percorso, in microlitri. Per aggiungere all'itinerario il consumo di carburante stimato alla risposta:

  • Imposta il campo dell'array extraComputations su FUEL_CONSUMPTION per attivare il calcolo del consumo di 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 del campo di risposta che specifichi di restituire le proprietà di risposta associate all'utilizzo di carburante:routes.travelAdvisory.fuelConsumptionMicroliters.

Il seguente esempio richiede l'utilizzo stimato di carburante nell'ambito di una richiesta che include anche l'itinerario ecologico:

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. Il seguente elenco mostra i dettagli più recenti della copertura, paese per paese, per il percorso ecologico:

  • Albania (AL)
  • Australia (AU)
  • Austria (AT)
  • Belgio (BE)
  • Bosnia ed Erzegovina (BA)
  • Bulgaria (BG)
  • Canada (CA)
  • Croazia (HR)
  • Cipro (CY)
  • Repubblica Ceca (CZ)
  • Danimarca (DK)
  • Egitto (EG)
  • Estonia (EE)
  • Finlandia (FI)
  • Francia (FR)
  • Germania (DE)
  • Grecia (GR)
  • Ungheria (HU)
  • Islanda (IS)
  • India (IN)
  • Indonesia (ID)
  • Irlanda (IE)
  • Italia (IT)
  • Kosovo (XK)
  • Lettonia (LV)
  • Liechtenstein (LI)
  • Lituania (LT)
  • Lussemburgo (LU)
  • Malta (MT)
  • Messico (MX)
  • Montenegro (ME)
  • Paesi Bassi (NL)
  • Macedonia del Nord (MK)
  • Norvegia (NO)
  • Polonia (PL)
  • Portogallo (PT)
  • Romania (RO)
  • Arabia Saudita (SA)
  • Serbia (RS)
  • Slovacchia (SK)
  • Slovenia (SI)
  • Spagna (ES)
  • Svezia (SE)
  • Svizzera (CH)
  • Turchia (TR)
  • Emirati Arabi Uniti (AE)
  • Regno Unito (GB)
  • Stati Uniti (US)

Regioni supportate per i veicoli a due ruote

Il seguente elenco mostra i dettagli della copertura più recenti, paese per paese, per il percorso ecologico dei veicoli a due ruote:

  • India (IN)
  • Indonesia (ID)