Traffic - Get Traffic Incident Tile

Kafelek Zdarzenia o ruchu sieciowym

Dotyczy: warstwy cenowe S0 i S1.

Ta usługa obsługuje kafelki o wymiary 256 x 256 pikseli, pokazujące zdarzenia ruchu drogowego. Wszystkie kafelki używają tego samego systemu siatki. Ponieważ kafelki ruchu używają przezroczystych obrazów, można je nakładać na kafelki mapy, aby utworzyć złożony ekran. Kafelki ruchu renderuje grafikę, aby wskazać ruch na dróg w określonym obszarze.

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

Parametry identyfikatora URI

Name In Required Type Description
format
path True

Żądany format odpowiedzi. Możliwe wartości to png & pbf.

api-version
query True
  • string

Numer wersji interfejsu API Azure Maps API. Bieżąca wersja to 1.0

style
query True

Styl używany do renderowania kafelka. Ten parametr nie jest prawidłowy, gdy format to pbf.

x
query True
  • integer
int32

Współrzędna X kafelka na siatce powiększenia. Wartość musi być w zakresie [0, 2 zoom -1].

Aby uzyskać szczegółowe informacje, zobacz Poziomy powiększenia i Siatka kafelków.

y
query True
  • integer
int32

Współrzędna Y kafelka na siatce powiększenia. Wartość musi być w zakresie [0, 2 zoom -1].

Aby uzyskać szczegółowe informacje, zobacz Poziomy powiększenia i Siatka kafelków.

zoom
query True
  • integer
int32

Poziom powiększenia odpowiedniego kafelka. W przypadku kafelków rastrowych wartość musi znajdować się w zakresie: 0–22 (włącznie). W przypadku kafelków wektorowych wartość musi być w zakresie: 0–22 (włącznie). Aby uzyskać szczegółowe informacje, zobacz Poziomy powiększenia i Siatka kafelków.

subscription-key
query
  • string

Jeden z kluczy Azure Maps z konta usługi Azure Map. Zapoznaj się z tym artykułem, aby uzyskać szczegółowe informacje na temat zarządzania uwierzytelnianiem.

t
query
  • string

Wartość referencyjna stanu ruchu w określonym czasie uzyskana z wywołania interfejsu API Viewport, atrybutu trafficModelId w polu trafficState. Jest aktualizowany co minutę i jest ważny przez dwie minuty, zanim przejmie on czas. Użyj -1, aby uzyskać najnowsze informacje o ruchu. Ustawienie domyślne: najnowsze informacje o ruchu.

Nagłówek żądania

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

Określa, które konto jest przeznaczone do użycia w połączeniu z modelem zabezpieczeń usługi Azure AD. Reprezentuje unikatowy identyfikator konta usługi Azure Maps i można go pobrać z interfejsu API konta Azure Maps zarządzania. Aby korzystać z zabezpieczeń usługi Azure AD w Azure Maps zobacz następujące artykuły, aby uzyskać wskazówki.

Odpowiedzi

Name Type Description
200 OK

OK

400 Bad Request

Nieprawidłowe żądanie: co najmniej jeden parametr został niepoprawnie określony lub wzajemnie się wykluczają.

401 Unauthorized

Odmowa dostępu z powodu nieprawidłowego klucza subskrypcji lub nieprawidłowego Azure Active Directory tokenu użytkownika. Pamiętaj, aby podać prawidłowy klucz dla aktywnej subskrypcji platformy Azure i zasobu usługi Maps. W przeciwnym razie sprawdź nagłówek WWW-Authenticate, aby uzyskać kod błędu i opis dostarczonego tokenu okaziciela usługi AAD.

Headers

  • WWW-Authenticate: string
403 Forbidden

Problemy z uprawnieniami, pojemnością lub uwierzytelnianiem.

404 Not Found

Nie znaleziono: nie można odnaleźć żądanego zasobu, ale może on być ponownie dostępny w przyszłości.

500 Internal Server Error

Wystąpił błąd podczas przetwarzania żądania. Spróbuj ponownie później.

Zabezpieczenia

azure_auth

Są to przepływy Azure Active Directory OAuth2. W przypadku sparowania z kontrolą dostępu opartą na rolach platformy Azure można jej użyć do kontrolowania dostępu do Azure Maps API REST. Kontrola dostępu oparta na rolach platformy Azure służy do wyznaczania dostępu do co najmniej jednego Azure Maps zasobów lub pod zasobów. Dowolny użytkownik, grupa lub nazwa główna usługi może uzyskać dostęp za pośrednictwem roli wbudowanej lub niestandardowej składającej się z co najmniej jednego uprawnienia do Azure Maps API REST.

