Scegli un percorso ecosostenibile

Per impostazione predefinita, l'API Routes restituisce la route default, ovvero una route senza tenere conto del consumo di carburante o dell'efficienza energetica. Quando attivi le funzionalità ecosostenibili di routing, ricevi comunque la route predefinita nella risposta. Inoltre, ripristina 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 di carburante in meno sull'intero percorso. L'API utilizza il motore del veicolo tipo insieme ad altri fattori come il traffico in tempo reale e le condizioni delle strade per scegliere il percorso ecosostenibile. Maggiore è il consumo di carburante o l'efficienza energetica del percorso, ridurre 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 è meglio guidare in autostrada. I veicoli ibridi ed elettrici tendono a fornire progressivamente maggiore l'efficienza di guida in città e in collina ambienti in cui possono usare e trarre beneficio in modo esteso dai sistemi rigenerativi frenata.

Puoi anche richiedere che l'API restituisca il consumo stimato di carburante per per l'intero percorso. Usa le stime del consumo di carburante per fare un confronto diversi percorsi, non come stime esplicite del consumo di carburante per il veicolo esatto.

In che modo Google Maps stima il consumo di carburante

L'API Routes stima il consumo di carburante utilizzando informazioni provenienti dagli Stati Uniti Dipartimento dell'energia National Renewable Energy Laboratory 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 all'incirca la stessa ora di arrivo del percorso predefinito. Nei casi in cui il carburante o il risparmio energetico è troppo basso o aumenta significativamente il tempo di guida, l'API mostra il risparmio di carburante o energia relativo tra i 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 questo automatica, il server esegue una ricerca più completa della rete stradale per trovare il percorso ottimale. Per ulteriori informazioni, vedi Configura qualità e latenza.

  • Devi impostare travelMode su DRIVE. Richieste di qualsiasi altra modalità di viaggio restituisce un errore.

  • Devi impostare una località per la tappa di partenza 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 un'anteprima funzionalità. Tuttavia, poiché il percorso ecosostenibile e la stima del consumo di carburante richiede di specificare TRAFFIC_AWARE_OPTIMAL come preferenza di routing, Il costo è addebitato in base allo SKU: Routes Avanzate.

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

Richiedi un percorso ecosostenibile

Per effettuare una richiesta di calcolo di un percorso 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.

  • Impostare una maschera del campo di risposta che specifichi di restituire le proprietà della risposta. associati a un percorso ecosostenibile:

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

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

Esempio di richiesta rispettoso dell'ambiente

Il seguente codice mostra una richiesta di un percorso ecosostenibile. In questo esempio, puoi utilizzare la maschera del campo di risposta per restituire le proprietà della risposta associate a percorso ecosostenibile insieme ai routes.distanceMeters e routes.duration proprietà:

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 percorsi: quello predefinito e il percorso a basso consumo di carburante. Nella risposta:

  • Per la route predefinita, la proprietà 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à 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 attuali condizioni di guida e di altri fattori, il percorso predefinito e il percorso ecosostenibile può essere lo stesso. 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 in microlitri. Per aggiungere il consumo stimato del carburante per un percorso alla risposta:

  • Imposta il campo array extraComputations su FUEL_CONSUMPTION per abilitare 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 l'elettricità e il carburante il consumo energetico in microlitri di carburante.

    Se emissionType è ELECTRIC, l'API converte l'elettricità il consumo energetico in microlitri di carburante.

  • Impostare una maschera del campo di risposta che specifichi di restituire le proprietà della risposta. associate al consumo di carburante: routes.travelAdvisory.fuelConsumptionMicroliters.

Nell'esempio seguente viene richiesto 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 per entrambi i percorsi predefiniti e 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 si adopera costantemente per migliorare le relazioni internazionali per i nostri servizi API. L'elenco seguente mostra la copertura più recente dettagli, 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)
  • Stati Uniti (US)