Route - Get Route Range

  • Ссылка
Service:
Maps
API Version:
1.0

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

Get Route Range API (Isochrone) — это HTTP-запросGET, который вычисляет набор расположений, которые могут быть доступны из исходной точки на основе указанного бюджета топлива, энергии, времени или расстояния. Граница многоугольника (или изохрона) возвращается в ориентации против часовой стрелки, а также точный центр многоугольников, который был результатом исходной точки.

Возвращаемый многоугольник можно использовать для дальнейшей обработки, например Поиск Inside Geometry для поиска объектов pois в предоставленной изохроне.

GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}
With optional parameters: 
GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}&fuelBudgetInLiters={fuelBudgetInLiters}&energyBudgetInkWh={energyBudgetInkWh}&timeBudgetInSec={timeBudgetInSec}&distanceBudgetInMeters={distanceBudgetInMeters}&departAt={departAt}&routeType={routeType}&traffic={traffic}&avoid={avoid}&travelMode={travelMode}&hilliness={hilliness}&windingness={windingness}&vehicleAxleWeight={vehicleAxleWeight}&vehicleWidth={vehicleWidth}&vehicleHeight={vehicleHeight}&vehicleLength={vehicleLength}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&vehicleCommercial={vehicleCommercial}&vehicleLoadType={vehicleLoadType}&vehicleEngineType={vehicleEngineType}&constantSpeedConsumptionInLitersPerHundredkm={constantSpeedConsumptionInLitersPerHundredkm}&currentFuelInLiters={currentFuelInLiters}&auxiliaryPowerInLitersPerHour={auxiliaryPowerInLitersPerHour}&fuelEnergyDensityInMJoulesPerLiter={fuelEnergyDensityInMJoulesPerLiter}&accelerationEfficiency={accelerationEfficiency}&decelerationEfficiency={decelerationEfficiency}&uphillEfficiency={uphillEfficiency}&downhillEfficiency={downhillEfficiency}&constantSpeedConsumptionInkWhPerHundredkm={constantSpeedConsumptionInkWhPerHundredkm}&currentChargeInkWh={currentChargeInkWh}&maxChargeInkWh={maxChargeInkWh}&auxiliaryPowerInkW={auxiliaryPowerInkW}

Параметры URI

Имя В Обязательно Тип Описание
format
 path True

ResponseFormat

Требуемый формат ответа. Значение может быть либо json , либо xml.
api-version
 query True

string

Номер версии API Azure Maps
query
 query True

number[]

Координата, с которой должно начинаться вычисление диапазона.
accelerationEfficiency
 query

number

double

Указывает эффективность преобразования химической энергии, хранящейся в топливе, в кинетическую энергию при ускорении транспортного средства (т. е. Kinetic EnergyGained/ChemicalЯConsumed). ChemicalИргетикаКонсумед получается путем преобразования израсходованного топлива в химическую энергию с использованием топливаХиденситиInMJoulesPerLiter.

Должен быть связан с замедлениемэффициентности.

Допустимый диапазон значений: от 0,0 до 1/decelerationEfficiency.

Разумные значения: для модели горения : 0,33, для электрической модели : 0,66
auxiliaryPowerInkW
 query

number

double

Указывает объем энергии, потребляемой для поддержки вспомогательных систем, в кВт.

Его можно использовать для указания потребления из-за устройств и систем, таких как системы переменного тока, радио, отопления и т. д.

Разумные значения: 1.7
auxiliaryPowerInLitersPerHour
 query

number

double

Указывает количество топлива, потребляемого для поддержки вспомогательных систем транспортного средства, в литрах в час.

Его можно использовать для указания потребления из-за устройств и систем, таких как системы переменного тока, радио, отопления и т. д.

Разумные значения: 0,2
avoid
 query

RouteAvoidType[]

