Compartilhar via

Migrar APIs da Rota 1.0 do Azure Mapas

Este artigo explica como migrar as APIs da Rota v1.0 do Azure Mapas para a Rota do Azure Mapas v2025-01-01 APIs. A tabela a seguir mostra as APIs de Rota v1.0 e as opções de migração.

Rota do Azure Mapas v1.0 Opções de migração da Rota do Azure Mapas versão de 01/01/2025
Obter Trajeto de Rota  Direções pós-rota: não há mais suporte para obter direções de rota.
Obter o Lote de Direções de Rota  O lote assíncrono de Rotas está indisponível no momento. Em vez disso, use Post Route Directions Batch.
Direções pós-rota  Direções pós-rota  
Lote de Direções pós-rota  Lote de Direções pós-rota: o lote assíncrono de rotas está indisponível no momento, em vez disso, use o lote de sincronização.
Sincronização em lotes de direções pós-rota  Lote de Direções pós-rota 
Obter matriz de rotas  Obter o resultado da operação de rota: use para obter o resultado de chamadas assíncronas da Matriz de Rota.
Obter o Status das Operações de Rota: use para obter o status das chamadas assíncronas da Matriz de Rotas.
Matrix de rota POST  Matriz de Pós-Rota Assíncrona 
Matriz de Pós-Rota Síncrona  Matrix de rota POST 
Obter intervalo de rotas  Intervalo pós-rota: não há mais suporte para solicitação GET.

Diferenças notáveis

Diferenças notáveis nas direções de rota

Característica v1.0 versão de 01/01/2025
Operações em lote Sincronizar e fazer solicitações assíncronas Solicitações de sincronização
Formato de coordenada Latitude, longitude Longitude/latitude, conforme definido por GeoJSON.
Modelo de consumo elétrico Suportado Sem suporte
Localização Use o parâmetro "language" para localizar o idioma das instruções de rota. Use o cabeçalho de solicitação "Accept-Language" para inserir um código de localização para localizar o idioma das instruções de rota.
Tipo de solicitação GET e POST PUBLICAR
Formato da resposta XML, JSON GeoJSON
Modo de viagem Carro, caminhão, pedestre.
Perfis beta: Ônibus, bicicleta, moto, táxi, van.		 Carro, caminhão, pedestre.
Otimização de Ponto de Passagem Suportado Atualmente, só há suporte para roteamento de caminhão.
Pontos de passagem Suportado Suportado. Também dá suporte para modos viaWaypoints de condução e caminhada.

Diferenças notáveis da Matriz de Rotas

Característica v1.0 versão de 01/01/2025
Formato de coordenada Longitude/latitude Longitude/latitude
Modelo de consumo elétrico Suportado Sem suporte
Coordenadas de entrada Usa recursos do MultiPoint GeoJSON para coordenadas de entrada, mas a solicitação está em JSON. Um tipo de geometria de MultiPoint GeoJSON válido.
Matriz: solicitações assíncronas Até 700 células Até 50.000 células
Matriz: solicitações síncronas Até 100 células Até 2.500 células
Formato da resposta JSON GeoJSON (entrada e resposta)
Modo de viagem Carro, caminhão, pedestre.
Perfis beta: Ônibus, bicicleta, moto, táxi, van.		 Carro, caminhão, pedestre.

Diferenças notáveis do Intervalo de Rotas

Característica v1.0 versão de 01/01/2025
Formato de coordenada Latitude, longitude Longitude/latitude, conforme definido por GeoJSON.
Modelo de consumo elétrico Suportado Sem suporte
Tipo de solicitação GET e POST PUBLICAR
Formato da resposta XML, JSON GeoJSON (entrada e resposta)
Modos de viagem Carro, caminhão.
Perfis beta: ônibus, moto, táxi, van		 Carro, Caminhão

Uso de transações

Para obter informações sobre como as transações são calculadas, consulte Noções básicas sobre transações do Azure Mapas.

Exemplos de serviços de rota

Esta seção fornece solicitações de exemplo e respostas para as versões 1.0 e 2025-01-01 para a Direção da Rota, Matriz de Rotas e API de Intervalo de Rotas .

Exemplos de direções de rota

Solicitação de exemplo do Route Directions versão 1.0

A API de Direções de Rota na versão 1.0 é uma solicitação HTTP GET . Todos os parâmetros são passados como parâmetros de cadeia de caracteres de consulta.

