Traffic - Get Traffic Flow Tile

Trafik akışı kutucuğu

Uygulama hedefi: S0 ve S1 fiyatlandırma katmanları.

Azure Flow kutucuğu API 'SI, trafik akışını gösteren 256 x 256 piksel kutucuğunu sunar. Tüm kutucuklar aynı kılavuz sistemini kullanır. Trafik kutucukları saydam görüntüler kullandığından, bir bileşik görüntü oluşturmak için harita kutucuklarının üzerine katmanlaştırabilirsiniz. Akış kutucukları, farklı yol kesimlerindeki trafiğin hızını veya söz konusu hız ile bu hız arasındaki farkı ve bu hız ile ücretsiz akış hızını göstermek için renkler 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}?subscription-key={subscription-key}&api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}&thickness={thickness}

URI Parametreleri

Name In Required Type Description
format
path True

Yanıtın istenen biçimi. Olası değerler, PBF & png ' dir.

api-version
query True
  • string

Azure Haritalar API 'sinin sürüm numarası. Geçerli sürüm 1,0

style
query True

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

  • Absolute, ölçülen mutlak hızı yansıtan renkler döndürür.
  • Göreli olarak, ücretsiz akışa göre hızı döndürür.
  • Göreli hızlardan, serbest akış hızlarından farklı olduğunda göreli gecikme görüntülenir.
x
query True
  • integer

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

Ayrıntılar için lütfen yakınlaştırma düzeyleri ve kutucuk Kılavuzu ' na bakın.

y
query True
  • integer

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

Ayrıntılar için lütfen yakınlaştırma düzeyleri ve kutucuk Kılavuzu ' na bakın.

zoom
query True
  • integer

İ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 lütfen yakınlaştırma düzeyleri ve kutucuk Kılavuzu ' na bakın.

subscription-key
query
  • string

Azure harita hesabından sunulan Azure haritalar anahtarlarından biri. Kimlik doğrulamasını yönetme hakkında daha fazla bilgi için lütfen bu makaleye bakın.

thickness
query
  • integer

Trafiği temsil eden çizginin genişliği değeri. Bu değer bir çarpan ve kabul edilen değerler 1-20 aralığındadır. Varsayılan değer 10'dur. Bu parametre PBF biçiminde olduğunda geçerli değildir.

İstek Başlığı

Name Required Type Description
x-ms-client-id
  • string

Azure AD güvenlik modeliyle birlikte hangi hesabın kullanım için tasarlanan olduğunu belirtir. Azure haritalar hesabı için benzersiz bir KIMLIĞI temsil eder ve Azure Maps yönetim düzlemi hesabı API 'sinden alınabilir. Azure haritalar 'da Azure AD güvenliği 'ni kullanmak için rehberlik için aşağıdaki makalelere bakın.

Yanıtlar

Name Type Description
200 OK
  • string

Tamam

400 Bad Request

Hatalı istek: bir veya daha fazla parametre yanlış belirtildi veya birbirini dışlıyor.

401 Unauthorized

Geçersiz abonelik anahtarı veya Azure Active Directory taşıyıcı belirteci geçersiz olduğundan erişim engellendi. Etkin bir Azure aboneliği ve haritalar kaynağı için geçerli bir anahtar sağladığınızdan emin olun. Aksi takdirde, hata kodu için www-Authenticate üst bilgisini ve belirtilen AAD taşıyıcı belirtecinin açıklamasını doğrulayın.

Headers

  • WWW-Authenticate: string
403 Forbidden

İzin, kapasite veya kimlik doğrulama sorunları.

404 Not Found

Bulunamadı: istenen kaynak bulunamadı, ancak gelecekte tekrar kullanılabilir olabilir.

500 Internal Server Error

İstek işlenirken bir hata oluştu. Lütfen daha sonra yeniden deneyin.

Güvenlik

azure_auth

Bunlar Azure Active Directory OAuth2 akışlardır. Azure rol tabanlı erişim denetimi ile eşleştirildiği zaman, Azure haritalar REST API 'lerine erişimi denetlemek için kullanılabilir. Azure rol tabanlı erişim denetimleri, bir veya daha fazla Azure Maps kaynak hesabına veya alt kaynağa erişimi belirlemek için kullanılır. Herhangi bir Kullanıcı, Grup veya hizmet sorumlusu, yerleşik bir rol veya Azure haritalar REST API 'Lerine bir veya daha fazla izinle oluşan özel bir rol aracılığıyla erişim sağlayabilir.

Senaryoları uygulamak için kimlik doğrulama kavramlarınıgörüntülemeniz önerilir. Özet bölümünde, bu güvenlik tanımı belirli API 'Ler ve kapsamlar üzerinde erişim denetimi yapabilen nesneler aracılığıyla uygulama modelleme için bir çözüm sağlar.

