L'API Routes è attualmente in anteprima (pre-GA). I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le Offerte pre-GA sono coperte dai Termini di servizio specifici per Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni delle fasi di lancio.

Configura percorsi ecosostenibili

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Per impostazione predefinita, l'API Routes restituisce la route predefinita, ovvero una route senza tenere conto del consumo di carburante o dell'efficienza energetica. Quando attivi il routing ecosostenibile, ricevi comunque il percorso predefinito nella risposta. Inoltre, otterrai un percorso ecosostenibile che mostra il percorso a più basso consumo di carburante o energetico in base al tipo di motore del veicolo.

Per scegliere il percorso ecosostenibile, l'API Routes utilizza il tipo di motore del tuo veicolo insieme ad altri fattori come il traffico in tempo reale e le condizioni stradali. Maggiore è l'efficienza energetica o a livello di carburante del percorso, minori saranno il consumo di carburante/energia e le emissioni di CO2 della tua auto.

Ad esempio, il vantaggio relativo del risparmio di carburante di un veicolo diesel è in genere superiore durante la guida 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.

Il percorso ecosostenibile restituito dall'API è ottimizzato per un consumo di carburante inferiore per l'intera route. Usa le stime del consumo di carburante del percorso per confrontare i diversi percorsi, non le stime esplicite sul consumo di carburante del veicolo esatto.

In che modo Google Maps stima il consumo di carburante

L'API Routes stima i consumi 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 di quella predefinita. 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, effettua una richiesta per calcolare un percorso:

  • 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 Confronto tra qualità e latenza.

  • Devi impostare travelMode su DRIVE. Le richieste di percorsi ecosostenibili per qualsiasi altra modalità di viaggio restituiscono un errore.

  • Devi impostare una località per il waypoint di origine in un'area geografica supportata. In caso contrario, l'API restituisce un errore.

  • La route non può contenere un punto intermedio.

Richiedi un percorso ecosostenibile

Per effettuare una richiesta di calcolo di un percorso ecosostenibile, imposta le seguenti proprietà nella richiesta:

  • Imposta requestedReferenceRoutes su FUEL_EFFICIENT.

  • Specifica emissionType per il veicolo utilizzando i valori definiti in VehicleEmissionType: DIESEL, GASOLINE, ELECTRIC o HYBRID. Il valore predefinito è GASOLINE.

Inoltre, imposta una maschera per il campo di risposta che specifichi la restituzione delle proprietà di risposta associate a una route ecosostenibile:

  • routes.routeLabels: identifica ogni percorso:

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

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

    • Per qualsiasi route alternativa, la proprietà dell'array routeLabels contiene DEFAULT_ROUTE_ALTERNATE.

  • routes.travelAdvisory.fuelConsumptionMicroliters: consumo di carburante stimato per l'intero percorso, in microlitri.

    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.

  • routes.routeToken: un token di routing che puoi trasmettere all'SDK di navigazione per recuperare una route personalizzata.

Esempio di richiesta ecosostenibile

Il codice seguente mostra una richiesta per un percorso ecosostenibile. In questo esempio, utilizzi la maschera del campo di risposta per restituire le proprietà di risposta associate a un percorso 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: API_KEY' 
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.travelAdvisory.fuelConsumptionMicroliters,routes.routeToken' 
'https://routes.googleapis.com/directions/v2:computeRoutes'

Esempio di risposta ecosostenibile

La chiamata della route di calcolo riportata sopra genera una risposta JSON contenente due route:

{
    "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"
            ]
        }
    ]
}

Se il percorso predefinito e quello ecosostenibile sono uguali, la proprietà routeLabels contiene sia DEFAULT_ROUTE che FUEL_EFFICIENT:

{
  "routes": [
    {
      "distanceMeters": 45875,
      "duration": "2655s",
      "travelAdvisory": {
        "fuelConsumptionMicroliters": "1926791"
      },
      "routeToken": "CvcDCos…6I40",
      "routeLabels": [
        "DEFAULT_ROUTE",
        "FUEL_EFFICIENT"
      ]
    }
  ]
}

Aree geografiche supportate

Il team di Google Maps Platform si adopera costantemente per migliorare la copertura internazionale dei nostri servizi API. Il seguente elenco mostra gli ultimi dettagli sulla copertura, paese per paese, per il percorso ecosostenibile:

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