Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este artigo explica como migrar a API Calcular uma Rota do Bing Mapas para a API Direções de Rotas do Azure Mapas. O Azure Mapas Route Directions é uma API que retorna a rota ideal entre uma origem e um destino para automóveis (condução), caminhões comerciais e rotas a pé. A rota considera fatores como o tráfego atual e as velocidades típicas da estrada no dia solicitado da semana e hora do dia.
Pré-requisitos
- Uma conta do Azure
- Uma conta do Azure Mapas
- Uma chave de assinatura ou outra forma de autenticação no Azure Mapas
Diferenças notáveis
- A API de Cálculo de Rotas do Bing Maps dá suporte a uma solicitação GET. A API de Direções de Rota do Azure Mapas dá suporte a uma solicitação POST.
- A API de Cálculo de Rota do Bing Maps dá suporte ao formato de resposta XML e JSON. A API de Direções de Rota do Azure Mapas dá suporte ao formato GeoJSON .
- A API de Cálculo de Rotas do Bing Maps requer que os waypoints e viaWaypoints estejam no formato de latitude/longitude, enquanto o Azure Maps exige que estejam no formato de longitude/latitude, conforme definido no formato GeoJSON.
- A API Calcular uma Rota do Bing Mapas dá suporte a waypoints e viaWaypoints como pontos, pontos de referência ou endereços. A API de Direções de Rota do Azure Mapas dá suporte apenas a pontos. Para converter um ponto de referência ou endereço em um ponto, você pode usar a API Get Geocoding do Azure Mapas.
- A API Bing Maps Calculate a Route oferece suporte ao roteamento de trânsito. A API de Direções de Rota do Azure Maps não funciona corretamente.
- Ao contrário do Bing Maps Enterprise, o Azure Maps é um serviço global que suporta a especificação de um escopo geográfico, permitindo limites à residência dos dados nas áreas geográficas da União Europeia (UE) ou dos Estados Unidos (EUA). Todas as solicitações (incluindo dados de entrada) são processadas exclusivamente na área geográfica especificada. Para obter mais informações, consulte o escopo geográfico.
Segurança e autenticação
O Bing Mapas para Empresas dá suporte somente à autenticação de chave de API. O Azure Mapas dá suporte a várias maneiras de autenticar suas chamadas à API, como uma chave de assinatura, o Microsoft Entra ID e o token de Assinatura de Acesso Compartilhado (SAS). Para obter mais informações sobre segurança e autenticação no Azure Mapas, consulte Autenticação com o Azure Mapas e a seção Segurança na documentação de Rotas do Azure Mapas.
Parâmetros de solicitação
A tabela a seguir lista os parâmetros de solicitação Calcular uma Rota do Bing Mapas e o equivalente do Azure Mapas.
| Parâmetro de solicitação do Bing Mapas | Alias do parâmetro de solicitação do Bing Mapas | Parâmetro de solicitação do Azure Mapas | Obrigatório no Azure Mapas | Tipo de dados do Azure Mapas | Descrição |
|---|---|---|---|---|---|
| evitar | evitar | Falso | cadeia de caracteres | Aqui estão os equivalentes da API Calcular uma Rota do Bing Mapas para a API Direções de Rota do Azure Mapas, onde houver suporte: pedágios: tollRoads balsa: balsas borderCrossings: borderCrossings minimizeDrivingSideTurn: sem suporte minimizeAgainstDrivingSideTurn: sem suporte minimizeUTurn: sem suporte minimizeTolls: sem suporte rodovias: limitedAccessHighways minimizeHighways: sem suporte |
|
| data/Hora | Dt | departAt | Falso | cadeia de caracteres | A API de Direções de Rota do Azure Mapas também dá suporte ao parâmetro arriveAt usado para especificar a data e a hora de chegada desejadas. Ele não pode ser usado com departAt. |
| distanceBeforeFirstTurn | dbft | Sem suporte | Sem suporte | Sem suporte | |
| distanceUnit | Du | Não é necessário | Não é necessário | Não é necessário | Na API de Direções de Rota do Azure Mapas, a unidade de distância é de metros. |
| cabeçalho | disco rígido | cabeçalho | Falso | inteiro | |
| itineraryGroups | Ig | Sem suporte | Sem suporte | ||
| maxSolutions | maxSolns | maxRouteCount | Falso | Número inteiro | |
| otimizar | optmz | optimizeRoute | Falso | Cadeia de caracteres | Aqui estão os equivalentes da API Calcular uma Rota do Bing Mapas para a API Direções de Rota optimizeRoute do Azure Mapas: tempo: mais rápido sem trânsito timeWithTraffic: fastestWithTraffic A API de Direções de Rota do Azure Mapas também dá suporte à otimização de rotas por distância para retornar a rota mais curta, especificando a mais curta como o valor de entrada 'optimizeRoute'. |
| otimizarPontosDePassagem | optWp | optimizeWaypointOrder | Falso | booleano | |
| routeAttributes | Ra | routeOutputOptions | Falso | cadeia de caracteres | Aqui estão os equivalentes da API Calcular uma Rota do Bing Mapas para a API Direções de Rota routeOutputOptions do Azure Mapas: routePath: routePath regionMediaSummary: regionMediaSummary A API de Direções de Rota do Azure Mapas dá suporte a mais valores como itinerário e routeSummary. Consulte o RouteOutputOption para obter detalhes. |
| routePathOutput | Rpo | routeOutputOptions | Falso | cadeia de caracteres | A API Direções de Rota do Azure Mapas dá suporte ao retorno das coordenadas para a geometria do caminho de rota passando routeOutputOptions=routePath na solicitação. |
| timeType | Tt | Sem suporte | Sem suporte | Sem suporte | A API de Direções de Rota do Azure Mapas não dá suporte ao Roteamento de Trânsito. |
| Tolerâncias | Tl | Sem suporte | Sem suporte | Sem suporte | |
| modo de viagem | modo de viagem | Falso | Cadeia de caracteres | Aqui estão os equivalentes de travelMode da API Calcular uma Rota do Bing Mapas para a API Direções de Rota do Azure Mapas: Dirigindo: dirigindo Caminhando: caminhando Trânsito: sem suporte O Azure Mapas dá suporte extra ao "caminhão" do travelMode para roteamento de caminhão. |
|
| viaWaypoint.n | vwp.n | Características InputWaypointFeaturesItem[] |
Verdadeiro | Ponto GeoJSON | waypoint e viaWaypoint são especificados como recursos, que é um parâmetro necessário. No entanto, somente o ponto de passagem é um pointType necessário e a solicitação pode ser feita sem viaWaypoint. Na API Calcular uma Rota do Bing Mapas, viaWaypoint pode ser um ponto, uma referência ou um endereço, enquanto na API Direções de Rota do Azure Mapas, deve ser um ponto. Para converter um ponto de referência ou endereço em um ponto, você pode usar a API Get Geocoding do Azure Mapas. A API de Cálculo de Rota de Caminhão dos Mapas do Bing requer que os viaWaypoints estejam no formato de latitude/longitude, enquanto os Mapas do Azure exigem que eles estejam em formato de longitude/latitude, conforme definido no formato GeoJSON. |
| waypoint.n | wp.n | recursos InputWaypointFeaturesItem[] | Verdadeiro | Ponto GeoJSON | Na API Calcular uma Rota do Bing Mapas, o waypoint pode ser um ponto, uma referência ou um endereço, enquanto na API Direções de Rota do Azure Mapas ele deve ser um ponto. Para converter um ponto de referência ou endereço em um ponto, você pode usar a API Get Geocoding do Azure Mapas. A API Calcular uma Rota do Bing Mapas exige que os waypoints estejam no formato de latitude/longitude, enquanto o Azure Mapas exige que eles estejam no formato de longitude/latitude, conforme definido no formato GeoJSON. |
Para obter mais informações sobre os parâmetros de solicitação da API de Rotas do Azure Mapas, consulte parâmetros de URI.
Solicitar exemplos
Solicitação da API Calcular uma Rota do Bing Mapas:
http://dev.virtualearth.net/REST/V1/Routes/driving?wp.0=47.610173,-122.204171&wp.1=47.612440,-122.204171key={Your-Bing-Maps-Key}
Solicitação POST da API Direções de Rota do Azure Mapas:
https://atlas.microsoft.com/route/directions?api-version=2025-01-01&subscription-key={Your-Azure-Maps-Subscription-key}
Incluído no corpo da solicitação:
{
"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"
}
}
]
}
Campos de resposta
A tabela a seguir lista os campos que podem aparecer na resposta HTTP ao executar a solicitação Calcular uma rota do Bing Mapas e o equivalente do Azure Mapas:
| Campo Mapas do Bing | Campo Azure Mapas | Descrição |
|---|---|---|
| actualStart | Objeto do recurso de ponto | O objeto de recurso de ponto com type="waypoint" e inputIndex = 0 define o local de início roteável. |
| actualEnd | Objeto do recurso de ponto | O objeto do recurso do ponto com type=”waypoint” e inputIndex = last define o local final roteável. |
| alternateVias | rotas alternativas | O Bing Maps alternateVias identifica as rotas separadas. No Azure Mapas, as rotas alternativas são retornadas como uma nova coleção de recursos em alternativeRoutes. |
| compassDegrees | compassDegrees | |
| compassDirection | compassDirection | |
| descrição | Sem suporte | |
| Detalhes | Propriedades | As propriedades do objeto de funcionalidade contêm as informações da manobra. |
| distanceUnit | Não aplicável | A API de Direções de Rota do Azure Mapas retorna a distância em metros. |
| durationUnit | Não aplicável | A API de Direções de Rota do Azure Mapas retorna a duração em segundos. |
| endPathIndices | intervalo | O Azure Mapas retorna o índice inicial e final coberto por uma etapa específica de uma rota como um intervalo. |
| ponto de extremidade | Sem suporte | Na resposta da API Direções de Rota do Azure Mapas, o endWaypoint pode ser derivado de type="waypoint" e inputIndex = último índice |
| formattedText | formattedText | |
| Dicas | Sem suporte | |
| hintType | Sem suporte | |
| tipo de ícone | Sem suporte | A API de Cálculo de Rota do Bing Mapas especifica o tipo de ícone para representar o modo de viagem em aplicativos de usuário. Por exemplo, se uma rota de condução tiver uma rota de balsa parcial, o ícone poderá ser usado para identificar visualmente os diferentes modos de viagem em uma rota. A API de Cálculo de Rota do Azure Mapas não dá suporte a iconType, no entanto, o modo de viagem pode ser derivado da propriedade travelMode na resposta. |
| Instrução | Instrução | |
| éTrânsitoEmTempoReal | Sem suporte | |
| isVia | viaWaypoint | Na resposta à API Direções de Rota do Azure Mapas, o ponto de passagem é retornado como "type": "ViaWaypoint" |
| códigos de localização | Sem suporte | |
| identificadorDeLocalização | Sem suporte | |
| maneuverPoint | maneuverPoint | No Azure Mapas, type=maneuverPoint para os objetos do ponto em que uma manobra é necessária. Em uma API Calcular uma Rota do Bing Mapas, o maneuverPoint está no formato de latitude/longitude, enquanto que no Azure Mapas está no formato de longitude/latitude, conforme definido no formato GeoJSON. |
| tipoDeManobra | tipoDeManobra | |
| modo | Sem suporte | |
| Nomes | Nomes | |
| realTimeTransitDelay | Sem suporte | |
| tipoDeEstrada | tipoDeEstrada | |
| routePathIndex | routePathPoint | |
| routeSubLegs | subLegs | |
| sideOfStreet | sideOfStreet | |
| startPathIndices | intervalo | O Azure Mapas retorna o índice inicial e final coberto por uma etapa específica de uma rota como um intervalo. |
| startWaypoint | Sem suporte | Na resposta à API de Direções de Rota do Azure Maps, o startWaypoint pode ser derivado de type="waypoint" e inputIndex = primeiro índice. |
| towardsRoadName | towardsRoadName | |
| trafficCongestion | trafficCongestion | |
| dadosDeTráfegoUtilizados | dadosDeTráfegoUtilizados | |
| distância de viagem | distânciaEmMetros | |
| duração da viagem | duraçãoEmSegundos | |
| travelDurationTraffic | duração do tráfego em segundos | |
| modo de viagem | Modo de viagem |
Para obter mais informações sobre os campos de resposta da API de Rotas do Azure Mapas, consulte Definições.
Exemplos de respostas
O exemplo JSON a seguir mostra o que é retornado no corpo da resposta HTTP ao executar a solicitação Calcular uma Rota do Bing Mapas:
{
"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"
}
A amostra JSON a seguir mostra o que é retornado no corpo da resposta HTTP quando você executa uma solicitação Obter Peça de Mapa do Azure Mapas:
{
"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": []
}
}
]
}
Uso de transações
Semelhante à API de Cálculo de Rota do Bing Mapas, a API de Direção de Rota do Azure Mapas registra uma transação faturável por solicitação de API. Para obter mais informações sobre transações do Azure Mapas, consulte Noções básicas sobre transações do Azure Mapas.
Informações adicionais
- Postar Lotes de Direção: use para enviar um lote de consultas à API Direções de Rota em uma única solicitação síncrona.
Apoio