Not

  • Bu güvenlik tanımı requires , x-ms-client-id uygulamanın hangi Azure Maps kaynağına erişim istediğini göstermek için üst bilginin kullanılmasını gerektirir. Bu, haritalar YÖNETIM API'sinden elde edilebilir.
  • , Authorization URL Azure genel bulut örneğine özeldir. Sovereign bulutları benzersiz yetkilendirme URL 'Leri ve Azure Active Directory yapılandırmalarına sahiptir.
  • Azure rol tabanlı erişim denetimi, Azure Yönetim düzleminden Azure Portal, POWERSHELL, CLI, Azure SDK 'LARı veya REST API 'leri aracılığıyla yapılandırılır.
  • Azure Haritalar Web SDK 'sının kullanımı, birden çok kullanım durumu için bir uygulamanın yapılandırma tabanlı kurulumuna izin verir.
  • Şu anda Azure Active Directory v 1.0 belirteçleri destekleniyor.

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

subscription-key

Bu, Azure Yönetim düzlemi aracılığıyla Azure portal, PowerShell, CLı, Azure SDK 'Ları veya REST API 'Leri aracılığıyla Azure Maps kaynağı oluştururken sağlanan paylaşılan bir anahtardır. Bu anahtarla, herhangi bir uygulamanın tüm REST API 'Lerine erişim yetkisi vardır. Diğer bir deyişle, bunlar şu anda, için verilen hesapta ana anahtar olarak kabul edilebilir. Genel kullanıma sunulan uygulamalar için, bu anahtarın güvenli bir şekilde depolanabileceği Azure Maps REST API 'Lerine sunucu erişimi için sunucu kullanma önerimiz.

Type: apiKey
In: query

Örnekler

GetTrafficFlowTile

Sample Request

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

Sample Response

"binary string image"
{
  "error": {
    "code": "400 BadRequest",
    "message": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive."
  }
}
{
  "error": {
    "code": "401 Unauthorized",
    "message": "Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription."
  }
}
{
  "error": {
    "code": "403 Forbidden",
    "message": "Permission, capacity, or authentication issues."
  }
}
{
  "error": {
    "code": "404 NotFound",
    "message": "Not Found: the requested resource could not be found, but it may be available again in the future."
  }
}
{
  "error": {
    "code": "500 InternalServerError",
    "message": "An error occurred while processing the request. Please try again later."
  }
}

Tanımlar

ODataError

Bu nesne, Haritalar API 'sinde bir hata oluştuğunda döndürülür.

ODataErrorResponse

Bu yanıt nesnesi, Haritalar API 'sinde bir hata oluştuğunda döndürülür.

TileFormat

Yanıtın istenen biçimi. Olası değerler, PBF & png ' dir.

TrafficFlowTileStyle

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

  • Absolute, ölçülen mutlak hızı yansıtan renkler döndürür.
  • Göreli olarak, ücretsiz akışa göre hızı döndürür.
  • Göreli hızlardan, serbest akış hızlarından farklı olduğunda göreli gecikme görüntülenir.

ODataError

Bu nesne, Haritalar API 'sinde bir hata oluştuğunda döndürülür.

Name Type Description
code
  • string

ODataError kodu.

details

Bu nesne, Haritalar API 'sinde bir hata oluştuğunda döndürülür.

message
  • string

Kullanılabiliyorsa, hatanın okunabilir bir açıklaması.

target
  • string

Varsa, hedef hataya neden olur.

ODataErrorResponse

Bu yanıt nesnesi, Haritalar API 'sinde bir hata oluştuğunda döndürülür.

Name Type Description
error

Bu nesne, Haritalar API 'sinde bir hata oluştuğunda döndürülür.

TileFormat

Yanıtın istenen biçimi. Olası değerler, PBF & png ' dir.

Name Type Description
pbf
  • string

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

png
  • string

PNG biçimindeki bir görüntü. 0 ile 18 arasında yakınlaştırma düzeylerini destekler.

TrafficFlowTileStyle

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

  • Absolute, ölçülen mutlak hızı yansıtan renkler döndürür.
  • Göreli olarak, ücretsiz akışa göre hızı döndürür.
  • Göreli hızlardan, serbest akış hızlarından farklı olduğunda göreli gecikme görüntülenir.
Name Type Description
absolute
  • string

Renkler, ölçülen mutlak hızı yansıtır.

reduced-sensitivity
  • string

Göreli renkler görüntülenir, ancak parçaların rengi değiştirmesi için FreeFlow 'dan daha büyük bir fark gerekir. Bu mod yalnızca biçim png olduğunda geçerlidir.

relative
  • string

Renkler, ücretsiz akışa göre hızı yansıtır.

relative-delay
  • string

Yalnızca, FreeFlow hızlarından farklı oldukları yerde göreli renkler görüntülenir.