Указывает то, чего следует избегать при вычислении маршрута. Можно указать несколько раз в одном запросе, например "&avoid=автомагистрали&avoid=tollRoads&avoid=ferries". В запросах диапазона маршрутов не следует использовать значение alreadyUsedRoads.
constantSpeedConsumptionInkWhPerHundredkm
 query

string

Задает зависящий от скорости компонент потребления.

Предоставляется в виде неупорядоченного списка пар "скорость-потребление". Список определяет точки на кривой потребления. Показатели потребления скоростей, отсутствуют в списке, приведены ниже.

  • путем линейной интерполяции, если заданная скорость находится между двумя скоростями в списке

  • путем линейной экстраполяции, в противном случае при условии, что константу (ΔConsumption/ΔSpeed) определяется ближайшими двумя точками в списке.

Список должен содержать от 1 до 25 пунктов (включительно) и не может содержать повторяющиеся точки для одной и той же скорости. Если он содержит только одну точку, то коэффициент потребления этой точки используется без дальнейшей обработки.

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

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

Допустимый диапазон значений потребления (выраженных в кВт*ч/100 км) составляет от 0,01 до 100 0000,0.

Разумные значения: 50,8.2:130,21,3

Этот параметр является обязательным для модели потребления электроэнергии.
constantSpeedConsumptionInLitersPerHundredkm
 query

string

Задает зависящий от скорости компонент потребления.

Предоставляется в виде неупорядоченного списка пар скорости с разделителями двоеточием & скорости потребления. Список определяет точки на кривой потребления. Показатели потребления скоростей, отсутствуют в списке, приведены ниже.

  • путем линейной интерполяции, если заданная скорость находится между двумя скоростями в списке

  • путем линейной экстраполяции, в противном случае при условии, что константу (ΔConsumption/ΔSpeed) определяется ближайшими двумя точками в списке.

Список должен содержать от 1 до 25 пунктов (включительно) и не может содержать повторяющиеся точки для одной и той же скорости. Если он содержит только одну точку, то коэффициент потребления этой точки используется без дальнейшей обработки.

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

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

Допустимый диапазон значений потребления (выраженный в l/100km) находится в диапазоне от 0,01 до 100 0000,0.

Разумные значения: 50,6.3:130,11,5

Примечание . Этот параметр является обязательным для модели потребления горения.
currentChargeInkWh
 query

number

double

Указывает текущую подачу электроэнергии в киловатт-ч (кВт*ч).

Этот параметр существует вместе с параметром maxChargeInkWh .

Допустимый диапазон значений : от 0,0 до maxChargeInkWh.

Разумные значения: 43
currentFuelInLiters
 query

number

double

Указывает текущую подачу топлива в литрах.

Разумные значения: 55
decelerationEfficiency
 query

number

double

Указывает эффективность преобразования кинетической энергии в сохраненное (не потребляемое) топливо, когда транспортное средство замедляется (т. е. ChemicalОвечествоSaved/KineticХисло). ChemicalОвещеСохранение получается путем преобразования сохраненного (не потребляемого) топлива в энергию с помощью fuelОведенситиInMJoulesPerLiter.

Должен быть связан с ускорениемЭффектиентность.

Допустимый диапазон значений — от 0,0 до 1/accelerationEfficiency.

Разумные значения: для модели горения : 0,83, для электрической модели : 0,91
departAt
 query

string

date-time

Дата и время отправления от исходной точки, отформатированные в виде dateTime значения, определенного в rfc 3339, раздел 5.6, с необязательным смещением часового пояса. Если смещение часового пояса не указано, оно будет считаться смещением исходной точки.

  • Значение по умолчанию: now
  • Другое значение: dateTime

Примеры:

  • 12.2023.19T16:39:57
  • 12.2023. 19T16:39:57-08:00

Параметр departAt нельзя использовать в сочетании с arriveAt.
distanceBudgetInMeters
 query

number

double

