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  Pubblica indicazioni stradali: Ottieni indicazioni stradali non è più supportato.
Ottieni il batch di indicazioni stradali  Il batch asincrono di Indicazioni stradali non è attualmente disponibile. Utilizzare invece Post Route Directions Batch.
Indicazioni stradali per posta  Indicazioni stradali per posta  
Registra batch indicazioni stradali  Registra batch indicazioni stradali: il batch asincrono Indicazioni stradali non è attualmente disponibile, utilizza invece il batch di sincronizzazione.
Registra la sincronizzazione batch delle indicazioni stradali  Registra batch indicazioni stradali 
Ottieni la matrice di route  Ottieni risultato operazione route: utilizzare per ottenere il risultato delle chiamate asincrone Route Matrix.
Ottieni stato operazioni di route: utilizzare per ottenere lo stato delle chiamate asincrone della matrice di route.
Matrice di percorso postale  Matrice di routing di posta asincrona 
Sincronizzazione matrice post route  Matrice di percorso postale 
Ottieni intervallo di route  Intervallo di route 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. Utilizzare l'intestazione della richiesta "Accept-Language" per inserire un codice di localizzazione per localizzare la lingua delle istruzioni del percorso.
Tipo di richiesta OTTIENI, PUBBLICA INSERISCI
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 Attualmente supportato solo per l'instradamento dei camion.
Punti di passaggio Sostenuto Supportato/a. 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 sincrone Fino a 100 celle Fino a 2.500 celle
Formato della risposta JSON (JavaScript Object Notation) 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 OTTIENI, PUBBLICA INSERISCI
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 route

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 route

Richiesta di esempio di matrice di route 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 route

Richiesta di esempio di intervallo route 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 route 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" 
      } 
    } 
  ] 
}