Partilhar via

Migrar APIs do Azure Maps Route 1.0

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

Azure Maps Route v1.0 Opções de migração do Azure Maps Route v2025-01-01
Obter direções de rota  Post Route Directions: Get Route Directions não é mais suportado.
Obter Route Directions Batch  O processamento assíncrono de direções de rota não está disponível no momento. Em vez disso, use Post Route Directions Batch.
Instruções para Rota de Entrega  Instruções para Rota de Entrega  
Lote de Instruções Pós-Rota  Conjunto de Instruções de Rota Post: o conjunto assíncrono de instruções de rota está indisponível no momento; em vez disso, use o conjunto sincronizado.
Sincronização em lote de instruções pós-rota  Lote de Instruções Pós-Rota 
Obter matriz de rotas  Obter resultado da operação de rota: utilizado para obter o resultado de chamadas assíncronas da Matriz de Rotas.
Obter estado das operações de rota: use para obter o estado das chamadas assíncronas da matriz de rota.
Matriz de Pós-Rota  Matriz de pós-rota assíncrona 
Sincronização da matriz pós-rota  Matriz de Pós-Rota 
Obter Faixa de Rota  Post Route Range: A GET solicitação não é mais suportada.

Diferenças notáveis

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

Característica v1,0 v2025-01-01
Operações em lote Solicitações sincrónicas e assíncronas Solicitações de sincronização
Formato das coordenadas Latitude/longitude Longitude/latitude, conforme definido pelo GeoJSON.
Modelo de consumo elétrico Suportado Não suportado
Localização Use o parâmetro "language" para localizar o idioma das instruções de rota. Use o cabeçalho da solicitação "Accept-Language" para inserir um código de localização para localizar o idioma das instruções de rota.
Tipo de pedido OBTER, POSTAR Publicação
Formato da resposta XML, JSON GeoJSON
Modo de viagem Carro, caminhão, pedestre.
Perfis beta: Ônibus, bicicleta, motocicleta, táxi, van.		 Carro, caminhão, pedestre.
Otimização de Waypoint Suportado Atualmente suportado apenas para roteamento de camiões.
Pontos de passagem Suportado Suportado. Também suporta viaWaypoints os modos de condução e caminhada.

Diferenças notáveis na Route Matrix

Característica v1,0 v2025-01-01
Formato das coordenadas Longitude e latitude Longitude e latitude
Modelo de consumo elétrico Suportado Não suportado
Coordenadas de entrada Usa recursos GeoJSON MultiPoint para coordenadas de entrada, mas a solicitação está em JSON. Um tipo de geometria GeoJSON MultiPoint 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 (JavaScript Object Notation) GeoJSON (entrada e resposta)
Modo de viagem Carro, caminhão, pedestre.
Perfis beta: Ônibus, bicicleta, motocicleta, táxi, van.		 Carro, caminhão, pedestre.

Diferenças notáveis no Route Range

Característica v1,0 v2025-01-01
Formato das coordenadas Latitude/Longitude Longitude/latitude, conforme definido pelo GeoJSON.
Modelo de consumo elétrico Suportado Não suportado
Tipo de pedido OBTER, POSTAR Publicação
Formato da resposta XML, JSON GeoJSON (entrada e resposta)
Modos de viagem Carro, caminhão.
Perfis beta: ônibus, motocicleta, táxi, van		 Carro, Camiã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 Maps.

Exemplos de serviços de rota

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

Exemplos de direções de rota

Exemplo de solicitação de Direções de Rota 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}

Pedido de exemplo de Direções de Rota 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 de 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" 
        } 
      ] 
    } 
  ] 
}

Exemplo de resposta Direções de Rota versão 2025-01-01

{ 
  "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 do Route Matrix versão 1.0

A API Post Route Matrix Sync 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 Route Matrix versão 2025-01-01

A API Route Matrix 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 do Route Matrix 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 Route Matrix versão 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 Route Range versão 1.0

A Route Range API 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}

Pedido de exemplo do Route Range versão 2025-01-01

A API Intervalo de Rotas na versão 2025-01-01 é uma solicitação HTTP POST. Os parâmetros podem ser incluídos na chamada de 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 Route Range versão 1.0

Os resultados da resposta são truncados para maior 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 Route Range versão 2025-01-01

Os resultados da resposta são truncados para maior 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