Traffic - Get Traffic Flow Tile

Trafik akışını gösteren 256 x 256 piksel kutucuk elde etmek için kullanın.

Traffic Flow Tile API, trafik akışını gösteren 256 x 256 piksel kutucuklardaki trafik koşulları hakkında gerçek zamanlı bilgiler döndüren bir HTTP GET isteğidir. Tüm kutucuklar aynı kılavuz sistemini kullanır. Trafik kutucukları saydam görüntüler kullandığından, bileşik ekran oluşturmak için harita kutucuklarının üzerine katmanlanabilir. Flow kutucukları, farklı yol segmentlerindeki trafiğin hızını veya söz konusu yol segmentindeki bu hız ile serbest akış hızı arasındaki farkı belirtmek için renkleri kullanır.

GET https://atlas.microsoft.com/traffic/flow/tile/{format}?api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}
GET https://atlas.microsoft.com/traffic/flow/tile/{format}?api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}&thickness={thickness}

URI Parametreleri

Name İçinde Gerekli Tür Description
format
path True

TileFormat

Yanıtın istenen biçimi. Olası değerler png & pbf'tir.

api-version
query True

string

Azure Haritalar API'sinin sürüm numarası.

style
query True

TrafficFlowTileStyle

Kutucuğu işlemek için kullanılacak stil.

x
query True

integer

int32

Yakınlaştırma kılavuzundaki kutucuğun X koordinatı. Değer [0, 2zoom -1] aralığında olmalıdır.

Ayrıntılar için bkz . Yakınlaştırma Düzeyleri ve Kutucuk Kılavuzu .

y
query True

integer

int32

Yakınlaştırma kılavuzundaki kutucuğun Y koordinatı. Değer [0, 2zoom -1] aralığında olmalıdır.

Ayrıntılar için bkz . Yakınlaştırma Düzeyleri ve Kutucuk Kılavuzu .

zoom
query True

integer

int32

İstenen kutucuk için yakınlaştırma düzeyi. Raster kutucukları için değer şu aralıkta olmalıdır: 0-22 (dahil). Vektör kutucukları için değer şu aralıkta olmalıdır: 0-22 (dahil). Ayrıntılar için bkz . Yakınlaştırma Düzeyleri ve Kutucuk Kılavuzu .

thickness
query

integer

int32

Trafiği temsil eden çizgi genişliğinin değeri. Bu değer bir çarpandır ve kabul edilen değerler 1 ile 20 arasında değişir. Varsayılan değer 10'dur. Biçim pbf olduğunda bu parametre geçerli değildir.

İstek Başlığı

Name Gerekli Tür Description
x-ms-client-id

string

Hangi hesabın Microsoft Entra ID güvenlik modeliyle birlikte kullanıma yönelik olduğunu belirtir. Azure Haritalar hesabı için benzersiz bir kimliği temsil eder ve Azure Haritalar yönetim düzlemi Hesap API'sinden alınabilir. Azure Haritalar Microsoft Entra ID güvenliğini kullanmak için kılavuz için aşağıdaki makalelere bakın.

Yanıtlar

Name Tür Description
200 OK

object

Bu görüntü başarılı bir Trafik Akışı Kutucuğu çağrısından döndürülür

Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

Headers

Content-Type: string

Other Status Codes

ErrorResponse

Beklenmeyen bir hata oluştu.

Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

Güvenlik

AADToken

Bunlar Microsoft Entra OAuth 2.0 Akışlarıdır. Azure rol tabanlı erişim denetimiyle eşleştirildiğinde, Azure Haritalar REST API'lerine erişimi denetlemek için kullanılabilir. Azure rol tabanlı erişim denetimleri, bir veya daha fazla Azure Haritalar kaynak hesabına veya alt kaynağına erişimi tanımlamak için kullanılır. Herhangi bir kullanıcı, grup veya hizmet sorumlusuna yerleşik bir rol veya REST API'lerini Azure Haritalar için bir veya daha fazla izinden oluşan özel bir rol aracılığıyla erişim verilebilir.

Senaryoları uygulamak için kimlik doğrulama kavramlarını görüntülemenizi öneririz. Özetle, bu güvenlik tanımı belirli API'ler ve kapsamlar üzerinde erişim denetimi yapabilen nesneler aracılığıyla uygulamaları modellemeye yönelik bir çözüm sağlar.

Notlar

  • Bu güvenlik tanımı, uygulamanın erişim isteğinde x-ms-client-id bulunduğu Azure Haritalar kaynağı belirtmek için üst bilginin kullanılmasını gerektirir. Bu, Haritalar yönetim API'sinden edinilebilir.

Authorization URL, Azure genel bulut örneğine özgüdür. Bağımsız bulutların benzersiz Yetkilendirme URL'leri ve Microsoft Entra ID yapılandırmaları vardır. * Azure rol tabanlı erişim denetimi Azure portal, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla Azure yönetim düzleminden yapılandırılır. * Azure Haritalar Web SDK'sının kullanımı, bir uygulamanın birden çok kullanım örneği için yapılandırma tabanlı kurulumuna olanak tanır.

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

Bu, Azure portal bir Azure Haritalar hesabı İçerik Oluşturucu veya PowerShell, CLI, Azure SDK'ları veya REST API kullanarak sağlanan paylaşılan bir anahtardır.

Bu anahtarla, tüm uygulamalar tüm REST API'lere erişebilir. Başka bir deyişle, bu anahtar, verildikleri hesapta ana anahtar olarak kullanılabilir.

Herkese açık uygulamalar için, anahtarınızın güvenli bir şekilde depolanabilmesi için gizli istemci uygulamaları yaklaşımını kullanarak Azure Haritalar REST API'lerine erişmenizi öneririz.

Type: apiKey
In: query

SAS Token

Bu paylaşılan erişim imzası belirteci, Azure portal, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla Azure yönetim düzlemi aracılığıyla Azure Haritalar kaynağındaki Sas Listeleme işleminden oluşturulur.

Bu belirteçle, tüm uygulamalar Azure rol tabanlı erişim denetimleri ve belirli bir belirtecin kullanım süresi, oranı ve bölgelerine yönelik ayrıntılı denetim ile erişim yetkisine sahip olur. Başka bir deyişle SAS Belirteci, uygulamaların erişimi paylaşılan anahtardan daha güvenli bir şekilde denetlemesine izin vermek için kullanılabilir.

Herkese açık uygulamalar için önerimiz, uygunsuz işlemeyi sınırlamak ve SAS Belirtecini düzenli olarak yenilemek için Harita hesabı kaynağında izin verilen kaynakların belirli bir listesini yapılandırmanızdır.

Type: apiKey
In: header

Örnekler

Request tile depicting the traffic flow

Sample Request

GET https://atlas.microsoft.com/traffic/flow/tile/png?api-version=1.0&style=absolute&zoom=12&x=2044&y=1360

Sample Response

"binary string image"

Tanımlar

Name Description
ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

ErrorDetail

Hata ayrıntısı.

ErrorResponse

Hata yanıtı

TileFormat

Yanıtın istenen biçimi. Olası değerler png & pbf'tir.

TrafficFlowTileStyle

Kutucuğu işlemek için kullanılacak stil.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

Name Tür Description
info

object

Ek bilgiler.

type

string

Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Name Tür Description
additionalInfo

ErrorAdditionalInfo[]

Hata ek bilgileri.

code

string

Hata kodu.

details

ErrorDetail[]

Hata ayrıntıları.

message

string

Hata iletisi.

target

string

Hata hedefi.

ErrorResponse

Hata yanıtı

Name Tür Description
error

ErrorDetail

Hata nesnesi.

TileFormat

Yanıtın istenen biçimi. Olası değerler png & pbf'tir.

Name Tür Description
pbf

string

Pbf biçiminde vektör grafiği. 0 ile 22 arasında yakınlaştırma düzeylerini destekler.

png

string

png biçiminde bir resim. 0 ile 18 arasında yakınlaştırma düzeylerini destekler.

TrafficFlowTileStyle

Kutucuğu işlemek için kullanılacak stil.

Name Tür Description
absolute

string

Renkler ölçülen mutlak hızı yansıtır. Mutlak hız, tam hıza erişme özelliğidir.

reduced-sensitivity

string

Göreli renkleri görüntüler, ancak segmentlerin rengi değiştirmesi için serbest akıştan daha büyük bir fark gereklidir. Bu mod yalnızca biçim png olduğunda geçerlidir.

relative

string

Bu, serbest akışa göre hızdır ve trafik akışını görselleştiren tıkanıklık alanlarını vurgular. Serbest akış, tıkanıklık olmadığı ve trafiğin hız sınırlarını izleyebildiği koşulları ifade eder. Bir haritada trafik akışını görselleştirmek için en çok kullanılan seçenek.

relative-delay

string

Göreli renkleri yalnızca serbest akış hızlarından farklı oldukları yerlerde görüntüler. Bu seçenek yalnızca tıkanıklık alanlarını vurgular.