Condividi tramite

Eseguire la migrazione delle API Route 1.0 di Azure Maps

Questo articolo illustra come eseguire la migrazione delle API di Mappe di Azure Route v1.0 alle API di Mappe di Azure Route v2025-01-01 . La tabella seguente mostra le API di Route v1.0 e le opzioni di migrazione.

Route di Mappe di Azure v1.0 Opzioni di migrazione di Azure Maps Route v2025-01-01
Ottieni indicazioni stradali  Post Route Directions: l'API Get Route Directions non è più supportata.
Get Route Directions Batch  Il batch asincrono di indicazioni di percorso non è attualmente disponibile. Utilizzare invece Post Route Directions Batch.
Indicazioni stradali per posta  Indicazioni stradali per posta  
Post Route Directions Batch  Post Route Directions Batch: il batch asincrono di indicazioni percorso non è attualmente disponibile, usare il batch sincrono.
Sincronizzazione batch delle indicazioni di percorso  Post Route Directions Batch 
Ottieni la matrice di percorso  Get Route Operation Result: consente di ottenere il risultato delle chiamate asincrone alla matrice di percorsi.
Get Route Operations Status: consente di ottenere lo stato delle chiamate asincrone alla matrice di percorsi.
Matrice di percorso postale  Post Route Matrix Async 
Post Route Matrix Sync  Matrice di percorso postale 
Ottieni intervallo di percorso  Gamma di rotta POST: la GET richiesta non è più supportata.

Differenze rilevanti

Direzioni del percorso Differenze notevoli

Caratteristica / Funzionalità v1.0 v2025-01-01
Operazioni batch Richieste di sincronizzazione e asincrone Richieste di sincronizzazione
Formato delle coordinate Latitudine/longitudine Longitudine/latitudine, come definito da GeoJSON.
Modello di consumo elettrico Sostenuto Non supportato
Localizzazione Utilizzare il parametro "language" per localizzare la lingua delle istruzioni del percorso. Usare l'intestazione della richiesta "Accept-Language" per immettere un codice di localizzazione per impostare la lingua delle istruzioni del percorso.
Tipo di richiesta GET, POST POST
Formato della risposta XML, JSON GeoJSON
Modalità viaggio Auto, camion, pedoni.
Profili beta: Autobus, bicicletta, moto, taxi, furgone.		 Auto, camion, pedoni.
Ottimizzazione dei waypoint Sostenuto supportato
Punti di passaggio Sostenuto Supportato. Supporta viaWaypoints anche le modalità di guida e camminata.

Differenze notevoli nella matrice di route

Caratteristica / Funzionalità v1.0 v2025-01-01
Formato delle coordinate Longitudine/latitudine Longitudine/latitudine
Modello di consumo elettrico Sostenuto Non supportato
Coordinate di input Usa le funzionalità GeoJSON MultiPoint per le coordinate di input, ma la richiesta è in JSON. Un tipo di geometria GeoJSON MultiPoint valido.
Matrice: Richieste asincrone Fino a 700 celle Fino a 50.000 celle
Matrice: Richieste sincronizzate Fino a 100 celle Fino a 2.500 celle
Formato della risposta JSON GeoJSON (input e risposta)
Modalità viaggio Auto, camion, pedoni.
Profili beta: Autobus, bicicletta, moto, taxi, furgone.		 Auto, camion, pedoni.

Differenze notevoli nell'intervallo di percorso

Caratteristica / Funzionalità v1.0 v2025-01-01
Formato delle coordinate Latitudine/Longitudine Longitudine/latitudine, come definito da GeoJSON.
Modello di consumo elettrico Sostenuto Non supportato
Tipo di richiesta GET, POST POST
Formato della risposta XML, JSON GeoJSON (input e risposta)
Modalità di viaggio Auto, camion.
Profili beta: autobus, moto, taxi, furgoni		 Auto, Camion

Utilizzo delle transazioni

Per informazioni sulla modalità di calcolo delle transazioni, vedere Informazioni sulle transazioni di Mappe di Azure.

Esempi di servizio di pianificazione percorso

Questa sezione fornisce esempi di richieste e risposte sia per la versione 1.0 che per la versione 2025-01-01 per l'API Route Direction, Route Matrix e Route Range .

Esempi di indicazioni stradali

Richiesta di esempio di Route Directions versione 1.0

L'API Route Directions nella versione 1.0 è una richiesta HTTP GET . Tutti i parametri vengono passati come parametri della stringa di query.

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}

Esempio di richiesta di indicazioni stradali versione 2025-01-01

L'API Route Directions nella versione 2025-01-01 è una richiesta HTTP POST . I parametri possono essere inclusi nella chiamata API come parametri della stringa di query, con altri parametri forniti nel corpo della richiesta utilizzando il formato GeoJSON.

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

I parametri inclusi nel corpo della richiesta HTTP POST vengono forniti come 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" 
      } 
    } 
  ] 
}

Esempio di risposta Route Directions versione 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" 
        } 
      ] 
    } 
  ] 
}

Esempio di risposta Indicazioni stradali versione 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" 
          } 
        ] 
      } 
    } 
  ] 
}

Esempi di matrice di percorsi

Richiesta di esempio per la matrice di percorsi versione 1.0

L'API Post Route Matrix Sync nella versione 1.0 è una richiesta HTTP POST . I parametri possono essere passati come parametri della stringa di query e nel corpo della richiesta utilizzando il formato GeoJSON.

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

I parametri inclusi nel corpo della richiesta HTTP POST vengono forniti come JSON.

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

Richiesta di esempio Route Matrix versione 2025-01-01

L'API Route Matrix nella versione 2025-01-01 è una richiesta HTTP POST . I parametri vengono passati come parametri della stringa di query e nel corpo della richiesta utilizzando il formato GeoJSON.

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

I parametri inclusi nel corpo della richiesta HTTP POST vengono forniti come 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" 
}

Esempio di risposta Route Matrix versione 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 
  } 
}

Esempio di risposta Route Matrix versione 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 
      } 
    ] 
  } 
}

Esempi di intervalli di percorsi

Richiesta di esempio di intervallo percorso versione 1.0

L'API Route Range nella versione 1.0 è una richiesta HTTP GET . Tutti i parametri vengono passati come parametri della stringa di query.

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}

Richiesta di esempio di intervallo percorso versione 2025-01-01

L'API Route Range nella versione 2025-01-01 è una richiesta HTTP POST . I parametri possono essere inclusi nella chiamata API come parametri della stringa di query, con altri parametri forniti nel corpo della richiesta utilizzando il formato GeoJSON.

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

I parametri inclusi nel corpo della richiesta HTTP POST vengono forniti come GeoJSON.

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

Esempio di risposta Route Range versione 1.0

I risultati della risposta vengono troncati per brevità.

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

Esempio di risposta Route Range versione 2025-01-01

I risultati della risposta vengono troncati per brevità.

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