Partager via

Migration des API Azure Maps Route 1.0

Cet article explique comment migrer les API Azure Maps Route v1.0 vers azure Maps Route v2025-01-01 API. Le tableau suivant présente les API Route v1.0 et les options de migration.

Itinéraire Azure Maps v1.0 Options de migration d’Azure Maps Route v2025-01-01
Obtenir un itinéraire  Post Route Directions : la commande Get Route Directions n’est plus prise en charge.
Obtenir l’itinéraire par lot  Route Directions async batch est actuellement indisponible. Utilisez plutôt Post Route Directions Batch.
Itinéraire de poste  Itinéraire de poste  
Envoi d’itinéraire Lot  Post Route Directions Batch : le traitement par lot asynchrone Route Directions est actuellement indisponible, utilisez plutôt le traitement par lot synchrone.
Synchronisation par lot des directions de la route postale  Envoi d’itinéraire Lot 
Obtenir la matrice de routage  Obtenir le résultat de l’opération de routage : permet d’obtenir le résultat des appels asynchrones de matrice de routage.
Obtenir l’état des opérations de routage : permet d’obtenir l’état des appels asynchrones de matrice de routage.
Envoyer une matrice d’itinéraire  Matrice de post-routage asynchrone 
Synchronisation de la matrice de routage post-route  Envoyer une matrice d’itinéraire 
Obtenir une zone d’itinéraire  Post Route Range : la requête GET n’est plus prise en charge.

Différences notables

Différences notables des indications de parcours

Caractéristique Version 1.0 Référence : V2025-01-01
Opérations par lot Requêtes synchrones et asynchrones Demandes de synchronisation
Format de coordonnées Latitude/Longitude Longitude/latitude, telle que définie par GeoJSON.
Modèle de consommation électrique Soutenu Non prise en charge
Localisation Utilisez le paramètre « language » pour localiser la langue des instructions de routage. Utilisez l’en-tête de requête « Accept-Language » pour entrer un code de localisation pour localiser la langue des instructions de routage.
Type de requête OBTENIR, PUBLIER PUBLIER
Format de la réponse XML, JSON GeoJSON
Mode voyage Voiture, camion, piéton.
Profils bêta : Bus, vélo, moto, taxi, van.		 Voiture, camion, piéton.
Optimisation des points de passage Soutenu Actuellement uniquement pris en charge pour le routage des camions.
Points de chemin Soutenu Pris en charge. Prend également en charge viaWaypoints pour les modes conduite et marche.

Différences notables de matrice de routage

Caractéristique Version 1.0 Référence : V2025-01-01
Format de coordonnées Longitude/latitude Longitude/latitude
Modèle de consommation électrique Soutenu Non prise en charge
Coordonnées d’entrée Utilise les fonctionnalités GeoJSON MultiPoint pour les coordonnées d’entrée, mais la requête est au format JSON. Un type de géométrie MultiPoint GeoJSON valide.
Matrice : demandes asynchrones Jusqu’à 700 cellules Jusqu’à 50 000 cellules
Matrice : requêtes synchrones Jusqu’à 100 cellules Jusqu’à 2 500 cellules
Format de la réponse JSON GeoJSON (entrée et réponse)
Mode voyage Voiture, camion, piéton.
Profils bêta : Bus, vélo, moto, taxi, van.		 Voiture, camion, piéton.

Différences notables entre gammes d’itinéraires

Caractéristique Version 1.0 Référence : V2025-01-01
Format de coordonnées Latitude/Longitude Longitude/latitude, telle que définie par GeoJSON.
Modèle de consommation électrique Soutenu Non pris en charge
Type de requête OBTENIR, PUBLIER PUBLIER
Format de la réponse XML, JSON GeoJSON (entrée et réponse)
Modes de voyage Voiture, Camion.
Profils bêta : bus, moto, taxi, van		 Voiture, camion

Utilisation des transactions

Pour plus d’informations sur la façon dont les transactions sont calculées, consultez Présentation des transactions Azure Maps.

Exemples de service de routage

Cette section fournit des exemples de demandes et de réponses pour la version 1.0 et 2025-01-01 pour l’API Route Direction, Route Matrix et Route Range .

Exemples d'itinéraires

Exemple de requête Route Directions version 1.0

L’API Route Directions dans la version 1.0 est une requête HTTP GET . Tous les paramètres sont passés en tant que paramètres de chaîne de requête.

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}

Route Directions version 2025-01-01 - Exemple de requête

L’API Route Directions dans la version 2025-01-01 est une requête HTTP POST . Les paramètres peuvent être inclus dans l’appel d’API en tant que paramètres de chaîne de requête, avec d’autres paramètres fournis dans le corps de la requête au format GeoJSON.

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

Les paramètres inclus dans le corps de la requête HTTP POST sont fournis en tant que 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" 
      } 
    } 
  ] 
}

Exemple de réponse Route Directions version 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" 
        } 
      ] 
    } 
  ] 
}

Exemple de réponse Route Directions version 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" 
          } 
        ] 
      } 
    } 
  ] 
}

Exemples de matrice de routage

Exemple de requête de matrice de routage version 1.0

L’API Post Route Matrix Sync dans la version 1.0 est une requête HTTP POST . Les paramètres peuvent être passés en tant que paramètres de chaîne de requête et dans le corps de la requête à l’aide du format GeoJSON.

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

Les paramètres inclus dans le corps de la requête HTTP POST sont fournis en tant que JSON.

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

Exemple de requête pour Route Matrix, version 2025-01-01

L’API Route Matrix dans la version 2025-01-01 est une requête HTTP POST . Les paramètres sont passés en tant que paramètres de chaîne de requête et dans le corps de la requête à l’aide du format GeoJSON.

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

Les paramètres inclus dans le corps de la requête HTTP POST sont fournis en tant que 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" 
}

Exemple de réponse Route Matrix version 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 
  } 
}

Exemple de réponse pour Route Matrix, version 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 
      } 
    ] 
  } 
}

Exemples de plage de routage

Exemple de requête de plage de routage version 1.0

L’API Plage de Route dans la version 1.0 est une requête HTTP GET. Tous les paramètres sont passés en tant que paramètres de chaîne de requête.

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}

Exemple de requête pour Route Range, version 2025-01-01

L'API Plage de routes dans la version 2025-01-01 est une requête HTTP POST. Les paramètres peuvent être inclus dans l’appel d’API en tant que paramètres de chaîne de requête, avec d’autres paramètres fournis dans le corps de la requête au format GeoJSON.

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

Les paramètres inclus dans le corps de la requête HTTP POST sont fournis en tant que GeoJSON.

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

Exemple de réponse pour la plage de routage, version 1.0

Les résultats de la réponse sont tronqués pour la concision.

{ 
  "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 
      } 
    ] 
  } 
}

Exemple de réponse pour Route Range, version 2025-01-01

Les résultats de la réponse sont tronqués pour la concision.

{ 
  "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