https://atlas.microsoft.com/route/directions/json?api-version=1.0&query=52.50931,13.42936:52.50895,13.42904&subscription-key={Your-Azure-Maps-Subscription-key}

Solicitação de exemplo do Route Directions versão 2025-01-01

A API de Direções de Rota na versão 2025-01-01 é uma solicitação HTTP POST . Os parâmetros podem ser incluídos na chamada à API como parâmetros de cadeia de caracteres de consulta, com mais parâmetros fornecidos no corpo da solicitação usando o formato GeoJSON.

https://atlas.microsoft.com/route/directions/json?api-version=2025-01-01&subscription-key={Your-Azure-Maps-Subscription-key}

Os parâmetros incluídos no corpo da solicitação HTTP POST são fornecidos como GeoJSON.

{ 
  "type": "FeatureCollection", 
  "features": [ 
    { 
      "type": "Feature", 
      "geometry": { 
        "coordinates": [ 
        13.42936,52.50931 
        ], 
        "type": "Point" 
      }, 
      "properties": { 
        "pointIndex": 0, 
        "pointType": "waypoint" 
      } 
    }, 
    { 
      "type": "Feature", 
      "geometry": { 
        "coordinates": [ 
         13.42904,52.50895 
        ], 
        "type": "Point" 
      }, 
      "properties": { 
        "pointIndex": 1, 
        "pointType": "waypoint" 
      } 
    } 
  ] 
}

Exemplo de resposta do Route Directions versão 1.0

{ 
  "formatVersion": "0.0.12", 
  "routes": [ 
    { 
      "summary": { 
        "lengthInMeters": 46, 
        "travelTimeInSeconds": 4, 
        "trafficDelayInSeconds": 0, 
        "trafficLengthInMeters": 0, 
        "departureTime": "2025-02-19T05:40:44+01:00", 
        "arrivalTime": "2025-02-19T05:40:47+01:00" 
      }, 
      "legs": [ 
        { 
          "summary": { 
            "lengthInMeters": 46, 
            "travelTimeInSeconds": 4, 
            "trafficDelayInSeconds": 0, 
            "trafficLengthInMeters": 0, 
            "departureTime": "2025-02-19T05:40:44+01:00", 
            "arrivalTime": "2025-02-19T05:40:47+01:00" 
          }, 
          "points": [ 
            { 
              "latitude": 52.50931, 
              "longitude": 13.42937 
            }, 
            { 
              "latitude": 52.50904, 
              "longitude": 13.42913 
            }, 
            { 
              "latitude": 52.50895, 
              "longitude": 13.42904 
            } 
          ]
        } 
      ], 
      "sections": [ 
        { 
          "startPointIndex": 0, 
          "endPointIndex": 2, 
          "sectionType": "TRAVEL_MODE", 
          "travelMode": "car" 
        } 
      ] 
    } 
  ] 
}

Versão 2025-01-01 das instruções de rota - exemplo de resposta

{ 
  "type": "FeatureCollection", 
  "features": [ 
    { 
      "type": "Feature", 
      "geometry": { 
        "type": "Point", 
        "coordinates": [ 
          13.429368, 
          52.509303 
        ] 
      }, 
      "properties": { 
        "routePathPoint": { 
          "legIndex": 0, 
          "pointIndex": 0 
        }, 
        "order": { 
          "inputIndex": 0 
        }, 
        "type": "Waypoint" 
      } 
    }, 
    { 
      "type": "Feature", 
      "geometry": { 
        "type": "Point", 
        "coordinates": [ 
          13.429045, 
          52.50895 
        ] 
      }, 
      "properties": { 
        "routePathPoint": { 
          "legIndex": 0, 
          "pointIndex": 3 
        }, 
        "order": { 
          "inputIndex": 1 
        }, 
        "type": "Waypoint" 
      } 
    }, 
    { 
      "type": "Feature", 
      "geometry": { 
        "type": "MultiLineString", 
        "coordinates": [ 
          [ 
            [ 
              13.429368, 
              52.509302 
            ], 
            [ 
              13.429225, 
              52.509145 
            ], 
            [ 
              13.429128, 
              52.509038 
            ], 
            [ 
              13.429044, 
              52.50895 
            ] 
          ] 
        ], 
        "bbox": [ 
          13.429044, 
          52.50895, 
          13.429368, 
          52.509302 
        ] 
      }, 
      "properties": { 
        "resourceId": "v70,h822083589,i0,a0,cen-US,dAAAAAAAAAAA1,y0,s1,m1,o1,t0,wTMPwETFBSkDPa-wS1dsqQA2~~~~~~~~~~v12,wTKYKRiVBSkAIWoEhq9sqQA2~~~~~~~~~~v12,k1,qatt:1", 
        "trafficCongestion": "Heavy", 
        "trafficDataUsed": "None", 
        "distanceInMeters": 44, 
        "durationInSeconds": 3, 
        "departureAt": "2025-02-19T05:41:07+00:00", 
        "arrivalAt": "2025-02-19T05:41:10+00:00", 
        "type": "RoutePath", 
        "legs": [ 
          { 
            "distanceInMeters": 44, 
            "durationInSeconds": 3, 
            "departureAt": "2025-02-19T05:41:07+00:00", 
            "arrivalAt": "2025-02-19T05:41:10+00:00", 
            "routePathRange": { 
              "legIndex": 0, 
              "range": [ 
                0, 
                3 
              ] 
            }, 
            "description": "An der Schillingbrücke" 
          } 
        ] 
      } 
    } 
  ] 
}

