Esta página foi traduzida pela API Cloud Translation.

Trajeto ecológico

Por padrão, a API Routes retorna a rota padrão, ou seja, sem considerar a eficiência energética ou de combustível. Quando você ativa o modelo ecológico roteamento, você ainda recebe a rota padrão na resposta. Além disso, você também voltar um trajeto ecológico que mostre o trajeto com maior economia de combustível ou energia com base no tipo de motor do veículo.

O trajeto ecológico retornado pela API Routes é otimizado para menor consumo de combustível em todo o trajeto. A API usa o motor do seu veículo tipo junto 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, reduzir o uso de combustível/energia do carro e as emissões de CO2.

Por exemplo, a vantagem relativa em economia de combustível de um veículo a diesel é geralmente na condução em estradas. Veículos híbridos e elétricos mais eficiência progressivamente na direção em paradas e em estradas acidentadas ambientes onde podem usar extensivamente e se beneficiar da abordagem freando.

Você também pode solicitar que a API retorne o consumo de combustível estimado para de todo o trajeto. Usar as estimativas de consumo de combustível para comparar trajetos diferentes, e não como estimativas explícitas de uso de combustível para o 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 dos EUA do Departamento de Energia Laboratório Nacional de Energia Renovável 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 vias locais ou rodovias)

A API Routes retorna o trajeto com melhor consumo de combustível ou energia quando tem aproximadamente o mesmo horário de chegada da rota padrão. Nos casos em que o combustível economia de energia é muito pequena ou aumentam 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:

Especifique TRAFFIC_AWARE_OPTIMAL como a preferência de roteamento. Neste o servidor realiza uma busca mais completa na malha rodoviária para para encontrar a melhor rota. Para mais informações, consulte Configure qualidade e latência.
Defina travelMode como DRIVE. Solicitações de qualquer outro meio de transporte retornará um erro.
Você deve definir um local para o ponto de referência de origem em um região com suporte. Caso contrário, a API 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 pré-lançamento. . No entanto, como trajetos ecológicos e estimativas do consumo de combustível exigir que você especifique TRAFFIC_AWARE_OPTIMAL como a preferência de roteamento, são cobrados com base no SKU: Routes Avançado.

Saiba mais sobre o faturamento da API Routes.

Solicitar um trajeto ecológico

Se quiser fazer uma solicitação para calcular uma rota ecológica, defina as propriedades a seguir 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.
Definir uma máscara de campo de resposta que especifique para retornar as propriedades da resposta associadas a um trajeto ecológico:
- routes.routeLabels: Identifica cada trajeto como DEFAULT_ROUTE, FUEL_EFFICIENT ou DEFAULT_ROUTE_ALTERNATE.
- routes.routeToken: Um token de rota que pode ser transmitido para SDK do Navigation para recuperar um 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, você usa a máscara de campo de resposta para retornar propriedades de resposta associadas a um trajeto ecológico com os routes.distanceMeters e routes.duration propriedades:

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 que economiza combustível. 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 contém 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 direção atuais e outros fatores, o trajeto e a rota padrão o trajeto ecológico pode ser o mesmo. Neste 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 da rota, em microlitros. Para adicionar o uso estimado de combustível para um trajeto ao resposta:

Defina o campo de matriz extraComputations como FUEL_CONSUMPTION para ativar a 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 vai converter eletricidade e combustível para microlitros de combustível.

Se o emissionType for ELECTRIC, a API vai converter eletricidade. para microlitros de combustível.
Definir uma máscara de campo de resposta que especifique para retornar as propriedades da resposta associado 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: 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 cobertura dos nossos serviços de API. A lista a seguir mostra a cobertura mais recente em cada país para criar trajetos ecológicos:

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)
Países Baixos (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)