Aby zaimplementować scenariusze, zalecamy zapoznanie się z pojęciami uwierzytelniania. Podsumowując, ta definicja zabezpieczeń zapewnia rozwiązanie do modelowania aplikacji za pośrednictwem obiektów z możliwością kontroli dostępu do określonych interfejsów API i zakresów.

Uwaga

  • Ta definicja zabezpieczeń wymaga użycia nagłówka w celu wskazania, Azure Maps zasobu, do którego aplikacja żąda x-ms-client-id dostępu. Można go uzyskać z interfejsu API zarządzania mapami.
  • Jest Authorization URL on specyficzny dla wystąpienia chmury publicznej Platformy Azure. Suwerenne chmury mają unikatowe adresy URL autoryzacji i konfiguracje usługi Azure Active Directory.
  • Kontrola dostępu oparta na rolach platformy Azure jest konfigurowana z płaszczyzny zarządzania platformy Azure za pośrednictwem Azure Portal, powershell, interfejsu wiersza polecenia, zestawów Azure SDK lub interfejsów API REST.
  • Użycie zestawu AZURE MAPS SDK umożliwia konfigurację opartą na konfiguracji aplikacji w wielu przypadkach użycia.
  • Obecnie Azure Active Directory tokeny w wersji 1.0 są obsługiwane.

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

subscription-key

Jest to klucz wspólny, który jest aprowowany podczas tworzenia zasobu usługi Azure Maps za pośrednictwem płaszczyzny zarządzania platformy Azure za pośrednictwem platformy Azure Portal, programu PowerShell, interfejsu wiersza polecenia, zestawów Azure SDK lub interfejsów API REST. Za pomocą tego klucza każda aplikacja jest autoryzowana do uzyskiwania dostępu do wszystkich interfejsów API REST. Innymi słowy, obecnie mogą być one traktowane jako klucze główne dla konta, dla którego zostały wystawione. W przypadku publicznie ujawnionych aplikacji zaleca się używanie dostępu serwera do serwera Azure Maps API REST, w których ten klucz może być bezpiecznie przechowywany.

Type: apiKey
In: query

Przykłady

GetTrafficIncidentTile

Sample Request

GET https://atlas.microsoft.com/traffic/incident/tile/png?subscription-key=[subscription-key]&api-version=1.0&style=night&zoom=10&x=175&y=408

Sample Response

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

Definicje

ODataError

Ten obiekt jest zwracany, gdy w interfejsie API usługi Maps wystąpi błąd.

ODataErrorResponse

Ten obiekt odpowiedzi jest zwracany, gdy w interfejsie API usługi Maps wystąpi błąd.

TileFormat

Żądany format odpowiedzi. Możliwe wartości to png & pbf.

TrafficIncidentTileResult

Ten obiekt jest zwracany z pomyślnego wywołania kafelka zdarzenia o ruchu sieciowym

TrafficIncidentTileStyle

Styl używany do renderowania kafelka. Ten parametr nie jest prawidłowy, gdy format to pbf.

ODataError

Ten obiekt jest zwracany, gdy w interfejsie API usługi Maps wystąpi błąd.

Name Type Description
code
  • string

Kod ODataError.

details

Ten obiekt jest zwracany, gdy w interfejsie API usługi Maps wystąpi błąd.

message
  • string

Jeśli jest dostępny, czytelny dla człowieka opis błędu.

target
  • string

Jeśli jest dostępny, element docelowy powoduje błąd.

ODataErrorResponse

Ten obiekt odpowiedzi jest zwracany, gdy w interfejsie API usługi Maps wystąpi błąd.

Name Type Description
error

Ten obiekt jest zwracany, gdy w interfejsie API usługi Maps wystąpi błąd.

TileFormat

Żądany format odpowiedzi. Możliwe wartości to png & pbf.

Name Type Description
pbf
  • string

Grafika wektorowa w formacie pbf. Obsługuje poziomy powiększenia od 0 do 22.

png
  • string

Obraz w formacie PNG. Obsługuje poziomy powiększenia od 0 do 18.

TrafficIncidentTileResult

Ten obiekt jest zwracany z pomyślnego wywołania kafelka zdarzenia o ruchu sieciowym

Name Type Description
image
  • string

Image, właściwość

TrafficIncidentTileStyle

Styl używany do renderowania kafelka. Ten parametr nie jest prawidłowy, gdy format to pbf.

Name Type Description
night
  • string

Styl nocy.

s1
  • string

Tworzy linie ruchu z kolorowymi chevronami wskazującymi ważność.

s2
  • string

Tworzy zwykłe linie z określonym stopniem rozgiełęzienia.

s3
  • string

Tworzy zwykłe linie z określonym stopniem rozgiełęzienia.