Trajeto ecológico

Desenvolvedores do Espaço Econômico Europeu (EEE)

Se o endereço de faturamento estiver no Espaço Econômico Europeu, a partir de 8 de julho de 2025, os Termos de Serviço da Plataforma Google Maps para o EEE vão valer para o uso dos serviços. A funcionalidade varia de acordo com a região. Saiba mais.

Este produto ou recurso está em pré-lançamento (pré-GA). Os produtos e recursos em pré-GA têm suporte limitado, e é possível que as mudanças neles não sejam compatíveis com versões anteriores. Os produtos e recursos em pré-GA são cobertos pelos Termos de Serviço da Plataforma Google Maps. Para mais detalhes, consulte as descrições da fase de lançamento.

Observação : os trajetos ecológicos não são compatíveis com o recurso Compute Route Matrix da API Routes.

Por padrão, a API Routes retorna o trajeto padrão, ou seja, um trajeto sem considerar o combustível ou a eficiência energética. Quando você ativa os trajetos ecológicos, ainda recebe o trajeto padrão na resposta. Além disso, você também recebe um trajeto ecológico que mostra o caminho mais eficiente em termos de combustível ou energia com base no tipo de motor do seu veículo.

O trajeto ecológico retornado pela API Routes é otimizado para reduzir o consumo de combustível em todo o percurso. A API usa o tipo de motor do veículo e outros fatores, como trânsito em tempo real e condições da via, para escolher o trajeto ecológico. Quanto mais econômico for o trajeto, menor será o uso de combustível ou energia do carro e as emissões de CO2.

Por exemplo, a vantagem relativa da economia de combustível para veículos a diesel geralmente é maior em rodovias. Os veículos híbridos e elétricos costumam ter uma eficiência progressivamente maior na cidade (com padrões de "anda e para") e em ambientes montanhosos em que eles podem usar e se beneficiar bastante da frenagem regenerativa.

Também é possível solicitar que a API retorne o consumo de combustível estimado para todo o trajeto. Use as estimativas de consumo de combustível para comparar rotas diferentes, não como estimativas explícitas de uso de combustível para seu veículo.

Observação: é possível solicitar estimativas de consumo de combustível para qualquer trajeto, não apenas ao solicitar um trajeto ecológico.

Como o Google Maps estima a eficiência de combustível

A API Routes estima a eficiência de combustível usando os insights do Laboratório Nacional de Energia Renovável do Departamento de Energia dos EUA e os dados da Agência Europeia do Ambiente. Esse cálculo inclui fatores que influenciam o uso de combustível e energia e as emissões de CO2, como estes:

• Consumo médio de combustível ou energia dos veículos na sua região
• Inclinação das vias no trajeto
• Padrões de "anda e para" do trânsito
• Tipos de via (como vias locais ou rodovias)

A API Routes retorna o trajeto mais econômico quando o horário de chegada é quase o mesmo da rota padrão. Quando a economia de combustível ou energia é muito pequena ou o tempo de percurso é significativamente maior, a API mostra o valor relativo entre os trajetos para você comparar.

Saiba mais sobre a tecnologia de trajetos ecológicos (PDF em inglês)

Pré-requisitos

Para usar trajetos ecológicos ou estimar o consumo de combustível:

• Especifique TRAFFIC_AWARE_OPTIMAL como a preferência de roteamento. Nesse modo, o servidor realiza uma pesquisa mais exaustiva da rede viária para encontrar o trajeto ideal. Para mais informações, consulte Configurar qualidade x latência.

• Defina travelMode como DRIVE ou TWO_WHEELER. As solicitações para qualquer outro meio de transporte retornam um erro. Os trajetos ecológicos para TWO_WHEELER estão disponíveis apenas em alguns países.

• É necessário definir um local para o ponto de passagem de origem em uma região com disponibilidade. Caso contrário, a API vai retornar um erro.

• Para TWO_WHEELER, é necessário definir um local para o waypoint de origem em uma região com disponibilidade para veículos de duas rodas. Caso contrário, a API vai retornar um erro.

• O trajeto não pode conter um waypoint intermediário.

Faturamento

Normalmente, a Plataforma Google Maps não cobra pelo uso de um recurso em fase de pré-lançamento. No entanto, como os trajetos ecológicos e a estimativa de consumo de combustível exigem que você especifique TRAFFIC_AWARE_OPTIMAL como a preferência de trajeto, você vai receber cobranças com base na SKU: Compute Routes Pro.

Saiba mais sobre o faturamento da API Routes.

Solicitar um trajeto ecológico

Para fazer uma solicitação de cálculo de um trajeto ecológico, defina as seguintes propriedades na solicitação:

• Especifique emissionType para o veículo usando os valores definidos em VehicleEmissionType: DIESEL, GASOLINE, ELECTRIC ou HYBRID. O valor padrão é GASOLINE.

• Defina requestedReferenceRoutes como FUEL_EFFICIENT.

