Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
В этой статье объясняется, как перенести API Вычисление маршрута Bing Maps в API Маршруты и направления Azure Maps. Маршруты Azure Maps — это API, который возвращает оптимальный маршрут между началом и назначением для автомобилей, грузовиков и пешеходов. Маршрут рассматривает такие факторы, как текущий трафик и типичные скорости дорожного движения в запрошенный день недели и времени дня.
Предпосылки
- Учетная запись Azure
- Учетная запись Azure Maps
- Ключ подписки или другая форма проверки подлинности с помощью Azure Maps
Заметные различия
- Bing Maps Calculate a Route API поддерживает запрос GET. API маршрутов Azure Maps поддерживает запрос POST.
- Bing Maps Вычисляет API маршрутов, поддерживает формат ответа XML и JSON. API маршрутов Azure Maps поддерживает формат GeoJSON .
- Bing Maps Calculate a Route API требует точек пути и viaWaypoints в формате широты и долготы, в то время как Azure Maps требует, чтобы они были в формате долготы и широты, как определено в формате GeoJSON.
- Bing Maps Calculate a Route API поддерживает точки пути и viaWaypoints в качестве точек, ориентиров или адресов. API маршрутов Azure Maps поддерживает только точки. Для преобразования ориентира или адреса в точку можно использовать API получения геокодирования Azure Maps.
- Bing Maps Calculate a Route API поддерживает транзитную маршрутизацию. API маршрутов Azure Maps не поддерживается.
- В отличие от карт Bing для предприятия, Azure Maps — это глобальная служба, которая поддерживает указание географической области, что позволяет ограничить расположение данных в европейских (ЕС) или сша (США) географических областях (геос). Все запросы (включая входные данные) обрабатываются исключительно в указанной географической области. Дополнительные сведения см. в географической области.
Безопасность и проверка подлинности
Карты Bing для enterprise поддерживают только проверку подлинности ключа API. Azure Maps поддерживает несколько способов проверки подлинности вызовов API, таких как ключ подписки, идентификатор Microsoft Entra и маркер общей подписи доступа (SAS). Дополнительные сведения о безопасности и проверке подлинности в Azure Maps см. в разделе "Проверка подлинности с помощью Azure Maps " и раздел "Безопасность " в документации по маршрутам Azure Maps.
Параметры запроса
В следующей таблице перечислены параметры запроса на маршрутизацию карт Bing и эквивалент Azure Maps:
| Параметр запроса Bing Maps | Псевдоним параметра запроса Bing Maps | Параметр запроса Azure Maps | Требуется в Azure Maps | Тип данных Azure Maps | Описание |
|---|---|---|---|---|---|
| избегать | избегать | Неправда | струна | Ниже приведены эквиваленты API для расчета маршрута в Bing Maps, которых следует избегать в API маршрутов Azure Maps, если это поддерживается: платные сборы: tollRoads паром: паромы пересечения границ: пересечения границ minimizeDrivingSideTurn: не поддерживается Минимизация при повороте на сторону движения: не поддерживается minimizeUTurn: не поддерживается minimizeTolls: не поддерживается шоссе: магистрали с ограниченным доступом функция "minimizeHighways": не поддерживается |
|
| дата и время | дата | времяОтправления | Неправда | струна | API маршрутов Azure Maps также поддерживает параметр arriveAt, используемый для указания требуемой даты и времени прибытия. Его нельзя использовать с departAt. |
| расстояниеДоПервогоПоворота | dbft | Не поддерживается | Не поддерживается | Не поддерживается | |
| единица расстояния | ду | Не требуется | Не требуется | Не требуется | В API маршрутов Azure Maps единица расстояния — метр. |
| заголовок | HD | заголовок | Неправда | целое число | |
| маршрутные группы | ig | Не поддерживается | Не поддерживается | ||
| maxSolutions | maxSolns | максимальноеКоличествоМаршрутов | Неправда | Целое число | |
| оптимизировать | optmz | оптимизироватьМаршрут | Неправда | строка | Вот эквиваленты API Bing Maps Calculate a Route для API Azure Maps Route Directions optimizeRoute: время: самый быстрый без пробок времяСПробками: самоеБыстроеСПробками API маршрутов Azure Maps также поддерживает оптимизацию маршрутов по расстоянию, чтобы вернуть самый короткий маршрут, указав самое короткое значение в качестве входного значения optimizeRoute. |
| оптимизироватьПутевыеТочки | optWp | оптимизация порядка путевых точек | Неправда | булевый тип данных | |
| атрибуты маршрута | Ра | настройки маршрута вывода | Неправда | струна | Ниже приведены эквиваленты API расчёта маршрута Bing Maps для параметров вывода маршрута в API построения маршрутов Azure Maps: routePath: routePath сводка путешествий региона: сводка путешествий региона API маршрутов Azure Maps поддерживает больше значений, таких как маршрут и маршрутSummary. Дополнительные сведения см. в разделе RouteOutputOption. |
| routePathOutput | rpo | настройки маршрута вывода | Неправда | струна | API маршрутов Azure Maps поддерживает возврат координат для геометрии пути маршрута путем передачи routeOutputOptions=routePath в запросе. |
| типВремени | tt | Не поддерживается | Не поддерживается | Не поддерживается | API маршрутов Azure Maps не поддерживает транзитную маршрутизацию. |
| Допуски | tl | Не поддерживается | Не поддерживается | Не поддерживается | |
| режим путешествия | режим путешествия | Неправда | строка | Ниже приведены эквиваленты API маршрутов Bing в API маршрутов Azure Maps Route RouteMode: Вождение: вождение Прогулка: ходьба Транзит: не поддерживается Azure Maps поддерживает дополнительный режим путешествия "грузовик" для построения маршрутов для грузовиков. |
|
| viaWaypoint.n | vwp.n | особенности ЭлементХарактеристикТочкиВхода[] |
Верно | GeoJSON-точка | точка пути и viaWaypoint указываются как компоненты, которые являются обязательным параметром. Однако точка пути является единственным обязательным типом pointType, и запрос можно сделать без viaWaypoint. Во встроенном в Карты Bing API расчета маршрутов viaWaypoint может быть точкой, ориентиром или адресом, тогда как в API маршрутов Azure Maps он должен быть только точкой. Для преобразования ориентира или адреса в точку можно использовать API получения геокодирования Azure Maps. Служба API "Карты Bing" требует, чтобы viaWaypoints были в формате широты и долготы, а Azure Maps требует их в формате долготы и широты, как определено в формате GeoJSON. |
| точка пути.n | wp.n | характеристики InputWaypointFeaturesItem[] | Верно | GeoJSON-точка | В API расчета маршрутов Карт Bing путевая точка может быть точкой, ориентиром или адресом, в отличие от API маршрутов Azure Maps, где она должна быть непременно точкой. Для преобразования ориентира или адреса в точку можно использовать API получения геокодирования Azure Maps. Bing Maps Calculate a Route API требует, чтобы точки пути были в формате широты и долготы, в то время как Azure Maps требует, чтобы они были в формате долготы и широты, как определено в формате GeoJSON. |
Дополнительные сведения о параметрах запроса API маршрутов Azure Maps смотрите в разделе Параметры URI.
Примеры запросов
Bing Maps запрос API для расчета маршрута:
http://dev.virtualearth.net/REST/V1/Routes/driving?wp.0=47.610173,-122.204171&wp.1=47.612440,-122.204171key={Your-Bing-Maps-Key}
POST запрос к API направлений маршрута Azure Maps:
https://atlas.microsoft.com/route/directions?api-version=2025-01-01&subscription-key={Your-Azure-Maps-Subscription-key}
Включен в текст запроса:
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"coordinates": [
-122.204171,
47.610173
],
"type": "Point"
},
"properties": {
"pointIndex": 0,
"pointType": "waypoint"
}
},
{
"type": "Feature",
"geometry": {
"coordinates": [
-122.204171,
47.612440
],
"type": "Point"
},
"properties": {
"pointIndex": 1,
"pointType": "Waypoint"
}
}
]
}
Поля ответа
В следующей таблице перечислены поля, которые могут отображаться в ответе HTTP при выполнении запроса Bing Maps на Расчет маршрута и соответствующих полях в Azure Maps.
| Поле "Карты Bing" | Поле Azure Maps | Описание |
|---|---|---|
| фактическое начало | Объект функции point | Объект точечной функции типа “waypoint” и inputIndex = 0 определяет маршрутизируемое начальное местоположение. |
| фактический конец | Объект функции point | Объект функции point с типом="waypoint" и inputIndex = последнее определяет маршрутизируемое расположение конца. |
| alternateVias | альтернативные маршруты | Bing Maps alternateVias определяет отдельные маршруты. В Azure Maps альтернативные маршруты возвращаются в качестве новой коллекции функций в альтернативных маршрутах. |
| градусы компаса | градусы компаса | |
| направление компаса | направление компаса | |
| описание | Не поддерживается | |
| подробности | свойства | Свойства функции объекта содержат информацию о манёвре. |
| единица расстояния | Неприменимо | API маршрутов Azure Maps возвращает расстояние в метрах. |
| единица времени | Неприменимо | API маршрутов Azure Maps возвращает длительность в секундах. |
| ИндексыКонечныхПутей | диапазон | Azure Maps возвращает начальный и конечный индекс, охватываемый определенной частью маршрута в виде диапазона. |
| endWaypoint | Не поддерживается | В ответе API маршрутов Azure Maps точка endWaypoint может быть получена из type="waypoint" и inputIndex = последний индекс |
| форматированный текст | форматированный текст | |
| Подсказки | Не поддерживается | |
| тип подсказки | Не поддерживается | |
| тип значка | Не поддерживается | API вычислений маршрутов карт Bing указывает тип значка для представления режима перемещения в пользовательских приложениях. Например, если маршрут вождения имеет частичный паромный маршрут, значок можно использовать для визуального определения различных режимов движения в маршруте. API вычислений маршрута Azure Maps не поддерживает iconType, однако режим путешествия можно получить из свойства travelMode в ответе. |
| инструкция | Инструкция | |
| isRealTimeTransit | Не поддерживается | |
| isVia | viaWaypoint | В ответе API маршрутов Azure Maps точка пути возвращается как "тип": "ViaWaypoint" |
| коды местоположений | Не поддерживается | |
| идентификатор местоположения | Не поддерживается | |
| точка маневра | точка маневра | В Azure Maps используется type=точка_маневра для объектов, в которых требуется маневр. В Bing Maps API расчета маршрута точка маневра представлена в формате широта/долгота, а в Azure Maps - в формате долгота/широта, как определено в формате GeoJSON. |
| тип маневра | тип маневра | |
| режим | Не поддерживается | |
| Имена | Имена | |
| задержка транзита в реальном времени | Не поддерживается | |
| тип дороги | тип дороги | |
| ИндексПутиМаршрута | точка маршрута | |
| routeSubLegs | подкатегория ног | |
| sideOfStreet | sideOfStreet | |
| начальные индексы пути | диапазон | Azure Maps возвращает начальный и конечный индекс, охватываемый определенной частью маршрута в виде диапазона. |
| начальнаяТочкаМаршрута | Не поддерживается | В ответе API маршрутизации маршрутов Azure Maps начальная точка может быть получена из type="waypoint" и inputIndex = первый индекс |
| в сторону RoadName | в сторону RoadName | |
| дорожные заторы | дорожные заторы | |
| использованные данные трафика | использованные данные трафика | |
| расстояние поездки | расстояниеВМетрах | |
| Длительность поездки | длительность в секундах | |
| продолжительность поездки с учетом трафика | длительностьТрафикаВСекундах | |
| режим путешествия | режим путешествия |
Дополнительные сведения о полях ответов API маршрутов Azure Maps см. в разделе "Определения".
Примеры ответов
В следующем примере JSON показано, что возвращается в тексте HTTP-ответа при выполнении запроса Рассчитать маршрут на картах Bing.
{
"authenticationResultCode": "ValidCredentials",
"brandLogoUri": "https://dev.virtualearth.net/Branding/logo_powered_by.png",
"copyright": "Copyright © 2024 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.",
"resourceSets": [
{
"estimatedTotal": 1,
"resources": [
{
"__type": "Route:http://schemas.microsoft.com/search/local/ws/rest/v1",
"bbox": [
47.610173,
-122.204193,
47.611674,
-122.203012
],
"id": "v70,h570425388,i0,a0,cen-US,dAAAAAAAAAAA1,y0,s1,m1,o1,t4,wfPMbJhrOR0Cq8j0jEY1ewA2~AF2UnBAtW6QAAADgAQAAAAAA0~MTAybmQgQXZlIE5F0~~~~~~~~v12,wkWEVb2TOR0Cq8j0jEY1ewA2~AF2UnBAdU6QAAADgAQAAgD8A0~MTAzcmQgQXZlIE5F0~~~~~~~~v12,k1,pZ3NpLXBvaQ2-VHJ1ZQ2,pWC1GRC1GTElHSFQ1-Z3NpLXBvaQ2,p-,p-,p-",
"distanceUnit": "Kilometer",
"durationUnit": "Second",
"routeLegs": [
{
"actualEnd": {
"type": "Point",
"coordinates": [
47.611674,
-122.203084
]
},
"actualStart": {
"type": "Point",
"coordinates": [
47.610173,
-122.20414
]
},
"alternateVias": [],
"description": "102nd Ave NE, NE 1st St",
"endTime": "/Date(1713305954789-0700)/",
"itineraryItems": [
{
"compassDirection": "north",
"details": [
{
"compassDegrees": 356,
"endPathIndices": [
1
],
"maneuverType": "DepartStart",
"mode": "Driving",
"names": [
"102nd Ave NE"
],
"roadType": "Street",
"startPathIndices": [
0
]
}
],
"exit": "",
"iconType": "Auto",
"instruction": {
"formattedText": null,
"maneuverType": "DepartStart",
"text": "Head north on 102nd Ave NE toward NE 1st Pl"
},
"isRealTimeTransit": false,
"maneuverPoint": {
"type": "Point",
"coordinates": [
47.610173,
-122.20414
]
},
"realTimeTransitDelay": 0,
"sideOfStreet": "Unknown",
"tollZone": "",
"towardsRoadName": "NE 1st Pl",
"transitTerminus": "",
"travelDistance": 0.114,
"travelDuration": 36,
"travelMode": "Driving"
},
{
"compassDirection": "east",
"details": [
{
"compassDegrees": 89,
"endPathIndices": [
4
],
"maneuverType": "TurnRight",
"mode": "Driving",
"names": [
"NE 1st St"
],
"roadType": "Street",
"startPathIndices": [
1
]
}
],
"exit": "",
"iconType": "Auto",
"instruction": {
"formattedText": null,
"maneuverType": "TurnRight",
"text": "Turn right onto NE 1st St"
},
"isRealTimeTransit": false,
"maneuverPoint": {
"type": "Point",
"coordinates": [
47.611206,
-122.204193
]
},
"realTimeTransitDelay": 0,
"sideOfStreet": "Unknown",
"tollZone": "",
"transitTerminus": "",
"travelDistance": 0.106,
"travelDuration": 22,
"travelMode": "Driving"
},
{
"compassDirection": "northwest",
"details": [
{
"compassDegrees": 302,
"endPathIndices": [
5
],
"maneuverType": "TurnLeft",
"mode": "Driving",
"names": [
"103rd Ave NE"
],
"roadType": "Street",
"startPathIndices": [
4
]
}
],
"exit": "",
"iconType": "Auto",
"instruction": {
"formattedText": null,
"maneuverType": "TurnLeft",
"text": "Turn left onto 103rd Ave NE"
},
"isRealTimeTransit": false,
"maneuverPoint": {
"type": "Point",
"coordinates": [
47.611629,
-122.203012
]
},
"realTimeTransitDelay": 0,
"sideOfStreet": "Unknown",
"tollZone": "",
"transitTerminus": "",
"travelDistance": 0.007,
"travelDuration": 21,
"travelMode": "Driving"
},
{
"compassDirection": "northwest",
"details": [
{
"compassDegrees": 302,
"endPathIndices": [
5
],
"maneuverType": "ArriveFinish",
"mode": "Driving",
"names": [
"103rd Ave NE"
],
"roadType": "Street",
"startPathIndices": [
5
]
}
],
"exit": "",
"hints": [
{
"hintType": "PreviousIntersection",
"text": "The last intersection before your destination is NE 2nd St"
}
],
"iconType": "Auto",
"instruction": {
"formattedText": null,
"maneuverType": "ArriveFinish",
"text": "Arrive at 103rd Ave NE"
},
"isRealTimeTransit": false,
"maneuverPoint": {
"type": "Point",
"coordinates": [
47.611674,
-122.203084
]
},
"realTimeTransitDelay": 0,
"sideOfStreet": "Unknown",
"tollZone": "",
"transitTerminus": "",
"travelDistance": 0,
"travelDuration": 0,
"travelMode": "Driving"
}
],
"routeRegion": "WWMX",
"routeSubLegs": [
{
"endWaypoint": {
"type": "Point",
"coordinates": [
47.611674,
-122.203084
],
"description": "103rd Ave NE",
"isVia": false,
"locationIdentifier": "0|93|148|156|16|29|83|164|0|0|0|224|1|0|0|128|63|0|47.611674,-122.203084",
"routePathIndex": 5
},
"startWaypoint": {
"type": "Point",
"coordinates": [
47.610173,
-122.20414
],
"description": "102nd Ave NE",
"isVia": false,
"locationIdentifier": "0|93|148|156|16|45|91|164|0|0|0|224|1|0|0|0|0|0|47.610173,-122.20414",
"routePathIndex": 0
},
"travelDistance": 0.227,
"travelDuration": 80
}
],
"startTime": "/Date(1713305874789-0700)/",
"travelDistance": 0.227,
"travelDuration": 80,
"travelMode": "Driving"
}
],
"trafficCongestion": "None",
"trafficDataUsed": "None",
"travelDistance": 0.227,
"travelDuration": 80,
"travelDurationTraffic": 71,
"travelMode": "Driving"
}
]
}
],
"statusCode": 200,
"statusDescription": "OK",
"traceId": "47969a89fd7bc08f1a922bf92f4a7541|MWH0032B15|0.0.0.0|MWH0031C9B, Leg0-MWH0031C8C"
}
В следующем примере JSON показано, что возвращаемое в теле HTTP-ответа при выполнении запроса Get Map Tile к Azure Maps:
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
-122.20414,
47.610173
]
},
"properties": {
"durationInSeconds": 36,
"distanceInMeters": 114.00,
"exitIdentifier": "",
"signs": [],
"instruction": {
"formattedText": "<Action>Head</Action> <CmpsDir>north</CmpsDir> on <RoadName>102nd Ave NE</RoadName> toward <Toward>NE 1st Pl</Toward>",
"maneuverType": "DepartStart",
"text": "Head north on 102nd Ave NE toward NE 1st Pl"
},
"towardsRoadName": "NE 1st Pl",
"routePathPoint": {
"legIndex": 0,
"pointIndex": 0
},
"compassDirection": "north",
"travelMode": "driving",
"steps": [
{
"maneuverType": "DepartStart",
"routePathRange": {
"legIndex": 0,
"range": [
0,
1
]
},
"names": [
"102nd Ave NE"
],
"compassDegrees": 356.00,
"roadType": "Street"
}
],
"type": "ManeuverPoint"
}
},
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
-122.204193,
47.611206
]
},
"properties": {
"durationInSeconds": 22,
"distanceInMeters": 106.00,
"exitIdentifier": "",
"signs": [],
"instruction": {
"formattedText": "<Action>Turn</Action> <TurnDir>right</TurnDir> onto <RoadName>NE 1st St</RoadName>",
"maneuverType": "TurnRight",
"text": "Turn right onto NE 1st St"
},
"routePathPoint": {
"legIndex": 0,
"pointIndex": 1
},
"compassDirection": "east",
"travelMode": "driving",
"steps": [
{
"maneuverType": "TurnRight",
"routePathRange": {
"legIndex": 0,
"range": [
1,
4
]
},
"names": [
"NE 1st St"
],
"compassDegrees": 89.00,
"roadType": "Street"
}
],
"type": "ManeuverPoint"
}
},
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
-122.203012,
47.611629
]
},
"properties": {
"durationInSeconds": 21,
"distanceInMeters": 7.00,
"exitIdentifier": "",
"signs": [],
"instruction": {
"formattedText": "<Action>Turn</Action> <TurnDir>left</TurnDir> onto <RoadName>103rd Ave NE</RoadName>",
"maneuverType": "TurnLeft",
"text": "Turn left onto 103rd Ave NE"
},
"routePathPoint": {
"legIndex": 0,
"pointIndex": 4
},
"compassDirection": "northwest",
"travelMode": "driving",
"steps": [
{
"maneuverType": "TurnLeft",
"routePathRange": {
"legIndex": 0,
"range": [
4,
5
]
},
"names": [
"103rd Ave NE"
],
"compassDegrees": 302.00,
"roadType": "Street"
}
],
"type": "ManeuverPoint"
}
},
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
-122.203084,
47.611674
]
},
"properties": {
"durationInSeconds": 0,
"distanceInMeters": 0.00,
"exitIdentifier": "",
"signs": [],
"instruction": {
"formattedText": "<Action>Arrive</Action> at <WaypointName>103rd Ave NE</WaypointName>",
"maneuverType": "ArriveFinish",
"text": "Arrive at 103rd Ave NE"
},
"routePathPoint": {
"legIndex": 0,
"pointIndex": 5
},
"compassDirection": "northwest",
"travelMode": "driving",
"steps": [
{
"maneuverType": "ArriveFinish",
"routePathRange": {
"legIndex": 0,
"range": [
5,
5
]
},
"names": [
"103rd Ave NE"
],
"compassDegrees": 302.00,
"roadType": "Street"
}
],
"type": "ManeuverPoint"
}
},
{
"type": "Feature",
"geometry": {
"type": "MultiLineString",
"coordinates": []
},
"properties": {
"resourceId": "v70,h570425388,i0,a0,cen-US,dAAAAAAAAAAA1,y0,s1,m1,o1,t0,wfPMbJhrOR0Cq8j0jEY1ewA2~~~~~~~~~~v12,wkWEVb2TOR0Cq8j0jEY1ewA2~~~~~~~~~~v12,k1,qatt:1",
"trafficCongestion": "Mild",
"trafficDataUsed": "None",
"distanceInMeters": 227.00,
"durationInSeconds": 80,
"departureTime": "2024-04-16T22:22:27+00:00",
"arrivalTime": "2024-04-16T22:23:47+00:00",
"type": "RoutePath",
"legs": []
}
}
]
}
Использование транзакций
Как и API вычисления маршрутов Bing Maps, API направления маршрутов Azure Maps регистрирует одну оплачиваемую транзакцию для каждого запроса API. Дополнительные сведения о транзакциях Azure Maps см. в статье "Основные сведения о транзакциях Azure Maps".
Дополнительные сведения
- Post Directions Batch: используется для отправки пакета запросов в API маршрутов Directions одним синхронным запросом.
Поддержка