Partilhar via

Migrar APIs do Azure Maps Traffic 1.0

Este artigo fornece orientação sobre como migrar o serviço Azure Maps Traffic v1 para outros serviços do Azure Maps.

A tabela a seguir descreve todos os serviços de Tráfego, juntamente com suas respetivas opções de migração.

Azure Maps Traffic v1.0 Opção de migração do Azure Maps
Obter Segmento de Fluxo de Tráfego Sem substituição direta.
Os blocos de mapa podem ser usados para visualizar o fluxo de tráfego, mas a velocidade e o tempo de viagem não estão disponíveis.
Obter Mosaico de Fluxo de Tráfego
- Absoluto
- Sensibilidade reduzida
- Relativo
- Atraso relativo 		Obter mosaico do mapa
TilesetID 
- Microsoft.Traffic.Absolute (vetor)
- Microsoft.Traffic.Absolute.Main (raster)
- Microsoft.Traffic.Relative (vetor)
- Microsoft.Traffic.Relative.Dark (raster)
- Microsoft.Traffic.Relative.Main (raster)
- Microsoft.Traffic.Delay (vetor)
- Microsoft.Traffic.Delay.Main (raster)
- Microsoft.Tráfego.Reducido.Principal (raster)
Obter detalhes de incidentes de trânsito Obter Informações sobre Incidentes de Trânsito 
Obter Mosaico de Incidentes de Trânsito Obter mosaico do mapa 
TilesetID 
- Microsoft.Traffic.Incident (vetor)
Obter Visualização de Incidentes de Trânsito Sem substituição.
Retorna o ID do modelo de tráfego usado pelo serviço Traffic v1, mas não é necessário para o tráfego mais recente ou serviços de renderização.

Diferenças notáveis

  • Ao contrário do serviço Traffic v1.0, a API Get Traffic Incident do Azure Maps mais recente e o serviço Get Map Tile API do serviço de renderização não exigem uma ID de modelo de tráfego.

  • A caixa delimitadora de entrada do Get Traffic Incident v2025-01-01 e a resposta estão no formato GeoJSON.

  • O Segmento de Fluxo de Tráfego v1.0 fornece informações sobre as velocidades dos veículos e os tempos de viagem do segmento rodoviário. Essas informações não estão disponíveis na versão mais recente, mas os dados de tráfego podem ser visualizados usando a API Render Get Map Tile .

  • Para atribuir uma categoria de ícone aos pontos retornados por Get Traffic Incident v2025-01-01, use o incidentType enum fornecido na resposta.

  • Os blocos de mapa de tráfego estão disponíveis em formato vetorial e raster no serviço Renderizar usando a API Get Map Tile .

Utilização de transações

Para obter informações sobre como as transações são calculadas para os serviços de Tráfego e Renderização, consulte Noções básicas sobre transações do Azure Maps.

Exemplos de serviços de tráfego

Esta seção fornece exemplos de solicitações e respostas para as versões 1.0 e 2025-01-01 da API de Incidente de Tráfego e a versão 2024-04-01 da API de Mosaico de Mapa de Renderização.

Exemplo de Incidente de Tráfego versão 1.0

A versão 1.0 da API de Incidente de Tráfego é uma solicitação HTTP GET que retorna todos os incidentes de tráfego dentro da caixa delimitadora especificada.

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}

A resposta contém todos os incidentes de tráfego dentro da área delimitada especificada, no formato JSON. Os resultados são truncados para maior brevidade.

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

Exemplo de Incidente de Tráfego versão 2025-01-01

A versão 2025-01-01 da API de Incidente de Tráfego é uma solicitação HTTP GET que retorna todos os incidentes de tráfego dentro da caixa delimitadora especificada.

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

A resposta contém todos os incidentes de tráfego dentro da caixa delimitadora especificada no formato GeoJSON. O exemplo a seguir mostra um único incidente de trânsito do tipo "Acidente":

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

Azure Maps Render Obter Mosaico de Mapa v2024-04-01

A API de Mosaico Get Map do Azure Maps Render é uma solicitação HTTP GET que retorna blocos de vetor de tráfego relativo.

Pedido de Exemplo

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}

Exemplo de resposta

Tipo de conteúdo: application/vnd.mapbox-vector-tile

sequência de imagem binária

  • Last updated on