• Defina uma máscara de campo de resposta que especifique o retorno das propriedades de resposta associadas a um trajeto ecológico:

  • routes.routeLabels: Identifica cada rota como DEFAULT_ROUTE, FUEL_EFFICIENT ou DEFAULT_ROUTE_ALTERNATE.

  • routes.routeToken:: um token de trajeto que pode ser transmitido ao SDK do Navigation para recuperar um trajeto personalizado.

Exemplo de solicitação ecológica

O código a seguir mostra uma solicitação de trajeto ecológico. Neste exemplo, você usa a máscara de campo de resposta para retornar propriedades de resposta associadas a um trajeto ecológico com as propriedades 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'

Exemplo de resposta ecológica

A chamada computeRoutes acima gera uma resposta JSON que contém dois trajetos: o padrão e o econômico. Na resposta:

• Para a rota padrão, a propriedade de matriz routeLabels contém DEFAULT_ROUTE.

• Para o trajeto ecológico, a propriedade de matriz routeLabels contém FUEL_EFFICIENT.

• Se você definir computeAlternativeRoutes na solicitação como true para calcular rotas alternativas, a propriedade de matriz routeLabels vai conter DEFAULT_ROUTE_ALTERNATE.

{
    "routes": [
        {
            "distanceMeters": 138939,
            "duration": "5412s",
            "routeToken": "CoYJCpoIC…0n9S1cu",
            "routeLabels": [
                "DEFAULT_ROUTE"
            ]
        },
        {
            "distanceMeters": 116887,
            "duration": "5631s",
            "routeToken": "CuEHCu0G…xqm",
            "routeLabels": [
                "FUEL_EFFICIENT"
            ]
        }
    ]
}

Devido às condições de trânsito atuais e a outros fatores, o trajeto padrão e o trajeto ecológico podem ser iguais. Nesse caso, routeLabels contém os dois rótulos: DEFAULT_ROUTE e FUEL_EFFICIENT:

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

Estimar o uso de combustível para o trajeto

Você pode solicitar que o método retorne o uso estimado de combustível para todo o trajeto, em microlitros. Para adicionar o uso estimado de combustível de um trajeto à resposta:

• Defina o campo de matriz extraComputations como FUEL_CONSUMPTION para ativar o cálculo de uso de combustível.

• Especifique emissionType para o veículo usando os valores definidos em VehicleEmissionType: DIESEL, GASOLINE, ELECTRIC ou HYBRID. O valor padrão é GASOLINE.

  Se o emissionType for HYBRID, a API vai converter o consumo de eletricidade e combustível em microlitros de combustível.

  Se o emissionType for ELECTRIC, a API vai converter o consumo de eletricidade em microlitros de combustível.

• Defina uma máscara de campo de resposta que especifique o retorno das propriedades de resposta associadas ao uso de combustível: routes.travelAdvisory.fuelConsumptionMicroliters.

O exemplo a seguir solicita o uso estimado de combustível como parte de uma solicitação que também inclui o trajeto ecológico:

Observação: não é necessário solicitar um trajeto ecológico para estimar o consumo de combustível. Por exemplo, você pode solicitar o consumo de combustível ao pedir apenas a rota padrão ou ao pedir rotas alternativas.

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'

A resposta contém o consumo de combustível estimado para o trajeto padrão e para o trajeto ecológico:

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

Regiões compatíveis

A equipe da Plataforma Google Maps trabalha constantemente para melhorar a cobertura internacional dos nossos serviços de API. A lista a seguir mostra os detalhes mais recentes da cobertura, por país, para trajetos ecológicos:

• Albânia (AL)
• Austrália (AU)
• Argentina (AR)
• Austrália (AU)
• Bósnia e Herzegovina (BA)
• Bulgária (BG)
• Canadá (CA)
• Croácia (HR)
• Chipre (CY)
• República Tcheca (CZ)
• Dinamarca (DK)
• Egito (EG)
• Estônia (EE)
• Finlândia (FI)
• França (FR)
• Alemanha (DE)
• Grécia (GR)
• Hungria (HU)
• Islândia (IS)
• Índia (IN)
• Indonésia (ID)
• Irlanda (IE)
• Itália (IT)
• Kosovo (XK)
• Letônia (LV)
• Liechtenstein (LI)
• Lituânia (LT)
• Luxemburgo (LU)
• Malta (MT)
• México (MX)
• Montenegro (ME)
• Holanda (NL)
• Macedônia do Norte (MK)
• Noruega (NO)
• Polônia (PL)
• Portugal (PT)
• Polônia (PL)
• Arábia Saudita (SA)
• Sérvia (RS)
• Eslováquia (SK)
• Eslovênia (SI)
• Espanha (ES)
• Suécia (SE)
• Suíça (CH)
• Turquia (TR)
• Emirados Árabes Unidos (AE)
• Reino Unido (GB)
• Estados Unidos (EUA)

Regiões com disponibilidade para motocicletas

A lista a seguir mostra os detalhes mais recentes da cobertura, por país, para trajetos ecológicos de veículos de duas rodas:

• Índia (IN)
• Indonésia (ID)