Compartir a través de

Migración de las API de Tráfico 1.0 de Azure Maps

En este artículo se proporcionan instrucciones sobre cómo migrar el servicio Traffic v1 de Azure Maps a otros servicios de Azure Maps.

En la tabla siguiente se describen todos los servicios de tráfico junto con sus respectivas opciones de migración.

Tráfico de Azure Maps v1.0 Opción de migración de Azure Maps
Get Traffic Flow Segment No hay reemplazo directo.
Los iconos de mapa se pueden usar para visualizar el flujo de tráfico, pero la velocidad y el tiempo de desplazamiento no están disponibles.
Get Traffic Flow Tile
-Absoluto
- Sensibilidad reducida
-Pariente
- Retraso relativo 		Obtener icono de mapa
TilesetID 
- microsoft.traffic.absolute (vector)
- microsoft.traffic.absolute.main (ráster)
- microsoft.traffic.relative (vector)
- microsoft.traffic.relative.dark (raster)
- microsoft.traffic.relative.main (raster)
- microsoft.traffic.delay (vector)
- microsoft.traffic.delay.main (ráster)
- microsoft.traffic.reduced.main (ráster)
Obtener detalles del incidente de tráfico Obtener incidente de tráfico 
Icono obtener incidentes de tráfico Obtener icono de mapa 
TilesetID 
- microsoft.traffic.incident (vector)
Obtener la ventanilla de incidentes de tráfico Sin reemplazo.
Devuelve el identificador del modelo de tráfico usado por el servicio Traffic v1, pero no es necesario para el tráfico más reciente ni para representar los servicios.

Diferencias destacadas

  • A diferencia del servicio Traffic v1.0, la api más reciente de obtención de incidentes de tráfico de Azure Maps y la API de obtención de iconos de mapa del servicio Render no requieren un identificador de modelo de tráfico.

  • El cuadro de límite de entrada Obtener incidente de tráfico v2025-01-01 y la respuesta están en formato GeoJSON.

  • Traffic Flow Segment v1.0 proporciona información sobre las velocidades del vehículo y los tiempos de desplazamiento del segmento de carretera. Esta información no está disponible en la versión más reciente, pero los datos de tráfico se pueden visualizar mediante la API Render Get Map Tile .

  • Para asignar una categoría de icono a los puntos devueltos por Get Traffic Incident v2025-01-01, use la incidentType enumeración proporcionada en la respuesta.

  • Los iconos de mapa de tráfico están disponibles en formato vectorial y ráster en el servicio Render mediante Get Map Tile API.

Uso de transacciones

Para obtener información sobre cómo se calculan las transacciones para los servicios de tráfico y representación, consulte Descripción de las transacciones de Azure Maps.

Ejemplos de servicio de tráfico

En esta sección se proporcionan solicitudes y respuestas de ejemplo para la versión 1.0 y 2025-01-01 de traffic Incident API y versión 2024-04-01 de Render Map Tile API.

Ejemplo de incidente de tráfico 1.0

La versión 1.0 de Traffic Incident API es una solicitud HTTP GET que devuelve todos los incidentes de tráfico dentro del cuadro de límite especificado.

https://atlas.microsoft.com/traffic/incident/detail/json?api-version=1.0&style=s3&boundingbox=37,-105,45,-94&boundingZoom=11&trafficmodelid=1335294634919&projection=EPSG4326&subscription-key={Your-Azure-Maps-Subscription-key}

La respuesta contiene todos los incidentes de tráfico dentro del cuadro de límite especificado en formato JSON. Los resultados se truncan para mayor brevedad.

{
  "tm": {
    "@id": "1742459680",
    "poi": [
      {
        "id": "CLUSTER_80251",
        "p": {
          "x": -105.0012712,
          "y": 39.7117135
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": -105.0038575,
          "y": 39.7096459
        },
        "ctr": {
          "x": -104.99992,
          "y": 39.7148278
        },
        "cs": 4,
        "l": 1132
      },
      {
        "id": "CLUSTER_80249",
        "p": {
          "x": -105.0070862,
          "y": 39.7491353
        },
        "ic": 13,
        "ty": 0,
        "cbl": {
          "x": -105.0214434,
          "y": 39.7391984
        },
        "ctr": {
          "x": -104.9985481,
          "y": 39.7597951
        },
        "cs": 12,
        "l": 2276
      }
    ]
  }
}

Ejemplo de incidente de tráfico versión 2025-01-01

La versión 2025-01-01 de Traffic Incident API es una solicitud HTTP GET que devuelve todos los incidentes de tráfico dentro del cuadro delimitador especificado.

https://atlas.microsoft.com/traffic/incident?api-version=2025-01-01&bbox=-105,37,-94,45&subscription-key={Your-Azure-Maps-Subscription-key}

La respuesta contiene todos los incidentes de tráfico dentro del cuadro de límite especificado en formato GeoJSON. En el ejemplo siguiente se muestra un único incidente de tráfico de tipo "Accidente":

{ 
  "type": "FeatureCollection", 
  "features": [ 
    { 
      "type": "Feature", 
      "id": 18558549332008001, 
      "geometry": { 
        "type": "Point", 
        "coordinates": [ 
          -104.939053, 
          39.682642 
        ] 
      }, 
      "properties": { 
        "startTime": "2025-09-12T09:31:37Z", 
        "endTime": "2025-09-12T10:21:47Z", 
        "description": "At CO 2/Colorado Boulevard (Denver) at Mile Point 204. Two right lanes are closed due to a crash.", 
        "title": "I-25 N / US-87 N", 
        "incidentType": "Accident", 
        "severity": 4, 
        "delay": null, 
        "lastModified": "2025-09-12T10:21:47Z", 
        "endPoint": { 
          "type": "Point", 
          "coordinates": [ 
            -104.940412, 
            39.68307 
          ] 
        }, 
        "isTrafficJam": false, 
        "isRoadClosed": false 
      } 
    } 
] 
}

Icono de obtención de mapa de Azure Maps v2024-04-01

La API de obtención de iconos de mapa de Render de Azure Maps es una solicitud HTTP GET que devuelve iconos de vectores de tráfico relativos.

Solicitud de ejemplo

https://atlas.microsoft.com/map/tile?api-version=2024-04-01&tilesetId=microsoft.traffic.relative&zoom=6&x=10&y=22&subscription-key={Your-Azure-Maps-Subscription-key}

Respuesta de ejemplo

Content-Type: application/vnd.mapbox-vector-tile

"cadena de imagen binaria"

  • Last updated on