Obtén una ruta ecológica

De forma predeterminada, la API de Routes devuelve la ruta predeterminada, es decir, una ruta que no tiene en cuenta el ahorro de combustible ni de energía. Cuando habilitas el enrutamiento ecológico, sigues recibiendo la ruta predeterminada en la respuesta. Además, también obtendrás una ruta ecológica que muestra la ruta más eficiente en cuanto al ahorro de combustible o energía según el tipo de motor de tu vehículo.

La ruta ecológica que muestra la API de Routes está optimizada para reducir el consumo de combustible en toda la ruta. La API usa el tipo de motor de tu vehículo junto con otros factores, como el tráfico en tiempo real y las condiciones de las rutas, para elegir la ruta ecológica. Mientras mayor sea la eficiencia de la ruta con respecto al ahorro de combustible o energía, serán menores el consumo de combustible o energía y las emisiones de CO2 de tu vehículo.

Por ejemplo, la ventaja relativa del ahorro de combustible de un vehículo diésel suele ser mayor en las autopistas. Los vehículos híbridos y eléctricos tienden a proporcionar una eficiencia progresivamente mayor en los entornos de conducción urbana de detención y avance y de conducción en pendiente, donde pueden utilizar ampliamente el frenado regenerativo y pueden aprovecharlo.

También puedes solicitar que la API muestre el consumo de combustible estimado para toda la ruta. Usa las estimaciones de consumo de combustible para comparar diferentes rutas, no como estimaciones explícitas del uso de combustible para tu vehículo exacto.

Cómo estima Google Maps el ahorro de combustible

La API de Routes estima la eficiencia del combustible con las estadísticas del Laboratorio Nacional de Energía Renovable del Departamento de Energía de EE.UU. y los datos de la Agencia Europea de Medio Ambiente. Este cálculo incluye factores que afectan el consumo de combustible y energía, y las emisiones de CO2, como los siguientes:

• Consumo promedio de combustible o energía para los vehículos de tu región
• Pendientes en la ruta
• Patrones de detención del tráfico
• Tipos de rutas (como rutas locales o autopistas)

La API de Routes devuelve la ruta con mayor ahorro de combustible o energía si tiene prácticamente la misma hora de llegada que la ruta predeterminada. En los casos en que el ahorro de combustible o energía sea demasiado pequeño, o la duración del viaje aumente significativamente, la API muestra el ahorro relativo de combustible o energía entre las diferentes rutas para ayudarte a compararlas.

Obtén más información sobre la tecnología de rutas ecológicas (PDF).

Requisitos previos

Para usar las rutas ecológicas o estimar el consumo de combustible, haz lo siguiente:

• Debes especificar TRAFFIC_AWARE_OPTIMAL como la preferencia de enrutamiento. En este modo, el servidor realiza una búsqueda más exhaustiva de la red vial para encontrar la ruta óptima. Para obtener más información, consulta Configura la calidad en comparación con la latencia.

• Debes establecer travelMode en DRIVE o TWO_WHEELER. Las solicitudes para cualquier otro medio de transporte muestran un error. El enrutamiento ecológico para TWO_WHEELER solo se admite en algunos países.

• Debes establecer una ubicación para el punto de partida en una región admitida. De lo contrario, la API muestra un error.

• En el caso de TWO_WHEELER, debes establecer una ubicación para el punto de partida en una región compatible con vehículos de dos ruedas. De lo contrario, la API muestra un error.

• La ruta no puede contener un punto de referencia intermedio.

Facturación

Por lo general, Google Maps Platform no cobra por el uso de una función en versión preliminar. Sin embargo, debido a que las rutas ecológicas y la estimación del consumo de combustible requieren que especifiques TRAFFIC_AWARE_OPTIMAL como preferencia de ruta, se te cobrará según el SKU: Compute Routes Pro.

Obtén más información sobre la facturación de la API de Routes.

Cómo solicitar una ruta ecológica

Para solicitar el cálculo de una ruta ecológica, establece las siguientes propiedades en la solicitud:

• Especifica emissionType para el vehículo con los valores definidos en VehicleEmissionType: DIESEL, GASOLINE, ELECTRIC o HYBRID. El valor predeterminado es GASOLINE.

• Establece requestedReferenceRoutes en FUEL_EFFICIENT.

