Compartir a través de


Traffic - Get Traffic Incident Detail

Use para obtener información sobre los incidentes de tráfico dentro de un rectángulo delimitador determinado.

La Traffic Incident Detail API es una solicitud HTTP GET que proporciona información sobre los incidentes de tráfico dentro de un cuadro de límite determinado, en función del identificador del modelo de tráfico actual. El identificador del modelo de tráfico está disponible para conceder sincronización de datos entre las llamadas y las API. El identificador del modelo de tráfico es un valor clave para determinar la moneda de los incidentes de tráfico. Se actualiza cada minuto y es válido durante dos minutos antes de que se agote el tiempo de espera. Se usa en la representación de iconos de incidentes. Se puede obtener de viewport API.

GET https://atlas.microsoft.com/traffic/incident/detail/{format}?api-version=1.0&style={style}&boundingbox={boundingbox}&boundingZoom={boundingZoom}&trafficmodelid={trafficmodelid}
GET https://atlas.microsoft.com/traffic/incident/detail/{format}?api-version=1.0&style={style}&boundingbox={boundingbox}&boundingZoom={boundingZoom}&trafficmodelid={trafficmodelid}&language={language}&projection={projection}&geometries={geometries}&expandCluster={expandCluster}&originalPosition={originalPosition}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
format
path True

ResponseFormat

Formato deseado de la respuesta. El valor puede ser json o xml.

api-version
query True

string

Número de versión de la API de Azure Maps.

boundingbox
query True

number[]

boundingbox se representa mediante dos pares de valores que describen las esquinas (primer par para la esquina inferior izquierda y la segunda para la esquina superior derecha). Los pares se pueden especificar mediante cualquiera de los projectionpares especificados a continuación (por ejemplo, minY,minY,maxY,maxY,maxX) o por dos pares de longitud de latitud (por ejemplo, minLat,minLon,maxLat,maxLon).

NOTA: Si se usan pares de latitud y longitud, el projection parámetro debe establecerse en "EPSG4326".

boundingZoom
query True

integer

int32

Nivel de zoom para el icono deseado. De 0 a 22 para mosaicos ráster, de 0 a 22 para mosaicos vectoriales

style
query True

IncidentDetailStyle

Estilo que se usará para representar el icono en Traffic Incident Tile API. Esto tendrá un efecto en las coordenadas de los incidentes de tráfico en la respuesta.

trafficmodelid
query True

string

Número que hace referencia al modelo de tráfico. Esto se puede obtener de viewport API. Se actualiza cada minuto y es válido durante dos minutos antes de que se agote el tiempo de espera. Si se especifica el identificador de modelo de tráfico incorrecto, la interfaz devolverá la correcta. Un valor de -1 siempre invocará el modelo de tráfico más reciente.

expandCluster
query

boolean

Boolean para indicar si se van a enumerar todos los incidentes de tráfico de un clúster por separado.

geometries
query

IncidentGeometryType

Tipo de geometría vectorial agregada a incidentes (devuelto en el elemento de la respuesta).

language
query

string

Código ISO 639-1 para el lenguaje de salida. Los idiomas admitidos son ar, ca, cs, da, de, el, en, en-GB, en-US, es, et, fi, fr, he, hu, id, in*, it, lt, lv, nb, nl, no, pl, pt, ro, ru, sk, sv, th, tr, zh.

Consulte Idiomas admitidos para obtener más información. Cuando se proporciona código de idioma no válido, se devuelve la respuesta en inglés. Cuando la causa o descripción del incidente no tiene traducción, se devuelve la descripción en inglés.

originalPosition
query

boolean

Boolean sobre si se va a devolver la posición original del incidente () así como el que se desplaza al principio del tubo de tráfico ()

projection
query

ProjectionStandard

Proyección usada para especificar las coordenadas de la solicitud y la respuesta. EPSG900913 (valor predeterminado) o EPSG4326

Encabezado de la solicitud

Nombre Requerido Tipo Description
x-ms-client-id

string

Especifica qué cuenta está pensada para su uso junto con el modelo de seguridad de Id. de Entra de Microsoft. Representa un identificador único para la cuenta de Azure Maps y se puede recuperar de la API de cuenta del plano de administración de Azure Maps. Para usar la seguridad de id. de Entra de Microsoft en Azure Maps, consulte los siguientes artículos para obtener instrucciones.

