Traffic - Get Traffic Incident Detail

Referensi

Layanan:: Maps

Versi API:: 1.0

Gunakan untuk mendapatkan informasi tentang insiden lalu lintas di dalam kotak pembatas tertentu.

API Traffic Incident Detail adalah permintaan GET HTTP yang memberikan informasi tentang insiden lalu lintas di dalam kotak pembatas tertentu, berdasarkan ID Model Lalu Lintas saat ini. ID Model Lalu Lintas tersedia untuk memberikan sinkronisasi data antara panggilan dan API. ID Model Lalu Lintas adalah nilai kunci untuk menentukan mata uang insiden lalu lintas. Ini diperbarui setiap menit, dan berlaku selama dua menit sebelum waktu habis. Ini digunakan dalam merender petak insiden. Ini dapat diperoleh dari Viewport API.

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

Dengan parameter opsional:

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}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
format	path	True	ResponseFormat	Format respons yang diinginkan. Nilai dapat berupa json atau xml .
api-version	query	True	string	Nomor versi Azure Maps API.
boundingbox	query	True	number[]	`boundingbox` diwakili oleh dua pasangan nilai yang menjelaskan sudutnya (pasangan pertama untuk sudut kiri bawah dan kedua untuk kanan atas). Pasangan dapat ditentukan menggunakan salah satu `projection`yang ditentukan di bawah ini (misalnya, minY,minX,maxY,maxX) atau oleh dua pasangan bujur lintang (misalnya, minLat,minLon,maxLat,maxLon). CATATAN: Jika pasangan garis lintang/bujur digunakan, parameter `projection` harus diatur ke "EPSG4326".
boundingZoom	query	True	integer (int32) minimum: 0 maximum: 22	Tingkat perbesar tampilan untuk petak peta yang diinginkan. 0 hingga 22 untuk petak peta raster, 0 hingga 22 untuk petak peta vektor
style	query	True	IncidentDetailStyle	Gaya yang akan digunakan untuk merender petak peta di Traffic Incident Tile API. Ini akan berpengaruh pada koordinat insiden lalu lintas dalam balasan.
trafficmodelid	query	True	string	Nomor yang mereferensikan model lalu lintas. Ini dapat diperoleh dari Viewport API. Ini diperbarui setiap menit, dan berlaku selama dua menit sebelum waktu habis. Jika ID Model Lalu Lintas yang salah ditentukan, id yang benar akan dikembalikan oleh antarmuka. Nilai -1 akan selalu memanggil model lalu lintas terbaru
expandCluster	query		boolean	Boolean untuk menunjukkan apakah akan mencantumkan semua insiden lalu lintas dalam kluster secara terpisah
geometries	query		IncidentGeometryType	Jenis geometri vektor ditambahkan ke insiden (dikembalikan dalam elemen respons).
language	query		string	kode ISO 639-1 untuk bahasa output. Bahasa yang didukung adalah 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. Silakan merujuk ke Bahasa yang Didukung untuk detailnya. Ketika kode bahasa yang tidak valid disediakan, respons dikembalikan dalam bahasa Inggris. Ketika penyebab atau deskripsi insiden tidak memiliki terjemahan, deskripsi bahasa Inggris dikembalikan.
originalPosition	query		boolean	Boolean tentang apakah akan mengembalikan posisi asli insiden () serta yang bergeser ke awal tabung lalu lintas ()
projection	query		ProjectionStandard	Proyeksi yang digunakan untuk menentukan koordinat dalam permintaan dan respons. EPSG900913 (default) atau EPSG4326

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
x-ms-client-id		string	Menentukan akun mana yang ditujukan untuk penggunaan bersama dengan model keamanan ID Microsoft Entra. Ini mewakili ID unik untuk akun Azure Maps dan dapat diambil dari API Akun sarana manajemen Azure Maps. Untuk menggunakan keamanan ID Microsoft Entra di Azure Maps, lihat artikel berikut ini untuk panduan.

Respons

Nama	Jenis	Deskripsi
200 OK	TrafficIncidentDetail	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.

Untuk menerapkan skenario, sebaiknya lihat konsep autentikasi . Singkatnya, definisi keamanan ini menyediakan solusi untuk memodelkan aplikasi melalui objek yang mampu mengontrol akses pada API dan cakupan tertentu.

