Traffic - Get Traffic Incident

Layanan:: Maps

Versi API:: 2025-01-01

API Insiden Lalu Lintas menyediakan insiden lalu lintas seperti konstruksi, kemacetan lalu lintas, dan kecelakaan, dll. dalam kotak pembatas. Ini juga menyediakan metadata lalu lintas untuk informasi terperinci tentang setiap insiden.

API menyediakan kumpulan fitur GeoJSON dari insiden lalu lintas. Setiap insiden mencakup fitur dua titik: lokasi tempat Anda mengalami insiden dan lokasi akhir insiden lalu lintas seperti akhir zona konstruksi. For traffic incident coverage by country/region, see traffic coverage.

GET https://atlas.microsoft.com/traffic/incident?api-version=2025-01-01&bbox={bbox}

Dengan parameter opsional:

GET https://atlas.microsoft.com/traffic/incident?api-version=2025-01-01&incidentType={incidentType}&bbox={bbox}

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi

Nama	Dalam	Diperlukan	Jenis	Deskripsi
api-version	query	True	string	Nomor versi Azure Maps API.
bbox	query	True	number[]	Mendefinisikan area persegi panjang yang diminati di permukaan bumi. Sisi persegi panjang ditentukan oleh nilai bujur dan lintang dan harus mematuhi format GeoJSON: [minLon, minLat, maxLon, maxLat]. Untuk informasi selengkapnya, lihat RFC 7946, Bagian 5. Minimum Dimensions: The height or width of the bounding box must be at least 12 meters. Maximum Area: The bounding box can cover an area up to 10,000 square kilometers. Incident Inclusion: Traffic incidents will be included in the response if they overlap with the bounding box, or if their start, end, or any part of the incident passes through the bounding box. Lokasi awal dan akhir insiden dapat berada di luar kotak pembatas. Example: `bbox=-105,37,-94,45`
incidentType	query		IncidentType	Menentukan jenis insiden lalu lintas yang akan dikembalikan. Beberapa jenis insiden dalam satu permintaan didukung. Jika tidak ditentukan, hasilnya akan menyertakan semua jenis insiden dalam kotak pembatas yang disediakan. Contoh, '&incidentType=Accident' atau '&incidentType=Accident,Construction'.

api-version

query

True

string

Nomor versi Azure Maps API.

bbox

query

True

number[]

Mendefinisikan area persegi panjang yang diminati di permukaan bumi. Sisi persegi panjang ditentukan oleh nilai bujur dan lintang dan harus mematuhi format GeoJSON: [minLon, minLat, maxLon, maxLat]. Untuk informasi selengkapnya, lihat RFC 7946, Bagian 5.

Minimum Dimensions: The height or width of the bounding box must be at least 12 meters.
Maximum Area: The bounding box can cover an area up to 10,000 square kilometers.
Incident Inclusion: Traffic incidents will be included in the response if they overlap with the bounding box, or if their start, end, or any part of the incident passes through the bounding box. Lokasi awal dan akhir insiden dapat berada di luar kotak pembatas.

Example: bbox=-105,37,-94,45

incidentType

query

IncidentType

Menentukan jenis insiden lalu lintas yang akan dikembalikan. Beberapa jenis insiden dalam satu permintaan didukung. Jika tidak ditentukan, hasilnya akan menyertakan semua jenis insiden dalam kotak pembatas yang disediakan.

Contoh, '&incidentType=Accident' atau '&incidentType=Accident,Construction'.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
x-ms-client-id		string	Menentukan akun mana yang ditujukan untuk penggunaan bersama dengan model keamanan Azure AD. Ini mewakili ID unik untuk akun Azure Maps dan dapat diambil dari API Akun sarana manajemen Azure Maps. To use Azure AD security in Azure Maps see the following articles for guidance.
Accept-Language		string	Bahasa tempat hasil insiden lalu lintas harus dikembalikan. For more information, see Supported Languages for reference.

Nama

Diperlukan

Jenis

Deskripsi

x-ms-client-id

string

Menentukan akun mana yang ditujukan untuk penggunaan bersama dengan model keamanan Azure AD. Ini mewakili ID unik untuk akun Azure Maps dan dapat diambil dari API Akun sarana manajemen Azure Maps. To use Azure AD security in Azure Maps see the following articles for guidance.

Accept-Language

string

Bahasa tempat hasil insiden lalu lintas harus dikembalikan.

For more information, see Supported Languages for reference.

Respons

Nama	Jenis	Deskripsi
200 OK	TrafficIncidentResponse	OK
Other Status Codes	ErrorResponse	Terjadi kesalahan tak terduga.

Keamanan

AADToken

Ini adalah Microsoft Entra OAuth 2.0 Flows. Saat dipasangkan dengan akses berbasis peran Azure kontrol dapat digunakan untuk mengontrol akses ke REST API Azure Maps. Kontrol akses berbasis peran Azure digunakan untuk menunjuk akses ke satu atau beberapa akun sumber daya Atau sub-sumber daya Azure Maps. Setiap pengguna, grup, atau perwakilan layanan dapat diberikan akses melalui peran bawaan atau peran kustom yang terdiri dari satu atau beberapa izin ke REST API Azure Maps.

To implement scenarios, we recommend viewing authentication concepts. Singkatnya, definisi keamanan ini menyediakan solusi untuk memodelkan aplikasi melalui objek yang mampu mengontrol akses pada API dan cakupan tertentu.

Notes

This security definition requires the use of the x-ms-client-id header to indicate which Azure Maps resource the application is requesting access to. This can be acquired from the Maps management API.

Authorization URL khusus untuk instans cloud publik Azure. Sovereign cloud memiliki URL Otorisasi yang unik dan konfigurasi ID Microsoft Entra. * Kontrol akses berbasis peran Azure dikonfigurasi dari bidang manajemen Azure melalui portal Microsoft Azure, PowerShell, CLI, Azure SDK, atau REST API. * Penggunaan Azure Maps Web SDK memungkinkan penyiapan berbasis konfigurasi aplikasi untuk beberapa kasus penggunaan.

Untuk informasi selengkapnya tentang platform identitas Microsoft, lihat gambaran umum platform identitas Microsoft .

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Ini adalah kunci bersama yang disediakan saat Anda Membuat akun Azure Maps di portal Microsoft Azure atau menggunakan PowerShell, CLI, Azure SDK, atau REST API.

Dengan kunci ini, aplikasi apa pun dapat mengakses semua REST API. Dengan kata lain, kunci ini dapat digunakan sebagai kunci master di akun tempat kunci tersebut dikeluarkan.

Untuk aplikasi yang diekspos secara publik, rekomendasi kami adalah menggunakan pendekatan aplikasi klien rahasia untuk mengakses REST API Azure Maps sehingga kunci Anda dapat disimpan dengan aman.

Jenis: apiKey
Dalam: query

SAS Token

Ini adalah token tanda tangan akses bersama dibuat dari operasi Daftar SAS pada sumber daya Azure Maps melalui bidang manajemen Azure melalui portal Microsoft Azure, PowerShell, CLI, Azure SDK, atau REST API.

Dengan token ini, aplikasi apa pun berwenang untuk mengakses dengan kontrol akses berbasis peran Azure dan kontrol butir halus ke kedaluwarsa, laju, dan wilayah penggunaan untuk token tertentu. Dengan kata lain, Token SAS dapat digunakan untuk memungkinkan aplikasi mengontrol akses dengan cara yang lebih aman daripada kunci bersama.

Untuk aplikasi yang diekspos secara publik, rekomendasi kami adalah mengonfigurasi daftar spesifik asal yang diizinkan pada sumber daya akun peta untuk membatasi penyalahgunaan penyajian dan memperbarui Token SAS secara teratur.

Jenis: apiKey
Dalam: header

Contoh

Request information about a traffic incident

Permintaan sampel

HTTP

GET https://atlas.microsoft.com/traffic/incident?api-version=2025-01-01&bbox=-104,37,-103,38

Respon sampel

Kode status:: 200

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "id": 18558549332008001,
      "geometry": {
        "type": "Point",
        "coordinates": [
          -103.5918059115,
          38.0005878581
        ]
      },
      "properties": {
        "startTime": "2025-09-12T09:31:37Z",
        "endTime": "2025-09-12T10:21:47Z",
        "description": "Accident W US Highway 50.",
        "title": "W US Highway 50",
        "incidentType": "Accident",
        "severity": 4,
        "delay": null,
        "lastModifiedTime": "2025-09-12T10:21:47Z",
        "endPoint": {
          "type": "Point",
          "coordinates": [
            -103.5918059115,
            38.0005878581
          ]
        },
        "isTrafficJam": false,
        "isRoadClosed": false
      }
    },
    {
      "type": "Feature",
      "id": 21366103288104000,
      "geometry": {
        "type": "Point",
        "coordinates": [
          -103.591850168,
          37.9995820453
        ]
      },
      "properties": {
        "startTime": "2025-09-12T09:42:32Z",
        "endTime": "2025-09-12T10:21:47Z",
        "description": "Accident Rogers Rd",
        "title": "Rogers Rd",
        "incidentType": "Accident",
        "severity": 4,
        "delay": 10,
        "lastModifiedTime": "2025-09-12T10:21:47Z",
        "endPoint": {
          "type": "Point",
          "coordinates": [
            -103.5918059115,
            38.0005878581
          ]
        },
        "isTrafficJam": true,
        "isRoadClosed": false
      }
    }
  ]
}

Definisi

Nama	Deskripsi
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Error response
FeaturesItemTypeEnum	Menentukan jenis `GeoJSON`. Satu-satunya jenis objek yang didukung adalah Fitur. For more information, see RFC 7946.
FeatureTypeEnum	Menentukan jenis `GeoJSON`. Satu-satunya jenis objek yang didukung adalah `FeatureCollection`. For more information, see RFC 7946.
GeoJsonPoint	Jenis geometri `GeoJSON Point` yang valid. Please refer to RFC 7946 for details.
IncidentType	Menentukan jenis insiden lalu lintas. Ini dapat digunakan untuk meminta dan membedakan antara berbagai jenis insiden.
TrafficIncidentFeatureProperties	Menentukan informasi terperinci tentang insiden lalu lintas.
TrafficIncidentFeaturesItem	Menentukan objek fitur GeoJSON insiden lalu lintas termasuk geometri dan properti tambahan.
TrafficIncidentResponse	Objek pengumpulan fitur GeoJSON yang berisi daftar fitur insiden lalu lintas.

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Objek

Error response

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

FeaturesItemTypeEnum

Enumeration

Menentukan jenis GeoJSON. Satu-satunya jenis objek yang didukung adalah Fitur. For more information, see RFC 7946.

Nilai	Deskripsi
Feature	Menentukan jenis objek Fitur `GeoJSON`.

FeatureTypeEnum

Enumeration

Menentukan jenis GeoJSON. Satu-satunya jenis objek yang didukung adalah FeatureCollection. For more information, see RFC 7946.

Nilai	Deskripsi
FeatureCollection	Menentukan tipe objek `GeoJSONFeatureCollection`.

GeoJsonPoint

Objek

Jenis geometri GeoJSON Point yang valid. Please refer to RFC 7946 for details.

Nama	Jenis	Deskripsi
coordinates	number[] (double)	`Position` adalah array angka dengan dua elemen atau lebih. The first two elements are longitude and latitude, precisely in that order. Altitude/Elevation is an optional third element. Please refer to RFC 7946 for details.
type	string	Menentukan jenis GeoJSON sebagai Titik.

IncidentType

Enumeration

Menentukan jenis insiden lalu lintas. Ini dapat digunakan untuk meminta dan membedakan antara berbagai jenis insiden.

Nilai	Deskripsi
Accident	Accident
Congestion	Congestion
DisabledVehicle	DisabledVehicle
Miscellaneous	Miscellaneous
RoadHazard	RoadHazard
Construction	Construction
Weather	Weather

TrafficIncidentFeatureProperties

Objek

Menentukan informasi terperinci tentang insiden lalu lintas.

Nama	Jenis	Deskripsi
delay	number (double)	Keterlambatan yang disebabkan oleh insiden dalam hitung detik. Jika tidak ada penundaan atau tidak berlaku, itu mengembalikan nol.
description	string	Deskripsi insiden yang mencakup nama jalan dan peristiwa yang memengaruhi arus lalu lintas. Examples: • W 95th St antara Swiss Rd dan Bluejacket Dr - konstruksi • WB Johnson Dr di I-435 - perbaikan jembatan
endPoint	object	Objek GeoJson Point yang menentukan lokasi akhir insiden lalu lintas seperti akhir zona konstruksi. Lokasi ini adalah bagian dari objek properti insiden dan secara default, tidak dapat ditafsirkan oleh pengurai untuk ditampilkan di peta.
endTime	string	Tanggal dan waktu dalam UTC ketika insiden lalu lintas akan berakhir, diformat sebagai nilai dateTime seperti yang didefinisikan dalam RFC 3339, bagian 5.6.
incidentType	IncidentType	Menentukan jenis insiden lalu lintas. Ini dapat digunakan untuk meminta dan membedakan antara berbagai jenis insiden.
isRoadClosed	boolean	Nilai `true` menunjukkan bahwa ada penutupan jalan.
isTrafficJam	boolean	Nilai `true` menunjukkan bahwa area jalan yang dicakup oleh insiden ini mengalami kondisi lalu lintas abnormal yang mengakibatkan keterlambatan non-khas.
lastModifiedTime	string	Tanggal dan waktu dalam UTC ketika informasi insiden terakhir diperbarui, diformat sebagai nilai dateTime seperti yang didefinisikan dalam RFC 3339, bagian 5.6.
severity	integer (int32)	Menentukan tingkat kepentingan insiden. 0: Unknown 1: Minor 2: Moderate 3: Major 4: Tidak ditentukan (digunakan untuk penutupan jalan dan penundaan tak terbatas lainnya)
startTime	string	Tanggal dan waktu dalam UTC ketika insiden terjadi, diformat sebagai nilai dateTime seperti yang didefinisikan dalam RFC 3339, bagian 5.6.
title	string	Menentukan nama jalan dan arah jalan yang terpengaruh.

TrafficIncidentFeaturesItem

Objek

Menentukan objek fitur GeoJSON insiden lalu lintas termasuk geometri dan properti tambahan.

Nama	Jenis	Deskripsi
geometry	GeoJsonPoint	Jenis geometri `GeoJSON Point` yang valid. Please refer to RFC 7946 for details.
id	integer (int64)	ID unik untuk insiden tersebut.
properties	TrafficIncidentFeatureProperties	Menentukan informasi terperinci tentang insiden lalu lintas.
type	FeaturesItemTypeEnum	Menentukan jenis `GeoJSON`. Satu-satunya jenis objek yang didukung adalah Fitur. For more information, see RFC 7946.

TrafficIncidentResponse

Objek

Objek pengumpulan fitur GeoJSON yang berisi daftar fitur insiden lalu lintas.

Nama	Jenis	Deskripsi
features	TrafficIncidentFeaturesItem[]	`GeoJSON` objek fitur yang berisi objek Geometri dan properti tambahan. Lihat RFC 7946, Bagian 3.2 untuk detailnya.
type	FeatureTypeEnum	Menentukan jenis `GeoJSON`. Satu-satunya jenis objek yang didukung adalah `FeatureCollection`. For more information, see RFC 7946.

Bagikan melalui

Traffic - Get Traffic Incident

Parameter URI

Header Permintaan

Respons

Keamanan

AADToken

Notes

Cakupan

subscription-key

SAS Token

Contoh

Request information about a traffic incident

Permintaan sampel

Respon sampel

Definisi

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FeaturesItemTypeEnum

FeatureTypeEnum

GeoJsonPoint

IncidentType

TrafficIncidentFeatureProperties

TrafficIncidentFeaturesItem

TrafficIncidentResponse