Configurar trajetos ecológicos

Por padrão, a API Routes retorna a rota default, o que significa uma rota sem levar em conta a eficiência de combustível ou energia. Quando você ativa o roteamento ecológico, ainda recebe a rota padrão na resposta. Além disso, você também recebe um trajeto ecológico que mostra o trajeto mais econômico, com base no tipo de motor do veículo.

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

Por exemplo, a vantagem relativa da economia de combustível de um veículo a diesel costuma ser maior na condução em rodovias. Veículos híbridos e elétricos tendem a fornecer eficiência progressivamente maior em carros nas paradas e em ambientes montanhosos em que eles podem usar e se beneficiar muito da frenagem regenerativa.

Você também pode solicitar que a API retorne o consumo estimado de combustível para todo o trajeto. Use as estimativas de consumo de combustível como uma maneira de comparar diferentes trajetos, não como estimativas explícitas de uso de combustível para seu veículo exato.

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

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

  • 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 locais ou rodovias)

A API Routes retorna o trajeto mais econômico ou econômico quando ele tem quase o mesmo horário de chegada que o trajeto padrão. Nos casos em que a economia de combustível ou energia é muito pequena ou aumenta significativamente o tempo de percurso, a API mostra a economia relativa de combustível ou energia entre os trajetos para ajudar você a 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:

  • Você precisa especificar TRAFFIC_AWARE_OPTIMAL como a preferência de roteamento. Nesse modo, o servidor realiza uma pesquisa mais completa da rede de estradas para encontrar o trajeto ideal. Para mais informações, consulte Configurar qualidade x latência.

  • Defina travelMode como DRIVE. As solicitações para qualquer outro meio de transporte retornam um erro.

  • É preciso definir um local para o waypoint de origem em uma região compatível. Caso contrário, a API retornará um erro.

  • O trajeto não pode conter um ponto de referência intermediário.

Faturamento

Normalmente, a Plataforma Google Maps não cobra pelo uso de um recurso de visualização. No entanto, como o roteamento ecológico e a estimativa do consumo de combustível exigem que você especifique TRAFFIC_AWARE_OPTIMAL como a preferência de roteamento, você é cobrado com base em SKU: rotas avançadas.

Saiba mais sobre o faturamento da Routes API.

Solicitar um trajeto ecológico

Para fazer uma solicitação e calcular uma rota ecológica, defina as propriedades a seguir:

  • 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 uma rota ecológica:

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

    • routes.routeToken: Um token de rota que pode ser transmitido para o SDK de navegação para recuperar uma rota personalizada.

Exemplo de solicitação ecológica

O código a seguir mostra uma solicitação de um trajeto ecológico. Neste exemplo, use a máscara de campo de resposta para retornar propriedades de resposta associadas a uma rota ecológica, além das 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: 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 de rotas de computação acima gera uma resposta JSON que contém duas rotas: a padrão e a econômica. Na resposta:

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

  • Para a rota ecológica, 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 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"
            ]
        }
    ]
}

Por causa das condições atuais do trânsito e de outros fatores, as rotas padrão e ecológica podem ser as mesmas. 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 o método para retornar o uso estimado de combustível para todo o trajeto, em microlitro. Para adicionar o uso estimado de combustível para uma rota à resposta:

  • Defina o campo da matriz extraComputations como FUEL_CONSUMPTION para ativar o cálculo do 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 converterá o consumo de energia elétrica e combustível em microlitro.

    Se o emissionType for ELECTRIC, a API converterá o consumo de eletricidade para microlitro de combustível.

  • Defina uma máscara de campo de resposta que especifique para retornar as 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:

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: 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 estimado de combustível para a rota padrão e ecológica:

{
    "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 de cobertura mais recentes, por país, para roteamento ecológico:

  • Albânia (AL)
  • Áustria (AT)
  • Bélgica (BE)
  • Bósnia e Herzegovina (BA)
  • Bulgária (BG)
  • Canadá (CA)
  • Croácia (HR)
  • Chipre (CY)
  • República Tcheca (CZ)
  • Dinamarca (DK)
  • Estônia (EE)
  • Finlândia (FI)
  • França (FR)
  • Alemanha (DE)
  • Grécia (GR)
  • Hungria (HU)
  • Islândia (IS)
  • Irlanda (IE)
  • Itália (IT)
  • Kosovo (XK)
  • Letônia (LV)
  • Liechtenstein (LI)
  • Lituânia (LT)
  • Luxemburgo (LU)
  • Malta (MT)
  • Montenegro (ME)
  • Holanda (NL)
  • Macedônia do Norte (MK)
  • Noruega (NO)
  • Polônia (PL)
  • Portugal (PT)
  • Romênia (RO)
  • Sérvia (RS)
  • Eslováquia (SK)
  • Eslovênia (SI)
  • Espanha (ES)
  • Suécia (SE)
  • Suíça (CH)
  • Turquia (TR)
  • Reino Unido (GB)
  • Estados Unidos (EUA)