Catatan

Definisi keamanan ini mengharuskan penggunaan header x-ms-client-id untuk menunjukkan sumber daya Azure Maps mana yang diminta akses aplikasi. Ini dapat diperoleh dari api manajemen Maps.

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/detail/json?api-version=1.0&style=s3&boundingbox=6841263.950712,511972.674418,6886056.049288,582676.925582&boundingZoom=11&trafficmodelid=1335294634919

Respon sampel

Kode status:: 200

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

Definisi

Nama	Deskripsi
DelayMagnitude	Besarnya penundaan yang terkait dengan insiden. Nilai-nilai ini sesuai dengan warna insiden dalam petak peta lalu lintas
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
IconCategory	Kategori ikon yang terkait dengan insiden ini. Nilai adalah angka dalam rentang 0-13, dengan arti berikut -- 0: Tidak diketahui, 1: Kecelakaan, 2: Kabut, 3: Kondisi Berbahaya, 4: Hujan, 5: Es, 6: Selai, 7: Jalur Tertutup, 8: Jalan Ditutup, 9: Pekerjaan Jalan, 10: Angin, 11: Banjir, 12: Memutar, 13: Kluster
IncidentDetailStyle	Gaya yang akan digunakan untuk merender petak peta di Traffic Incident Tile API. Ini akan berpengaruh pada koordinat insiden lalu lintas dalam balasan.
IncidentGeometryType	Jenis geometri vektor ditambahkan ke insiden (dikembalikan dalam elemen respons).
Point	Representasi generik titik dengan koordinat (x, y) di bidang Kartesius.
ProjectionStandard	Proyeksi yang digunakan untuk menentukan koordinat dalam permintaan dan respons. EPSG900913 (default) atau EPSG4326
ResponseFormat	Format respons yang diinginkan. Nilai dapat berupa json atau xml .
Tm	Elemen respons utama
TrafficIncidentDetail	Objek ini dikembalikan dari panggilan Detail insiden Lalu Lintas yang berhasil
TrafficIncidentPointOfInterest

DelayMagnitude

Enumeration

Besarnya penundaan yang terkait dengan insiden. Nilai-nilai ini sesuai dengan warna insiden dalam petak peta lalu lintas

Nilai	Deskripsi
0	Tidak dikenal
1	Kecil
2	Sedang
3	Utama
4	Tidak terbatas (digunakan untuk penutupan jalan dan penundaan lain yang tidak terbatas)

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

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

IconCategory

Enumeration

Kategori ikon yang terkait dengan insiden ini. Nilai adalah angka dalam rentang 0-13, dengan arti berikut -- 0: Tidak diketahui, 1: Kecelakaan, 2: Kabut, 3: Kondisi Berbahaya, 4: Hujan, 5: Es, 6: Selai, 7: Jalur Tertutup, 8: Jalan Ditutup, 9: Pekerjaan Jalan, 10: Angin, 11: Banjir, 12: Memutar, 13: Kluster

Nilai	Deskripsi
0	Tidak dikenal
1	Kecelakaan
10	Angin
11	Banjir
12	Detour
13	Kluster: Dikembalikan jika kluster berisi insiden dengan kategori ikon yang berbeda.
14	Kendaraan Rusak
2	Kabut
3	Kondisi Berbahaya
4	Hujan
5	Ice
6	Selai
7	Jalur Ditutup
8	Jalan Ditutup
9	Pekerjaan Jalan

IncidentDetailStyle

Enumeration

Gaya yang akan digunakan untuk merender petak peta di Traffic Incident Tile API. Ini akan berpengaruh pada koordinat insiden lalu lintas dalam balasan.

Nilai	Deskripsi
night	Gaya malam.
s1	Membuat garis lalu lintas dengan chevron berwarna yang menunjukkan tingkat keparahan.
s2	Membuat garis biasa dengan tingkat cahaya tertentu.
s3	Membuat garis biasa dengan tingkat cahaya tertentu, berbeda dari gaya s2.

IncidentGeometryType

Enumeration

Jenis geometri vektor ditambahkan ke insiden (dikembalikan dalam elemen respons).

