Traffic - Get Traffic Incident Detail

  • Referensi
Service:
Maps
API Version:
1.0

Detail Insiden Lalu Lintas

Berlaku untuk: lihat tingkat harga.

API ini menyediakan 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}
With optional parameters: 
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

Name In Required Type Description
format
 path True

Format respons yang diinginkan. Nilai dapat berupa json atau xml.
api-version
 query True
  • string

Nomor versi API Azure Maps.
boundingbox
 query True
  • array

diwakili boundingbox oleh dua pasangan nilai yang menjelaskan sudutnya (pasangan pertama untuk sudut kiri bawah dan kedua untuk kanan atas). Pasangan dapat ditentukan menggunakan salah satu dari projectionyang ditentukan di bawah ini (misalnya, minY,minX,maxY,maxX) atau dengan dua pasangan garis bujur lintang (misalnya, minLat,minLon,maxLat,maxLon).

CATATAN: Jika pasangan lintang/bujur digunakan, maka projection parameter harus diatur ke "EPSG4326".
boundingZoom
 query True
  • integer
int32

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

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

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 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

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

Header Permintaan

Name Required Type Description
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 bidang manajemen Azure Maps. Untuk menggunakan keamanan Azure AD di Azure Maps lihat artikel berikut untuk panduan.

Respons

Name Type Description
200 OK

OK
Other Status Codes

Terjadi kesalahan tak terduga.

Keamanan

AADToken

Ini adalah Alur OAuth2 Azure Active Directory. Saat dipasangkan dengan kontrol akses berbasis peran Azure, kontrol akses tersebut dapat digunakan untuk mengontrol akses ke Azure Maps REST API. 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 untuk Azure Maps REST API.

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

Catatan

  • Definisi keamanan ini memerlukan penggunaan x-ms-client-id header untuk menunjukkan sumber daya Azure Maps mana yang meminta akses aplikasi. Ini dapat diperoleh dari API manajemen Peta.

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

  • Saat ini, Azure Active Directory v1.0 atau v2.0 mendukung Kantor, Sekolah, dan Tamu tetapi tidak mendukung akun Pribadi.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

subscription-key

Ini adalah kunci bersama yang disediakan saat membuat sumber daya Azure Maps melalui bidang manajemen Azure melalui portal Azure, PowerShell, CLI, Azure SDK, atau REST API.

Dengan kunci ini, aplikasi apa pun berwenang untuk mengakses semua REST API. Dengan kata lain, saat ini dapat diperlakukan sebagai kunci master ke akun tempat kunci tersebut dikeluarkan.

Untuk aplikasi yang diekspos secara publik, rekomendasi kami adalah menggunakan akses server-ke-server Azure Maps REST API tempat kunci ini dapat disimpan dengan aman.

Type: apiKey
In: 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 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 fine-grain 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 asal tertentu yang diizinkan di sumber daya akun Peta untuk membatasi penyalahgunaan penyalahgunaan dan memperbarui Token SAS secara teratur.

Type: apiKey
In: header

Contoh

Request information about a traffic incident

Sample Request

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

Sample Response

Status code:
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

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

Respons 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 Ditutup, 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

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

Name Type Description
0
  • Integer

Tidak dikenal
1
  • Integer

Minor
2
  • Integer

Sedang
3
  • Integer

Parah
4
  • Integer

Tidak terbatas (digunakan untuk penutupan jalan dan penundaan lain yang tidak terbatas)

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Name Type Description
info
  • object

Info tambahan.
type
  • string

Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Name Type Description
additionalInfo

Info tambahan kesalahan.
code
  • string

Kode kesalahan.
details

Detail kesalahan.
message
  • string

Pesan kesalahan.
target
  • string

Target kesalahan.

ErrorResponse

Respons kesalahan

Name Type Description
error

Objek 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 Ditutup, 8: Jalan Ditutup, 9: Pekerjaan Jalan, 10: Angin, 11: Banjir, 12: Memutar, 13: Kluster

Name Type Description
0
  • Integer

Tidak dikenal
1
  • Integer

Kecelakaan
10
  • Integer

Angin
11
  • Integer

Banjir
12
  • Integer

Detour
13
  • Integer

Kluster: Dikembalikan jika kluster berisi insiden dengan kategori ikon yang berbeda.
14
  • Integer

Kendaraan Rusak
2
  • Integer

Kabut
3
  • Integer

Kondisi Berbahaya
4
  • Integer

Hujan
5
  • Integer

Es
6
  • Integer

Kemacetan
7
  • Integer

Jalur Ditutup
8
  • Integer

Jalan Ditutup
9
  • Integer

Pekerjaan Jalan

IncidentDetailStyle

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

Name Type Description
night
  • string

Gaya malam.
s1
  • string

Membuat garis lalu lintas dengan chevron berwarna yang menunjukkan tingkat keparahan.
s2
  • string

Membuat garis biasa dengan tingkat cahaya tertentu.
s3
  • string

Membuat garis biasa dengan tingkat cahaya tertentu, berbeda dari gaya s2.

IncidentGeometryType

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

Name Type Description
original
  • string

Menempatkan insiden tepatnya di jalan.
shifted
  • string

Memindahkan insiden sedikit (tergantung pada tingkat perbesar tampilan) untuk menunjukkan jalur jalan tertentu.

Point

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

Name Type Description
x
  • number

koordinat x
y
  • number

koordinat y

ProjectionStandard

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

Name Type Description
EPSG4326
  • string

EPSG4326
EPSG900913
  • string

EPSG900913

ResponseFormat

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

Name Type Description
json
  • string

Format Pertukaran Data Notasi Objek JavaScript
xml
  • string

Bahasa Markup yang Dapat Diperluas

Tm

Elemen respons utama

Name Type Description
@id
  • string

ID model lalu lintas untuk insiden ini
poi

Insiden lalu lintas tunggal, atau kluster insiden lalu lintas

TrafficIncidentDetail

Objek ini dikembalikan dari panggilan Detail insiden Lalu Lintas yang berhasil

Name Type Description
tm

Elemen respons utama

TrafficIncidentPointOfInterest

Name Type Description
c
  • string

Penyebab insiden, jika tersedia, dalam bahasa yang diminta
cbl

Koordinat kiri bawah kluster dalam proyeksi permintaan
cs
  • integer

Ukuran kluster: jumlah insiden dalam kluster
ctr

Koordinat kanan atas kluster dalam proyeksi permintaan
d
  • string

Deskripsi insiden dalam bahasa yang diminta
dl
  • integer

Keterlambatan yang disebabkan oleh insiden dalam hitung detik (kecuali dalam penutupan jalan)
ed
  • string

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

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 Ditutup, 8: Jalan Ditutup, 9: Pekerjaan Jalan, 10: Angin, 11: Banjir, 12: Memutar, 13: Kluster
id
  • string

ID insiden lalu lintas
l
  • integer

Panjang insiden dalam meter
p

Titik di mana ikon kluster atau insiden mentah harus digambar, dinyatakan dalam proyeksi yang diminta. Hal 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

Tanggal mulai insiden, jika tersedia. Tanggal dijelaskan dalam format ISO8601.
t
  • string

Ke: nama persimpangan atau lokasi tempat lalu lintas karena insiden berakhir
ty

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