Exemplos de Matriz de Rotas

Solicitação de exemplo da Matriz de Rotas 1.0

A API de Matriz de Pós-Rota Síncrona na versão 1.0 é uma solicitação HTTP POST. Os parâmetros podem ser passados como parâmetros de cadeia de caracteres de consulta e no corpo da solicitação usando o formato GeoJSON.

https://atlas.microsoft.com/route/matrix/sync/json?api-version=1.0&travelMode=car&subscription-key={Your-Azure-Maps-Subscription-key}

Os parâmetros incluídos no corpo da solicitação HTTP POST são fornecidos como JSON.

{ 
  "origins": { 
    "type": "MultiPoint", 
    "coordinates": [ 
      [ 
        4.85106,
        52.36006 
      ], 
      [ 
        4.85056, 
        52.36187 
      ] 
    ] 
  }, 
  "destinations": { 
    "type": "MultiPoint", 
    "coordinates": [ 
      [ 
        4.85003, 
        52.36241 
      ] 
    ] 
  } 
}

Exemplo de solicitação da versão da Matriz de Rotas 2025-01-01

A API de Matriz de Rotas na versão 2025-01-01 é uma solicitação HTTP POST . Os parâmetros são passados como parâmetros de cadeia de caracteres de consulta e no corpo da solicitação usando o formato GeoJSON.

https://atlas.microsoft.com/route/matrix/json?api-version=2025-01-01&subscription-key={Your-Azure-Maps-Subscription-key}

Os parâmetros incluídos no corpo da solicitação HTTP POST são fornecidos como GeoJSON.

{ 
  "type": "FeatureCollection", 
  "features": [ 
    { 
      "type": "Feature", 
      "geometry": { 
        "type": "MultiPoint", 
        "coordinates": [ 
          [ 
            4.85106, 
            52.36006 
          ], 
          [ 
            4.85056, 
            52.36187 
          ] 
        ] 
      }, 
      "properties": { 
        "pointType": "origins" 
      } 
    }, 
    { 
      "type": "Feature", 
      "geometry": { 
        "type": "MultiPoint", 
        "coordinates": [ 
          [ 
            4.85003, 
            52.36241 
          ] 
        ] 
      }, 
      "properties": { 
        "pointType": "destinations" 
      } 
    } 
  ], 
  "travelmode":"driving" 
}

Exemplo de resposta da Matriz de Rotas versão 1.0

{ 
  "formatVersion": "0.0.1", 
  "matrix": [ 
    [ 
      { 
        "statusCode": 200, 
        "response": { 
          "routeSummary": { 
            "lengthInMeters": 494, 
            "travelTimeInSeconds": 124, 
            "trafficDelayInSeconds": 0, 
            "trafficLengthInMeters": 0, 
            "departureTime": "2025-02-19T06:30:23+01:00", 
            "arrivalTime": "2025-02-19T06:32:27+01:00" 
          } 
        } 
      } 
    ], 
    [ 
      { 
        "statusCode": 200, 
        "response": { 
          "routeSummary": { 
            "lengthInMeters": 337, 
            "travelTimeInSeconds": 106, 
            "trafficDelayInSeconds": 0, 
            "trafficLengthInMeters": 0, 
            "departureTime": "2025-02-19T06:30:23+01:00", 
            "arrivalTime": "2025-02-19T06:32:08+01:00" 
          } 
        } 
      } 
    ] 
  ], 
  "summary": { 
    "successfulRoutes": 2, 
    "totalRoutes": 2 
  } 
}

Exemplo de resposta da versão da Matriz de Rotas 2025-01-01

{ 
  "type": "Feature", 
  "geometry": null, 
  "properties": { 
    "summary": { 
      "totalCount": 2, 
      "successfulCount": 2 
    }, 
    "matrix": [ 
      { 
        "statusCode": 200, 
        "originIndex": 0, 
        "destinationIndex": 0, 
        "durationTrafficInSeconds": 129, 
        "durationInSeconds": 129, 
        "distanceInMeters": 494 
      }, 
      { 
        "statusCode": 200, 
        "originIndex": 1, 
        "destinationIndex": 0, 
        "durationTrafficInSeconds": 110, 
        "durationInSeconds": 110, 
        "distanceInMeters": 338 
      } 
    ] 
  } 
}

Exemplos de intervalo de rotas

Solicitação de exemplo do Intervalo de Rotas versão 1.0

A API Intervalo de Rotas na versão 1.0 é uma solicitação HTTP GET. Todos os parâmetros são passados como parâmetros de cadeia de caracteres de consulta.

https://atlas.microsoft.com/route/range/json?api-version=1.0&query=50.97452,5.86605&travelmode=car&distanceBudgetInMeters=15&subscription-key={Your-Azure-Maps-Subscription-key}

Solicitação de exemplo da Faixa de Rotas versão 2025-01-01

A API Route Range na versão 2025-01-01 é uma requisição HTTP POST. Os parâmetros podem ser incluídos na chamada à API como parâmetros de cadeia de caracteres de consulta, com mais parâmetros fornecidos no corpo da solicitação usando o formato GeoJSON.

https://atlas.microsoft.com/route/range?api-version=2025-01-01&subscription-key={Your-Azure-Maps-Subscription-key}

Os parâmetros incluídos no corpo da solicitação HTTP POST são fornecidos como GeoJSON.

{ 
    "type": "Feature", 
    "geometry": { 
        "type": "Point", 
        "coordinates": [ 
            5.86605,50.97452 
        ] 
    }, 
    "properties": { 
        "distanceBudgetInMeters": 15, 
        "travelMode": "driving" 
    } 
}

Exemplo de resposta do Intervalo de Rotas versão 1.0

Os resultados da resposta são resumidos para brevidade.

{ 
  "formatVersion": "0.0.1", 
  "reachableRange": { 
    "center": { 
      "latitude": 50.97452, 
      "longitude": 5.86605 
    }, 
    "boundary": [ 
      { 
        "latitude": 50.97452, 
        "longitude": 5.86605
      }, 
      { 
        "latitude": 50.97452, 
        "longitude": 5.86605 
      }, 
      { 
        "latitude": 50.97452, 
        "longitude": 5.86605 
      }, 
      { 
        "latitude": 50.97452, 
        "longitude": 5.86605 
      } 
    ] 
  } 
}

Exemplo de resposta do Intervalo de Rotas 2025-01-01

Os resultados da resposta são resumidos para brevidade.

{ 
  "type": "FeatureCollection", 
  "features": [ 
    { 
      "type": "Feature", 
      "geometry": { 
        "type": "Point", 
        "coordinates": [ 
          5.86605, 
          50.97452 
        ] 
      }, 
      "properties": { 
        "type": "center" 
      } 
    }, 
    { 
      "type": "Feature", 
      "geometry": { 
        "type": "Polygon", 
        "coordinates": [ 
          [ 
            [ 
              5.86605,50.97452 
            ], 
            [ 
              5.8659, 50.97454 
            ], 
            [ 
              5.86584, 50.9745 
            ], 
            [ 
              5.86588, 50.97448 
            ] 
          ] 
        ], 
        "bbox": [ 
          5.86584, 
          50.97447, 
          5.86626, 
          50.97454 
        ] 
      }, 
      "properties": { 
        "type": "boundary" 
      } 
    } 
  ] 
}
  • Last updated on