Nilai	Deskripsi
original	Tempat insiden tepatnya di jalan.
shifted	Memindahkan insiden sedikit (tergantung pada tingkat zoom) untuk menunjukkan jalur jalan tertentu.

Point

Objek

Representasi generik titik dengan koordinat (x, y) di bidang Kartesius.

Nama	Jenis	Deskripsi
x	number	koordinat x
y	number	koordinat y

ProjectionStandard

Enumeration

Proyeksi yang digunakan untuk menentukan koordinat dalam permintaan dan respons. EPSG900913 (default) atau EPSG4326

Nilai	Deskripsi
EPSG4326	EPSG4326
EPSG900913	EPSG900913

ResponseFormat

Enumeration

Format respons yang diinginkan. Nilai dapat berupa json atau xml .

Nilai	Deskripsi
json	Format Pertukaran Data Notasi Objek JavaScript
xml	Bahasa Markup yang Dapat Diperluas

Tm

Objek

Elemen respons utama

Nama	Jenis	Deskripsi
@id	string	ID model lalu lintas untuk insiden ini
poi	TrafficIncidentPointOfInterest[]	Insiden lalu lintas tunggal, atau kluster insiden lalu lintas

TrafficIncidentDetail

Objek

Objek ini dikembalikan dari panggilan Detail insiden Lalu Lintas yang berhasil

Nama	Jenis	Deskripsi
tm	Tm	Elemen respons utama

TrafficIncidentPointOfInterest

Objek

Nama	Jenis	Deskripsi
c	string	Penyebab insiden, jika tersedia, dalam bahasa yang diminta
cbl	Point	Koordinat kiri bawah kluster dalam proyeksi permintaan
cs	integer (int32)	Ukuran kluster: jumlah insiden dalam kluster
ctr	Point	Koordinat kanan atas kluster dalam proyeksi permintaan
d	string	Deskripsi insiden dalam bahasa yang diminta
dl	integer (int32)	Keterlambatan yang disebabkan oleh insiden dalam hitung detik (kecuali dalam penutupan jalan)
ed	string (date-time)	Perkiraan tanggal akhir insiden, jika tersedia. Tanggal dijelaskan dalam format ISO8601.
f	string	Dari: nama persimpangan atau lokasi tempat lalu lintas karena insiden dimulai
ic	IconCategory (int32)	Kategori ikon yang terkait dengan insiden ini. Nilai adalah angka dalam rentang 0-13, dengan arti berikut -- 0: Tidak diketahui, 1: Kecelakaan, 2: Kabut, 3: Kondisi Berbahaya, 4: Hujan, 5: Es, 6: Selai, 7: Jalur Tertutup, 8: Jalan Ditutup, 9: Pekerjaan Jalan, 10: Angin, 11: Banjir, 12: Memutar, 13: Kluster
id	string	ID insiden lalu lintas
l	integer (int32)	Panjang insiden dalam meter
p	Point	Titik di mana ikon kluster atau insiden mentah harus digambar, dinyatakan dalam proyeksi yang diminta. Ini dipengaruhi oleh gaya lalu lintas, tingkat zoom, dan jenis jalan
r	string	Nomor jalan yang terpengaruh oleh insiden tersebut. Beberapa nomor jalan akan dibatasi oleh garis miring
sd	string (date-time)	Tanggal mulai insiden, jika tersedia. Tanggal dijelaskan dalam format ISO8601.
t	string	Untuk: nama persimpangan atau lokasi tempat lalu lintas karena insiden berakhir
ty	DelayMagnitude (int32)	Besarnya penundaan yang terkait dengan insiden. Nilai-nilai ini sesuai dengan warna insiden dalam petak peta lalu lintas

Bagikan melalui

Traffic - Get Traffic Incident Detail

Parameter URI

Header Permintaan

Respons

Keamanan

AADToken

Catatan

Cakupan

subscription-key

SAS Token

Contoh

Request information about a traffic incident

Permintaan sampel

Respon sampel

Definisi

DelayMagnitude

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IconCategory

IncidentDetailStyle

IncidentGeometryType

Point

ProjectionStandard

ResponseFormat

Tm

TrafficIncidentDetail

TrafficIncidentPointOfInterest

Sumber Daya Tambahan: