Freigeben über

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  Wegbeschreibung nach der Veröffentlichung: Das Abrufen von Wegbeschreibungen wird nicht mehr unterstützt.
Abrufen des Batches "Route Directions"  Der asynchrone Batch "Route Directions" ist derzeit nicht verfügbar. Verwenden Sie stattdessen den Batch "Wegbeschreibung posten".
Wegbeschreibung nach dem Posten der Route  Wegbeschreibung nach dem Posten der Route  
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.
Batch-Synchronisierung von Wegbeschreibungen posten  Batch für Post-Routenanweisungen 
Abrufen der Routenmatrix  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  Asynchrone Post-Route-Matrix 
Nach der Synchronisierung der Routenmatrix  Veröffentlichen der Routenmatrix 
Routenbereich abrufen  Post-Route-Bereich: Die GET Anforderung wird nicht mehr unterstützt.

Wichtige Unterschiede

Routenbeschreibung Bemerkenswerte Unterschiede

Merkmal v1.0 Nr. 2025-01-01
Batchvorgänge Synchronisierung und asynchrone Anforderungen Synchronisieren von Anforderungen
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, mit dem die Sprache der Routenanweisungen lokalisiert wird.
Anforderungstyp ABRUFEN, POSTEN SENDEN
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 Derzeit wird dies nur für die Routenplanung von Lkw unterstützt.
Wegpunkte Unterstützt Unterstützt. Unterstützt viaWaypoints auch den Fahr- und Gehmodus.

Bemerkenswerte Unterschiede in der Routenmatrix

Merkmal v1.0 Nr. 2025-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 Nr. 2025-01-01
Format der Koordinaten Breitengrad/Längengrad Längen-/Breitengrad, wie von GeoJSON definiert.
Modell des Stromverbrauchs Unterstützt Nicht unterstützt
Anforderungstyp ABRUFEN, POSTEN SENDEN
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}

Route Range Version 2025-01-01 Beispielanfrage

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 Version des Routenbereichs 2025-01-01

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