Эта страница переведена с помощью Cloud Translation API.

Настройте экологически чистые маршруты

По умолчанию Routes API возвращает маршрут по умолчанию , то есть маршрут без учета расхода топлива или энергии. Когда вы включаете экологичную маршрутизацию , вы по-прежнему получаете в ответе маршрут по умолчанию. Кроме того, вы также получаете экологически чистый маршрут, показывающий наиболее экономичный маршрут с точки зрения расхода топлива или энергии в зависимости от типа двигателя вашего автомобиля.

Экологичный маршрут, возвращаемый Routes API, оптимизирован для снижения расхода топлива по всему маршруту. API использует тип двигателя вашего автомобиля, а также другие факторы, такие как трафик в режиме реального времени и дорожные условия, чтобы выбрать экологически чистый маршрут. Чем экономичнее маршрут с точки зрения топлива или энергии, тем меньше расход топлива/энергии и выбросы CO2 вашим автомобилем.

Например, относительное преимущество дизельного автомобиля в экономии топлива, как правило, является наибольшим при движении по шоссе. Гибридные и электрические транспортные средства, как правило, обеспечивают все более высокую эффективность при движении по городу с частыми остановками и в условиях движения по холмистой местности, где они могут широко использовать и получать выгоду от рекуперативного торможения.

Вы также можете запросить, чтобы API возвращал расчетный расход топлива для всего маршрута. Используйте оценки расхода топлива как способ сравнения различных маршрутов, а не как явные оценки расхода топлива для вашего конкретного автомобиля.

Как Google Maps оценивает эффективность использования топлива

API Routes оценивает эффективность использования топлива, используя данные Национальной лаборатории возобновляемых источников энергии Министерства энергетики США и данные Европейского агентства по окружающей среде. Этот расчет включает факторы, влияющие на потребление топлива и энергии и выбросы CO2, такие как:

Среднее потребление топлива или энергии для транспортных средств в вашем регионе
Крутизна холмов на вашем маршруте
Стоп-энд-гоу схемы движения
Типы дорог (например, местные дороги или шоссе)

Routes API возвращает наиболее экономичный с точки зрения расхода топлива или энергии маршрут, если его время прибытия примерно совпадает с маршрутом по умолчанию. В случаях, когда экономия топлива или энергии слишком мала или значительно увеличивает время в пути, API показывает относительную экономию топлива или энергии между маршрутами, чтобы помочь вам сравнить.

Узнайте больше об экологически чистой технологии маршрутизации (PDF) .

Предпосылки

Чтобы использовать экологически безопасный маршрут или оценить расход топлива:

Вы должны указать TRAFFIC_AWARE_OPTIMAL в качестве предпочтения маршрутизации. В этом режиме сервер выполняет более полный поиск дорожной сети, чтобы найти оптимальный маршрут. Дополнительные сведения см. в разделе Настройка качества и задержки .
Вы должны установить для travelMode значение DRIVE . Запросы любого другого режима движения возвращают ошибку.
Вы должны установить местоположение исходной путевой точки в поддерживаемом регионе . В противном случае API возвращает ошибку.
Маршрут не может содержать промежуточную путевую точку.

Выставление счетов

Как правило, платформа Google Карт не взимает плату за использование функции предварительного просмотра. Однако, поскольку для экологически чистой маршрутизации и оценки расхода топлива необходимо указать TRAFFIC_AWARE_OPTIMAL в качестве предпочтения маршрутизации, с вас будет взиматься плата в зависимости от SKU: Routes Advanced .

Узнайте больше о выставлении счетов за Routes API.

Запросить экологически чистый маршрут

Чтобы сделать запрос на расчет экологичного маршрута, задайте в запросе следующие свойства:

Укажите emissionType для транспортного средства, используя значения, определенные в VehicleEmissionType : DIESEL , GASOLINE , ELECTRIC или HYBRID . Значение по умолчанию — GASOLINE .
Задайте для requestedReferenceRoutes значение FUEL_EFFICIENT .
Задайте маску поля ответа, указывающую, что должны возвращаться свойства ответа, связанные с экологически чистым маршрутом:
- routes.routeLabels: идентифицирует каждый маршрут как DEFAULT_ROUTE , FUEL_EFFICIENT или DEFAULT_ROUTE_ALTERNATE .
- routes.routeToken: токен маршрута, который можно передать в пакет SDK для навигации , чтобы получить собственный маршрут.

Пример экологичного запроса

В следующем коде показан запрос на экологически чистый маршрут. В этом примере вы используете маску поля ответа, чтобы вернуть свойства ответа, связанные с экологически чистым маршрутом, вместе со свойствами routes.distanceMeters и 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'

Пример экологичного ответа

Приведенный выше вызов вычислительных маршрутов генерирует ответ JSON, содержащий два маршрута: маршрут по умолчанию и маршрут с эффективным расходом топлива. В ответе:

Для маршрута по умолчанию свойство массива routeLabels содержит DEFAULT_ROUTE .
Для экологичного маршрута свойство массива routeLabels содержит FUEL_EFFICIENT .
Если для computeAlternativeRoutes в запросе задано значение true для вычисления альтернативных маршрутов , свойство массива routeLabels будет содержать DEFAULT_ROUTE_ALTERNATE .

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

Из-за текущих условий вождения и других факторов маршрут по умолчанию и экологически чистый маршрут могут совпадать. В этом случае routeLabels содержит обе метки: DEFAULT_ROUTE и FUEL_EFFICIENT :

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

Расчет расхода топлива по маршруту

Вы можете запросить метод, чтобы вернуть расчетное потребление топлива для всего маршрута в микролитрах. Чтобы добавить расчетный расход топлива для маршрута к ответу:

Задайте для поля массива extraComputations значение FUEL_CONSUMPTION , чтобы включить расчет расхода топлива.
Укажите emissionType для транспортного средства, используя значения, определенные в VehicleEmissionType : DIESEL , GASOLINE , ELECTRIC или HYBRID . Значение по умолчанию — GASOLINE .
Если для emissionType задано значение HYBRID , API преобразует потребление электроэнергии и топлива в микролитры топлива.
Если для emissionType установлено значение ELECTRIC , API преобразует потребление электроэнергии в микролитры топлива.
Задайте маску поля ответа, указывающую, что должны возвращаться свойства ответа, связанные с использованием топлива: routes.travelAdvisory.fuelConsumptionMicroliters .

В следующем примере запрашивается расчетный расход топлива как часть запроса, который также включает экологически чистый маршрут:

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'

Ответ содержит расчетный расход топлива как для маршрута по умолчанию, так и для экологически чистого маршрута:

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

Поддерживаемые регионы

Команда Google Maps Platform постоянно работает над расширением международного охвата наших API-сервисов. В следующем списке показаны последние сведения о покрытии по странам для экологически чистой маршрутизации:

Албания (AL)
Австрия (АТ)
Бельгия (BE)
Босния и Герцеговина (BA)
Болгария (БГ)
Канада (Калифорния)
Хорватия (HR)
Кипр (КИ)
Чехия (CZ)
Дания (ДК)
Эстония (EE)
Финляндия (FI)
Франция (фр.)
Германия (DE)
Греция (GR)
Венгрия (HU)
Исландия (ИС)
Ирландия (IE)
Италия (ИТ)
Косово (XK)
Латвия (LV)
Лихтенштейн (LI)
Литва (LT)
Люксембург (LU)
Мальта (MT)
Черногория (ME)
Нидерланды (Нидерланды)
Северная Македония (МК)
Норвегия (НЕТ)
Польша (PL)
Португалия (Португалия)
Румыния (RO)
Сербия (РС)
Словакия (Словакия)
Словения (SI)
Испания (Испания)
Швеция (ЮВ)
Швейцария (Швейцария)
Турция (ТР)
Соединенное Королевство (ГБ)
Соединенные Штаты (США)