Migrieren von Azure Maps Route 1.0-APIs

In diesem Artikel wird erläutert, wie Sie die Azure Maps Route v1.0-APIs zu Azure Maps Route v2025-01-01-APIs migrieren. In der folgenden Tabelle sind die Route v1.0-APIs und die Migrationsoptionen aufgeführt.

Azure Maps Route v1.0 Migrationsoptionen für Azure Maps Route v2025-01-01
Abrufen von Wegbeschreibungen  Gepostete Wegbeschreibungen: Das Abrufen von Wegbeschreibungen wird nicht mehr unterstützt.
Routenanweisungsstapel abrufen  Der asynchrone Batch "Route Directions" ist derzeit nicht verfügbar. Verwenden Sie stattdessen Post Route Directions Batch.
Postroutenanweisungen  Postroutenanweisungen  
Batch für Post-Routenanweisungen  Batch für Routenbeschreibungen posten: Der asynchrone Batch für Routenbeschreibungen ist derzeit nicht verfügbar, verwenden Sie stattdessen den Synchronisierungsbatch.
Post Route Directions Batch Sync  Batch für Post-Routenanweisungen 
Routenmatrix abrufen  Ergebnis des Routenvorgangs abrufen: Verwenden Sie diese Option, um das Ergebnis von asynchronen Routenmatrixaufrufen abzurufen.
Abrufen des Status von Routenvorgängen: Verwenden Sie diese Option, um den Status von asynchronen Routenmatrixaufrufen abzurufen.
Veröffentlichen der Routenmatrix  Post Route Matrix Async 
Post Route Matrix Sync  Veröffentlichen der Routenmatrix 
Routenbereich abrufen  Post Route Range: Die Anfrage GET wird nicht mehr unterstützt.

Wichtige Unterschiede

Routenbeschreibung Bemerkenswerte Unterschiede

Merkmal v1.0 v2025-01-01
Batchvorgänge Synchrone und asynchrone Anforderungen Synchronisierungsanfragen
Format der Koordinaten Breiten-/Längengrad Längen-/Breitengrad, wie von GeoJSON definiert.
Modell des Stromverbrauchs Unterstützt Nicht unterstützt
Lokalisierung Verwenden Sie den Parameter "language", um die Sprache der Routenanweisungen zu lokalisieren. Verwenden Sie den Anforderungsheader "Accept-Language", um einen Lokalisierungscode einzugeben, um die Sprache der Routenanweisungen zu lokalisieren.
Anforderungstyp GET, POST POST
Antwortformat XML, JSON GeoJSON
Reisemodus Auto, LKW, Fußgänger.
Beta-Profile: Bus, Fahrrad, Motorrad, Taxi, Van.		 Auto, LKW, Fußgänger.
Wegpunkt-Optimierung Unterstützt unterstützt
Wegpunkte Unterstützt Unterstützt. Unterstützt viaWaypoints auch den Fahr- und Gehmodus.

Bemerkenswerte Unterschiede in der Routenmatrix

Merkmal v1.0 v2025-01-01
Format der Koordinaten Längen-/Breitengrad Längen-/Breitengrad
Modell des Stromverbrauchs Unterstützt Nicht unterstützt
Eingabe-Koordinaten Verwendet GeoJSON-MultiPoint-Features für Eingabekoordinaten, aber die Anforderung erfolgt in JSON. Ein gültiger GeoJSON-MultiPoint-Geometrietyp.
Matrix: Asynchrone Anforderungen Bis zu 700 Zellen Bis zu 50.000 Zellen
Matrix: Synchrone Anforderungen Bis zu 100 Zellen Bis zu 2.500 Zellen
Antwortformat JSON GeoJSON (Eingabe und Antwort)
Reisemodus Auto, LKW, Fußgänger.
Beta-Profile: Bus, Fahrrad, Motorrad, Taxi, Van.		 Auto, LKW, Fußgänger.

Bemerkenswerte Unterschiede in der Routenreichweite

Merkmal v1.0 v2025-01-01
Format der Koordinaten Breitengrad/Längengrad Längen-/Breitengrad, wie von GeoJSON definiert.
Modell des Stromverbrauchs Unterstützt Nicht unterstützt
Anforderungstyp GET, POST POST
Antwortformat XML, JSON GeoJSON (Eingabe und Antwort)
Reisemodi Auto, LKW.
Beta-Profile: Bus, Motorrad, Taxi, Van		 Auto, LKW

Transaktionsnutzung

Informationen zum Berechnen von Transaktionen finden Sie unter Grundlegendes zu Azure Maps-Transaktionen.

Beispiele für Routendienste

Dieser Abschnitt enthält Beispielanforderungen und -antworten für Version 1.0 und 2025-01-01 für die Routenrichtung, die Routenmatrixund die Routenbereichs-API.

Beispiele für Routenbeschreibungen

Route Directions Version 1.0 Beispielanforderung

Bei der Route Directions API in Version 1.0 handelt es sich um eine HTTP-Anforderung GET . Alle Parameter werden als Abfragezeichenfolgenparameter übergeben.

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}

Anfahrtsbeschreibung Version 2025-01-01 Beispielanfrage

Bei der Route Directions API in Version 2025-01-01 handelt es sich um eine HTTP-Anforderung POST . Parameter können als Abfragezeichenfolgenparameter in den API-Aufruf eingeschlossen werden, wobei weitere Parameter im Anforderungstext im GeoJSON-Format bereitgestellt werden.

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

Parameter, die im Text der HTTP-Anforderung POST enthalten sind, werden als GeoJSON bereitgestellt.

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

Antwortbeispiel für 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" 
        } 
      ] 
    } 
  ] 
}

Antwortbeispiel für 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" 
          } 
        ] 
      } 
    } 
  ] 
}

Beispiele für Routenmatrix

Beispielanforderung für Route Matrix Version 1.0

Bei der Post Route Matrix Sync API in Version 1.0 handelt es sich um eine HTTP-Anforderung POST . Parameter können als Abfragezeichenfolgenparameter und im Text der Anforderung im GeoJSON-Format übergeben werden.

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

Parameter, die im Text der HTTP-Anforderung POST enthalten sind, werden als JSON bereitgestellt.

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

Route Matrix Version 2025-01-01 Beispielanforderung

Bei der Route Matrix API in Version 2025-01-01 handelt es sich um eine HTTP-Anforderung POST . Parameter werden als Abfragezeichenfolgenparameter und im Text der Anforderung im GeoJSON-Format übergeben.

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

Parameter, die im Text der HTTP-Anforderung POST enthalten sind, werden als GeoJSON bereitgestellt.

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

Antwortbeispiel für 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 
  } 
}

Antwortbeispiel für die 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 
      } 
    ] 
  } 
}

Beispiele für Routenbereiche

Beispielanforderung für Route Range Version 1.0

Bei der Route Range API in Version 1.0 handelt es sich um eine HTTP-Anforderung GET . Alle Parameter werden als Abfragezeichenfolgenparameter übergeben.

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}

Beispielanfrage für Route-Range-Version 2025-01-01

Bei der Route Range API in Version 2025-01-01 handelt es sich um eine HTTP-Anforderung POST . Parameter können als Abfragezeichenfolgenparameter in den API-Aufruf eingeschlossen werden, wobei weitere Parameter im Anforderungstext im GeoJSON-Format bereitgestellt werden.

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

Parameter, die im Text der HTTP-Anforderung POST enthalten sind, werden als GeoJSON bereitgestellt.

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

Antwortbeispiel für Route Range Version 1.0

Die Antwortergebnisse werden aus Gründen der Kürze abgeschnitten.

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

Antwortbeispiel für die Routenbereichs-Version vom 01.01.2025.

Die Antwortergebnisse werden aus Gründen der Kürze abgeschnitten.

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