Traffic - Get Traffic Flow Segment

Referensi

Service:: Maps

API Version:: 1.0

Segmen Flow Lalu Lintas

Berlaku untuk: lihat tingkat harga.

Layanan ini memberikan informasi tentang kecepatan dan waktu perjalanan fragmen jalan yang paling dekat dengan koordinat yang diberikan. Ini dirancang untuk bekerja bersama lapisan Flow Layanan Render untuk mendukung visualisasi data alur yang dapat diklik. Dengan API ini, sisi klien dapat menghubungkan tempat apa pun di peta dengan data aliran di jalan terdekat dan menyajikannya kepada pengguna.

GET https://atlas.microsoft.com/traffic/flow/segment/{format}?api-version=1.0&style={style}&zoom={zoom}&query={query}

With optional parameters:

GET https://atlas.microsoft.com/traffic/flow/segment/{format}?api-version=1.0&style={style}&zoom={zoom}&query={query}&unit={unit}&thickness={thickness}&openLr={openLr}

Parameter URI

Name	In	Required	Type	Description
format	path	True	ResponseFormat	Format respons yang diinginkan. Nilai dapat berupa json atau xml.
api-version	query	True	string	Nomor versi API Azure Maps.
query	query	True	array	Koordinat titik yang dekat dengan segmen jalan. Parameter ini adalah daftar empat koordinat, yang berisi dua pasangan koordinat (lat, long, lat, long), dan dihitung menggunakan proyeksi EPSG4326. Ketika titik akhir ini dipanggil secara langsung, koordinat diteruskan sebagai string tunggal yang berisi empat koordinat, dipisahkan oleh koma.
style	query	True	TrafficFlowSegmentStyle	Gaya yang akan digunakan untuk merender petak peta. Nilai yang valid adalah absolut yang mengembalikan warna yang mencerminkan kecepatan absolut yang diukur, relatif yang mengembalikan kecepatan relatif terhadap aliran bebas, Penundaan relatif yang menampilkan kecepatan relatif hanya di mana mereka berbeda dari kecepatan aliran bebas
zoom	query	True	integer int32	Tingkat perbesar tampilan untuk petak peta yang diinginkan. Nilai zoom harus dalam rentang: 0-22 (inklusif). Silakan lihat Tingkat Pembesaran Tampilan dan Kisi Petak peta untuk detailnya.
openLr	query		boolean	Boolean tentang apakah respons harus menyertakan kode OpenLR
thickness	query		integer int32	Nilai lebar garis yang mewakili lalu lintas. Nilai ini adalah pengali dan nilai yang diterima berkisar antara 1 - 20. Nilai defaultnya adalah 10.
unit	query		SpeedUnit	Satuan kecepatan dalam KMPH atau MPH

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	TrafficFlowSegmentData	OK
Other Status Codes	ErrorResponse	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, ini saat ini dapat diperlakukan sebagai kunci master ke akun tempat mereka 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, tarif, 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 penyalahgunaan dan memperbarui Token SAS secara teratur.

Type: apiKey
In: header

Contoh

Request traffic flow segment information

Sample Request

HTTP

GET https://atlas.microsoft.com/traffic/flow/segment/json?api-version=1.0&style=absolute&zoom=10&query=52.41072,4.84239

Sample Response

Status code:: 200

{
  "flowSegmentData": {
    "frc": "FRC3",
    "currentSpeed": 79,
    "freeFlowSpeed": 79,
    "currentTravelTime": 33,
    "freeFlowTravelTime": 33,
    "confidence": 0.5,
    "coordinates": {
      "coordinate": [
        {
          "latitude": 52.404648,
          "longitude": 4.8442388
        },
        {
          "latitude": 52.408447,
          "longitude": 4.8357286
        }
      ]
    },
    "openlr": null,
    "@version": "1.0.53-mascoma"
  }
}

Definisi

Coordinates	Termasuk koordinat yang menjelaskan bentuk segmen. Koordinat digeser dari jalan tergantung pada tingkat zoom untuk mendukung visualisasi berkualitas tinggi di setiap skala.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Respons kesalahan
FlowSegmentData	properti Flow Segment Data
LatLongPair	Lokasi yang direpresentasikan sebagai garis lintang dan bujur.
ResponseFormat	Format respons yang diinginkan. Nilai dapat berupa json atau xml.
SpeedUnit	Satuan kecepatan di KMPH atau MPH
TrafficFlowSegmentData	Objek ini dikembalikan dari panggilan Traffic Flow Segment yang berhasil
TrafficFlowSegmentStyle	Gaya yang akan digunakan untuk merender petak peta. Nilai yang valid adalah absolut yang mengembalikan warna yang mencerminkan kecepatan absolut yang diukur, relatif yang mengembalikan kecepatan relatif terhadap aliran bebas, Penundaan relatif yang menampilkan kecepatan relatif hanya di mana mereka berbeda dari kecepatan aliran bebas

Coordinates

Termasuk koordinat yang menjelaskan bentuk segmen. Koordinat digeser dari jalan tergantung pada tingkat zoom untuk mendukung visualisasi berkualitas tinggi di setiap skala.

Name	Type	Description
coordinate	LatLongPair[]	Array koordinat

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	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Respons kesalahan

Name	Type	Description
error	ErrorDetail	Objek kesalahan.

FlowSegmentData

properti Flow Segment Data

Name	Type	Description
@version	string	Ini menunjukkan versi perangkat lunak yang menghasilkan respons.
confidence	number	Keyakinan adalah ukuran kualitas waktu dan kecepatan perjalanan yang disediakan. Nilai 1 berarti keyakinan penuh, bahwa respons berisi data berkualitas tertinggi. Nilai yang lebih rendah menunjukkan tingkat respons dapat bervariasi dari kondisi aktual di jalan. Nilai apa pun yang lebih besar dari 0,6 berarti informasi didasarkan pada input pemeriksaan real time. Nilai 0,5 berarti kecepatan yang dilaporkan didasarkan pada info historis. Nilai antara 0,5 dan 0,6 memiliki rata-rata tertimbang terhitung antara kecepatan historis dan langsung.
coordinates	Coordinates	Termasuk koordinat yang menjelaskan bentuk segmen. Koordinat digeser dari jalan tergantung pada tingkat zoom untuk mendukung visualisasi berkualitas tinggi di setiap skala.
currentSpeed	integer	Kecepatan rata-rata saat ini pada titik yang dipilih, dalam unit yang diminta. Ini dihitung dari currentTravelTime dan panjang segmen yang dipilih.
currentTravelTime	integer	Waktu perjalanan saat ini dalam hitungan detik, di seluruh segmen lalu lintas ini, berdasarkan pengukuran real-time yang menyatu antara lokasi yang ditentukan ke arah yang ditentukan.
frc	string	Kelas Jalan Fungsional. Ini menunjukkan jenis jalan: 0: Jalan raya, jalan bebas hambatan atau jalan utama lainnya. 1: Jalan utama, kurang penting daripada jalan raya. 2: Jalan utama lainnya. 3: Jalan sekunder. 4: Jalan penghubung lokal. 5: Jalan lokal yang sangat penting. Jalan lokal.
freeFlowSpeed	integer	Kecepatan aliran bebas yang diharapkan dalam kondisi ideal, dinyatakan dalam unit yang diminta. Ini terkait dengan freeFlowTravelTime.
freeFlowTravelTime	integer	Waktu perjalanan dalam detik, di seluruh segmen lalu lintas ini, yang akan diharapkan dalam kondisi arus bebas yang ideal.
openlr	string	Kode OpenLR untuk segmen. Lihat OpenLR untuk informasi selengkapnya tentang penggunaan kode Open LR.

LatLongPair

Lokasi yang direpresentasikan sebagai garis lintang dan bujur.

Name	Type	Description
latitude	number	Properti garis lintang
longitude	number	Properti garis bujur

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

SpeedUnit

Satuan kecepatan di KMPH atau MPH

Name	Type	Description
KMPH	string	Kilometer Per Jam
MPH	string	Mil Per Jam

TrafficFlowSegmentData

Objek ini dikembalikan dari panggilan Traffic Flow Segment yang berhasil

Name	Type	Description
flowSegmentData	FlowSegmentData	properti Flow Segment Data

TrafficFlowSegmentStyle

Gaya yang akan digunakan untuk merender petak peta. Nilai yang valid adalah absolut yang mengembalikan warna yang mencerminkan kecepatan absolut yang diukur, relatif yang mengembalikan kecepatan relatif terhadap aliran bebas, Penundaan relatif yang menampilkan kecepatan relatif hanya di mana mereka berbeda dari kecepatan aliran bebas

Name	Type	Description
absolute	string
relative	string
relative-delay	string