Бюджет расстояния в метрах, определяющий максимальный диапазон, который можно преодолеть с помощью расстояния. Модель потребления влияет на диапазон только в том случае, если параметр routeType имеет значение eco.
Необходимо использовать ровно один бюджет (fuel BudgetInLiters, energyBudgetInkWh, timeBudgetInSec или distanceBudgetInMeters).
downhillEfficiency
 query

number

double

Указывает эффективность преобразования потенциальной энергии в сохраненное (не потребленное) топливо, когда транспортное средство теряет высоту (т. е. ChemicalХергетикаSaved/PotentialЯЛост). ChemicalОвещеСохранение получается путем преобразования сохраненного (не потребляемого) топлива в энергию с помощью fuelОведенситиInMJoulesPerLiter.

Должен быть связан с uphillEfficiency.

Допустимый диапазон значений: от 0,0 до 1/uphillEfficiency.

Разумные значения: для модели горения : 0,51, для электрической модели : 0,73
energyBudgetInkWh
 query

number

double

Бюджет электроэнергии в киловатт-часах (кВт-ч), определяющий максимальный диапазон, который может быть пройден с помощью указанной модели потребления электроэнергии.
При использовании energyBudgetInkWh необходимо указать подробную модель потребления электроэнергии.
Необходимо использовать ровно один бюджет (fuel BudgetInLiters, energyBudgetInkWh, timeBudgetInSec или distanceBudgetInMeters).
fuelBudgetInLiters
 query

number

double

Бюджет топлива в литрах, определяющий максимальный диапазон, который может быть пройден с помощью указанной модели потребления сгорания.
При использовании fuelBudgetInLiters необходимо указать подробную модель потребления горения.
Необходимо использовать ровно один бюджет (fuel BudgetInLiters, energyBudgetInkWh, timeBudgetInSec или distanceBudgetInMeters).
fuelEnergyDensityInMJoulesPerLiter
 query

number

double

Указывает количество химической энергии, хранящейся в одном литре топлива в мегаджоулях (MJ). Он используется в сочетании с параметрами *Efficiency для преобразований между сэкономленной или потребляемой энергией и топливом. Например, плотность энергии составляет 34,2 МДж/л для бензина и 35,8 МДж/л для дизельного топлива.

Этот параметр является обязательным, если задан любой параметр *Efficiency .

Разумные значения: 34.2
hilliness
 query

InclineLevel

Степень холмистости для захватывающего маршрута. Этот параметр можно использовать только в сочетании с routeType=thrilling.
maxChargeInkWh
 query

number

double

Указывает максимальный объем электроэнергии в киловатт-часах (кВт*ч), который может храниться в аккумуляторе транспортного средства.

Этот параметр существует вместе с параметром currentChargeInkWh .

Минимальное значение должно быть больше или равно currentChargeInkWh.

Разумные значения: 85
routeType
 query

RouteType

Тип запрошенного маршрута.
timeBudgetInSec
 query

number

double

Бюджет времени в секундах, определяющий максимальный диапазон, который можно путешествовать, используя время вождения. Модель потребления влияет на диапазон только в том случае, если параметр routeType имеет значение eco.
Необходимо использовать ровно один бюджет (fuel BudgetInLiters, energyBudgetInkWh, timeBudgetInSec или distanceBudgetInMeters).
traffic
 query

boolean

Возможные значения:

  • true — учитывайте все доступные сведения о трафике во время маршрутизации.
  • false — игнорировать текущие данные трафика во время маршрутизации. Обратите внимание, что, хотя текущие данные о дорожном движении игнорируются во время маршрутизации, влияние исторического трафика на эффективную скорость дорожного движения по-прежнему учитывается.
travelMode
 query

TravelMode

Режим перемещения для запрошенного маршрута. Если значение не определено, по умолчанию используется значение "car". Обратите внимание, что запрошенный travelMode может быть недоступен для всего маршрута. Если запрошенный travelMode недоступен для определенного раздела, элемент travelMode ответа для этого раздела будет "other". Обратите внимание, что режимы поездки автобус, мотоцикл, такси и фургон являются бета-функциями. Полные данные об ограничениях доступны не во всех областях.
uphillEfficiency
 query

number

double

Указывает эффективность преобразования химической энергии, хранящейся в топливе, в потенциальную энергию, когда транспортное средство получает высоту (т. е. PotentialЯGained/ChemicalЯConsumed). ChemicalИргетикаКонсумед получается путем преобразования израсходованного топлива в химическую энергию с использованием топливаХиденситиInMJoulesPerLiter.

Должен быть связан с downhillEfficiency.

Допустимый диапазон значений: от 0,0 до 1/downhillEfficiency.

Разумные значения: для модели горения : 0,27, для электрической модели : 0,74
vehicleAxleWeight
 query

integer

Вес на ось транспортного средства в кг. Значение 0 означает, что ограничения по весу на ось не учитываются.
vehicleCommercial
 query

boolean

Используется ли транспортное средство в коммерческих целях. Коммерческим транспортным средствам может быть запрещено ездить по некоторым дорогам.
vehicleEngineType
 query

VehicleEngineType

Тип двигателя транспортного средства. Если указана подробная модель потребления, она должна соответствовать значению vehicleEngineType.
vehicleHeight
 query

number

double

Высота транспортного средства в метрах. Значение 0 означает, что ограничения по высоте не учитываются.
vehicleLength
 query

number

double

Длина транспортного средства в метрах. Значение 0 означает, что ограничения длины не учитываются.
vehicleLoadType
 query

VehicleLoadType

Типы грузов, которые могут быть классифицированы как опасные материалы и запрещены с некоторых дорог. Доступные значения vehicleLoadType — это классы 1–9 US Hazmat, а также универсальные классификации для использования в других странах или регионах. Значения, начинающиеся с USHazmat, предназначены для маршрутизации в США, тогда как otherHazmat следует использовать для всех остальных стран и регионов. vehicleLoadType можно указать несколько раз. В настоящее время этот параметр учитывается только для travelMode=truck.
vehicleMaxSpeed
 query

integer

Максимальная скорость транспортного средства в км/час. Максимальная скорость в профиле транспортного средства используется для проверка, разрешено ли транспортное средство на автомагистралях.

  • Значение 0 означает, что при планировании маршрута будет определено и применено соответствующее значение для транспортного средства.

  • Ненулевое значение может быть переопределено во время планирования маршрута. Например, текущий поток трафика составляет 60 км/ч. Если максимальная скорость автомобиля установлена в 50 км/ч, то двигатель маршрутизации будет учитывать 60 км/ч, так как это текущая ситуация. Если максимальная скорость транспортного средства составляет 80 км/ч, но текущий поток движения составляет 60 км/час, то подсистема маршрутизации снова будет использовать 60 км/час.
vehicleWeight
 query

integer

Вес транспортного средства в килограммах.

  • Это обязательно, если задан какой-либо из параметров *Эффективности.

  • Он должен быть строго положительным при использовании в контексте модели потребления. Учитываются ограничения веса.

  • Если подробная модель потребления не указана и значение vehicleWeight не равно нулю, учитываются ограничения по весу.

  • Во всех остальных случаях этот параметр игнорируется.

Разумные значения: для модели горения : 1600, для электрической модели : 1900
vehicleWidth
 query

number

double

Ширина транспортного средства в метрах. Значение 0 означает, что ограничения ширины не учитываются.
windingness
 query

WindingnessLevel

Уровень поворотов для захватывающего маршрута. Этот параметр можно использовать только в сочетании с routeType=thrilling.

Заголовок запроса

Имя Обязательно Тип Описание
x-ms-client-id

string

Указывает, какая учетная запись предназначена для использования в сочетании с моделью безопасности Microsoft Entra ID. Он представляет уникальный идентификатор учетной записи Azure Maps и может быть получен из API учетной записи уровня управления Azure Maps. Инструкции по использованию Microsoft Entra ID безопасности в Azure Maps см. в следующих статьях.

Ответы

Имя Тип Описание
200 OK

RouteRangeResult

ОК
Other Status Codes

ErrorResponse

Произошла непредвиденная ошибка.

Безопасность

AADToken

Это Microsoft Entra потоков OAuth 2.0. При связывании с управлением доступом на основе ролей Azure его можно использовать для управления доступом к Azure Maps REST API. Элементы управления доступом на основе ролей Azure используются для назначения доступа к одной или нескольким учетным записям Azure Maps ресурсов или вложенным ресурсам. Любому пользователю, группе или субъекту-службе можно предоставить доступ через встроенную роль или пользовательскую роль, состоящую из одного или нескольких разрешений на Azure Maps REST API.

Для реализации сценариев рекомендуется ознакомиться с основными понятиями проверки подлинности. Таким образом, это определение безопасности предоставляет решение для моделирования приложений с помощью объектов, способных управлять доступом к определенным API и областям.

Примечания

  • Это определение безопасности требует использования заголовкаx-ms-client-id, чтобы указать, к какому Azure Maps ресурсу приложение запрашивает доступ. Его можно получить из API управления Картами.

Объект Authorization URL предназначен для экземпляра общедоступного облака Azure. Национальные облака имеют уникальные URL-адреса авторизации и конфигурации Microsoft Entra ID. * Управление доступом на основе ролей Azure настраивается из плоскости управления Azure с помощью портал Azure, PowerShell, CLI, пакетов SDK для Azure или REST API. * Использование веб-пакета SDK для Azure Maps позволяет настраивать приложение на основе конфигурации для нескольких вариантов использования.

  • Дополнительные сведения о платформа удостоверений Майкрософт см. в платформа удостоверений Майкрософт обзоре.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Имя Описание
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

Это общий ключ, который подготавливается при Create учетной записи Azure Maps в портал Azure или с помощью PowerShell, CLI, пакетов SDK для Azure или REST API.

С помощью этого ключа любое приложение может получить доступ ко всем REST API. Другими словами, этот ключ можно использовать в качестве ключа master в учетной записи, в которую они выдаются.

Для общедоступных приложений мы рекомендуем использовать подход конфиденциальных клиентских приложений для доступа к Azure Maps REST API, чтобы обеспечить безопасное хранение ключа.

Type: apiKey
In: query

SAS Token

Это маркер подписанного URL-адреса, созданный с помощью операции List SAS для ресурса Azure Maps через плоскость управления Azure с помощью портал Azure, PowerShell, CLI, пакетов SDK для Azure или REST API.

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

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

Type: apiKey
In: header

Примеры

Successfully retrieve a set of locations that can be reached from the origin point based on various conditions

Sample Request

GET https://atlas.microsoft.com/route/range/json?api-version=1.0&query=50.97452,5.86605&timeBudgetInSec=6000

Sample Response

Status code:
200 
{
  "formatVersion": "0.0.1",
  "reachableRange": {
    "center": {
      "latitude": 50.9745,
      "longitude": 5.86605
    },
    "boundary": [
      {
        "latitude": 52.03704,
        "longitude": 5.73602
      },
      {
        "latitude": 52.09456,
        "longitude": 5.59435
      },
      {
        "latitude": 52.16815,
        "longitude": 5.42279
      },
      {
        "latitude": 52.25047,
        "longitude": 5.21276
      },
      {
        "latitude": 52.21374,
        "longitude": 5.15355
      },
      {
        "latitude": 52.25674,
        "longitude": 4.96687
      },
      {
        "latitude": 52.07834,
        "longitude": 4.739
      },
      {
        "latitude": 52.05647,
        "longitude": 4.72513
      },
      {
        "latitude": 51.94553,
        "longitude": 4.53237
      },
      {
        "latitude": 51.70119,
        "longitude": 4.31165
      },
      {
        "latitude": 51.5837,
        "longitude": 4.28917
      },
      {
        "latitude": 51.48463,
        "longitude": 3.82685
      },
      {
        "latitude": 51.21096,
        "longitude": 3.62838
      },
      {
        "latitude": 50.6814,
        "longitude": 3.89244
      },
      {
        "latitude": 50.66791,
        "longitude": 3.93493
      },
      {
        "latitude": 50.49042,
        "longitude": 3.98156
      },
      {
        "latitude": 50.30944,
        "longitude": 4.47995
      },
      {
        "latitude": 50.24448,
        "longitude": 4.60502
      },
      {
        "latitude": 50.24467,
        "longitude": 4.89999
      },
      {
        "latitude": 50.08735,
        "longitude": 5.04206
      },
      {
        "latitude": 49.99214,
        "longitude": 5.23042
      },
      {
        "latitude": 49.88478,
        "longitude": 5.40994
      },
      {
        "latitude": 49.85797,
        "longitude": 5.46178
      },
      {
        "latitude": 49.86279,
        "longitude": 5.7196
      },
      {
        "latitude": 49.83259,
        "longitude": 5.74151
      },
      {
        "latitude": 50.22239,
        "longitude": 5.9387
      },
      {
        "latitude": 50.0011,
        "longitude": 6.08535
      },
      {
        "latitude": 50.04616,
        "longitude": 6.12089
      },
      {
        "latitude": 50.09472,
        "longitude": 6.28373
      },
      {
        "latitude": 49.95863,
        "longitude": 6.51654
      },
      {
        "latitude": 50.00485,
        "longitude": 6.61034
      },
      {
        "latitude": 50.00587,
        "longitude": 6.70295
      },
      {
        "latitude": 50.2947,
        "longitude": 6.65865
      },
      {
        "latitude": 50.36903,
        "longitude": 6.79276
      },
      {
        "latitude": 50.31614,
        "longitude": 7.32163
      },
      {
        "latitude": 50.36737,
        "longitude": 7.58782
      },
      {
        "latitude": 50.46919,
        "longitude": 7.7626
      },
      {
        "latitude": 50.96246,
        "longitude": 7.9826
      },
      {
        "latitude": 51.07086,
        "longitude": 7.55924
      },
      {
        "latitude": 51.36614,
        "longitude": 7.58138
      },
      {
        "latitude": 51.52015,
        "longitude": 7.67861
      },
      {
        "latitude": 51.65781,
        "longitude": 7.35175
      },
      {
        "latitude": 51.81916,
        "longitude": 7.21664
      },
      {
        "latitude": 51.9587,
        "longitude": 7.0467
      },
      {
        "latitude": 51.82713,
        "longitude": 6.67267
      },
      {
        "latitude": 51.81133,
        "longitude": 6.48424
      },
      {
        "latitude": 51.9368,
        "longitude": 6.27316
      },
      {
        "latitude": 52.01701,
        "longitude": 6.14452
      },
      {
        "latitude": 52.20847,
        "longitude": 6.09312
      },
      {
        "latitude": 52.23705,
        "longitude": 6.01297
      }
    ]
  }
}

Определения

Имя Описание
EffectiveSetting

Действующий параметр или данные, используемые при вызове этого API маршрута.
ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail

Сведения об ошибке.
ErrorResponse

Сообщение об ошибке
InclineLevel

Степень холмистости для захватывающего маршрута. Этот параметр можно использовать только в сочетании с routeType=thrilling.
LatLongPair

Расположение, представленное в виде широты и долготы.
ResponseFormat

Требуемый формат ответа. Значение может быть либо json , либо xml.
RouteAvoidType

Указывает то, чего следует избегать при вычислении маршрута. Можно указать несколько раз в одном запросе, например "&avoid=автомагистрали&avoid=tollRoads&avoid=ferries". В запросах диапазона маршрутов не следует использовать значение alreadyUsedRoads.
RouteRange

Доступный диапазон
RouteRangeResult

Этот объект возвращается из успешного вызова Route Reachable Range
RouteReport

Сообщает действующие параметры, используемые в текущем вызове.
RouteType

Тип запрошенного маршрута.
TravelMode

Режим перемещения для запрошенного маршрута. Если значение не определено, по умолчанию используется значение "car". Обратите внимание, что запрошенный travelMode может быть недоступен для всего маршрута. Если запрошенный travelMode недоступен для определенного раздела, элемент travelMode ответа для этого раздела будет "other". Обратите внимание, что режимы поездки автобус, мотоцикл, такси и фургон являются бета-функциями. Полные данные об ограничениях доступны не во всех областях.
VehicleEngineType

Тип двигателя транспортного средства. Если указана подробная модель потребления, она должна соответствовать значению vehicleEngineType.
VehicleLoadType

Типы грузов, которые могут быть классифицированы как опасные материалы и запрещены с некоторых дорог. Доступные значения vehicleLoadType — это классы 1–9 US Hazmat, а также универсальные классификации для использования в других странах или регионах. Значения, начинающиеся с USHazmat, предназначены для маршрутизации в США, тогда как otherHazmat следует использовать для всех остальных стран и регионов. vehicleLoadType можно указать несколько раз. В настоящее время этот параметр учитывается только для travelMode=truck.
WindingnessLevel

Уровень поворотов для захватывающего маршрута. Этот параметр можно использовать только в сочетании с routeType=thrilling.

EffectiveSetting

Действующий параметр или данные, используемые при вызове этого API маршрута.

Имя Тип Описание
key

string

Имя используемого параметра.
value

string

Значение используемого параметра.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.
type

string

Тип дополнительных сведений.

ErrorDetail

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.
code

string

Код ошибки.
details

ErrorDetail[]

Сведения об ошибке.
message

string

Сообщение об ошибке.
target

string

Целевой объект ошибки.

ErrorResponse

Сообщение об ошибке

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

InclineLevel

Степень холмистости для захватывающего маршрута. Этот параметр можно использовать только в сочетании с routeType=thrilling.

Имя Тип Описание
high

string

high
low

string

low
normal

string

нормальный

LatLongPair

Расположение, представленное в виде широты и долготы.

Имя Тип Описание
latitude

number

Свойство Latitude
longitude

number

Свойство Долгота

ResponseFormat

Требуемый формат ответа. Значение может быть либо json , либо xml.

Имя Тип Описание
json

string

Формат обмена данными нотации объектов JavaScript
xml

string

Расширяемый язык разметки

RouteAvoidType

Указывает то, чего следует избегать при вычислении маршрута. Можно указать несколько раз в одном запросе, например "&avoid=автомагистрали&avoid=tollRoads&avoid=ferries". В запросах диапазона маршрутов не следует использовать значение alreadyUsedRoads.

Имя Тип Описание
alreadyUsedRoads

string

Избегает использования одной и той же дороги несколько раз. Наиболее полезно в сочетании с routeType=захватывающее.
borderCrossings

string

Позволяет избежать пересечений границы при расчете маршрута.
carpools

string

Избегает маршрутов, требующих использования карпуля (HOV/High Заполнение транспортного средства) полосы движения.
ferries

string

Избегает паромов
motorways

string

Избегает автомагистралей
tollRoads

string

Избегает платных дорог.
unpavedRoads

string

Избегает грунтовых дорог

RouteRange

Доступный диапазон

Имя Тип Описание
boundary

LatLongPair[]

Граница многоугольников достижимого диапазона, представленная в виде списка точек.
center

LatLongPair