Respuestas

Nombre Tipo Description
200 OK

TrafficIncidentDetail

Aceptar

Other Status Codes

ErrorResponse

Se ha producido un error inesperado.

Seguridad

AADToken

Estos son los flujos de Microsoft Entra OAuth 2.0 . Cuando se empareja con el control de acceso basado en rol de Azure , se puede usar para controlar el acceso a las API REST de Azure Maps. Los controles de acceso basados en roles de Azure se usan para designar el acceso a una o varias cuentas de recursos o subrecursos de Azure Maps. Se puede conceder acceso a cualquier usuario, grupo o entidad de servicio mediante un rol integrado o un rol personalizado compuesto por uno o varios permisos para las API REST de Azure Maps.

Para implementar escenarios, se recomienda ver los conceptos de autenticación. En resumen, esta definición de seguridad proporciona una solución para modelar aplicaciones a través de objetos capaces de controlar el acceso en determinadas API y ámbitos.

Notas

  • Esta definición de seguridad requiere el uso del x-ms-client-id encabezado para indicar a qué recurso de Azure Maps solicita acceso la aplicación. Esto se puede adquirir desde la API de administración de Maps .

Authorization URL es específico de la instancia de nube pública de Azure. Las nubes soberanas tienen direcciones URL de autorización únicas y configuraciones de id. de Microsoft Entra. * El control de acceso basado en rol de Azure se configura desde el plano de administración de Azure mediante Azure Portal, PowerShell, la CLI, los SDK de Azure o las API REST. * El uso del SDK web de Azure Maps permite la configuración basada en la configuración de una aplicación para varios casos de uso.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

Se trata de una clave compartida que se aprovisiona al crear una cuenta de Azure Maps en Azure Portal o mediante PowerShell, la CLI, los SDK de Azure o la API REST.

Con esta clave, cualquier aplicación puede acceder a todas las API REST. En otras palabras, esta clave se puede usar como clave maestra en la cuenta en la que se emiten.

En el caso de las aplicaciones expuestas públicamente, nuestra recomendación es usar el enfoque de aplicaciones cliente confidenciales para acceder a las API REST de Azure Maps para que la clave se pueda almacenar de forma segura.

Tipo: apiKey
En: query

SAS Token

Se trata de un token de firma de acceso compartido que se crea a partir de la operación List SAS en el recurso de Azure Maps a través del plano de administración de Azure a través de Azure Portal, PowerShell, la CLI, los SDK de Azure o las API REST.

Con este token, cualquier aplicación está autorizada para acceder a los controles de acceso basado en roles de Azure y al control específico de la expiración, la tasa y las regiones de uso para el token determinado. Es decir, el token de SAS se puede usar para permitir que las aplicaciones controlen el acceso de forma más segura que la clave compartida.

En el caso de las aplicaciones expuestas públicamente, nuestra recomendación es configurar una lista específica de orígenes permitidos en el recurso de la cuenta de mapa para limitar la representación de abusos y renovar periódicamente el token de SAS.

Tipo: apiKey
En: header

Ejemplos

Request information about a traffic incident

Solicitud de ejemplo

GET https://atlas.microsoft.com/traffic/incident/detail/json?api-version=1.0&style=s3&boundingbox=6841263.950712,511972.674418,6886056.049288,582676.925582&boundingZoom=11&trafficmodelid=1335294634919

Respuesta de muestra

{
  "tm": {
    "@id": "1521671948910",
    "poi": [
      {
        "id": "europe_HD_NL_TTR116377227776064",
        "p": {
          "x": 538636.9,
          "y": 6842004.5
        },
        "ic": 9,
        "ty": 1,
        "cs": 0,
        "d": "roadworks",
        "c": "new roadworks layout",
        "f": "Amstelveen/Vinkeveen - N201 (N196)",
        "t": "Uithoorn-Centrum (N196)",
        "l": 220,
        "dl": 14,
        "r": "N196"
      },
      {
        "id": "europe_CLUSTER_11_-34959639",
        "p": {
          "x": 528668.6,
          "y": 6848897.9
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 528622.5,
          "y": 6848661.2
        },
        "ctr": {
          "x": 528714.7,
          "y": 6849134.6
        },
        "cs": 2,
        "l": 190
      },
      {
        "id": "europe_CLUSTER_11_-1540737434",
        "p": {
          "x": 518277,
          "y": 6852206.8
        },
        "ic": 9,
        "ty": 1,
        "cbl": {
          "x": 517421.3,
          "y": 6851776.4
        },
        "ctr": {
          "x": 519132.8,
          "y": 6852637.2
        },
        "cs": 2,
        "l": 1620
      },
      {
        "id": "europe_CLUSTER_11_-26712906",
        "p": {
          "x": 529902.2,
          "y": 6855622.4
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 529524.6,
          "y": 6855377.2
        },
        "ctr": {
          "x": 530279.9,
          "y": 6855867.7
        },
        "cs": 4,
        "l": 660
      },
      {
        "id": "europe_HD_NL_TTR116367997504816",
        "p": {
          "x": 568216,
          "y": 6851287.6
        },
        "ic": 9,
        "ty": 1,
        "cs": 0,
        "d": "roadworks",
        "c": "new roadworks layout",
        "f": "Ankeveen (N236)",
        "t": "Weesp (N236)",
        "l": 2760,
        "dl": 73,
        "r": "N236"
      },
      {
        "id": "europe_HD_NL_TTR116367997261488",
        "p": {
          "x": 561973.7,
          "y": 6854259.4
        },
        "ic": 9,
        "ty": 3,
        "cs": 0,
        "d": "roadworks",
        "c": "new roadworks layout",
        "f": "Weesp (N236)",
        "t": "Ankeveen (N236)",
        "l": 2650,
        "r": "N236"
      },
      {
        "id": "europe_HD_NL_TTR116331064819392",
        "p": {
          "x": 571268.5,
          "y": 6858435.4
        },
        "ic": 8,
        "ty": 4,
        "cs": 0,
        "d": "closed",
        "f": "IJsselmeerweg",
        "t": "A6",
        "l": 370
      },
      {
        "id": "europe_CLUSTER_11_-1442937814",
        "p": {
          "x": 563934,
          "y": 6859271.3
        },
        "ic": 9,
        "ty": 1,
        "cbl": {
          "x": 563726.1,
          "y": 6859250.4
        },
        "ctr": {
          "x": 564141.9,
          "y": 6859292.2
        },
        "cs": 2,
        "l": 460
      },
      {
        "id": "europe_CLUSTER_11_258400781",
        "p": {
          "x": 558055.6,
          "y": 6861147.1
        },
        "ic": 13,
        "ty": 1,
        "cbl": {
          "x": 557493.3,
          "y": 6860514.8
        },
        "ctr": {
          "x": 558618,
          "y": 6861779.4
        },
        "cs": 3,
        "l": 1030
      },
      {
        "id": "europe_HD_NL_TTR116100227865681",
        "p": {
          "x": 542665,
          "y": 6861959.7
        },
        "ic": 8,
        "ty": 4,
        "cs": 0,
        "d": "closed",
        "f": "Strawinskylaan",
        "t": "Matthijs Vermeulenpad",
        "l": 110
      },
      {
        "id": "europe_CLUSTER_11_1438243625",
        "p": {
          "x": 545058.7,
          "y": 6864571.6
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 543779.5,
          "y": 6864070.7
        },
        "ctr": {
          "x": 546337.8,
          "y": 6865072.6
        },
        "cs": 5,
        "l": 1590
      },
      {
        "id": "europe_HD_NL_TTR116081762316976",
        "p": {
          "x": 547507.8,
          "y": 6866259.3
        },
        "ic": 8,
        "ty": 4,
        "cs": 0,
        "d": "closed",
        "f": "Alexanderplein (s113)",
        "t": "Stadhouderskade",
        "l": 390,
        "r": "S100"
      },
      {
        "id": "europe_CLUSTER_11_691732516",
        "p": {
          "x": 541448.7,
          "y": 6867162.1
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 541160.1,
          "y": 6866710.7
        },
        "ctr": {
          "x": 541737.2,
          "y": 6867613.5
        },
        "cs": 4,
        "l": 430
      },
      {
        "id": "europe_CLUSTER_11_1582351486",
        "p": {
          "x": 534709.6,
          "y": 6865174.7
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 534562.2,
          "y": 6865025.3
        },
        "ctr": {
          "x": 534856.9,
          "y": 6865324.2
        },
        "cs": 2,
        "l": 380
      },
      {
        "id": "europe_CLUSTER_11_-2070222267",
        "p": {
          "x": 536813.1,
          "y": 6868188.3
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 536191.1,
          "y": 6867699.7
        },
        "ctr": {
          "x": 537435.1,
          "y": 6868677
        },
        "cs": 7,
        "l": 1380
      },
      {
        "id": "europe_CLUSTER_11_-496866890",
        "p": {
          "x": 516025.5,
          "y": 6871606.3
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 514115.1,
          "y": 6870216.9
        },
        "ctr": {
          "x": 517935.9,
          "y": 6872995.7
        },
        "cs": 7,
        "l": 1510
      },
      {
        "id": "europe_HD_NL_TTR115675492352160",
        "p": {
          "x": 517835.3,
          "y": 6883216.3
        },
        "ic": 8,
        "ty": 4,
        "cs": 0,
        "d": "closed",
        "f": "Amsterdamseweg",
        "t": "A22",
        "l": 710
      },
      {
        "id": "europe_CLUSTER_11_834920993",
        "p": {
          "x": 543803.8,
          "y": 6875659.8
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 543474.7,
          "y": 6875602.7
        },
        "ctr": {
          "x": 544133,
          "y": 6875716.9
        },
        "cs": 2,
        "l": 760
      }
    ]
  }
}

Definiciones

Nombre Description
DelayMagnitude

Magnitud del retraso asociado al incidente. Estos valores corresponden a colores de incidentes en los iconos de tráfico

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

IconCategory

Categoría de icono asociada a este incidente. Los valores son números en el intervalo 0-13, con los siguientes significados -- 0: Desconocido, 1: Accidente, 2: Niebla, 3: Condiciones peligrosas, 4: Lluvia, 5: Hielo, 6: Jam, 7: Carril cerrado, 8: Carretera cerrada, 9: Obras viales, 10: Viento, 11: Inundación, 12: Desvío, 13: Clúster

IncidentDetailStyle

Estilo que se usará para representar el icono en Traffic Incident Tile API. Esto tendrá un efecto en las coordenadas de los incidentes de tráfico en la respuesta.

IncidentGeometryType

Tipo de geometría vectorial agregada a incidentes (devuelto en el elemento de la respuesta).

Point

Representación genérica de un punto con coordenadas (x, y) en el plano cartesiano.

ProjectionStandard

Proyección usada para especificar las coordenadas de la solicitud y la respuesta. EPSG900913 (valor predeterminado) o EPSG4326

ResponseFormat

Formato deseado de la respuesta. El valor puede ser json o xml.

Tm

Elemento de respuesta principal

TrafficIncidentDetail

Este objeto se devuelve de una llamada de detalle de incidente de tráfico correcta.

TrafficIncidentPointOfInterest

DelayMagnitude

Magnitud del retraso asociado al incidente. Estos valores corresponden a colores de incidentes en los iconos de tráfico

Nombre Tipo Description
0

Integer

Desconocido

1

Integer

Escasa

2

Integer

Media

3

Integer

Alta

4

Integer

Indefinido (utilizado para cierres de carreteras y otros retrasos indefinidos)

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Los detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

IconCategory

Categoría de icono asociada a este incidente. Los valores son números en el intervalo 0-13, con los siguientes significados -- 0: Desconocido, 1: Accidente, 2: Niebla, 3: Condiciones peligrosas, 4: Lluvia, 5: Hielo, 6: Jam, 7: Carril cerrado, 8: Carretera cerrada, 9: Obras viales, 10: Viento, 11: Inundación, 12: Desvío, 13: Clúster

Nombre Tipo Description
0

Integer

Desconocido

1

Integer

Accidente

10

Integer

Wind

11

Integer

Inundación

12

Integer

Desvío

13

Integer

Clúster: se devuelve si un clúster contiene incidentes con diferentes categorías de iconos.

14

Integer

Vehículo desglosado

2

Integer

Niebla

3

Integer

Condiciones peligrosas

4

Integer

Lluvia

5

Integer

Hielo

6

Integer

Mermelada

7

Integer

Carril cerrado

8

Integer

Carretera cerrada

9

Integer

Obras viales

IncidentDetailStyle

Estilo que se usará para representar el icono en Traffic Incident Tile API. Esto tendrá un efecto en las coordenadas de los incidentes de tráfico en la respuesta.

Nombre Tipo Description
night

string

Estilo nocturno.

s1

string

Crea líneas de tráfico con marcadores de contenido adicional coloreados que indican la gravedad.

s2

string

Crea líneas sin formato con cierto grado de brillo.

s3

string

Crea líneas sin formato con cierto grado de brillo, diferente del estilo s2.

IncidentGeometryType

Tipo de geometría vectorial agregada a incidentes (devuelto en el elemento de la respuesta).

Nombre Tipo Description
original

string

Coloca incidentes precisamente en la carretera.

shifted

string

Mueve el incidente ligeramente (dependiendo del nivel de zoom) para indicar carriles de carretera específicos.

Point

Representación genérica de un punto con coordenadas (x, y) en el plano cartesiano.

Nombre Tipo Description
x

number

Coordenada x

y

number

Coordenada y

ProjectionStandard

Proyección usada para especificar las coordenadas de la solicitud y la respuesta. EPSG900913 (valor predeterminado) o EPSG4326

Nombre Tipo Description
EPSG4326

string

EPSG4326

EPSG900913

string

EPSG900913

ResponseFormat

Formato deseado de la respuesta. El valor puede ser json o xml.

Nombre Tipo Description
json

string

Formato de intercambio de datos de notación de objetos JavaScript

xml

string

Lenguaje de marcado extensible

Tm

Elemento de respuesta principal

Nombre Tipo Description
@id

string

Identificador del modelo de tráfico para este incidente

poi

TrafficIncidentPointOfInterest[]

Un único incidente de tráfico o un clúster de incidentes de tráfico

TrafficIncidentDetail

Este objeto se devuelve de una llamada de detalle de incidente de tráfico correcta.

Nombre Tipo Description
tm

Tm

Elemento de respuesta principal

TrafficIncidentPointOfInterest

Nombre Tipo Description
c

string

Causa del incidente, cuando está disponible, en el idioma solicitado

cbl

Point

Coordenada inferior izquierda del clúster en la proyección de la solicitud

cs

integer

Tamaño del clúster: el número de incidentes del clúster

ctr

Point

Coordenada superior derecha del clúster en la proyección de la solicitud

d

string

Descripción del incidente en el idioma solicitado

dl

integer

Retraso causado por el incidente en segundos (excepto en cierres de carretera)

ed

string

Fecha de finalización estimada del incidente, si está disponible. La fecha se describe en el formato ISO8601.

f

string

From: el nombre de la intersección o la ubicación donde se inicia el tráfico debido al incidente.

ic

IconCategory

Categoría de icono asociada a este incidente. Los valores son números en el intervalo 0-13, con los siguientes significados -- 0: Desconocido, 1: Accidente, 2: Niebla, 3: Condiciones peligrosas, 4: Lluvia, 5: Hielo, 6: Jam, 7: Carril cerrado, 8: Carretera cerrada, 9: Obras viales, 10: Viento, 11: Inundación, 12: Desvío, 13: Clúster

id

string

Identificador del incidente de tráfico

l

integer

Longitud del incidente en metros

p

Point

Punto en el que se debe dibujar un icono del clúster o incidente sin procesar, expresado en la proyección solicitada. Esto se ve afectado por el estilo de tráfico, el nivel de zoom y el tipo de carretera.

r

string

Los números de carretera afectados por el incidente. Varios números de carretera se delimitarán por barras diagonales

sd

string

Fecha de inicio del incidente, si está disponible. La fecha se describe en el formato ISO8601.

t

string

Para: el nombre de la intersección o la ubicación donde finaliza el tráfico debido al incidente

ty

DelayMagnitude

Magnitud del retraso asociado al incidente. Estos valores corresponden a colores de incidentes en los iconos de tráfico