• Establece una máscara de campo de respuesta que especifique que se devuelvan las propiedades de respuesta asociadas con una ruta ecológica:

  • routes.routeLabels: Identifica cada ruta como DEFAULT_ROUTE, FUEL_EFFICIENT o DEFAULT_ROUTE_ALTERNATE.

  • routes.routeToken: Es un token de ruta que puedes pasar al SDK de Navigation para recuperar una ruta personalizada.

Ejemplo de solicitud ecológica

En el siguiente código, se muestra una solicitud de una ruta ecológica. En este ejemplo, usas la máscara de campo de respuesta para devolver las propiedades de respuesta asociadas a una ruta ecológica junto con las propiedades routes.distanceMeters y 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'

Ejemplo de respuesta ecológica

La llamada a computeRoutes anterior genera una respuesta JSON que contiene dos rutas: la ruta predeterminada y la ruta eficiente en el consumo de combustible. En la respuesta, figura lo siguiente:

• Para la ruta predeterminada, la propiedad de array routeLabels contiene DEFAULT_ROUTE.

• En el caso de la ruta ecológica, la propiedad de array routeLabels contiene FUEL_EFFICIENT.

• Si configuras computeAlternativeRoutes en la solicitud como true para calcular rutas alternativas, la propiedad de 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"
            ]
        }
    ]
}

Debido a las condiciones de conducción actuales y otros factores, la ruta predeterminada y la ruta ecológica pueden ser las mismas. En este caso, routeLabels contiene ambas etiquetas: DEFAULT_ROUTE y FUEL_EFFICIENT:

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

Estimar el uso de combustible para la ruta

Puedes solicitar que el método devuelva el uso de combustible estimado para toda la ruta, en microlitros. Para agregar el uso de combustible estimado de una ruta a la respuesta, haz lo siguiente:

• Establece el campo de array extraComputations en FUEL_CONSUMPTION para habilitar el cálculo del uso de combustible.

• Especifica emissionType para el vehículo con los valores definidos en VehicleEmissionType: DIESEL, GASOLINE, ELECTRIC o HYBRID. El valor predeterminado es GASOLINE.

  Si emissionType es HYBRID, la API convierte el consumo de electricidad y combustible en microlitros de combustible.

  Si emissionType es ELECTRIC, la API convierte el consumo de electricidad en microlitros de combustible.

• Establece una máscara de campo de respuesta que especifique que se devuelvan las propiedades de respuesta asociadas con el uso de combustible: routes.travelAdvisory.fuelConsumptionMicroliters.

En el siguiente ejemplo, se solicita el uso estimado de combustible como parte de una solicitud que también incluye la ruta ecológica:

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 respuesta contiene el consumo de combustible estimado para la ruta predeterminada y la ruta 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"
            ]
        }
    ]
}

Regiones admitidas

El equipo de Google Maps Platform trabaja constantemente para mejorar la cobertura internacional de nuestros servicios de API. En la siguiente lista, se muestran los detalles de cobertura más recientes del enrutamiento ecológico por país:

• Albania (AL)
• Australia (AU)
• Austria (AT)
• Bélgica (BE)
• Bosnia-Herzegovina (BA)
• Bulgaria (BG)
• Canadá (CA)
• Croacia (HR)
• Chipre (CY)
• República Checa (CZ)
• Dinamarca (DK)
• Egipto (EG)
• Estonia (EE)
• Finlandia (FI)
• Francia (FR)
• Alemania (DE)
• Grecia (GR)
• Hungría (HU)
• Islandia (IS)
• India (IN)
• Indonesia (ID)
• Irlanda (IE)
• Italia (IT)
• Kosovo (XK)
• Letonia (LV)
• Liechtenstein (LI)
• Lituania (LT)
• Luxemburgo (LU)
• Malta (MT)
• México (MX)
• Montenegro (ME)
• Países Bajos (NL)
• Macedonia del Norte (MK)
• Noruega (NO)
• Polonia (PL)
• Portugal (PT)
• Rumania (RO)
• Arabia Saudita (SA)
• Serbia (RS)
• Eslovaquia (SK)
• Eslovenia (SI)
• España (ES)
• Suecia (SE)
• Suiza (CH)
• Türkiye (TR)
• Emiratos Árabes Unidos (AE)
• Reino Unido (GB)
• Estados Unidos (US)

Regiones admitidas para vehículos de dos ruedas

En la siguiente lista, se muestran los detalles de cobertura más recientes por país para la función de rutas ecológicas en vehículos de dos ruedas:

• India (IN)
• Indonesia (ID)