Compartir a través de

Migración de las API de Azure Maps Route 1.0

En este artículo se explica cómo migrar las API de Route v1.0 de Azure Maps a las API de Route v2025-01-01 de Azure Maps . En la tabla siguiente se muestran las API de Route v1.0 y las opciones de migración.

Ruta de Azure Maps v1.0 Opciones de migración de Route v2025-01-01 de Azure Maps
Obtener indicaciones de ruta  Post Route Directions: Get Route Directions ya no se admite.
Obtener lote de direcciones de ruta  El lote asincrónico de Route Directions no está disponible actualmente. En su lugar, use Post Route Directions Batch.
Direcciones de la ruta posterior  Direcciones de la ruta posterior  
Lote de direcciones de ruta posterior  Post Route Directions Batch: El lote asincrónico de direcciones de ruta no está disponible actualmente; en su lugar, use el lote sincrónico.
Sincronización por lotes de indicaciones posteriores a la ruta  Lote de direcciones de ruta posterior 
Obtener matriz de rutas  Get Route Operation Result: usar para obtener el resultado de las llamadas asincrónicas de Route Matrix.
Get Route Operations Status: usar para obtener el estado de las llamadas asincrónicas de Route Matrix.
Matriz de rutas postales  Matriz de ruta posterior asincrónica 
Sincronización de matriz de rutas postales  Matriz de rutas postales 
Obtener rango de ruta  Post Route Range: la solicitud GET ya no se admite.

Diferencias destacadas

Diferencias notables en las direcciones de ruta

Característica v1.0 v2025-01-01
Operaciones por lotes Solicitudes sincrónias y asincrónicas Solicitudes de sincronización
Formato de coordenadas Latitud/longitud Longitud y latitud, tal como se define en GeoJSON.
Modelo de consumo eléctrico Compatible No está soportado
Localización Use el parámetro "language" para localizar el idioma de las instrucciones de ruta. Use el encabezado de solicitud "Accept-Language" para escribir un código de localización para localizar el idioma de las instrucciones de ruta.
Tipo de solicitud OBTENER, PUBLICAR EXPONER
Formato de respuesta XML, JSON GeoJSON
Modo de desplazamiento Coche, camión, peatonal.
Perfiles beta: Bus, bicicleta, motocicleta, taxi, van.		 Coche, camión, peatonal.
Optimización de puntos de referencia Compatible Actualmente solo es compatible con las rutas de camiones.
Puntos de referencia Compatible Admitido. También admite viaWaypoints en los modos de conducción y caminata.

Diferencias notables en la matriz de rutas

Característica v1.0 v2025-01-01
Formato de coordenadas Longitud y latitud Longitud y latitud
Modelo de consumo eléctrico Compatible No está soportado
Coordenadas de entrada Usa las características de MultiPoint de GeoJSON para las coordenadas de entrada, pero la solicitud está en JSON. Un tipo de geometría GeoJSON MultiPoint válido.
Matrix: solicitudes asincrónicas Hasta 700 celdas Hasta 50 000 celdas
Matriz: solicitudes sincrónicas Hasta 100 celdas Hasta 2500 celdas
Formato de respuesta JSON GeoJSON (entrada y respuesta)
Modo de desplazamiento Coche, camión, peatonal.
Perfiles beta: Bus, bicicleta, motocicleta, taxi, van.		 Coche, camión, peatonal.

Diferencias notables en el rango de rutas

Característica v1.0 v2025-01-01
Formato de coordenadas Latitud/longitud Longitud y latitud, tal como se define en GeoJSON.
Modelo de consumo eléctrico Compatible No está soportado
Tipo de solicitud OBTENER, PUBLICAR EXPONER
Formato de respuesta XML, JSON GeoJSON (entrada y respuesta)
Modos de desplazamiento Coche, Camión.
Perfiles beta: autobús, motocicleta, taxi, van		 Coche, Camión

Uso de transacciones

Para obtener información sobre cómo se calculan las transacciones, consulte Descripción de las transacciones de Azure Maps.

Ejemplos de servicio de rutas

En esta sección se proporcionan solicitudes y respuestas de ejemplo para las versiones 1.0 y 2025-01-01 de las API de Dirección de Ruta, Matriz de Ruta y Rango de Ruta.

Ejemplos de direcciones de ruta

Solicitud de ejemplo Route Direction versión 1.0

Route Directions API en la versión 1.0 es una solicitud HTTPGET. Todos los parámetros se pasan como parámetros de cadena de consulta.

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}

Solicitud de ejemplo Route Directions versión 2025-01-01

Route Directions API en la versión 2025-01-01 es una solicitud HTTPPOST. Los parámetros se pueden incluir en la llamada API como parámetros de cadena de consulta, con más parámetros proporcionados en el cuerpo de la solicitud mediante el formato GeoJSON.

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

Los parámetros incluidos en el cuerpo de la solicitud HTTP POST se proporcionan como 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" 
      } 
    } 
  ] 
}

Ejemplo de respuesta route Directions versión 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" 
        } 
      ] 
    } 
  ] 
}

Ejemplo de respuesta Route Direction versión 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" 
          } 
        ] 
      } 
    } 
  ] 
}

Ejemplos de matriz de rutas

Solicitud de ejemplo de Route Matrix versión 1.0

Post Route Matrix Sync API en la versión 1.0 es una solicitud HTTPPOST. Los parámetros se pueden pasar como parámetros de cadena de consulta y en el cuerpo de la solicitud mediante el formato GeoJSON.

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

Los parámetros incluidos en el cuerpo de la solicitud HTTP POST se proporcionan como JSON.

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

Solicitud de ejemplo de la matriz de ruta versión 2025-01-01

Route Matrix API en la versión 2025-01-01 es una solicitud HTTPPOST. Los parámetros se pasan como parámetros de cadena de consulta y en el cuerpo de la solicitud mediante el formato GeoJSON.

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

Los parámetros incluidos en el cuerpo de la solicitud HTTP POST se proporcionan como 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" 
}

Ejemplo de respuesta route Matrix versión 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 
  } 
}

Ejemplo de respuesta de Route Matrix versión 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 
      } 
    ] 
  } 
}

Ejemplos de intervalos de rutas

Solicitud de ejemplo de route Range versión 1.0

Route Range API en la versión 1.0 es una solicitud HTTPGET. Todos los parámetros se pasan como parámetros de cadena de consulta.

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}

Ejemplo de solicitud de rango de rutas versión 2025-01-01

La Route Range API es una solicitud HTTP en la versión 2025-01-01. Los parámetros se pueden incluir en la llamada API como parámetros de cadena de consulta, con más parámetros proporcionados en el cuerpo de la solicitud mediante el formato GeoJSON.

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

Los parámetros incluidos en el cuerpo de la solicitud HTTP POST se proporcionan como GeoJSON.

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

Ejemplo de respuesta del rango de rutas versión 1.0

Los resultados de la respuesta se han truncado para mayor concisión.

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

Ejemplo de respuesta Route Range versión 2025-01-01

Los resultados de la respuesta se han truncado para mayor concisión.

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