Центральная точка доступного диапазона

RouteRangeResult

Этот объект возвращается из успешного вызова Route Reachable Range

Имя Тип Описание
formatVersion

string

Свойство Format Version
reachableRange

RouteRange

Доступный диапазон
report

RouteReport

Сообщает действующие параметры, используемые в текущем вызове.

RouteReport

Сообщает действующие параметры, используемые в текущем вызове.

Имя Тип Описание
effectiveSettings

EffectiveSetting[]

Действующие параметры или данные, используемые при вызове этого API маршрута.

RouteType

Тип запрошенного маршрута.

Имя Тип Описание
eco

string

Маршрут, сбалансированный по экономике и скорости.
fastest

string

Самый быстрый маршрут.
shortest

string

Самый короткий маршрут по расстоянию.
thrilling

string

Включает интересные или сложные дороги и использует как можно меньше автомагистралей. Вы можете выбрать уровень включенных поворотов, а также степень холмистости. Сведения о настройке см. в разделе Параметры холмистости и обмотки. Существует ограничение в 900 км на маршрутах, запланированных с routeType=захватывающее

TravelMode

Режим перемещения для запрошенного маршрута. Если значение не определено, по умолчанию используется значение "car". Обратите внимание, что запрошенный travelMode может быть недоступен для всего маршрута. Если запрошенный travelMode недоступен для определенного раздела, элемент travelMode ответа для этого раздела будет "other". Обратите внимание, что режимы поездки автобус, мотоцикл, такси и фургон являются бета-функциями. Полные данные об ограничениях доступны не во всех областях.

Имя Тип Описание
bus

string

Возвращаемые маршруты оптимизированы для автобусов, включая использование только автобусных полос. Функции БЕТА-версии.
car

string

Возвращаемые маршруты оптимизированы для автомобилей.
motorcycle

string

Возвращаемые маршруты оптимизированы для мотоциклов. Функции БЕТА-версии.
taxi

string

Возвращаемые маршруты оптимизированы для такси. Функции БЕТА-версии.
truck

string

Возвращаемые маршруты оптимизированы для коммерческих транспортных средств, например для грузовиков.
van

string

Возвращаемые маршруты оптимизированы для фургонов. Функции БЕТА-версии.

VehicleEngineType

Тип двигателя транспортного средства. Если указана подробная модель потребления, она должна соответствовать значению vehicleEngineType.

Имя Тип Описание
combustion

string

Двигатель внутреннего сгорания.
electric

string

Электрический двигатель.

VehicleLoadType

Типы грузов, которые могут быть классифицированы как опасные материалы и запрещены с некоторых дорог. Доступные значения vehicleLoadType — это классы 1–9 US Hazmat, а также универсальные классификации для использования в других странах или регионах. Значения, начинающиеся с USHazmat, предназначены для маршрутизации в США, тогда как otherHazmat следует использовать для всех остальных стран и регионов. vehicleLoadType можно указать несколько раз. В настоящее время этот параметр учитывается только для travelMode=truck.

Имя Тип Описание
USHazmatClass1

string

Взрывоопасные вещества
USHazmatClass2

string

Сжатый газ
USHazmatClass3

string

Легковоспламеняемые жидкости
USHazmatClass4

string

Легковоспламеняемые твердые вещества
USHazmatClass5

string

Окислители
USHazmatClass6

string

Яды
USHazmatClass7

string

Радиоактивные вещества
USHazmatClass8

string

Коррозионные средства
USHazmatClass9

string

Прочее
otherHazmatExplosive

string

Взрывоопасные вещества
otherHazmatGeneral

string

Прочее
otherHazmatHarmfulToWater

string

Вредно для воды

WindingnessLevel

Уровень поворотов для захватывающего маршрута. Этот параметр можно использовать только в сочетании с routeType=thrilling.

Имя Тип Описание
high

string

high
low

string

low
normal

string

нормальный